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
Error rendering macro 'show-if' : Failed to render Visibility macro due to: @authenticated is not a valid user

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

  • To configure authentication, see Configuring after installation .
Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Orwin Lopes

    I would request BMC to also provide on how to install it on Linux environment because there are many steps that are skipped. I faced a issue when i tried to run AtriumSSOMaintenanceTool.sh script & it gave error :-

    /bin/sh^M: bad interpreter :No such file or directory\

    I had to run extra command to solve this :-

    sed -i -e 's/\r$//' AtriumSSOMaintenanceTool.sh 

    to make it working on RHEL6.5 .RHEL6.5 is supported OS Platform for Atrium SSO. So can you please tell where this steps are documented ?

    Feb 04, 2016 09:07
    1. Kamalakannan Srinivasan

      Hi Orwin,

      Thank you for your comment. I will discuss with the technical team and make the relevant changes.

      Regards,

      Kamal

      Feb 04, 2016 11:19
    1. Kamalakannan Srinivasan

      Hi Orwin,

      The Linux installation is the same as Windows. The only change required is to change *.cmd to sh *.bin or sh *.sh. Moreover, the MaintenanceTool scrip is located in utility folder and not the bin folder.

      Regards,
      Kamal

      Feb 05, 2016 04:37
      1. Orwin Lopes

        Hi,

        It does not work. I am not running it from bin folder. Also, i am running .sh only & not cmd in linux. it gives this error of bash. Apparently we need to convert the script from DOS to UNIX & hence this command works out. I would advice Testing Team to please check if 

        > cd /..../utility

        > ./AtriumSSOMaintenanceTool.sh   works or not.


        Thanks,

        Orwin

        Feb 05, 2016 06:00
        1. Kamalakannan Srinivasan

          Hi Orwin,

          Thank you for your comment. I will discuss with the technical team and keep you informed.

          Regards,
          Kamal

           

          Feb 05, 2016 06:10
        1. Kamalakannan Srinivasan

          Hi Orwin,

          Please try the below:

          > cd /..../utility

          > sh ./AtriumSSOMaintenanceTool.sh 

          Regards,

          Kamal

          Feb 09, 2016 04:23
          1. Albert Taylor

            the problem here is that the file has dos file endings.

             

            running the dos2unix command on the file fixes this.

            yum install dos2unix

            dos2unix AtriumSSOMaintenanceTool.sh
            dos2unix: converting file AtriumSSOMaintenanceTool.sh to Unix format ...

             

            Apr 12, 2017 08:34
  2. Orwin Lopes

    What is J MEMBER_LOCATION=/home/xuser/5162_node.dat ? Is there any explanation for all the parameters which are not self explanatory ? 

    Feb 24, 2016 09:56
    1. Kamalakannan Srinivasan

      Hi Orwin,

      Thank you for your comment.

      You may want to log a ticket/request with our customer support for further details.

      Going forward, BMC encourages customers to move to BMC Remedy Single Sign-On, our new single sign-on solution.

      Regards,

      Kamal

      Feb 25, 2016 11:53
  3. Orwin Lopes

    Hi Kannan,

     

    please check below :-

     

     

    Mar 02, 2016 09:26