APPX 5.0.0 - Linux - Upgrade Installation

Overview

Two different methods are provided to install APPX on Linux. There is a GUI installer and a 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. 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".
2. Creates the destination directory and installs APPX into it.
3. Sets the appropriate permissions
4. 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

Convert Your System Administration Files

The first step of upgrading your APPX 4.2.a installation to APPX 5.0.0 is to convert your System Administration files to the new APPX 5.0.0 format. The System Administration files for APPX 4.2.a are not compatible with APPX 5.0.0 and must be converted to the APPX 5.0.0 format.

Install the Upgrade Application (GUI)

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

Download the installer for the APPX 4.2.a to APPX 5.0.0 upgrade application (APPX4to5upgrade_linux.sh) from the APPX web site or the APPX ftp server and save it to your Desktop or to any other suitable folder.

Change the permissions on the downloaded installer file (APPX4to5upgrade_linux.sh) to have Execute permissions.

Run the installer file (APPX4to5upgrade_linux.sh). If you are presented with a "Run or Display?" screen similar to the one below, click on the "Run" button.

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

Read the Installation Instructions and then click on the "Next" button to continue.

Specify the Destination Directory into which the upgrade utility is to be installed. The directory that you specify must be the directory where APPX 4.2.a is installed on your system. As a matter of convention, this directory is usually "/usr/local/appx/".

The APPX Upgrade Application (5SA Version 00) will then be installed into the specified destination directory.

When the installation wizard displays the final screen, click on the Finish button to end the installation wizard.

Configure the Upgrade Application

After installing the Upgrade Application, you must run APPX as an APPX System Administrator and configure the Upgrade Application.

Add the upgrade application (5SA 00) to the Applications file.

Add the database (5SA) for the Upgrade Application to the Databases file.

Run Database Management for the Upgrade Application and Database.

Run Create Files.

Run the Upgrade Application

After configuring the Upgrade Application, you must run the Upgrade Utility to convert your System Administration files.

Click on the "Convert" button to run the conversion utility.

The conversion utility will create a log. Specify the appropriate disposition options to print the conversion log.

The conversion log will inform you of any problems that may have been encountered while running the conversion utility.

GUI Installation on Linux

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

Download the APPX/Linux GUI installer (appxsetup.sh) from the APPX web site or the APPX ftp server and save it to your Desktop or to any other suitable folder.

Change the permissions on the downloaded installer file (appxsetup.sh) to have Execute permissions.

Run the installer file (appxsetup.sh). If you are presented with a "Run or Display?" screen similar to the one below, click on the "Run" button.

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

Read and accept the license agreement.

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.

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

APPX will then be installed into the specified destination directory.

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

When you click on the Finish button, the APPX Client will be launched to run APPX to complete the installation of the APPX environment.

Character Mode Installation on Linux

xxxxx

xxxxx

xxxxx

xxxxx

xxxxx

xxxxx

xxxxx

xxxxx

xxxxx

xxxxx

xxxxx

xxxxx

xxxxx

Run APPX to Complete the Installation

The first time that APPX is run after the installation wizard completes, you will need to complete the initial configuration of APPX.

Comments:

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

-- SteveFrizzell - 2 Nov 2009