Running a target custom installation on a Windows® system

trc_target_setup.exe /s /v"/qn [INSTALLPARAMETER1][INSTALLPARAMETER2]...[INSTALLPARAMETERX]"

/s

Denotes a silent installation.

/v"

The string that is attached to /v contains the parameters for msiexec.exe, which is a piece of software that runs the installation.

/qn

Run a silent and unattended installation with no progress window and no UI.

You can also replace /qn with the following parameters.

/qb

For an unattended installation with a basic UI and a small progress bar.

/qr

For an unattended installation with a reduced UI progress bar in a large window.

/qf

For an attended installation with full UI.

TRC_SERVER_HOSTNAME

The host name or IP address of the server. This property is required. Default value is <blank>.

For example, TRC_SERVER_HOSTNAME=trc.myserver.com.

TRC_SERVER_CONTEXT

This parameter value must match the last part of the path in the server URL. Default value is trc.

For example, TRC_SERVER_CONTEXT=trc.

TRC_SERVER_PORT

If the server runs on a non-standard port, specify the port number. Default value is 80.

For example, TRC_SERVER_PORT=8080.

TRC_SERVER_PROTOCOL

Choose between plain HTTP and secure HTTPS protocols. Valid values are http and https. Default value is http.

For example, TRC_SERVER_PROTOCOL=http.

TRC_PROXY_HOSTNAME

Host name or IP address for the proxy server, if you are using one. Default value is <blank>.

For example, TRC_PROXY_HOSTNAME=proxy.company.com.

TRC_PROXY_PORT

Port number for the proxy server. Default value is <blank>.

For example, TRC_PROXY_PORT=8080.

TRC_PROXY_USER_ID

The user ID, if the proxy requires authentication. Default value is <blank>. The user ID and password are automatically encrypted when the target starts, unless DISABLEAUTOMATICPASSPHRASEENCRYPTION is set to Yes. For more information about automatic passphrase encryption, see the BigFix® Remote Control Administrator's Guide.

For example, TRC_PROXY_USER_ID=proxyuser.

TRC_PROXY_PASSWORD

The password, if the proxy requires authentication. Default value is <blank>. The user ID and password are automatically encrypted when the target starts, unless DISABLEAUTOMATICPASSPHRASEENCRYPTION is set to Yes. For more information about automatic passphrase encryption, see the BigFix® Remote Control Administrator's Guide.

TRC_PROXY_PASSWORD=v264xmpt.

TRC_PROXY_AUTH_B64

The user ID and password, format user: password, encoded in base64. Overrides the user ID and password properties. If you do not want the password to be easily visible, use this parameter. Base64 is not encryption. Default value is <blank>.

For example, TRC_PROXY_AUTH_B64=cHJveHl1c2VyOnYyNjR4bXB0

The user ID and password are automatically encrypted when the target starts, unless DISABLEAUTOMATICPASSPHRASEENCRYPTION is set to Yes. For more information about automatic passphrase encryption, see the BigFix® Remote Control Administrator's Guide.

TRC_TARGET_PORT

To run the target on a non-standard port, specify the port number to use. Default value is 888.

For example, TRC_TARGET_PORT=888.

TRC_SERVER_HEARTBEAT_RETRY

The amount of time, in minutes, that the target waits before it resends a heartbeat to the server, when the server is not responding. Default value is 10.

For example, TRC_SERVER_HEARTBEAT_RETRY=1.

TRC_ACCESSIBILITY

Enables the accessible UI. Default value is No. Available on Windows® operating system.

GROUP_LABEL

The name of the group that the target is to be assigned to. To enable this feature, edit the trc.properties file and set allow.target.group.override = true. For more information about editing the properties files, see the BigFix® Remote Control Administrator's Guide. Default value is DefaultTargetGroup.

Note:

1. The GROUP_LABEL parameter is discarded if the target is already registered in the Remote Control server.
2. The target group that is specified must already be defined on the server.

For example, GROUP_LABEL=NewTargetGroup.

INSTALLDIR

Use this parameter to specify the directory for installing the target software to.

For example, INSTALLDIR= c:\trc\target.

