Appendix A: Silent Install

The iTivity Windows-based software components: console, hyperserver, and agents, are provided by iTivity as standard MSI installers. You can use the MSI command line parameters and public properties to create a customized, silent installation. With silent install, you do not need to monitor the installation process and provide input through dialog boxes. Instead, all of the input data is passed to the installer via the command line. The easiest way to take advantage of the custom, silent installation is to create a custom installer on the iTivity support web site.

The rest of this appendix describes how you can manually build installer command lines to meet the deployment needs of your organization.

You can customize the installation for the following iTivity components on Windows platforms:

  • hyperserver

  • console

  • attended agent

  • unattended agent

Command Line Options (Parameters) for msiexec

The following command line options or parameters apply to all MSI installers when invoked by "msiexec". For this reason, you can use these options with all of the iTivity installers.

/i <package.msi>

Install the MSI package.

/passive

Unattended mode. Installer only displays a progress bar.

/qn

Silent installation of the package with no user interface presented.

/qf

Provides a full user interface for the installation.

<PROPERTY>=<value>

Provides a value or setting for the indicated public PROPERTY.

Using these command line options or parameters in conjunction with the public properties for the individual installers, you can create custom, automated installations for your organization. Here are some examples of automating the iTivity software deployment using the msiexec.exe command line.

1. Install the unattended agent with only the progress bar displayed and selecting Active Directory authentication and the hyperserver.

msiexec.exe /I iTivityUnattendediAgent.msi /passive AUTHENTICATION=ntlm CGRP1NAME="AcmeSoft iServer" CGRP1NAME=iserver.acmesoft.com CGRP1PORTS=23800

2. Install the console into a custom installation directory.

msiexec.exe /I iTivityiManager.msi /passive INSTALLDIR="C:\Program Files\AcmeSoft\" AUTOISERVER="iserver.acmesoft.com:25800"

3. Install the attended agent with full user interface interaction and public certificate URL.

msiexec.exe /I iTivityAttendediAgent.msi /qf AUTHENTICATION=none PROMPTNAME=1 CONFIRMCONN=1 PUBCERTURL="http://iserver.acmesoft.com/4c6eac17.0" CGRP1NAME="AcmeSoft iServer" CGRP1NAME=iserver.acmesoft.com CGRP1PORTS=23800

Hyperserver Public MSI Properties

The following public properties are recognized by the hyperserver MSI installer from iTivity.

Note: You should specify the IAGENTPORT and IMANAGERPORT for any silent installation of the hyperserver. The PERMISSIONGROUP will default to "iTivityServerUsers" unless you specify a different value.

AUTHENTICATION=<ntlm/none>

Authentication method for access to the hyperserver.

HOSTNAME=<computer-name>

Name of the hyperserver system to display in the console.

HOSTDESC=<computer-description>

Description of the hyperserver system.

IAGENTPORT=<iagent-port>

The hyperserver port number for agent connections.

IMANAGERPORT=<imanager-port>

The hyperserver port number for console connections.

INSTALLDIR=<install-directory>

Target installation directory for the v software.

LAUNCHISERVER=<0/1>

Flag indicating whether to launch the hyperserver at the end of the installation.

PERMISSIONGROUP=<ad-ntlm-group>

AD/ntlm security group granting access permission to the hyperserver.

REGURL=<registry-file>

URL of a valid registry file to apply with hyperserver settings.

Console Public MSI Properties

The following public properties are recognized by the console MSI installer from iTivity.

Note: All of these settings have reasonable defaults. If you do not want the console to automatically connect to any specific hyperserver, then do not specify AUTOISERVER.

AUTOISERVER=<iservername:port>

Automatically connect to the hyperserver at iservername:port when the console starts.

HOSTNAME=<computer-name>

Name of the console system.

HOSTDESC=<computer-description>

Description of the console system.

INSTALLDIR=<install-directory>

Target installation directory for the console software.

PROMPTFORREASON=<0/1>

Flag indicating whether to prompt the console user for a connect reason.

REGURL=<registry-file>

URL of a valid registry file to apply with hyperserver settings.

SUPPORTDOMAIN=<support-domain-list>

Support domain(s), if any, where the console user is authorized for access. Separate multiple entries with a comma.

VERIFYCERTS=<0/1>

Flag indicating whether the console should verify encryption certificates.

Unattended Public MSI Properties

The following public properties are recognized by the unattended agent MSI installer from iTivity.

Note: You should specify a hostname and port number for connection group one. Connection groups two and three are optional and should only be used for access from different hyperservers. Please note that the connection group one settings override the legacy hyperserver and PORT settings.

AUTHENTICATION=<ntlm/none>

