Installing the Aeon Client

Follow

Running the Client Installation program on your local machine installs Aeon and all components necessary for it to run. The Aeon Client installation file installs the Aeon client and supporting files on your workstation.

Obtaining the Aeon Client Setup File

To install the Aeon Client software, locate and run the AeonClientSetup.exe file. It is installed with the Aeon server and should be distributed to staff workstations. You can also download this file from the Aeon 4.0 Downloads page. You will need to run the Client Installer on each machine you plan to use as a client machine.

If you are hosted by Atlas Systems you can access the client installation file from your server's setup web folder. That folder is restricted by IP to your staff workstations.

Running the Client Installer

Once you have the Client Setup file on your local machine, follow the screen by screen steps below to install the Aeon Client.

The Client installer has been modified to work with the issue in Windows 7 that caused installations to fail if the installation was not performed using Administrator privileges. If you do not begin the installation by selecting Run as administrator, you will be prompted to enter Admin credentials before the installer runs. If you are using Windows 7, you should say Yes to this option. If a client has been installed from the desktop using Administrator privileges, client updates within a major version will not require Administrator privileges. 

You will also be prompted to enter Admin credentials if you elect to open the SQL Alias Manager when the installation is complete as you will not be allowed to run the SAM without escalating to Admin privileges.

  1. Click the Client Setup icon to start the Installer. If you are going to run the installer as an Administrator, right-click the file and select Run as Administrator. You are greeted by a Welcome screen.
  2. Setup Type. Choose your setup type: either Complete or Custom. Complete installs all Client components and supporting applications to the default location (C:\Program Files\Aeon\). Custom allows you to select the features and the location where you want to install the Aeon Client.
  3. Ready to Install Aeon Client. Provides an opportunity to go back and review or change any of your installation settings. If you did not run the install as admin, you will be prompted to enter admin credentials before the installer will continue.
  4. Progress Dialog. Shows the installation progress via a green progress bar.
  5. Installation Complete. Notifies you that the Client installation is complete. If you want to open the SQL Alias Manager, check the box next to Launch SQL Alias Manager. Shortcuts for Client components are installed to the desktop (Aeon Client, Customization Manager, Staff Manager, and SQL Alias Manager) and various web components are installed (dll, web platform, GetVersionInfo, Get BuildInfo). If you did not elect to run the client installer as an administrator you will again be prompted to enter Admin credentials. You will not be allowed to run the SAM without escalating to Admin privileges.

Client Installer Command Line Options

The Aeon Client Installer supports a few command line options to provide some limited flexibility for administrative roles. If you would like to have detailed control over the Aeon setup, for either server or client installations, you should consider using the Aeon MSIs directly in combination with Microsoft's msiexec utility. They are available from your customer service agent.

Option
Result
-q, -quiet Runs the installer in quiet mode, which will provide no user interface and will automatically proceed with its typical action (install or repair) with default settings.
-uninstall

When used in conjunction with -q, this will cause the installer to uninstall Aeon from the computer. Note that when not in quiet mode, running the installer after Aeon has been installed will take you to the maintenance screen.

-repair When used in conjunction with -q, this will cause the installer to perform a repair on Aeon. Note that when not in quiet mode, running the installer after Aeon has been installed will take you to the maintenance screen.

Launching SQL Alias Manager

If you are installing the client for the first time and have not previously loaded the Atlas SQL Alias Manager onto your local machine, you will be prompted to launch the SQL Alias Manager at the end of setup. See Atlas SQL Alias Manager for help in setting up your Aeon database connection.

Client Screen Resolution

Set the screen resolution to 1024x768 or higher.

Troubleshooting the Installer

Client installer logging is recorded in the temp folder. Log files are created as the Installer goes through the process and display with Aeon_Client_ at the beginning of the filename.

Two client logs are created by an outer program that sets up and runs the client installer MSI. These logs are detailed and should contain information about any installation errors that might occur. The logging detail can be controlled with registry settings - please consult with your support representative if you need to change the logging level.

You can monitor the log files when you run the client installation by opening the temp folder and sorting the entries by “Date Modified” in order to view the latest files at the beginning of the list.

If you are hosted by Atlas Systems you can access the client installation file from your server's setup web folder. That folder is restricted by IP to your staff workstations.

Questions?

If this article didn’t resolve your issue, please take a moment and answer a few questions to help improve our documentation:

Feedback