6 Installing Network Integrity

This chapter describes how to install Oracle Communications Network Integrity. Before installing Network Integrity, read these chapters:

Types of Installation

There are two types of Network Integrity installation:

Caution:

If the installation fails for some reason, you must create a new WebLogic domain and a new database user before you begin installation again.

See "Installing and Configuring the Oracle Database" and "Installing and Configuring Oracle WebLogic Server" for more information.

Caution:

The Network Integrity Installer must be launched from the same system as the one hosting the Administration server of your domain.

Installing Network Integrity by Using Interactive Install

To run the Network Integrity installer, the Java Runtime Environment (JRE) must already be installed. See "Required Software" for more information about the required Java version.

To install Network Integrity:

  1. Create a directory (dir).

  2. Download the software for your operating system from the Oracle software delivery website:

    https://edelivery.oracle.com

    and save it to dir:

  3. Extract the contents of the software pack to dir.

  4. Run the Oracle Universal Installer using the following command:

    /dir/integrity/Disk1/install/runInstaller -jreloc jre_Path
    

    where jre_Path contains the jre folder inside the Java Development Kit (JDK) installation directory.

    The Installer Welcome screen appears.

  5. Click Next.

  6. One of the following screens is displayed:

    • If Network Integrity is the first Oracle product that you are installing on the system, the Specify Inventory directory and credentials screen appears. Enter the full path of the inventory directory, select the Operating System group name, and then click Next.

      The Select Installation Type screen appears. Continue with step 7.

      Note:

      The inventory directory manages all Oracle products installed on your system.
    • If you have installed any Oracle products on the system prior to installing Network Integrity, the Select Installation Type screen appears. Continue with step 7.

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

    • If you select Complete, the Specify Home Details screen appears.

      Skip the next step.

    • If you select Custom, the Available Product Components screen appears.

      Continue with the next step.

  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 a name to identify your installation as an Oracle Product in OUI.

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

      Note:

      You can also select the name for the installation from the list of names the Installer provides or browse to the location.
    3. Click Next.

    The WebLogic Administration Server Connection Information screen appears.

  10. Do the following:

    1. In the Host Name field, enter the IP address or the host name of the Administration Server.

    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 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 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 Network Integrity, and click Next.

    • If you select Administration server, or a managed server, the  Database Type Selection screen appears.

      Skip to step 13.

      Note:

      If you select a managed server, ensure that the managed server and the node manager are running.
    • If you select a cluster server, the Cluster Member Server Selection screen appears.

      Continue with the next step.

  12. In the Cluster Member Server Selection screen, select a cluster member for Network Integrity adapters installation, and click Next.

    The Database Type Selection screen appears.

  13. In the Database Type Selection screen, do one of the following.

    • Select the Standard Oracle 12c Enterprise Database option.

      The Database Connection Information screen appears.

      Do the following:

      1. In the Host Name field, enter the IP address or the host name of the system where the database server is installed.

      2. In the Port Number field, enter the port number with which the installer connects 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.

        See "Creating the Database (MetaData) Schema for Network Integrity" 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 that uniquely identifies your database on the system.

      6. Click Next.

        The Network Integrity Schema User Information screen appears.

    • Select the Oracle 12c Real Application Cluster Database option.

      The RAC DB Nodes Connection Information screen appears.

      Do 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 NAME1;HOST NAME2:PORT2:SERVICE NAME2

      2. In the User Name field, enter the user name for the Oracle RAC database server.

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

      4. Click Next.

        The Network Integrity Schema User Information screen appears.

  14. In the Network Integrity Schema User Information screen, do the following:

    Note:

    Ensure that the schema owner has an associated MetaData Services (MDS) schema.

    Caution:

    You must use the same user name and password that you created during the MetaData schema creation. See "Creating the Database (MetaData) Schema for Network Integrity" for more information.
    1. In the Schema User Name field, enter the name for the MDS schema user.

    2. In the Schema User Password field, enter the password for the MDS schema user to access the schema.

    3. Click Next.

      The Security Provider Selection screen appears.

  15. Select the type of security provider you want to use by performing one of the following steps:

    • Select the Default WebLogic Security Provider (Embedded_LDAP) option, and click Next.

      The Network Integrity User Information screen appears.

    • If you select External Security Provider, the External Security Provider Connection Information screen appears.

      Do 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. Click Next.

        The NI Administrator user creation (Optional) screen appears.

    • If you select Other Security Provider, and click Next, the Reporting Tool Connection (Optional) screen appears.

      Skip to step 20.

  16. In the NI Administrator user creation (Optional) screen, do the following:

    1. In the User Name field, enter the user name for the Network Integrity user.

      This user accesses and uses Network Integrity.

    2. In the Password field, define a password for the Network Integrity user.

      Note:

      The Network Integrity user password can be a maximum of 12 characters long, and should contain at least one digit, one capital letter, and one non alpha-numeric value; For example, Weblogic@123.

      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 NI User ni-internal secure credentials screen appears.

  17. Do the following:

    1. In the User Password field, define a password for the Network Integrity internal user.

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

    2. Click Next.

      The Disable Unsecured Listen Port screen appears.

  18. Select whether or not to disable the unsecured listen port by doing one of the following:

    • Select Yes if you are configuring Network Integrity to communicate and listen over SSL-enabled ports.

    • Select No if you are not configuring Network Integrity to communicate and listen over SSL-enabled ports.

  19. Click Next.

    The Reporting Tool Connection (Optional) screen appears.

  20. Enter the names of, and links to, the reporting tool(s) you have configured, and click Next.

    Note:

    This is an optional screen. If you do not have any reporting tools configured, click Next to continue with the installation.

    The Launch Cartridge Deployer (Optional) screen appears.

  21. Select whether to launch the Cartridge Deployer and click Next.

    Note:

    This is an optional screen that only appears for systems installed on the Linux or Solaris operating systems. Clicking Next takes you to the next screen if you do not want to make this choice now.

    Selecting Yes launches the Cartridge Deployer Tool after the successful installation of Network Integrity.

    The Summary screen appears.

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

    The Install screen appears.

  23. You can view the installation progress.

    Note:

    During the installation progress, two popup messages will appear.

    The first popup message asks for the confirmation to stop the WebLogic Servers, click OK.

    The second popup message gives the order in which the servers should be restarted manually. Start the servers, in order listed in the popup message, and click OK, only after all the servers are started.

    On successful installation of Network Integrity, the End of Installation screen appears.

    Note:

    Record the URLs that are displayed in the End of Installation screen, to access Network Integrity.
  24. Follow any on-screen instructions to complete the installation.

    You can now access the Network Integrity application.

  25. Click Exit to close the Installation Wizard.

  26. For a Cluster Server installation, do the following:

    1. Edit the startWebLogic.sh file under Domain_Home/bin/ directory.

      ${JAVA_HOME}/bin/java ${JAVA_VM} ${MEM_ARGS} -Dweblogic.Name=${SERVER_NAME}

      -Dweblogic.wsee.useRequestHost=true

      -Djava.security.policy=${WL_HOME}/server/lib/weblogic.policy ${JAVA_OPTIONS}

      ${PROXY_SETTINGS} ${SERVER_CLASS}

      ${JAVA_HOME}/bin/java ${JAVA_VM} ${MEM_ARGS} -Dweblogic.Name=${SERVER_NAME}

      -Dweblogic.wsee.useRequestHost=true

      -Djava.security.policy=${WL_HOME}/server/lib/weblogic.policy ${JAVA_OPTIONS}

      ${PROXY_SETTINGS} ${SERVER_CLASS} >"${WLS_REDIRECT_LOG}" 2>&1

    2. Stop the AdminServer and restart, using the following command:

      ./startWebLogic.sh

    3. Stop the managed servers and restart, using the following command:

      ./startManagedWebLogic.sh cluster_managed_server_name admin_server_URL

