Installing Lasso v4

EDB distributes the application through the EDB website and grants usage to customers using a company token as a means of authentication.

Linux

You can install Lasso on any major supported Linux distribution by following the corresponding Linux installation option for your system from the EDB Downloads page. Or, you can install it directly from the EDB repositories for Linux page. Choose Lasso and following the installation instructions.

After installing the EDB repository for your subscription on your system, you can install Lasso on Linux using the package manager tool for your Linux distribution. Examples include (but aren't limited to):

  • Debian / Ubuntu:
    apt install edb-lasso
  • RHEL / CentOS / Oracle Linux 7:
    yum install edb-lasso
  • RHEL / Rocky / AlmaLinux / Oracle Linux 8+:
    dnf install edb-lasso
  • SLES:
    zypper install edb-lasso

If your system has internet access, then installing the edb-lasso package using your package manager installs EDB Python (package name edb-python39) as the only dependency.

If your system doesn't have internet access, then you need to download EDB Python and install it manually before installing Lasso.

The edb-python39 package, on its turn, depends on the following packages:

  • ncurses
  • openssl
  • readline
  • xz

Which are already installed by default on most Linux distributions.

If you have any issues installing Lasso or EDB Python, please reach out to EDB Support.

Windows

Lasso for Windows is a single-file binary executable called lasso-windows-X.Y.Z.exe, where X.Y.Z is the current Lasso version. You can download it from the EDB Downloads page.

On Windows, Lasso doesn't require installing any dependencies, but Lasso can run only on Windows Server 2019 or later.

Configuration file

If you try to run Lasso without a configuration file, this error occurs:

    ERROR: no configuration file for Lasso could be found. Please create a configuration file and try again.

Lasso requires a configuration file, which can be one of the following options. (It uses the first match.)

  • ./edb-lasso.cfg in the same directory where Lasso is running
  • ./edb-lasso.conf in the same directory where Lasso is running
  • $HOME/.edb-lasso.conf
  • /etc/edb-lasso.conf

The minimum configuration file looks like this:

[customer]
id=XXXXX
token=YYYYYYYYY

Replace the id and token value with the information found in your company page in the Support Portal. (In the left menu bar, select Company info > Company.) Enter the Company code value from this page in the id field in the configuration file. Enter the Token value in the token field in the configuration file.

Important

A configuration file for Lasso is mandatory and must contain at least the customer id and token.

For more details about the Lasso configuration, see Configuration.

Executing Lasso

After installing Lasso and creating an appropriate configuration file, a standard Lasso execution on Linux is:

    lasso

On Windows, to run Lasso, you need to do the following:

  1. In the Start menu search field, enter cmd.
  2. On the Start menu, right-click Command Prompt and select Run as administrator.
  3. If Windows prompts you to allow Command Prompt to make changes in the system, select Yes.
  4. At the Command Prompt, cd to the directory where the Lasso .exe file is located.
  5. Execute the command lasso-windows-X.Y.Z.exe, where X.Y.Z is the Lasso version.
    lasso-windows-X.Y.Z.exe -H IP_ADDRESS -p PORT --password PASSWORD DATABASE_NAME USER_NAME

Alternatively, if you fill in the settings under the postgresql section in the configuration file telling Lasso how to connect to Postgres, then you can execute Lasso from the Windows Explorer. Right-click the .exe file, and then select Run as administrator.

For more details on the many Lasso options, see Usage.