Configuring the integration between BMC Remedyforce and BMC Client Management

For information about whitelisting salesforce.com network IP addresses, see https://na1.salesforce.com/_ui/training/help/pub/UserEdSolution?
id=50130000000MExc&retURL=https://na12.salesforce.com/_ui/training/help/
CombinedSearchPage?str=whitelist&ps=1&orgId=00D000000000062.

1. Click the Remedyforce Administration tab.
2. On the Home page, click the Integrations tile, and from the menu select BMC Client Management Integration Settings.
3. Click Salesforce Remote Site Settings to open the All Remote Sites page in a new tab.
4. Click New Remote Site.
5. In the Remote Site Name field, type the name of the remote site.
6. In the Remote Site URL field, type the URL of the BMC Client Management server:port.
   Ensure that you enter the same port number that you have entered in the Web Service Port field while installing the SSL certificate. For more information, see Installing an SSL certificate on the BMC Client Management server.
   
   Ensure that you include https:// at the beginning of the URL. For more information, see https://na9.salesforce.com/help/doc/user_ed.jsp?loc=help&target=configuring_remoteproxy.htm&section=Security.
7. Click Save.

Install a Secure Socket Layer (SSL) certificate on the BMC Client Management server.

Important: You must install a Secure Socket Layer (SSL) certificate for the integration to work. Installing the SSL certificate secures the transactions and encrypts the information passing between the BMC Client Management server and BMC Remedyforce.

Ensure that the BMC Client Management Web Service port is accessible over the Internet.

Note: BMC recommends that you only provide access to the Salesforce platform by whitelisting the valid Salesforce IP addresses.

1. Navigate to Setup > Create > Objects.
2. In the Label column, click Incident.
3. In the Page Layouts section, click Edit next to the page layout that you are using for the Incident object.
4. (Optional) To allow users to view the severity of the incidents created for the alerts and events generated from BMC Client Management, drag the BCM Severity field to the section.
5. Drag the Link CI and CI Actions buttons to the Incident Detail section.
6. Click Save.

Enable the REST Web API on the BMC Client Management server.

Note: You must perform this configuration only if you are integrating with BMC FootPrints Asset Core 11.7 or later and want to use the enhanced UI in BMC Remedyforce.

1.  In the BMC Client Management server, navigate to Global Settings > External Integration > Web Service Configuration.
2. Click the Enable Web Service Module on Selected Device toolbar icon.
3. In the Enable Web Service Module on Selected Device dialog box, select the BMC Client Management server with which you are configuring the integration.
4. Click OK.

1. For each operational rule status in the Map Operational Rule Status to Task Status section, click the Task Status list.
2. In the Select From Status window, select the task status that maps to the operational rule status.
3. Repeat step 1 and step 2 for each operational rule status. The following are possible statuses of an operational rule:
   • Approval Rejected: The operational rule could not be deployed because the approver rejected the approval record for the incident or service request that contained the linked task used to deploy the operational rule.
   • Execution Error: The request to deploy the operational rule could not be successfully completed.
   • Requested: The request to deploy the operational rule has been sent to the BMC Client Management server.
   • Request Error: The BMC Client Management server could not accept the request.
   • Request Pending: The request to deploy the operational rule has not been sent to the BMC Client Management server.
   • Request Successful: The request to deploy the operational rule was successfully completed.
4. Click Save.
   The status of the task is updated depending on the status of the operational rule.

1. In the BMC Client Management server, navigate to Global Settings > External Integration.
2. Click the Create BMC Remedyforce Integration toolbar icon.
3. In the Properties dialog box, click Select an existing administrator.
4. In the Assign an Administrator dialog box, select the user who is a BMC Client Management administrator.
   Ensure that the user has the appropriate permissions to perform direct actions on all devices managed from BMC Remedyforce. Also, the user password must not exceed 127 characters. If the password of the External Integration user exceeds 127 characters, change the password in BMC Client Management by navigating to Global Settings > Administrators > Properties > Authentication tab.
5. (Optional)To create an incident in BMC Remedyforce when an alert is generated in BMC Client Management, enter the appropriate information in the following fields:
   • Application Login -- Type the user name of the BMC Remedyforce staff member who creates all incidents for BMC Client Management alerts and events.
   • Application Password -- Type the password and the security token of the BMC Remedyforce staff member who creates all incidents for BMC Client Management alerts and events. In Salesforce, navigate to Setup > Reset My Security Token. Click Reset Security Token and an email message is sent to your email address stored in Salesforce. In the Password field, append the security token to the password. For example, if your password is mypassword and your security token is XXXXXXXXX, then you must enter mypasswordXXXXXXXXX in the Password field. If Reset Security Token is not visible, you need to enter the password only.
     
     Note: If you have enabled the improved Setup user interface in your Salesforce organization, navigate to My Settings > Personal > Reset My Security Token. For more information about the improved Setup user interface, see http://help.salesforce.com/apex/HTViewHelpDoc?id=admin_setup_improved.htm&language=en_US.
   • Select the event notifications you want to receive section -- Expand the subsections and select the required alerts and events. For more information, see the BMC Client Management - External Integration Guide.
6. To close the Assign an Administrator dialog box, click OK.
7. To close the Properties dialog box, click OK.

Configure the BMC Client Management server details in BMC Remedyforce.

Note: After you save the BMC Client Management server details, BMC Remedyforce creates the BCM category and its subcategories for events that are received from BMC Client Management. Some of the subcategories that are created in BMC Remedyforce are Database, Inventory, Operational Rule, and Performance.

