Difference: APPX500WindowsUpgradeInstallation (1 vs. 29)

Revision 292021-08-31 - AlKalter

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

APPX Windows- APPX 5 Upgrade Instructions

Line: 183 to 183
 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. Review your 'appx.env' file.
Changed:
<
<
  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. 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. Update the SYSDIR.
    1. System Administration (Option 3), System Setup (Option 1), System Administration File Management (Option 2), Update SYSDIR (Option 14).
    • update-sysdir.png
Line: 202 to 202
 
      • sync-widgets.png
Changed:
<
<
    • 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
    • Run 'Sync Design Elements' for each of your applications.
>
>
    • Run 'Load Initial Audit History' (Application Design > Utilities menu) 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
    • Run 'Sync Design Elements' (Application Design > Utilities menu) for each of your applications.
 
  1. If you are using Custom Fonts in your applications (i.e., bar codes, etc) and you have not already updated your Resources for the new method, follow these steps, otherwise they will not print.
  2. Install the new APPX Desktop Client for all users
  3. If you were using Appx/ODBC, you must install the new version. The old version is not compatible with Release 5 and will not work. See this page for installation instructions.

Revision 282019-02-12 - JeanNeron

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

APPX Windows- APPX 5 Upgrade Instructions

Line: 182 to 182
  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

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.
  2. 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. Update the SYSDIR.
    1. System Administration (Option 3), System Setup (Option 1), System Administration File Management (Option 2), Update SYSDIR (Option 14).
    • update-sysdir.png

Revision 272016-02-25 - JeanNeron

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

APPX Windows- APPX 5 Upgrade Instructions

Line: 180 to 180
  appx8060 Started
appx8060 will start automatically each time you boot your system
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.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. Review your 'appx.env' file. Ensure any settings from 4.2.x are still there. Remove any obsolete settings.
  2. Update the SYSDIR.

Revision 262014-12-05 - JeanNeron

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

APPX Windows- APPX 5 Upgrade Instructions

Line: 66 to 66
 

Character Mode Installation

Changed:
<
<
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.
>
>
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.
  C:\Appx>Appx4to5upgrade_windows -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: 93 to 94
  System Administration (Option 3) > Database / Application (Option 3) > File Maintenance - Applications (Option 1)
Changed:
<
<
Add5SAApplication.png
>
>
Add5SAApplication.png
  Create the Design Files for Application 5SA.
Line: 101 to 102
  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
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.

System Administration (Option 3) > Database / Application (Option 3) > File Maintenance - Databases / Applications (Option 2)

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.

Run an Application (Option 1). 5SA.

Changed:
<
<		RunDatabase5SA.png
>
>		RunDatabase5SA.png
  Click on the "Convert" button to run the conversion utility.
Line: 130 to 131
  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

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

Line: 154 to 155
 Then follow these steps:


Overview

Two different methods are provided to install APPX on Windows. There is a GUI installer and a 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. A typical APPX installation on a system where APPX has not been previously installed performs the following steps:

  1. Creates the destination directory and installs APPX into it.
  2. Sets the appropriate permissions
  3. 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 Windows

Log in to your system as an administrative user.

Download and run the APPX GUI installer (appxsetup-windows.exe) from the APPX web site or the APPX ftp server.

After a few moments, the APPX Setup Wizard should display the Welcome screen. Click on the "Next" button to continue. If you are presented with a Security Warning dialog, click on the "Run" button to continue with the installation.


Welcome.PNG

Read and accept the license agreement.


AcceptLicense.PNG

Specify the Destination Directory into which APPX is to be installed. As a matter of convention, APPX is usually installed into C:\appx but may be installed into the drive and directory of your choice, but do not choose a directory with spaces in the name.


SelectDestinationDirectory.PNG

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

The APPX Setup Wizard can optionally create a Start Menu. You must specify the appropriate options. If you don't know what to specify on this screen, simply accept the recommended options by clicking on the "Next" button to proceed with the installation.


SelectStartMenu.PNG


APPX will then be installed into the specified destination directory.


InstallingFiles.PNG

Finally, you may specify whether or not you want the APPX Setup Wizard to create a shortcut on your desktop and/or a quick launch icon on the taskbar. After specifying the appropriate options, click on the "Finish" button to end the APPX Setup Wizard.


