create new tag
view all tags

APPX 5 - New Installation - Configure APPX


The first time that APPX is run after the installation wizard completes, you will need to complete the initial configuration of APPX by completing the following tasks:

  1. Configure and start the APPX Login Manager service
  2. Configure and start the APPX Audit Manager service
  3. Configure and start the Data API service (5.5 & higher only)
  4. Add APPX System Administrators to the APPX user file
  5. Install the license key

You will be presented with a series of screens for the purpose of completing the above tasks.

Configure the APPX Login Manager Service and the the APPX Audit Manager Service

If you want to allow remote clients to connect to your APPX installation, you should configure the APPX Login Manager Service by entering a Login Manager Port number. The Login Manager Port number is used by the various types of APPX clients that connect to APPX from a remote location. If you do not want to allow remote connections, blank out the Login Manager Port number.

If you intend to enable the file I/O audit logging feature of APPX, you should configure the APPX Audit Manager Service by entering a Audit Manager Port number. The Audit Manager Port number is used by APPX to log file I/O audit information. If you are not going to use this feature of APPX, blank out the Audit Manager Port number.

If you intend to Data API feature of APPX, you should configure the APPX Data API Service by entering a Data API Port number. If you are not going to use this feature of APPX, blank out the Data API Port number.

You may change these port numbers to be any other TCP/IP port numbers that are not already being used by your system but, as a matter of convention, you may want to use the numbers that are already filled in on this screen. After you have entered the appropriate port numbers, click on the "Start Services" button to create the services and start them.

If you do not want to configure these services, click on the Skip button. You can always configure the services at a later time.

You can click on the Advanced button to review and edit additional options relating to configuring the APPX Login Manager Service.


The Advanced Settings screen allows you to specify the Authentication Method that is to be used by the APPX Login Manager service. If you choose HT authentication, you will also need to provide the full pathname of the HT password file.

You must also specify a name for the tools directory where the APPX Login Manager and the APPX Audit Manager commands are installed. Unless you have moved them to a different directory, you should accept the default directory.

You must also specify a name for the "APPXPATH" directory. Unless instructed to change it by an APPX tech support technician, you should accept the default APPXPATH directory.


Add APPX System Administrators to the APPX User File

You may identify which users are to be APPX System Administrators. These are the only users who will be allowed to initially run APPX. One user ("appx") has already been added to the APPX User file as an APPX System Administrator. You may optionally identify additional users who are to be APPX System Administrators. If you are to be an APPX System Administrator, you should add a User record for your User ID. After adding User records for your APPX System Administrators, you may proceed by clicking on the Next button.

Note that if you chose 'Appx-user' as your authentication method, you will have to enter a password for each user.


Install Your APPX License Key

Next, you must install your APPX license key. The license key is usually provided as an attachment to an e-mail. If you have access to the License Key file, you may import the License Key. Otherwise, you will need to manually enter the License Key information.


Import License Key

Automatically Import License Key

If you select the "Import It Now" option and if you have saved the License Key file in the /tmp directory on the Linux system where APPX is being installed with the specific name of "appx-registration.txt", you will not be prompted for the pathname to the License Key file. The License Key will automatically be detected and installed.

Import From Clipboard

You can also copy the registration to the clipboard, and APPX will recognize it. It will be automatically uploaded to a temporary location (varies by platform), and you can import it from there:


Import From Named File

Alternatively, you can upload the file to a location of your choosing and import it from there:


Wrong License Key Version

APPX 5 and higher requires a License Key that was specifically issued for APPX Release 5 and above. If you attempt to install an older License Key, the installation of APPX 5 will terminate. If you are presented with the following screen, simply press Enter to terminate the installation of APPX 5 without installing a License Key. When you acquire a License Key for APPX 5, you may run APPX to install the License Key.


Enter License Key

The least efficient way to enter your registration is to manually enter the data. It's also the most error prone, as the slightest keying error will cause the license to be rejected. The information is case sensitive so enter the registration data exactly as it appears on your license key, including any spelling mistakes.


After entering the main registration, you will have to enter the information for the Licensed Components.


Installation Completed


Final Tasks

  1. Install a PDF reader on your server. For printing PDF documents on printers defined on a Windows server, we recommend using 'Foxit' from http://www.foxitsoftware.com/pdf/reader/ This product is most compatible with the method APPX uses for printing PDF documents. For Linux/Unix installations, we recommend Adobe's Acrobat reader, version 9 or higher.
  2. Install the APPX Desktop client on the workstations that need to access APPX. Instructions for the various platforms can be found here. Note that the server installation of APPX also includes the APPX Desktop Client, it is not necessary to install it again.
  3. Install a PDF reader on each of those workstations. The recommendations are the same, Foxit for Windows workstations, Adobe Acrobat for Linux. Macintosh desktops include the Preview application, so no additional software is necessary, although you can install Adobe Acrobat if you prefer.


Read what other users have said about this page or add your own comments.

-- JeanNeron - 2/11/20

Edit | Attach | Watch | Print version | History: r13 < r12 < r11 < r10 < r9 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r13 - 2020-02-11 - JeanNeron
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 2008-2022 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback