9 Upgrading Network Integrity

This chapter explains how to upgrade your existing system to the latest release of Oracle Communications Network Integrity.

This chapter explains how to recover your system after an upgrade failure. See "About Rolling Back Network Integrity" for more information.

About Upgrading Network Integrity

Upgrading to a new release of Network Integrity consists of the following tasks:

Before upgrading a production environment, you should first test the upgrade in a test environment. See "Testing the Upgrade in a Test Environment" for more information.

In this chapter, the release you are upgrading from is called the old release, the release you are upgrading to is called the new release.

Supported Upgrade Paths

This release of Network Integrity supports the following direct upgrade paths:

  • From release 7.3.0 to release 7.3.5

  • From release 7.3.2 to release 7.3.5

See "Upgrading Network Integrity" for more information.

Planning Your Upgrade

Depending on the components affected by the upgrade, your upgrade team may include the following:

  • A database administrator, to manage the database upgrade and tune the database.

  • A system integrator, to handle new and existing customizations.

  • A system administrator, to manage the Oracle WebLogic Server and Network Integrity software upgrade.

  • A UNIX administrator, to manage accounts, network setup, and IP configurations.

Identify who might be affected by the upgrade. For example:

  • You might need to give your system administrators and Network Integrity users notice of any system downtime.

  • Tell your system administrators in advance about any changes to the system architecture (for example, Oracle database, client, or WebLogic Server upgrades).

  • Train your administrators, users, cartridge developers, or system integrators on new functionality introduced by the upgrade that has an impact on their role.

You might need to make changes to your system after the upgrade is complete to accommodate new or modified features or functionality. For example, if the new release provides new security functionality, additional system configuration steps may be required. See "Upgrade Impacts" for more information.

The best way to estimate the duration of an upgrade is to perform the upgrade procedure on a test system with a copy of the production data. See "Testing the Upgrade in a Test Environment" for more information.

It is not necessary to shut down Network Integrity or the Network Integrity WebLogic Server domain before an upgrade. However, you must ensure that Network Integrity is not running any operations, such as scans or blackouts.

Oracle recommends scheduling your upgrade during non-peak hours to minimize the disruption to your operations.

Testing the Upgrade in a Test Environment

Oracle recommends running the upgrade procedure on a test system with a copy of your production data before upgrading your production system. Test the upgrade by doing the following:

  • Successfully completing all the pre-upgrade, upgrade, and post-upgrade tasks.

  • Comparing the default behavior between the old and the new releases.

  • Recreating any custom configurations and extensions.

  • Confirming that all new behavior and functionality works.

  • Ensuring that the database tables are properly installed.

  • Ensuring that the database data is correct.

  • Starting the WebLogic Server domain.

  • Ensuring that users and user permissions are correct.

  • Ensuring that productized and custom cartridges build and deploy properly.

  • Logging into Network Integrity and verifying the version number of installed components.

Upgrade Impacts

This section explains any important system changes introduced by an upgrade. Upgrading to this version of Network Integrity requires the following system changes:

New features and new functionality are described in Network Integrity Release Notes.

Fusion Middleware Changes

If upgrading from:

  • 7.3.0:You must upgrade your version of Application Development Runtime and apply applicable patches, and install Repository Creation Utility.

  • 7.3.2: You must upgrade your version of Application Development Runtime and apply applicable patches, and install Repository Creation Utility.

See "Software Requirements" for more information.

Java Development Kit Changes

If you are upgrading from either 7.3.0 or 7.3.2, the new version of Network Integrity requires an updated version of the Java Development Kit (JDK) on the Network Integrity application server. See "Software Requirements" for more information.

During the upgrade, you will need to update the Network Integrity domain to point to the new JDK.

WebLogic Server Changes

If upgrading from:

  • 7.3.0: You must upgrade your version of WebLogic Server and apply applicable patches.

  • 7.3.2: You must upgrade your version of WebLogic Server and apply applicable patches.

See "Software Requirements" for more information on software versions.

