Installing Unified Inventory Management

5 Installing Unified Inventory Management

This chapter describes how to install Oracle Communications Unified Inventory Management (UIM).

About the UIM Installer

You install UIM using the Oracle NextGen Installer. This installer installs the core application and configures connections with the components, based on the connection details you provide. You can install UIM by using interactive install or silent install.

Interactive install: Use interactive install when you want to interact with the installer UI during installation, such as installing a UIM production environment. See "Installing UIM Using the Interactive Mode".
Silent install: Use silent install when you are installing UIM using the same configuration repeatedly, such as installing multiple UIM test environments. Silent install does not use the installer UI. Rather, it is a scripted installation that runs in the background. See "Installing UIM Using Silent Mode".

Installing UIM Using the Interactive Mode

This section describes the procedure for installing UIM using the interactive mode.

Prerequisite

Configure the WebLogic Server to not use the demonstration identity and trust keystores. See "Configuring the WebLogic Server to Not Use KSS Demo Identity and Trust Keystores" for more information.

To install UIM by using the interactive install:

Note:

In the event that the installation fails for some reason, you are required to create a new WebLogic domain and a new database user before you begin installation again.

For upgrade scenarios, retry the installation and if the installation fails again contact My Oracle Support.

See "Installing and Configuring Oracle WebLogic Server".

Note:

The installer must be launched from a host which has access to Domain_Home on the UIM AdminServer. If UIM is installed using a shared file system, then this is not an issue.

Download the required version of the JRE, which is contained in the JDK. See "Installing the Oracle JDK" for more information.
Create a temporary directory (temp_dir).
Download the UIM software pack from the Oracle software delivery website and save it to temp_dir.
Run the Oracle NextGen Installer file (UnifiedInventoryManagementInstaller_{release}.jar) using the following command:
```
java -jar UnifiedInventoryManagementInstaller_{release}.jar
```
The Welcome screen of the installation wizard appears.
Click Next and from the Installation Location screen, enter the path of Domain Home, where UIM will be installed.
Click Next.

The Select Installation Type screen appears.

Note:

The installer creates an Inventory directory if it does not detect any installed Oracle products on the system. The Inventory directory manages all Oracle products installed on your system.
Select Complete as the type of UIM installation, and click Next.
Do the following:
1. In the Host Name field, enter the Listen address of the Administration server (IP address or the host name of the host machine).
2. In the Port Number field, enter the Administration server port number.
3. In the User Name field, enter user name with which you connected to the Administration server.
  
  Note:
  
  This user should belong to the WebLogic Server Administrator's group.
4. In the Password field, enter the password for the user name that you provided in the User Name field.
5. Select or deselect the Use SSL check box based on your business need.
6. In the KeyStore Location field, enter the keystore location if the Use SSL check box is selected.
7. Click Next.
  
  The Target Selection screen appears.
Select the option for the server, or cluster, where you want to deploy UIM, and click Next.

The Database Type Selection screen appears.

Note:

If you select a managed server, ensure that all managed servers and the node managers are running.
Select the option for the database type to be used and click Next.
- If you select Standard Oracle Enterprise Database, the Database Connection Information screen appears.
- If you select Oracle Real Application Clusters Database, the RAC DB Connection screen appears.
Enter the Oracle RAC Database Nodes Connection information, by doing the following:
1. In the RAC Database Connection String field, enter the connection details to connect to the Oracle RAC database.
  
  For example:
```
HOST_NAME1:PORT1:SERVICE_NAME,HOST_NAME2:PORT2:SERVICE_NAME
```
2. In the User Name field, enter the user name for the Oracle RAC database SYSDBA user.
  
  Note:
  
  The user must have the privileges: CATALOG, CONNECT, Create User, Create Session, Grant Any Privilege, Grant Any Role, Select Any Table, Select any Dictionary, CREATE MATERIALIZED VIEW, QUERY REWRITE, RESOURCE, UNLIMITED TABLESPACE.
3. In the Password field, enter the password for the user name that you provided in the User Name field.
4. Click Next.
  
  The MDS Schema information screen appears.
Enter the Database Connection information by doing the following:
1. In the Host Name field, enter the IP address or host name of the machine where the database server is installed.
2. In the Port Number field, enter the port number with which the installer will connect to the database server.
3. In the User Name field, enter the user name for the database SYSDBA user.
  
  Caution:
  
  You must use the same user name and password that you provided when you set up the database schema using the Repository Creation Utility (RCU).
  
  The user must have the following privileges: CATALOG, CONNECT, Create User, Create Session, Grant Any Privilege, Grant Any Role, Select Any Table, Select any Dictionary, CREATE MATERIALIZED VIEW, QUERY REWRITE, RESOURCE, UNLIMITED TABLESPACE.
  
  See "Creating the Database RCU Schema for UIM" for more information.
4. In the Password field, enter the password for the user name that you provided in the User Name field.
5. In the Service Name field, enter the service name for that uniquely identifies your database on the system.
6. Click Next.
The MDS Schema Information screen appears.
Enter the MDS Schema information by doing the following:
1. In the User Name field, enter the user name for the MDS schema (prefix_MDS).
  
  Note:
  
  You must use the same user name and password provided when the UIM MDS schema was created.
2. In the Password field, enter the password for the user name that you provided in the User Name field.
Select whether or not to create the UIM database schema and click Next.

Note:

If you select to create the UIM database schema, the schema will be empty.

If you select not to create the UIM database schema, then you are using an existing schema (from a previous install or a manually created UIM schema).
If you select Yes, the Do you want to create the UIM JDBC Store or File Store? dialog box appears. But, if you want to use the existing UIM schema, select No. The Existing Schema Information screen appears.
Select the type of store to create and click Next.

The Unified Inventory Management Schema Information screen appears.

Note:

If File Store is selected, a file store (inv_jms_store) is created at the Domain_Home/UIM location.
Enter the UIM database schema information, by doing the following:
1. In the User Name field, enter the user name for the Unified Inventory Management schema.
2. In the Password field, enter the password for the user name that you provided in the User Name field.
3. In the System Tablespace field, enter the name for the permanent tablespace.
4. In the Temp Tablespace field, enter the name for the temporary tablespace.
5. Click Next.
The Security Provider Selection screen appears.
(Optional) The Existing UIM Schema screen appears when you do not create a new UIM Schema.
- In the User Name field, enter the user name for the Unified Inventory Management schema.
- In the Password field, enter the password.
The Security Provider Selection screen appears.
Select the security provider you want to use and click Next.
- If you select the default WebLogic security provider (Embedded_LDAP) option, theUIM Administrator user creation (Optional) screen appears.
- If you select the external security provider option (External_LDAP), the External Security Provider Connection Information screen appears. Continue with the next step.
Enter the External Security Provider information, by doing the following:
1. In the LDAP Server Host Name field, enter the host name for the external LDAP server.
2. In the LDAP Server Port Number field, enter the port number for the external LDAP server.
3. In the LDAP Server User Name field, enter the user name for the external LDAP server.
4. In the LDAP Server Password field, enter the password for the external LDAP server.
5. In the User Base DN field, enter the user base DN.
6. In the Group Base DN field, enter the group base DN.
7. In the Use SSL? field, clear the check box if you do not want to use SSL.
  
  This option is checked by default. If you accept the default, ensure that your server is SSL-enabled. The SSL port would have been configured when creating the domain.
8. In the KeyStore Location field, enter the location for the keystore.
9. Click Next.
  
  The CMWS User Information screen appears.
Do the following:
1. In the User Name field, enter the user name for the UIM user.
  
  This user accesses and uses Unified Inventory Management.
2. In the Password field, define a password for the UIM user.
  
  Note:
  
  The UIM user password length must be between 8 to 12, should contain atleast one lowercase, one uppercase, one number, and one special character. No character can appear more than 4 times in total or more than 3 times in a row.
  
  Also, the user name must not be part of the password, not even in the reverse order.
  
  In the Confirm Password field, enter the password again, to confirm it.
3. Click Next.
  
  The CMWS User Information screen appears.
Enter the CMWS User information, by doing the following:
1. In the User Name field, enter the user name for the CMWS user.
2. In the Password field, enter password.
  
  Note:
  
  The CMWS user password length must be between 8 to 12, should contain atleast one lowercase, one uppercase, one number, and one special character. No character can appear more than 4 times in total or more than 3 times in a row.
  
  Also, the user name must not be part of the password, not even in the reverse order.
3. In the Confirm Password field, enter the password again.
4. Click Next.
  
  The Java Home screen appears.
Verify and update the Java Home path.
Click Next.

The Installation Summary screen appears.
Review the selections you have made in the preceding screens, and click Install.

The Installation Progress screen appears.
You can view the installation progress.

On successful installation of Unified Inventory Management, the End of Installation Complete screen appears.

Note:

Record the URL that is displayed in the End of Installation screen, to access UIM.
(For installing UIM without using a shared storage) Zip the <Domain_Home>/bin and <Domain_Home>/UIM directories on node 1 and unzip them on node 2.

Note:
You need to zip the <Domain_Home>/bin and <Domain_Home>/UIM directories on node 1 and unzip them on node 2 for all UIM upgrade or patch installations.
Perform the UIM post-installation tasks. See "Unified Inventory Management Post-Installation Tasks" for more information.
Restart the Administration server by using the following command from within the Domain_Home/bin directory:
```
./startUIM.sh 
```
Note:

For clustered deployments, you need to edit the setDomainEnv.sh file and set the WLS_JDBC_REMOTE_ENABLED parameter to true. The setDomainEnv.sh file is located in the Domain_Home/bin directory.

The following is an example of the parameter:

WLS_JDBC_REMOTE_ENABLED="-Dweblogic.jdbc.remoteEnabled=true"
Start the managed server by using the following command:
```
./startUIM.sh Managed_Server_Name Admin_URL
```

For information on verifying the successful installation of UIM, see "Verifying the Unified Inventory Management Installation".

Installing UIM Using Silent Mode

Use silent mode when you are installing UIM using the same configuration repeatedly. Silent mode does not use the installer UI, instead it uses a response file that must be setup with the configuration values required for your specific installation. Silent install runs in the background and is not visible to the user.

About the Response File

The installer uses a response file, which contains a predefined set of values, such as server connection details.

The response file template: oracle.communications.inventory.rsp comes as a part of the UIM installation package.

The following response file template contains all the fields that the installer requires to perform installation in silent mode:

uim/Disk1/stage/Response

When you extract the installer JAR file, the response file template is saved in the Response directory at the location: Disk1/stage/Response.

Populating the Response File

The following tables show the UIM response file template properties and the corresponding values that should be specified for a complete installation scenario.

Installation Location Details (Required)

Property Name	Description (with Default Value)
ORACLE_HOME	Provide Domain_Home location.

Installation Type Details (Required)

Property Name	Description (with Default Value)
INSTALLATION_TYPE	Type of installation. The allowed values are Complete or Upgrade. Set Install for a fresh installation.

Weblogic Admin Server Connection Details (Required)

Property Name	Description (with Default Value)
APP_ADMIN_HOST	The hostname or IP address of the WebLogic Admin Server.
APP_ADMIN_PORT	The port number for the WebLogic Admin Server (enclose in double quotes). For SSL-based deployment, provide the SSL port value and specify the keystore file location in the `APP_SERVER_KEYSTORE` property.
APP_SERVER_USER	The user name for the WebLogic Admin Server.
APP_SERVER_PASSWD	The password for the WebLogic Admin Server.
APP_SERVER_KEYSTORE	The path to the keystore file required for SSL-based deployment (for example, certs/Keystore.jks).

Target Selection Details (Required)

Property Name	Description (with Default Value)
APP_TARGET_NAME	Name of the target (such as `AdminServer` or `CL1`) where UIM will be installed.

Database Selection Details (Required)

Property Name	Description (with Default Value)
DATABASE_TYPE	Type of the database used (Accepted values: Standard Oracle Enterprise Database or Oracle Real Application Cluster Database).

Standard DB Details (Required only if DATABASE_TYPE = Standard Oracle Enterprise Database)

Property Name	Description (with Default Value)
DB_HOST_NAME	The hostname of the standard Oracle database.
DB_HOST_PORT	The port number of the standard Oracle database (enclose in double quotes).
DB_USER_NAME	The user name with SYSDBA privileges for the standard Oracle database.
DB_PASSWORD	The password for the SYSDBA user of the standard Oracle database.
DB_SERVER_SERVICE	The service name of the standard Oracle database.

RAC DB Details (Required only if DATABASE_TYPE = Oracle Real Application Cluster Database)

Property Name	Description (with Default Value)
RAC_CONNECTION_STRING	The connection string details for Oracle RAC, in the format: HostName1:Port1:Service1,HostName2:Port2:Service2.
RAC_SERVER_USER	The user name for connecting to the Oracle RAC database.
RAC_SERVER_PASSWORD	The password for the Oracle RAC database server.

Schema Creation Details (Required only if INSTALLATION_TYPE=Complete)

Property Name	Description (with Default Value)
DB_SCHEMA	The flag to indicate whether to create the UIM schema (Allowed values: "`true`" or `false`). For fresh installation, provide `true`. In case you want to use some existingUIM schema, provide `false`.

Store Type Details (Required only if DB_SCHEMA=”true”)

Property Name	Description (with Default Value)
STORE_CHECK	Provide "`true`" if you want to use File Store, else provide "`false`" if you want to use JDBC Store (required only if DB_SCHEMA=”`true`” and the value must be enclosed in double quotes).

UIM Schema Details (Required; TableSpace not required if DB_SCHEMA=”false”)

Property Name	Description (with Default Value)
APP_SCHEMA_USER	Provide the name of new UIM schema to be created if DB_SCHEMA=”`true`” or In case DB_SCHEMA=”`false`”, then provide the name for existing UIM schema.
APP_SCHEMA_PASS	Provide the password for the new UIM schema to be created if DB_SCHEMA=”`true`” or In case DB_SCHEMA=”`false`”, then provide the password for existing UIM schema.
APP_SCHEMA_SYSTABLESPACE	Provide the System Tablespace (required only if DB_SCHEMA=”`true`”).
APP_SCHEMA_TABLESPACE	Provide the Temp Tablespace (required only if DB_SCHEMA=”`true`”).

Security Provider Selection Details (Required)

Property Name	Description (with Default Value)
SECURITY_PROVIDER_NAME	Type of the security provider to select (Allowed values: `Embedded_LDAP` or `External_LDAP`).

Embedded LDAP Details (User creation is optional; values can be left empty even if SECURITY_PROVIDER_NAME is set to Embedded LDAP)

Property Name	Description (with Default Value)
LDAP_USER_NAME	The user name to be created in the embedded LDAP directory
LDAP_PASSWD	The password for the newly embedded LDAP user Note: Password requirements: Length must be between 8 to 12. It should contain at least one uppercase letter, one lowercase letter, one number and one special character. It must not contain user name directly or in reverse No character can appear more than 4 times in total or more than 3 times in a row.

Property Name

Description (with Default Value)

LDAP_USER_NAME

The user name to be created in the embedded LDAP directory

LDAP_PASSWD

The password for the newly embedded LDAP user

Note:

Password requirements:

Length must be between 8 to 12.
It should contain at least one uppercase letter, one lowercase letter, one number and one special character.
It must not contain user name directly or in reverse
No character can appear more than 4 times in total or more than 3 times in a row.

External LDAP Details (Required only if SECURITY_PROVIDER_NAME=External LDAP)

Property Name	Description (with Default Value)
LDAP_SERVER_HOST	The hostname of the external LDAP server.
LDAP_SERVER_PORT	The port number of the external LDAP server.
LDAP_SERVER_USER	The user name for connecting to the external LDAP server.
LDAP_SERVER_PASSWORD	The password for the external LDAP server user.
LDAP_USER_BASE_DN	The user BASE DN information of external LDAP server.
LDAP_GROUP_BASE_DN	The group BASE DN information of external LDAP server.
LDAP_SERVER_KEYSTORE	The path to the keystore file for the external LDAP server (for example: certs/externalLDAPKeystore.jks).

CMWS User Details (Required)

Property Name	Description (with Default Value)
INPUT_CMWS_USERNAME	The user name to be created for CMWS User
INPUT_CMWS_USERPASSWORD	The password for the CMWS user Note: Password requirements: Length must be between 8 to 12. It should contain at least one uppercase letter, one lowercase letter, one number and one special character. It must not contain user name directly or in reverse No character can appear more than 4 times in total or more than 3 times in a row.

Property Name

Description (with Default Value)

INPUT_CMWS_USERNAME

The user name to be created for CMWS User

INPUT_CMWS_USERPASSWORD

The password for the CMWS user

Note:

Password requirements:

Length must be between 8 to 12.
It should contain at least one uppercase letter, one lowercase letter, one number and one special character.
It must not contain user name directly or in reverse
No character can appear more than 4 times in total or more than 3 times in a row.

Note:

Before using the response file, ensure that any optional properties or values not required by the installer are left empty. When you provide a Boolean value (true or false) or any pure integer value such as port number, enclose the values inside double quotes.

Starting Silent Install

Before you begin installing UIM by using silent install, ensure that you have provided all required input values in the response file template.

To install UIM by using silent install:

Download the required version of Java. See “Installing the Oracle JDK” for more information.
Set the JAVA_HOME environment variable.
Use the following command to start the installation, where path is the response file location:
```
java -jar UnifiedInventoryManagementInstaller -responseFile path
```
Where path is the response file location.

The installation will run silently in the background.
When the installation completes, manually shut down all of the servers.
Perform the UIM post-installation tasks. See "Unified Inventory Management Post-Installation Tasks" for more information.
Restart the Administration server by using the following command from within the Domain_Home/bin directory:
```
./startUIM.sh
```
Restart the managed servers by using the following command:
```
./startUIM.sh Managed_Server_Name Admin_URL
```
After the installation is complete, open the following file to get the URL to access UIM:

Domain_Home/UIM/install/readme.txt
Copy and paste the URL in a Web browser and press Enter to access UIM.

You can now access the UIM application.

For information on verifying the successful installation of UIM, see "Verifying the Unified Inventory Management Installation".