Creating multiple Dashboard Application Services Hub users

These commands create Dashboard Application Services Hub users, and grant them access to the Dashboard Application Services Hub and Tivoli® Netcool® Performance Manager pages. You can script these commands to create multiple users.

About this task

You run the following commands on the computer where the Jazz for Service Management server is running. These commands create a Dashboard Application Services Hub user, assign the appropriate roles to the user, and grant access to Tivoli Netcool Performance Manager pages within Dashboard Application Services Hub. The Tivoli Netcool Performance Manager administrator must also be assigned the Dashboard Application Services Hub roles, iscadmins and administrator, for the appropriate permissions to modify users by using the User Preference Management page in Tivoli Netcool Performance Manager.

Procedure

Note: Run these commands in a single line.

  1. To create a Dashboard Application Services Hub user, enter the following command: 

    <DASH_location>/profile/bin/wsadmin.sh
–lang jython
–user <DASH_admin_user>
-password <DASH_admin_password>
-c “AdminTask.createUser(‘[-uid <user_name>
-password <user_password>
-confirmPassword <user_password>
-cn <user_first_name>
-sn <user_second_name>
-mail <user_email_address>]')”
    Where <DASH_location> is the directory where Dashboard Application Services Hub is installed, by default /opt/IBM/JazzSM.
  2. To assign an appropriate role to the Dashboard Application Services Hub user, allowing the user to log in and perform Tivoli Netcool Performance Manager tasks, enter the following command: 
    <DASH_location>/ui/bin/tipcli.sh
MapRolesToUser --username <DASH_admin_user>
--password <DASH_admin_password>
--userID <userUniqueId>
--rolesList <roleName>
    Where

    <userUniqueId> is the concatenation of the user name and the realm in which the user information is stored.

    <roleName> is tnpmUser or tnpmAdministrator.

    • File-based repository example: 
      <DASH_location>/ui/bin/tipcli.sh
MapRolesToUser --username <DASH_admin_user> 
--password <DASH_admin_password> 
--userID uid=<user_name>,o=defaultWIMFileBasedRealm 
--rolesList tnpmUser
    • LDAP repository example:
      <DASH_location>/ui/bin/tipcli.sh
MapRolesToUser --username <DASH_admin_user> 
--password <DASH_admin_password> 
--userID uid=<user_name>,dc=<server>,
dc=<company>,dc=com --rolesList tnpmUser
  3. For tnpmAdministrator users only. To assign the iscadmins role to the tnpmAdministrator user, enter the following command:

     
    <DASH_location>/ui/bin/tipcli.sh
MapRolesToUser --username <DASH_admin_user> 
--password <DASH_admin_password> 
--userID <userUniqueId> 
--rolesList <roleName>
    Where:


    <userUniqueId>     is the concatenation of the user name and the realm in which the user information is stored.

    <roleName> is iscadmins.

    • File-based repository example: 
      <DASH_location>/ui/bin/tipcli.sh
MapRolesToUser --username <DASH_admin_user> 
--password <DASH_admin_password> 
--userID uid=<user_name>,o=defaultWIMFileBasedRealm 
--rolesList iscadmins
    • LDAP repository example: 
      <DASH_location>/ui/bin/tipcli.sh
MapRolesToUser --username <DASH_admin_user> 
--password <DASH_admin_password> 
--userID uid=<user_name>,dc=<server>,dc=<company>,dc=com 
--rolesList iscadmins
  4. For tnpmAdministrator users only. To assign the administrator role to the tnpmAdministrator user, enter the following command:

     
    <DASH_location>/ui/bin/tipcli.sh
MapRolesToUser --username <DASH_admin_user> 
--password <DASH_admin_password> 
--userID <userUniqueId> 
--rolesList <roleName>
    Where:

    <userUniqueId> is the concatenation of the user name and the realm in which the user information is stored.

    <roleName> is administrator.

    • File-based repository example: 
      <DASH_location>/ui/bin/tipcli.sh
MapRolesToUser --username <DASH_admin_user> 
--password <DASH_admin_password> 
--userID uid=<user_name>,o=defaultWIMFileBasedRealm 
--rolesList administrator
    • LDAP repository example: 
      <DASH_location>/ui/bin/tipcli.sh
--username <DASH_admin_user> 
--password <DASH_admin_password> 
--userID uid=<user_name>,dc=<server>,dc=<company>,dc=com 
--rolesList administrator
  5. To add the Dashboard Application Services Hub user to a group, allowing the user to access Tivoli Netcool Performance Manager pages in the Dashboard Application Services Hub, enter the following command:
    • File-based repository example: 
      <DASH_location>/profile/bin/wsadmin.sh
–lang jython 
–user <DASH_admin_user> 
-password <DASH_admin_password> 
-c "AdminTask.addMemberToGroup('[-memberUniqueName uid=<user_name>,
o=defaultWIMFileBasedRealm 
-groupUniqueName cn=tnpmUsers,o=defaultWIMFileBasedRealm]')"
    • LDAP repository example: 
      <DASH_location>/profile/bin/wsadmin.sh
–lang jython –user <DASH_admin_user> 
-password <DASH_admin_password> 
-c "AdminTask.addMemberToGroup('[-memberUniqueName uid=
<user_name>,ou=People,dc=<server>,
dc=<company>,dc=com 
-groupUniqueName cn=tnpmUsers,ou=Groups,dc=<server>,
dc=<company>,dc=com]')"
  6. To save the user configuration, enter the following command: 
    <DASH_location>/profile/bin/wsadmin.sh
–lang jython
–user <DASH_admin_user> 
-password <DASH_admin_password> 
-c “AdminConfig.save()”
  7. On the command-line interface, change to the <DASH_location>/profiles/bin directory.
  8. To stop and start the Jazz for Service Management server, enter the following commands:
     
    ./startServer.sh <server_name> -username <WAS_admin_user_name> 
														 -password <WAS_admin_password>

./stopServer.sh <server_name> 	 -username <WAS_admin_user_name> 
													   -password <WAS_admin_password>

    Where:

    server_name
    Enter the name of the application server that was specified when the application server profile was created. For example, server1.
    WAS_admin_user_name
    The default user name is smadmin.
    WAS_admin_password
    This is the password that is specified at the time of installation.