1. Navigate to the BMC Client Management Integration Settings page.
2. Select the Enable BMC Client Management Integration check box.
   The Enable enhanced UI for BMC FootPrints 11.7 and BMC Client Management 12.0 and later check box and the Server Name, Server Port, User Name, and Password fields are enabled only after you select this check box.
   
   The Enable enhanced UI for BMC FootPrints 11.7 and BMC Client Management 12.0 and later check box is selected by default, unless you are upgrading from a previous version and enabled the integration with BMC FootPrints Asset Core 11.6 or earlier.
3. If you are configuring the integration with BMC FootPrints Asset Core 11.6, or you do not want to use the REST web API in version 11.7 or later, clear the Enable enhanced UI for BMC FootPrints 11.7 and BMC Client Management 12.0 and later check box.
   If you enable the enhanced UI (CI Actions window), selecting an action from the BCM Actions menu opens the CI Actions window in BMC Remedyforce. You can perform actions on the BMC Client Management devices from the CI Actions window, without starting the BMC Client Management console. However, the Remote Control, File System, and File Transfer actions continue to start the BMC Client Management console.
   
   Note: If you are using the Incidents tab to manage incidents and service requests, the enhanced UI is not available even if you select the Enable enhanced UI for BMC FootPrints 11.7 and BMC Client Management 12.0 and later check box.
4. In the Server Name field, type the name or IP address of the BMC Client Management server.
   You can enter a maximum of 255 characters in the Server Name field. If the server name exceeds 255 characters, enter the IP address instead.
   
   Note: If you have entered an IP address in the Server Name field, you must ensure that you also enter an IP address while creating the Salesforce Remote Site Setting.
5. In the Server Port field, type the port number of the BMC Client Management server.
   Ensure that you enter the same port number that you have entered in the Web Service Port field while installing the SSL certificate. For more information, see Installing an SSL certificate on the BMC Client Management server.
6. In the User Name field, type the user name of the BMC Client Management External Integration user (the user that you configured in step 4).
7. In the Password field, type the password of the BMC Client Management External Integration user.
8. Click Test Connection to validate the credentials that you have entered.
9. In the confirmation dialog box, click OK.
10. Click Save.
    If you have configured the integration with version 11.6 of BMC FootPrints Asset Core, or if the REST web API for version 11.7 or later is not configured, the Enable enhanced UI for BMC FootPrints 11.7 and BMC Client Management 12.0 and later check box is cleared.

1. In the BCM Processor section, type the interval at which the job should run in the Hours and Minutes fields.
2. Click Start BCM Processor.

Note: BMC recommends that you complete mapping the operational rule and task statuses before starting the processor.

Clear the settings in the BMC Client Management server to request system credentials for remote access.

Note: You must perform this configuration only if you are integrating with BMC FootPrints Asset Core 11.7 or later and want to perform direct actions on devices from the enhanced UI in BMC Remedyforce.

1. In the BMC Client Management server, navigate to Global Settings > System Variables.
2. Click the Security tab.
3. Click the Display the properties of the selected object toolbar icon.
4. In the Properties dialog box, clear the following check boxes:
   • Request System Credentials for Windows Remote Access
   • Request System Credentials for Linux Remote Access
   • Request System Credentials for Mac OS Remote Access
5. Click OK.

(Optional) Enable the Validate_BCM_Login validation rule to prevent users from editing the BMC Client Management user name stored in the BCM Login ID field of the User object.

After this rule is enabled, users can delete but not edit the user name in the BCM Login ID field. If users delete the user name, BMC Remedyforce displays the BMC Client Management Authentication dialog box when they attempt to perform an action from the BCM Actions menu or start the BMC Client Management console.

1. Navigate to Setup > Customize > Users > Validation Rules.
2. Next to the Validate_BCM_Login rule, click Edit.
3. Select the Active check box.
4. Click Save.

1. Navigate to Setup > Customize > Users > Page Layouts.
2. Next to the Remedyforce User page layout, click Edit.
3. Drag the BCM Login ID field to the BMC Remedyforce section.
4. Click Save.
5. Click Page Layout Assignment.
6. On the Page Layout Assignment page, click Edit Assignment.
7. Select the required profiles in the Profiles column.
8. From the Page Layout To Use list, select the Remedyforce User page layout.
9. Click Save.

Note: When first-time users connect to BMC Client Management from BMC Remedyforce, they must enter their BMC Client Management credentials. If the credentials are correct, BMC Remedyforce stores the user name in the BCM Login ID field of the user record. Users are not required to enter their credentials for future connection attempts. For more information, see Integrated authentication for BMC Client Management administrators.

Select the Enable logs for all actions performed on devices check box. If you do not enable the enhanced UI, logs are created only for the Remote Control and Audit Now actions. However, if you enable the enhanced UI, logs are also created for the following direct actions:

• Shut down
• Wake up
• Registry
• Process Management
• Services Each time you perform any direct action on a device, your user name, the action performed, the date/time the action was performed, and the device name are stored in the following location:
• If you perform an action from the Incidents form, the log entry is added to the Action History related list of the incident record and in the Instance Editor > Details > History tab of the CI instance.
• If you perform an action from the CMDB Manager, the log entry is added to the Instance Editor > Details > History tab of the CI instance.

Note: Logs for operational rules are generated even if you do not select this option.