5 Installing Unified Inventory Management

About the UIM Installer

You install UIM using the Oracle Universal Installer. This UI-based 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 by Using Interactive Install".

• 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 by Using Silent Install".

Installing UIM by Using Interactive Install

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

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 interactive install:

1. Download the latest version of the JRE, which is contained in the JDK. See "Installing the Oracle JDK" for more information.

2. Create a temporary directory (temp_dir).

3. Download the software pack for your operating system from the Oracle software delivery website and save it to temp_dir:

4. Unzip the software pack in a folder of your choice using the following command:

   unzip UnifiedInventoryManagement-Release-OS.zip
   

   where Release is the version of UIM, and OS is your operating system.

   The uim/Disk1/install/ folder structure is created.

   Note:

   For Solaris and Linux x86 installations, the UIM installation will fail due to an Out of Memory error. To fix this issue perform the following:

   1. Navigate to the oraparam.ini file, located in the uim/Disk1/install/folder.

   2. Open the file and locate the JRE_MEMORY_OPTIONS parameter.

   3. Change the default value for the JRE_MEMORY_OPTIONS parameter to the following:

      JRE_MEMORY_OPTIONS="-d64 -mx256m -XX:MaxPermSize=512m"

5. Run the Oracle Universal Installer executable file runInstaller using the following command:

   ./runInstaller -jreloc jre_Path
   

   Where jre_Path is the JRE location.

   Note:

   The installer can also be run by specifying the install user group and Oracle Inventory directory location.

   ./runInstaller.sh -invPtrLoc ~/orainst.loc

   where orainst.loc contains:

   inst_group=uimcluster

   inventory_loc=/share/uimcluster/oraInventory

   The Welcome screen of the installation wizard appears.

6. 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.

7. Select the type of UIM installation you require, and click Next.

   • If you select Complete, this option installs all the components. The  Specify Home Details screen appears.

     Skip to step 8.

   • If you select Custom, this option allows you to specify which components to install. This option is used for UIM upgrades. The Available Product Components screen appears.

     Continue with step 7.

8. In the Available Product Components screen, select the components you want to install, and click Next.

9. In the Specify Home Details screen, do the following:

   1. In the Name field, enter an appropriate name for the folder that will contain all of the installation files.

   2. In the Path field, enter the path to the folder where you want to install UIM.

      Note:

      You can also select the name for the installation from the list of names the installer provides.

      You can also browse for the path where UIM will be installed from the provided list using the explorer UI.

   3. Click Next.

   The WebLogic Administration Server Connection Information screen appears.

10. 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 WebLogic Server/Cluster Selection screen appears.

11. 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 the managed server and the node manager are running.

12. Select the option for the database type to be used and click Next.

    • If you select Standard Oracle 12c Enterprise Database, the MDS Schema information screen appears. Proceed to step 14.

    • If you select Oracle 12c Real Application Clusters Database, the RAC DB for MDS screen appears. Proceed to step 12.

13. Enter the Oracle RAC DB for MDS Schema information, by doing the following:

    1. In the RAC Database Connection String field, enter the MDS schema information to connect to the Oracle RAC database.

       For example:

       HOST_NAME1:PORT1:SERVICE_NAME; HOST_NAME2:PORT2:SERVICE_NAME

       Caution:

       You must use the same user name and password provided when the UIM MDS schema was created.

    2. In the User Name field, enter the prefix_MDS schema user name.

    3. In the Password field, enter the password for the user name that you provided in the User Name field.

    4. Click Next.

    The Oracle RAC Database Nodes Connection Information screen appears.

14. 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 server.

       Note:

       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.

    3. In the Password field, enter the password for the user name that you provided in the User Name field.

    4. Click Next.

       The UIM Administrator user creation (Optional) screen appears.

       Proceed to step 21.

15. Enter the MDS Schema 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 MDS schema.

    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 Database Connection Information screen appears.

16. 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 server.

       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 (MetaData) 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 UIM database schema creation screen appears.

17. Select whether or not to create the UIM database schema and click Next.

    Caution:

    Ensure the user has the database privileges mentioned in the previous step 0 0

    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).

    The Unified Inventory Management Schema Information screen appears.

18. 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.