Database Software Changes

If upgrading from:

  • 7.3.0: You do not need to upgrade your version of the Oracle Database, but you do need to apply applicable patches.

  • 7.3.2: You do not need to upgrade your version of Oracle Database, but you do need to apply applicable patches.

See "Software Requirements" for more information on software versions.

Database Schema Changes

The new version of Network Integrity requires an updated database schema.

Application Component Changes

The Oracle Universal Installer updates all the Network Integrity components.

Design Studio Changes

This version of Network Integrity requires an updated version of Oracle Communications Design Studio. See "Network Integrity System Requirements" for more information.

Design Studio can be set up before or after you upgrade Network Integrity. See the Design Studio installation documentation for more information. Rather than upgrading Design Studio, install the new version and keep the old version until after you have finished upgrading Network Integrity.

Cartridge Changes

You must undeploy cartridges that you do not want to migrate to the new release before beginning the upgrade.

After the upgrade is complete, cartridges must be migrated to the new release of Network Integrity using the Design Studio Cartridge Migration Tool. It is possible that migrated cartridges contain minor compilation errors that prevent them from building and deploying. If a cartridge fails to build, open it in Design Studio and correct any compilation errors.

If you are upgrading from:

  • 7.3.0: The Optical UIM Integration cartridge is enhanced with new scan parameter groups. You must update any Import Optical from UIM and Import Logical Optical scans in Network Integrity.

  • 7.3.2: You do not need to update any Import Optical from UIM or Import Logical Optical scans in Network Integrity.

Upgrading Network Integrity

This section details the upgrade procedures to upgrade Network Integrity:

Pre-Upgrade Tasks (7.3.0 to 7.3.5) or (7.3.2 to 7.3.5)

Pre-upgrade tasks must be performed while the WebLogic server is inactive.

