Install App Builder on Linux

From Lianjapedia
Revision as of 21:17, 10 December 2019 by Barrymavin (Talk | contribs)

Jump to: navigation, search

See Also

Before you start...

The Lianja App Builder installer includes the Lianja App Builder, the Lianja App Center (desktop client), the Lianja Server (Lianja Cloud Server, Lianja SQL Server for development and testing) and Lianja ODBC Driver.

It includes everything you need to develop for desktop and web/tablet/mobile clients.


  • Make sure root has execute permission on the downloaded file.

Open up a Terminal window. (e.g. on Ubuntu right click on the desktop and select 'Open Terminal').

In 5.1 and above, the distro is a compressed tar file.

$ cd 
$ cd Downloads
$ tar xvf LianjaAppBuilder-X.X.X-linux-x64-installer..tar.gz
$ chmod +x LianjaAppBuilder-X.X.X-linux-x64-installer.bin

Prior to 5.1 the distro was not a compressed tar file.

$ cd 
$ cd Downloads
$ chmod +x LianjaAppBuilder-X.X.X-linux-x64-installer.bin
  • As root or using sudo, run the installer.
$ sudo ./LianjaAppBuilder-X.X.X-linux-x64-installer.bin

Note: if you run the installer with sudo the Lianja App Builder and Lianja App Center shortcuts will be placed on your desktop. If you run the installer as root, they will be placed on root's desktop.

Installer: Language Selection

Select the language for installation, then click OK:

Installer: Welcome

The welcome page will be displayed.

Click Forward:

Installer: License

Read the License Agreement using the scrollbar to display the full text

Click a radio button to accept or reject the License Agreement, then click Forward

If you select I accept the agreement, the installation will continue.

If you select I do not accept the agreement, you will be prompted to abort the installation.

If you click Yes the installation will stop, if you click No you will be returned to the License Agreement.

Installer: Components

After accepting the License Agreement, the installation will continue

Make sure 'Lianja App Builder' is checked, then click Forward.

Installer: Ready to Install

Click Forward to begin the installation

If you do not want the installation to begin, click Cancel

Installer: Finished

Once the installer has finished, uncheck the box if you do not want to view the Readme File, then click Finish.

Installer: Readme

Click OK to exit the Readme.

Running the Lianja App Builder

After installation, logout then login again before running the Lianja App Builder so that the new PATH is used.

Run Lianja App Builder: Desktop Shortcut

Run the Lianja App Builder from its desktop shortcut.

Note that if this is the first time you have installed Lianja App Builder, it will run with a 30 day trial license.

Run Lianja App Builder: Terminal

Or from a terminal.

$ lianja

Note that if this is the first time you have installed Lianja App Builder, it will run with a 30 day trial license.

Lianja App Builder: Home

The Lianja App Builder will start in the Home workspace.

See Getting Started for an introduction to creating Apps in Lianja App Builder.

Running the Lianja App Center

The Lianja App Center desktop runtime client is also installed when you install Lianja App Builder.

Run Lianja App Center desktop runtime client

Run the Lianja App Center from its desktop shortcut or from a terminal.

$ lianjaruntime

The Lianja App Center will start on the login page. The default username/password for the Lianja App Center is admin/admin.

Lianja App Center

Once logged in, the Lianja App Center home page will be displayed.

This shows Apps that have been published and deployed in Lianja App Builder.

See Getting Started for an introduction to creating, publishing and deploying Apps in Lianja App Builder.

Lianja Server

The Lianja Server (Lianja Cloud Server and Lianja SQL Server) for development and testing and the Lianja ODBC Driver are also installed when you install Lianja App Builder. Lianja Cloud Server is required for Lianja web/mobile Apps. Lianja SQL Server is required for ODBC access to Lianja databases using the Lianja ODBC Driver.

Lianja Server

The lianja_admin command is used to manage the Lianja Server and must be run as root or using sudo.

To check that the Lianja Server is running:

$ sudo lianja-admin status

Further lianja-admin options are:

$ sudo lianja-admin start
$ sudo lianja-admin stop
$ sudo lianja-admin restart

For more information see Lianja Server Manager on Linux.

Lianja ODBC Driver

The Lianja ODBC Driver requires the unixODBC package. To install unixODBC:


$ sudo apt-get install unixodbc


# yum install unixODBC

Now init the ODBC definitions for Lianja. This will define the Lianja ODBC driver in /etc/odbcinst.ini and the lianja_southwind DSN in /etc/odbc.ini.

$ cd /opt/lianja/server/dist
$ ./ /opt/lianja/server odbc

For information on setting up ODBC data sources, see unixODBC without the GUI.