This documentation supports the 20.08 version of BMC Digital Workplace Basic, which is available only to BMC Helix subscribers (SaaS).
To view an earlier version, select the version from the Product Version menu.

Building and configuring an environment with BMC HR Case Management multiple tenants

This section describes how to build and configure an environment with BMC HR Case Management multiple tenants to restrict access for end users to only the services available in their catalog in BMC Digital Workplace.

This topic describes use cases and the steps to create a two-tenant environment with BMC HR Case Management. To enable more than two tenants with BMC HR Case Management, follow the instructions for how to build the secondary stack with BMC HR Case Management for the additional tenants that you need.

Before you begin

To understand the use cases and diagrams described in this section, you must understand the basic concepts of BMC HR Case Management (such as solutions, articles, cases), and the application as a whole. See Related topics for the links to BMC HR Case Management documentation.

To enable multitenancy, your existing environment must have the following system components configured for use with BMC Digital Workplace:

  • BMC HR Case Management of version 4.7.01
  • BMC Remedy IT Service Management of version 8.1.02 and later
Related topics

From the BMC HR Case Management documentation:

  • Managing solutions Open link

  • Introduction to user management in BMC HR Case Management Open link

  • Setting up appointments with end users Open link

Note: The BMC HR Case Management documentation refers to BMC Digital Workplace by its previous product name, BMC MyIT.

Use cases for enabling multitenancy in BMC HR Case Management

Use case 1: Multiple HR departments need to manage their cases and solutions separately, and end users need access to all HR services

A company has a large HR organization with multiple departments, and a large number of HR agents. Joe Unser is a manager of the Payroll department, and Bob Martin manages the Human Resources department. Sandra Jones is a director of the HR organization.

Joe wants to manage HR cases and HR solutions independently from Bob's department and from other HR departments. End users of the company need to have access to the services provided by both departments.

Sandra needs to have access to all HR solutions and articles.

You need to extend your existing environment (primary stack), so that HR agents can manage their solutions, and work on new cases independently from the other HR departments (secondary stack).

Use case 1 Common access data flow

Use case 2: Multiple HR departments need to manage their cases and solutions separately, and end users need access only to those HR services that are distributed with their department

End users running BMC Digital Workplace can be the customers of multiple departments, and they need access only to the services of the department to which they belong. You need to extend your environment (primary stack), so that end users can access HR services according to their permissions for services in the BMC HR Case Management in the secondary stack.

Data flow between the servers

Your existing environment might be one of the following stacks:

  • A single existing stack—BMC Remedy AR System Server, BMC HR Case Management, BMC Remedy IT Service Management.
    The data on the existing stack (system configuration, users, solutions, and cases) should be distributed between the primary stack and the secondary stack that you install.

    The following figure shows the primary stack of applications that your company already has, and the secondary stack, which needs to be installed. The integration between these two stacks is done on the server where BMC Digital Workplace is installed by configuring and running the tenant configuration scripts.

    Multi-tenancy configuration

  • Two existing stacks:
    • Stack 1 (Primary): BMC Remedy AR System Server, BMC HR Case Management, BMC Remedy IT Service Management
    • Stack 2 (Secondary): BMC Remedy AR System Server, BMC HR Case Management

To prepare the secondary stack with BMC HR Case Management for multitenancy

Before enabling multitenancy in an environment with BMC HR Case Management, prepare the stack with the secondary BMC HR Case Management based on your use case.

Perform the steps described in the following table to prepare your environment:

StageDescriptionUse case 1Use case 2References
1

Install a secondary tenant server with BMC HR Case Management.

Required.Required only if you do not have the necessary environment yet.

Installing BMC HR Case Management Open link

2Configure the secondary tenant server with BMC HR Case Management as required.Configure BMC HR Case Management on the secondary server to match the configuration on the primary server.Configure BMC HR Case Management on the secondary server as needed. It does not have to match the configuration on the primary server.

Configuring BMC HR Case Management Open link

3Synchronize users between BMC Remedy AR System Server in the primary stack and BMC Remedy AR System Server in the secondary stack.Synchronize only end users, and required HR Administrators and Masters between the two BMC Remedy AR System servers.Not required.

Synchronizing users between two BMC Remedy AR System Servers Open link

4Export solutions from BMC HR Case Management in the primary stack to BMC HR Case Management in the secondary stack.Export only those solutions that need to be managed in an independent tenant environment.

Required for the newly created environment.
Export only those solutions that need to be managed in an independent tenant environment.

Importing and exporting solutions from one server to another Open link

5Copy necessary cases from BMC HR Case Management in the primary stack to the BMC HR Case Management in the secondary stack.(Optional) Re-create the necessary cases manually on the secondary BMC HR Case Management if required.

(Optional) Re-create the necessary cases manually if required.

Introduction to cases in BMC HR Case Management Open link

6In the Calendar of BMC HR Case Management in stack 2, recreate all necessary appointments from BMC HR Case Management in stack 1.

(Optional) Re-create the necessary appointments and reminders on the secondary BMC HR Case Management if required.

(Optional) Re-create the necessary appointments and reminders on the secondary BMC HR Case Management if required.

Creating appointments with end users Open link

To enable multitenancy for BMC HR Case Management

After your secondary stack is installed and configured, configure the multitenancy as follows:

  1. Configure the tenant-config scripts, and run them as follows:
    1. Open the folder with the scripts:
      • For a Linux-based server with BMC Digital Workplace, navigate to the following folder location: DigitalWorkplaceHome/DWP/tenant-config/scripts/linux
      • For a Windows-based server with BMC Digital Workplace, navigate to the following folder location: DigitalWorkplaceHome\DWP\tenant-config\scripts\win
    2. Make sure that set_env script is configured:

      # MyIT server URL (required).
      # MYIT_SERVER_URL=http://myit-server.com:9000/ux
      MYIT_SERVER_URL=
      # MyIT server api token value. Could be found in ${TOMCAT_HOME}/external-conf/connect-dwp.properties (required).
      API_TOKEN=
      # MyIT server api secret value. Could be found in ${TOMCAT_HOME}/external-conf/connect-dwp.properties (required).
      API_SECRET=
      # Optional. Script will try to use java from JAVA_HOME environment variable and then (if fails) java executable from PATH.
      # JAVA_HOME=/usr/lib/jvm/jre
      JAVA_HOME=
      # Tenant identifier (required for tenant-based
      #  operations except for add_subtenant)
      # For on-premise (non-SaaS) the master-tenant is usually "1" as below
      TENANT_NAME=000000000000001
    3. Move the tenant-config.jar file to the scripts/linux or scripts\win folder, as required.
    4. Configure the add_hrcm_catalog_provider and add_hrcm_knowledge_provider scripts by setting the following properties:
      • host_name 
      • host_port 

      • system_user_password

      • instance_name

        Important

        The instance_name property must be unique for each tenant instance. It can be any descriptive name, such as hrcm-catalog-2 or hrcm-knowledge-2.

    5. Run the add_hrcm_catalog_provider and add_hrcm_knowledge_provider scripts.
    6. Run the reload_providers script.

To verify multitenancy for BMC HR Case Management

When you enable providers for the second instance of BMC HR Management, they appear in the BMC Digital WorkplaceAdmin console.

  1. Log in to the BMC Digital Workplace Admin console as an administrator.
  2. Select Configuration > Application Features.
  3. Look through the Providers list, and find all the HRCM providers.
    The service catalog pluggable provider and knowledge pluggable provider for the secondary BMC HR Case Management are enabled:

    End users have access to the services and solutions according to their permissions, defined by the multitenancy use case.
Was this page helpful? Yes No Submitting... Thank you

Comments