APPX500NewInstallConfigAPPX < Main

---+ APPX 5 - New Installation - Configure APPX

<br />%TOC%
---++ Overview

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
   1 Configure and start the APPX Audit Manager service
   1 Add APPX System Administrators to the APPX user file
   1 Install the license key

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

#CompleteTheConfiguation
---+++ 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.

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 either of the 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.

<br /><img width="672" alt="ConfigureAPPXServices.png" src="%ATTACHURLPATH%/ConfigureAPPXServices.png" height="586" />

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.

<br /><img width="672" alt="AdvancedSettings.png" src="%ATTACHURLPATH%/AdvancedSettings.png" height="586" />
---+++ 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.

<br /><img width="672" alt="APPXSystemAdmins.png" src="%ATTACHURLPATH%/APPXSystemAdmins.png" height="586" />
---+++ Install Your APPX License Key

Finally, 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.

<br /><img width="672" alt="LicenseKey.png" src="%ATTACHURLPATH%/LicenseKey.png" height="586" />
---++++ 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:

<br /><img width="672" alt="ImportFromClipboard.png" src="%ATTACHURLPATH%/ImportFromClipboard.png" height="586" />
---+++++ Import From Named File

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

<br /><img width="672" alt="ImportFromNamedFile.png" src="%ATTACHURLPATH%/ImportFromNamedFile.png" height="586" />
---++++ 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.

<br /><img width="670" alt="WrongLicenseKeyVersion.PNG" src="%ATTACHURLPATH%/WrongLicenseKeyVersion.PNG" height="593" />
---++++ Enter License Key

The least efficient way to enter your registration is to manually enter the data. The information is case sensitive so enter the registration data exactly as it appears on your license key, including any spelling mistakes. 

<img alt="" src="webkit-fake-url://DED341EF-FDBC-4945-BBDF-961D149F5050/image.png" />

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

<img alt="" src="webkit-fake-url://1F53E538-EF7F-41E5-9596-4FAA764D85E7/image.png" />
---+++ Installation Completed

<br /><img width="672" alt="ConfigComplete.png" src="%ATTACHURLPATH%/ConfigComplete.png" height="586" />
---++ Comments:

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

<br />%COMMENT%

-- SteveFrizzell - 23 Oct 2008
This topic: Main > WebHome > APPX500InstallationInstructions > APPX500LinuxNewInstallation > APPX500NewInstallConfigAPPX
Topic revision: r7 - 2009-11-09 - JeanNeron