Try TT Now

ICE Gateway

Installing via the Command Line

Overview

Use the command line interface to expedite the installation process by suppressing some or all of the dialog boxes that appear during a GUI installation. This becomes particularly useful when installing multiple instances of the ICE Gateway.

When entering the command, use the following syntax:

packagename.exe -a --argument1=value --argument2=value where:

packagename.exe equals the name of the executable file (e.g., ICE_rVersion 7.16.0.1p2.exe).

-a identifies that arguments follow in the command.

--argument1 equals the arguments you wish to use from the table below.

Warning

When entering commands, you can not include spaces between the argument and its value. For example, --argument1=value works while --argument1 = value does not.

Creating an Install Configuration File

For multiple installs, you can open a text editor, such as Notepad, and create an install configuration file that contains a list of arguments you wish to use. When creating an install configuration file, you must list each argument on a separate line.

Example Install Configuration File

installroot=c:program filestt

exhangename=ICE-B

reboot=force

Once created, you can give the file any name you want. You can then begin the installation by adding the filename to the --installcfg argument. The example below shows the command line argument to install ICE Gateway version Version 7.16 package 2 using a install configuration file named Install.txt located on the C: drive:

ICE_rVersion 7.16.0.1p2.exe -a installcfg=c:Install.txt

Note

You should only begin the argument with -- when passing the command via the command line. You must omit the -- from the argument when passing the command in a configuration file.

Installing the TT Gateway Software via the Command Line Interface

To begin the command line installation:

  1. Download the package executable file from the TT Customer Portal. To simplify the install, place the file on the server’s <root drive>.
  2. Open a command window by selecting Run on the Start menu and typing CMD.
  3. When the command window appears, use the cd <root drive>: command to navigate to the location of the executable.
  4. Enter the name of the executable file followed by -a and the arguments you wish to use.

    Example Installation Arguments for the ICE Gateway:

    Entering:

    ICE_rVersion 7.16.0.1p2.exe -a --installroot=c:softwarett --exhangename=ICE-B --reboot=force

    causes the ICE Gateway installation to perform the following:

    • The Gateway installs into the c:softwarett directory
    • The exchange-flavor equals ICE-B
    • The server automatically reboots after the install completes
    Warning

    When entering commands, you can not include spaces between the argument and its value. For example, --argument1=value works while --argument1 = value does not.

    In addition, you should only begin the argument with -- when passing the command via the command line. You must omit the -- from the argument when passing the command in a configuration file.

Installation Arguments

Argument

Function

--accept_eula

Accept EULA and bypass the license agreement screen.

--aconfigxml=location

Suppresses the Browse for aconfig.xml dialog box and uses the provided network aconfig.xml file.

Using this argument causes the installation to update the revision count on the existing network aconfig.xml file.

Warning

Do not use the ovr command when supplying an existing network aconfig.xml file.

--pkgaconfig

Suppresses the Browse for aconfig.xml dialog box and uses the aconfig.xml file included with the package instead of using a network aconfig.xml file.

This command only valid for clean installs. Also, this command only available in TT Gateways Version 7.15 and higher.

Note

Passing the aconfigxml argument overrides the pkgaconfig.

If both arguments are present, the installation will ignore the pkgaconfig argument and use the network aconfig.xml file instead.

--confirmupgrade

Suppresses the verification dialog boxes for re-installing or upgrading the TT Gateway.

This command only available in TT Gateways Version 7.15 and higher.

--exchangename=Exchange-Flavor

Suppresses the Available Exchange Names dialog and sets the Exchange-Flavor for the ICE Gateway.

--reboot=force

Sets the server’s behavior following the installation. The --reboot command uses the following values:

  • norestart: The installation does not reboot the server. In addition, the installation suppresses the Reboot Now dialog.
  • force: The installation reboots the server without displaying the Reboot Now dialog.
  • promptrestart: The installation displays the Reboot Now dialog.
Note

If the --reboot command is not present, the installation exhibits the default behavior.

--skipdesktop

Sets the installation to not add desktop icons.

--ttmdcfg=ttmd.cfg, ovr

Sets the location of the ttmd.cfg file. You must set this value equal to ttmd.cfg.

In addition, you must add the ovr argument to overwrite an existing ttmd.cfg file.

Install Location Arguments

Warning

The following arguments only apply if this is the first TT product installed on the server. Subsequent installations automatically write to an existing TT folder, even if you supply the following arguments.

--installroot=[path]

Sets the directory path for all install files and folders and suppresses the prompt for installation path during first time installations.

Note

When installing on a machine running Windows Server 2008, if you place the install root in the Program Files directory, you must select a different location for the ttconfig, ttdatfiles and ttlogfiles directories by using the installconfig, installdata and installlog arguments.

--installconfig=[path]

Suppresses the Customize Destination Folders dialog and sets the location for the hostinfo.cfg, custommultipliers.cfg, ttchron.ini and ttclean.ini configuration files.

Also, this argument sets the location of additional TT component configuration files (i.e., ttmd.cfg, DNModifications.cfg).

--installdata=[path]

Sets the location for system data files.

--installuserdata=[path]

Sets the location for user data files.

--installlog=[path]

Sets the location for log files.

--installpathlist=[pathlist]

Sets the location for all files listed above (i.e., configuration, log, user, and system data files). The value of this parameter must equal a comma separated list of installation paths that must include the installroot and must appear in the following order: installroot,installconfig,installlog,installuserdata,installdata

Any omitted values causes those files to be written to the installroot location.

Note

You can not add this argument to an installation configuration file.