Skip Headers
Oracle® Communications Network Integrity Installation Guide
Release 7.2.2

Part Number E36031-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

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:

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.

See "Installing and Configuring the Oracle Database" and "Installing and Configuring Oracle WebLogic Server".

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 in the GUI Mode

To install Network Integrity in the GUI mode, using the Installer:

Note:

The installer does not include the JRE component. Download the latest version of the JRE from the Oracle Technology Network web site.
  1. Create a temporary directory (dir).

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

    https://edelivery.oracle.com

    and save it to dir:

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

    Note:

    The Network Integrity installation will fail due to an Out of Memory error. To fix this issue perform the following:

    For Standalone Installations:

    1. Navigate to the oraparam.ini file, located in integrity/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 -Djavax.xml.rpc.ServiceFactory=org.apache.axis.client.ServiceFactory"
      

    For Server Cluster Installations:

    1. Navigate to the clusterparam.ini file, located in integrity/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 -Djavax.xml.rpc.ServiceFactory=org.apache.axis.client.ServiceFactory"
      

    Note:

    Ensure that WebLogic Administration Server and all managed servers are up and running before starting the installation.
  4. Run the Oracle Universal Installer using the following command:

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

    Where jre_Path is the JRE location.

    The Installer Welcome screen appears.

  5. Click Next.

    The Select a Product to Install screen appears.

  6. Select Install Network Integrity and 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 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 unselect 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 standalone managed server, the  Database Type Selection screen appears.

      Skip the next step.

      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 11g 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 11g 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 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. Specify whether to close the plain-text, non-SSL listen port for Network Integrity and click Next.

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

    The Reporting Tool Connection (Optional) screen appears.

  16. 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 Network Integrity User Information (Optional) screen appears.

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

      Skip to step 19.

  17. In the Network Integrity User Information (Optional) screen, do the following:

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

      This user accesses and uses Network Integrity.

    2. In the Network Integrity 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 Disable Unsecured Listen Port screen appears.

  18. In the Reporting Tool Connection (Optional) screen, 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.

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

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

    The Install screen appears.

  21. 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 Server, 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 URL that is displayed in the End of Installation screen, to access Network Integrity.
  22. Follow any on-screen instructions to complete the installation.

    You can now access the Network Integrity application.

  23. Click Exit to close the Installation Wizard.

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

Note:

After installing Network Integrity on a cluster server, perform the following:

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

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

./startWebLogic.sh

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

./startManagedWebLogic.sh cluster_managed_server_name admin_server_URL

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 jdk_Path/jre_Path
      

      Where Path is the response file location and jdk_Path/jre_Path is the JDK or JRE location.

  • 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 jdk_Path/jre_Path
    

    Where Path is the response file location and jdk_Path/jre_Path is the JDK or JRE location.

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