Difference: APPX500LinuxUpgradeInstallation (14 vs. 15)

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
 
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 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