CompletingSetup.PNG

Character Mode Installation

If you are running Windows Core Server, 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.

C:\Appx>setup.exe -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?

[C:\APPX]

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

 
Changed:
<
<		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.
>
>		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.x. 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.
  License_win_before.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.
  License_win.PNG

Configure the new APPX Login Manager

Line: 202 to 203
 
    • 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
    • Run 'Sync Design Elements' for each of your applications.
Changed:
<
<
  1. If you are using Custom Fonts in your applications (i.e., bar codes, etc) and you have not already updated your Resources for the new method, follow these steps, otherwise they will not print.
>
>
  1. If you are using Custom Fonts in your applications (i.e., bar codes, etc) and you have not already updated your Resources for the new method, follow these steps, otherwise they will not print.
 
  1. Install the new APPX Desktop Client for all users
Changed:
<
<
  1. If you were using Appx/ODBC, you must install the new version. The old version is not compatible with Release 5 and will not work. See this page for installation instructions.
>
>
  1. If you were using Appx/ODBC, you must install the new version. The old version is not compatible with Release 5 and will not work. See this page for installation instructions.
 
  1. Configure new features as desired

Comments:

Revision 252012-03-13 - JoeOrtagus

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

APPX Windows- APPX 5 Upgrade Instructions

Line: 23 to 23
 
  1. Ask all users to log off
  2. Verify the integrity of all files in your system and correct any errors.
    • System Administration Files
Changed:
<
<
      • System Administration (Option 3) > System Setup (Option 1) > System Administration File Management (Option 2) > Verify Files (Option 12) > Verify Integrity of APPXIO Files (Option 1) Should be on file system path similar to \Appx\data\0SA\Data\*
>
>
      • System Administration (Option 3) > System Setup (Option 1) > System Administration File Management (Option 2) > Select All (Option 2) > END > Verify Files (Option 12) > Verify Integrity of APPXIO Files (Option 1) Should be on file system path similar to \Appx\data\0SA\Data\*
        • Each file should have a status of OK, or Skipped: Temporary or Non-indexed File.
 
    • Design Files
      • System Administration (Option 3) > Database/Applications (Option 3) > Design File Management (Option 5) > Enter the Application and Version number for each application that you want upgraded to APPX 5 > Select all files > Verify Files (Option 12) > Verify Integrity of APPXIO Files (Option 1) Should be on a file system path similar to \Appx\data\00\TGL\Data\*. Look for failures. Skips are okay.
    • Data Files

Revision 242011-03-25 - JeanNeron

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

APPX Windows- APPX 5 Upgrade Instructions

Line: 27 to 27
 
    • Design Files
      • System Administration (Option 3) > Database/Applications (Option 3) > Design File Management (Option 5) > Enter the Application and Version number for each application that you want upgraded to APPX 5 > Select all files > Verify Files (Option 12) > Verify Integrity of APPXIO Files (Option 1) Should be on a file system path similar to \Appx\data\00\TGL\Data\*. Look for failures. Skips are okay.
    • Data Files
