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.

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

Comments

  1. Andreas Mitterdorfer

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

    The file ./system_notifications.json does not exist in installationLocation/sb/rxscripts. There is a ./data/users/myit_users/sys_notification.json though. Please can you review and correct?

    Apr 27, 2020 05:34
    1. Lisa Greene

      Hello Andreas,

      You are correct. The latest version of BMC Digital Workplace does not include the ./system_notifications.json file, so I removed the procedure that mentions it. Please follow the "To create a system notification user account from the command line" procedure instead.

      May 01, 2020 08:49
  2. Olga Kutetska

    Andreas Mitterdorfer , thank you fir the question,

    This feature is not supported in 9.1, but it is available in the recent versions. See Importing configuration from an identity provider and configuring SAML

    See the description of the Federation metadata URL parameter on this page.


    Apr 27, 2020 06:28
    1. Andreas Mitterdorfer

      Olga: I'm confused ? (smile)

      Apr 27, 2020 06:38
      1. Olga Kutetska

        I am sorry. I had two pages open. Did not notice that I answered to another comment. 

        Apr 27, 2020 08:18
  3. Yazeed Qudah

    I try to create a system notification user account from the command line and I got the follwing error

    ./csn.json FAILED WITH THE FOLLOWING ERROR:

    [{"messageType":"ERROR","messageNumber":304,"messageText":"Message not in catalog; Message number = 304","appendedText":""}] Successfully created 0 users, done!

    Aug 19, 2020 05:32
    1. Olha Horbachuk

      Hi Yazeed Qudah, thanks for reaching out to our team. It looks like you might be using the incorrect account or hannah_admin does not have Administrative permission. Please check whether this helps and let us know.

      Regards,

      Olha Horbachuk

      Aug 27, 2020 03:09
      1. Yazeed Qudah

        Thank you for your response, I think hannah_admin does not have Administrative permission. because when I try to creating user accounts by using Remedy Mid Tier, I log in to midtier with hannah_admin successfully and go to the following link (http://:8080/arsys/forms/<digitalworkplace_catalog-sample.com>/User) when I try to create a new user, I got the error (you don't have write permission .....)

        Aug 30, 2020 01:00
        1. Olha Horbachuk

          For more information about the Administrative permission, see User accounts, groups, and permissions for BMC Digital Workplace Catalog. Hope this helps.

          Aug 31, 2020 05:11