Difference: APPX500LinuxUpgradeInstallation (1 vs. 23)

Revision 232021-08-23 - JoeOrtagus

Line: 1 to 1
 
META TOPICPARENT name="APPX500InstallationInstructions"

APPX Linux/Unix - APPX 5 Upgrade Instructions

Line: 158 to 158
 APPX 5.0.0 includes the new APPX Login Manager service. This service replaces the Connection Manager (appxd) which was included with APPX releases prior to APPX 5.0.0. The old Connection Manager will not work with APPX 5.0.0 and should not be used. You should remove appxd and start-appxd.sh from the tools directory since they are no longer needed. You should also remove any commands that might be run to start appxd during the boot process.

To configure and start the new APPX Login Manager service, log in as the root user and execute a command similar to the following:

Changed:
<
<
 /usr/local/appx/services/appxLoginMgr -install -name=appxLogin8060 -port=8060

>
>
 cd /usr/local/appx/services/
./appxLoginMgr -install -name=appxLogin8060 -port=8060
  Warning - the engine that you named has the setuid bit enabled, you may not want that bit set for the authentication

Revision 222019-02-12 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="APPX500InstallationInstructions"

APPX Linux/Unix - APPX 5 Upgrade Instructions

Line: 179 to 180
  After executing the above command, users should be able to use the APPX 5.x Desktop Client to successfully login on port 8060. For additional information on managing APPX Login Services, please refer to the complete documentation.

Final Tasks

Changed:
<
<
  1. Review your 'appx.env' file. Ensure any settings from 4.2.x are still there. Remove any obsolete settings.
>
>
  1. Review your 'appx.env' file. Ensure any settings you still need are there. However, remove any obsolete settings. In particular, do not set APPX_42_EPS, this will cause system wide problems with Page Up/Down.
 
  1. Create the new System Administration files ("System Administration/File Management/System Admin Files" on pull down menu).
  2. Upgrade Design Files
    • Remove the Structure files for each of your applications. It is not necessary to do this to the applications supplied with Appx (0AD, 0LA, 0DB, 0SA, 1EX, DMO, etc)

Revision 212014-12-05 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="APPX500InstallationInstructions"

APPX Linux/Unix - APPX 5 Upgrade Instructions

Line: 40 to 40
  Change the permissions on the downloaded installer file (APPX4to5upgrade_linux.sh) to have Execute permissions.
Changed:
<
<

SetExecutePermissions.png
>
>

SetExecutePermissions.png
  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.
Changed:
<
<

RunScript.png
>
>

RunScript.png
  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.
Changed:
<
<
Welcome.png
>
>
Welcome.png
  Read the Installation Instructions and then click on the "Next" button to continue.
Changed:
<
<

InstallationInstructions.png
>
>

InstallationInstructions.png
  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/".
Changed:
<
<

DestinationDirectory.png
>
>

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

InstallingFiles.png
>
>

InstallingFiles.png
  When the installation wizard displays the final screen, click on the Finish button to end the installation wizard.
Changed:
<
<

Finished.png
>
>

Finished.png
 

Character Mode Installation

Added:
>
>
 
If you don't have access to a GUI you can run the this 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.

# ./Appx4to5upgrade_linux.sh -c
Unpacking JRE ...
Preparing JRE ...
Starting Installer ...
This will install Appx 4.2 to 5.0 Upgrade Application on your computer.
OK [o, Enter], Cancel [c]

Line: 91 to 92
  Add the upgrade application (5SA 00) to the Applications file.
Changed:
<
<

Add5SAApplication.png
>
>

Add5SAApplication.png
  Create the Design Files for Application 5SA. APPX should report "File Already Exists" for each file. If not, the application was not installed in the correct location. Repeat the installation steps above, specifing the correct location
Changed:
<
<
Screen_shot_2009-11-10_at_2.46.40_PM.png
>
>
Screen_shot_2009-11-10_at_2.46.40_PM.png
  Add the database (5SA) for the Upgrade Application to the Databases file.
Changed:
<
<

Add5SADatabase.png
>
>

Add5SADatabase.png
  Run Database Management for the Upgrade Application and Database.
Changed:
<
<

DatabaseMgt.png
>
>

DatabaseMgt.png
  Run Create Files.
Changed:
<
<

RunCreateFiles.png
>
>

RunCreateFiles.png
 

Run the Upgrade Application

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

Changed:
<
<
RunDatabase5SA.png
>
>
RunDatabase5SA.png
  Click on the "Convert" button to run the conversion utility.
Changed:
<
<

ConversionUtility.png
>
>

ConversionUtility.png
  The conversion utility will create a log. Specify the appropriate disposition options to print the conversion log.
Changed:
<
<

ConversionLogDispositionScreen.png
>
>

ConversionLogDispositionScreen.png
  The conversion log will inform you of any problems that may have been encountered while running the conversion utility.
Changed:
<
<

ConversionLog.png
>
>

ConversionLog.png
 

Install the Upgraded System Administration Files

You are almost ready to install Release 5 on top of your existing installation. Before actually installing APPX, you should:

Line: 138 to 139
 You should also remove the System Administration structure files. You can use a "rm" command similar to the example below to remove your System Administration structure files. Be sure to edit the rm command to reference the directory where APPX is installed on your system if APPX is not installed in "/usr/local/appx".