Changed:
<
<
      • System Administration (Option 3) > Database/Applications (Option 3) > File Maintenance - Database / Applications (Option 2) > Select the database (RETURN, RETURN) > For each application select Database Management (Option 5) > Select All (Option 2) > END > Verify Files Menu (Option 12) > Verify Integrity of APPXIO Files (Option 1. Look for failures. Skips are okay. Path will be similar to \Appx\data\TGL\TGL\Data\*
>
>
      • System Administration (Option 3) > Database/Applications (Option 3) > File Maintenance - Database / Applications (Option 2) > Select the database (RETURN, RETURN) > For each application select Database Management (Option 5) > Select All (Option 2) > END > Verify Files Menu (Option 12) > Verify Integrity of APPXIO Files (Option 1. Look for failures. Skips are okay. Path will be similar to \Appx\data\TGL\TGL\Data\*
 
  1. Backup your system
  2. Obtain a new Release 5.0 License from your Reseller or Distributor
Line: 182 to 182
  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. Update the SYSDIR.
    1. System Administration (Option 3), System Setup (Option 1), System Administration File Management (Option 2), Update SYSDIR (Option 14).
    • update-sysdir.png

Revision 232011-01-27 - JoeOrtagus

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

APPX Windows- APPX 5 Upgrade Instructions

Line: 27 to 27
 
    • Design Files
      • System Administration (Option 3) > Database/Applications (Option 3) > Design File Management (Option 5) > Enter the Application and Version number for each application that you want upgraded to APPX 5 > Select all files > Verify Files (Option 12) > Verify Integrity of APPXIO Files (Option 1) Should be on a file system path similar to \Appx\data\00\TGL\Data\*. Look for failures. Skips are okay.
    • Data Files
Changed:
<
<
      • System Administration (Option 3) > Database/Applications (Option 3) > File Maintenance - Database / Applications (Option 2) > Select the database (RETURN, RETURN) > For each application select Database Management (Option 5) > Select All (Option 2) > END > Verify Files Menu (Option 12) > Verify Integrity of APPXIO Files (Option 1)
>
>
      • System Administration (Option 3) > Database/Applications (Option 3) > File Maintenance - Database / Applications (Option 2) > Select the database (RETURN, RETURN) > For each application select Database Management (Option 5) > Select All (Option 2) > END > Verify Files Menu (Option 12) > Verify Integrity of APPXIO Files (Option 1. Look for failures. Skips are okay. Path will be similar to \Appx\data\TGL\TGL\Data\*
 
  1. Backup your system
  2. Obtain a new Release 5.0 License from your Reseller or Distributor

Revision 222011-01-27 - JoeOrtagus

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

APPX Windows- APPX 5 Upgrade Instructions

Line: 27 to 27
 
    • Design Files
      • System Administration (Option 3) > Database/Applications (Option 3) > Design File Management (Option 5) > Enter the Application and Version number for each application that you want upgraded to APPX 5 > Select all files > Verify Files (Option 12) > Verify Integrity of APPXIO Files (Option 1) Should be on a file system path similar to \Appx\data\00\TGL\Data\*. Look for failures. Skips are okay.
    • Data Files
Added:
>
>
      • System Administration (Option 3) > Database/Applications (Option 3) > File Maintenance - Database / Applications (Option 2) > Select the database (RETURN, RETURN) > For each application select Database Management (Option 5) > Select All (Option 2) > END > Verify Files Menu (Option 12) > Verify Integrity of APPXIO Files (Option 1)
 
  1. Backup your system
  2. Obtain a new Release 5.0 License from your Reseller or Distributor

Revision 212011-01-26 - JoeOrtagus

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

APPX Windows- APPX 5 Upgrade Instructions

Line: 25 to 25
 
    • System Administration Files
      • System Administration (Option 3) > System Setup (Option 1) > System Administration File Management (Option 2) > Verify Files (Option 12) > Verify Integrity of APPXIO Files (Option 1) Should be on file system path similar to \Appx\data\0SA\Data\*
    • Design Files
Added:
>
>
      • System Administration (Option 3) > Database/Applications (Option 3) > Design File Management (Option 5) > Enter the Application and Version number for each application that you want upgraded to APPX 5 > Select all files > Verify Files (Option 12) > Verify Integrity of APPXIO Files (Option 1) Should be on a file system path similar to \Appx\data\00\TGL\Data\*. Look for failures. Skips are okay.
 
    • Data Files
  1. Backup your system
  2. Obtain a new Release 5.0 License from your Reseller or Distributor
Line: 64 to 65
 

Character Mode Installation

Changed:
<
<
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.
>
>
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.
  C:\Appx>Appx4to5upgrade_windows -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]

Revision 202011-01-04 - GaryRogers

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

APPX Windows- APPX 5 Upgrade Instructions

Line: 64 to 64
 

Character Mode Installation

Changed:
<
<
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.
>
>
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.
  C:\Appx>Appx4to5upgrade_windows -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: 139 to 139
  COPY C:\Appx\data\5SA\5SA\Data\ C:\Appx\data\0SA\Data\*
Added:
>
>		If you are prompted to overwrite any files answer Yes or All.
 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\*

Line: 155 to 157
  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.
Changed:
<
<
LicenseKey.png
>
>		License_win_before.PNG
  After installing a new 5.0.0 License Key, your System Registration screen should include an Effective Date.
Changed:
<
<
LicenseKey500.png
>
>		License_win.PNG
 

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:

Line: 189 to 191
 
    • 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).
      • create-design-files.png
Added:
>
>
 
      • create-design-files2.png
Changed:
<
<
    • 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 'Sync Widget Elements' for each of your applications from the Utilities Menu in Application Design. This is optional, as APPX will force you to do this the first time you go into an application after installing Release 5.0
 
      • sync-widgets.png
Added:
>
>
 
    • 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
    • Run 'Sync Design Elements' for each of your applications.
  1. If you are using Custom Fonts in your applications (i.e., bar codes, etc) and you have not already updated your Resources for the new method, follow these steps, otherwise they will not print.
Line: 219 to 225
 
META FILEATTACHMENT attachment="InstallingFiles_win.PNG" attr="" comment="" date="1294158809" name="InstallingFiles_win.PNG" path="InstallingFiles_win.PNG" size="21801" stream="InstallingFiles_win.PNG" tmpFilename="/tmp/sfGlNXMDmU" user="GaryRogers" version="1"
META FILEATTACHMENT attachment="Fnished_win.PNG" attr="" comment="" date="1294158817" name="Fnished_win.PNG" path="Fnished_win.PNG" size="85147" stream="Fnished_win.PNG" tmpFilename="/tmp/7iE0oj74ju" user="GaryRogers" version="1"
META FILEATTACHMENT attachment="DestinationDirectory_win.PNG" attr="" comment="" date="1294159487" name="DestinationDirectory_win.PNG" path="DestinationDirectory_win.PNG" size="24691" stream="DestinationDirectory_win.PNG" tmpFilename="/tmp/VYAL8WfqHI" user="GaryRogers" version="1"
Added:
>
>
META FILEATTACHMENT attachment="License_win.PNG" attr="" comment="" date="1294163445" name="License_win.PNG" path="License_win.PNG" size="33066" stream="License_win.PNG" tmpFilename="/tmp/DtfAg5waX1" user="GaryRogers" version="1"
META FILEATTACHMENT attachment="License_win_before.PNG" attr="" comment="" date="1294166485" name="License_win_before.PNG" path="License_win_before.PNG" size="33108" stream="License_win_before.PNG" tmpFilename="/tmp/6MJzr38kdw" user="GaryRogers" version="1"

Revision 192011-01-04 - GaryRogers

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

APPX Windows- APPX 5 Upgrade Instructions

Line: 44 to 44
  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.
Changed:
<
<
Welcome.png
>
>		Welcome_win.PNG
  Read the Installation Instructions and then click on the "Next" button to continue.
Changed:
<
<
InstallationInstructions.png
>
>		Instructions_win.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.
Changed:
<
<
DestinationDirectory.png
>
>		DestinationDirectory_win.PNG
  The APPX Upgrade Application (5SA Version 00) will then be installed into the specified destination directory.
Changed:
<
<
InstallingFiles.png
>
>		InstallingFiles_win.PNG
  When the installation wizard displays the final screen, click on the Finish button to end the installation wizard.
Changed:
<
<
Finished.png
>
>		Fnished_win.PNG
 

Character Mode Installation

Line: 214 to 214
 
META FILEATTACHMENT attachment="create-design-files.png" attr="" comment="" date="1284064247" name="create-design-files.png" path="create-design-files.png" size="41928" stream="create-design-files.png" tmpFilename="/tmp/2pZaCV70Wi" user="JoeOrtagus" version="1"
META FILEATTACHMENT attachment="create-design-files2.png" attr="h" comment="" date="1284064536" name="create-design-files2.png" path="create-design-files2.png" size="39673" stream="create-design-files2.png" tmpFilename="/tmp/y6YbmI8mxX" user="JoeOrtagus" version="1"
META FILEATTACHMENT attachment="sync-widgets.png" attr="h" comment="" date="1284064730" name="sync-widgets.png" path="sync-widgets.png" size="39252" stream="sync-widgets.png" tmpFilename="/tmp/kQFPPmLFPc" user="JoeOrtagus" version="1"
Added:
>
>
META FILEATTACHMENT attachment="Welcome_win.PNG" attr="" comment="" date="1294158584" name="Welcome_win.PNG" path="Welcome_win.PNG" size="85045" stream="Welcome_win.PNG" tmpFilename="/tmp/IJfPO3ensO" user="GaryRogers" version="1"
META FILEATTACHMENT attachment="Instructions_win.PNG" attr="" comment="" date="1294158767" name="Instructions_win.PNG" path="Instructions_win.PNG" size="29894" stream="Instructions_win.PNG" tmpFilename="/tmp/0q0MHXXn4g" user="GaryRogers" version="1"
META FILEATTACHMENT attachment="InstallingFiles_win.PNG" attr="" comment="" date="1294158809" name="InstallingFiles_win.PNG" path="InstallingFiles_win.PNG" size="21801" stream="InstallingFiles_win.PNG" tmpFilename="/tmp/sfGlNXMDmU" user="GaryRogers" version="1"
META FILEATTACHMENT attachment="Fnished_win.PNG" attr="" comment="" date="1294158817" name="Fnished_win.PNG" path="Fnished_win.PNG" size="85147" stream="Fnished_win.PNG" tmpFilename="/tmp/7iE0oj74ju" user="GaryRogers" version="1"
META FILEATTACHMENT attachment="DestinationDirectory_win.PNG" attr="" comment="" date="1294159487" name="DestinationDirectory_win.PNG" path="DestinationDirectory_win.PNG" size="24691" stream="DestinationDirectory_win.PNG" tmpFilename="/tmp/VYAL8WfqHI" user="GaryRogers" version="1"

Revision 182010-11-10 - JeanNeron

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

APPX Windows- APPX 5 Upgrade Instructions

Line: 194 to 194
 
      • 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
    • Run 'Sync Design Elements' for each of your applications.
Changed:
<
<
  1. If you are using Custom Fonts in your applications (i.e., bar codes, etc) follow these steps, otherwise they will not print.
>
>
  1. If you are using Custom Fonts in your applications (i.e., bar codes, etc) and you have not already updated your Resources for the new method, follow these steps, otherwise they will not print.
 
  1. Install the new APPX Desktop Client for all users
  2. If you were using Appx/ODBC, you must install the new version. The old version is not compatible with Release 5 and will not work. See this page for installation instructions.
  3. Configure new features as desired

Revision 172010-11-09 - JeanNeron

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

APPX Windows- APPX 5 Upgrade Instructions

Line: 193 to 193
 
    • 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
      • 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
Added:
>
>
    • Run 'Sync Design Elements' for each of your applications.
 
  1. If you are using Custom Fonts in your applications (i.e., bar codes, etc) follow these steps, otherwise they will not print.
  2. Install the new APPX Desktop Client for all users
  3. If you were using Appx/ODBC, you must install the new version. The old version is not compatible with Release 5 and will not work. See this page for installation instructions.

Revision 162010-11-09 - JeanNeron

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

APPX Windows- APPX 5 Upgrade Instructions

Revision 152010-11-09 - JeanNeron

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

APPX Windows- APPX 5 Upgrade Instructions

Line: 13 to 13
  To upgrade your existing APPX Windows installation from APPX 4.2.a to APPX 5, you must complete the following steps:
Deleted:
<
<
  1. Obtain a new Release 5.0 License from your Reseller or Distributor
 
  1. Complete the preliminary tasks
  2. Convert Your System Administration Files
  3. Install the APPX Utility upgrade
Line: 28 to 27
 
    • Design Files
    • Data Files
  1. Backup your system
Added:
>
>
  1. Obtain a new Release 5.0 License from your Reseller or Distributor
 

Convert Your System Administration Files

Line: 195 to 195
 
    • 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 these steps, otherwise they will not print.
  2. Install the new APPX Desktop Client for all users
Added:
>
>
  1. If you were using Appx/ODBC, you must install the new version. The old version is not compatible with Release 5 and will not work. See this page for installation instructions.
 
  1. Configure new features as desired

Comments:

Revision 142010-09-13 - JoeOrtagus

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

APPX Windows- APPX 5 Upgrade Instructions

Line: 24 to 24
 
  1. Ask all users to log off
  2. Verify the integrity of all files in your system and correct any errors.
    • System Administration Files
Added:
>
>
      • System Administration (Option 3) > System Setup (Option 1) > System Administration File Management (Option 2) > Verify Files (Option 12) > Verify Integrity of APPXIO Files (Option 1) Should be on file system path similar to \Appx\data\0SA\Data\*
 
    • Design Files
    • Data Files
  1. Backup your system

Revision 132010-09-09 - JoeOrtagus

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

APPX Windows- APPX 5 Upgrade Instructions

Line: 88 to 88
  Add the upgrade application (5SA 00) to the Applications file.
Added:
>
>		System Administration (Option 3) > Database / Application (Option 3) > File Maintenance - Applications (Option 1)
 
Add5SAApplication.png
Changed:
<
<		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
>
>		Create the Design Files for Application 5SA.

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

  Screen_shot_2009-11-10_at_2.46.40_PM.png

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

Added:
>
>		System Administration (Option 3) > Database / Application (Option 3) > File Maintenance - Databases / Applications (Option 2)
 
Add5SADatabase.png

Run Database Management for the Upgrade Application and Database.

Line: 109 to 117
  After configuring the Upgrade Application, you must run the Upgrade Utility to convert your System Administration files.
Added:
>
>		Run an Application (Option 1). 5SA.
 RunDatabase5SA.png

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

Changed:
<
<
ConversionUtility.png
>
>		5SA-Running-Conversion-Program.png
  The conversion utility will create a log. Specify the appropriate disposition options to print the conversion log.
Line: 167 to 177
  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. Update the SYSDIR.
    1. System Administration (Option 3), System Setup (Option 1), System Administration File Management (Option 2), Update SYSDIR (Option 14).
    • update-sysdir.png
 
  1. Create the new System Administration files ("System Administration/File Management/System Admin Files" on pull down menu).
Added:
>
>
    • Final-Steps-01-Create-New-SA-Files.png
 
  1. Upgrade Design Files
Changed:
<
<
    • 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)
