Space banner This documentation supports the 20.02 version of BMC Digital Workplace Advanced.To view the latest version, select the version from the Product Version menu.

Creating the system notification user account


BMC Digital Workplace requires a service level user that runs background tasks such as pushing notifications to self-service users when BMC Digital Workplace Catalog requests are being processed. You must create the user account that will perform these actions, and provide the credentials for this user when you enable the enhanced catalog.

 

Before you begin

Review the information about user accounts and permissions as shown on Setting-up-user-accounts-and-granting-access-to-BMC-Digital-Workplace-Catalog.

Review this topic thoroughly to determine whether you will be creating the default system notification user account or creating an account by providing your own information.

Best Practice
Create a unique system level account to configure the notifications for the enhanced catalog in BMC Digital Workplace.


Required information fields for the system notification user account

The following table shows an example of the fields used to create the system notification user. You should specify unique login credentials when creating the system notification user in your environment:

To create a system notification user account from the command line

  1. On the BMC Digital Workplace Catalog server, go to installationLocation/sb/rxscripts/bin/users.
  2. Open a text editor, and create a file that contains the required information for a single user as a JSON string.
    Example
    : To create an account for Custom System Notifications, compose the following text file:

    Example: System notification user
    {
     "fullName": "Custom System Notifications",
     "loginName": "csn@${rx_tenant_domain}",
     "emailAddress": "csn@${rx_tenant_domain}",
     "licenseType": "Read",
     "groups": ["sbe-myit-users"],
     "forcePasswordChangeOnLogin": "false",
     "password": "%8*6x4=t2J_nR!ZQ"
    }
  3. Save the file to the /dwpCatalogInstallDir/sb/rxscripts/bin/users folder.
    Example: csn.json
  4. Run the command source ./bin/setenv.sh to load the environment variables into the current shell context.

    Example
    source ./bin/setenv.sh
  5. Run the command ./bin/login.sh and pass the parameters to log in as the tenant administrator.

    Example
    ./bin/login.sh hannah_admin@calbroservices.com Passw0rd!
  6. Run the command ./bin/users/create.sh to load the specified JSON file to create the user account.

    Example
    ./bin/users/create.sh ./csn.json

    The system notifies you when the account is successfully created or if the process failed.

For a detailed explanation of this procedure, see Creating-user-accounts-in-a-batch-by-using-shell-scripts.

To create a custom system notification user account by using Remedy Mid Tier

After you configure a Remedy Mid Tier to access the BMC Digital Workplace Catalog server, you can create a custom system notification user account by adding the record directly into the tenant User form. To integrate a Remedy Mid Tier with BMC Helix Digital Workplace Catalog and read an example of this integration, see Setting-up-a-Remedy-Mid-Tier-for-system-administration-of-the-BMC-Digital-Workplace-Catalog-server.

  1. Edit the values in the following URL to match your server environment, and open the URL in a web browser to open Remedy Mid Tier to access the User form on the BMC Digital Workplace Catalog server.

    Example URL
    http://<server_with_midtier>:8080/arsys/forms/<digitalworkplace_catalog-sample.com>/User
  2. Log in as a service catalog administrator.
    Example:
    • User: hannah_admin@calbroservices.com
    • Password: Passw0rd!
  3. Click New request.
  4. Enter the information for the user record.
    Example: To create a self-service request user account for Custom System Notifications, complete the following fields:

  5. Click Save to create the user account.
  6. When you are finished managing user accounts, log out of Remedy Mid Tier.

 

Where to go from here

You have completed the essential tasks for installing BMC Digital Workplace Catalog. Proceed to Configuring-after-installation-of-BMC-Digital-Workplace-Catalog.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*