Presentation Server tssh commands
The TrueSight Presentation Server tssh commands provide the TrueSight Presentation Serverusers the options to set or change advanced settings from the command line interface. The tssh commands are also used as troubleshooting aids.
To run the tssh commands, you must have the required privileges on the computer where the TrueSight Presentation Server is installed. You must run these tssh commands from the installationDirectory\truesightpserver\bin folder. On a Linux environment, only a non-root user has the privileges to run most of the tssh commands. A root user can run only the following three commands:
- tssh list
- tssh help
- tssh service (not available for a non-root user)
The following table describes the tssh commands that are available.
Perform actions on components registered with the TrueSight Presentation Server.
tssh component list | sync <component ID> (SYNC_MOMETA | SYNC_MOS | SYNC_GROUPS | SYNC_DEVICES | SYNC_CITYPES) | initialize <component DNS name>
tssh component list - Displays the component ID, component name, and connection status of components registered with the TrueSight Presentation Server.
tssh component sync 1 <option> - Synchronizes the component with component ID 1. Options are:
SYNC_MOMETA - Synchronizes the MO meta information.
SYNC_MOS - Synchronizes the MO information.
SYNC_GROUPS - Synchronizes the groups.
SYNC_DEVICES - Synchronizes the devices from the TrueSight Infrastructure Management server.
SYNC_CITYPES - Synchronizes the CI Types from the TrueSight Infrastructure Management server.
tssh component initialize xyz.bmc.com - Re-initializes the TrueSight Infrastructure Management server component to obtain the devices, instances, groups and events.
tssh component update <infrastructure management component> <property> <value>- Updates the TrueSight Infrastructure Management server component's (FQDN format) tsimEventPruneInterval property to the specified value. For information on events pruning, see
(Applicable only to TrueSight Presentation Server version 11.3.02 and later)
tssh component portcheck: Checks the port availability of a component.
For more information, see Checking a component port availability from the Presentation Server
Add or update custom components to the TrueSight Presentation Server.
Note: If you have configured the TrueSight Presentation Server for high availability, add or update components on both servers.
tssh componenttype add | update <component zip file path>
tssh componenttype add c:\compo\abc.zip - Adds a component abc whose zip file is in the specified path.
Back up the TrueSight Presentation Server database and configure backup settings.
|See Backing up the Presentation Server database.|
tssh device delete all | <device DNS name>
tssh device delete all - Deletes all stale devices from the Presentation Server.
Configure the recovery TrueSight Presentation Server in a disaster recovery environment.
Archive a snapshot of the TrueSight Presentation Serverand restore the snapshot.
|See Archiving the Presentation Server files.|
Clean up events in the TrueSight Presentation Server.
(Applicable only to TrueSight Presentation Server version 11.3.02 and later) tssh event reinitialize
Configure the TrueSight Presentation Server in High Availability (HA) mode.
Lists the tssh commands that are available.
Note: (Linux) Both the root and non-root user can run this command.
|tssh locale||Add or update, or delete a locale to the Presentation Server.|
tssh locale list | add | update <language-name> <language-code> <resourceFileName> | delete <language-name>
tssh locale list - Displays the list of current locales.
tssh locale add - Adds a new locale with the specified resource file name.
tssh locale update - Updates the specified locale if json file name has changed.
tssh locale delete - Deletes the locale.
For more information, see Creating and applying a custom language pack.
Enable debug logging for some or all loggers in the TrueSight Presentation Server.
|See Enabling logging of the Presentation Server.|
Start, stop, and view the status of the TrueSight Presentation Server processes.
tssh process start | stop | status (database | indexserver | CSR)
tssh process status database - Displays the status of the Presentation Server database.
Set, view, and reload the TrueSight Presentation Server properties.
tssh properties list: Displays the list of properties with the current values.
Syntax: tssh properties list
Example: tssh properties list
tssh properties reload: Reloads the properties. Use this command after you update the values of properties.
Syntax: tssh properties reload
Example: tssh properties reload
tssh properties set: Sets a particular tssh property.
Syntax: tssh properties set <property name> <property value> [reload]
Note: Reload is an optional parameter and enables you to immediately reload a property after its value is set.
For enabling the base user group, set these properties to true or false:
Start and stop the TrueSight Presentation Server.
List the version and status of the TrueSight Presentation Server.
Check the TrueSight Presentation Server ports for availability.
tssh server start | stop | version | status | portcheck
tssh server start - Starts all the TrueSight Presentation Server services. Note that you cannot start this service if the computer hosting the Presentation Server does not meet the system requirements.
tssh server start force - Forces all the TrueSight Presentation Server services to start irrespective of whether the computer hosting the Presentation Server meets the system requirements.
tssh server stop - Stops all the TrueSight Presentation Server services.
tssh server version - Lists the TrueSight Presentation Server version and build number.
tssh server status - Lists the status of the database, index server, and core server processes of the TrueSight Presentation Server.
tssh server portcheck - Checks the TrueSight Presentation Server ports for availability and displays the status - busy or available. For more information, see Troubleshooting startup problems due to port conflicts.
(Linux only) Register the TrueSight Presentation Server for non-root users.
Note: (Linux) Only a root user can run this command.
tssh service register <non-root User> - Registers the BMCTSPSSvc service under the /etc/init.d folder.
tssh service deregister <non-root User> - Deregisters and removes the BMCTSPSSvc service from the /etc/init.d folder.
For more information, see
Configure the TrueSight Presentation Server to run as a Network Service user.
This command is no longer supported. However, you can configure the TrueSight Infrastructure Management and TrueSight Presentation Server to run as Network Service user. For more information, see Configuring TrueSight Operations Management components to run as a Network Service user.