This documentation supports the 9.0 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.

The following represents the general command line syntax:

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

Note

The full path to the AtriumSSO directory must be specified.

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:\Program Files\BMC Software\Atrium SSO.
  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.exe -i silent -DOPTIONS_FILE=<AtriumSSO directory path>SSOSilentInstallOptions.txt
  5. Verify that your BMC Atrium Single Sign-On installation was successful:
    1. Launch the Administrator 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\UninstallBMCAtriumSSO.

  3. Run uninstall.exe or uninstall.sh with the following syntax:

    uninstall.exe -i silent -DOPTIONS_FILE=<Path to directory containing SSOSilentUninstallOptions.txt file>/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.exe -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/utility/AtriumSSOMaintenanceTool.cmd -silent -encrypt -encrypt -password=test -confirm_password=test
DES\:a751b8161238d05108839e457d4e2050

The SSOSilentInstallOptions.txt file contains:

-P installLocation=C:\SSO\AtriumSSO
-A featureAtriumSSO             
-J ITGR_INSTALL_TYPE=true
-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_CONFIRM=DES\:3996ba109b2b3f035fb4200116c2339a78ecec52023308de
-J ATRIUMSSO_COOKIE_DOMAIN=bmc.com
-J ATRIUMSSO_HOST_NAME=atrium-sso-vm4.bmc.com


Silent Install files for external Tomcat

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 featureAtriumSSO
-J ITGR_INSTALL_TYPE=true
-J ATRIUMSSO_INSTALL_TOMCAT=false
-J ATRIUMSSO_TOMCAT_HTTPS_PORT=8443
-J ATRIUMSSO_SERVER_PASSWORD=DES\:097133405e7ea7a641f019bca8781280
-J ATRIUMSSO_SERVER_PASSWORD_CONFIRM=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/jdk
-J JDK_LOCATION=/usr/jdk

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 featureAtriumSSO
-J ITGR_INSTALL_TYPE=true
-J ATRIUMSSO_INSTALL_TOMCAT=false
-J ATRIUMSSO_TOMCAT_HTTPS_PORT=8443
-J ATRIUMSSO_SERVER_PASSWORD=DES\:097133405e7ea7a641f019bca8781280
-J ATRIUMSSO_SERVER_PASSWORD_CONFIRM=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/jdk
-J JDK_LOCATION=/usr/jdk

Silent Install file for AR System integration

The SSOSilentInstallOptions.txt file for integrating BMC Atrium Single Sign-On and BMC Remedy AR System. You must run this file on the AR System server. The file must contain the following parameters:

-P installLocation=/root/bmc/AtriumSSO
-A featureArIntegration
-J ITGR_INSTALL_TYPE=false
-J ITGR_AR_TYPE=true
-J ITGR_AR_SERVER_NAME=arserver.xyz.com
-J ITGR_AR_SERVER_USER=Allen
-J ITGR_AR_SERVER_PWD=DES\:097133405e7ea7a641f019bca8781280
-J ITGR_AR_SERVER_PORT=0
-J ITGR_ATRIUM_SSO_URL=https://ssoserver.xyz.com:8443/atriumsso
-J ITGR_ATRIUM_SSO_PWD=DES\:097133405e7ea7a641f019bca8781280
-J ITGR_AR_TRUSTSTORE=/home/bmcuser/artruststore.jks
-J ITGR_AR_TRUSTSTORE_PWD=DES\:097133405e7ea7a641f019bca8781280
-J ITGR_AR_TRUSTSTORE_PWD_CNFRM=DES\:097133405e7ea7a641f019bca8781280

Silent Install file for Mid Tier System integration

The SSOSilentInstallOptions.txt file for integrating BMC Atrium Single Sign-On and BMC Remedy Mid Tier. You must run this file on the Mid Tier. The file must contain the following parameters:

-P installLocation=/root/bmc/AtriumSSO
-A featureMtIntegration
-J ITGR_MT_TYPE=true
-J ITGR_AR_SERVER_NAME=arserver.xyz.com
-J ITGR_AR_SERVER_USER=Allen
-J ITGR_AR_SERVER_PWD=DES\:097133405e7ea7a641f019bca8781280
-J ITGR_AR_SERVER_PORT=0
-J ITGR_MT_CONTAINER_TYPE=TOMCAT7
-J ITGR_MT_CONTAINER_BASE_DIR=/<path_to_midtier_server>
-J ITGR_MT_HOST_NAME=mt-host-name
-J ITGR_MT_AGENT_REALM=BmcRealm
-J ITGR_MT_TRUSTSTORE=/<path_to_truststore>
-J ITGR_MT_TRUSTSTORE_PWD=DES\:097133405e7ea7a641f019bca8781280
-J ITGR_MT_IS_BEHIND_LB=true
-J ITGR_MT_URL=http://mt-loadbalancer-url.xyz.com
-J ITGR_MT_HOME=/<path_to_midtier_home>
-J ITGR_MT_UPGRADE_JARS=true

Where to go from here

 

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