ALLOWP2P

Use this parameter to enable peer to peer connections regardless of the server status. Default value is No.

ALLOWP2PFAILOVER

Use this parameter to enable failover to peer-to-peer mode when the server is down or unreachable. Default value is No.

AUDITTOSYSTEM

Use this parameter to log peer to peer session events in the targets application event log for auditing purposes. Default value is No.

AUTOSAVECHAT

Use this parameter to save the contents of the chat window to a file on the target. Default value is No.

AUTOWINLOGON

Determines whether a session can be started when no users are logged on at the target. Default value is Yes.

CHECKUSERGROUP

The controller user must be a member of the listed groups. Default value is BUILTIN\Administrators on Windows® systems and wheel on Linux® systems.

CHECKUSERLOGIN

Determines whether the login window is displayed when the controller user selects a session type in the Open Connection window. Default value is Yes.

CONFIRMFILETRANSFER

Determines whether the user acceptance window is displayed before the controller user transfer files from the target to the controller in a peer to peer session. Default value is Yes.

CONFIRMMODECHANGE

Determines whether the user acceptance window is displayed when the controller user selects a different session mode during the remote control session. Default value is Yes.

CONFIRMSYSINFO

Determines whether the user acceptance window is displayed when the controller user requests to view the target system information. Default value is Yes.

CONFIRMTAKEOVER

Determines whether the user acceptance window is displayed when a peer to peer session is requested. Default value is Yes.

DISABLEAUTOMATICPASSPHRASEENCRYPTION

Determines whether the proxy authentication user ID and password are automatically encrypted when the target starts. Default value is No. For more information about automatic passphrase encryption, see the BigFix® Remote Control Administrator's Guide.

DISABLECHAT

Determines whether you can start a chat session with the target and also chat to the controller user during a peer to peer session. Default value is No.

DISABLECLIPBOARD

Determines the availability of the clipboard transfer menu during a peer to peer session. Default value is No.

DISABLEFILEPULL

Determines whether you can transfer files from the target to the controller during a peer to peer session.

DISABLEFILEPUSH

Determines whether you can transfer files from the controller to the target during a peer to peer session. Default value is No.

FIPSCOMPLIANCE

Enable the use of a FIPS certified cryptographic provider for all cryptographic functions. Default value is No.

SP800131ACOMPLIANCE

Enable the use of NIST SP800-131A compliant algorithms and key strengths for all cryptographic functions. Default value is No.

HTTPSSTRICTVALIDATION

Determines whether the target uses the system truststore to verify HTTPS connections to the server. Default value is No.

LOGLEVEL

Set the logging level. The logging level determines the types of entries and how much information is added to the target log file. Possible values 0, 1, 2, or 4. However, use LOGLEVEL=4 only by request from IBM software support. Default value is 2.

For example, LOGLEVEL=2.

LOGROTATION

Controls the period after which an older log file is overwritten. Set to Daily, Weekly, or Monthly. Default value is Weekly.

For example, LOGROTATION=Monthly.

You can also disable log rotation by using the value Disabled.

LOGROLLOVER

Controls the period after which a new log file is started. Therefore, this period must be shorter than the LOGROTATION period, not all combinations are valid. LOGROLLOVER cannot be disabled. Set to Daily or Hourly. Default value is Daily.

For example, LOGROLLOVER=Daily.

VSC

Use the parameter to install the device driver for the virtual smart card reader. Add VSC=1 to the parameter list to install the driver.

Note: The appearance of VSC in the parameter list determines whether the driver is installed, not the value of the parameter. If VSC= n is in the parameter list, the driver is installed. If VSC is not in the parameter list, the driver is not installed. VSC can have any value. However, VSC=1 is the suggested value.

For more information about installing the device driver for the virtual smart card reader during a silent installation, see Installing the virtual smart card reader driver by running a silent installation.

REGISTRATIONTOKEN

Use this parameter to provide the registration token to the target. The token is used to authenticate the target to the server when it first contacts the server. The value of the property is set to the registration token. For more information about installing the target with a secure registration token by running a silent installation, see Running a target silent installation with a secure registration token.