Installing the Presentation Server in the standalone mode silently
Where you are in the Installation process
Step | Task |
---|---|
1 | Complete the planning activities |
2 | Prepare for TrueSight Operations Management installation |
3 | Install Remedy Single Sign-On |
4 | Install TrueSight Presentation Server — Phase A (You are here) |
(Optional) Configure TrueSight Presentation Server for disaster recovery — Phase B | |
5 | Install Infrastructure Management (If licensed) |
6 | Install App Visibility Manager (If licensed) |
7 | Install Real End User Experience Monitoring Software Edition (If licensed) |
8 | Install TrueSight IT Data Analytics (If licensed) |
9 | Complete the post-installation activities |
You can install the Presentation Server using one of these settings:
- Typical: Installs the Presentation Server using the default settings.
- Custom: Allows you to customize the settings.
To perform a typical installation of the TrueSight Presentation Server in the silent mode
Log in to the host computer (as a root user if you are using Linux) on which you want to install Presentation Server, and delete all the files from the temporary directory:
- (Windows) %temp%
(Linux) /tmp
Extract the downloaded files to a temporary location outside the following location to avoid any file sharing conflicts:
(Windows) C:\Program Files
(Linux) /opt
You will need to type the database administrator password and the Remedy Single Sign-On password in an encrypted form in the server-silent-options-<operatingSystem>.txt in Step 5. You can encrypt these passwords using the TrueSightPServerMaintenanceTool through the wizard or command line interface:
Go to the extracted folder, and locate the server-silent-options-<operatingSystem>.txt file:
(Windows) <DownloadLocation>\Windows\Disk1\
(Linux) <DownloadLocation>/Linux/Disk1/
Open and edit the server-silent-options-<operatingSystem>.txt file. This is a text file that defines the installation properties in the form of a prefix tag followed by a property name and value pair. You can either retain the default values or change them and save the file.
Note
Ensure that the following system requirements are met. If your target computer does not meet these requirements, you cannot proceed with the installation. However, in a test environment, you can skip the system requirements validation and run the installer by using the
-J MINIMAL=true
argument.- Total RAM (in MB): 32,000
- Available RAM (in MB): 25,000
- Total swap space / page file (in MB): 8,000
- Available swap space / page file (in MB): 8,000
By default, the TrueSight Presentation Server uses 256-bit encryption. However, AES 256-bit encryption is not allowed in some countries due to import regulations. You can change the default encryption key size when you invoke the installer.
From the command prompt, run one of the following commands to start the installation. Type the complete path to the server-silent-options-<operatingSystem>.txt file in the command. If the path includes a blank space, enclose the path within double quotes. However, installation occurs in the background.
Environment type Command Production environment with the default encryption setting - (Windows)
install.cmd -i silent -DOPTIONS_FILE="<
path_to_server-
silent-options-windows
.txt_file>" - (Linux)
./
>"install.sh
-i silent -DOPTIONS_FILE="<path_to_server-
.txt_filesilent-options-linux
Example
- (Windows - With space in the path)
install.cmd
e -i silent -DOPTIONS_FILE="C:\temp folder\Disk1\
server-silent-options-windows.txt
" - (Linux- With space in the path)
./
install.sh
-i silent -DOPTIONS_FILE="/opt/temp folder/Disk1/server-silent-options-linux.txt
"
Production environment with user-specified encryption setting - (Windows)
install.cmd
–J BMC_TS_KEY_SZ=<128/256>
-i silent -DOPTIONS_FILE="<path_to_server-
silent-options-windows
.txt_file>" - (Linux)
./
>"install.sh
–J BMC_TS_KEY_SZ=<128/256>
-i silent -DOPTIONS_FILE="<path_to_server-
.txt_filesilent-options-linux
Example
- (Windows - With space in the path)
install.cmd
-i silent -DOPTIONS_FILE="C:\temp folder\Disk1\
server-silent-options-windows.txt
" - (Linux- With space in the path)
./
install.sh
-i silent -DOPTIONS_FILE="/opt/temp folder/Disk1/server-silent-options-linux.txt
"
Test environment with the default encryption setting
- (Windows)
install.cmd
-J MINIMAL=true
-i silent -DOPTIONS_FILE=C:\Disk1\server-silent-options-windows.txt
- (Linux - as a non-root user)
Ensure that you start a new session as a non-root user to run the installation. Do not use the./
install.sh
-J MINIMAL=true -i silent -DOPTIONS_FILE=/opt/Disk1/server-silent-options-linux.txtsu
command to start a non-root session.
Example
- (Windows)
install.cmd -J MINIMAL=true
-i silent -DOPTIONS_FILE=C:\Disk1\server-silent-options-windows.txt
- (Linux - as a non-root user)
./install.sh -J MINIMAL=true -i silent -DOPTIONS_FILE=/opt/Disk1/server-silent-options-linux.txt
Test environment with user-specified encryption setting - (Windows)
install.cmd
-J MINIMAL=true–J BMC_TS_KEY_SZ=<128/256>
-i silent -DOPTIONS_FILE=C:\Disk1\server-silent-options-windows.txt
- (Linux - as a non-root user)
Ensure that you start a new session as a non-root user to run the installation. Do not use the./install.sh -J MINIMAL=true -i silent -DOPTIONS_FILE=/opt/Disk1/server-silent-options-linux.txt
su
command to start a non-root session.
Example
- (Windows)
install.cmd
-J MINIMAL=true–J BMC_TS_KEY_SZ=<128/256>
-i silent -DOPTIONS_FILE=C:\Disk1\server-silent-options-windows.txt
- (Linux - as a non-root user)
./install.sh -J MINIMAL=true -i silent -DOPTIONS_FILE=/opt/Disk1/server-silent-options-linux.txt
- (Windows)
The installation might take up to 15 minutes. After the installation is complete, the Installation Summary page is displayed. You can periodically check the installation status by checking the truesightpserver_install_log.txt file located at:
- (Windows) %temp%
(Linux) /tmp
Locate the following log message in the truesightpserver_install_log.txt file to ensure that the Presentation Server is installed successfully:
Log message:
TrueSight Presentation Server 11.3.04 install succeeded
.Verify that the following environment variable points to the Presentation Server installation path:
(Windows) %TRUESIGHTPSERVER_HOME%
(Linux) $TRUESIGHTPSERVER_HOME
Note: (Optional) After the installation is complete, you can revoke the write permission on the /opt directory.
Run the following command to verify the TrueSight Presentation Server status:
- (Windows) Navigate to the TrueSightPServer\truesightpserver\bin directory, and run
tssh server status
command. - (Linux) Navigate to the TrueSightPServer/truesightpserver/bin directory, and run
./tssh server status
command.
A list of Presentation Server processes are displayed as shown in the following example:
Process status
================================
Core Server Running (13176)
Index Server Running (11028)
Database Server Running (6052)If errors occur when you run
tssh server status
command, restart the Presentation Server by running the following command:(Windows)
tssh server start
- (Linux)
./tssh server start
- (Windows) Navigate to the TrueSightPServer\truesightpserver\bin directory, and run
(Linux only) Register the
BMCTSPSSvc.service
service by performing the following steps:Note: The systemd service
BMCTSPSSvc.service
is supported only from version 11.3.04. For more information on this service, see Starting and stopping the TrueSight Operations Management components.- As a root user, run the
tssh service register <Non-RootUserName>
. This command registers theBMCTSPSSvc.service
service under the /etc/systemd/system folder. - (SUSE Linux Enterprise Server only) Run the chkconfig --add BMCTSPSSvc.service command.
If you restart the TrueSight Presentation Server host without registering the
BMCTSPSSvc.service
service, the processes will not come up, and you will need to start the TrueSight Presentation Server manually.Verify whether the service is registered with the following steps:
- Ensure that you have read and write permissions for the installedDirectory\truesightpserver\logs\tssh.log file.
- Run the
systemctl status BMCTSPSSvc.service
To start and stop the service, run the following commands:
systemctl start BMCTSPSSvc.service
systemctl stop BMCTSPSSvc.service
- As a root user, run the
In an IPv6 environment, comment the following properties and restart the TrueSight Presentation Server:
#vm.args.system.26
in the installedDirectory\truesightpserver\conf\custom\csr.conf and installedDirectory\truesightpserver\conf\services\csr.conf files#vm.args.system.18
in the installedDirectory\truesightpserver\conf\custom\idxsrv.conf and installedDirectory\truesightpserver\conf\services\idxsrv.conf files
(Applicable only if you plan to connect to the TrueSight Presentation Server with an alias name) The TrueSight Presentation Server validates all incoming requests to prevent Cross-Site Forgery (CSRF) attacks. If you plan to connect to the TrueSight Presentation Server with an alias or a proxy name, you must configure all hosts, aliases, or proxies for CSRF validation. Unless you do this, you cannot access TrueSight Presentation Server even if the installation completed successfully.
Run the following commands to enable the CSRF filter for the alias names set:
- Navigate to the following location:
- (Windows) TrueSightPServer\truesightpserver\bin
- (Linux)TrueSightPServer/truesightpserver/bin
Run the
tssh properties set tspsProxyHosts <alias1>,<alias2>,<alias3>
command.Example
If you have set a single alias name for the TrueSight Presentation Server host:
tssh properties set tspsProxyHosts HostHouston
If you have set multiple alias names for the TrueSight Presentation Server host:
tssh properties set tspsProxyHosts HostHouston,HostLondon,HostPune
- Run the
tssh properties reload
command.
- Navigate to the following location:
Define the Presentation Server URL using this format, and launch the application in a browser:
(Windows) http(s)://<TSPS_FQDN>
- (Linux) http(s)://<TSPS_FQDN>:<tomcat_port>
- Type the default Admin credentials (User name: admin, Password: admin12345) , and click Log In.
The TrueSight console opens.
To perform a custom installation of the TrueSight Presentation Server in the silent mode
Log in to the host computer (as a root user if you are using Linux) on which you want to install Presentation Server, and delete all the files from the temporary directory:
- (Windows) %temp%
(Linux) /tmp
Extract the downloaded files to a temporary location outside the following location to avoid any file sharing conflicts:
(Windows) C:\Program Files
(Linux) /opt
You will need to type the database administrator password and the Remedy Single Sign-On password in an encrypted form in the server-silent-options-<operatingSystem>.txt in Step 5. You can encrypt these passwords using the TrueSightPServerMaintenanceTool through the wizard or command line interface:
Go to the extracted folder, and locate the server-silent-options-<operatingSystem>.txt file:
(Windows) <DownloadLocation>\Windows\Disk1\
(Linux) <DownloadLocation>/Linux/Disk1/
Open and edit the server-silent-options-<operatingSystem>.txt file. You can either retain the default values for the properties or change them, and save the file. The server-silent-options-<operatingSystem>.txt is a text file that defines the installation properties in the form of a prefix tag followed by a property name and value pair.
Note
Ensure that the following system requirements are met. If your target computer does not meet these requirements, you cannot proceed with the installation. However, in a test environment, you can skip the system requirements validation and run the installer by using the
-J MINIMAL=true
argument.- Total RAM (in MB): 32,000
- Available RAM (in MB): 25,000
- Total swap space / page file (in MB): 8,000
- Available swap space / page file (in MB): 8,000
By default, the TrueSight Infrastructure Management Server uses 256-bit encryption. However, AES 256-bit encryption is not allowed in some countries due to import regulations. You can change the default encryption key size when you invoke the installer.
From the command prompt, run one of the following commands to start the installation. Type the complete path to the server-silent-options-<operatingSystem>.txt file in the command. If the path includes a blank space, enclose the path within double quotes. However, installation occurs in the background.
Environment type Command Production environment with the default encryption setting - (Windows)
setup.exe -i silent -DOPTIONS_FILE="<
path_to_server-
silent-options-windows
.txt_file>" - (Linux)
./setup.bin -i silent -DOPTIONS_FILE="<
>"path_to_server-
.txt_filesilent-options-linux
Example
- (Windows - With space in the path)
setup.exe -i silent -DOPTIONS_FILE="C:\temp folder\Disk1\
server-silent-options-windows.txt
" - (Linux- With space in the path)
./setup.bin -i silent -DOPTIONS_FILE="/opt/temp folder/Disk1/
server-silent-options-linux.txt
"
Production environment with user-specified encryption setting - (Windows)
setup.exe
–J BMC_TS_KEY_SZ=<128/256>
-i silent -DOPTIONS_FILE="<path_to_server-
silent-options-windows
.txt_file>" - (Linux)
./setup.bin
>"–J BMC_TS_KEY_SZ=<128/256>
-i silent -DOPTIONS_FILE="<path_to_server-
.txt_filesilent-options-linux
Example
- (Windows - With space in the path)
setup.exe -i silent -DOPTIONS_FILE="C:\temp folder\Disk1\
server-silent-options-windows.txt
" - (Linux- With space in the path)
./setup.bin -i silent -DOPTIONS_FILE="/opt/temp folder/Disk1/
server-silent-options-linux.txt
"
Test environment with the default encryption setting
- (Windows)
setup.exe -J MINIMAL=true
-i silent -DOPTIONS_FILE=C:\Disk1\server-silent-options-windows.txt
- (Linux - as a non-root user)
Ensure that you start a new session as a non-root user to run the installation. Do not use the./setup.bin -J MINIMAL=true -i silent -DOPTIONS_FILE=/opt/Disk1/server-silent-options-linux.txt
su
command to start a non-root session.
Example
- (Windows)
setup.exe -J MINIMAL=true
-i silent -DOPTIONS_FILE=C:\Disk1\server-silent-options-windows.txt
- (Linux - as a non-root user)
./setup.bin -J MINIMAL=true -i silent -DOPTIONS_FILE=/opt/Disk1/server-silent-options-linux.txt
Test environment with user-specified encryption setting - (Windows)
setup.exe
-J MINIMAL=true–J BMC_TS_KEY_SZ=<128/256>
-i silent -DOPTIONS_FILE=C:\Disk1\server-silent-options-windows.txt
- (Linux - as a non-root user)
Ensure that you start a new session as a non-root user to run the installation. Do not use the./setup.bin -J MINIMAL=true -i silent -DOPTIONS_FILE=/opt/Disk1/server-silent-options-linux.txt
su
command to start a non-root session.
Example
- (Windows)
setup.exe
-J MINIMAL=true–J BMC_TS_KEY_SZ=<128/256>
-i silent -DOPTIONS_FILE=C:\Disk1\server-silent-options-windows.txt
- (Linux - as a non-root user)
./setup.bin -J MINIMAL=true -i silent -DOPTIONS_FILE=/opt/Disk1/server-silent-options-linux.txt
- (Windows)
The installation might take up to 15 minutes. After the installation is complete, the Installation Summary page is displayed. You can periodically check the installation status by checking the truesightpserver_install_log.txt file located at:
- (Windows) %temp%
(Linux) /tmp
Locate the following log message in the truesightpserver_install_log.txt file to ensure that the Presentation Server is installed successfully:
Log message:
TrueSight Presentation Server 11.3.01 install succeeded
.Verify that the following environment variable points to the Presentation Server installation path:
(Windows) %TRUESIGHTPSERVER_HOME%
(Linux) $TRUESIGHTPSERVER_HOME
Run the following command to verify the TrueSight Presentation Server status:
- (Windows) Navigate to the TrueSightPServer\truesightpserver\bin directory, and run
tssh server status
command. - (Linux) Navigate to the TrueSightPServer/truesightpserver/bin directory, and run
./tssh server status
command.
A list of Presentation Server processes are displayed as shown in the following example:
Process status
================================
Core Server Running (13176)
Index Server Running (11028)
Database Server Running (6052)If errors occur when you run
tssh server status
command, restart the Presentation Server by running the following command:(Windows)
tssh server start
- (Linux)
./tssh server start
- (Windows) Navigate to the TrueSightPServer\truesightpserver\bin directory, and run
(Linux only) Register the
BMCTSPSSvc
service by performing the following steps:- As a root user, run the
tssh service register <Non-RootUserName>
. This command registers theBMCTSPSSvc
service under the /etc/init.d folder. - (SUSE Linux Enterprise Server only) Run the chkconfig --add BMCTSPSSvc command.
If you restart the TrueSight Presentation Server host without registering the
BMCTSPSSvc
service, the processes will not come up, and you will need to start the TrueSight Presentation Server manually.Verify whether the service is registered with the following steps:
- Ensure that you have read and write permissions for the installedDirectory\truesightpserver\logs\tssh.log file.
- Run the
service BMCTSPSSvc status
command.
To start and stop the service, run the following commands:
service BMCTSPSSvc start
service BMCTSPSSvc stop
- As a root user, run the
In an IPv6 environment, comment the following properties and restart the TrueSight Presentation Server:
#vm.args.system.26
in the installedDirectory\truesightpserver\conf\custom\csr.conf and installedDirectory\truesightpserver\conf\services\csr.conf files#vm.args.system.18
in the installedDirectory\truesightpserver\conf\custom\idxsrv.conf and installedDirectory\truesightpserver\conf\services\idxsrv.conf files
(Applicable only if you plan to connect to the TrueSight Presentation Server with an alias name) The TrueSight Presentation Server validates all incoming requests to prevent Cross-Site Forgery (CSRF) attacks. If you plan to connect to the TrueSight Presentation Server with an alias or a proxy name, you must configure all hosts, aliases, or proxies for CSRF validation. Unless you do this, you cannot access TrueSight Presentation Server even if the installation completed successfully.
Run the following commands to enable the CSRF filter for the alias names set:
- Navigate to the following location:
- (Windows) TrueSightPServer\truesightpserver\bin
- (Linux)TrueSightPServer/truesightpserver/bin
Run the
tssh properties set tspsProxyHosts <alias1>,<alias2>,<alias3>
command.Example
If you have set a single alias name for the TrueSight Presentation Server host:
tssh properties set tspsProxyHosts HostHouston
If you have set multiple alias names for the TrueSight Presentation Server host:
tssh properties set tspsProxyHosts HostHouston,HostLondon,HostPune
- Run the
tssh properties reload
command.
- Navigate to the following location:
Define the Presentation Server URL using this format, and launch the application in a browser:
(Windows) http(s)://<TSPS_FQDN>
- (Linux) http(s)://<TSPS_FQDN>:<tomcat_port>
- Type the default Admin credentials (User name: admin, Password: admin12345) , and click Log In.
The TrueSight console opens.
Note
The system requirements are validated every time you restart the host computer or product services. If the system requirements are not met, the product services are not started. To force-start the product services, see Starting and stopping the TrueSight Operations Management components.
Troubleshooting installation issues
If you face issues during installation, see Troubleshooting the Presentation Server deployment.
Next step in the Installation process
Now that you have successfully installed the Presentation Server, do one of the following:
- (Optional) Configure disaster recovery. For instructions, see Configuring the Presentation Server in the standalone and disaster recovery mode.
- Install the other TrueSight components as per your license entitlements. For instructions, see Installation process.
Comments
Log in or register to comment.