Installation Parameters

This article describes the parameters that are used during CA UIM installation. The parameters that are required during your installation vary depending on:
uim902
This article describes the parameters that are used during CA UIM installation. The parameters that are required during your installation vary depending on:
  • The installation method that you are using. 
  • The database software that you are using for the UIM database.
The following topics cover the information:
 
 
2
 
2
 
 
GUI and Console Parameters
The GUI and console installation processes prompt you for the parameters that are required for your operating system, database, and secure mode.
Port Parameters
Parameter
Value
WASP HTTP Port
The port for accessing Admin Console, UMP, and the UIM Home Page (default is 80)
MySQL Parameters (GUI/Console)
 
Parameter
 
 
Value
 
Database Server Hostname or IP
Database server hostname or IP address.  If you have selected IPv6 installation environment, then enter the IPv6 address as database server hostname.
Database Server Name
Desired name for a new database, or the name of the UIM database that is created before UIM Server installation
Database Port
Database server port (typically 3306)
Database Name
Enter CA_UIM or the name of your choice
Database Username
Database Password
Database administrative account (root) and password
SQL Server Parameters (GUI/Console)
 
Parameter
 
 
Value
 
Database Server Hostname or IP
Database Server hostname or IP address. If you have selected IPv6 installation environment, then enter the IPv6 address as database server hostname.
Database Server Port
  • Database server port if the port is assigned (default is 1433)
Database Name
  • CA_UIM (default) or name of your choice for a new database
  • Actual name of the UIM database that is created before UIM Server installation
Database Authentication Mode
  • SQL Server Authentication to use the database to authenticate credentials
  • Windows Authentication to use Active Directory to authenticate credentials
Database Username
  • Username
     
    for a SQL Server user account on the database server if you chose SQLServer Authentication (default is sa)
  • Domain/username for a Windows account if you chose Windows Authentication
 If you chose 
Create New Database
 mode, this account must have administrative privileges.
Database Password
  • Password for existing database administrator account
  • Desired password if the account is created during CA UIM installation.
Enable TLS
Select the option to enable TLS v1.2 in CA UIM, which lets the UIM Server establish secure communication with the UIM database (Microsoft SQL Server in this case). 
For more information about TLS v1.2 support, see the Support for TLS v1.2 section in Microsoft SQL Server.
TrustStore Path
Specify the location of the generated .jks file. The UIM Server installer copies the .jks file from the specified location and places it in the
<uim>\Nimsoft\security
folder during the installation. The installer then renames the copied file to truststore.jks. This file includes your database server certificate. For more information about how to create a .jks file, see the Support for TLS v1.2 section (Create a .jks File for Server Certificate) in Microsoft SQL Server.
TrustStore Password
Specify the password to access the source .jks file.
 
Oracle Parameters (GUI/Console)
 
Parameter
 
 
Value
 
Oracle Instant Client Directory
Location of Oracle Instant Client (required)
Database Server Name
  • Hostname
  • IPv4 address
Database Server Port
Database server port (typically 1521)
Database Service Name
  • Oracle service name to use for the database connection (default is ORCL)
  • (O
    racle 12 ONLY)
     Pluggable database name
SYS Password
Password for the SYS account on the database server (required only if database is created during installation)
Database Username
  • Desired name for the UIM database user account that the installer creates (new)
  • Database user who is created when database was created (existing)
Database Password
Password for the UIM database administrator account
Database Tablespace Name
Tablespace name to associate with the database username schema. Valid characters are: a-z, A-Z, 0-9 and underscore (_)
Enable TLS
Select the option to enable TLS v1.2 in CA UIM, which lets the UIM Server establish secure communication with the UIM database (Oracle in this case). For more information about TLS v1.2 support, see the Support for TLS v1.2 section in Oracle.
Wallet Location
Specify the location of the wallet where your security certificates are available. This location includes your trusted security certificates. The same security certificate must be available on the database server. For more information, see the Support for TLS v1.2 section in Oracle.
Wallet Type
Select the wallet type from the drop-down list. The selected wallet type takes the precedence. Note that both SSO and PKCS12 are copied to the UIM Server (
<uim>\Nimsoft\security
) irrespective of the wallet type you select.
Wallet Password
Specify the password to access the wallet information.
Need Client Authentication
Select the option to specify whether you want to enable client authentication.
Hub Parameters (GUI/Console)
Hub parameters (domain and hub name, specifically) modified after installation will severely impact your environment. Changing these fields without updating the rest of the hub and robot configuration files (hub.cfg and robot.cfg) in your environment will cause a disconnect from those components.
 
Parameter
 
 
Value
 
Domain Name
  • Desired domain name (default is
     hostname
    _domain)
Primary Hub Name
  • Desired hub name (default is 
    hostname
    _hub)
Primary Robot Name
  • Desired robot name (default is 
    hostname
    )
Primary Robot First Probe Port
  • No value or the default (48000)
  • Port assignments start at 48000. Increase by one until a free port is found, then continue to increase for subsequent assignments
  • Any available port if you want to specify an initial port for UIM probes. Subsequent port assignments increase from the specified port
Primary Hub IP Address
  • IP address that you want to use for UIM traffic (the installer displays all network interfaces attached to the computer). If you have selected IPv6 installation environment then you can chose the interface to install.
Primary Hub License
  • License key exactly as it appears on your UIM License Document
  • Autogenerated to create a temporary license that is valid for 30 days
The above-mentioned licensing functionality is no longer applicable for CA UIM 9.2.0. From CA UIM 9.2.0 onward, hub/robot- and probe-level licensing requirements have been removed. Deploy the hub, robot, and distsrv versions released with CA UIM 9.2.0 to remove the license dependency. If you want to continue with the older versions of hub and probes that require an extension of the license, contact Support so that they can assist you in extending the license (if required).
UIM Administrator Username
  • Administrator
     
    by default
UIM Administrator Password
  • Desired UIM administrator password (at least six characters)
telemetry Probe Parameters
The telemetry probe is installed by the CA UIM installer, unless you choose to not accept the terms of the Telemetry Probe License Agreement and you cancel the installation of CA UIM. You must read and scroll completely to the bottom of the Telemetry Probe License Agreement before you can modify the probe parameters.
Parameter
Value
I accept the terms of the Telemetry Probe License Agreement
If you accept the terms, click the radio button. If you want the probe to upload data about your CA UIM environment to CA Technologies Support for further troubleshooting purposes, click the button to accept the terms 
and
 enter your Support credentials before you click Next. If you click the button to accept the terms and do 
not
 enter your Support credentials before you click Next, the probe is installed, is active, and collects data about your CA UIM environment. However, the probe saves this data only to your local system. 
Note
: You cannot go back later to configure the probe to upload data to Support.
I do NOT accept the terms of the Telemetry Probe License Agreement
If you do NOT accept the terms, click the radio button. If you want to halt the entire CA UIM installation process, click the button to NOT accept the terms and then click Cancel.
CA Support Username
If you accept the terms and want the probe to upload data about your CA UIM environment to Support, enter your valid CA UIM Support username.
CA Support Password
If you accept the terms and want the probe to upload data about your CA UIM environment to Support, enter your valid CA UIM Support password.
Secure Mode Parameters
This section is applicable only when you are upgrading from CA UIM 9.0.2 to CA UIM 9.2.0.
 
Parameter
 
 
Value
 
Do you want to install secure bus binaries?
Enable
The CA UIM 9.2.0 upgrade installer (UIM Server) performs the secure hub- and robot-related configurations in the existing CA UIM 9.0.2 environment when you enable this option. The secure mode option provides enhanced end-to-end security for hub-to-hub and robot-to-hub communication. For more information about the secure hub and robot, see Secure hub and robot.
Review the following points:
  • You want to use the secure option.
    Your existing 9.0.2 setup is already configured with tunnels. In this case, the tunnel configuration options are not displayed in this screen. Because the secure option is enabled, the upgrade uses the secure hub and robot packages.
  • You want to use the secure option.
    Your existing CA UIM 9.0.2 setup is not configured with tunnels. In this case, the tunnel configuration options are displayed in this screen. Because the secure option is enabled, the upgrade uses the secure hub and robot packages.
  • You do not want to use the secure option.
    When you disable the secure option, no tunnel configuration parameters are displayed in this screen. Because the secure option is not enabled, the upgrade uses the non-secure (normal) hub and robot packages.
Tunnel Server Port
Specifies the tunnel server port that you want to use for the primary hub. Click 
Test
 to verify the port availability.
 
Default:
 48003
CA/Tunnel Server Password
Specifies the password that you want to use while creating the certificate authority (CA) and * (wildcard) tunnel server certificates.
Confirm CA/Tunnel Server Password
Lets you confirm the password entered for the CA and * tunnel server certificates.
Client Certificate Password
Specifies the password that you want to use while creating the * tunnel client certificates.
Confirm Client Certificate Password
Lets you confirm the password entered for the * tunnel client certificates.
Silent Install Parameters
Silent install parameters are defined in the installer.DB_OS.properties file. To get the appropriate template file, access the KB article and download the required file based on your release.