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
PDF · Mobi · ePub

12 Troubleshooting the Network Integrity Installation

This chapter describes how to troubleshoot the Oracle Communications Network Integrity installation. For more information on troubleshooting Network Integrity, see Network Integrity System Administrator's Guide. To verify that the installation was successful, see "Verifying the Network Integrity Installation".

Common Problems and Their Solutions

This section describes the following installation problems, and how to resolve them:

Problem: Installer Fails to Update Application KEYSTORE Table

If the installer fails to update the application KEYSTORE table, the installer is interrupted and the following error message appears:

Unable to update application key store 'AppKeyStore', please check log files for more details. Refer to Network Integrity documentation for executing this step manually.

Solution

Click the Continue button to complete the installation. Manually update the application KEYSTORE table when the installation is complete.

To manually update the application KEYSTORE table:

  1. Navigate to NI_Home/POMSClient.

  2. Execute the following command:

    JRE_Home/bin/java -javaagent:lib/eclipselink.jar -cp POMSClient.jar oui.j2ee.poms.client.UpdateAppKeyStore DB_HostName DB_Port DB_ServiceName NI_Schema_UserName NI_Schema_Password default aes 128
    

    Where jre_home is the location of the JRE, DB_HostName is the database host name, DB_Port is the database port number, DB_ServiceName is the database service name or system ID, NI_Schema_UserName is a valid Network Integrity database user name for the schema, and NI_Schema_Password is the password for the Network Integrity schema user name.

  3. Connect to the application KEYSTORE table and verify the following:

    • That the COMPONENT column has a value of default.

    • That the ENCRYPTALGORITHM column has a value of aes.

    • That the KEYLENGTH column has a value of 128.

  4. Restart Network Integrity for the changes to take effect, as explained in Network Integrity System Administrator's Guide.

Problem: Installer Fails to Update Application INFORMATION Table

If the installer fails to update the application INFORMATION table, the installer is interrupted and the following error message appears:

Unable to update application details 'ApplicationInfo', please check log files for more details. Refer to Network Integrity documentation for executing this step manually.

Solution

Click the Continue button to complete the installation. Manually update the application INFORMATION table when the installation is complete.

To manually update the application INFORMATION table:

  1. Navigate to NI_Home/POMSClient.

  2. Execute the following command:

    JRE_Home/bin/java -javaagent:lib/eclipselink.jar -cp POMSClient.jar oui.j2ee.poms.client.UpdateAppInfoTable DB_HostName DB_Port DB_ServiceName NI_Schema_UserName NI_Schema_Password "Network Integrity" NI_Version SUCCESS
    

    where:

    • jre_home is the location of the JRE

    • DB_HostName is the database host name

    • DB_Port is the database port number

    • DB_ServiceName is the database service name or system ID

    • NI_Schema_UserName is a valid Network Integrity database user name for the schema

    • NI_Schema_Password is the password for the Network Integrity schema user name

    • NI_Version is the version of Network Integrity being installed

  3. Connect to the application INFORMATION table and verify the following:

    • That the NAME column has a value of Network Integrity.

    • That the VERSION column has the correct version of Network Integrity.

    • That the STATUS column has a value of SUCCESS.

Problem: Inability To Run Scans or Resolve Discrepancies After Upgrading

After upgrading Network Integrity, you may be unable to run scans or resolve discrepancies using cartridges if you have unmigrated cartridges still deployed to your system.

To confirm that you are experiencing this issue, verify the following:

  • Network Integrity displays the following error messages when you try to run a scan:

    Unable to start scan, as cartridge is in the process of getting deployed or undeployed.
     
    
  • Network Integrity displays the following error messages when you try to resolve discrepancies:

    All Plugins are not ready. Cartridge deploy or undeploy is in progress.
    
  • The DisPlugin database table has the value 0 set for the pluginready attribute for some cartridges.

Solution

Resolve this issue by doing the following:

  • Migrate all deployed, unmigrated cartridges that you are licensed and permitted to migrate.

  • Run the Troubleshoot_delete_unused_plugins_post_upgrade.sql script to delete the remaining unmigrated cartridges from your system:

    1. In Network Integrity, delete all scan configurations related to unmigrated cartridges.

    2. From the command prompt, go to the NI_Home/integrity/upgrade/migration directory.

    3. Enter the following command, to execute the script as the Network Integrity MDS DB schema user, using sqlplus:

      Troubleshoot_delete_unused_plugins_post_upgrade.sql
      
    4. Follow the command-line prompts.

      The script deletes all cartridges from the system that have a pluginready value of 0 in the DisPlugin database table.

    5. Restart Network Integrity.

    6. Run a test scan to confirm that the issue is resolved.

Reporting Problems

Before calling Oracle Global Support, read the description of preparing to call Global Support in the Troubleshooting chapter in Network Integrity System Administrator's Guide.