Out of support

 

This documentation supports the 8.1 version of BMC Atrium Single Sign-On, which is in "End of Version Support." However, the documentation is available for your convenience. You will not be able to leave comments.

Click here to view the documentation for a supported version of Remedy Single Sign-On.

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.

The page BMC Atrium Core - description does not exist.

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:

[--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]
[--truststore=truststorepath | Optional parameter]
[--truststore-password=truststorepassword | Optional parameter]
[--force=<Yes or No> Restart AR Server automatically | Optional parameter]

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:

[--install-mode=Install or Uninstall]
[--ar-server-name=ARServerName]
[--ar-server-user=ARServerUser]
[--ar-server-password=ARServerPassword]
[--ar-server-port=ARServerPort]
[--container-type=containertype]
[--web-app-url=MidtierURL or LoadBalancerURL]
[--container-base-dir=webserverhomedirectory]
[--jre-path=JREInstallDirectory]
[--midtier-home=MidtierHome]
[--notify-url=MidTierURL]
[--agent-realm=RealmName]
[--force SuppressAllManualInputs]
[--server-instance-name WebSphereinstancename required input for WebSphere server]
[--instance-config-directory WebSphereconfigdirectory required input for WebSphere server]
[--weblogic-domain-home BEAdomainhome required input for WebLogic web application]

Note

If you are using IBM WebSphere, pass the IBM Java path as an input for the --jre-path input parameter.

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:

[--server-instance-name WebSphereServerInstanceName]
[--instance-config-directory WebSphereServerInstanceConfigurationDirectory]

For example:

[--server-instance-name server1]
[--instance-config-directory <WAS>/AppServer/profiles/AppSrv01/config/cells/<host>Node01Cell/nodes/<host>Node01/servers/server1]

Additional parameters for Oracle WebLogic

For Oracle WebLogic, you can set these additional parameters:

[--weblogic-domain-home DomainHomeDirectoryForDomainWhereWebAppIsDeployed]

For example:

[ --weblogic-domain-home <BEA_Home>/user_projects/domains/base_domain]

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.
Was this page helpful? Yes No Submitting... Thank you

Comments