For information on verifying the successful installation of Network Integrity, see "Verifying the Network Integrity Installation".

Installing Network Integrity in Silent Mode

Use silent install mode when you are installing Network Integrity using the same configuration repeatedly. Silent install mode does not use the GUI and it runs in the background.

About the Response File

The Network Integrity installer uses a response file, which contains a pre-defined set of values, such as server connection details. The response file comes in a template form, to install Network Integrity in silent mode.

The following two response file templates come as part of the Network Integrity installation package:

  • oracle.communications.ni.Complete.rsp

    Use this file template if you are doing a complete installation.

  • oracle.communications.ni.Custom.rsp

    Use this file template if you are doing a custom installation.

The response file templates contain all the fields that the installer requires values for to connect to various servers during the silent, unattended installation.

When you untar the Network Integrity package, the response file templates are saved in the Response folder at the following location:

integrity/Disk1/stage/Response

Populate the response file with the required server and connection values for the installer to use during installation, before you begin the silent installation. The provided response file is a template with pre-defined places where you fill in the required values of the required type. Shown here is sample section of a response file:

#Name       : DATABASE_TYPE
 #Datatype   : String
 #Description: 
 #Example: DATABASE_TYPE = 
 #---------------------------------------------------------------
 DATABASE_TYPE="Non Clustered-DB" 
#---------------------------------------------------------------
#Name       : MANAGED_SERVER_NAME
#Datatype   : String
#Description: 
#Example: MANAGED_SERVER_NAME = 
#---------------------------------------------------------------
MANAGED_SERVER_NAME="Managed_Server_1" 

In this section of the response file sample, you would provide values for the following:

DATABASE_TYPE=
MANAGED_SERVER_NAME=

Similarly, provide values for all variables described in the response file.

Populating the Response File

You can populate the response file in the following ways:

  • Recording the response file contents during a GUI installation

    To record the response file contents during a GUI installation:

    1. Use the following command to launch the Network Integrity installer and also record all input values you provide during the installation:

      ./runInstaller -record -destinationFile Path -silent -jreloc jre_Path
      

      where jre_Path contains the jre folder inside the JDK installation directory.

  • Manually populating the response file

    To populate the response file manually:

    1. Go to the following location:

      integrity/Disk1/stage/Response

    2. Open the appropriate RSP template and make a copy for your current requirement.

    3. Enter the required input values in the provided locations.

Starting Silent Mode Installation

Before you begin installing Network Integrity in silent mode, ensure that you have provided all required input values in the response file template.

To install Network Integrity in silent mode:

  1. Use the following command, where path is the response file location, to start the installation:

    ./runInstaller -responseFile Path -silent -jreloc jre_Path
    

    where jre_Path contains the jre folder inside the JDK installation directory.

    The installation runs silently in the background.

    Note:

    The installer shuts down all of the servers, including the Administration Server and the Managed Servers, after a silent installation. Start all of the servers manually after the installation is complete. See "Starting the Cluster Member Servers".
  2. Open the following file once the installation is complete, to get the URL to access Network Integrity:

    NI_Home/install/readme.txt

    For example: /opt/integrity/Oraclecommunications/install/readme.txt

  3. Copy the URL and paste it in the browser window's address field and press Enter to access Network Integrity.

    You can now access the Network Integrity application.

For information on verifying the successful installation of Network Integrity, see "Verifying the Network Integrity Installation".