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
- Unzip the BMC Remedy Single Sign-On files.
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.
- In the lower-right corner of the Welcome panel, click Next.
- Review the license agreement, click I agree to the terms of license agreement, and then click Next.
- Accept the default destination directory or browse to select a different directory, and then click Next.
- Select the Install BMC Remedy Single Sign-On 1.0 option, and then click Next.
- Browse to select the Apache Tomcat directory path where BMC Remedy Single Sign-On application will be deployed.
- Enter the database settings.
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.
- 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.
- In the Installation Preview window, click Install.
- Log on with default credentials (URL: http(s)://servername:port/rsso/admin; User Name: Admin; Password: RSSO#Admin#).
- 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
- Ensure that all nodes are running and available.
Unzip the BMC Remedy Single Sign-On files on the additional node.
- Run the installation program.
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.
In the window to assign database users, select the Use Existing User option.
- 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 .
Where to go from here
To configure a BMC Remedy SSO for authentication, see .