rm -f /usr/local/appx/data/0SA/Struct/*

Changed:
<
<

Install APPX 5.0.0 or 5.1.0

>
>

Install APPX 5.x

 
Changed:
<
<
Now follow these steps to install APPX 5.0.0 or 5.1.0:
>
>
Now follow these steps to install APPX 5.x:
 
Changed:
<
<

Overview

Two different methods are provided to install APPX on Linux/Unix. 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, 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".
  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

GUI Installation on Linux/Unix

Log in to your 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. The following instructions will refer to the appxsetup.sh file, which is the name of the 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. if you are downloading directly from the ftp site, make sure you choose the correct installer for your O/S, and substitute your installer's name in the following instructions.

Change the permissions on the downloaded installer file to have Execute permissions.


InstallerProperties.png

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.


RunOrDisplay.png

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


WelcomeToSetupWizard.png

Read and accept the license agreement.


AcceptLicenseAgreement.png

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.


SelectDestinationDirectory.png

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


DirectoryAlreadyExists.png

APPX will then be installed into the specified destination directory.


InstallingFiles.png

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.


CompletingInstallation.png

When you click on the Finish button, an APPX session will be automatically launched to APPX500NewInstallConfigAPPX of the APPX environment.

Finally, if you intend to log into APPX as user "appx", then you must add a password for the "appx" o/s user that was created by the installer (use the "passwd appx" command).

After completing the above steps, you should be able to login to APPX as user "appx" from a remote desktop using the ADC.

Character Mode Installation

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.

On some systems the Java based installer may fail to run with a notice as shown below even though you are supplying the -c argument. In this case, make sure you have dejavu-sans-font package installed, and also that you have a non headless version of a JRE available to the installer. You can do that with the following yum command on RHEL8.

yum install dejavu-sans-fonts java-1.8.0-openjdk

Could not display the GUI. This application needs access to an X Server.
*******************************************************************
You can also run this application in console mode without
access to an X server by passing the argument -c
*******************************************************************
[root@rhel8 Downloads]#

# ./appxsetup.sh -c

Unpacking JRE ...
Preparing JRE ...
Starting Installer ...
This will install Appx on your computer.
OK [o, Enter], Cancel [c]


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 5.0.0

_ Important! _

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.

.
.
.
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?

[/appx50]

Create a desktop icon?

Yes [y, Enter], No [n]

Create a Quick Launch icon?

Yes [y, Enter], No [n]


>
>

Overview

Two different methods are provided to install APPX on Linux/Unix. 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, 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".
  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

GUI Installation on Linux/Unix

Log in to your 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. The following instructions will refer to the appxsetup.sh file, which is the name of the 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. if you are downloading directly from the ftp site, make sure you choose the correct installer for your O/S, and substitute your installer's name in the following instructions.

Change the permissions on the downloaded installer file to have Execute permissions.


InstallerProperties.png

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.


RunOrDisplay.png

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


WelcomeToSetupWizard.png

Read and accept the license agreement.


AcceptLicenseAgreement.png

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.


SelectDestinationDirectory.png

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


DirectoryAlreadyExists.png

APPX will then be installed into the specified destination directory.


InstallingFiles.png

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.


CompletingInstallation.png

When you click on the Finish button, an APPX session will be automatically launched to APPX500NewInstallConfigAPPX of the APPX environment.

Finally, if you intend to log into APPX as user "appx", then you must add a password for the "appx" o/s user that was created by the installer (use the "passwd appx" command).

After completing the above steps, you should be able to login to APPX as user "appx" from a remote desktop using the ADC.

Character Mode Installation

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.

On some systems the Java based installer may fail to run with a notice as shown below even though you are supplying the -c argument. In this case, make sure you have dejavu-sans-font package installed, and also that you have a non headless version of a JRE available to the installer. You can do that with the following yum command on RHEL8.

yum install dejavu-sans-fonts java-1.8.0-openjdk

Could not display the GUI. This application needs access to an X Server.
*******************************************************************
You can also run this application in console mode without
access to an X server by passing the argument -c
*******************************************************************
[root@rhel8 Downloads]#

# ./appxsetup.sh -c

Unpacking JRE ...
Preparing JRE ...
Starting Installer ...
This will install Appx on your computer.
OK [o, Enter], Cancel [c]


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 5.0.0

_ Important! _

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.

.
.
.
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?

[/appx50]

Create a desktop icon?

Yes [y, Enter], No [n]

Create a Quick Launch icon?

Yes [y, Enter], No [n]


 

Install a new APPX 5.x License Key

Log on to your Linux system as a user who is an APPX System Administrator. Then start a local APPX session by running client-local.sh. You should be presented with the following System Registration screen. Notice that the Effective Date field on this registration is blank. Starting with APPX 5.0.0, all License Keys include an Effective Date. You must install an updated License Key before you will be able to run APPX 5.0.0 or higher. Note that in Release 5 and higher you can copy your registration to the clipboard, and APPX will detect it when you choose "Typical Import" from the "Import Menu" below.

Changed:
<
<

LicenseKey.png
>
>

LicenseKey.png
 
Changed:
<
<
After installing a new 5.0.0 License Key, your System Registration screen should include an Effective Date.
>
>
After installing a new 5.x License Key, your System Registration screen should include an Effective Date.
 
Changed:
<
<

LicenseKey500.png
>
>

LicenseKey500.png
 

Configure the new APPX Login Manager

APPX 5.0.0 includes the new APPX Login Manager service. This service replaces the Connection Manager (appxd) which was included with APPX releases prior to APPX 5.0.0. The old Connection Manager will not work with APPX 5.0.0 and should not be used. You should remove appxd and start-appxd.sh from the tools directory since they are no longer needed. You should also remove any commands that might be run to start appxd during the boot process.

Line: 177 to 177
 up and running (process 31754 servicing port 8060) Installation Complete_
Changed:
<
<
After executing the above command, users should be able to use the APPX 5.0.0 Desktop Client to successfully login on port 8060. For additional information on managing APPX Login Services, please refer to the complete documentation.
>
>
After executing the above command, users should be able to use the APPX 5.x Desktop Client to successfully login on port 8060. For additional information on managing APPX Login Services, please refer to the complete documentation.
 

Final Tasks

  1. Review your 'appx.env' file. Ensure any settings from 4.2.x are still there. Remove any obsolete settings.
  2. Create the new System Administration files ("System Administration/File Management/System Admin Files" on pull down menu).

Revision 202012-06-21 - JoeOrtagus

Line: 1 to 1
 
META TOPICPARENT name="APPX500InstallationInstructions"

APPX Linux/Unix - APPX 5 Upgrade Instructions

Line: 140 to 138
 You should also remove the System Administration structure files. You can use a "rm" command similar to the example below to remove your System Administration structure files. Be sure to edit the rm command to reference the directory where APPX is installed on your system if APPX is not installed in "/usr/local/appx".

rm -f /usr/local/appx/data/0SA/Struct/*

Changed:
<
<

Install APPX 5.0.0

>
>

Install APPX 5.0.0 or 5.1.0

 
Changed:
<
<
Now follow these steps to install APPX 5.0.0:
>
>
Now follow these steps to install APPX 5.0.0 or 5.1.0:
 

Overview

Two different methods are provided to install APPX on Linux/Unix. 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, 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".
  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

GUI Installation on Linux/Unix

Log in to your 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. The following instructions will refer to the appxsetup.sh file, which is the name of the 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. if you are downloading directly from the ftp site, make sure you choose the correct installer for your O/S, and substitute your installer's name in the following instructions.

Change the permissions on the downloaded installer file to have Execute permissions.


InstallerProperties.png

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.


RunOrDisplay.png

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


WelcomeToSetupWizard.png

Read and accept the license agreement.


AcceptLicenseAgreement.png

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.


SelectDestinationDirectory.png

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


DirectoryAlreadyExists.png

APPX will then be installed into the specified destination directory.


InstallingFiles.png

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.


CompletingInstallation.png

When you click on the Finish button, an APPX session will be automatically launched to APPX500NewInstallConfigAPPX of the APPX environment.

Finally, if you intend to log into APPX as user "appx", then you must add a password for the "appx" o/s user that was created by the installer (use the "passwd appx" command).

After completing the above steps, you should be able to login to APPX as user "appx" from a remote desktop using the ADC.

Character Mode Installation

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.

On some systems the Java based installer may fail to run with a notice as shown below even though you are supplying the -c argument. In this case, make sure you have dejavu-sans-font package installed, and also that you have a non headless version of a JRE available to the installer. You can do that with the following yum command on RHEL8.

yum install dejavu-sans-fonts java-1.8.0-openjdk

Could not display the GUI. This application needs access to an X Server.
*******************************************************************
You can also run this application in console mode without
access to an X server by passing the argument -c
*******************************************************************
[root@rhel8 Downloads]#

# ./appxsetup.sh -c

Unpacking JRE ...
Preparing JRE ...
Starting Installer ...
This will install Appx on your computer.
OK [o, Enter], Cancel [c]


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 5.0.0

_ Important! _

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.

.
.
.
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?

[/appx50]

Create a desktop icon?

Yes [y, Enter], No [n]

Create a Quick Launch icon?

Yes [y, Enter], No [n]


Changed:
<
<

Install a new APPX 5.0.0 License Key

>
>

Install a new APPX 5.x License Key

  Log on to your Linux system as a user who is an APPX System Administrator. Then start a local APPX session by running client-local.sh. You should be presented with the following System Registration screen. Notice that the Effective Date field on this registration is blank. Starting with APPX 5.0.0, all License Keys include an Effective Date. You must install an updated License Key before you will be able to run APPX 5.0.0 or higher. Note that in Release 5 and higher you can copy your registration to the clipboard, and APPX will detect it when you choose "Typical Import" from the "Import Menu" below.

Revision 192011-03-25 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="APPX500InstallationInstructions"

APPX Linux/Unix - APPX 5 Upgrade Instructions

Line: 181 to 181
  After executing the above command, users should be able to use the APPX 5.0.0 Desktop Client to successfully login on port 8060. For additional information on managing APPX Login Services, please refer to the complete documentation.

Final Tasks

Added:
>
>
  1. Review your 'appx.env' file. Ensure any settings from 4.2.x are still there. Remove any obsolete settings.
 
  1. Create the new System Administration files ("System Administration/File Management/System Admin Files" on pull down menu).
  2. Upgrade Design Files
    • Remove the Structure files for each of your applications. It is not necessary to do this to the applications supplied with Appx (0AD, 0LA, 0DB, 0SA, 1EX, DMO, etc)

Revision 182010-11-11 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="APPX500InstallationInstructions"

APPX Linux/Unix - APPX 5 Upgrade Instructions

Line: 187 to 187
 
    • Run Create Files for each of your applications
    • Run 'Sync Widget Elements' for each of your applications. This is optional, as APPX will force you to do this the first time you go into an application after installing Release 5.0
    • Run 'Load Initial Audit History' for each of your applications. This is optional, as APPX will automatically build the history as you make changes to your application. For example, the first time you go into INPUTs, APPX will see that the audit history is missing and it will create it as it reads the input process records. Regardless of whether you run this, APPX will start keeping a detailed audit history of changes in applications from this point on. However, you should decide now whether to run this step now or not. If audit information already exists in the audit file when you run this step, it will duplicate the data.
Added:
>
>
    • Run 'Sync Design Elements' for each of your applications.
 
  1. Install the new APPX Desktop Client for all users
  2. Configure new features as desired

Comments:

Revision 172010-02-23 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="APPX500InstallationInstructions"

APPX Linux/Unix - APPX 5 Upgrade Instructions

Line: 183 to 183
 

Final Tasks

  1. Create the new System Administration files ("System Administration/File Management/System Admin Files" on pull down menu).
  2. Upgrade Design Files
Changed:
<
<
    • Remove the Structure files for each application
    • Run Create Files for each application
    • Run 'Sync Widget Elements' for each application. This is optional, as APPX will force you to do this the first time you go into an application after installing Release 5.0
    • Run 'Load Initial Audit History' for each application. This is optional, as APPX will automatically build the history as you make changes to your application. For example, the first time you go into INPUTs, APPX will see that the audit history is missing and it will create it as it reads the input process records. Regardless of whether you run this, APPX will start keeping a detailed audit history of changes in applications from this point on. However, you should decide now whether to run this step now or not. If audit information already exists in the audit file when you run this step, it will duplicate the data.
>
>
    • Remove the Structure files for each of your applications. It is not necessary to do this to the applications supplied with Appx (0AD, 0LA, 0DB, 0SA, 1EX, DMO, etc)
    • Run Create Files for each of your applications
    • Run 'Sync Widget Elements' for each of your applications. This is optional, as APPX will force you to do this the first time you go into an application after installing Release 5.0
    • Run 'Load Initial Audit History' for each of your applications. This is optional, as APPX will automatically build the history as you make changes to your application. For example, the first time you go into INPUTs, APPX will see that the audit history is missing and it will create it as it reads the input process records. Regardless of whether you run this, APPX will start keeping a detailed audit history of changes in applications from this point on. However, you should decide now whether to run this step now or not. If audit information already exists in the audit file when you run this step, it will duplicate the data.
 
  1. Install the new APPX Desktop Client for all users
  2. Configure new features as desired

Comments:

Revision 162010-02-01 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="APPX500InstallationInstructions"

APPX Linux/Unix - APPX 5 Upgrade Instructions

Line: 49 to 49
  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.
Changed:
<
<

Welcome.png</script><script type="text/javascript" src="http://wiki.appx.com/wiki/pub/TWiki/TinyMCEPlugin/tinymce/jscripts/tiny_mce/plugins/twikibuttons/langs/en.js"></script><script type="text/javascript" src="http://wiki.appx.com/wiki/pub/TWiki/TinyMCEPlugin/tinymce/jscripts/tiny_mce/plugins/twikiimage/langs/en.js"></script>37;ATTACHURLPATH%/Welcome.png" height="390" />
>
>
Welcome.png
  Read the Installation Instructions and then click on the "Next" button to continue.

Revision 152010-01-30 - RayPelegrino

Line: 1 to 1
 
META TOPICPARENT name="APPX500InstallationInstructions"

APPX Linux/Unix - APPX 5 Upgrade Instructions

Changed:
<
<
Esta pagina tiene contenidos de age provides the information needed to upgrade an existing APPX 4.2.a Linux/Unix installation to APPX 5.
>
>
This page provides the information needed to upgrade an existing APPX 4.2.a Linux/Unix installation to APPX 5.
 

Overview

Changed:
<
<
>
>

 
Changed:
<
<
Warning - These instructions specifically apply to upgrading from APPX 4.2.a to APPX 5. If you are upgrading from an older release of APPX, these instructions may not be applicable. You should consider upgrading to APPX 4.2.a first and then upgrading to APPX 5.
>
>
Warning - These instructions specifically apply to upgrading from APPX 4.2.a to APPX 5. If you are upgrading from an older release of APPX, these instructions may not be applicable. You should consider upgrading to APPX 4.2.a first and then upgrading to APPX 5.
  To upgrade your existing APPX Linux/Unix installation from APPX 4.2.a to APPX 5, you must complete the following steps:
Line: 50 to 49
  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.
Changed:
<
<

<img width="500" alt="Welcome.png" src="37;ATTACHURLPATH%/Welcome.png" height="390" />
>
>

Welcome.png</script><script type="text/javascript" src="http://wiki.appx.com/wiki/pub/TWiki/TinyMCEPlugin/tinymce/jscripts/tiny_mce/plugins/twikibuttons/langs/en.js"></script><script type="text/javascript" src="http://wiki.appx.com/wiki/pub/TWiki/TinyMCEPlugin/tinymce/jscripts/tiny_mce/plugins/twikiimage/langs/en.js"></script>37;ATTACHURLPATH%/Welcome.png" height="390" />
  Read the Installation Instructions and then click on the "Next" button to continue.
Line: 145 to 144
  Now follow these steps to install APPX 5.0.0:
Changed:
<
<

Overview

Two different methods are provided to install APPX on Linux/Unix. 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, 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".
  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

GUI Installation on Linux/Unix

Log in to your 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. The following instructions will refer to the appxsetup.sh file, which is the name of the 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. if you are downloading directly from the ftp site, make sure you choose the correct installer for your O/S, and substitute your installer's name in the following instructions.

Change the permissions on the downloaded installer file to have Execute permissions.


InstallerProperties.png

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.


RunOrDisplay.png

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


WelcomeToSetupWizard.png

Read and accept the license agreement.


AcceptLicenseAgreement.png

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.


SelectDestinationDirectory.png

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


DirectoryAlreadyExists.png

APPX will then be installed into the specified destination directory.


InstallingFiles.png

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.


CompletingInstallation.png

When you click on the Finish button, an APPX session will be automatically launched to APPX500NewInstallConfigAPPX of the APPX environment.

Finally, if you intend to log into APPX as user "appx", then you must add a password for the "appx" o/s user that was created by the installer (use the "passwd appx" command).

After completing the above steps, you should be able to login to APPX as user "appx" from a remote desktop using the ADC.

Character Mode Installation

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.

On some systems the Java based installer may fail to run with a notice as shown below even though you are supplying the -c argument. In this case, make sure you have dejavu-sans-font package installed, and also that you have a non headless version of a JRE available to the installer. You can do that with the following yum command on RHEL8.

yum install dejavu-sans-fonts java-1.8.0-openjdk

Could not display the GUI. This application needs access to an X Server.
*******************************************************************
You can also run this application in console mode without
access to an X server by passing the argument -c
*******************************************************************
[root@rhel8 Downloads]#

# ./appxsetup.sh -c

Unpacking JRE ...
Preparing JRE ...
Starting Installer ...
This will install Appx on your computer.
OK [o, Enter], Cancel [c]


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 5.0.0

_ Important! _

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.

.
.
.
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?

[/appx50]

Create a desktop icon?

Yes [y, Enter], No [n]

Create a Quick Launch icon?

Yes [y, Enter], No [n]


>
>

Overview

Two different methods are provided to install APPX on Linux/Unix. 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, 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".
  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

GUI Installation on Linux/Unix

Log in to your 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. The following instructions will refer to the appxsetup.sh file, which is the name of the 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. if you are downloading directly from the ftp site, make sure you choose the correct installer for your O/S, and substitute your installer's name in the following instructions.

Change the permissions on the downloaded installer file to have Execute permissions.


InstallerProperties.png

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.


RunOrDisplay.png

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


WelcomeToSetupWizard.png

Read and accept the license agreement.


AcceptLicenseAgreement.png

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.


SelectDestinationDirectory.png

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


DirectoryAlreadyExists.png

APPX will then be installed into the specified destination directory.


InstallingFiles.png

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.


CompletingInstallation.png

When you click on the Finish button, an APPX session will be automatically launched to APPX500NewInstallConfigAPPX of the APPX environment.

Finally, if you intend to log into APPX as user "appx", then you must add a password for the "appx" o/s user that was created by the installer (use the "passwd appx" command).

After completing the above steps, you should be able to login to APPX as user "appx" from a remote desktop using the ADC.

Character Mode Installation

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.

On some systems the Java based installer may fail to run with a notice as shown below even though you are supplying the -c argument. In this case, make sure you have dejavu-sans-font package installed, and also that you have a non headless version of a JRE available to the installer. You can do that with the following yum command on RHEL8.

yum install dejavu-sans-fonts java-1.8.0-openjdk

Could not display the GUI. This application needs access to an X Server.
*******************************************************************
You can also run this application in console mode without
access to an X server by passing the argument -c
*******************************************************************
[root@rhel8 Downloads]#

# ./appxsetup.sh -c

Unpacking JRE ...
Preparing JRE ...
Starting Installer ...
This will install Appx on your computer.
OK [o, Enter], Cancel [c]


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 5.0.0

_ Important! _

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.

.
.
.
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?

[/appx50]

Create a desktop icon?

Yes [y, Enter], No [n]

Create a Quick Launch icon?

Yes [y, Enter], No [n]


 

Install a new APPX 5.0.0 License Key

Log on to your Linux system as a user who is an APPX System Administrator. Then start a local APPX session by running client-local.sh. You should be presented with the following System Registration screen. Notice that the Effective Date field on this registration is blank. Starting with APPX 5.0.0, all License Keys include an Effective Date. You must install an updated License Key before you will be able to run APPX 5.0.0 or higher. Note that in Release 5 and higher you can copy your registration to the clipboard, and APPX will detect it when you choose "Typical Import" from the "Import Menu" below.

Line: 161 to 160
  To configure and start the new APPX Login Manager service, log in as the root user and execute a command similar to the following:
Changed:
<
<
 /usr/local/appx/services/appxLoginMgr -install -name=appxLogin8060 -port=8060
>
>
 /usr/local/appx/services/appxLoginMgr -install -name=appxLogin8060 -port=8060

  Warning - the engine that you named has the setuid bit enabled, you may not want that bit set for the authentication
Line: 178 to 177
  method that you have chosen (OS-User) To turn off the setuid bit, chmod u-s ../appx up and running (process 31754 servicing port 8060)
Changed:
<
<
Installation Complete_
>
>
Installation Complete_
  After executing the above command, users should be able to use the APPX 5.0.0 Desktop Client to successfully login on port 8060. For additional information on managing APPX Login Services, please refer to the complete documentation.

Final Tasks

Line: 197 to 196
  Did an AIX upgrade, ran into the following: - when using the character installer, the permissions were not set. Had to manually change ownership & set sticky bit. - using 'ssh -X user@host' and then trying to run either client-local or client.sh did not work. The ADC would hang at 'Negotiating GUI something or other' - When trying to create new Sys Admin files, got error about Invalid Prototype Record Length on SYSDFLT. Scratched all Ems/Dbgs for the 0-apps and problem went away.
Changed:
<
<
-- JeanNeron - 2010-01-27
<--/commentPlugin-->
>
>
-- JeanNeron - 2010-01-27
<--/commentPlugin-->
  -- SteveFrizzell - 2 Nov 2009

Revision 142010-01-29 - RayPelegrino

Line: 1 to 1
 
META TOPICPARENT name="APPX500InstallationInstructions"

APPX Linux/Unix - APPX 5 Upgrade Instructions

Changed:
<
<
This page provides the information needed to upgrade an existing APPX 4.2.a Linux/Unix installation to APPX 5.
>
>
Esta pagina tiene contenidos de age provides the information needed to upgrade an existing APPX 4.2.a Linux/Unix installation to APPX 5.
 

Overview

Line: 195 to 195
 Read what other users have said about this page or add your own comments.
Changed:
<
<

Did an AIX upgrade, ran into the following: - when using the character installer, the permissions were not set. Had to manually change ownership & set sticky bit. - using 'ssh -X user@host' and then trying to run either client-local or client.sh did not work. The ADC would hang at 'Negotiating GUI something or other' - When trying to create new Sys Admin files, got error about Invalid Prototype Record Length on SYSDFLT. Scratched all Ems/Dbgs for the 0-apps and problem went away.

>
>
Did an AIX upgrade, ran into the following: - when using the character installer, the permissions were not set. Had to manually change ownership & set sticky bit. - using 'ssh -X user@host' and then trying to run either client-local or client.sh did not work. The ADC would hang at 'Negotiating GUI something or other' - When trying to create new Sys Admin files, got error about Invalid Prototype Record Length on SYSDFLT. Scratched all Ems/Dbgs for the 0-apps and problem went away.
  -- JeanNeron - 2010-01-27
<--/commentPlugin-->

Revision 132010-01-27 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="APPX500InstallationInstructions"

APPX Linux/Unix - APPX 5 Upgrade Instructions

Line: 195 to 195
 Read what other users have said about this page or add your own comments.
Changed:
<
<

<--/commentPlugin-->
>
>

Did an AIX upgrade, ran into the following: - when using the character installer, the permissions were not set. Had to manually change ownership & set sticky bit. - using 'ssh -X user@host' and then trying to run either client-local or client.sh did not work. The ADC would hang at 'Negotiating GUI something or other' - When trying to create new Sys Admin files, got error about Invalid Prototype Record Length on SYSDFLT. Scratched all Ems/Dbgs for the 0-apps and problem went away.

-- JeanNeron - 2010-01-27

<--/commentPlugin-->
  -- SteveFrizzell - 2 Nov 2009

Revision 122009-12-10 - SteveFrizzell

Line: 1 to 1
 
META TOPICPARENT name="APPX500InstallationInstructions"

APPX Linux/Unix - APPX 5 Upgrade Instructions

Line: 129 to 129
 
ConversionLog.png

Install the Upgraded System Administration Files

Added:
>
>
You are almost ready to install Release 5 on top of your existing installation. Before actually installing APPX, you should:
  1. Terminate (kill) the APPX Connection Manager (appxd)
  2. Terminate (kill) any APPX sessions that are still active (there shouldn't be any if everyone has logged off)
  3. Terminate (kill) the APPX License Server session
 Before you install the APPX Utility, you must first replace your old System Administration files with the new System Administration files that were created when you ran the upgrade utility to convert your System Administration files to the new APPX 5.0.0 structure. You can use a "cp" command similar to the example below to replace your old System Administration with the upgraded files. Be sure to edit the copy command to reference the directory where APPX is installed on your system if APPX is not installed in "/usr/local/appx".

cp -f /usr/local/appx/data/5SA/5SA/Data/* /usr/local/appx/data/0SA/Data

Line: 136 to 141
 You should also remove the System Administration structure files. You can use a "rm" command similar to the example below to remove your System Administration structure files. Be sure to edit the rm command to reference the directory where APPX is installed on your system if APPX is not installed in "/usr/local/appx".

rm -f /usr/local/appx/data/0SA/Struct/*

Added:
>
>

Install APPX 5.0.0

 
Changed:
<
<
You are now ready to install Release 5 on top of your existing installation. Before actually installing APPX, you should:
  1. Terminate (kill) the APPX Connection Manager (appxd)
  2. Terminate (kill) any APPX sessions that are still active (there shouldn't be any if everyone has logged off)
  3. Terminate (kill) the APPX License Server session

Then follow these steps:

>
>
Now follow these steps to install APPX 5.0.0:
 

Overview

Two different methods are provided to install APPX on Linux/Unix. 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, 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".
  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

GUI Installation on Linux/Unix

Log in to your 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. The following instructions will refer to the appxsetup.sh file, which is the name of the 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. if you are downloading directly from the ftp site, make sure you choose the correct installer for your O/S, and substitute your installer's name in the following instructions.

Change the permissions on the downloaded installer file to have Execute permissions.


InstallerProperties.png

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.


RunOrDisplay.png

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


WelcomeToSetupWizard.png

Read and accept the license agreement.


AcceptLicenseAgreement.png

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.


SelectDestinationDirectory.png

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


DirectoryAlreadyExists.png

APPX will then be installed into the specified destination directory.


InstallingFiles.png

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.


CompletingInstallation.png

When you click on the Finish button, an APPX session will be automatically launched to APPX500NewInstallConfigAPPX of the APPX environment.

Finally, if you intend to log into APPX as user "appx", then you must add a password for the "appx" o/s user that was created by the installer (use the "passwd appx" command).

After completing the above steps, you should be able to login to APPX as user "appx" from a remote desktop using the ADC.

Character Mode Installation

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.

On some systems the Java based installer may fail to run with a notice as shown below even though you are supplying the -c argument. In this case, make sure you have dejavu-sans-font package installed, and also that you have a non headless version of a JRE available to the installer. You can do that with the following yum command on RHEL8.

yum install dejavu-sans-fonts java-1.8.0-openjdk

Could not display the GUI. This application needs access to an X Server.
*******************************************************************
You can also run this application in console mode without
access to an X server by passing the argument -c
*******************************************************************
[root@rhel8 Downloads]#

# ./appxsetup.sh -c

Unpacking JRE ...
Preparing JRE ...
Starting Installer ...
This will install Appx on your computer.
OK [o, Enter], Cancel [c]


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 5.0.0

_ Important! _

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.

.
.
.
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?

[/appx50]

Create a desktop icon?

Yes [y, Enter], No [n]

Create a Quick Launch icon?

Yes [y, Enter], No [n]


Install a new APPX 5.0.0 License Key

Revision 112009-12-08 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="APPX500InstallationInstructions"
Changed:
<
<
&#---+ APPX Linux/Unix - APPX 5 Upgrade Instructions
>
>

APPX Linux/Unix - APPX 5 Upgrade Instructions

  This page provides the information needed to upgrade an existing APPX 4.2.a Linux/Unix installation to APPX 5.
Line: 27 to 27
 
    • System Administration Files
    • Design Files
    • Data Files
Deleted:
<
<
  1. Terminate (kill) the APPX Connection Manager (appxd)
  2. Terminate (kill) any APPX sessions that are still active (there shouldn't be any if everyone has logged off)
  3. Terminate (kill) the APPX License Server session
 
  1. Backup your system

Line: 140 to 137
  rm -f /usr/local/appx/data/0SA/Struct/*
Changed:
<
<
You are now ready to install Release 5 on top of your existing installation. Follow these steps:
>
>
You are now ready to install Release 5 on top of your existing installation. Before actually installing APPX, you should:
  1. Terminate (kill) the APPX Connection Manager (appxd)
  2. Terminate (kill) any APPX sessions that are still active (there shouldn't be any if everyone has logged off)
  3. Terminate (kill) the APPX License Server session

Then follow these steps:

 

Overview

Two different methods are provided to install APPX on Linux/Unix. 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, 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".
  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

GUI Installation on Linux/Unix

Log in to your 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. The following instructions will refer to the appxsetup.sh file, which is the name of the 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. if you are downloading directly from the ftp site, make sure you choose the correct installer for your O/S, and substitute your installer's name in the following instructions.

Change the permissions on the downloaded installer file to have Execute permissions.


InstallerProperties.png

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.


RunOrDisplay.png

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


WelcomeToSetupWizard.png

Read and accept the license agreement.


AcceptLicenseAgreement.png

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.


SelectDestinationDirectory.png

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


DirectoryAlreadyExists.png

APPX will then be installed into the specified destination directory.


InstallingFiles.png

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.


CompletingInstallation.png

When you click on the Finish button, an APPX session will be automatically launched to APPX500NewInstallConfigAPPX of the APPX environment.

Finally, if you intend to log into APPX as user "appx", then you must add a password for the "appx" o/s user that was created by the installer (use the "passwd appx" command).

After completing the above steps, you should be able to login to APPX as user "appx" from a remote desktop using the ADC.

Character Mode Installation

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.

On some systems the Java based installer may fail to run with a notice as shown below even though you are supplying the -c argument. In this case, make sure you have dejavu-sans-font package installed, and also that you have a non headless version of a JRE available to the installer. You can do that with the following yum command on RHEL8.

yum install dejavu-sans-fonts java-1.8.0-openjdk

Could not display the GUI. This application needs access to an X Server.
*******************************************************************
You can also run this application in console mode without
access to an X server by passing the argument -c
*******************************************************************
[root@rhel8 Downloads]#

# ./appxsetup.sh -c

Unpacking JRE ...
Preparing JRE ...
Starting Installer ...
This will install Appx on your computer.
OK [o, Enter], Cancel [c]


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 5.0.0

_ Important! _

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.

.
.
.
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?

[/appx50]

Create a desktop icon?

Yes [y, Enter], No [n]

Create a Quick Launch icon?

Yes [y, Enter], No [n]


Install a new APPX 5.0.0 License Key

Revision 102009-11-20 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="APPX500InstallationInstructions"
Changed:
<
<

APPX Linux/Unix - APPX 5 Upgrade Instructions

>
>
&#---+ APPX Linux/Unix - APPX 5 Upgrade Instructions
  This page provides the information needed to upgrade an existing APPX 4.2.a Linux/Unix installation to APPX 5.
Line: 53 to 53
  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.
Changed:
<
<

Welcome.png
>
>

<img width="500" alt="Welcome.png" src="37;ATTACHURLPATH%/Welcome.png" height="390" />
  Read the Installation Instructions and then click on the "Next" button to continue.
Line: 185 to 185
 
    • Run Create Files for each application
    • Run 'Sync Widget Elements' for each application. This is optional, as APPX will force you to do this the first time you go into an application after installing Release 5.0
    • Run 'Load Initial Audit History' for each application. This is optional, as APPX will automatically build the history as you make changes to your application. For example, the first time you go into INPUTs, APPX will see that the audit history is missing and it will create it as it reads the input process records. Regardless of whether you run this, APPX will start keeping a detailed audit history of changes in applications from this point on. However, you should decide now whether to run this step now or not. If audit information already exists in the audit file when you run this step, it will duplicate the data.
Changed:
<
<
  1. Upgrade APPX Desktop Client for all users
>
>
  1. Install the new APPX Desktop Client for all users
 
  1. Configure new features as desired

Comments:

Revision 92009-11-17 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="APPX500InstallationInstructions"

APPX Linux/Unix - APPX 5 Upgrade Instructions

Line: 179 to 179
  After executing the above command, users should be able to use the APPX 5.0.0 Desktop Client to successfully login on port 8060. For additional information on managing APPX Login Services, please refer to the complete documentation.

Final Tasks

Added:
>
>
  1. Create the new System Administration files ("System Administration/File Management/System Admin Files" on pull down menu).
 
  1. Upgrade Design Files
    • Remove the Structure files for each application
    • Run Create Files for each application
    • Run 'Sync Widget Elements' for each application. This is optional, as APPX will force you to do this the first time you go into an application after installing Release 5.0
    • Run 'Load Initial Audit History' for each application. This is optional, as APPX will automatically build the history as you make changes to your application. For example, the first time you go into INPUTs, APPX will see that the audit history is missing and it will create it as it reads the input process records. Regardless of whether you run this, APPX will start keeping a detailed audit history of changes in applications from this point on. However, you should decide now whether to run this step now or not. If audit information already exists in the audit file when you run this step, it will duplicate the data.
Deleted:
<
<
  1. Create the new System Administration files ("System Administration/File Management/System Admin Files" on pull down menu).
 
  1. Upgrade APPX Desktop Client for all users
  2. Configure new features as desired

Comments:

Revision 82009-11-12 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="APPX500InstallationInstructions"

APPX Linux/Unix - APPX 5 Upgrade Instructions

Line: 14 to 14
  To upgrade your existing APPX Linux/Unix installation from APPX 4.2.a to APPX 5, you must complete the following steps:
Changed:
<
<
  1. Preliminary Tasks
>
>
  1. Obtain a new Release 5.0 License from your Reseller or Distributor
  2. Complete the preliminary tasks
 
  1. Convert Your System Administration Files
  2. Install the APPX Utility upgrade
  3. Install a new APPX 5.0.0 License Key
Line: 70 to 71
 
Finished.png

Character Mode Installation

Changed:
<
<
If you don't have access to a GUI (on either Windows or Linux/Unix), you can run the this 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.
>
>
If you don't have access to a GUI you can run the this 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.
  # ./Appx4to5upgrade_linux.sh -c
Unpacking JRE ...
Preparing JRE ...
Starting Installer ...
This will install Appx 4.2 to 5.0 Upgrade Application on your computer.
OK [o, Enter], Cancel [c]

Line: 133 to 134
  Before you install the APPX Utility, you must first replace your old System Administration files with the new System Administration files that were created when you ran the upgrade utility to convert your System Administration files to the new APPX 5.0.0 structure. You can use a "cp" command similar to the example below to replace your old System Administration with the upgraded files. Be sure to edit the copy command to reference the directory where APPX is installed on your system if APPX is not installed in "/usr/local/appx".
Changed:
<
<
cp -f /usr/local/appx/data/5SA/5SA/Data/ /usr/local/appx/data/0SA/Data*
>
>
cp -f /usr/local/appx/data/5SA/5SA/Data/* /usr/local/appx/data/0SA/Data
  You should also remove the System Administration structure files. You can use a "rm" command similar to the example below to remove your System Administration structure files. Be sure to edit the rm command to reference the directory where APPX is installed on your system if APPX is not installed in "/usr/local/appx".
Line: 144 to 145
 

Overview

Two different methods are provided to install APPX on Linux/Unix. 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, 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".
  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

GUI Installation on Linux/Unix

Log in to your 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. The following instructions will refer to the appxsetup.sh file, which is the name of the 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. if you are downloading directly from the ftp site, make sure you choose the correct installer for your O/S, and substitute your installer's name in the following instructions.

Change the permissions on the downloaded installer file to have Execute permissions.


InstallerProperties.png

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.


RunOrDisplay.png

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


WelcomeToSetupWizard.png

Read and accept the license agreement.


AcceptLicenseAgreement.png

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.


SelectDestinationDirectory.png

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


DirectoryAlreadyExists.png

APPX will then be installed into the specified destination directory.


InstallingFiles.png

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.


CompletingInstallation.png

When you click on the Finish button, an APPX session will be automatically launched to APPX500NewInstallConfigAPPX of the APPX environment.

Finally, if you intend to log into APPX as user "appx", then you must add a password for the "appx" o/s user that was created by the installer (use the "passwd appx" command).

After completing the above steps, you should be able to login to APPX as user "appx" from a remote desktop using the ADC.

Character Mode Installation

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.

On some systems the Java based installer may fail to run with a notice as shown below even though you are supplying the -c argument. In this case, make sure you have dejavu-sans-font package installed, and also that you have a non headless version of a JRE available to the installer. You can do that with the following yum command on RHEL8.

yum install dejavu-sans-fonts java-1.8.0-openjdk

Could not display the GUI. This application needs access to an X Server.
*******************************************************************
You can also run this application in console mode without
access to an X server by passing the argument -c
*******************************************************************
[root@rhel8 Downloads]#

# ./appxsetup.sh -c

Unpacking JRE ...
Preparing JRE ...
Starting Installer ...
This will install Appx on your computer.
OK [o, Enter], Cancel [c]


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 5.0.0

_ Important! _

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.

.
.
.
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?

[/appx50]

Create a desktop icon?

Yes [y, Enter], No [n]

Create a Quick Launch icon?

Yes [y, Enter], No [n]


Install a new APPX 5.0.0 License Key

Changed:
<
<
Log On to your Linux system as a user who is an APPX System Administrator. Then start a local APPX session by running client-local.sh. You should be presented with the following System Registration screen. Notice that the Effective Date field on this registration is blank. Starting with APPX 5.0.0, all License Keys include an Effective Date. You must install an updated License Key before you will be able to run APPX 5.0.0. If you have an updated License Key for your system, you should install it now. Note that in Release 5 and higher you can copy your registration to the clipboard, and APPX will detect it when you choose "Typical Import" from the "Import Menu" below.
>
>
Log on to your Linux system as a user who is an APPX System Administrator. Then start a local APPX session by running client-local.sh. You should be presented with the following System Registration screen. Notice that the Effective Date field on this registration is blank. Starting with APPX 5.0.0, all License Keys include an Effective Date. You must install an updated License Key before you will be able to run APPX 5.0.0 or higher. Note that in Release 5 and higher you can copy your registration to the clipboard, and APPX will detect it when you choose "Typical Import" from the "Import Menu" below.
 
LicenseKey.png
Line: 183 to 184
 
    • Run Create Files for each application
    • Run 'Sync Widget Elements' for each application. This is optional, as APPX will force you to do this the first time you go into an application after installing Release 5.0
    • Run 'Load Initial Audit History' for each application. This is optional, as APPX will automatically build the history as you make changes to your application. For example, the first time you go into INPUTs, APPX will see that the audit history is missing and it will create it as it reads the input process records. Regardless of whether you run this, APPX will start keeping a detailed audit history of changes in applications from this point on. However, you should decide now whether to run this step now or not. If audit information already exists in the audit file when you run this step, it will duplicate the data.
Changed:
<
<
  1. Create the new System Administration files ("System Administration/File Management/System Admin Files on pull down menu").
>
>
  1. Create the new System Administration files ("System Administration/File Management/System Admin Files" on pull down menu).
 
  1. Upgrade APPX Desktop Client for all users
  2. Configure new features as desired

Comments:

Revision 72009-11-11 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="APPX500InstallationInstructions"

APPX Linux/Unix - APPX 5 Upgrade Instructions

Line: 131 to 131
 
ConversionLog.png

Install the Upgraded System Administration Files

Changed:
<
<
Before you install the APPX Utility, you must first replace your old System Administration files with the new System Administration files that were created when you ran the upgrade utility to convert your System Administration files to the new APPX 5.0.0 structure. You can use a "cp" command similar to the example below to replace your old System Administration with the upgraded files. Be sure to edit the copy command to reference the directory where APPX is installed on your system if APPX is not installed in "/usr/local/appx". cp -f /usr/local/appx/data/5SA/5SA/Data/* /usr/local/appx/data/0SA/Data
>
>
Before you install the APPX Utility, you must first replace your old System Administration files with the new System Administration files that were created when you ran the upgrade utility to convert your System Administration files to the new APPX 5.0.0 structure. You can use a "cp" command similar to the example below to replace your old System Administration with the upgraded files. Be sure to edit the copy command to reference the directory where APPX is installed on your system if APPX is not installed in "/usr/local/appx".
 
Changed:
<
<
You should also remove the System Administration structure files. You can use a "rm" command similar to the example below to remove your System Administration structure files. Be sure to edit the rm command to reference the directory where APPX is installed on your system if APPX is not installed in "/usr/local/appx".   rm -f /usr/local/appx/data/0SA/Struct
>
>
cp -f /usr/local/appx/data/5SA/5SA/Data/ /usr/local/appx/data/0SA/Data*

You should also remove the System Administration structure files. You can use a "rm" command similar to the example below to remove your System Administration structure files. Be sure to edit the rm command to reference the directory where APPX is installed on your system if APPX is not installed in "/usr/local/appx".

rm -f /usr/local/appx/data/0SA/Struct/*

  You are now ready to install Release 5 on top of your existing installation. Follow these steps:

Overview

Two different methods are provided to install APPX on Linux/Unix. 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, 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".
  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

GUI Installation on Linux/Unix

Log in to your 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. The following instructions will refer to the appxsetup.sh file, which is the name of the 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. if you are downloading directly from the ftp site, make sure you choose the correct installer for your O/S, and substitute your installer's name in the following instructions.

Change the permissions on the downloaded installer file to have Execute permissions.


InstallerProperties.png

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.


RunOrDisplay.png

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


WelcomeToSetupWizard.png

Read and accept the license agreement.


AcceptLicenseAgreement.png

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.


SelectDestinationDirectory.png

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


DirectoryAlreadyExists.png

APPX will then be installed into the specified destination directory.


InstallingFiles.png

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.


CompletingInstallation.png

When you click on the Finish button, an APPX session will be automatically launched to APPX500NewInstallConfigAPPX of the APPX environment.

Finally, if you intend to log into APPX as user "appx", then you must add a password for the "appx" o/s user that was created by the installer (use the "passwd appx" command).

After completing the above steps, you should be able to login to APPX as user "appx" from a remote desktop using the ADC.

Character Mode Installation

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.

On some systems the Java based installer may fail to run with a notice as shown below even though you are supplying the -c argument. In this case, make sure you have dejavu-sans-font package installed, and also that you have a non headless version of a JRE available to the installer. You can do that with the following yum command on RHEL8.

yum install dejavu-sans-fonts java-1.8.0-openjdk

Could not display the GUI. This application needs access to an X Server.
*******************************************************************
You can also run this application in console mode without
access to an X server by passing the argument -c
*******************************************************************
[root@rhel8 Downloads]#

# ./appxsetup.sh -c

Unpacking JRE ...
Preparing JRE ...
Starting Installer ...
This will install Appx on your computer.
OK [o, Enter], Cancel [c]


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 5.0.0

_ Important! _

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.

.
.
.
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?

[/appx50]

Create a desktop icon?

Yes [y, Enter], No [n]

Create a Quick Launch icon?

Yes [y, Enter], No [n]


Install a new APPX 5.0.0 License Key

Changed:
<
<
Log On to your Linux system as a user who is an APPX System Administrator. Then start a local APPX session by running client-local.sh. You should be presented with the following System Registration screen. Notice that the Effective Date field on this registration is blank. Starting with APPX 5.0.0, all License Keys include an Effective Date. You must install an updated License Key before you will be able to run APPX 5.0.0. If you have an updated License Key for your system, you should install it now.
>
>
Log On to your Linux system as a user who is an APPX System Administrator. Then start a local APPX session by running client-local.sh. You should be presented with the following System Registration screen. Notice that the Effective Date field on this registration is blank. Starting with APPX 5.0.0, all License Keys include an Effective Date. You must install an updated License Key before you will be able to run APPX 5.0.0. If you have an updated License Key for your system, you should install it now. Note that in Release 5 and higher you can copy your registration to the clipboard, and APPX will detect it when you choose "Typical Import" from the "Import Menu" below.
 
LicenseKey.png

Revision 62009-11-11 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="APPX500InstallationInstructions"

APPX Linux/Unix - APPX 5 Upgrade Instructions

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


ConversionLog.png

Deleted:
<
<

Install the APPX Utility Upgrade

The APPX 5.0.0 installer supports two different methods for upgrading your APPX/Linux system. The installer may be run as GUI installer or as a Console Mode (character mode) installer. The same installer is used for either method. 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 been previously installed performs the following steps:

  1. Installs APPX into the destination directory replacing the previously installed APPX release.
  2. Sets the appropriate permissions
 

Install the Upgraded System Administration Files

Before you install the APPX Utility, you must first replace your old System Administration files with the new System Administration files that were created when you ran the upgrade utility to convert your System Administration files to the new APPX 5.0.0 structure. You can use a "cp" command similar to the example below to replace your old System Administration with the upgraded files. Be sure to edit the copy command to reference the directory where APPX is installed on your system if APPX is not installed in "/usr/local/appx". cp -f /usr/local/appx/data/5SA/5SA/Data/* /usr/local/appx/data/0SA/Data

Changed:
<
<
You should also remove the System Administration structure files. You can use a "rm" command similar to the example below to remove your System Administration structure files. Be sure to edit the rm command to reference the directory where APPX is installed on your system if APPX is not installed in "/usr/local/appx". rm -f /usr/local/appx/data/0SA/Struct

GUI Installation

Log in to your Linux 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.


InstallerProperties.png

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.


RunOrDisplay.png

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


WelcomeToSetupWizard.png

Read and accept the license agreement.


AcceptLicenseAgreement.png

Specify the Destination Directory into which the APPX 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/".


SelectDestinationDirectory.png

You will be warned that the destination directory already exists. Click on the "Yes" button to continue.


DirectoryAlreadyExists.png

APPX will then be installed into the specified destination directory.


InstallingFiles.png

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

>
>
You should also remove the System Administration structure files. You can use a "rm" command similar to the example below to remove your System Administration structure files. Be sure to edit the rm command to reference the directory where APPX is installed on your system if APPX is not installed in "/usr/local/appx".   rm -f /usr/local/appx/data/0SA/Struct
 
Changed:
<
<

CompletingInstallation.png
>
>
You are now ready to install Release 5 on top of your existing installation. Follow these steps:
 
Changed:
<
<

Character Mode Installation

Install a new APPX 5.0.0 License Key

>
>

Overview

Two different methods are provided to install APPX on Linux/Unix. 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, 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".
  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

GUI Installation on Linux/Unix

Log in to your 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. The following instructions will refer to the appxsetup.sh file, which is the name of the 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. if you are downloading directly from the ftp site, make sure you choose the correct installer for your O/S, and substitute your installer's name in the following instructions.

Change the permissions on the downloaded installer file to have Execute permissions.


InstallerProperties.png

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.


RunOrDisplay.png

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


WelcomeToSetupWizard.png

Read and accept the license agreement.


AcceptLicenseAgreement.png

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.


SelectDestinationDirectory.png

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


DirectoryAlreadyExists.png

APPX will then be installed into the specified destination directory.


InstallingFiles.png

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.


CompletingInstallation.png

When you click on the Finish button, an APPX session will be automatically launched to APPX500NewInstallConfigAPPX of the APPX environment.

Finally, if you intend to log into APPX as user "appx", then you must add a password for the "appx" o/s user that was created by the installer (use the "passwd appx" command).

After completing the above steps, you should be able to login to APPX as user "appx" from a remote desktop using the ADC.

Character Mode Installation

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.

On some systems the Java based installer may fail to run with a notice as shown below even though you are supplying the -c argument. In this case, make sure you have dejavu-sans-font package installed, and also that you have a non headless version of a JRE available to the installer. You can do that with the following yum command on RHEL8.

yum install dejavu-sans-fonts java-1.8.0-openjdk

Could not display the GUI. This application needs access to an X Server.
*******************************************************************
You can also run this application in console mode without
access to an X server by passing the argument -c
*******************************************************************
[root@rhel8 Downloads]#

# ./appxsetup.sh -c

Unpacking JRE ...
Preparing JRE ...
Starting Installer ...
This will install Appx on your computer.
OK [o, Enter], Cancel [c]


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 5.0.0

_ Important! _

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.

.
.
.
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?

[/appx50]

Create a desktop icon?

Yes [y, Enter], No [n]

Create a Quick Launch icon?

Yes [y, Enter], No [n]


Install a new APPX 5.0.0 License Key

  Log On to your Linux system as a user who is an APPX System Administrator. Then start a local APPX session by running client-local.sh. You should be presented with the following System Registration screen. Notice that the Effective Date field on this registration is blank. Starting with APPX 5.0.0, all License Keys include an Effective Date. You must install an updated License Key before you will be able to run APPX 5.0.0. If you have an updated License Key for your system, you should install it now.
Line: 222 to 178
 
    • Remove the Structure files for each application
    • Run Create Files for each application
    • Run 'Sync Widget Elements' for each application. This is optional, as APPX will force you to do this the first time you go into an application after installing Release 5.0
Changed:
<
<
    • Run 'Load Initial Audit History' for each application. This is optional, as APPX will automatically build the history as you make changes to your application. For example, the first time you go into INPUTs, APPX will see that the audit history is missing and it will create it as it reads the input process records. Regardless of whether you run this, APPX will start keeping a detailed audit history of changes in applications from this point on. You can also run this later and the past history will be added to the existing history.
>
>
    • Run 'Load Initial Audit History' for each application. This is optional, as APPX will automatically build the history as you make changes to your application. For example, the first time you go into INPUTs, APPX will see that the audit history is missing and it will create it as it reads the input process records. Regardless of whether you run this, APPX will start keeping a detailed audit history of changes in applications from this point on. However, you should decide now whether to run this step now or not. If audit information already exists in the audit file when you run this step, it will duplicate the data.
  1. Create the new System Administration files ("System Administration/File Management/System Admin Files on pull down menu").
 
  1. Upgrade APPX Desktop Client for all users
  2. Configure new features as desired

Comments:

Revision 52009-11-10 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="APPX500InstallationInstructions"

APPX Linux/Unix - APPX 5 Upgrade Instructions

Changed:
<
<
This page provides the information needed to upgrade an existing APPX Linux/Unix installation to APPX 5.
>
>
This page provides the information needed to upgrade an existing APPX 4.2.a Linux/Unix installation to APPX 5.
 

Overview

Line: 22 to 22
 
  1. Final Tasks

Preliminary Tasks

  1. Ask all users to log off
Changed:
<
<
  1. Verify the integrity of all files in your system
>
>
  1. Verify the integrity of all files in your system and correct any errrors.
 
    • System Administration Files
    • Design Files
    • Data Files
Line: 70 to 70
 
Finished.png

Character Mode Installation

Added:
>
>
If you don't have access to a GUI (on either Windows or Linux/Unix), you can run the this 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.

# ./Appx4to5upgrade_linux.sh -c
Unpacking JRE ...
Preparing JRE ...
Starting Installer ...
This will install Appx 4.2 to 5.0 Upgrade Application on your computer.
OK [o, Enter], Cancel [c]


Next, the installation and conversion instructions will be displayed. Press Enter when you are ready to continue.

Installation Instructions

This conversion utility is an Appx application that will read your
existing 4.2 System Administration files and write new 5.0 System
Administration files into a work directory. Once Appx 5.0 is installed
you can copy the System Administration files from this work directory
into place as your live System Administration files.
Here are the steps involved in installing and using this utility


1. Install conversion application into your current appx installation path.
2. Add application 5SA version 00 in System Administration - Applications.
3. Add database 5SA connected to Application 5SA 00 in System Administration - Databases.
4. Process the Data Dictionary for application 5SA 00.
5. Create data files for Database 5SA, application 5SA.
6. Run application 5SA, database 5SA and follow the on screen instructions.


Choose the location for the installation.

Where should Appx 4.2 to 5.0 Upgrade Application be installed?
[/usr/local/appx/]


The files will then be copied to your hard disk. When this is finished, you are ready to continue with 'Configure the Upgrade Application'

 

Configure the Upgrade Application

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

Line: 78 to 97
 
Add5SAApplication.png
Added:
>
>
Create the Design Files for Application 5SA. APPX should report "File Already Exists" for each file. If not, the application was not installed in the correct location. Repeat the installation steps above, specifing the correct location

Screen_shot_2009-11-10_at_2.46.40_PM.png

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


Add5SADatabase.png

Line: 198 to 221
 
  1. Upgrade Design Files
    • Remove the Structure files for each application
    • Run Create Files for each application
Added:
>
>
    • Run 'Sync Widget Elements' for each application. This is optional, as APPX will force you to do this the first time you go into an application after installing Release 5.0
    • Run 'Load Initial Audit History' for each application. This is optional, as APPX will automatically build the history as you make changes to your application. For example, the first time you go into INPUTs, APPX will see that the audit history is missing and it will create it as it reads the input process records. Regardless of whether you run this, APPX will start keeping a detailed audit history of changes in applications from this point on. You can also run this later and the past history will be added to the existing history.
 
  1. Upgrade APPX Desktop Client for all users
  2. Configure new features as desired

Comments:

Line: 209 to 234
  -- SteveFrizzell - 2 Nov 2009
Deleted:
<
<
  • Create 5SA Design Files:
    Screen_shot_2009-11-10_at_2.46.40_PM.png
 
META FILEATTACHMENT attachment="SetExecutePermissions.png" attr="h" comment="Set Execute Permission on 0SA Upgrade Installer" date="1257186989" name="SetExecutePermissions.png" path="SetExecutePermissions.png" size="49333" stream="SetExecutePermissions.png" tmpFilename="/usr/tmp/CGItemp42634" user="SteveFrizzell" version="1"
META FILEATTACHMENT attachment="RunScript.png" attr="h" comment="Run Script Warning" date="1257187016" name="RunScript.png" path="RunScript.png" size="34817" stream="RunScript.png" tmpFilename="/usr/tmp/CGItemp42569" user="SteveFrizzell" version="1"
META FILEATTACHMENT attachment="Welcome.png" attr="h" comment="Welcome to the install Wizard" date="1257187043" name="Welcome.png" path="Welcome.png" size="87313" stream="Welcome.png" tmpFilename="/usr/tmp/CGItemp42550" user="SteveFrizzell" version="1"

Revision 42009-11-10 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="APPX500InstallationInstructions"

APPX Linux/Unix - APPX 5 Upgrade Instructions

Line: 209 to 209
  -- SteveFrizzell - 2 Nov 2009
Added:
>
>
  • Create 5SA Design Files:
    Screen_shot_2009-11-10_at_2.46.40_PM.png
 
META FILEATTACHMENT attachment="SetExecutePermissions.png" attr="h" comment="Set Execute Permission on 0SA Upgrade Installer" date="1257186989" name="SetExecutePermissions.png" path="SetExecutePermissions.png" size="49333" stream="SetExecutePermissions.png" tmpFilename="/usr/tmp/CGItemp42634" user="SteveFrizzell" version="1"
META FILEATTACHMENT attachment="RunScript.png" attr="h" comment="Run Script Warning" date="1257187016" name="RunScript.png" path="RunScript.png" size="34817" stream="RunScript.png" tmpFilename="/usr/tmp/CGItemp42569" user="SteveFrizzell" version="1"
META FILEATTACHMENT attachment="Welcome.png" attr="h" comment="Welcome to the install Wizard" date="1257187043" name="Welcome.png" path="Welcome.png" size="87313" stream="Welcome.png" tmpFilename="/usr/tmp/CGItemp42550" user="SteveFrizzell" version="1"
Line: 228 to 231
 
META FILEATTACHMENT attachment="ImportLicenseKeyMenu.png" attr="h" comment="Import License Key Menu" date="1257273608" name="ImportLicenseKeyMenu.png" path="ImportLicenseKeyMenu.png" size="43507" stream="ImportLicenseKeyMenu.png" tmpFilename="/usr/tmp/CGItemp42270" user="SteveFrizzell" version="1"
META FILEATTACHMENT attachment="SpecifyLocationOfImportFile.png" attr="h" comment="Specify Location of License Key" date="1257273634" name="SpecifyLocationOfImportFile.png" path="SpecifyLocationOfImportFile.png" size="46162" stream="SpecifyLocationOfImportFile.png" tmpFilename="/usr/tmp/CGItemp42430" user="SteveFrizzell" version="1"
META FILEATTACHMENT attachment="LicenseKey500.png" attr="h" comment="License Key (New)" date="1257273658" name="LicenseKey500.png" path="LicenseKey500.png" size="62728" stream="LicenseKey500.png" tmpFilename="/usr/tmp/CGItemp42528" user="SteveFrizzell" version="1"
Added:
>
>
META FILEATTACHMENT attachment="Screen_shot_2009-11-10_at_2.46.40_PM.png" attr="h" comment="Create 5SA Design Files" date="1257886127" name="Screen_shot_2009-11-10_at_2.46.40_PM.png" path="Z:\Screen shot 2009-11-10 at 2.46.40 PM.png" size="39048" stream="Z:\Screen shot 2009-11-10 at 2.46.40 PM.png" tmpFilename="/usr/tmp/CGItemp25514" user="JeanNeron" version="1"

Revision 32009-11-10 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="APPX500InstallationInstructions"
Changed:
<
<

APPX/Linux - APPX 5.0.0 Upgrade Instructions

>
>

APPX Linux/Unix - APPX 5 Upgrade Instructions

 
Changed:
<
<
This page provides the information needed to upgrade an existing APPX/Linux installation to APPX 5.0.0.
>
>
This page provides the information needed to upgrade an existing APPX Linux/Unix installation to APPX 5.
 

Overview

Changed:
<
<
Warning - These instructions specifically apply to upgrading from APPX 4.2.a to APPX 5.0.0. If you are upgrading from an older release of APPX, these instructions may not be applicable. You should consider upgrading to APPX 4.2.a first and then upgrading to APPX 5.0.0.
>
>
Warning - These instructions specifically apply to upgrading from APPX 4.2.a to APPX 5. If you are upgrading from an older release of APPX, these instructions may not be applicable. You should consider upgrading to APPX 4.2.a first and then upgrading to APPX 5.
 
Changed:
<
<
To upgrade your existing APPX/Linux installation from APPX 4.2.a to APPX 5.0.0, you must complete the following steps:
>
>
To upgrade your existing APPX Linux/Unix installation from APPX 4.2.a to APPX 5, you must complete the following steps:
 
  1. Preliminary Tasks
  2. Convert Your System Administration Files
Line: 34 to 34
 

Convert Your System Administration Files

Changed:
<
<
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.
>
>
The first step of upgrading your APPX 4.2.a installation to APPX 5 is to convert your System Administration files to the new APPX 5 format. The System Administration files for APPX 4.2.a are not compatible with APPX 5 and must be converted to the APPX 5 format.
 

Install the Upgrade Application

GUI Installation

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

Changed:
<
<
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.
>
>
Download the installer for the APPX 4.2.a to APPX 5 upgrade application (APPX4to5upgrade_linux.sh for Intel based computers running Linux, or Appx4to5upgrade_risc.tar.gz for RISC based computers) 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.
Line: 58 to 58
 
InstallationInstructions.png
Changed:
<
<
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/".
>
>
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/".
 
DestinationDirectory.png

Revision 22009-11-03 - SteveFrizzell

Line: 1 to 1
 
META TOPICPARENT name="APPX500InstallationInstructions"
Changed:
<
<

APPX 5.0.0 - Linux - Upgrade Installation

>
>

APPX/Linux - APPX 5.0.0 Upgrade Instructions

 
Changed:
<
<

>
>
This page provides the information needed to upgrade an existing APPX/Linux installation to APPX 5.0.0.
 
Added:
>
>

 

Overview

Changed:
<
<
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:
>
>
 
Changed:
<
<
  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
>
>
Warning - These instructions specifically apply to upgrading from APPX 4.2.a to APPX 5.0.0. If you are upgrading from an older release of APPX, these instructions may not be applicable. You should consider upgrading to APPX 4.2.a first and then upgrading to APPX 5.0.0.

To upgrade your existing APPX/Linux installation from APPX 4.2.a to APPX 5.0.0, you must complete the following steps:

  1. Preliminary Tasks
  2. Convert Your System Administration Files
  3. Install the APPX Utility upgrade
  4. Install a new APPX 5.0.0 License Key
  5. Configure the new APPX Login Manager
  6. Final Tasks

Preliminary Tasks

  1. Ask all users to log off
  2. Verify the integrity of all files in your system
    • System Administration Files
    • Design Files
    • Data Files
  3. Terminate (kill) the APPX Connection Manager (appxd)
  4. Terminate (kill) any APPX sessions that are still active (there shouldn't be any if everyone has logged off)
  5. Terminate (kill) the APPX License Server session
  6. Backup your system

 

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.

Changed:
<
<

Install the Upgrade Application (GUI)

>
>

Install the Upgrade Application

GUI Installation

 
Changed:
<
<
Log in to your Linux desktop system as the "root" user.
>
>
Log in to your Linux 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.
Line: 52 to 69
 When the installation wizard displays the final screen, click on the Finish button to end the installation wizard.


Finished.png

Added:
>
>

Character Mode Installation

 

Configure the Upgrade Application

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

Line: 88 to 106
 The conversion log will inform you of any problems that may have been encountered while running the conversion utility.


ConversionLog.png

Added:
>
>

Install the APPX Utility Upgrade

The APPX 5.0.0 installer supports two different methods for upgrading your APPX/Linux system. The installer may be run as GUI installer or as a Console Mode (character mode) installer. The same installer is used for either method. 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 been previously installed performs the following steps:

  1. Installs APPX into the destination directory replacing the previously installed APPX release.
  2. Sets the appropriate permissions

Install the Upgraded System Administration Files

Before you install the APPX Utility, you must first replace your old System Administration files with the new System Administration files that were created when you ran the upgrade utility to convert your System Administration files to the new APPX 5.0.0 structure. You can use a "cp" command similar to the example below to replace your old System Administration with the upgraded files. Be sure to edit the copy command to reference the directory where APPX is installed on your system if APPX is not installed in "/usr/local/appx". cp -f /usr/local/appx/data/5SA/5SA/Data/* /usr/local/appx/data/0SA/Data

You should also remove the System Administration structure files. You can use a "rm" command similar to the example below to remove your System Administration structure files. Be sure to edit the rm command to reference the directory where APPX is installed on your system if APPX is not installed in "/usr/local/appx". rm -f /usr/local/appx/data/0SA/Struct

 
Changed:
<
<

GUI Installation on Linux

>
>

GUI Installation

 
Changed:
<
<
Log in to your Linux desktop system as the "root" user.
>
>
Log in to your Linux 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.
Line: 112 to 141
 
AcceptLicenseAgreement.png
Changed:
<
<
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.
>
>
Specify the Destination Directory into which the APPX 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/".
 
SelectDestinationDirectory.png
Changed:
<
<
You will be warned if the destination directory already exists. Otherwise, APPX will create it.
>
>
You will be warned that the destination directory already exists. Click on the "Yes" button to continue.
 
DirectoryAlreadyExists.png
Line: 124 to 153
 
InstallingFiles.png
Changed:
<
<
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 the installation wizard displays the final screen, click on the Finish button to end the APPX Setup Wizard.
 
CompletingInstallation.png
Changed:
<
<
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.

>
>

Character Mode Installation

Install a new APPX 5.0.0 License Key

Log On to your Linux system as a user who is an APPX System Administrator. Then start a local APPX session by running client-local.sh. You should be presented with the following System Registration screen. Notice that the Effective Date field on this registration is blank. Starting with APPX 5.0.0, all License Keys include an Effective Date. You must install an updated License Key before you will be able to run APPX 5.0.0. If you have an updated License Key for your system, you should install it now.


LicenseKey.png

After installing a new 5.0.0 License Key, your System Registration screen should include an Effective Date.


LicenseKey500.png

Configure the new APPX Login Manager

APPX 5.0.0 includes the new APPX Login Manager service. This service replaces the Connection Manager (appxd) which was included with APPX releases prior to APPX 5.0.0. The old Connection Manager will not work with APPX 5.0.0 and should not be used. You should remove appxd and start-appxd.sh from the tools directory since they are no longer needed. You should also remove any commands that might be run to start appxd during the boot process.

To configure and start the new APPX Login Manager service, log in as the root user and execute a command similar to the following:

 /usr/local/appx/services/appxLoginMgr -install -name=appxLogin8060 -port=8060

 Warning - the engine that you named has the setuid bit enabled,
          you may not want that bit set for the authentication
          method that you have chosen (OS-User)
           To turn off the setuid bit, chmod u-s ../appx
Configuration written to:  appxLogin8060.ini
Environment written to:    appxLogin8060.env
Service script written to: /etc/init.d/appxLogin8060
Configuration complete
Registering service
Starting appxLogin8060:                                    [  OK  ]
Warning - the engine that you named has the setuid bit enabled,
          you may not want that bit set for the authentication
          method that you have chosen (OS-User)
           To turn off the setuid bit, chmod u-s ../appx
up and running (process 31754 servicing port 8060)
Installation Complete_

After executing the above command, users should be able to use the APPX 5.0.0 Desktop Client to successfully login on port 8060. For additional information on managing APPX Login Services, please refer to the complete documentation.

Final Tasks

  1. Upgrade Design Files
    • Remove the Structure files for each application
    • Run Create Files for each application
  2. Upgrade APPX Desktop Client for all users
  3. Configure new features as desired
 

Comments:

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

Line: 185 to 224
 
META FILEATTACHMENT attachment="ConversionUtility.png" attr="h" comment="Conversion Utility Menu" date="1257190116" name="ConversionUtility.png" path="ConversionUtility.png" size="37034" stream="ConversionUtility.png" tmpFilename="/usr/tmp/CGItemp42565" user="SteveFrizzell" version="1"
META FILEATTACHMENT attachment="ConversionLogDispositionScreen.png" attr="h" comment="Conversion Log Disposition Screen" date="1257190147" name="ConversionLogDispositionScreen.png" path="ConversionLogDispositionScreen.png" size="57914" stream="ConversionLogDispositionScreen.png" tmpFilename="/usr/tmp/CGItemp42508" user="SteveFrizzell" version="1"
META FILEATTACHMENT attachment="ConversionLog.png" attr="h" comment="Conversion Log" date="1257190174" name="ConversionLog.png" path="ConversionLog.png" size="44540" stream="ConversionLog.png" tmpFilename="/usr/tmp/CGItemp42502" user="SteveFrizzell" version="1"
Added:
>
>
META FILEATTACHMENT attachment="LicenseKey.png" attr="h" comment="License Key (Old)" date="1257273580" name="LicenseKey.png" path="LicenseKey.png" size="62342" stream="LicenseKey.png" tmpFilename="/usr/tmp/CGItemp42393" user="SteveFrizzell" version="1"
META FILEATTACHMENT attachment="ImportLicenseKeyMenu.png" attr="h" comment="Import License Key Menu" date="1257273608" name="ImportLicenseKeyMenu.png" path="ImportLicenseKeyMenu.png" size="43507" stream="ImportLicenseKeyMenu.png" tmpFilename="/usr/tmp/CGItemp42270" user="SteveFrizzell" version="1"
META FILEATTACHMENT attachment="SpecifyLocationOfImportFile.png" attr="h" comment="Specify Location of License Key" date="1257273634" name="SpecifyLocationOfImportFile.png" path="SpecifyLocationOfImportFile.png" size="46162" stream="SpecifyLocationOfImportFile.png" tmpFilename="/usr/tmp/CGItemp42430" user="SteveFrizzell" version="1"
META FILEATTACHMENT attachment="LicenseKey500.png" attr="h" comment="License Key (New)" date="1257273658" name="LicenseKey500.png" path="LicenseKey500.png" size="62728" stream="LicenseKey500.png" tmpFilename="/usr/tmp/CGItemp42528" user="SteveFrizzell" version="1"

Revision 12009-11-02 - SteveFrizzell

Line: 1 to 1
Added:
>
>
META TOPICPARENT name="APPX500InstallationInstructions"

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.


SetExecutePermissions.png

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.


RunScript.png

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.


Welcome.png

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


InstallationInstructions.png

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/".


DestinationDirectory.png

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


InstallingFiles.png

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


Finished.png

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.


Add5SAApplication.png

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


Add5SADatabase.png

Run Database Management for the Upgrade Application and Database.


DatabaseMgt.png

Run Create Files.


RunCreateFiles.png

Run the Upgrade Application

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

RunDatabase5SA.png

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


ConversionUtility.png

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


ConversionLogDispositionScreen.png

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


ConversionLog.png

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.


InstallerProperties.png

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.


RunOrDisplay.png

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


WelcomeToSetupWizard.png

Read and accept the license agreement.


AcceptLicenseAgreement.png

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.


SelectDestinationDirectory.png

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


DirectoryAlreadyExists.png

APPX will then be installed into the specified destination directory.


InstallingFiles.png

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.


CompletingInstallation.png

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.



<--/commentPlugin-->

-- SteveFrizzell - 2 Nov 2009

META FILEATTACHMENT attachment="SetExecutePermissions.png" attr="h" comment="Set Execute Permission on 0SA Upgrade Installer" date="1257186989" name="SetExecutePermissions.png" path="SetExecutePermissions.png" size="49333" stream="SetExecutePermissions.png" tmpFilename="/usr/tmp/CGItemp42634" user="SteveFrizzell" version="1"
META FILEATTACHMENT attachment="RunScript.png" attr="h" comment="Run Script Warning" date="1257187016" name="RunScript.png" path="RunScript.png" size="34817" stream="RunScript.png" tmpFilename="/usr/tmp/CGItemp42569" user="SteveFrizzell" version="1"
META FILEATTACHMENT attachment="Welcome.png" attr="h" comment="Welcome to the install Wizard" date="1257187043" name="Welcome.png" path="Welcome.png" size="87313" stream="Welcome.png" tmpFilename="/usr/tmp/CGItemp42550" user="SteveFrizzell" version="1"
META FILEATTACHMENT attachment="InstallationInstructions.png" attr="h" comment="Installation Steps" date="1257187073" name="InstallationInstructions.png" path="InstallationInstructions.png" size="53229" stream="InstallationInstructions.png" tmpFilename="/usr/tmp/CGItemp42523" user="SteveFrizzell" version="1"
META FILEATTACHMENT attachment="DestinationDirectory.png" attr="h" comment="Destination Directory" date="1257187097" name="DestinationDirectory.png" path="DestinationDirectory.png" size="44123" stream="DestinationDirectory.png" tmpFilename="/usr/tmp/CGItemp42606" user="SteveFrizzell" version="1"
META FILEATTACHMENT attachment="InstallingFiles.png" attr="h" comment="Installing Files" date="1257187118" name="InstallingFiles.png" path="InstallingFiles.png" size="35112" stream="InstallingFiles.png" tmpFilename="/usr/tmp/CGItemp42571" user="SteveFrizzell" version="1"
META FILEATTACHMENT attachment="Finished.png" attr="h" comment="Finished" date="1257187138" name="Finished.png" path="Finished.png" size="88325" stream="Finished.png" tmpFilename="/usr/tmp/CGItemp42573" user="SteveFrizzell" version="1"
META FILEATTACHMENT attachment="Add5SAApplication.png" attr="h" comment="Add 5SA 00 to Application File" date="1257189980" name="Add5SAApplication.png" path="Add5SAApplication.png" size="39368" stream="Add5SAApplication.png" tmpFilename="/usr/tmp/CGItemp42584" user="SteveFrizzell" version="1"
META FILEATTACHMENT attachment="Add5SADatabase.png" attr="h" comment="Add 5SA Database to Database File" date="1257190007" name="Add5SADatabase.png" path="Add5SADatabase.png" size="39481" stream="Add5SADatabase.png" tmpFilename="/usr/tmp/CGItemp42603" user="SteveFrizzell" version="1"
META FILEATTACHMENT attachment="DatabaseMgt.png" attr="h" comment="Database Management" date="1257190044" name="DatabaseMgt.png" path="DatabaseMgt.png" size="50490" stream="DatabaseMgt.png" tmpFilename="/usr/tmp/CGItemp42550" user="SteveFrizzell" version="1"
META FILEATTACHMENT attachment="RunCreateFiles.png" attr="h" comment="Run Create Files" date="1257190063" name="RunCreateFiles.png" path="RunCreateFiles.png" size="38925" stream="RunCreateFiles.png" tmpFilename="/usr/tmp/CGItemp42614" user="SteveFrizzell" version="1"
META FILEATTACHMENT attachment="RunDatabase5SA.png" attr="h" comment="Run Database" date="1257190089" name="RunDatabase5SA.png" path="RunDatabase5SA.png" size="243992" stream="RunDatabase5SA.png" tmpFilename="/usr/tmp/CGItemp42460" user="SteveFrizzell" version="1"
META FILEATTACHMENT attachment="ConversionUtility.png" attr="h" comment="Conversion Utility Menu" date="1257190116" name="ConversionUtility.png" path="ConversionUtility.png" size="37034" stream="ConversionUtility.png" tmpFilename="/usr/tmp/CGItemp42565" user="SteveFrizzell" version="1"
META FILEATTACHMENT attachment="ConversionLogDispositionScreen.png" attr="h" comment="Conversion Log Disposition Screen" date="1257190147" name="ConversionLogDispositionScreen.png" path="ConversionLogDispositionScreen.png" size="57914" stream="ConversionLogDispositionScreen.png" tmpFilename="/usr/tmp/CGItemp42508" user="SteveFrizzell" version="1"
META FILEATTACHMENT attachment="ConversionLog.png" attr="h" comment="Conversion Log" date="1257190174" name="ConversionLog.png" path="ConversionLog.png" size="44540" stream="ConversionLog.png" tmpFilename="/usr/tmp/CGItemp42502" user="SteveFrizzell" version="1"
 
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