Adding or modifying user information in registry

After you add or delete a user in Dashboard Designer tool, you must also update the basic-registry.xml file to include or delete a username and password of that user.

Before you begin

Ensure that the user is already added or deleted in Dashboard Designer or Engine.

Procedure

Complete the following steps to add username and password to the basic-registry.xml file:

  1. Encrypt the password.
  2. As a root user, open the basic-registry.xml file from the following location:
    
    cd $install_dir/wlp/usr/servers/prdauth
    vi basic-registry.xml

    Where, install_dir is the directory where you installed the application. However, during installation, if you do not specify a different installation location, then by default the application is installed in /opt/icabi folder.

  3. Add, modify, or delete the user and password entry in basic-registry.xml file as follows:
    1. Add a username and its encrypted password entry within the <basicRegistry> element as follows:
      
      <server description="External Datasource Configuration">
      <!--
      	Configure users for application according to the following examples.
      
      	**** OnPrem Mode ****
      		<user name="xxxx" password="xxxx"/>
      	Example : 
      		<user name="smadmin" password="{aes}AD6y8I0nmEEKnH2c2BApoirqB99Ko+8ePOR2NHYboa3V" />
      
      	**** Multitenant Mode ****	
      		<user name="xxxx@xxx" password="xxxx"/>
      	Example:
      		<user name="smadmin@tenant_name" password="{aes}AD6y8I0nmEEKnH2c2BApoirqB99Ko+8ePOR2NHYboa3V"/>
      	
      	Note : User need to wrap all the users within <basicRegistery></basicRegistery> tag.
      
      -->
      	<basicRegistry id="basic" ignoreCaseForAuthentication="true" realm="admin">
               <user name="smadmin" password="{aes}ANA78js6sPRl+70O/y6YmLyW3pWmyqRZVfygbJcBQLLy" />
               <user name="scheduler" password="{aes}ANRncLTFenxjoo8o42//QiffHwUAGqLLagQqKcEOSn8/" />
               <user name="engine" password="{aes}AMJc3nGPAKfd0Oj2QQXAv5u1CblG7Q8+HiF+duibQnt5" />
      	</basicRegistry>	
      </server>
       
      Note: If the ignoreCaseForAuthentication is set to true, the case-insensitive username can be used to log in to the application.
    2. Optional: Modify an existing username or password from within the basicRegistry element in basic-registry.xml.
    3. Optional: Delete an existing username or password entry from the basicRegistry element in basic-registry.xml.
      Note: When you delete a Dashboard Designer tool or Engine user from the user interface, make sure to delete the user entry from the basic-registry.xml file also.
  4. Save the basic-registry.xml file.