>
>
    • 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
Added:
>
>
      • System Administration (Option 3), Database / Applications (Option 3), Design File Management (Option 5). Specify your Application and Version, Create Files (Option 3).
      • create-design-files.png
      • 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
Added:
>
>
      • 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 these steps, otherwise they will not print.
  2. Install the new APPX Desktop Client for all users
Line: 184 to 203
 
<--/commentPlugin-->

-- SteveFrizzell - 2 Nov 2009 \ No newline at end of file

Added:
>
>
META FILEATTACHMENT attachment="5SA-Create-Design-Files.png" attr="h" comment="" date="1284056853" name="5SA-Create-Design-Files.png" path="5SA-Create-Design-Files.png" size="40010" stream="5SA-Create-Design-Files.png" tmpFilename="/tmp/ZE17lEA1P2" user="JoeOrtagus" version="1"
META FILEATTACHMENT attachment="5SA-Running-Conversion-Program.png" attr="h" comment="" date="1284058096" name="5SA-Running-Conversion-Program.png" path="5SA-Running-Conversion-Program.png" size="38757" stream="5SA-Running-Conversion-Program.png" tmpFilename="/tmp/ypD1FqJqns" user="JoeOrtagus" version="1"
META FILEATTACHMENT attachment="Final-Steps-01-Create-New-SA-Files.png" attr="h" comment="" date="1284060477" name="Final-Steps-01-Create-New-SA-Files.png" path="Final-Steps-01-Create-New-SA-Files.png" size="41125" stream="Final-Steps-01-Create-New-SA-Files.png" tmpFilename="/tmp/jdCbSLHof2" user="JoeOrtagus" version="1"
META FILEATTACHMENT attachment="update-sysdir.png" attr="h" comment="" date="1284063459" name="update-sysdir.png" path="update-sysdir.png" size="36457" stream="update-sysdir.png" tmpFilename="/tmp/FJQShCGM5w" user="JoeOrtagus" version="1"
META FILEATTACHMENT attachment="create-design-files.png" attr="" comment="" date="1284064247" name="create-design-files.png" path="create-design-files.png" size="41928" stream="create-design-files.png" tmpFilename="/tmp/2pZaCV70Wi" user="JoeOrtagus" version="1"
META FILEATTACHMENT attachment="create-design-files2.png" attr="h" comment="" date="1284064536" name="create-design-files2.png" path="create-design-files2.png" size="39673" stream="create-design-files2.png" tmpFilename="/tmp/y6YbmI8mxX" user="JoeOrtagus" version="1"
META FILEATTACHMENT attachment="sync-widgets.png" attr="h" comment="" date="1284064730" name="sync-widgets.png" path="sync-widgets.png" size="39252" stream="sync-widgets.png" tmpFilename="/tmp/kQFPPmLFPc" user="JoeOrtagus" version="1"

