This documentation supports the 19.05 version of BMC Digital Workplace Advanced.

To view an earlier 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.

Field nameKey nameExamples
Full NamefullNameSystem Notification Account
Login NameloginNamesys_notification@calbroservices.com
Email AddressemailAddresssys_notification@calbroservices.com
License TypelicenseTypeRead
Group Listgroups

sbe-myit-users

Warning: Do not add the Administrator group to any users of the sbe-myit-users group.

Passwordpassword5Y5_n0tification!
Status(Not used in scripts)Current
(Not on user form)forcePasswordChangeOnLoginfalse

To create the default system notification user account from the command line

You can create the default system notification user account by loading the information in the system_notifications.json file that is saved in a subfolder of the BMC Digital Workplace Catalog installation folder (/opt/bmc/digitalworkplace by default).

  1. On the BMC Digital Workplace Catalog server, go to installationLocation/sb/rxscripts.

  2. Run the command source ./bin/setenv.sh to load the environment variables into the current shell context.

    Example
    source ./bin/setenv.sh
  3. 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!
    • A successful login displays a login token composed of a long string of characters.
    • An unsuccessful login displays a JSON error message.

  4. Run the command ./bin/users/create.sh to load the specified JSON file to create the system notification user account.

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

To create a custom system notification user account from the command line

You can create a custom system notification user account by saving a text file on the server that contains the information for your custom account.

  1. On the BMC Digital Workplace Catalog server, go to installationLocation/sb/rxscripts.
  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.
    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.

  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:

    Field nameExample
    Full NameCustom System Notifications
    Login Namecsn
    Email Addresscsn@calbroservices.com
    License TypeRead
    Group Listsbe-myit-users
    Password%8*6x4=t2J_nR!ZQ
    StatusCurrent

  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.

Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Jan Sierens

    I don't find the file "system_notifications.json". Is it /opt/bmc/digitalworkplace/sb/rxscripts/data/users/myit_users/sys_notification.json ?

    Feb 04, 2019 07:21