These pre-upgrade tasks apply if your old version of Network Integrity is version 7.3.0 or 7.3.2. Perform and complete all the following pre-upgrade tasks before upgrading Network Integrity:

  1. Back up the Network Integrity and MDS databases. See Network Integrity System Administrator's Guide for more information.

  2. Back up the Network Integrity WebLogic Server domain. See the WebLogic Server documentation for more information.

    Note:

    Verify that the file/folder being backed up meets the file size or path name length requirements for the backup utility being used. For example, the maximum path name length for the tar application is 256 characters.
  3. Upgrade the Fusion Middleware Application Development Runtime:

    • If you are upgrading from either 7.3.0 or 7.3.2, upgrade your version of Fusion Middleware Application Development Runtime and apply any required patches.

    See "Software Requirements" for version information regarding Fusion Middleware Application Development Runtime and any applicable patches.

  4. Upgrade the MDS and OPSS schemas:

    1. Navigate to MW_HOME/oracle_common/upgrade/bin/ua

      where MW_HOME is the directory in which Oracle Fusion Middleware is installed.

      This directory contains the Upgrade Assistant (UA) tool, which you use to upgrade the schema.

    2. Launch the UA tool to upgrade the schema.

      The Welcome screen appears.

    3. Click Next.

      The All Schemas screen appears.

    4. Select Schemas and click Next.

      The Available Components List screen appears showing the Components to be upgraded and select these check boxes, and click Next:

      Oracle Metadata Services
      Oracle Platform Security Services
      
    5. In the Direction field, select the Weblogic domain directory for the upgrade. click Next.

      The Prerequisites screen appears.

    6. Confirm that the database backup is complete by selecting the All affected data is backed up, Database version is certified by Oracle for Fusion Middleware upgrade, and Certification and system requirements have been met check boxes, and click Next.

      The OPSS Schema screen appears.

    7. From the Database Type list, select the database type.

    8. In Database Connect String, enter the hostname:portnumber/SID string.

      Note:

      For a clustered environment, the hostname:portnumber/SID must specify the primary Oracle RAC node.
    9. In DBA User Name, enter the database administrator user name.

    10. In DBA Password, enter the password for the administrator user.

    11. Click Connect.

      If the provided details are valid, the Schema User Name and Schema Password fields become enabled.

    12. From the Schema User Name list, select the OPSS schema.

    13. In Schema Password field, enter the database password, and click Next.

      The MDS Schema screen appears.

    14. From the Database Type list, select the database type.

    15. In Database Connect String, enter the hostname:portnumber/SID string.

      Note:

      For a clustered environment, the hostname:portnumber/SID must specify the primary Oracle RAC node.
    16. In DBA User Name, enter the database administrator user name.

    17. In DBA Password, enter the password for the administrator user.

    18. Click Connect.

      If the provided details are valid, the Schema User Name and Schema Password fields become enabled.

    19. From the Schema User Name list, select the MDS schema.

    20. In Schema Password field, enter the database password, and click Next.

      The Examine screen appears.

    21. Click Next.

      The Upgrade Summary screen appears.

    22. Verify the details of the OPSS and MDS schema to be upgraded and click Upgrade.

      The Upgrading Components screen appears. You can monitor the progress of the upgrade from this screen.

    23. After the upgrade completes, click Next.

      The Upgrade Success screen appears.

    24. Verify that the upgrade was successful and click Close.

      See Oracle Fusion Middleware documentation for more information.

  5. Reconfigure the WebLogic domain configurations using the Fusion Middleware Reconfiguration Wizard, which you open using the following command:

    ./MW_Home/oracle_common/common/bin/reconfig.sh
    
    1. On the Select Domain screen, from the Existing Domain Location list, select the domain that you want to upgrade and click Next.

      The Reconfiguration Setup Progress screen appears, displaying the progress of the reconfiguration setup process.

    2. Click Next.

      The Domain Mode and JDK screen appears.

      The domain mode cannot be changed during reconfiguration. It is inherited from the original domain.

    3. Select the JDK option and browse to the folder (JAVA_HOME) where the JDK is installed and click Next.

      Ensure that you have installed the correct version of the JDK. See "Software Requirements" for more information.

      The Database Configuration Type screen appears.

    4. Select the RCU Data option, complete the required fields, and then click Get RCU Configuration, which retrieves the schema information.

      You select the RCU Data option to connect to the database to retrieve schema information for all schemas that are included in the domain.

    5. Click Next.

    6. Navigate through the different screens by clicking Next on each screen and specify your settings as necessary.

    7. On the Node Manager screen, under the Node Manager Type area, select Manual Node Manager Setup and click Next.

      The Advanced Configuration screen appears.

    8. Select the categories for which you want to perform advanced configuration and click Next.

      For each category you select, the appropriate configuration screen is displayed to allow you to perform advanced configuration.

    9. Navigate through the different screens by clicking Next on each screen and specify your settings as necessary.

    10. On the Deployments Targeting screen, under Targets, select the oracle.communications.inventory application and then click the left arrow, which moves the application to the Deployments section.

    11. On the Deployments Targeting screen, under Deployments, select Library, and then under Targets, select the server or cluster, and then click the right arrow, which moves all the libraries to the targeted server or cluster for deployment.

      Note:

      When targeting applications for deployment on a cluster, ensure that NICMWSAdapter and cartridge_management_ws are selected for only the first managed server of the cluster.
    12. Click Next.

      The Services Targeting screen appears.

    13. Under Services, select all the services, and then under Targets, select the server or cluster, and then click the right arrow, which moves the services to the targeted server or cluster for deployment.

      Note:

      When targeting services to a cluster, ensure that CMWSPersistentDS, CMWSPersistentJDBCStore, and CMWSJMSModule are targeted to only the first managed server of the cluster.
    14. Click Next until the Configuration Summary screen appears.

    15. Review the detailed configuration settings of the domain and click Reconfig.

      The Reconfiguration Progress screen appears, which displays the progress of the reconfiguration process.

      After the reconfiguration process completes, the Reconfiguration Success screen appears.

    16. Click Finish.

      See Oracle Fusion Middleware documentation for more information.

  6. Upgrade the WebLogic domain configurations by doing the following:

    1. Navigate to the MW_Home/oracle_common/upgrade/bin/ua directory.

      This directory contains the Fusion Middleware Upgrade Assistant, which you use to upgrade the WebLogic domain configurations.

    2. Launch the Fusion Middleware Upgrade Assistant.

      The Welcome screen appears.

    3. Click Next.

    4. Select WebLogic Component Configurations, and in the Domain Directory field, select the WebLogic domain directory you want to upgrade, and then click Next.

      The Prerequisites screen appears.

    5. Navigate through the different screens by clicking Next on each screen and specifying your settings as necessary.

    6. On the Upgrade Success screen, verify that the upgrade was successful and click Close.

      See Oracle Fusion Middleware documentation for more information.

  7. After the upgrade of the WebLogic domain, you perform this step before starting the WebLogic Administration server.

    If Network Integrity is installed in a WebLogic cluster domain, open the WL_DOMAIN/config/config.xml file and change the JD persistent store and the NI persistent store targets to managed server migratables.

    See Chapter 4, "Installing and Configuring Oracle WebLogic Server" for more information.

  8. Start the Network Integrity Administration server. If this is a clustered server environment, start the cluster member servers.

    Note:

    If there are any JNDI issues and if managed server status goes to ”Admin” state, then delete NetworkIntegrity.ear and NICMWSAdapter.ear from deployments and start the managed server.
  9. Ensure that all the deployed applications are active, otherwise you will need to manually update each application and then make each application active.

  10. Undeploy all cartridges that you do not want migrated to the new version of Network Integrity. See "Migrating Cartridges" for more information.

    For example, you should undeploy cartridges that you are no longer licensed to use, or cartridges that provide functionality you no longer want to use.

    WARNING:

    It is not possible to undeploy a non-migrated cartridge after upgrading Network Integrity. Failure to undeploy cartridges that cannot or are not migrated causes Network Integrity to not function.

    See "Problem: Inability To Run Scans or Resolve Discrepancies After Upgrading" for more information.

