Configuring the Dashboard credentials identifier

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.