Preparation
Before you begin:
Ensure that you install the Remedy AR API DLLs.
Confirm the port number you will require for the target address.
If you are connecting to the Remedy Action Request Server though a load balancer, set the ARTCPPORT Windows system environment variable.
Configure a target system administrator.
Create at least one template account, to support Bravura Identity account creation operations.
If you plan to target different major versions of the Remedy Action Request System on the same Bravura Security Fabric instance, at least one of the targets should use a proxy.
Install Remedy AR API DLLs
Remedy connectors (agtrem
, agtrem-itsm
, pxrem
) require Remedy AR API DLLs version 7.5 to interface with Remedy AR System.
Go to Bravura Security portal: https://hitachi-id.com/portal/?q=node/389
Download
remedy-arapi-75.zip
.Unzip the DLLs into a folder within the system PATH (e.g. <Program Files>\Common Files\Bravura Security\). There are 8 files:
arapi75.dll
arutl75.dll
arrpc75.dll
icudt32.dll
icuinbmc32.dll
icuucbmc32.dll
msvcp71.dll
msvcr71.dll
If using the pxrem9
connector, these DLLs are not required as the BMC Remedy AR System REST API is used to interface with the Remedy AR System.
Confirming the port number
You can check which port to use for the target address from the Action Request System Administration Console:
Click System > General > Server Information.
Click the Ports and Queues tab.
The TCP port is the port you should use. If the value is zero, this indicates you are using RPC and you do not need to specify a port number in the target address.
Set the ARTCPPORT Windows system environment variable
If you are connecting to the Remedy Action Request Server through a load balancer, set the ARTCPPORT Windows system environment variable to the value of the port you will use when targeting a Remedy server. Without the ARTCPPORT variable specified, the Remedy Action Request API will call GetPort first, which is a RPC call to retreive the correct port.
Configuring a target system administrator
Bravura Security Fabric uses a designated account on the AR System to create and manage objects.
The target system administrator must be a member of the Administrator group on the AR System.
Ensure that you set and note the account’s password. You will be required to enter the login ID and password when you add the target system to Bravura Security Fabric .
Remedy administrators may be specified with blank passwords; however, this is not recommended due to the potential security risk that it poses.
Creating a template account
Following are the steps to create an account template in BMC Remedy AR System 7.5. Details may vary depending on your version of the software.
To create a template account:
Create a group with the necessary permissions.
Create a user account and assign it to the group.
Creating a group
Log into BMC Remedy User as an administrator.
Click on AR System Administration Console.
From the AR System Administration Console, click on Application to expand.
Click on Users > Groups > Roles to expand.
Click on Groups to open the window.
Right-click anywhere in the group search window, then select New Request to open the window.
Enter the Group Name, Group ID and Long Group Name. For Group Type, select Change.
Click Save.
Creating a user
Log into BMC Remedy User as an administrator.
Click on AR System Administration Console.
From the AR System Administration Console, click on Application to expand.
Click on Users > Groups > Roles to expand.
Click on Users to open the window.
Right click anywhere in the user search window, then select New Request to open the window.
Enter the Login Name and Full name. For Group List, click the arrow icon, then select the group. Set the License Type to Fixed.
Click Save.