Integrating with BMC Remedy applications
Simplified integration process available
Integrating with BMC Remedy applications has become easier. See the following knowledge article: https://bmcsites.force.com/casemgmt/sc_KnowledgeArticle?sfdcid=kA214000000glSkCAI&type=Solution
A system administrator can configure MyIT Service Broker to enable communication between fulfillment process workflows and applications built on the Remedy Action Request System (AR System) platform 8.1 SP2 and later. You can use this process to integrate with BMC applications such as BMC Remedy IT Service Management, BMC HR Case Management, and Approval Central. You can also use this process to integrate with custom Remedy applications.
Features enabled through integration
These steps are mandatory for integration with existing systems and to ensure approvals function correctly.
|BMC application||Use case|
|Approval Central||Service catalog administrators can design workflows that send requests for approval when service items are ordered in MyIT. For information on setting up a request for approval after performing the integration, see Workflow to request approval.|
|BMC Service Request Management||BMC AR System administrators can configure filters to send a response back to a waiting workflow in MyIT Service Broker. For information on setting up the approval request, after performing the integration steps, see Configuring a system to return a response.|
|BMC HR Case Management||BMC HR Case Management administrators can design the same integration experience as when integrating with BMC Service Request Management.|
Integration process overview
A system administrator must perform the following steps on each of the servers that hosts an AR System application to be configured:
- Download the Remedy ITSM integration patch installer for either Windows and Linux servers from EPD.
- Run the patch installer on the Remedy ITSM server.
- Copy library files that were extracted from the installer package into the required location on the AR System server.
- Using the BMC Remedy Mid Tier, create or update records to configure each of the AR System servers to trigger the script that sends a response back to MyIT Service Broker.
For AR System applications running in a clustered server environment, perform the installation on the primary server only. Afterwards, copy the entire remoteaction folder installed by the patch into the same location on the secondary servers. Example: Copy the folder "C:\Program Files\BMC Software\ARSystem\remoteaction" to all secondary servers in the cluster.
An experienced administrator should be able to complete the integration within 20 minutes.
You do not need to configure anything on the MyIT Service Broker server to enable integration with Remedy AR System applications. MyIT Service Broker shall use the connection details provided in the service connector configuration panel within the application.
Before you begin
Ensure the version of AR System servers to be configured is release 8.1 SP2 or later.
For more information, see System requirements.
To check the result after installing the patch, prepare Remedy Developer Studio to access the AR System servers.
Download the Remedy IT Service Management integration patch for MyIT Service Broker 3.3.00 from the BMC Electronic Product Distribution (EPD) site. The file version must match the operating system of the AR System server.
For instructions, see downloading the installation files.
The folder <installLocation>/remoteaction must not already exist on the target BMC Remedy ITSM server. If you are installing this patch on a server where the patch has already been installed, rename the existing folder before you install the patch.
For example, on a BMC Remedy ITSM system installed on a Windows server, rename the folder C:\Program Files\BMC\ARSystem\remoteaction to C:\Program Files\BMC\ARSystem\remoteactionOLD
To install the Remedy ITSM server integration patch
You must perform the installation on only one server in a cluster. Then you can copy the installation folder to the remaining servers.
Copy the operating system-specific file and extract the contents onto the Remedy ITSM server:
Operating system File name Linux myit-servicebroker-remedy-itsm-integration-patch-linux.tar.gz Windows myit-servicebroker-remedy-itsm-integration-patch-windows.zip
Run the appropriate installer for your ITSM server operation system.
Operating system File name Linux <extraction_folder>/ApprovalServiceProvider/Disk1/setup.bin Windows <extraction_folder>\Disk1\setup.exe
- After the installation is completed, open the Remedy ITSM System
<installLocation>folder and check for the creation of a
remoteactionfolder. The following shows the Windows display. However, the same files are created on Linux systems.
- Open the location of the extracted installer files.
Copy the following files from the appropriate extraction folder into the
Operating system Folder name File name Linux <extraction_folder>/ApprovalServiceProvider/Disk1/files/remoteaction
Open Remedy Developer Studio.
Log onto the Remedy ITSM server as the AR System administrator to ensure the creation of the following objects:
To configure the MyIT Service Broker callback on the Remedy ITSM server
You can use BMC Remedy Mid Tier to configure the forms that enable communication back to MyIT Service Broker.
You must have enabled the AR System Objects List on the Remedy ITSM server.
For instructions on enabling this list to be available to the Mid Tier, see Administering the MyIT Service Broker platform.
Open the AR System Objects List on the mid tier using a URL similar to the following examplwe.
bmc-itsm-sample.comwith the address of your Remedy AR System server.Example
- When prompted for credentials, log on as an administrative user with permissions to create records using the following forms:
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.
Search for the form SB:LocalApprovalConfiguration, and create the following record.
Update the settings to match your system configuration:
Enter the values apply to the local Remedy ITSM server.
Parameter Example Description Local Hostname localhost Server name of the AR System server. Localhost is fine. Does not require http/https context. Local Port 0 The port number configured. Local User Name Demo The AR System
The illustration shows Demo with an empty password. In practice the AR System
<BMC_AR_USER>account should be assigned a password.
External process full path "C:\Program Files\BMC Software\ARSystem\remoteaction\remoteaction.bat"
The default value should be provided as one of the following. Correct if necessary:
Search for the form SB:RemoteApprovalConfiguration, and create the following record.
Update the settings to match your system configuration:
Ensure that the values entered are applicable to the target MyIT Service Broker server.
Parameter Example Description Remote Hostname bmc-myitsb-sample.com Server name of the MyIT Service Broker server. Does not require http/https context. Remote Port 8008 The port number of the application, not the platform (9988). Remote User Name email@example.com The tenant admin account. SBE Login End point /api/myit-sb/users/login Endpoint for logon authentication. SBE Signal End point /api/myit-sb/processes/signal Endpoint for AR System server to contact MyIT Service Broker when process is complete.
- Remain logged into the AR System server and proceed to Flush the SB:ServiceRequestStub cache.
Flush the SB:ServiceRequestStub cache
- From the AR System Objects List, search for the form AP:Form and open it.
- Within AP:Form, search for the SB:ServiceRequestStub form.
- Go to the Advanced tab.
- Clear the value for Application Request ID and then Save the form.
- Return the field value to $SBServiceRequestID$ and then Save the form again.
To troubleshoot the integration
If you experience any problems while running workflows after configuring the servers, refer to the following options:
On the Remedy AR System server
- Open the mid tier and check the records created through the SB:ServiceRequestStub form to test the initial request, and any field updates that should be performed by filters.
Open the file system and read the following log
On the MyIT Service Broker server, log onto the command line and view the following log file:
High availability server setup
In environments where Remedy ITSM is installed in an AR System Server Group, you must first install and configure the BMC Remedy ITSM server integration patch on the AR System Admin Server. After you have completed the installation, a
remoteaction folder will be created in the AR System
This folder contains files that are required by the other servers in the group. You must copy the contents of the
<installLocation>/remoteaction folder from the AR Admin Server onto each of the remaining Server Group members.