This documentation supports the 18.02 version of BMC Digital Workplace. To view the latest version, select the version from the Product version menu.

Loading the BMC Digital Workplace Catalog tenant setup data

Before you can use BMC Digital Workplace Catalog you must create the tenant by loading the required setup data, such as service categories, catalog profile templates, and the default service catalog administrator user.


Before you begin

  • Refer to the tenant information that you collected in the Installation worksheets for BMC Digital Workplace Catalog.
  • Ensure that the database administrator provided the credentials for the chosen database server:
  • Ensure that BMC Digital Workplace Catalog has been installed successfully and that you can see the login screen when you enter the URL in a web browser (for example: http://digitalworkplace-catalog.domain.com:8008/myitsbe ).

    Note

    If you set a custom port value for the BMC Digital Workplace Catalog application server port (<BMC_DWP_PORT>) in your installation options file, update the value in /opt/bmc/digitalworkplace/sb/env/set_script_variables.sh before you create the tenant.

To provide access to the jq command-line JSON processor

To load the tenant data, the post_install.sh script invokes the jq command-line JSON processor to create the required data records from text files. Depending on your system configuration, you might have to copy the jq application to a location where the post_install.sh can find it.

To copy the jq application to the /usr/bin folder on the BMC Digital Workplace Catalog server, next to other utility programs, you must have the permissions to create files into the /usr/bin folder. For information about granting the required permissions to install as a non-root account, see Preparing a Linux server for BMC Digital Workplace Catalog installation.

  1. From the Linux command line, issue the jq command to test that the application exists.

    If you see the following response, then the jq command line JSON processor is installed successfully. You can proceed to the step: To create a text file for the post_install.sh script values.

    Example success message
    jq - commandline JSON processor [version 1.4]
    Usage: jq [options] <jq filter> [file...]
    
    For a description of the command line options and
    how to write jq filters (and why you might want to)
    see the jq manpage, or the online documentation at
    http://stedolan.github.com/jq

    If you see the following error message, proceed to step 2.

    Example error message
    bash: jq: command not found...
  2. From the list of files you extracted from the installation archive, find the jq file. For example, if you extracted the installation archive into the folder ~/Download/install, you would issue the following commands:

    Example
    $ cd ~/Download/install
    $ ls -al install_files/jq
    
    -rw-rw-r-- 1 dwpuser dwpinstall 497799 Mar 31 18:03 install_files/jq
  3. Copy the jq file from its location inside the ./install_files folder to the /usr/bin folder.

    Example
    $ cp install_files/jq /usr/bin
  4. Change the file mode to enable all users to run the jq command.

    Example
    $ chmod +x /usr/bin/jq
  5. Check the file mode.

    Example
    $ ls -al /usr/bin/jq
    
    -rwxrwxr-x 1 dwpuser dwpinstall 497799 Aug 14 13:38 /usr/bin/jq
  6. Issue the jq command again to verify that the command-line JSON processor can run successfully.

    Example success message
    $ jq
    
    jq - commandline JSON processor [version 1.4]
    Usage: jq [options] <jq filter> [file...]
    
    For a description of the command line options and
    how to write jq filters (and why you might want to)
    see the jq manpage, or the online documentation at
    http://stedolan.github.com/jq

To create a text file for the post_install.sh script values

When you run the post_install.sh script to create the tenant, you are asked to provide values for specific parameters that are used to prepare the tenant database. When you run the command, you must provide the values for each prompt. Some of the prompts expect different values based on the database server type, as shown in the following table.

ItemPromptDatabase server typeExpected response
1Enter the BMC Digital Workplace Catalog administrator login nameBoth

BMC Digital Workplace Catalog system administrator credentials

Example: dwpadmin

2Password for specified user nameBothExample: dwppassword
3Enter one of the following - (SQL Server) Tenant database name; (Oracle) Tenant database administrator user nameSQL Server

Tenant database name

Example: dwp_db_tenant

Oracle

Tenant database administrator user name

Example: dwp_admin_tenant

4Enter a domain name to identify this tenantBoth

Tenant domain name

Example: calbroservices.com

5Enter the server's virtual host name specified during the installationBoth

BMC Digital Workplace Catalog server instance name

Example: dwp-catalog-server

6Enter the tenant database user nameSQL Server

Application database administrator user name

Example: dwp_admin_app

Oracle

Tenant database administrator user name

Example: dwp_admin_tenant

 7Password for specified user nameBoth

Database user password

Example: 4McGXk%UXfz^sLVD


To reduce the risk of error when answering the prompts, such as complex account names or passwords, you can create a text file and direct the post_install.sh script to read the values from the text file.

  1. Copy the text from one of the following simplified prompt templates into a text editor.

    Note

    In the following examples, observe that prompts 3, 6, and 7 differ based on your selected database server type (SQL Server or Oracle).

    Simplified prompt template (SQL Server)
    1. Admin login:
    2. Admin password:
    3. Tenant database NAME:
    4. Domain name:
    5. Virtual host name:
    6. SYSTEM database user:
    7. SYSTEM database Password:
    Simplified prompt template (Oracle)
    1. Admin login:
    2. Admin password:
    3. Tenant database USER:
    4. Domain name:
    5. Virtual host name:
    6. TENANT database user:
    7. TENANT database password:
  2. Complete the template by inserting values that match your environment.

    Note

    When you create a tenant, you can specify any unique value for the virtual host name parameter, <BMC_DWP_SERVER_HOST_NAME>. The host name value must exist in the /etc/hosts file.
    Simplified prompt template with values (SQL Server)
    1. Admin login: dwpadmin
    2. Admin password: dwppassword
    3. Tenant database NAME: dwp_db_tenant
    4. Domain name: calbroservices.com
    5. Virtual host name: dwp-catalog-server
    6. SYSTEM database user: dwp_admin_app
    7. SYSTEM database Password: dwp_password_app
    Simplified prompt template with values (Oracle)
    1. Admin login: dwpadmin
    2. Admin password: dwppassword
    3. Tenant database USER: dwp_admin_tenant
    4. Domain name: calbroservices.com
    5. Virtual host name: dwp-catalog-server
    6. TENANT database user: dwp_admin_tenant
    7. TENANT database password: dwp_password_tenant
  3. Delete the prompts and save the file with only your values.

    Simplified prompt template without prompts (SQL Server)
    dwpadmin
    dwppassword
    dwp_db_tenant
    calbroservices.com
    dwp-catalog-server
    dwp_admin_app
    dwp_password_app
    Simplified prompt template without prompts (Oracle)
    dwpadmin
    dwppassword
    dwp_admin_tenant
    calbroservices.com
    dwp-catalog-server
    dwp_admin_tenant
    dwp_password_tenant
  4. Copy this file to the application server where the post_install.sh script will be able to read it. For example, if your BMC Digital Workplace Catalog installation folder is /opt/bmc/digitalworkplace and you saved the command template values as  calbroservices.txt , upload the file to the server and move it to the /opt/bmc/digitalworkplace/sb folder to be next to the post_install.sh script.

To load the initial tenant data

Perform the following steps in a terminal window while logged in to the BMC Digital Workplace Catalog application server.  These examples refer to the BMC Digital Workplace Catalog installation folder as /opt/bmc/digitalworkplace.

Tip

To watch the tenant creation process after you run the post_install.sh script, open a second terminal window and log in to the same server. Then, enter the following command to watch the logs. (If you did not install BMC Digital Workplace Catalog in the default location, replace /opt/bmc/digitalworkplace with the location of your installation.)

tail -f /opt/bmc/digitalworkplace/db/post_install.log

For more information about this log file, see the Troubleshooting the tenant creation section .

  1. On the application server, navigate to the /opt/bmc/digitalworkplace/sb folder.

    Example
    cd /opt/bmc/digitalworkplace/sb
  2. Run the post_install.sh script in create schema mode, and load the file that contains the tenant values (for example, calbroservices.txt). If you did not create a text file with the tenant creation values, remove < calbroservices.txt from the command and follow the prompts.

    Example
    ./post_install.sh create_schema < calbroservices.txt
    
  3. Wait for the script to complete and return you to the terminal prompt.

  4. Run the post_install.sh script in create tenant mode, and load the file that contains the tenant values (for example, calbroservices.txt). If you did not create a text file with the tenant creation values, remove < calbroservices.txt from the command and follow the prompts.

    Example
    ./post_install.sh create_tenant < calbroservices.txt
    
  5. Wait for the script to complete.

    The post_install.sh script restarts the BMC Digital Workplace Catalog server in the background before you will see the terminal prompt.

To test the tenant catalog administrator login

After you have installed the BMC Digital Workplace Catalog and created the tenant by loading the initial tenant data, test the success of the operation by logging in to the application. The post_install.sh script creates an account for the first service catalog administrator user with the following credentials.

ParameterExampleNotes
Emailhannah_admin@calbroservices.comReplace calbroservices.com with your tenant domain.
PasswordPassw0rd!After you test the default login credentials and apply the license to the server, create user accounts specific to your organization, and then disable the default user account.
For more information about creating and managing users, see Overview of user accounts and groups for BMC Digital Workplace Catalog.

  1. Edit the placeholders in the following URL to match your server environment, and open the URL in a web browser to go to the BMC Digital Workplace Catalog login page.

    Example URL
    http://digitalworkplace-catalog.example.com:8008/myitsbe

    Note

    Port 8008 is the default port number that the Jetty web server uses. If you changed the Jetty configuration to use a different port number, or if you enabled access without a port number, modify the port number value in the URL accordingly.


  2. Log on with the tenant administrator account credentials, such as hannah_admin@calbroservices.com.

    If the application opens to the catalog administration dashboard, then your installation was a success!

Troubleshooting the tenant creation process 

If you experience any issues while loading the tenant data to create the tenant, refer to the following log files. If you installed BMC Digital Workplace Catalog into a custom folder, then replace all occurrences of the /opt/bmc/digitalworkplace path name with your installation folder.

  • /opt/bmc/digitalworkplace/db/post_install.log
  • /opt/bmc/digitalworkplace/sb/log/post_install_restart.txt

For more information about reviewing the log files for messages that can assist your troubleshooting, see Troubleshooting with log files.

Where to go from here

Setting up a Remedy Mid Tier for system administration of the BMC Digital Workplace Catalog server

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

Comments

  1. Ariel Manka

    Naming in the examples given for the options file is confusing in points 4 and 5. Description indicates that domain and host name should be entered but the example is showing something resemblign fully qualified domain name or host depends which part of the document you look at.

    In the example provided values for both parameters are identical: 4. Domain name: calbroservices.com 5. Virtual host name: calbroservices.com

    Domain and host name (or fqdn) can't be the same.

    Aug 02, 2018 08:08
    1. Olga Kutetska

      Hello!

      Thank you very much for leaving the detailed feedback. I will consult with the installation team, and make the necessary changes to make the document clear. 

      Aug 06, 2018 04:57
    1. Ravee Panjwani

      Thanks for your comment, Ariel.

      While the same name can be used for the Domain name and Virtual host name, the virtual host name will map to the server name provided during installation. I am updating the content to simplify the example and provide only 'dwp-catalog-server' as an example for the Virtual host name.

      Thanks,
      Ravee

      Aug 13, 2018 04:19