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.

Installing silently

In addition to using the GUI interface, the installer and uninstaller programs can be run from scripts. This topic provides examples for installing and uninstalling BMC Atrium Single Sign-On in silent mode by using the setup script from the command line. If you ae

Note

You must use the same options files and steps for upgrading BMC Atrium Single Sign-On silently.

The following represents the general command line syntax:

setup.sh|setup.cmd -i silent -DOPTIONS_FILE=<AtriumSSO directory path><file>

Note

The full path to the AtriumSSO directory must be specified.

If you are configuring BMC Atrium Single Sign-On as a High Availability (HA) cluster, you must complete the HA prerequisites and HA pre-installation tasks before running the installer in silent mode on the first node and the additional nodes. Before running the installer in silent mode on an additional node, you must also complete the following tasks:

  • Ensure that all nodes are running and available.
  • Copy the configuration file (created during the first node’s installation) to the Disk1 directory of the extracted files before installing BMC Atrium Single Sign-On on the node.

You must also complete the HA post-installation activities after you have run the installer in silent mode on all the nodes.

For information about the additional parameters that you must add in the SSOSilentInstallOptions.txt file, see Example options.txt file.

Running the installer in silent mode

  1. Open a command line window.
  2. Navigate to the AtriumSSO directory. For example, on Windows, the default location is C:\SSO\AtriumSSO.
  3. Create the SSOSilentInstallOptions.txt file with any environment-specific parameters. For details on the file format, see the Silent installation example.

  4. Run the setup command with the following syntax:

    setup.sh|setup.cmd -i silent -DOPTIONS_FILE=<AtriumSSO directory path>SSOSilentInstallOptions.txt
  5. Verify that your BMC Atrium Single Sign-On installation was successful:
    1. Launch the BMC Atrium SSO Admin Console.
    2. Confirm that you can view the BMC Atrium Single Sign-On logon panel.

Note

If you install in silent mode, you must also uninstall in silent mode to uninstall the server.

Uninstalling in silent mode

  1. Open a command-line window.
  2. Navigate to the AtriumSSO directory. For example, on Windows, the default location is C:\SSO\AtriumSSO.

  3. Run UninstallAtrium.exe with the following syntax:

    UninstallAtriumSSO.exe -i silent -DOPTIONS_FILE=<AtriumSSO directory path>SSOSilentUninstallOptions.txt

    where SSOSilentUninstallOptions.txt contains:

    -silent
    -U productAtriumSSO
    -U featureAtriumSSO

Example options.txt file

The following Windows example invokes a silent installation where the administrator password is admin123.

setup.cmd -i silent -DOPTIONS_FILE=C:\SSO\AtriumSSO\SSOSilentInstallOptions.txt

You can also generate a new administrator password using the following command from the local directory where you have unzipped the BMC Atrium Single Sign-On installation files:

<unzipped_localdirectory>/Disk1/support/AtriumSSOMaintenanceTool.cmd -silent -encrypt -encrypt -password=test -confirm_password=test
DES\:a751b8161238d05108839e457d4e2050

The SSOSilentInstallOptions.txt file contains:

-P installLocation=C:\SSO\AtriumSSO
-A productAtriumSSO
-J ATRIUMSSO_TOMCAT_SHUTDOWN_PORT=8005
-J ATRIUMSSO_TOMCAT_HTTP_PORT=8080
-J ATRIUMSSO_INSTALL_TOMCAT=true
-J ATRIUMSSO_TOMCAT_HTTPS_PORT=8443
-J ATRIUMSSO_SERVER_PASSWORD=DES\:3996ba109b2b3f035fb4200116c2339a78ecec52023308de
-J ATRIUMSSO_SERVER_PASSWORD_2=DES\:3996ba109b2b3f035fb4200116c2339a78ecec52023308de
-J ATRIUMSSO_COOKIE_DOMAIN=bmc.com
-J ATRIUMSSO_HOST_NAME=atrium-sso-vm4.bmc.com


 

Note

If you want to install only a specific feature of BMC Atrium Single Sign-On and not the entire product, use the option '-A feature<feature name>' instead of '-A productAtriumSSO'.

 

The SSOSilentInstallOptions.txt file for installing BMC Atrium Single Sign-On on external Tomcat specifying that the installer will use Tomcat scripts for starting/stopping Tomcat processes contains the following parameters:


-P installLocation=/root/bmc/AtriumSSO
-A productAtriumSSO
-J ATRIUMSSO_INSTALL_TOMCAT=false
-J ATRIUMSSO_TOMCAT_HTTPS_PORT=8443
-J ATRIUMSSO_SERVER_PASSWORD=DES\:097133405e7ea7a641f019bca8781280
-J ATRIUMSSO_SERVER_PASSWORD_2=DES\:097133405e7ea7a641f019bca8781280
-J ATRIUMSSO_COOKIE_DOMAIN=bmc.com
-J ATRIUMSSO_HOST_NAME=vl-aus-rh55-atm-sp01.bmc.com
-J USE_EXTERNAL_SCRIPTS=true
-J CLUSTER_MODE=STANDALONE_STRING
-J ATRIUMSSO_EXISTING_TOMCAT_DIRECTORY=/root/apache-tomcat-6.0.37
-J TRUSTSTORE_LOCATION=/root/apache-tomcat-6.0.37/conf/cacerts.p12
-J TRUSTSTORE_PASSWORD=changeit
-J KEYSTORE_LOCATION=/root/apache-tomcat-6.0.37/conf/keystore.p12
-J KEYSTORE_PASSWORD=changeit
-J KEYSTORE_ALIAS=tomcat
-J JAVA_LOCATION=/usr/jdk64
-J JDK_LOCATION=/usr/jdk64

The SSOSilentInstallOptions.txt file for installing BMC Atrium Single Sign-On on external Tomcat server specifying the installer uses Windows service of Tomcat server contains the following parameters:

-P installLocation=/root/bmc/AtriumSSO
-A productAtriumSSO
-J ATRIUMSSO_INSTALL_TOMCAT=false
-J ATRIUMSSO_TOMCAT_HTTPS_PORT=8443
-J ATRIUMSSO_SERVER_PASSWORD=DES\:097133405e7ea7a641f019bca8781280
-J ATRIUMSSO_SERVER_PASSWORD_2=DES\:097133405e7ea7a641f019bca8781280
-J ATRIUMSSO_COOKIE_DOMAIN=bmc.com
-J ATRIUMSSO_HOST_NAME=vl-aus-rh55-atm-sp01.bmc.com
-J USE_EXTERNAL_SCRIPTS=false
-J ATRIUMSSO_EXISTING_TOMCAT_SERVICE=Tomcat
-J CLUSTER_MODE=STANDALONE_STRING
-J ATRIUMSSO_EXISTING_TOMCAT_DIRECTORY=/root/apache-tomcat-6.0.37
-J TRUSTSTORE_LOCATION=/root/apache-tomcat-6.0.37/conf/cacerts.p12
-J TRUSTSTORE_PASSWORD=changeit
-J KEYSTORE_LOCATION=/root/apache-tomcat-6.0.37/conf/keystore.p12
-J KEYSTORE_PASSWORD=changeit
-J KEYSTORE_ALIAS=tomcat
-J JAVA_LOCATION=/usr/jdk64
-J JDK_LOCATION=/usr/jdk64

When installing BMC Atrium Single Sign-On as a High Availability (HA) cluster, the SSOSilentInstallOptions.txt file must contain some additional parameters.

The SSOSilentInstallOptions.txt file for installing the first node for a HA cluster must contain the following parameters:

-P installLocation=C:\SSO\AtriumSSO
-A productAtriumSSO
-J ATRIUMSSO_INSTALL_TOMCAT=true
-J CLUSTER_MODE=FIRST_MEMBER_CLUSTER_STRING
-J MEMBER_LOCATION=/home/xuser/5162_node.dat
-J ATRIUMSSO_COOKIE_DOMAIN=bmc.com
-J LOAD_BALANCER_URL=https://iBMC-JBHBBK1.bmc.com:443/atriumsso
-J ATRIUMSSO_LDAP_REPLICATION_PORT=8092
-J ATRIUMSSO_TOMCAT_SHUTDOWN_PORT=8005
-J ATRIUMSSO_SERVER_PASSWORD_2=DES\:097133405e7ea7a641f019bca8781280
-J ATRIUMSSO_TOMCAT_HTTP_PORT=8080
-J ATRIUMSSO_TOMCAT_HTTPS_PORT=8443
-J USE_EXTERNAL_SCRIPTS=false
-J ATRIUMSSO_SERVER_PASSWORD=DES\:097133405e7ea7a641f019bca8781280
-J ATRIUMSSO_HOST_NAME=rlnx-al-vm01.bmc.com
-J ATRIUMSSO_LDAP_PORT=8091

The SSOSilentInstallOptions.txt file for installing additional nodes for a HA cluster must contain the following parameters:

-P installLocation=/opt/bmc/AtriumSSO
-A productAtriumSSO
-J ATRIUMSSO_TOMCAT_SHUTDOWN_PORT=8005
-J ATRIUMSSO_TOMCAT_HTTP_PORT=8080
-J ATRIUMSSO_INSTALL_TOMCAT=true
-J ATRIUMSSO_TOMCAT_HTTPS_PORT=8443
-J CLUSTER_MODE=ADDITIONAL_MEMBER_CLUSTER_STRING
-J MEMBER_LOCATION=/tmp/SSO/5162_node.dat
-J ATRIUMSSO_COOKIE_DOMAIN=bmc.com
-J ATRIUMSSO_LDAP_REPLICATION_PORT=8092
-J ATRIUMSSO_HOST_NAME=vm-rhel5-rds1276.bmc.com
-J ATRIUMSSO_LDAP_PORT=8091
-J USE_EXTERNAL_SCRIPTS=false

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*