Upgrading Network Integrity (7.3.0 to 7.3.5)

This section assumes that you have completed the pre-upgrade steps in "Pre-Upgrade Tasks (7.3.0 to 7.3.5) or (7.3.2 to 7.3.5)" before proceeding with the upgrade of Network Integrity.

To upgrade Network Integrity:

  1. Create a directory (dir) for a temporary installation directory.

  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.

    The extracted software pack has the following structure:

    integrity/Disk1/install/

  4. (IBM AIX only) Stop and restart the WebLogic Server domain for Network Integrity.

  5. Run the following command:

    ./dir/integrity/Disk1/install/runInstaller -paramFile ../oraparam.ini -jreloc jre_Path
    

    where jre_Path contains jre folder inside the JDK installation directory.

    The Installer Welcome screen appears.

  6. Click Next.

    The Select Installation Type screen appears.

  7. Select Complete and click Next.

    The Available Product Components screen appears.

  8. Select Network Integrity and click Next.

    The Specify Home Details screen appears.

  9. Do all of the following:

    1. In the Name field, enter, browse to, or confirm the name of the folder that contains the installation files for the old version of Network Integrity.

    2. In the Path field, enter, browse to, or confirm the directory where the folder specified in the Name field is located.

    3. Click Next.

    The Installer scans the specified directory and folder. The Installer displays a pop-up message if it detects a pre-existing installation of Network Integrity.

  10. (Optional) Confirm that you want to override your pre-existing installation.

    The Installer retrieves information about your old Network Integrity installation, such as connection details and user names.

    The Available Product Components screen appears displaying installation information about the installed Network Integrity components.

    The Installer automatically detects the Network Integrity components that can be upgraded.

  11. Review the list of components to be upgraded and click Next.

    The WebLogic Administration Server Connection Information screen appears displaying the current connection information.

  12. Verify the WebLogic Administration Server connection information, enter the WebLogic Server password, and click Next.

    The WebLogic Server / Cluster Selection screen appears.

    Note:

    The Installer does not proceed from the WebLogic Administration Server Connection Information screen if the fields contain errors.
  13. Select the same target WebLogic server or cluster of servers belonging to the WebLogic Server domain to upgrade and click Next.

    If you are upgrading a cluster of servers, the Cluster Member Server Selection screen appears, where you can select a cluster member for Network Integrity adapters to install or upgrade.

    The Database Type Selection screen appears.

  14. Select the same database type that is used by your old Network Integrity installation:

    • If your old installation is connected to a standalone database, select Standard Oracle 12c Enterprise Database and click Next.

      The Database Connection Information screen appears.

      Do the following:

      1. Verify that the retrieved field values are correct and click Next.

      2. In the Password field, enter the database server password for the user specified in the User Name field.

      3. Click Next.

    • If your old installation is connected to an Oracle Real Application Clusters (RAC) database, select Oracle 12c Real Application Cluster Database and click Next.

      The RAC DB Nodes Connection Information screen appears.

      Do the following:

      1. Verify that the retrieved field values are correct and click Next.

      2. In the Password field, enter the database server password for the user specified in the User Name field.

      3. Click Next.

      The Network Integrity Schema User Information screen appears.

      Note:

      The Installer does not proceed from either the Database Connection Information or RAC DB Nodes Connection Information screen if the fields on these screens contain errors.
  15. Do the following:

    1. Verify that the retrieved value in the Schema User Name field is correct.

    2. In the Schema User Password field, enter the schema user password for the user specified in the Schema User Name field.

    3. Click Next.

      The NI User ni-internal secure credentials screen appears.

  16. Do the following:

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

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

    3. Click Next.

      The Summary screen appears.

  17. Review the Summary screen and click Install.

    The Summary screen lists the products and components that are being upgraded. The Already Installed list includes products and components that are already up to date and are not being upgraded.

  18. Click the Install button.

    The Install screen appears, showing the status of the upgrade installation. The Install screen also explains where the upgrade log files are saved (NI_Home/oraInventory/logs/installActionDate_Time.log).

    When the Installer completes the upgrade, the End of Installation screen appears displaying the success of the upgrade. This screen also provides the URLs for accessing the new release of Network Integrity. Make a note of the URLs.

  19. Click Installed Products and verify that the installed version for Network Integrity is correct.

  20. Logon to the Network Integrity database instance and run the following data migration scripts:

    Note:

    You must use the same user name and password that you provided when you set up the database schema using RCU. See "Creating the Database (MetaData) Schema for Network Integrity" for more information.
    • NI_Home/integrity/upgrade/migration/7.3.2.0.0_NetworkIntegrity_data_migration.sql

    • NI_Home/integrity/upgrade/migration/post_upgrade_data_changes.sql

  21. In the Installer, click Exit.

