Integrating BMC applications with BMC Helix Digital Workplace Catalog

Enable the Action Request System (AR System) application integration so that BMC Helix Digital Workplace Catalog workflows can communicate with BMC applications or applications developed on the BMC Helix Innovation Studio.

Functionality enabled through BMC application integration

The following table shows a few examples of the features that require this integration.

Integration process overview

The following diagram illustrates the process for integrating BMC applications with BMC Helix Digital Workplace Catalog so that end users can request services.

The catalog administrator configures a connection that uses the Helix ITSM connector to connect to the application server. If applications run on different servers, the catalog administrator must create and configure a connection for each server, and must also set the default connection for BMC Helix ITSM functionality. After completing the integration, the catalog administrator creates services that use the connection, and end users request the services.

To configure the callback to the BMC Helix Digital Workplace Catalog from the AR System server

Use the Mid Tier for the AR System server to create records to specify the BMC Helix Digital Workplace Catalog server that will receive the callbacks.

1. Open the AR System Objects List on the mid tier by using a URL similar to the following example. Replace <bmc-itsm-sample.com>  with the address of the AR System server.

   Example

   http://<bmc-itsm-sample.com>:8080/arsys/forms

2. When you are prompted, log in as an administrative user who has access permission to use the following form to create records:
   • SB:RemoteApprovalConfiguration

   Important

   Some systems require the AR System administrator to access these forms. Other systems allow an application administrator to access these forms. Contact your IT administrator if you are not sure.

3. Search for the SB:RemoteApprovalConfiguration form, and create the following record with values that match your system configuration:

https://<bmc-itsm-sample.com>/arsys/forms/<bmc-itsm-sample.com>/SB:RemoteApprovalConfiguration

Example

Values that apply to the target BMC Helix Digital Workplace Catalog server

Parameter	Example	Description
Remote Hostname	bmc-dwpcatalog-sample.com	Server name of the BMC Helix Digital Workplace Catalog server. You do not need to specify http or https. If the BMC Helix Digital Workplace Catalog server is configured with a load balancer for SSL access or high availability deployment, specify the hostname of the load balancer.
Remote Port	8008	Port number used to access the BMC Helix Digital Workplace Catalog application, not the platform (9988).
HTTPS	Disabled	Enable if the BMC Helix Digital Workplace Catalog is configured for SSL access.
Remote User Name	hannah_admin@calbroservices.com	Tenant administrator user account.
SBE Login End point	/api/myit-sb/users/login	Endpoint for authentication.
SBE Signal End point	/api/myit-sb/processes/signal	Endpoint for process completion responses.

To configure connections for ITSM functionality

A catalog administrator must configure at least one connection that uses the Helix ITSM connector. To use BMC Helix CMDB (CMDB) functionality, a catalog administrator must also configure a connection that uses the CMDB connector.  When you create the first connection for the Helix ITSM connector, the system sets this connection as the default connection for entitlements and approvals. If you are integrating with BMC Helix CMDB (CMDB), when you create the first connection for the CMDB connector, the system sets this as the default CMDB connection. For information on creating connections, see Configuring service connectors.

To set the default connections for ITSM functionality

If you have more than one connection that uses the Helix ITSM connector or more than one connection that uses the CMDB connector, a catalog administrator can set the default connection in BMC Helix Digital Workplace Catalog. 

To change the default connections from the default values set by the system:

1. Click the configuration gear () to open the Application Settings panel.
2. In the Connectors section, click the arrow (>) to open the Default Connections panel, and select the applicable connections:
   
   • Entitlement/Approval—Displays connections that use the Helix ITSM connector. Select the connection to the BMC Service Request Management server. The connection to this server is used for entitlements and approvals, and should connect to the same BMC Helix Innovation Studio that is configured in BMC Helix Digital Workplace.
   • CMDB—Displays connections that use the CMDB connector. Select the connection to Atrium CMDB. 
3. Click Save.
   

Troubleshooting the integration

Perform these tasks if you experience any problems while running workflows after you configure the integration to an AR System server.

Options to troubleshoot the AR System server integration

• To monitor a request to observe the fields that a filter action updated, log on to the mid tier to access the AR System server and search for records created through the SB:ServiceRequestStub form.
• To investigate issues with the integration, use the Support Assistant Tool to examine the following log:
  
  • /opt/bmc/ARSystem/log/remoteaction.log

For more information, see  Viewing and collecting logs by using the Support Assistant tool in the BMC Helix ITSM Deployment documentation.

• To troubleshoot issues with the approval engine, use the Support Assistant Tool to examine the approval log (which must be enabled):
  •  /opt/bmc/ARSystem/db/arapprov.log

For more information, see  Viewing and collecting logs by using the Support Assistant tool in the BMC Helix ITSM Deployment documentation.

To troubleshoot the communication from the BMC Helix Digital Workplace Catalog server

1. As an administrator in BMC Helix Innovation Studio, enable logs for the com.bmc.myservice.catalog bundle. For detailed procedure, see  Enabling and downloading logs from BMC Helix Innovation Studio .
2. Open the myit-sb.log file and review the following logs: 
   
   Run-time log example:

# tail -f /opt/bmc/digitalworkplace/db/bundle.log

Text editor log example: 

# vi /opt/bmc/digitalworkplace/db/bundle.log

Where to go from here

To configure connections to additional BMC application servers, see Configuring service connectors.

To import services from BMC Service Request Management, see Importing service catalog items from external systems.

To create services, see Adding and updating services.