The APPX installation process is quite straightforward. Follow these instructions carefully, and your success is guaranteed.
Step 1 - Verify File Locations
In order for the installation process to go smoothly, please make sure that the following conditions are all true:
- The APPX License Key is in directory /tmp, as /tmp/appx-registration.txt
- You have downloaded the APPX Utility (AppxUtility-linux.sh) and have it available to launch from a GUI desktop.
- You have downloaded the APPX Business Applications install file (AppxBANG-linux.sh) and have it available to launch from a GUI desktop.
Step 2 - Install the APPX Utility
Make sure you are logged in as "root". Install the APPX Utility by executing the APPX Utility file that you have previously downloaded:
- sh ./AppxUtility-linux.sh
Step 3 - Activate your APPX Installation
After installing the software:
- APPX will prompt you for the identity of the Linux user who is to be the APPX System Administrator. The APPX System Administrator does not need to have root user privileges.
- APPX will next install the license key that you saved as /tmp/appx-registration.txt. If APPX is unable to find the license key in the /tmp directory, APPX will prompt you to identify the pathname where the license key can be found. There is also an option to allow keyboard entry of the license key information.
- When APPX has completed the activation, you will be presented with an "Installation Completed" dialog box as shown in the figure below. You should acknowledge this by clicking on the Continue button. APPX will then terminate.
Step 4 - Install the APPX Business Applications
With APPX activated, we proceed to installing the applications. Still logged in as "root", execute the appx-BANG! Business Applications file that you previously downloaded:
- sh ./AppxBANG-2.001- linux.sh
IMPORTANT NOTE: If you are installing the appx-BANG! Business Applications into an existing APPX installation, where you have not just installed the APPX Utility as instructed above, it is critical that there is an APPX user set up in both your operating system and in your APPX users file. Use operating system user ID 'appx' and set up the corresponding user within APPX as user APX, as an APPX System Administrator. The software will not work properly otherwise. Also, when specifying the path for installation, be sure it is the same location in which the APPX Utility is installed.
Step 5 - Install the APPX Desktop Client
You may be able to bypass this step. If you will be running a stand-alone single-user Linux system, the APPX Desktop Client has already been installed as part of the APPX Utility installation. If, however, you are setting up a client-server system, or will be accessing the APPX applications as data from a remote desktop (Linux, Windows®, or MacIntosh), then you must run the following web install on each desktop:
- For Linux desktops, download and run this file
- For Windows desktops, download and run this file
- For Macintosh desktops, download and run this file
Note: In order for the APPX server product to communicate with your desktop client(s) to allow login and operation, the APPX daemon must be running on the server. To start the daemon, run the following script on your Linux server:
Step 6 - Install Adobe Acrobat Reader
If you already have Acrobat Reader installed, or if you are running a Linux desktop with an equivalent product, you can bypass this step. Otherwise, follow Adobe's instructions for installing Acrobat Reader. We believe that following the above steps will allow you to successfully install your APPX business applications. However, should you run into any unexpected difficulty during the installation or setup processes, we invite you to contact APPX Software, Inc. for free assistance, at email@example.com.
That completes the installation process. Now, move ahead to setup.