Revision 122010-08-30 - JoeOrtagus

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

APPX Windows- APPX 5 Upgrade Instructions

Line: 126 to 126
  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 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"
Changed:
<
<		COPY C:\Appx\data\5SA\5SA\Data\ C:\Appx\data\0SA\Data*
>
>		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".

Revision 112010-08-30 - JoeOrtagus

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

APPX Windows- APPX 5 Upgrade Instructions

Line: 41 to 41
  Log in to your system as an administrative user.
Changed:
<
<		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.
>
>		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.
 
Welcome.png

Revision 102010-07-08 - JeanNeron

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

APPX Windows- APPX 5 Upgrade Instructions

Line: 172 to 172
 
    • 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
Changed:
<
<
    • 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.
>
>
    • 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 these steps, otherwise they will not print.
 
  1. Install the new APPX Desktop Client for all users
  2. Configure new features as desired

Comments:

Revision 92010-02-23 - JeanNeron

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

APPX Windows- APPX 5 Upgrade Instructions

Line: 63 to 63
 

Character Mode Installation

Changed:
<
<
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.
>
>
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.
  C:\Appx>Appx4to5upgrade_windows -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: 169 to 169
 

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 82010-01-30 - RayPelegrino

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

APPX Windows- APPX 5 Upgrade Instructions

