Running the Maintenance Tool utility

To run the Presentation Server maintenance tool

The Presentation Server Maintenance Tool utility is included with the Presentation Server installation, and is made up of tabbed pages that provide options for administering the Presentation Server. You can use this utility to:

• View installation and configuration log files
• Set an encrypted password

The following topics describe how to start the utility and use the options available on each tabbed page:

• To run the Presentation Server maintenance tool
• Running the Maintenance Tool
• Logs tab
• Encrypt tab

Running the Maintenance Tool

You can run the Presentation Server Maintenance tool in a graphical user interface or from the command line.

To open the Maintenance tool in a graphical user interface

• (Microsoft Windows): Navigate to the installationDirectory\TrueSightPServer\truesightpserver  folder, and run the  TrueSightPServerMaintenanceTool.cmd file.
• (UNIX): Navigate to the installationDirectory/TrueSightPServer/truesightpserver  folder, and run the  TrueSightPServerMaintenanceTool.sh file.

To open the Maintenance tool from the command line

• (Microsoft Windows): Navigate to the installationDirectory\TrueSightPServer\truesightpserver  folder, and run  TrueSightPServerMaintenanceTool.cmd with the -silent option.

• (UNIX) Navigate to the installationDirectory/TrueSightPServer/truesightpserver  folder, and run  TrueSightPServerMaintenanceTool.sh with the -silent option.

Logs tab

You can use the Presentation Server Maintenance Tool Logs tab to view installation and uninstallation log files, locate and view other log files, and zip log files to send to BMC Customer Support. 

Each time that you run the installer or uninstaller, it creates a log file that you can view from a log viewer, which you launch from the Maintenance Tool.

The log viewer is the graphical presentation of the log files. Each installer log session is displayed as a tab. The tab's name includes a timestamp of the installer run. The tab displays the contents of the log file, with errors highlighted in red andwarnings highlighted in yellow. Entries are presented in a table format that you can sort.

Perform the following procedure to view and zip log files:

1. Start Presentation Server Maintenance Tool.
   The application opens by default on the Logs tab. 

2. Click Install Log to view the installation log file.

   You can perform the following actions for the log file:

   • Click one of the date tabs over the table to see events for the specified date.
   • Click a column heading to sort the table according to that parameter.
   • Select an item in the table to see details relative to the item appear in the area below the table.
   • Use the  and  buttons to search for or filter details.
   • Save the file with another name and type using the option from the File menu. 
3. Click Uninstall Log or Configuration Log to view those files.
4. Click Browse to Log to locate and view additional log files.
5. Click Zip Logs to package the Presentation Server log files for email or transfer to a technical support person. The resulting archive includes the Viewer logs, as well as the Presentation Server log files. After the process is complete, the location of the zipped files is displayed. It is stored in the (Windows) %TEMP% or (Linux) /var/tmp or /tmp directories.
6. Click Zip All Logs, to package log files for all BMC Software products installed on the computer, for email or transfer to a technical support person. After the process is complete, the location of the zipped files is displayed. By default the file is called is AllLogs-<computerName>.zip and is stored in the (Windows) %TEMP% or (Linux) /var/tmp or /tmp directories.

Generating the options file to be used for another installation

Perform the following procedure to generate the options file from the first installation logs. This options file can be used for another regular or silent installation.

1. Start Presentation Server Maintenance Tool. The application opens by default on the Logs tab. 
2. Click Install Log to view the installation log file.
3. Select File > Save As to open the Save As window. 
4. Select Project Options File from Save As Type.
5. Enter the path where you want to save the options file in File Name.
6. Click OK to generate the options file at the given path. 

Encrypt tab

You can use the Presentation Server Maintenance Tool Encrypt tab to create an encrypted password for Presentation Server silent installations. 

Perform the following steps to create an encrypted password using the Encrypt tab:

1. Start Presentation Server Maintenance Tool.
2. Click the Encrypt tab.
3. Type the desired password in the Password box.
4. Type it again in the Confirm Password box.
5. Click Encrypt.
   The encrypted password is displayed in the Encrypted Password box.
6. Copy and paste the encrypted password in the Options.txt file.