Administering

See the following for information about the processes administrator use to manage the BladeLogic Dashboard:

• • Accessing the dashboard with minimum permissions
  • Changing the user, role, and password needed for access

Accessing the dashboard with minimum permissions

Some organization want to set up users who can access the dashboard but do not have permissions to perform other activities in BMC Server Automation.

1. Identify the role in BMC Server Automation that should have permissions that restrict acess to the dashboard exclusively.
   In some cases, you may want to create a role specifically for dashboard access. 

2. Use the Role Creation wizard in BMC Server Automation to create a new role or modify an existing role. On the General panel of the wizard, assign the following individual authorizations:

   Authorization	Description
   DepotFolder.*	Depot folder management
   JobFolder.*	Job folder management
   NSHScript.*	NSH Script management
   NSHScriptJob.*	NSH Script Job management
   Server.Read	Read server properties and other metadata

3. Finish creating or modifying the role.
   Any users assigned to the role you have defined can log onto BladeLogic Dashboard and view information there but are not enabled to perform other activities in BMC Server Automation.

Changing the user, role, and password needed for access

After installing the dashboard, you may want to change the user, role, and password needed for accessing the dashboard. 

1. Change the user, role, and password parameters for the NSH Script used to run the BladeLogic Dashboard job.

   1. In BMC Server Automation, access Depot > BMC Maintenance.
   2. Right-click BSA Dashboard Script and select Open.
      The script opens at right.
   3. Click the Parameters tab (at the bottom of the script). 
   4. Perform any of the following actions:

   • 
     
     • To change the user, click the BLUser row and click Update Parameter . The Edit Parameter dialog box opens. For Default Value, enter a new user name and click OK.
     • To change the role, click the BLRole row and click Update Parameter . The Edit Parameter dialog box opens. For Default Value, enter a new role and click OK.
     • To change the password, take the following actions:
       1. Open a command line.
       2. Enter blenc <password>.
          The blenc utility returns an encrypted version of the password.
       3. Copy the encrypted password.
       4. Click the BLPassword row and click Update Parameter . The Edit Parameter dialog box opens.
       5. For Default Value, enter the encrypted password you copied and click OK.
2. If you make any changes to the BSA Dashboard Script, you must also make the corresponding changes in a Tomcat properties file.
   1. Open the following file for editing:
      <Dashboard_install_location>/Tomcat/webapps/properties/localPropFile.properties
      
      <Dashboard_install_location> is the location where you unzipped the dashboard installation files, such as  /opt/bmc/BMC_Dashboard (for Linux) or Program Files\BMC Software\BMC_Dashboard (for Windows).
      
      

   2. Modify the following properties as necessary:

      To change:	Property to modify
      User	prop_local_username_key
      Role	prop_local_role_key
      Password	prop_local_password_key Warning Note You must insert an encrypted value for the password. Encrypt the password using the blenc utility, as described above in step 1.

   3. Save the localPropFile.properties file.