Post-Upgrade Tasks (7.3.0 to 7.3.5)

After upgrading Network Integrity, do the following, if necessary:

  1. Verify that the Network Integrity software upgrade was completed successfully. See "Verifying the Network Integrity Installation" for more information.

  2. If you configured an Inventory System in the old version of Network Integrity and specified a password, you need to re-enter the password.

    1. In the new version of Network Integrity, click Manage Import System.

    2. Click Edit.

    3. Enter the password and click Save and Close.

  3. Migrate your cartridges to the new version of Network Integrity. See "Migrating Cartridges" for more information.

  4. Re-deploy your cartridges. See "Deploying Network Integrity Cartridges" for more information.

  5. In Network Integrity, edit all scans that use the Import Optical from UIM and Import Logical Optical from UIM scan action:

    1. On the Manage Scans page, search for scans that use the Import Optical from UIM scan action.

    2. In the search result, select each scan and do the following:

      • Click the Edit icon.

      • Click Save and Close.

    3. On the Manage Scans page, search for scans that use the Import Logical Optical from UIM scan action.

    4. In the search result, select each scan and do the following:

      • Click the Edit icon.

      • Click Save and Close.

    These scans are updated with the new scan parameter groups from the Optical UIM Integration cartridge.

Upgrading Network Integrity (7.3.2 to 7.3.5)

