This documentation supports the 22.4 version of BMC Helix Single Sign-On, which is available only to BMC Helix customers (SaaS). To view an earlier version, select the version from the Product version menu.

Integrating BMC Helix SSO with Action Request System and Mid Tier

Follow the instructions provided in this topic to integrate BMC Helix Single Sign-On with Action Request System (AR System) and Mid Tier. You can also integrate BMC Helix SSO with Developer Studio, see Enabling BMC Helix Single Sign-On for Developer Studio.

You need to integrate BMC Helix SSO server with AR System and Mid Tier if you want to have single sign-on experience for AR System and Mid Tier by using BMC Helix SSO.

Note: Mid Tier is not the same as the Mid Tier Configuration Tool.

Best practice
If you have an existing integration of BMC Helix SSO with AR System and Mid Tier, we recommend that you have the same version for the BMC Helix SSO server and BMC Helix SSO agents. You might need to upgrade integration with AR System and Mid Tier. 

You also need to reintegrate with Mid Tier after you upgrade Mid Tier to a later version.

Related topics

Removing-BMC-Helix-SSO-integration-from-Action-Request-System-and-Mid-Tier

BMC-Helix-SSO-agent

Troubleshooting-integration-issues

Troubleshooting-login-and-logout-issues

From the AR System documentation:

Enabling BMC Helix Single Sign-On for Developer Studio

Starting and logging on to Developer Studio

Before you begin

Before you integrate BMC Helix SSO with AR System, verify the following conditions are met:

  • BMC Helix SSO, AR System, and Mid Tier are installed. For more information, see Installing Remedy SSO

  • Review System-requirements and validate the integrated products are compatible with BMC Helix SSO. 
  • It is recommended that the BMC Helix SSO server has the same version as BMC Helix SSO components:
    • BMC Helix SSO server has the same version as BMC Helix SSO AREA plugin.
    • BMC Helix SSO server has the same version as the BMC Helix SSO agent. 
  • Obtain the files that you need for installation from the BMC Electronic Product Distribution (EPD) site. Upload and unzip the installation files to all servers where you will run the BMC Helix SSO installer.
  • If you plan to integrate BMC Helix SSO with AR System that is integrated with BMC Atrium Single Sign-On (Atrium SSO), you must manually remove integration between AR System and Atrium SSO, and then integrate it with BMC Helix SSO.  For information about how to do this, see Migrating from BMC Atrium Single Sign-On to Remedy SSO.

Task 1: Integrate BMC Helix SSO with the AR System server

You can integrate BMC Helix SSO with BMC applications by using one of the followings methods:

To integrate BMC Helix SSO with the AR System server by running the BMC Helix SSO installation wizard

  1. On the server where AR System is installed, unzip the BMC Helix SSO installation file to a destination directory.
  2. Depending on your operating system, select the installation program to run the installer:
    • (Windows) setup.exe.
    • (Linux) sh setup.sh.
  3. In the lower-right corner of the Welcome panel, click Next.
  4. Review the license agreement, click I agree to the terms of license agreement, and then click Next.
  5. In the BMC Helix SSO feature selection screen, select Integrate with AR System.
  6. Complete the following installation fields as described in the Integrate with AR System tab of the Installation-worksheets:
    • Path to AR System Home
    • Service BMC Helix SSO instance URL

  7. Check the installation preview and then click Install to complete the integration.

    To protect the new BMC Helix CMDB UI, you must install the agent as an OSGi bundle on each AR System server.

    After the AR System integration is completed, the installer restarts the AR System server.

    Important

    If you receive a warning message that the AR System server restart has failed, check the status of the server. If the server is not running, restart the server manually.

