To install the target software on a Windows®operating system, use the trc_target_setup.exe file.
About this task
For more information about obtaining this file, see Obtain the installation files.
To install the target, complete the following steps:
Procedure
-
Create a folder in your root drive called IBMTRC.
-
Copy trc_target_setup.exe to IBMTRC.
-
Open a command prompt window and go to IBMTRC.
-
Type DIR to verify that the exe file is in this folder.
-
To install the target, type the following command in one line.
trc_target_setup.exe
/s /v"/qn [INSTALLPARAMETER1][INSTALLPARAMETER2]...[INSTALLPARAMETERX]"
Use the
following installation parameters customize your installation.
Note: Ensure that the correct values
are assigned to the parameters as no validation of the values is carried out.
- /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>.
For example,
TRC_PROXY_USER_ID=proxyuser
.
- TRC_PROXY_PASSWORD
- The password, if the proxy requires authentication. Default value is
<blank>.
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. Use this parameter if you do not want the password to be easily
visible. Base64 is not encryption. Default value is <blank>. For example,
TRC_PROXY_AUTH_B64=cHJveHl1c2VyOnYyNjR4bXB0
- 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 IBM BigFix Remote Control Administrator's
Guide. Default value is
DefaultTargetGroup.
Note:
- The GROUP_LABEL parameter is discarded if the target is already registered in the IBM BigFix Remote Control server.
- 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
is No.
- ALLOWP2PFAILOVER
- Use this parameter to enable failover to peer-to-peer mode when the server is down or
unreachable. Default is No.
- AUDITTOSYSTEM
- Use this parameter to log peer to peer session events in the targets application event log for
auditing purposes. Default is No.
- AUTOSAVECHAT
- Use this parameter to save the contents of the chat window to a file on the target. Default is
No.
- AUTOWINLOGON
- Determines whether the user acceptance window is displayed on a target where the user is not
logged on. Default is Yes.
- CHECKUSERGROUP
- The controller user must be a member of the listed groups. Default 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 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 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 is Yes.
- CONFIRMSYSINFO
- Determines whether the user acceptance window is displayed when the controller user requests to
view the target system information. Default is Yes.
- CONFIRMTAKEOVER
- Determines whether the user acceptance window is displayed when a peer to peer session is
requested. Default is Yes.
- 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 is No.
- DISABLECLIPBOARD
- Determines the availability of the clipboard transfer menu during a peer to peer session.
Default 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 is No.
- FIPSCOMPLIANCE
- Enable the use of a FIPS certified cryptographic provider for all cryptographic functions.
Default is No.
- SP800131ACOMPLIANCE
- Enable the use of NIST SP800-131A compliant algorithms and key strengths for all cryptographic
functions. Default 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. This period must be shorter than the
LOGROTATION period, therefore not all combinations are valid. LOGROLLOVER cannot be disabled. Set to
Daily or Hourly. Default value is Daily.
- For example,
LOGROLLOVER=Daily
.
Results
Note: If you want to reconfigure the parameters on an existing target installation, use the
parameter,
REINSTALL=ALL. However, the parameter is ignored if it is used when
you upgrade the target.
For example, on the command line you can type the following command:
trc_target_setup.exe /s /v"/qn REINSTALL=ALL"
To modify the target configuration and apply an upgrade, complete the following steps.
- Perform a silent installation with the new version of target software. Do not use any
parameters. If you do use parameters, the target is upgraded but the parameters are ignored and are
not updated.
- Perform a silent re installation with
REINSTALL=ALL
and any new parameters.
You can also specify the parameters that you want to override.
For example, to change the target port to 2222, type the following command
trc_target_setup.exe /s /v"/qn TRC_TARGET_PORT=2222 REINSTALL=ALL"
Note: To view Help options during the installation, type the following command on the command line.
trc_target_setup.exe --help