Install UIM Server

This article explains how to install UIM Server for the first time. To:
uim835
This article explains how to install UIM Server for the first time. To:
  • Upgrade an existing installation
    , go to Release Notes and Upgrading.
  • Reinstall
    , first uninstall the software, then restart the installation process. Note that your server configuration information (domain and hub names, IP addresses, user accounts and passwords) is
    not
    retained.
The UIM Server installer performs the following tasks:
  • Installs the primary hub, the core of the UIM message bus
  • Creates your database (if not created during database software installation)
  • Creates your UIM domain
  • Installs your UIM Server web page, which provides access to administrative consoles and UIM component install packages
  • Installs your local archive, which contains UIM probes and packages
Contents 
Before You Begin
Complete the following tasks before you install UIM Server.
Perform Pre-Installation Planning
Read and understand the prerequisites detailed in Pre-Installation Planning. Pre-Installation planning covers the hardware, operating system, and database software requirements for CA UIM.
Verify Required Disk Space
Ensure that you have the necessary disk space:
  • 15 GB available disk space is recommended for UIM Server.
  • The installer requires 2.1 GB of temporary space to unpack the files.
On Linux and Solaris, the installer unpacks to /tmp/install.dir.
xyz
, where
xyz
is a random number. If /tmp does not have 2.1 GB available, the installer uses the home directory of the user running the installer (root).
Microsoft SQL Server Log In Requirements
If you are using Microsoft SQL Server for the UIM database, log in to the system as the user associated with the UIM Server installation. If you are using MS SQL Server with Windows authentication, make sure a domain administrator has permission to
log on as a service
on both the primary hub server and the database server, and that SQL Server is configured to use Windows authentication.
POSIX-Oriented Operating System Prerequisites
Root access is required to run the UIM Server installer.
Download the UIM Server Install Package
Follow these steps:
  1. Log on to the primary hub server as administrator.
  2. Log in to support.nimsoft.com and go to
    Downloads
    .
  3. Download the UIM Server install package appropriate for your platform
  4. (Silent Mode Upgrade Only)
    Download the
    Silent Install Templates for UIM Server
    zip package.
  5. (Linux and Solaris
    Only
    ) Execute
    chmod 755
    on the install file to make it executable.
Run the UIM Server Installer
You can run the installer in three modes. Graphical user interface (GUI) mode walks you through the installation process. Console mode provides an interactive command-line interface. In silent mode, the installer reads configuration information from a response file you create, then runs with no further interaction.
If the CA UIM installation on Solaris is interrupted, or for some reason fails, then installer files (/tmp/install.*) remain in /tmp. Since Solaris swap includes the /tmp directory, CA recommends manually deleting these files before running the installer again. 
The installer log file is located in /tmp/ca_uim.
GUI Mode
Follow these steps:
  1. Follow the prompts to complete the installation. Database server parameters and hub configuration values are case-sensitive. For help, you can hover over the tooltip buttons next to the fields or refer to the article Installation Parameters.
  2. Allow the process to complete. Note that:
    • Post configuration can take several minutes.
    • A warning that one or more probes did not activate before the installer finished does not necessarily represent an issue. Some probes might not finish their startup sequence before the installer displays its final screen.
Console Mode
Follow these steps:
  1. Log on to the UIM Server system as administrator.
  2. From a command line, execute the appropriate command:
    setupCAUIMServer.exe -i console (Windows systems) setupCAUIMServer_linux.bin -i console setupCAUIMServer_solaris.bin -i console setupCAUIMServer_solaris_sparc64.bin -i console
  3. Follow the prompts to set up your database and specify your hub and robot information. Database server parameters and hub configuration values are case-sensitive. The parameters are defined in the article Installation Parameters
  4. Allow the process to complete. Note the following:
    • Post configuration can take several minutes.
    • (Linux and Solaris Only
      )
      To see the progress of the installation in detail, execute:
      $ tail -f /tmp/ca_uim/uimserver_ia_install.log
  5. UIM Server launches. If for some reason it does not, execute:
    • Windows: 
      net start "Nimsoft Robot Watcher"
      The NT service named 'Nimsoft Robot Watcher' can also be administered through the 'Services' Administrative Tools control panel application.
    • Linux or Solaris: 
      /etc/init.d/nimbus start
  6. Turn on your anti-virus and firewall software.
Silent Mode
Follow these steps:
  1. Prepare your response file:
    1. Extract the silent install template zip file.
    2. Locate the
      uimserver_silentinstall_master.properties
      file that corresponds to your system setup, and save the file as
      installer.properties
      in the same directory as the UIM Server installation executable binary file.
    3. In
      installer.properties
      , enter or change the parameter values as needed. All lines that do not begin with a
      #
      symbol must have a value. For more information, refer to the article Installation Parameters.
    4. Save the file, ensuring the file type is still
      PROPERTIES
      . If the file type is
      Text Document
      , remove the
      .txt
      extension (which may not be displayed in the folder).
  2. Run the installer. From a command line, execute the appropriate command:
    setupCAUIMServer.exe -i silent(Windows systems) setupCAUIMServer_linux.bin -i silent setupCAUIMServer_solaris.bin -i silent setupCAUIMServer_solaris_sparc64.bin -i silent
  3. The installer unpacks the files and completes the installation. This process can take several minutes or more. To see the progress of the installation, execute:
    tail -f /tmp/ca_uim/uimserver_ia_install.log
  4. UIM Server launches. If for some reason it does not, execute:
    • Windows:
      net start "Nimsoft Robot Watcher"
      The NT service named 'Nimsoft Robot Watcher' can also be administered through the 'Services' Administrative Tools control panel application.
    • Linux or Solaris:
      /etc/init.d/nimbus start
Post-Installation Tasks
If you shut down any anti-virus software or firewalls prior to installation, turn them back on now.
Once you have installed UIM Server, you have several options on how to proceed: