Troubleshooting AR System server and Mid Tier integrations

Performing the BMC Atrium Single Sign-On integration with the BMC Remedy AR System server and the BMC Remedy Mid Tier is a two-step sequence. If you have problems with BMC Atrium Single Sign-On installation and configuration, review the following information.

• • Manually running the SSOARIntegration utility on the AR System server
  • Manually running the SSOMidtierIntegration utility on the AR System server

Manually running the SSOARIntegration utility on the AR System server

The SSOARIntegration utility uses the following inputs in the arintegration.txt file to integrate BMC Atrium Single Sign-On and the AR System server:

If needed, you can manually run the SSOARIntegration utility on 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. Enter the following command:

   java -jar SSOARIntegration.jar --ar-server-name
   ARServerName --ar-server-user ARServerUser --ar-server-password ARServerPassword
   --ar-server-port ARServerPort --atrium-sso-url AtriumSSOURL --admin-name
   SSOAdminName --admin-pwd SSOAdminPassword
   

   For example:

   java -jar C:\Program Files\BMC Software\ARSystem\artools\AtriumSSOIntegrationUtility\SSOARIntegration.jar --ar-server-name
   ARServer.labs.bmc.com --ar-server-user Demo --ar-server-password Demo
   --ar-server-port 0 --atrium-sso-url https://ssoServer.bmc.com:8443/atriumsso
   --admin-name amAdmin --admin-pwd bmcAdm1n
   

   Tip

   Copy and paste this example into a text editor, and modify the values for your own environment. Then copy the final version into your command window.

3. Review the utility logs at <ARSystemServerInstall>\artools\AtriumSSOIntegrationUtility\Logs\AtriumSSOIntegrationUtility.log.
    If successful, the SSOARIntegrationutility performs the following actions on the AR System server:
   • Validates the user inputs and returns any errors.

   • Configures the SSO AREA plug-in with a Java plug-in entry in ar.cfg/ar.conf:

     Server-Plugin-Alias: AREA AREA VW-PUN-REM-QA5J.pune-labs.bmc.com:9999
     

   • Configures the EA form for BMC Atrium Single Sign-On with the following entries in the ar.cfgfile:

     Use-Password-File: T
     Crossref-Blank-Password: T
     External-Authentication-RPC-Socket: 390695
     Authentication-Chaining-Mode: 1
     
   • Verifies the BMC Atrium Single Sign-On username and password by connecting with the BMC Atrium Single Sign-On server and returns any errors.

   • Configures single sign-on with the following entries in the ar.cfgfile:

     Atrium-SSO-Location: <<AtriumSSOURL>>
     Atrium-SSO-Admin-User: SSOAdminName
     Atrium-SSO-Admin-Password: SSOAdminPassword
     Atrium-SSO-Keystore-Password: truststorepassword
     Atrium-SSO-Keystore-Path: truststorepath
     
   • Restarts the AR System server.

Manually running the SSOMidtierIntegration utility on the AR System server

The SSOMidtierIntegration utility uses the following inputs to integrate BMC Atrium Single Sign-On and the AR System server:

Possible parameters for container-type and container-base-dir

• For --container-type, specify one of the following possible values:
  • JBOSSV4
  • JBOSSV5
  • SERVLETEXECV5
  • SERVLETEXECV6
  • TOMCATV5
  • TOMCATV6
  • TOMCATV7
  • WEBSPHEREV6
  • WEBSPHEREV7
  • WEBSPHEREV8
  • WEBLOGICV10
  • WEBLOGICV11

• If you are using the Apache or IIS web application server, specify --container-base-dir as <TOMCAT_Home_Dir> instead of the Apache or IIS directory, and specify the --container-type as TOMCAT instead of Apache or IIS.

Additional parameters for IBM WebSphere

For IBM WebSphere, you can set these additional parameters:

For example:

Additional parameters for Oracle WebLogic

For Oracle WebLogic, you can set these additional parameters:

For example:

If needed, you can manually run the SSOMidtierIntegration utility on 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. Enter the following command:

   java -jar SSOMidtierIntegration.jar --midtierintegration --ar-server-name ARServerName --ar-server-user ARServerUser --ar-server-password ARServerPassword --ar-server-port ARServerPort --install --container-type containertype --web-app-url MidtierURL --container-base-dir webserverhomedirectory --jre-path JREInstallDirectory --midtier-home MidtierHome
   

   For example:

   java -jar C:\Program Files\BMC Software\ARSystem\midtier\AtriumSSOIntegrationUtility\SSOMidtierIntegration.jar --midtierintegration --ar-server-name ARServer.labs.bmc.com --ar-server-user Demo --ar-server-password Demo --ar-server-port 0 --install --container-type TOMCATV6 --web-app-url http://Midtier.bmc.com:8080/arsys --container-base-dir "C:\Program Files\Apache Software Foundation\Tomcat6.0" --jre-path "C:\Program Files\Java\jre7" --midtier-home "C:\Program Files\BMC Software\ARSystem\midtier"
   

   Tip

   Copy and paste this example into a text editor, and modify the values for your own environment. Then copy the final version into your command window.

3. Review the utility logs at <ARSystemServerInstall>\artools\AtriumSSOIntegrationUtility\Logs\AtriumSSOIntegrationUtility.log.

4. Review the web.xml file (located at C:\Program Files\BMC Software\ARSystem\midtier\WEB-INF) to verify that the following settings are present:

   <filter>
                          <filter-name>Agent</filter-name>
                          <filter-class>com.bmc.atrium.sso.agents.web.SSOFilter</filter-class>
   </filter>
   <filter-mapping>
                          <filter-name>Agent</filter-name>
                          <url-pattern>/*</url-pattern>
   </filter-mapping>
   

5. Review the config.properties file (located at C:\Program Files\BMC Software\ARSystem\midtier\WEB-INF\classes) to verify that the following entry is present:

   arsystem.authenticator=com.remedy.arsys.sso.AtriumSSOAuthenticator
   

   The SSOMidtierIntegration utility performs the following actions on the Mid Tier:

   • Validates the user inputs and returns any errors.
   • Checks if you are installing or uninstalling.
   • Connects to AR System server and fetches SSO values. If successful, performs AR System server and BMC Atrium Single Sign-On integration. Otherwise, returns an AR-SSO integration is not done error.
   • Checks if Mid Tier is running and, if so, shuts it down before running the utility.
   • Copies files to Mid Tier and performs other modifications to the Mid Tier.