Performing the Single Sign-On integration with the AR System server and the BMC Remedy Mid Tier is a two-step sequence:

1. Run the SSOARIntegration utility on the computer where the AR System server is installed (this procedure).
2. Run the SSOMidtierIntegration utility on the computer where the Mid Tier is installed.

Before you begin

Make sure that Oracle JRE 1.6.0_23 or higher is installed on the AR System server.

To run the SSOARIntegration utility to integrate Single Sign-On and the AR System server

1. On the computer where the AR System server is installed, navigate to the <ARSystemServerInstall>\artools\AtriumSSOIntegrationUtility directory.
   For example, navigate to C:\Program Files\BMC Software\ARSystem\artools\AtriumSSOIntegrationUtility.
2. Open the arintegration.txt file and update the parameters for your environment.
   For example:

   
   #AR Server Name, Provide the AR server name.
   --ar-server-name=arsystemserver.bmc.com
   
   
   #AR Server User, Provide the AR server user.
   --ar-server-user=Demo
   
   #AR Server Password, Provide the AR server password.
   --ar-server-password=Demo
   
   #AR Server Port, Provide the AR server port.
   --ar-server-port=0
   
   #Atrium SSO URL, Provide the Atrium SSO URL and and make sure the server name is 
   # provided with fully qualified domain name and port is also provided in the URL.
   --atrium-sso-url=https://ssoserver.bmc.com:8443/atriumsso
   
   #Atrium SSO Admin Name
   --admin-name=amadmin
   
   #Atrium SSO Password
   --admin-pwd=ssoadminpassword
   
   #TrustStore Path, Path to the truststore directory. This is an optional parameter.
   #Remove # to uncomment and use the below property.
   #--truststore=truststorepath | Optional parameter.
   
   #TrustStore Passowrd. This is an optional parameter.
   #Remove # to uncomment and use the below property.
   #--truststore-password=truststorepassword | Optional parameter.
   		
   #force option, It accepts values as "Yes" or "No" where default is "No". 
   #If "Yes" is provided then utility will not wait for user to shutdown the webserver, 
   # if not done already in case, webserver is other then tomcat or jboss.
   #Remove # to uncomment and use the below property.
   #--force=<Yes or No>
   

   Note

   • Blank passwords are not supported. Your AR System server user must have a password before you run this utility.
   • Fully-qualified domain names for the AR System server and Atrium SSO URL parameters are required.
   • The --truststore=truststorepath and --truststore-password=truststorepassword parameters are optional when integrating Single Sign-On and the AR System server.
   • The --force=Yes or No parameter is optional. If you pass this input, you are not prompted for any manual inputs to restart the AR System server and the server is started automatically. Otherwise, you are prompted to restart the AR System server.
   • Review the optional inputs carefully for your environment.
3. Save your changes to arintegration.txt.
4. Open a command window and navigate to the <ARSystemServerInstall>\artools\AtriumSSOIntegrationUtility directory.
5. Enter the following command:

   
   java -jar SSOARIntegration.jar --inputfile arintegration.txt
   

6. When prompted by the utility, restart the AR System server.
7. Reviewing AR System server external authentication settings and configuring group mapping and restart the AR System server.

Where to go from here

• Reviewing AR System server external authentication settings and configuring group mapping
• Running the SSOMidtierIntegration utility on the Mid Tier