Difference between revisions of "Install App Builder on Linux"

From Lianjapedia
Jump to: navigation, search
(RHEL / Centos 8.x)
 
(18 intermediate revisions by 2 users not shown)
Line 1: Line 1:
'''[http://www.lianja.com/component/rsfiles/files?folder=Linux Downloads for Linux]'''
+
==See Also==
 +
* [http://www.lianja.com/component/rsfiles/files?folder=Linux Downloads for Linux]
 +
* [[:Category:Getting Started|Getting Started]]
 +
* [[:Category:License Management|License Management]]
 +
* [[Lianja Server Manager on Linux]]
 +
* [[Apache Module for Linux]]
  
 +
==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.
 +
 +
===RHEL / Centos 8.x===
 +
The required '''libnsl''' package is no longer provided in the OS glibc package, so should be installed separately.
 +
 +
<pre>$ sudo yum install libnsl</pre>
  
 
==Installation==
 
==Installation==
* Make sure root has execute permission on the downloaded file.  If not, change the file permissions from a terminal window or by right clicking on the file and selecting "properties". (chmod +x)
+
* Make sure root has execute permission on the downloaded file.   
* As root or using sudo, run the installer. For 64 bit Red Hat / Centos / Fedora, please run the installer in text mode (--mode text)
+
 
* Click '''Forward''' to continue
+
Open up a Terminal window. (e.g. on Ubuntu right click on the desktop and select 'Open Terminal').
[[File:Linux_Install_ab1.png|link=|Lianja App Builder Installation]]
+
 
* Read the License Agreement
+
In 5.1 and above, the distro is a compressed tar file.
* Use the scrollbar to display the full text
+
 
[[File:Linux_Install_ab2.png|link=|Lianja App Builder Installation]]
+
* Click a radio button to accept or reject the License Agreement
+
* Click '''Forward'''
+
* If you select '''I accept the agreement''', the installation will continue
+
[[File:License_ab_yes.png|link=|Lianja App Builder Installation]]
+
* 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
+
[[File:License_ab_no.png|link=|Lianja App Builder Installation]]
+
* After accepting the License Agreement, the installation will continue
+
* Make sure 'Lianja App Builder' is checked
+
* Click '''Forward'''
+
[[File:Linux_Install_ab3.png|link=|Lianja App Builder Installation]]
+
* Click '''Forward''' to begin the installation
+
* If you do not want the installation to begin, click '''Cancel'''
+
[[File:Linux_Install_ab4.png|link=|Lianja App Builder Installation]]
+
* Uncheck the box if you do not want to view the Readme File
+
* Click '''Finish'''
+
[[File:Linux_Install_ab5.png|link=|Lianja App Builder Installation]]
+
* Run the Lianja App Builder from its desktop launcher or from a terminal:
+
 
<pre>
 
<pre>
$ lianja
+
$ cd
 +
$ cd Downloads
 +
$ tar xvf LianjaAppBuilder-X.X.X-linux-x64-installer.tar.gz
 +
$ chmod +x LianjaAppBuilder-X.X.X-linux-x64-installer.bin
 
</pre>
 
</pre>
* When you install the Lianja App Builder, the Lianja App Center (desktop client) will also be installed. Run the Lianja App Center from its desktop launcher or from a terminal:
+
 
 +
Prior to 5.1 the distro was not a compressed tar file.
 +
 
 
<pre>
 
<pre>
$ lianjaruntime
+
$ cd
 +
$ cd Downloads
 +
$ chmod +x LianjaAppBuilder-X.X.X-linux-x64-installer.bin
 
</pre>
 
</pre>
* The default username/password for the Lianja App Center is admin/admin.
+
 
* Note: If you want to develop for web/tablet/mobile clients, you will also need to install the Lianja Cloud Server.
+
* As root or using sudo, run the installer.
==See Also==
+
<pre>$ sudo ./LianjaAppBuilder-X.X.X-linux-x64-installer.bin</pre>
[[:Category:License Management|License Management]]
+
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.
 +
 
 +
[[{{ns:file}}:linstall_language.png|600px|thumb|left|link={{filepath:linstall_language.png}}|Installer: Language Selection]]
 +
 
 +
 
 +
 
 +
 
 +
Select the language for installation, then click '''OK''':
 +
<br clear=all>
 +
 
 +
[[{{ns:file}}:linstall_welcome.png|600px|thumb|left|link={{filepath:linstall_welcome.png}}|Installer: Welcome]]
 +
 
 +
 
 +
 
 +
 
 +
The welcome page will be displayed.
 +
 
 +
Click '''Forward''':
 +
<br clear=all>
 +
 
 +
[[{{ns:file}}:linstall_license.png|600px|thumb|left|link={{filepath:linstall_license.png}}|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.
 +
 
 +
<br clear=all>
 +
 
 +
[[{{ns:file}}:linstall_components.png|600px|thumb|left|link={{filepath:linstall_components.png}}|Installer: Components]]
 +
 
 +
 
 +
 
 +
 
 +
After accepting the License Agreement, the installation will continue
 +
 
 +
Make sure 'Lianja App Builder' is checked, then click '''Forward'''.
 +
 
 +
<br clear=all>
 +
 
 +
[[{{ns:file}}:linstall_ready_to_install.png|600px|thumb|left|link={{filepath:linstall_ready_to_install.png}}|Installer: Ready to Install]]
 +
 
 +
 
 +
 
 +
 
 +
Click '''Forward''' to begin the installation
 +
 
 +
If you do not want the installation to begin, click '''Cancel'''
 +
 
 +
<br clear=all>
 +
 
 +
[[{{ns:file}}:linstall_finish.png|600px|thumb|left|link={{filepath:linstall_finish.png}}|Installer: Finished]]
 +
 
 +
 
 +
 
 +
Once the installer has finished, uncheck the box if you do not want to view the Readme File, then click '''Finish'''.
 +
 
 +
<br clear=all>
 +
 
 +
[[{{ns:file}}:linstall_release_notes.png|600px|thumb|left|link={{filepath:linstall_release_notes.png}}|Installer: Readme]]
 +
 
 +
 
 +
 
 +
Click '''OK''' to exit the Readme.
 +
<br clear=all>
 +
 
 +
==Running the Lianja App Builder==
 +
After installation, logout then login again before running the Lianja App Builder so that the new PATH is used.
 +
 
 +
[[{{ns:file}}:linstall_appb_shortcut.png|600px|thumb|left|link={{filepath:linstall_appb_shortcut.png}}|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.
 +
 
 +
<br clear=all>
 +
 
 +
[[{{ns:file}}:linstall_appb.png|600px|thumb|left|link={{filepath:linstall_appb.png}}|Run Lianja App Builder: Terminal]]
 +
 
 +
 
 +
 
 +
 
 +
Or from a terminal.
 +
<pre>
 +
$ lianja
 +
</pre>
 +
 
 +
Note that if this is the first time you have installed Lianja App Builder, it will run with a 30 day trial license.
 +
 
 +
<br clear=all>
 +
 
 +
[[{{ns:file}}:linstall_appb_home.png|600px|thumb|left|link={{filepath:linstall_appb_home.png}}|Lianja App Builder: Home]]
 +
 
 +
 
 +
 
 +
The Lianja App Builder will start in the '''Home''' workspace.
 +
 
 +
See [[:Category:Getting Started|Getting Started]] for an introduction to creating Apps in Lianja App Builder.
 +
<br clear=all>
 +
 
 +
==Running the Lianja App Center==
 +
The Lianja App Center desktop runtime client is also installed when you install Lianja App Builder.
 +
 
 +
[[{{ns:file}}:linstall_runtime_login.png|600px|thumb|left|link={{filepath:linstall_runtime_login.png}}|Run Lianja App Center desktop runtime client]]
 +
 
 +
 
 +
 
 +
 
 +
Run the Lianja App Center from its desktop shortcut or from a terminal.
 +
 
 +
<pre>$ lianjaruntime</pre>
 +
 
 +
The Lianja App Center will start on the login page.  The default username/password for the Lianja App Center is admin/admin.
 +
 
 +
<br clear=all>
 +
 
 +
[[{{ns:file}}:linstall_runtime_appc.png|600px|thumb|left|link={{filepath:linstall_runtime_appc.png}}|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 [[:Category:Getting Started|Getting Started]] for an introduction to creating, publishing and deploying Apps in Lianja App Builder.
 +
 
 +
<br clear=all>
 +
 
 +
==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.
 +
 
 +
[[{{ns:file}}:linstall_server_running.png|600px|thumb|left|link={{filepath:linstall_server_running.png}}|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:
 +
<pre>$ sudo lianja-admin status</pre>
 +
 
 +
<br clear=all>
 +
 
 +
Further lianja-admin options are:
 +
<pre>$ sudo lianja-admin start
 +
$ sudo lianja-admin stop
 +
$ sudo lianja-admin restart</pre>
 +
 
 +
For more information see [[Lianja Server Manager on Linux]].
 +
 
 +
==Lianja ODBC Driver==
 +
The Lianja ODBC Driver requires the unixODBC package.  To install unixODBC:
 +
 
 +
Ubuntu
 +
 
 +
<pre>$ sudo apt-get install unixodbc</pre>
 +
 
 +
RHEL
 +
 
 +
<pre># yum install unixODBC</pre>
 +
 
 +
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.
 +
 
 +
<pre>$ cd /opt/lianja/server/dist
 +
$ ./postinstall.sh /opt/lianja/server odbc</pre>
 +
 
 +
For information on setting up ODBC data sources, see [http://www.unixodbc.org/odbcinst.html unixODBC without the GUI].
 +
 
 
[[Category:Installation| ]]
 
[[Category:Installation| ]]
 +
[[Category:Installation on Linux| Lianja App Builder]]

Latest revision as of 10:23, 15 January 2020

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.

RHEL / Centos 8.x

The required libnsl package is no longer provided in the OS glibc package, so should be installed separately.

$ sudo yum install libnsl

Installation

  • 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:

Ubuntu

$ sudo apt-get install unixodbc

RHEL

# 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
$ ./postinstall.sh /opt/lianja/server odbc

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