Revision 72010-01-08 - JeanNeron

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

APPX Windows- APPX 5 Upgrade Instructions

Revision 62009-12-08 - JeanNeron

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

APPX Windows- APPX 5 Upgrade Instructions

Line: 26 to 26
 
    • System Administration Files
    • Design Files
    • Data Files
Deleted:
<
<
  1. Stop the APPX Connection Manager service(s).
  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: 135 to 132
  DEL C:\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 installing APPX you should:
  1. Stop the APPX Connection Manager service(s).
  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 Windows. There is a GUI installer and a 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. A typical APPX installation on a system where APPX has not been previously installed performs the following steps:

  1. Creates the destination directory and installs APPX into it.
  2. Sets the appropriate permissions
  3. 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 Windows

Log in to your system as an administrative user.

Download and run the APPX GUI installer (appxsetup-windows.exe) from the APPX web site or the APPX ftp server.

After a few moments, the APPX Setup Wizard should display the Welcome screen. Click on the "Next" button to continue. If you are presented with a Security Warning dialog, click on the "Run" button to continue with the installation.


Welcome.PNG

Read and accept the license agreement.


AcceptLicense.PNG

Specify the Destination Directory into which APPX is to be installed. As a matter of convention, APPX is usually installed into C:\appx but may be installed into the drive and directory of your choice, but do not choose a directory with spaces in the name.


