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:

  1. In the left navigation panel of the Add Realm or Edit Realm page, click Branding and add branding details. For more information about the branding details, see Branding parameters.

  2. Click Preview to see the preview of the login page.

Branding parameters 

FieldDescription

Customize Login Page

Customizes the login page.

Window Title

Title for the browser window.

Product Name

Name for the product.

Company Logo

Specifies the company logo.

Click the Edit icon to specify the image that you want to use for the company logo.

Background Image

Specifies the background image.

Click the Edit icon to specify the image that you want to use as a background image.

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

  1. 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
  2. Run the tssh properties list command and check the list contains the property show.footer.console
  3. Run tssh properties set show.footer.console true
  4. Run tssh properties reload
    This reloads the updated footer property.
  5. Log in to the TrueSight console or refresh the console to view the footer.

To edit the footer content

  1. 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
  2. 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."
  3. Save the changes
  4. Stop and start the TrueSight Presentation Server by running 
    tssh server stop 
    tssh server start
  5. Log in to the TrueSight console or refresh the console to view the updated footer

To disable the footer

  1. 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
  2. Run tssh properties set show.footer.console false
  3. Run tssh properties reload
    This reloads the updated footer property.
  4. Log in to the TrueSight console or refresh the console.

Related topics

Accessing and navigating the TrueSight console

Presentation Server tssh commands


Was this page helpful? Yes No Submitting... Thank you

Comments