---+ APPX Linux/Unix - APPX 5 Upgrade Instructions _This page provides the information needed to upgrade an existing APPX Linux/Unix installation to APPX 5._ <br />%TOC% ---++ Overview %RED% 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. %ENDCOLOR% 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 1 Convert Your System Administration Files 1 Install the APPX Utility upgrade 1 Install a new APPX 5.0.0 License Key 1 Configure the new APPX Login Manager 1 Final Tasks ---++ Preliminary Tasks 1 Ask all users to log off 1 Verify the integrity of all files in your system * System Administration Files * Design Files * Data Files 1 Terminate (kill) the APPX Connection Manager (appxd) 1 Terminate (kill) any APPX sessions that are still active (there shouldn't be any if everyone has logged off) 1 Terminate (kill) the APPX License Server session 1 Backup your system #ConvertSystemAdminFiles ---++ Convert Your System Administration Files 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. 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. <br /><img width="511" alt="SetExecutePermissions.png" src="%ATTACHURLPATH%/SetExecutePermissions.png" height="461" /> 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. <br /><img width="504" alt="RunScript.png" src="%ATTACHURLPATH%/RunScript.png" height="197" /> 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. <br /><img width="500" alt="Welcome.png" src="%ATTACHURLPATH%/Welcome.png" height="390" /> Read the Installation Instructions and then click on the "Next" button to continue. <br /><img width="573" alt="InstallationInstructions.png" src="%ATTACHURLPATH%/InstallationInstructions.png" height="411" /> Specify the Destination Directory into which the upgrade utility is to be installed. The directory that you specify <strong>must </strong>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/". <br /><img width="500" alt="DestinationDirectory.png" src="%ATTACHURLPATH%/DestinationDirectory.png" height="390" /> The APPX Upgrade Application (5SA Version 00) will then be installed into the specified destination directory. <br /><img width="500" alt="InstallingFiles.png" src="%ATTACHURLPATH%/InstallingFiles.png" height="390" /> When the installation wizard displays the final screen, click on the Finish button to end the installation wizard. <br /><img width="573" alt="Finished.png" src="%ATTACHURLPATH%/Finished.png" height="411" /> ---++++ 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. Add the upgrade application (5SA 00) to the Applications file. <br /><img width="672" alt="Add5SAApplication.png" src="%ATTACHURLPATH%/Add5SAApplication.png" height="586" /> Add the database (5SA) for the Upgrade Application to the Databases file. <br /><img width="672" alt="Add5SADatabase.png" src="%ATTACHURLPATH%/Add5SADatabase.png" height="586" /> Run Database Management for the Upgrade Application and Database. <br /><img width="672" alt="DatabaseMgt.png" src="%ATTACHURLPATH%/DatabaseMgt.png" height="586" /> Run Create Files. <br /><img width="672" alt="RunCreateFiles.png" src="%ATTACHURLPATH%/RunCreateFiles.png" height="586" /> ---+++ Run the Upgrade Application After configuring the Upgrade Application, you must run the Upgrade Utility to convert your System Administration files. <img width="672" alt="RunDatabase5SA.png" src="%ATTACHURLPATH%/RunDatabase5SA.png" height="586" /> Click on the "Convert" button to run the conversion utility. <br /><img width="672" alt="ConversionUtility.png" src="%ATTACHURLPATH%/ConversionUtility.png" height="586" /> The conversion utility will create a log. Specify the appropriate disposition options to print the conversion log. <br /><img width="672" alt="ConversionLogDispositionScreen.png" src="%ATTACHURLPATH%/ConversionLogDispositionScreen.png" height="586" /> The conversion log will inform you of any problems that may have been encountered while running the conversion utility. <br /><img width="672" alt="ConversionLog.png" src="%ATTACHURLPATH%/ConversionLog.png" height="586" /> ---++ 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 [[#GuiInstaller][GUI installer]] or as a [[#CharacterInstaller][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. 1 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 [[#ConvertSystemAdminFiles][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". <literal><strong>cp -f /usr/local/appx/data/5SA/5SA/Data/* /usr/local/appx/data/0SA/Data</strong></literal> 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". <literal><strong>rm -f /usr/local/appx/data/0SA/Struct</strong></literal> #GuiInstaller ---+++ 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. <br /><img width="511" alt="InstallerProperties.png" src="%PUBURLPATH%/Main/APPX500LinuxNewInstallation/InstallerProperties.png" height="461" /> 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. <br /><img width="504" alt="RunOrDisplay.png" src="%PUBURLPATH%/Main/APPX500LinuxNewInstallation/RunOrDisplay.png" height="176" /> After a few moments, the APPX Setup Wizard should display the Welcome screen. Click on the "Next" button to continue. <br /><img width="500" alt="WelcomeToSetupWizard.png" src="%PUBURLPATH%/Main/APPX500LinuxNewInstallation/WelcomeToSetupWizard.png" height="390" /> Read and accept the license agreement. <br /><img width="529" alt="AcceptLicenseAgreement.png" src="%PUBURLPATH%/Main/APPX500LinuxNewInstallation/AcceptLicenseAgreement.png" height="484" /> 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/". <br /><img width="500" alt="SelectDestinationDirectory.png" src="%PUBURLPATH%/Main/APPX500LinuxNewInstallation/SelectDestinationDirectory.png" height="390" /> You will be warned that the destination directory already exists. Click on the "Yes" button to continue. <br /><img width="459" alt="DirectoryAlreadyExists.png" src="%PUBURLPATH%/Main/APPX500LinuxNewInstallation/DirectoryAlreadyExists.png" height="166" /> APPX will then be installed into the specified destination directory. <br /><img width="493" alt="InstallingFiles.png" src="%PUBURLPATH%/Main/APPX500LinuxNewInstallation/InstallingFiles.png" height="384" /> When the installation wizard displays the final screen, click on the Finish button to end the APPX Setup Wizard. <br /><img width="493" alt="CompletingInstallation.png" src="%PUBURLPATH%/Main/APPX500LinuxNewInstallation/CompletingInstallation.png" height="384" /> #CharacterInstaller ---+++ 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. <br /><img width="672" alt="LicenseKey.png" src="%ATTACHURLPATH%/LicenseKey.png" height="586" /> After installing a new 5.0.0 License Key, your System Registration screen should include an Effective Date. <br /><img width="672" alt="LicenseKey500.png" src="%ATTACHURLPATH%/LicenseKey500.png" height="586" /> ---++ 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: <verbatim> /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_</verbatim> 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 [[APPXLoginManagerForUnixLinux][complete documentation]]. ---++ Final Tasks 1 Upgrade Design Files * Remove the Structure files for each application * Run Create Files for each application 1 Upgrade APPX Desktop Client for all users 1 Configure new features as desired ---++ Comments: _Read what other users have said about this page or add your own comments._ --- <br />%COMMENT% -- SteveFrizzell - 2 Nov 2009
This topic: Main
>
WebHome
>
APPX500InstallationInstructions
>
APPX500LinuxUpgradeInstallation
Topic revision: r3 - 2009-11-10 - JeanNeron
Copyright © 2008-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki?
Send feedback