SelectDestinationDirectory.PNG

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

The APPX Setup Wizard can optionally create a Start Menu. You must specify the appropriate options. If you don't know what to specify on this screen, simply accept the recommended options by clicking on the "Next" button to proceed with the installation.


SelectStartMenu.PNG


APPX will then be installed into the specified destination directory.


InstallingFiles.PNG

Finally, you may specify whether or not you want the APPX Setup Wizard to create a shortcut on your desktop and/or a quick launch icon on the taskbar. After specifying the appropriate options, click on the "Finish" button to end the APPX Setup Wizard.


CompletingSetup.PNG

Character Mode Installation

If you are running Windows Core Server, 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.

C:\Appx>setup.exe -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?

[C:\APPX]

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 52009-12-08 - GaryRogers

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

APPX Windows- APPX 5 Upgrade Instructions

Line: 9 to 9
 
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 you must upgrade to APPX 4.2.a first and then upgrade to APPX 5.
  To upgrade your existing APPX Windows installation from APPX 4.2.a to APPX 5, you must complete the following steps:
Line: 34 to 34
 

Convert Your System Administration Files

Changed:
<
<		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.
>
>		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 GUI installer and a 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.

Line: 165 to 165
  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. Install the new APPX Desktop Client for all users
  2. Configure new features as desired

Comments:

Revision 42009-11-25 - JeffPrentice

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

