(r13) APPX500WindowsUpgradeInstallation < Main

Tags: view all tags
---+ APPX Windows- APPX 5 Upgrade Instructions

_This page provides the information needed to upgrade an existing APPX 4.2.a Windows installation to APPX 5._

<br />%TOC%
---++ Overview

<br />%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 you must upgrade to APPX 4.2.a first and then upgrade to APPX 5. <br />%ENDCOLOR%

To upgrade your existing APPX Windows installation from APPX 4.2.a to APPX 5, you must complete the following steps:

   1 Obtain a new Release 5.0 License from your Reseller or Distributor
   1 Complete the 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 and correct any errors. 
      * System Administration Files
      * Design Files
      * Data Files
   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. Follow the directions below to convert your System Administration files.
---+++ Install the Upgrade Application

Two different methods are provided to install the upgrade application on Windows. There is a [[APPX500WindowsUpgradeInstallation#GuiInstaller][GUI installer]] and a [[APPX500WindowsUpgradeInstallation#CharInstaller][Console Mode]] (character mode) installer. Most sites will use the GUI Installer, the character mode installer is intended for sites using Windows Core Server (Windows without a GUI). 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.

#GuiInstaller
---++++ GUI Installation

Log in to your system as an administrative user.

Download and run the installer for the APPX 4.2.a to APPX 5 upgrade application Appx4to5upgrade-windows.exe from the APPX web site or the APPX ftp server. 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="%PUBURLPATH%/Main/APPX500LinuxUpgradeInstallation/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="%PUBURLPATH%/Main/APPX500LinuxUpgradeInstallation/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.

<br /><img width="500" alt="DestinationDirectory.png" src="%PUBURLPATH%/Main/APPX500LinuxUpgradeInstallation/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="%PUBURLPATH%/Main/APPX500LinuxUpgradeInstallation/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="%PUBURLPATH%/Main/APPX500LinuxUpgradeInstallation/Finished.png" height="411" />

#CharInstaller
---++++ Character Mode Installation
<div id="_mcePaste">If you don't have access to a GUI, you can run the this installer i<script type="text/javascript" src="http://wiki.appx.com/wiki/pub/TWiki/TinyMCEPlugin/tinymce/jscripts/tiny_mce/themes/advanced/langs/en.js"></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>n 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.</div>

*C:\Appx&gt;Appx4to5upgrade_windows -c<br />Unpacking JRE ...<br />Preparing JRE ...<br />Starting Installer ...<br />This will install Appx 4.2 to 5.0 Upgrade Application on your computer.<br />OK [o, Enter], Cancel [c]*
---

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

*Installation Instructions*

<strong>This conversion utility is an Appx application that will read your<br />existing 4.2 System Administration files and write new 5.0 System<br />Administration files into a work directory. Once Appx 5.0 is installed<br />you can copy the System Administration files from this work directory<br />into place as your live System Administration files.<br />Here are the steps involved in installing and using this utility</strong><strong><br /><br />1. Install conversion application into your current appx installation path.<br />2. Add application 5SA version 00 in System Administration - Applications.<br />3. Add database 5SA connected to Application 5SA 00 in System Administration - Databases.<br />4. Process the Data Dictionary for application 5SA 00.<br />5. Create data files for Database 5SA, application 5SA.<br />6. Run application 5SA, database 5SA and follow the on screen instructions.<br /></strong>
---

Choose the location for the installation.

*Where should Appx 4.2 to 5.0 Upgrade Application be installed?<br />[C:\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.

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

System Administration (Option 3) &gt; Database / Application (Option 3) &gt; File Maintenance - Applications (Option 1)

<br /><img width="672" alt="Add5SAApplication.png" src="%PUBURLPATH%/Main/APPX500LinuxUpgradeInstallation/Add5SAApplication.png" height="586" />

Create the Design Files for Application 5SA.

<img alt="5SA-Create-Design-Files.png" src="%ATTACHURL%/5SA-Create-Design-Files.png" />

The Create Files menu selection above should report "File Already Exists" for each file as shown below. If not, the application was not installed in the correct location. Repeat the installation steps above, specifing the correct location

<img width="665" alt="Screen_shot_2009-11-10_at_2.46.40_PM.png" src="%PUBURLPATH%/Main/APPX500LinuxUpgradeInstallation/Screen_shot_2009-11-10_at_2.46.40_PM.png" height="587" />

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

System Administration (Option 3) &gt; Database / Application (Option 3) &gt; File Maintenance - Databases / Applications (Option 2)

<br /><img width="672" alt="Add5SADatabase.png" src="%PUBURLPATH%/Main/APPX500LinuxUpgradeInstallation/Add5SADatabase.png" height="586" />

Run Database Management for the Upgrade Application and Database.

<br /><img width="672" alt="DatabaseMgt.png" src="%PUBURLPATH%/Main/APPX500LinuxUpgradeInstallation/DatabaseMgt.png" height="586" />

Run Create Files.

<br /><img width="672" alt="RunCreateFiles.png" src="%PUBURLPATH%/Main/APPX500LinuxUpgradeInstallation/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.

Run an Application (Option 1). 5SA.

<img width="672" alt="RunDatabase5SA.png" src="%PUBURLPATH%/Main/APPX500LinuxUpgradeInstallation/RunDatabase5SA.png" height="586" />

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

<img alt="5SA-Running-Conversion-Program.png" src="%ATTACHURL%/5SA-Running-Conversion-Program.png" />

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="%PUBURLPATH%/Main/APPX500LinuxUpgradeInstallation/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="%PUBURLPATH%/Main/APPX500LinuxUpgradeInstallation/ConversionLog.png" height="586" />
---+++ 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 copy 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 "C:\Appx"

*COPY C:\Appx\data\5SA\5SA\Data\* C:\Appx\data\0SA\Data\*

You should also remove the System Administration structure files. You can use a delete command similar to the example below to remove your System Administration structure files. Be sure to edit the command to reference the directory where APPX is installed on your system if APPX is not installed in "C:\Appx".

*DEL C:\Appx\data\0SA\Struct\**

You are now ready to install Release 5 on top of your existing installation. Before installing APPX you should:
   1 Stop the APPX Connection Manager service(s).
   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

Then follow these steps:

<br />%INCLUDE{"APPX500WindowsNewInstallation"}%
---+++ Install a new APPX 5.0.0 License Key

Double click the C:\Appx\AppxDesktopClient.exe file to start the Appx Desktop Client. Click on the 'Local' tab, enter the location of the APPX engine (the appx.exe file) and click the connect button. 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. 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.

<br /><img width="672" alt="LicenseKey.png" src="%PUBURLPATH%/Main/APPX500LinuxUpgradeInstallation/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="%PUBURLPATH%/Main/APPX500LinuxUpgradeInstallation/LicenseKey500.png" height="586" />
---++ Configure the new APPX Login Manager

APPX 5 includes the new APPX Login Manager service. This service replaces the Connection Manager (AppxdSvc) which was included with APPX releases prior to APPX 5.0.0. The old Connection Manager will not work with APPX 5 and higher, and should not be used. You should remove the services installed by appxdsvc using the '-remove' keyword:

*C:\Appx\tools&gt;appxdsvc -remove -name=Appx8060*

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

C:\Appx&gt;CD services<br />C:\Appx\services&gt;appxLoginMgr.exe -install -name=appx8060 -displayName=appx8060 -port=8060 -engine=C:\Appx\appx.exe

You should see the following messages:

appx8060 Created<br />appx8060 Configured

appx8060 Started<br />appx8060 will start automatically each time you boot your system

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 Update the SYSDIR. 
      1 System Administration (Option 3), System Setup (Option 1), System Administration File Management (Option 2), Update SYSDIR (Option 14).
      * <img alt="update-sysdir.png" src="%ATTACHURL%/update-sysdir.png" />
   1 Create the new System Administration files ("System Administration/File Management/System Admin Files" on pull down menu). 
      * <img alt="Final-Steps-01-Create-New-SA-Files.png" src="%ATTACHURL%/Final-Steps-01-Create-New-SA-Files.png" />
   1 Upgrade Design Files 
      * Remove the Em, Dbg and 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) 
         * For example, your GL application's path for Em, Dbg and Struct files might look similar to: C:\Appx\data\01\DGL\Struct\* and C:\Appx\data\01\DGL\Em\* and C:\Appx\data\01\DGL\Dbg\*
      * Run Create Files for each of your applications 
         * System Administration (Option 3), Database / Applications (Option 3), Design File Management (Option 5). Specify your _Application_ and _Version,_ Create Files (Option 3).
         * <img alt="create-design-files.png" src="%ATTACHURL%/create-design-files.png" />
         * <img alt="create-design-files2.png" src="%ATTACHURL%/create-design-files2.png" />
      * 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 
         * <img alt="sync-widgets.png" src="%ATTACHURL%/sync-widgets.png" />
      * 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 If you are using Custom Fonts in your applications (i.e., bar codes, etc) follow <a target="_blank" href="UsingCustomFonts">these steps</a>, otherwise they will not print.
   1 Install the new 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
Attachments
Topic attachments
I	Attachment	History	Action	Size	Date	Who	Comment
png	create-design-files.png	r1	manage	40.9 K	2010-09-09 - 20:30	JoeOrtagus
Topic revision: r13 - 2010-09-09 - JoeOrtagus
~~Edit~~
~~Attach~~