This section assumes that you have completed the pre-upgrade steps in "Pre-Upgrade Tasks (7.3.0 to 7.3.5) or (7.3.2 to 7.3.5)" before proceeding with the upgrade of Network Integrity.

To upgrade Network Integrity:

  1. Create a directory (dir) for a temporary installation directory.

  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.

    The extracted software pack has the following structure:

    integrity/Disk1/install/

  4. (IBM AIX only) Stop and restart the WebLogic Server domain for Network Integrity.

  5. Run the following command:

    ./dir/integrity/Disk1/install/runInstaller -paramFile ../oraparam.ini -jreloc jre_Path
    

    where jre_Path contains jre folder inside the JDK installation directory.

    The Installer Welcome screen appears.

  6. Click Next.

    The Select Installation Type screen appears.

  7. Select Complete and click Next.

    The Available Product Components screen appears.

  8. Select Network Integrity and click Next.

    The Specify Home Details screen appears.

  9. Perform all of the following steps:

    1. In the Name field, enter, browse to, or confirm the name of the folder that contains the installation files for the old version of Network Integrity.

    2. In the Path field, enter, browse to, or confirm the directory where the folder specified in the Name field is located.

    3. Click Next.

    The Installer scans the specified directory and folder. The Installer displays a pop-up message if it detects a pre-existing installation of Network Integrity.

  10. (Optional) Confirm that you want to override your pre-existing installation.

    The Installer retrieves information about your old Network Integrity installation, such as connection details and user names.

    The Available Product Components screen appears displaying installation information about the installed Network Integrity components.

    The Installer automatically detects the Network Integrity components that can be upgraded.

  11. Review the list of components to be upgraded and click Next.

    The WebLogic Administration Server Connection Information screen appears displaying the current connection information.

  12. Verify the WebLogic Administration Server connection information, enter the WebLogic Server password, and click Next.

    The WebLogic Server / Cluster Selection screen appears.

    Note:

    The Installer does not proceed from the WebLogic Administration Server Connection Information screen if the fields contain errors.
  13. Select the same target WebLogic server or cluster of servers belonging to the WebLogic Server domain to upgrade and click Next.

    If you are upgrading a cluster of servers, the Cluster Member Server Selection screen appears, where you can select a cluster member for Network Integrity adapters to install or upgrade.

    The Database Type Selection screen appears.

  14. Select the same database type that is used by your old Network Integrity installation:

    • If your old installation is connected to a standalone database, select Standard Oracle 12c Enterprise Database and click Next.

      The Database Connection Information screen appears.

      Do the following:

      1. Verify that the retrieved field values are correct and click Next.

      2. In the Password field, enter the database server password for the user specified in the User Name field.

      3. Click Next.

    • If your old installation is connected to an Oracle Real Application Clusters (RAC) database, select Oracle 12c Real Application Cluster Database and click Next.

      The RAC DB Nodes Connection Information screen appears.

      Do the following:

      1. Verify that the retrieved field values are correct and click Next.

      2. In the Password field, enter the database server password for the user specified in the User Name field.

      3. Click Next.

      The Network Integrity Schema User Information screen appears.

      Note:

      The Installer does not proceed from either the Database Connection Information or RAC DB Nodes Connection Information screen if the fields on these screens contain errors.
  15. Do the following:

    1. Verify that the retrieved value in the Schema User Name field is correct.

    2. In the Schema User Password field, enter the schema user password for the user specified in the Schema User Name field.

    3. Click Next.

      The NI User ni-internal secure credentials screen appears.

  16. Do the following:

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

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

    3. Click Next.

      The Summary screen appears.

  17. Review the Summary screen and click Install.

    The Summary screen lists the products and components that are being upgraded. The Already Installed list includes products and components that are already up to date and are not being upgraded.

  18. Click the Install button.

    The Install screen appears, showing the status of the upgrade installation. The Install screen also explains where the upgrade log files are saved (NI_Home/oraInventory/logs/installActionDate_Time.log).

    When the Installer completes the upgrade, the End of Installation screen appears displaying the success of the upgrade. This screen also provides the URLs for accessing the new release of Network Integrity. Make a note of the URLs.

  19. Click Installed Products and verify that the installed version for Network Integrity is correct.

  20. In the Installer, click Exit.

