APPX 6.1.0 (and greater) - Windows - New Installation

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 (as administrator) the APPX GUI installer from the APPX web site

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.

Read and accept the license agreement.

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

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.

APPX will then be installed into the specified destination directory.

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.

#CharInstaller

Character Mode Installation

C:\appx>appxsetup-windows-32.exe -c

C:\appx>This will install Appx Server 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 6.1.0 (and greater)

_ 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]

Set the ICU Locale

A locale identifies a specific user community - a group of users who have similar culture and language expectations for human-computer interaction (and the kinds of data they process).

A community is usually understood as the intersection of all users speaking the same language and living in the same country. Furthermore, a community can use more specific conventions. For example, an English/United States/Military locale is separate from the regular English/United States locale since the US military writes times and dates differently than most of the civilian community.

APPX needs to know your Locale. If not specified, it will default to en_US.

To change the locale, use a text editor to modify the 'appx.env' file, and add:

LANG=<desired locale>

The 'appx.env' file is located in the 'data' folder of your installation folder. For example, if APPX was installed in C:\APPX\, then 'appx.env' is located at 'C:\APPX\data\appx.env'.

See http://userguide.icu-project.org/locale for more information on Locales.

Completing the Installation

After all the files have been installed, you will have to run an APPX session to complete the configuration of the APPX environment.

If you are running in character mode (i.e., Windows Core Server), you will have to manually start the APPX Login Manager Service before you can complete the installation. Enter the following command (make sure you adjust the path names as required):

C:\appx>cd services
C:\appx\services>appxLoginMgr.exe -install -name=Appx8060 -port=8060 -engine=c:\appx\appx.exe APPXPATH=c:\appx\data APPXKEYMAP=Windows

Appx8060 Created
Appx8060 Configured

Appx8060 Started
Appx8060 will start automatically each time you boot your system

C:\appx\services>

This will start a Login Manager service on port 8060. Install the APPX Desktop Client on another workstation, and use the Remote tab to log on to this server, then complete the installation by completing the configuration.

Note that as part of completing the installation, you will be asked to install the Login Manager again. You can use the same port number again, it will not affect the installation process.

When you have completed the configuration, return to the Installation page and continue with installing the APPX Desktop Client.

Comments

-- Brian Ryan - 2021-04-14