Customizing the TrueSight console

Use the instructions in the following sections to customize the TrueSight console.

Customizing the TrueSight console logon page

Following the installation of the Remedy RSSO authentication product and the TrueSight Presentation Server, you can access the logon page for the TrueSight console by entering its fully-qualified domain name (FQDN) in the address bar of your browser.

Although you specify the FQDN for the TrueSight Presentation Server, the logon page for Remedy Single Sign-On is displayed. To avoid confusion, BMC recommends that you customize the logon page with TrueSight, or the name of your TrueSight product.

Before you begin

You must have installed Remedy Single Sign-On and the TrueSight Presentation Server. For more information, see Installing.

To customize the logon page

Access the Remedy Single Sign-On Admin console and do the following:

Customizing the TrueSight console footer

You can enable, disable, and customize the TrueSight console footer. To enable the footer, you must have the permission to run the tssh commands.

To enable the footer

From the TrueSight Presentation Server command prompt,
- (On Windows) As an administrator, navigate to the <installationDirectory>\truesightpserver\bin folder
- (On Linux) As a non-root user, navigate to the<installationDirectory>/truesightpserver/bin folder
Run the tssh properties list command and check the list contains the property show.footer.console
Run tssh properties set show.footer.console true
Run tssh properties reload
This reloads the updated footer property.
Log in to the TrueSight console or refresh the console to view the footer.

To edit the footer content

From the TrueSight Presentation Server command prompt,
- (On Windows) As an administrator, navigate to the truesightpserver\modules\tomcat\webapps\ROOT\WEB-INF\classes folder
- (On Linux) As a non-root user, navigate to the truesightpserver/modules/tomcat/webapps/ROOT/WEB-INF/classes folder

Edit the following i18N files using a text editor based on your locale requirement:

English: en.json
German: de.json
Chinese: zh.json

Default Footer text (English)

"core.footer.line1": "This is a customizable TrueSight console footer.",
"core.footer.line2": "To customize the footer text, see the Customizing TrueSight console footer topic in the online documentation."

Notes

- Do not modify or remove the keys core.footer.line1 and core.footer.line2.

- If the text length exceeds the width of the page, the text beyond the view is hidden with an ellipsis.

- If you want to insert a \ (backward slash) or display the double-quotes in the footer, do the following:

- For inserting a \ character, you must insert the \ twice. For example, to display C:\Program Files in the footer, you must type it as C:\\Program Files. The footer text is displayed as C:\Program Files.

- For inserting the double-quotes character, you must insert a single \ character before the double-quotes. For example, to display A quick brown fox within quotes, you must type the text as \"A quick brown fox.\" The text is displayed as "A quick brown fox."

Sample updated footer in English

"core.footer.line1": "BMC Software, Inc. All rights reserved.",
"core.footer.line2": "Unauthorized use of this software is strictly prohibited."

Save the changes
Stop and start the TrueSight Presentation Server by running
tssh server stop
tssh server start
Log in to the TrueSight console or refresh the console to view the updated footer

To disable the footer

From the TrueSight Presentation Server command prompt
- (On Windows) As an administrator, navigate to the <installationDirectory>\truesightpserver\bin folder
- (On Linux) As a non-root user, navigate to the<installationDirectory>/truesightpserver/bin folder
Run tssh properties set show.footer.console false
Run tssh properties reload
This reloads the updated footer property.
Log in to the TrueSight console or refresh the console.