Post-Upgrade Tasks (7.3.2 to 7.3.5)

After upgrading Network Integrity, do the following, if necessary:

  1. Verify that the Network Integrity software upgrade was completed successfully. See "Verifying the Network Integrity Installation" for more information.

  2. If you configured an Inventory System in the old version of Network Integrity and specified a password, you need to re-enter the password.

    1. In the new version of Network Integrity, click Manage Import System.

    2. Click Edit.

    3. Enter the password and click Save and Close.

  3. Migrate your cartridges to the new version of Network Integrity. See "Migrating Cartridges" for more information.

  4. Re-deploy your cartridges. See "Deploying Network Integrity Cartridges" for more information.

    Note:

    Due to some limitations, cartridge deployments need to be done one by one after a Network Integrity 7.3.5 upgrade.

Migrating Cartridges

If you developed or extended cartridges for the old version of Network Integrity, you must migrate them to the new version of Network Integrity to continue to use them.

It is not possible to migrate scan instances or scan data. Scan instances have to be manually re-created in Network Integrity. Scan data is re-created when you run a scan.

Production cartridges (those with binaries supplied by Oracle) are already compatible with and can be deployed to the new version of Network Integrity.

Migrate your old custom cartridges to be compatible with the new version of Network Integrity using the Design Studio Cartridge Migration Tool. See Design Studio Platform online Help for more information.

The procedure for migrating cartridges assumes you have two Design Studio environments: one for the old version of Network Integrity, and one for the new version of Network Integrity.

Ensure the imported project is not read-only. The cartridge migration will fail if the project is read-only.

It is important to make sure that all the dependent projects exist in the workspace before importing a Network Integrity project. The migration tool will automatically set the dependencies when migrating Network Integrity projects, if the dependent projects exist in the workspace. If multiple projects are imported into Design Studio at the same time, move the dependent project to the top of the order in the cartridge upgrade dialog, so that the dependent project will be migrated first.

To migrate a custom cartridge (a cartridge with binaries not supplied by Oracle):

  1. Using the old Design Studio environment for Network Integrity, do the following:

    1. Select the Design Studio perspective.

    2. Select the Studio Projects view.

    3. Select the cartridge project and, from the Project menu, deselect Build Automatically.

    4. From the Project menu, select Clean.

    5. Select the Navigation view.

    6. Right-click the cartridge project folder and select Close Project.

  2. Using the new installation of Design Studio for Network Integrity, do the following:

    1. Select the Design Studio perspective.

    2. Select the Studio Projects view.

    3. Right-click anywhere in the Studio Projects view and select Import.

      The Import Project dialog box appears.

    4. Verify that the imported project is not ”read-only.”

    5. Locate the cartridge project and import it.

    6. Double-click the cartridge project folder.

      The cartridge properties appear.

    7. Verify that the Target Version field value matches the Network Integrity version.

      Note:

      If the Target Version field is not editable, it may mean that the cartridge is sealed, read-only, or under source control.
    8. Perform all necessary pre-build steps particular to your cartridge.

    9. From the Project menu, enable Build Automatically.

    10. From the Project menu, select Clean.

      The cartridge project is automatically built. The binary file is produced and written to the cartridgeBin directory.

About Rolling Back Network Integrity

If the Installer fails to successfully upgrade Network Integrity, you must manually restore the WebLogic server domain, the database schema, and the database domain. See Network Integrity System Administrator's Guide for more information about restoring the database. See your WebLogic Server documentation for more information about restoring the WebLogic Server domain.