APPX Windows- APPX 5 Upgrade Instructions

Line: 44 to 44
  Log in to your system as an administrative user.
Changed:
<
<		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 serverAfter 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.
>
>		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.
 
Welcome.png

Revision 32009-11-20 - JeanNeron

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

APPX Windows- APPX 5 Upgrade Instructions

Line: 171 to 171
 
    • 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.
  1. Create the new System Administration files ("System Administration/File Management/System Admin Files" on pull down menu).
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 22009-11-12 - JeanNeron

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

APPX Windows- APPX 5 Upgrade Instructions

Line: 153 to 153
  C:\Appx\tools>appxdsvc -remove -name=Appx8060
Changed:
<
<		To configure and start the new APPX Login Manager service, log in as the root user and execute a command similar to the following:
>
>		To configure and start the new APPX Login Manager service, log in as an administrative user and execute a command similar to the following:
 
Changed:
<
<
 /usr/local/appx/services/appxLoginMgr -install -name=appxLogin8060 -port=8060
>
>		C:\Appx>CD services
C:\Appx\services>appxLoginMgr.exe -install -name=appx8060 -displayName=appx8060 -port=8060 -engine=C:\Appx\appx.exe
 
Changed:
<
<		 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_
>
>		You should see the following messages:

appx8060 Created
appx8060 Configured

appx8060 Started
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 complete documentation.

Final Tasks

Line: 181 to 170
 
    • 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 12009-11-12 - JeanNeron

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

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.


Overview


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 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
  2. Complete the preliminary tasks
  3. Convert Your System Administration Files
  4. Install the APPX Utility upgrade
  5. Install a new APPX 5.0.0 License Key
  6. Configure the new APPX Login Manager
  7. Final Tasks

Preliminary Tasks

  1. Ask all users to log off
  2. Verify the integrity of all files in your system and correct any errors.
    • System Administration Files
    • Design Files
    • Data Files
  3. Stop the APPX Connection Manager service(s).
  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 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

Two different methods are provided to install the upgrade application on Windows. There is a GUI installer and a 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.

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


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

Character Mode 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.

C:\Appx>Appx4to5upgrade_windows -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?
[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.


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

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

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

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 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. Follow these steps:


Overview

Two different methods are provided to install APPX on Windows. There is a GUI installer and a 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. A typical APPX installation on a system where APPX has not been previously installed performs the following steps:

  1. Creates the destination directory and installs APPX into it.
  2. Sets the appropriate permissions
  3. 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 Windows

Log in to your system as an administrative user.

Download and run the APPX GUI installer (appxsetup-windows.exe) from the APPX web site or the APPX ftp server.

After a few moments, the APPX Setup Wizard should display the Welcome screen. Click on the "Next" button to continue. If you are presented with a Security Warning dialog, click on the "Run" button to continue with the installation.


Welcome.PNG

Read and accept the license agreement.


AcceptLicense.PNG

Specify the Destination Directory into which APPX is to be installed. As a matter of convention, APPX is usually installed into C:\appx but may be installed into the drive and directory of your choice, but do not choose a directory with spaces in the name.


SelectDestinationDirectory.PNG

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

The APPX Setup Wizard can optionally create a Start Menu. You must specify the appropriate options. If you don't know what to specify on this screen, simply accept the recommended options by clicking on the "Next" button to proceed with the installation.


SelectStartMenu.PNG


APPX will then be installed into the specified destination directory.


InstallingFiles.PNG

Finally, you may specify whether or not you want the APPX Setup Wizard to create a shortcut on your desktop and/or a quick launch icon on the taskbar. After specifying the appropriate options, click on the "Finish" button to end the APPX Setup Wizard.


CompletingSetup.PNG

Character Mode Installation

If you are running Windows Core Server, 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.

C:\Appx>setup.exe -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?

[C:\APPX]

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

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.


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 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>appxdsvc -remove -name=Appx8060

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
    • 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.
  2. Create the new System Administration files ("System Administration/File Management/System Admin Files on pull down menu").
  3. Upgrade APPX Desktop Client for all users
  4. Configure new features as desired

Comments:

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


<--/commentPlugin-->

-- SteveFrizzell - 2 Nov 2009

View topic | History: r29 < r28 < r27 < r26 | More topic actions...
 
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