To integrate BMC Helix SSO with AR System by using the silent mode

  1. On the server where AR System is installed, create the options.txt file.

  2. Copy the options that you want to install, and enter the Integrate with AR System parameters into the options.txt file.

    Options for integrating the Helix SSO server with the AR System server
    -P installLocation=<path where product info will be located>
    -A productHelixSSO
    -J AR_TYPE=true
    -J AR_HOME=<path_to_AR_server_home>
    -J INT_URL=<internal_Helix_SSO_url>
  3. (Linux) Ensure that no Ctrl+M characters were inserted in the options.txt file.

  4. Run the installer with the -i silent option:

    Windows
    setup.exe -i silent -DOPTIONS_FILE=<path_to_txt_file_with_installation_options>
    Linux
     sh setup.bin -i silent -DOPTIONS_FILE=<path_to_txt_file_with_installation_options>

To integrate BMC Helix SSO with AR System manually

You can also integrate BMC Helix SSO with AR System manually. For information about how to do this, see Manually-integrating-Helix-SSO-with-BMC-applications.

Task 2: Integrate BMC Helix SSO with Mid Tier 

Important

If Mid Tier has been updated to a later version, you also need to reintegrate BMC Helix SSO with Mid Tier. The web.xml file that contains the BMC Helix SSO filter information is overwritten and the integration breaks. To restore the integration, manually remove the <HelixSSO (integration) installation> directory that contains the InstalledConfiguration.xml file and perform the following steps again.

You can install BMC Helix SSO by using one of the followings methods:

To integrate BMC Helix SSO with Mid Tier by running the BMC Helix SSO installation wizard

  1. On the server where Mid Tier is installed, unzip the BMC Helix SSO installation file to a destination directory.
  2. Depending on your operating system, select the installation program to run the installer:
    • (Windows) setup.exe.
    • (Linux) sh setup.sh.
  3. In the lower-right corner of the Welcome panel, click Next.
  4. Review the license agreement, click I agree to the terms of license agreement, and then click Next.
  5. Complete the following installation fields as described in the Integrate with Mid Tier tab of the Installation-worksheets:
    • Path to Mid Tier Home
    • Path to Mid Tier Web server
    • Public BMC Helix SSO instance URL
    • Service BMC Helix SSO instance URL
  6. Check the installation preview and then click Install to complete the integration.

To integrate BMC Helix SSO with Mid Tier by using the silent mode

  1. On the server where Mid Tier is installed, create the options.txt file.

  2. Copy the options that you want to install, and enter the Integrate with Mid Tier parameters into the options.txt file.

    Options for integrating Remedy SSO server with Remedy Mid Tier
    -P installLocation=<path where product info will be located>
    -A productHelixSSO
    -J MT_TYPE=true
    -J MT_HOME=<path_to_Mid_Tier_home>
    -J MT_PATH=<path_to_Mid_Tier_server_home>
    -J INT_URL=<internal_Helix_url>
    -J EXT_URL=<external_Helix_url>
  3. (Linux) Ensure that no Ctrl+M characters were inserted in the options.txt file.

  4. Run the installer with the -i silent option:

    Windows
    setup.exe -i silent -DOPTIONS_FILE=<path_to_txt_file_with_installation_options>
    Linux
     sh setup.bin -i silent -DOPTIONS_FILE=<path_to_txt_file_with_installation_options>

To integrate BMC Helix SSO with Mid Tier manually

You can also integrate BMC Helix SSO with Mid Tier manually. For information about how to do this, see Manually-integrating-Helix-SSO-with-BMC-applications.

Task 3: Perform post-integration configuration steps

AREA LDAP configuration and BMC Helix SSO AREA are different plugins, and when you install the BMC Helix SSO agent in the AR System server, the AREA LDAP plugin is removed from the pluginsvr_config.xml file. 

If you want to use the AREA LDAP plug-in configuration for BMC Helix SSO, perform the following steps:

  1. Implement the same configurations (Bind User, Host Name, User Base search and other settings) in BMC Helix SSO as described in Configuring the AREA LDAP plug-in.
  2. Add the AREA LDAP reference again to the pluginsvr_config.xml for all the AR System servers (if you have a server group).

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*