Install UIM Server

This article explains how to install UIM Server for the first time. After you have completed pre-installation, you can run the installer for UIM Server. The following topics cover the complete information:
uim902
Install_UIM_Server
This article explains how to install UIM Server for the first time. After you have completed pre-installation, you can run the installer for UIM Server. The following topics cover the complete information:
 
 
2
 
2
 
 
CA UIM 9.2.0 does not support the new installation of the UIM Server. Only an upgrade is supported. CA UIM upgrade also provides a secure mode. For more information about secure mode, see Secure Hub and Robot.
Tasks Performed
The UIM Server is the foundation of the CA UIM solution and consists of:
  • The Message Bus
  • The Domain
  • The Primary Hub
  • A robot and core probes
  • The UIM Server web page, which contains links to installers for client systems
  • The UIM Database
  • The required UIM Server and Database user accounts
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 Home Page, which provides access to administrative consoles and UIM component install packages.
  • Installs your local archive, which contains probes and packages.
High-Level Process
The following diagram shows the high-level steps that are required for the UIM Server installation:
Install UIM Server Process
Install UIM Server Process
Before You Begin
Complete the following tasks before you install UIM Server:
  1. Perform Pre-Installation Planning
  2. Verify Required Disk Space
  3. Microsoft SQL Server Log in Requirements
  4. POSIX-Oriented Operating System Requirements
 If you are installing on Windows 2008 R2 64-bit, ensure that you have the Microsoft Visual C++ 2008 64-bit run-time libraries already installed; otherwise, installer will fail.
Perform Pre-Installation Planning
Read and understand the prerequisites that are detailed in Pre-Installation Planning. Pre-Installation planning covers the hardware, operating system, and database software requirements for CA UIM.
 To configure CA UIM in a pure IPv6 environment review Configure IPv6 Support.
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, 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 using the database account that you designated during Pre-Installation Planning. If you are using Microsoft SQL Server with Windows authentication, verify that 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. For more information about the 
log on as a service 
right, see the Microsoft article https://technet.microsoft.com/en-us/library/cc739424(v=ws.10).aspx. 
POSIX-Oriented Operating System Requirements
Root access is required to run the UIM Server installer.
Download the UIM Server Install Package
 
Follow these steps:
 
  1. Log in to the UIM server as administrator.
  2. Log in to support.ca.com, Download Management, or support.nimsoft.com, Downloads.
    A CA support login is required.
  3. Download the following installation packages for your operating system:
    • The UIM Server Installer (
      setupCAUIMServer 
      executable)
    • The UIM Server Packages (
      uimserverpackages
       zip file)
      Both files are required on the system that hosts the UIM server. If the uimserverpackages zip file is not present, the installation fails.
  4.  
    (Silent Mode Only) 
    Download the 
    Silent Install Templates for UIM Server
     zip package.
  5.  
    (Linux Only)
     Run the 
    chmod 755
     command on the setupCAUIMServer executable file.
Run the UIM Server Installer
You can run the installer in one of the following modes:
  • GUI Mode 
  • Console Mode 
  • Silent Mode 
The installer log file is located in /tmp/ca_uim.
GUI Mode
Graphical user interface (GUI) mode walks you through the installation process.
 
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 the following items:
    • 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
Console mode provides an interactive command-line interface.
 
Follow these steps:
 
  1. From a command line, execute the appropriate command:
    setupCAUIMServer.exe -i console (Windows systems) setupCAUIMServer.bin -i console (Linux systems)
  2. 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
  3. Allow the process to complete. Note the following items:
    • Post configuration can take several minutes.
    •  
      (Linux Only
      )
       
       To see the progress of the installation in detail, 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: 
      /etc/init.d/nimbus start
       
Silent Mode
If you do not want to monitor your product installation for GUI inputs, you can use a silent mode installation. During a silent-mode installation, the UIM installer
 
reads your defined installation parameters from 
installer.properties 
file. A silent-mode installation:
  • Does not display configuration options.
  • Does not require any customer interaction after the creation of the properties file.
 
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 might 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.bin -i silent (Linux systems)
  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: 
      /etc/init.d/nimbus start
       
 (For Microsoft SQL Server with NT Authentication)
 
After installation, ensure that the 
Nimsoft Robot Watcher NT
 service Logon User is the same as the one used during UIM Server installation. Since this service starts the robot, the 
Nimsoft Robot Watcher
 user also requires full permissions to the UIM Server installation folder and logon privileges to the SQL Server. Also, we recommend against changing the logon user value, which could result in the robot either not being able to start or unable to function correctly due to file permission issues. If a change is made, be sure that the login user is specified in the <domain>\<nt_username> format so that the user has full permissions to the install directory contents.
Additional Information
Review the following additional information:
  • CA UIM 9.0.2 removes dependency on the end-of-life (EOL) Microsoft Visual C++ Redistributables for a few probes and packages. Because of this dependency removal, CA UIM 9.0.2 installation deploys the Microsoft Visual C++ 2017 Redistributables package (for example, vs2017_vcredist_x86) by default. With this package deployment, only the listed probes can work. For other probes that use the EOL Microsoft Visual C++ Redistributables or for older versions of the impacted probes, you must download and deploy the required EOL Microsoft Visual C++ Redistributable package (for example, vs2008_redist_x86) from the Archive.
  • Furthermore, if you want to use the impacted probes with CA UIM releases prior to CA UIM 9.0.2, ensure that you download and deploy the required Microsoft Visual C++ 2017 Redistributables package that is available in the Archive.
  • The UIM Server installer creates a .pem file (certificate.pem) in the 
    <Nimsoft>\security
     folder. The .pem file is a symmetric key that is shared with the required robots, which is then used for communication with the data_engine probe. You copy this .pem file to the remote UMP robot, UR robot, CABI robot, and HA system (if available) and provide the location of the file in the robot.cfg file (
    cryptkey = <.pem file location>
    ). Furthermore, if any impacted probe is not on the same computer where data_engine is present, copy the generated .pem file to the robot computer (where data_engine is not available) and update the robot.cfg file with the .pem file location on that computer. For more information about the robot.cfg file configuration, see Configure the robot.cfg File.
Options After Installation
 If you shut down any anti-virus software or firewalls before installation, turn them back on now.
Once you have installed UIM Server, you have several options on how to proceed:
 To Upgrade an existing installation, see Upgrade CA UIM
To reinstall, first, uninstall the software, then restart the installation process. Your server configuration information (domain and hub names, IP addresses, user accounts, and passwords) is not retained.