19. Select the security provider you want to use and click Next.

    • If you select the default WebLogic security provider (Embedded_LDAP) option, the CMWS User Information screen appears. Continue with step 20.

    • If you select the external security provider option (External_LDAP), the External Security Provider Connection Information screen appears. Continue with step 19.

20. 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.

21. 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 the password for the user name that you provided in the User Name field.

    3. In the Confirm Password field, enter the password again.

    4. Click Next.

       The UIM Administrator user creation (Optional) screen appears.

22. 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 can be a maximum of 12 letters long, and should contain at least one numeric value and one capital letter. For example, Weblogic123.

       Also, the user name must not be part of the password.

       In the Confirm Password field, enter the password again, to confirm it.

    3. Click Next.

       The Do you want to create the UIM file store or JDBC store? screen appears.

23. Select the type of store to create, and click Next.

    Note:

    If File Store is selected, a file store (inv_jms_store) is created at the Domain_Home/UIM location.

    The SSL enable Information screen appears.

24. Select whether or not to enable SSL, and click Next.

    Note:

    If you select Yes, enter the Port number and click Next.

    The MapViewer information screen appears if MapViewer was installed.

25. (Optional if MapViewer was installed) In the URL field, enter the URL for MapViewer.

26. Click Next.

    The Summary screen appears.

27. Review the selections you have made in the preceding screens, and click Install.

    The Install screen appears.

28. You can view the installation progress.

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

    Note:

    Record the URL that is displayed in the End of Installation screen, to access UIM.

29. Install and configure the AspectJ libraries, which are not included in the UIM installation. To do this:

    1. Download the aspectj-1.8.10.jar library from the following website:

       http://www.eclipse.org/aspectj/downloads.php

    2. Extract the aspectj-1.8.10.jar file to a temporary folder (aspectj-1.8.10), by entering the following command:

       java -jar aspectj-1.8.10.jar
       

       Note:

       Ensure that the AspectJ files (aspectjweaver.jar, aspectjrt.jar, and aspectjtools.jar) have execute permissions.

    3. Copy the aspectjweaver.jar file from the aspectj-1.8.10/lib folder to the UIM_Home/lib folder.

       Note:

       The following step is required if dynamic extensibility (for custom extension points) is to be used.

    4. Copy the aspectjrt.jar and aspectjtools.jar files from the aspectj-1.8.10/lib folder to the UIM_Home/lib folder.

30. Perform the UIM post-installation tasks. See "Unified Inventory Management Post-Installation Tasks" for more information.

31. Restart the Administration server by using the following command from within the Domain_Home/bin directory:

    ./startWebLogic.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"

32. 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 by Using Silent Install

Use silent install when you are installing UIM using the same configuration repeatedly. Silent install 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.

#Name       : DATABASE_TYPE
#Datatype   : String
#Description: Enter the database type whether Clustered or Non-Clustered DB. The value should be string containing database type. 
#Example: DATABASE_TYPE="&Standard Oracle 12c Enterprise Database" (for Non-RAC database) or DATABASE_TYPE="Oracle 12c &Real Application Clusters Database" (for RAC database) 
#---------------------------------------------------------------
DATABASE_TYPE=
#---------------------------------------------------------------
#Name       : MANAGED_SERVER_NAME
#Datatype   : String
#Description: Name of the managed server.
#Example: MANAGED_SERVER_NAME="Managed_Server_1" 
#---------------------------------------------------------------
MANAGED_SERVER_NAME= 
#---------------------------------------------------------------
#Name       : RAC_DB_COUNT
#Datatype   : String
#Description: Number of hosts in the Oracle RAC database.
#Example: RAC_DB_COUNT="2" 
#---------------------------------------------------------------
RAC_DB_COUNT= 
#---------------------------------------------------------------
#Name       : MDS_RAC_DB_COUNT
#Datatype   : String
#Description: Number of hosts in the Oracle RAC database.
#Example: MDS_RAC_DB_COUNT="2" 
#---------------------------------------------------------------
MDS_RAC_DB_COUNT= 

DATABASE_TYPE=
MANAGED_SERVER_NAME=
RAC_DB_COUNT=
MDS_RAC_DB_COUNT=
#---------------------------------------------------------------