Difference between revisions of "Install App Builder on Linux"
Yvonne.milne (Talk | contribs) |
Yvonne.milne (Talk | contribs) (→RHEL / Centos 8.x) |
||
(16 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
− | + | ==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 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. | + | * 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. | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
<pre> | <pre> | ||
− | $ | + | $ 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> | ||
− | + | ||
+ | Prior to 5.1 the distro was not a compressed tar file. | ||
+ | |||
<pre> | <pre> | ||
− | $ | + | $ 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. | + | |
− | + | * As root or using sudo, run the installer. | |
− | == | + | <pre>$ sudo ./LianjaAppBuilder-X.X.X-linux-x64-installer.bin</pre> |
− | [ | + | 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
Contents
See Also
- Downloads for Linux
- Getting Started
- 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.
$ 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.
Select the language for installation, then click OK:
The welcome page will be displayed.
Click Forward:
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.
After accepting the License Agreement, the installation will continue
Make sure 'Lianja App Builder' is checked, then click Forward.
Click Forward to begin the installation
If you do not want the installation to begin, click Cancel
Once the installer has finished, uncheck the box if you do not want to view the Readme File, then click Finish.
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 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.
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.
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 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.
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.
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.