This documentation supports the 8.1 version of BMC Atrium Single Sign-On.

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

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

Comments

  1. Sean Brennan

    The SSOSilentInstallOptions.txt file also requires the following line.

    -A productAtriumSSO
    
    May 26, 2015 01:57
    1. Kamalakannan Srinivasan

      Hi Sean,

      Thank you for your comment. I will discuss with the concerned SME and address your comment.

      Regards,

      Kamal

      May 26, 2015 11:43
    1. Kamalakannan Srinivasan

      Hi Sean,

      I had a discussion with our technical team about including the line '-A productAtriumSSO' in the options file. They had the following query:

      • Did you face any issues while installing without this line in the options file? If yes, can you please specify them?

      Would request your response so that our technical team can address this.

      Thanks and regards,

      Kamal

      Jun 15, 2015 04:51
      1. Sean Brennan

        I don't recall seeing a specific error and I no longer have the log file. I looked through this document again to see if I was missing anything and noticed the '-U productAtriumSSO' under the silent uninstall instructions so gave it a try with '-A productAtriumSSO ' and it worked.

        I am installing in an HA cluster.

         

        Jun 15, 2015 01:01
        1. Kamalakannan Srinivasan

          Hi Sean,

          Thank you for your response. I made relevant changes to the topic.

          Regards,

          Kamal

          Jun 15, 2015 11:50