APPX 5.4.7 Installation Instructions

This page provides instructions for installing APPX 5.4.7.

Notes

• IMPORTANT: This version includes new SSL certificates. Client versions earlier than 5.4.4c will not be able to connect to this release. There are several options:
  • explicity disable SSL in the login manager. The default is 'optional', which means the client & server will try to use SSL. You may be using it unintentionally because of this default setting. In that case, it might be acceptable to simply disable it. This will allow older clients to connect until you can upgrade them.
  • You can install a new login manager on a different port and force it to use the old certificate by setting '-UseOldSSLcert=true' in your login manager. This will allow older clients to connect to that port until you can upgrade them, at which point they can connect to the normal login port
  • The Java Web Start version of the client can only connect to a 5.4.4c or higher server. That client must be upgraded at the same time as the rest of APPX.
• If you are upgrading from a release prior to 5.3.3, then be aware that:
  • Bug 2823 requires a job to be run to fix the user keymaps - System Administration File Management - Update Keymap
  • Changes in the format of the Role Based Security files require you to scratch 0SA/Struct/SEC* then run Sys Admin File Management - Create Files
  • If you previously used the Data Exchange application in 5.3.0, see these instructions.
• If you are upgrading from a release prior to 5.4.3 and you are using Language Translation you should process the DD in your applications to fix bug 3450

Overview

Installation of APPX 5.4.7 is accomplished by simply following the steps outlined below for your target platform. Because all platforms use a common Installation Wizard, the installation steps for the various platforms are very similar.

APPX runs on multiple platforms (various Windows versions & servers, Linux, HP-UX, AIX, etc). The steps for installing are very similar between all Linux/Unix platforms and all Windows versions, and rather than give instructions for each variation, we break them down into all Windows installations and all Linux/Unix installations. Where applicable, we note any O/S specific variations within the instructions for that type of O/S.

APPX Utility Installation Instructions

Windows Server/Win 7/Win 10

New Installation

Follow APPX500WindowsNewInstallation to install APPX onto a Windows system where APPX is not currently installed.

Upgrade Existing Installation

Are you already running APPX 5? If yes, then follow these instructions prior to your upgrade.

When you are ready to proceed with the upgrade, then:

• Ask all users to log off.
• Terminate any remaining appx tasks, such as the license server, using Windows Task Manager.
• Stop the login service(s), using the Windows Task Manager.
• Follow the instructions above for a new installation and install the new release on top of your existing installation.
• Restart the login service(s), using the Windows Task Manager. Note that if any APPX sessions are running during the upgrade, or if you don't stop all the login services, you will have to reboot your server to complete the upgrade.

Follow APPX500WindowsUpgradeInstallation to upgrade an existing installation of APPX 4.2.a to APPX 5.

Linux/Unix Server

New Installation

Follow APPX500LinuxNewInstallation to install APPX onto a Linux/Unix system where APPX is not currently installed.

Upgrade Existing Installation

Are you already running APPX 5? If yes, then follow these instructions prior to your upgrade.

When you are ready to proceed with the upgrade, then:

• Ask all users to log off.
• kill any remaining appx tasks, such as the license server.
• Stop the login services, using the O/S specific commands to start/stop services.
• Follow the instructions above for a new installation and install the new release on top of your existing installation.
• Restart the login services.

Follow APPX500LinuxUpgradeInstallation to upgrade an existing installation of APPX 4.2.a to APPX 5.

Using 64 bit Linux?

If you're planning to run APPX on a 64 bit version of Linux, see Running APPX in a 64 bit environment for details on how to install the required 32 bit libraries.

APPX Desktop Client Installation Instructions - Overview

The Appx Desktop Client (ADC) can be downloaded from the APPX web site under Downloads/Desktop Products. There are installers for Windows, Linux and Macintosh desktops. There are no license restrictions on downloading and installing the client software. You may install the software on as many desktops as you like. Your APPX server license will limit the number of simultaneous connections.

To upgrade an existing ADC installation, simply install the new version on top of the old version. It is not necessary to uninstall the old client software first.

In addition to the ADC, you will probably need a PDF viewer. For Windows and Linux desktops you can use the Adobe Acrobat reader or the free Foxit reader. Mac OS/X includes the Preview application, which is sufficient for view and printing PDF documents.

IMPORTANT: The APPX Desktop Client only runs on Intel based Macs with OS/X 10.5 Update 1, or higher. Older Intel based Macs might be able to use a third party Java runtime but this has not been tested. Power PC based Macs will not be able to run the APPX Desktop Client at all, since Apple does not provide Java SE 6 for this platform.

Windows Desktops

Installation

Follow APPXADCWindowsInstallation to install the ADC onto a Windows Desktop.

Linux Desktops

Installation

Follow APPXADCLinuxInstallation to install the ADC onto a Linux Desktop.

Mac Desktops

Installation

Follow APPXADCMacInstallation to install the ADC onto a Mac Desktop.

Java Web Start

Installation

As an alternative to installing the client on each desktop, you can use Java Web Start technology to load the client from your web server. See Launching APPX Desktop Client for instructions.

APPX HTML Client Instructions

Installation

Another alternative to the above desktop clients is the HTML client. This will run your APPX applications in a browser on a desktop, tablet or smart phone. See APPX HTML Client for instructions on installing the HTML client on your web server.

APPX ODBC Installation Instructions

APPX ODBC - New or Upgrade Existing Installation

Databases

Configuring APPX to work with RDBMS systems.

Comments:

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

-- JeanNeron - 2018-12-07