This documentation supports the 1.3 version of Remedy with Smart IT.

To view the latest version, select the version from the Product version menu.

Configuring Smart IT for BMC Atrium Single Sign-On

This topic describes how to configure the integration of BMC Atrium Single Sign-On with both BMC Remedy with Smart IT (Smart IT) and BMC MyIT.


This procedure does not apply to multitenant environments.

BMC Atrium Single Sign-On authentication applies to both the universal client and to mobile applications. When a user logsin toon a mobile device, the user is prompted to enter thehost nameand port. If the server has SSO enabled, the mobile client opens a browser to the SSO login page. The SSO server sets the SSO cookies after authentication on to the device browser. When the user relaunches the application, if the cookies are not expired, the mobile client displays the application. If the cookies are expired, the user is shown the login page again for authentication.

Before you begin 

  • Install BMC Atrium Single Sign-On and configure realms. For more information, see the BMC Atrium Single Sign-On 9.0 online documentation.
  • Install Smart IT and BMC MyIT.
  • Verify that access to the BMC Atrium SSO servers and the BMC MyIT and Smart IT server requires the same domain. Otherwise, deploying the BMC Atrium Single Sign-On agent will not work.
  • Verify the location of the Web Agent folder or compressed file in the BMC Atrium Single Sign-On installation files at the following location:

    location webagent

To enable BMC Atrium Single Sign-On in the Smart IT and BMC MyIT database

  1. Using the business schemalogin, log into the Oracle or Microsoft SQL database configured for Smart IT and BMC MyIT during installation.
    The Smart IT and BMC MyIT server is installed with two logins for business schema and system schema. If you do not know the login details, check the database configuration files at TomcatInstallationPath/Tomcat8.0/conf/catalina/localhost/ux.xml

  2. In the TENANT table for all tenants (all entries in the table), for Microsoft SQL database set the SAML Authentication field to True, and for Oracle database, set the database value as 1.

    Example - Microsoft SQL: Setting SAML_AUTHENTICATION

  3. Repeat this step each time you add a tenant to the BMC Atrium Single Sign-On configuration.  

To deploy the BMC Atrium Single Sign-On agent

For clusters, complete the following procedure for each Smart IT and BMC MyIT server.

  1. Stop the Apache Tomcat server.

  2. Copy the WebAgent folder to any location on the Smart IT and BMC MyIT server, and, if it is a compressed file, extract the files. 

  3. In a Linux shell or DOS command window, go to the WebAgent/Deployer folder. 
  4. Specifying the ssoServer:portmyitUrltomcatServerPathssoAdminName, and ssoAdminPassword values, run the following command with the fully qualified domain names:
    Irrespective of the Tomcat version you are using, use 'tomcatv7' in this command.

    JavaInstallationPath\java -jar deployer.jar --install --container-type tomcatv7 --atrium-sso-url https://ssoServer:port/atriumsso --web-app-url http://myitUrl/ux --container-base-dir tomcatServerPath --admin-name ssoAdminName --admin-pwd ssoAdminPassword


    Create a .bat or .sh file with the command so that, if needed, you can modify and run the command, for example, in clusters or server groups. 

    Example: /usr/java/jdk1.8/bin/java -jar deployer.jar --install --container-type tomcatv7 --atrium-sso-url --web-app-url --container-base-dir /opt/bmc/apache/tomcat --admin-name admin --admin-pwd Pass1234

  5. Check the output for errors.
  6. Verify that the atssoAgents folder has been created in the Tomcat folder. 
    Example: Apache Software Foundation\Tomcat8.0\atssoAgents
  7. Log in to the BMC Atrium Single Sign-On server, and verify that /ux@myitServer:port exists in the agent list.

  8. Restart the Tomcat server for Smart IT.

  9. Log in to Smart IT or BMC MyIT with BMC Atrium Single Sign-On. 

Related topics

Configuring after installation from the BMC Atrium Single Sign-On online documentation

Installing Smart IT and BMC MyIT

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.


  1. Matthias Werninghaus

    At point 10.

    I cannot find the ux.war file...i saw it in previous versions but now in Smart-IT 1.3 it's not there.

    Not in Apache Directory and not in Smart-IT Directory...

    Did i miss a Thing?

    Nov 10, 2015 01:19
  2. Catherine Siderine

    Hi Matthias,

    Thanks for your question. I have sent it to the person who maintains this content.


    Nov 11, 2015 01:11