AutoMate Command-Line Installation

AutoMate Professional, Premium or Runtime components can be installed using simple command-line parameters through the use of the Windows Installer executable MSIExec.exe along with the AutoMate MSI file. This allows for easy mass deployment and simplified automated installations.

What You Will Need


Command-line installation requires the following items:

  1. AutoMate installation MSI file (which can be found as a separate download link on the Account Maintenance Page).

  2. AutoMate Serial Number(s).

  3. AutoMate 8 or AutoMate 9 Serial Number (if upgrading to AutoMate 9).

Installation Properties


 

The following properties can be used during a command-line installation of AutoMate 9. Properties and their values are separated by equal signs and should appear after the MSIExec.exe command but before MSIExec switch options. While the property values are not case sensitive, All properties must be entered in uppercase.

Property Name

Description

Example

SERIALCODE

The AutoMate 9 serial code used to register the software. If this is not provided, AutoMate will install as a 30 day evaluation version.

SERIALCODE="AM9-12345-12345-12345-12345-12345"

UPGRADESERIAL

The AutoMate 8 or AutoMate 9 original serial code used in association with the AutoMate 9 upgrade serial code (for those who acquired an upgrade license). If SERIALCODE specified an upgrade serial code, this property must be used as well.

UPGRADESERIAL="AM8-1234-1234-1234-1234"

LOGGINGDATASOURCE

AutoMate Premium Edition allows a valid database connection string to use for External Database Logging. If this property is supplied, External Database Logging is automatically enabled after installation is completed. Since External Database Logging functionality requires an AutoMate Premium serial code, this property is ignored if SERIALCODE is not a valid Premium Edition serial code.

LOGGINGDATASOURCE="<ConnectionString>"

REMOTEPASSWORD

AutoMate Premium Edition allows for Runtime Required for Premium Runtime Editions. Optional for other Editions

Enables Remote Administration and set the password to the value of REMOTEPASSWORD.  Must be supplied for Premium Agent installations, otherwise administration of product is not possible.

REMOTEPASSWORD="MyPassword"

REMOTEPORT

Optional

Use a port other than the default 7977 for Remote Administration connections.

REMOTEPORT="8100"

Installing AutoMate Professional


To install AutoMate Professional, use the following command-line:

 

msiexec.exe /i "<path to AutoMate MSI file>" SERIALCODE="AM9-12345-56780-12345-56780-12345" /qn

 

where <path to AutoMate MSI file> is the full path to the AutoMate installation, and SERIALCODE is set to your AutoMate Serial Code. The /i switch specifies an install, and /qn indicates a silent install with no user dialogs. For example, if the MSI file was on the C:\ drive in folder AutoMateInstall, and our serial code was AM8-1234-5678-1234-5678, the command line would look like this:

 

msiexec.exe /i "C:\AutoMateInstall\AutoMate.msi" SERIALCODE="AM8-12345-56780-12345-56780-12345" /qn

 

 

The installation would then proceed silently in the background. The install is complete when the AutoMate "A" icon appears in the system tray near the system clock.

NOTE: The SERIALCODE property sets the serial code for the AutoMate product and must be present in order for the product to register properly with the system. While the serial code itself is not case sensitive, the keyword SERIALCODE must be in uppercase.

Upgrading from AutoMate 8 or AutoMate 9


When upgrading from AutoMate 8 or AutoMate 9, you must also specify the original serial code with the UPGRADESERIAL keyword. For example, if our AutoMate 9 serial code was "AM8-1234-1234-1234-1234", the command line would look like this:

 

msiexec.exe /i "C:\AutoMateInstall\AutoMate.msi" SERIALCODE="AM9-12345-56780-12345-56780-12345" UPGRADESERIAL="AM8-1234-1234-1234-1234" /qn

 

The installation would then proceed silently in the background. The install is complete when the AutoMate "A" icon appears in the system tray near the system clock.

Creating an Install Log


To create a log file to trace the progress of the installation, use the /L option and specify the level of logging. For example, to create a verbose log, the command-line would look like this:

 

msiexec.exe /i "C:\AutoMateInstall\AutoMate.msi" SERIALCODE="AM9-12345-56780-12345-56780-12345" /qn /L*v AMInstall.log

 

Enabling Remote Administration


To enable Remote Administration (which is necessary for AutoMate Premium Runtime installations but optional for Professional and Premium Developer installs), use the REMOTEPASSWORD property. For example:

 

msiexec.exe /i "C:\AutoMateInstall\AutoMate8.msi" SERIALCODE="AM9-12345-56780-12345-56780-12345" REMOTEPASSWORD="mypassword"

 

You can further specify a TCP/IP port other than the default (7977) using the REMOTEPORT property. For example:

msiexec.exe /i "C:\AutoMateInstall\AutoMate8.msi" SERIALCODE="AM9-12345-56780-12345-56780-12345" REMOTEPASSWORD="mypassword" REMOTEPORT="8100"

 

Installing AutoMate Premium Developer Tools


AutoMate Premium installations work the same way as AutoMate Professional installations but include an additional install property, LOGGINGDATASOURCE, to activate external database logging. To enable external database logging, you must first know the datasource connection string to use. If you have already configured the datasource on an installation of AutoMate Premium using the AutoMate Task Administrator's System Options, the datasource string can be found in the registry under:

HKEY_LOCAL_MACHINE\Software\Network Automation\AutoMate 9\Task Service\Logging
Value name: DBExternalDatasource

Apply this entry after the SERIALCODE properties. For example:

msiexec.exe /i <path to AutoMate MSI file> SERIALCODE="AM9-xxxxx-xxxxx-xxxxx-xxxxx-xxxxx" LOGGINGDATASOURCE="<datasourcestring>" /qn

 

NOTE: This property is used only if the SERIALCODE property is a valid AutoMate Premium Developer or AutoMate Premium Runtime serial code.

Installing AutoMate Premium Runtime Component


AutoMate Premium Runtime installations work the same way as AutoMate Professional and AutoMate Premium Developer installations except it is required that a REMOTEPASSWORD property be supplied. Because AutoMate Premium Runtime components lack the Task Administrator and Task Builder Development interfaces, the Task Service cannot be configured without remote administration. Follow the instructions for the AutoMate Professional installation above together with the REMOTEPASSWORD property instructions.

NOTE: If the Runtime component is installed without a remote password, the product will need to be uninstalled and reinstalled with the correct properties.

See Also:

Installation Properties

Software Updates

System Requirements

↑ Top of Page