Authentication method for access to the unattended agent. This authentication stage is applied in addition to the authentication configured at the hyperserver. In some environments, it may make sense to disable the agent stage authentication ("none")and rely on the hyperserver authentication.

CGRP1NAME=<group-one-name>

Display name for connection group one.

CGRP1HOSTS=<group-one-hosts>

One or more hyperserver hostnames (or IPs) for connection group one (comma separated)..

CGRP1PORTS=<group-one-ports>

One or more hyperserver port numbers for connection group one (comma separated).

CGRP2NAME=<group-two-name>

Display name for connection group two.

CGRP2HOSTS=<group-two-hosts>

One or more hyperserver hostnames (or IPs) for connection group two (comma separated)..

CGRP2PORTS=<group-two-ports>

One or more hyperserver port numbers for connection group two (comma separated).

CGRP3NAME=<group-three-name>

Display name for connection group three.

CGRP3HOSTS=<group-three-hosts>

One or more hyperserver hostnames (or IPs) for connection group three (comma separated)..

CGRP3PORTS=<group-three-ports>

One or more hyperserver port numbers for connection group three (comma separated).

HOSTNAME=<computer-name>

Name of the agent system to display in the console.

HOSTDESC=<computer-description>

Description of the agent system.

ICONURL=<icon-file>

URL of a valid icon file (*.ico).

ISERVER=<iserver-hostname>

The hostname or IP address for the hyperserver.

INSTALLDIR=<install-directory>

Target installation directory for the unattended agent software.

PERMISSIONGROUP=<ad-ntlm-group>

AD/ntlm security group granting access permission to the agent.

PORT=<iserver-port>

The hyperserver port number for agent connections.

PUBCERTURL=<public-certificate>

URL of the hyperserver public key certificate, renamed to the fingerprint hash value (1234abcd.0).

REGURL=<registry-file>

URL of a valid registry file to apply with agent settings.

SUPPORTDOMAIN=<support-domain-list>

Support domain(s), if any, where the agent system should be visible and accessible. Separate multiple entries with a comma.

VERIFYCERTS=<0/1>

Flag indicating whether the agent should verify encryption certificates.

Attended Agent Public MSI Properties

The following public properties are recognized by the attended agent MSI installer from iTivity.

Note: You should specify a hostname and port number for connection group one. Connection groups two and three are optional and should only be used for access from different hyperservers. Please note that the connection group one settings override the legacy hyperserver and PORT settings.

AUTHENTICATION=<ntlm/none>

Authentication method for access to the attended agent. This authentication stage is applied in addition to the authentication configured at the hyperserver. In some environments, it may make sense to disable the agent stage authentication ("none")and rely on the hyperserver authentication.

CGRP1NAME=<group-one-name>

Display name for connection group one.

CGRP1HOSTS=<group-one-hosts>

One or more hyperserver hostnames (or IPs) for connection group one (comma separated)..

CGRP1PORTS=<group-one-ports>

One or more hyperserver port numbers for connection group one (comma separated).

CGRP2NAME=<group-two-name>

Display name for connection group two.

CGRP2HOSTS=<group-two-hosts>

One or more hyperserver hostnames (or IPs) for connection group two (comma separated)..

CGRP2PORTS=<group-two-ports>

One or more hyperserver port numbers for connection group two (comma separated).

CGRP3NAME=<group-three-name>

Display name for connection group three.

CGRP3HOSTS=<group-three-hosts>

One or more hyperserver hostnames (or IPs) for connection group three (comma separated)..

CGRP3PORTS=<group-three-ports>

One or more hyperserver port numbers for connection group three (comma separated).

HOSTNAME=<computer-name>

Name of the agent system to display in the console.

HOSTDESC=<computer-description>

Description of the agent system.

ICONURL=<icon-file>

URL of a valid icon file (*.ico).

ISERVER=<iserver-hostname>

The hostname or IP address for the hyperserver.

INSTALLDIR=<install-directory>

Target installation directory for the attended agent software.

PERMISSIONGROUP=<ad-ntlm-group>

AD/ntlm security group granting access permission to the agent.

PORT=<iserver-port>

The hyperserver port number for agent connections.

PUBCERTURL=<public-certificate>

URL of the hyperserver public key certificate, renamed to the fingerprint hash value (1234abcd.0).

REGURL=<registry-file>

URL of a valid registry file to apply with agent settings.

SUPPORTDOMAIN=<support-domain-list>

Support domain(s), if any, where the agent system should be visible and accessible. Separate multiple entries with a comma.

VERIFYCERTS=<0/1>

Flag indicating whether the agent should verify encryption certificates.

iTivity Product Support

Product support is available from iTivity by web site or email:

Copyright © 2004 - 2019, iTivity Corporation Copyright and License Information