The administrator must define the credentials ID using the Dashboard credentials tool. To configure the Dashboard credentials identifier:

  1. Start a web browser specifying the following URL:

    http://<tomcat_host>:8080/SMViewletAuth

  2. Type a username and password that will be used in the future to access the Dashboard credential tool (for example, admin, 12345).

  3. Click Submit.

    A message indicating a successful login appears.

    Note:

    This step assigns values to two parameters that control access to the tool: configuration.admin.user and configuration.admin.password. Use this username and password whenever you need to access this tool to edit Dashboard credential IDs.

  4. Select Edit Configuration. The following text appears:

    # Automatically generated configuration file
# admin credential: DO NOT EDIT 2 fields below
configuration.admin.user=admin
configuration.admin.password=12345
#[connection_alias1]
#    com.smarts.userid=admin
#    com.smarts.password=changeit
#    smarts.remote.broker=10.239.3.92:426
#    com.smarts.autoAttachDM=INCHARGE-SAM
#    com.smarts.clientips=10.239.*;10.7.2.[1-9];10.7.2.11
## end of entry connection_alias1

    Parameters for automatic attach with viewlets explains the parameters used in this screen.

Table 1. Parameters for automatic attach with viewlets

Parameter

Description

connection_alias1

Replace this string of text with the credentials ID (for example, GUI_ID). You must replace this at both the beginning and end of the list.

com.smarts.userid

Username. This name must match a record in the serverConnect.conf file used by the Global Manager. In addition, this user must have an account with the Global Manager.

com.smarts.password

Password.

smarts.remote.broker

Location of the Broker in <host>:<port> format. For example, smarts-broker:426.

com.smarts.autoAttachDM

Name of the Global Manager, for example INCHARGE-SA.

com.smarts.clientips

Your IP for running the Dashboard applet should be inserted to the "com.smarts.clientips" list of the alias you are using for the Dashboard. For localhost, it might be 127.0.0.1. "com.smarts.clientips" controls which host can run the Dashboard without the need of knowing the connection credentials.

  1. Copy the text beginning with the line, #[connection_alias1], and paste it at the end of the file. Uncomment and edit the parameters in these lines in order to create the credentials ID for the autoAttach feature. For example:

    [GUI_ID]
    com.smarts.userid=oper
    com.smarts.password=oper
    smarts.remote.broker=qa-fancy:426
    com.smarts.autoAttachDM=INCHARGE-SA
    com.smarts.clientips=10.239.*;10.7.2.[1-9];10.7.2.11;127.0.0.1
# end of entry GUI_ID

  2. Click Save.

    The Show Configuration screen appears and the username and password are scrambled, for example:

    # start of entry GUI_ID 
[GUI_ID]
# The following fields CAN NOT be modified manually
    com.smarts.userid=5f2c442449242f41
    com.smarts.password=5f2c642e4d392041
# end of fields CAN NOT be modified manually
    smarts.remote.broker=qa-fancy:426
    com.smarts.autoAttachDM=INCHARGE-SA
    com.smarts.clientips=10.239.*;10.7.2.[1-9];10.7.2.11;127.0.0.1
# end of entry GUI_ID

  3. Click Edit to return to the Edit Configuration screen.

  4. Click Logout to exit.

    By default, the configuration file with all the obfuscated credentials is stored in the directory where tomcat was started. The default filename is viewletauth.conf. The administrator can change this behavior and specify a different location. This can be done by specifying the following property:

    <init-param>
        <param-name>com.smarts.viewletauth.conf</param-name>
  <param-value>file_path</param-value>
      </init-param>

  5. Start the viewlet. If properly configured, the viewlet should bypass the login dialog box and attach directly to the Global Manager (INCHARGE-SA). (Note, this assumes that the Global Manager is already running.) When values for one or more of the parameters in Parameters for automatic attach with viewlets are not provided, the viewlet displays the login dialog box requesting credentials.