APPX600LinuxNewInstallation < Main

Tags: view all tags
---+ APPX 6.0.0 - Linux/Unix - New Installation

<br /><span style="font-variant-ligatures: no-common-ligatures;">%TOC%</span>

<br /><span style="font-variant-ligatures: no-common-ligatures;">%STARTINCLUDE%</span>
---++ Overview

Two different methods are provided to install APPX on Linux/Unix. There is a [[#GuiInstaller][GUI installer]] and a [[#CharInstaller][Console Mode]] (character mode) installer. The same installer is used for both methods. The installer will automatically detect if it is being run as a command or from a GUI Desktop, although in some cases you may have to add "-c" to the command line to force the character installer. Regardless of which installation method is used, the result is the same. A typical APPX installation on a system where APPX has not been previously installed performs the following steps:

   1 Creates an O/S user named "appx" and a group named "appxgrp".
   1 Creates the destination directory and installs APPX into it.
   1 Sets the appropriate permissions
   1 Runs APPX to allow you to complete the configuration
      * Add APPX System Administrators to the APPX user file
      * Configure and start the APPX Login Manager service
      * Configure and start the APPX Audit Manager service
      * Install the license key

---++ Special Note for AIX

If you are installing APPX on AIX, you will probably have to raise the data segment size via the 'ulimit' command. The symptom is that your APPX sessions crash with no warning, especially in processes that use tables.

To increase the limit:
<pre>bash-4.3# ulimit -d unlimited
bash-4.3# ulimit -a
core file size          (blocks, -c) 1048575
data seg size           (kbytes, -d) unlimited
file size               (blocks, -f) unlimited
max memory size         (kbytes, -m) 32768
open files                      (-n) 2000
pipe size            (512 bytes, -p) 64
stack size              (kbytes, -s) 32768
cpu time               (seconds, -t) unlimited
max user processes              (-u) 262144
virtual memory          (kbytes, -v) unlimited
</pre>

<span style="font-variant-ligatures: no-common-ligatures;">You can set this limit in the /etc/security/limits file so that it is set on every reboot. If you set it manually, you must restart the login service from the same shell so that it will inherit the new setting:</span>
<pre>bash-4.3# stopsrc -s appx-8600
0513-044 The appx-8600 Subsystem was requested to stop.
bash-4.3# startsrc -s appx-8600
0513-059 The appx-8600 Subsystem has been started. Subsystem PID is 315394.
</pre>
---++ GUI Installation on Linux/Unix

Log in to your system as the "root" user.

Download the APPX/Linux GUI installer from the <a href="https://www.appx.com/server-releases" target="_blank">APPX web site</a> and save it to your Desktop or to any other suitable folder. The following instructions will refer to the appxsetup-linux-64.sh file, which is the name of the 64 bit Linux installer. The installers for other operating systems have similar names, ie, appxsetup-aix.sh for AIX, appxsetup-sun.sh for Solaris, and so on.

Open a Terminal window and run the installer file:

<b>[root@centos7]# sh appxsetup-linux-64.sh</b><br /><b>Unpacking JRE ...</b><br /><b>Preparing JRE ...</b><br /><b>Starting Installer ...</b>

After a few moments, the APPX Setup Wizard should display the Welcome screen. Click on the "Next" button to continue.

<br /><img alt="new_start_linux.png" height="424" src="%ATTACHURL%/new_start_linux.png" width="514" />

Read and accept the license agreement.

<br /><img alt="new_linux_license_6.png" height="411" src="%ATTACHURL%/new_linux_license_6.png" width="503" />

Specify the Destination Directory into which APPX is to be installed. As a matter of convention, APPX is usually installed into /usr/local/appx but may be installed into the directory of your choice.

<br /><img alt="new_linux_select_folder.png" height="413" src="%ATTACHURL%/new_linux_select_folder.png" width="503" />

You will be warned if the destination directory already exists. Otherwise, the APPX Setup Wizard will create it.

<br />APPX will then be installed into the specified destination directory.

<br /><img alt="new_linux_install_files.png" height="419" src="%ATTACHURL%/new_linux_install_files.png" width="507" />

When all files have been copied, a message instructing you to run APPX to complete the installation will appear.

<img alt="new_linux_install_remind.png" height="422" src="%ATTACHURL%/new_linux_install_remind.png" width="513" />

When the APPX Setup Wizard displays the final screen, click on the Finish button to end the APPX Setup Wizard and to automatically run APPX to complete the configuration and installation of APPX.

<br /><img alt="new_linux_finish.png" height="425" src="%ATTACHURL%/new_linux_finish.png" width="517" />

See 'Completeing the Installation' below to complete the installation

<span style="font-variant-ligatures: no-common-ligatures;"><br />#CharInstaller</span>
---++ Character Mode Installation

<div id="_mcePaste">If you don't have access to a GUI, you can run the Appx installer in character mode by appending "-c" to the command line. After a few moments, the Appx Setup Wizard should display the Welcome message. Press Enter to continue the installation.</div>

__# ./appxsetup.sh -c__
<div id="_mcePaste"> __Unpacking JRE ...__ </div> <div id="_mcePaste"> __Preparing JRE ...__ </div> <div id="_mcePaste"> __Starting Installer ...__ </div> <div id="_mcePaste"> __This will install Appx on your computer.__ </div> <div id="_mcePaste"><em><strong>OK [o, Enter], Cancel [c</strong>]</em></div>

---

Next, read and accept the License agreement. Press Enter as each page is displayed.

__Please read the following License Agreement. You must accept the terms of this agreement before continuing with the installation.__

__Software License__

__APPX Utility - Release 6.0.0__

<em>_ Important! _ </em>

__Please read this carefully before you click on the Accept button.__

__Definitions:__

__"Software License Agreement (SLA)" shall mean this Software License document and the associated *License Key document collectively.__

__[Enter]__

After the agreement has been displayed, enter 1 to accept the license agreement, or 2 to cancel the installation.

__.<br />.<br />.<br />For inquires regarding this agreement, please contact: APPX Software, Inc., 11363 San Jose Blvd., Suite 301, Jacksonville, Florida 32223, USA__

__I accept the agreement__

__Yes [1], No [2]__

---

Choose the directory where APPX should be installed and the other installation options.

__Where should Appx be installed?__

__[/opt/appxserver]__

__Create a desktop icon?__

__Yes [y, Enter], No [n]__

__Create a Quick Launch icon?__

__Yes [y, Enter], No [n]__

<br /><span style="font-variant-ligatures: no-common-ligatures;">%STOPINCLUDE%</span>
---++ Set the ICU Locale

A locale identifies a specific user community - a group of users who have similar culture and language expectations for human-computer interaction (and the kinds of data they process).

A community is usually understood as the intersection of all users speaking the same language and living in the same country. Furthermore, a community can use more specific conventions. For example, an English/United States/Military locale is separate from the regular English/United States locale since the US military writes times and dates differently than most of the civilian community.

APPX needs to know your Locale. If not specified, it will default to en_US.

To change the locale, use a text editor to modify the 'appx.env' file, and add:

LANG=&lt;desired locale&gt;

The 'appx.env' file is located in the 'data' folder of your installation folder. For example, if APPX was installed in /opt/appxserver, then 'appx.env' is located at '/opt/appxserver/appx.env'.

See <a href="http://userguide.icu-project.org/locale" target="_blank" title="ICU Locale User Guide">http://userguide.icu-project.org/locale</a> for more information on Locales.
---++ Completing the Installation

You will have to manually start the APPX Login Manager Service before you can complete the installation. Enter the following commands (make sure you adjust the path names as required):

[root@centos7 appx]# cd services<br />[root@centos7 services]# ./appxLoginMgr -install -name=appx600 -port=8060 -engine=/opt/appxserver/appx APPXPATH=/opt/appxserver/data<br />Warning - the engine that you named has the setuid bit enabled,<br /> you may not want that bit set for the authentication<br /> method that you have chosen (OS-User)<br /> To turn off the setuid bit, chmod u-s /opt/appxserver/appx<br />Configuration written to: appx8060.ini<br />Environment written to: appx8060.env<br />Service script written to: /etc/init.d/appx600<br />Configuration complete<br />Registering service<br />Starting appx600 (via systemctl): [ OK ]<br />Warning - the engine that you named has the setuid bit enabled,<br /> you may not want that bit set for the authentication<br /> method that you have chosen (OS-User)<br /> To turn off the setuid bit, chmod u-s /opt/appxserver/appx<br />up and running (process 12882 servicing port 8060)<br />Installation Complete

This will start a Login Manager service on port 8060. Install the APPX Desktop Client on another workstation, and use the Remote tab to log on to this server, then complete the installation by <a href="APPX600NewInstallConfigAPPX" target="_blank">completing the configuration</a>.

Note that as part of completing the installation, you will be asked to install the Login Manager again. You can use the same port number again, it will not affect the installation process.

When you have completed the configuration, return to the Installation page and continue with installing the APPX Desktop Client.
---++ Comments:

_Read what other users have said about this page or add your own comments._
---

<br /><span style="font-variant-ligatures: no-common-ligatures;">%COMMENT%</span>

-- <span style="font-variant-ligatures: no-common-ligatures;">%USERSIG{JeanNeron - 2018-02-15}%</span>
Topic revision: r6 - 2018-03-29 - JeanNeron