This documentation supports the 9.0 version of BMC Remedy ITSM Deployment.

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

Perform BMC Remedy Single Sign-On Installation


The current version of BMC Remedy Single Sign-On installer can only be used for a fresh installation. Using this installer, the user cannot upgrade or repair an existing version of BMC Remedy Single Sign-On.

This topic provides instructions for performing BMC Remedy Single Sign-On installation. You may perform a stand-alone or High Availability (HA) installation.

The BMC Remedy Single Sign-On High Availability (HA) cluster environment is implemented as a redundant system with session failover. In this model, if a node fails, the single sign-on load is transitioned to the remaining servers with minimal interruption.

When multiple BMC Remedy Single Sign-On servers are installed and configured to operate as a cluster, a system failure is absorbed by the remaining cluster nodes. The BMC best practice is to run the BMC Remedy Single Sign-On cluster behind a firewall to protect the communications channels (such as replication, single sign-on (SSO) sessions, and administrative communications) between the nodes. Communications are encrypted; however, the ports must be exposed for connections from other clustered machines. Internal communication (behind the load balancer) is not encrypted.

Before you begin

  • For installation prerequisites, see Preinstallation procedures for BMC Remedy Single Sign-On.
  • If an installation of BMC Remedy Single Sign-On already exists on the target computer, the installer will not allow another installation. You must uninstall the existing version.

  • Run Tomcat and BMC Remedy Single Sign-On from the same user group. For example, if tomcat is run under root privileges, then run BMC Remedy Single Sign-On under the same privileges as well.

To install BMC Remedy Single Sign-On

  1. Unzip the BMC Remedy Single Sign-On files.
  2. Run the installation program. The setup executable is located in the Disk1 directory of the extracted files.

    • (Microsoft Windows) Run setup.exe.
    • (Linux) Run the shell command sh setup.bin.
  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. Accept the default destination directory or browse to select a different directory, and then click Next.
  6. Select the Install BMC Remedy Single Sign-On 1.0 option, and then click Next.
  7. Browse to select the Apache Tomcat directory path where BMC Remedy Single Sign-On application will be deployed.

  8. Enter the database settings.

  9. Assign a database user. The details of the user will be used by BMC Remedy Single Sign-On to store details of application configuration and user sessions. You may choose to provide the credentials for an existing database user with permissions to create tables or create a new user. 


    In a High Availability (HA) environment), when you add nodes, you must select the Use Existing User option.

  10. Enter a cookie domain, and then click Next.
    The domain value of the cookie must be the network domain of BMC Atrium Single Sign-On or one of its parent domains.

  11. In the Installation Preview window, click Install.
  12. Log on with default credentials (URL: http(s)://servername:port/rsso/admin; User Name: Admin; Password: RSSO#Admin#).
  13. After you log on for the first time, change the password.

Installing BMC Remedy Single Sign-On in a HA environment

During subsequent node installations, previously installed nodes must be available so the newly added node can fully integrate into the cluster.

To install BMC Remedy Single Sign-On in a HA environment

  1. Ensure that all nodes are running and available.
  2. Unzip the BMC Remedy Single Sign-On files on the additional node.

  3. Run the installation program.
  4. Click Next to confirm the database settings.


    The database settings must already have been created and exist. Otherwise, BMC Remedy Single Sign-On will be installed as a standalone server.

  5. In the window to assign database users, select the Use Existing User option.

  6. Complete the rest of the installation steps.


The BMC Remedy Single Sign-On web agent is usually configured to communicate with only one BMC Remedy Single Sign-On server. If you want to configure the web agent to communicate with multiple servers, refer BMC Remedy Single Sign-On agent supporting multiple servers .

Where to go from here

To configure a BMC Remedy SSO for authentication, see Configuring BMC Remedy Single Sign-On .

Related topics

  • Orientation
  • BMC Remedy Single Sign-On HA environment
  • Manually integrating BMC Remedy Single Sign-On with BMC Remedy applications
  • Troubleshooting BMC Remedy Single Sign-On log on and log off issues

Was this page helpful? Yes No Submitting... Thank you