Contents

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Document Revision History

1 Using Design Studio to Extend Network Integrity

• Installing Design Studio
  • Configuring Design Studio for Network Integrity
    • Configuring Network Integrity Preferences
    • Network Integrity Project Dependencies
    • Configuring Data Dictionary Preference Settings
• About Design Studio Perspectives
• About Design Studio Views
  • Studio Design Perspective Views
  • Java Perspective Views
• About Projects
  • About the Project Architecture
• Working with Projects
  • Building and Packaging Projects
    • About the Project Build Order
    • About Build Artifacts
    • Packaging Projects
  • Deploying and Undeploying Cartridges
    • Creating a Design Studio Environment Project
    • Creating a Design Studio Environment For Network Integrity
    • Deploying a Cartridge
    • Undeploying a Cartridge
    • Redeploying a Cartridge
  • Debugging and Testing Cartridges
    • Starting the WebLogic Server in Test Mode
    • Configuring Remote Debugger in Design Studio
  • Sealing and Unsealing Projects
  • Exporting and Importing Cartridges
    • Exporting a Cartridge with Source Code
    • Exporting a Cartridge Without Source Code
• About Specifications
• Working with Specifications
  • About Model Collections
  • About Specification Helpers
• About Source Control
• Working with Source Control for Network Integrity
• Tips and Tricks
  • About Java Errors in the Generated Controller Class
  • Renaming or Deleting Actions and Processors
  • Adding External Libraries to a Java Build Path
  • About ”Missing Required Library” Errors for External Libraries
  • Error Marker on Cartridge but not on any Entities

2 Working with Actions

• About Actions
  • About Actions and Processors
  • About Action within Actions
  • About the Generated Action MDB and Controller
  • About Scan Parameter Groups
    • Extending the Create Scan Page
    • Extending the Scan Details Page
  • About Conditions
    • About Generated Classes and the Implementation Class
    • Adding Dependent Actions with Conditions as Processors
    • Creating Condition Examples
  • About Model Collections in Actions
  • About For Each Processors
  • About Result Categories
• About Import Actions
• About Discovery Actions
  • About Discovery Action Address Handlers
  • About the Address_Handlers Cartridge
  • Implementing Address Handlers
    • About the AddressHandler Interface
    • About Dynamic Address Handlers
  • About Discovery Action Result Categories
  • About the Discovery Action in the Network Integrity UI
  • About Discovery Action Scan Parameter Groups
• About Assimilation Actions
• About Discrepancy Detection Actions
  • About Discrepancy Detection
  • About Result Sources
  • About Result Source and Scan Types
  • Generated Action MDB and Controller
• About Discrepancy Resolution Actions
  • About the Resolution Action Label
  • About Result Sources
  • Generated Action and MDB Controller

3 Working with Processors

• About Processors
  • About Context Parameters
    • Specifying Context Parameters before Creating Implementation Class
  • About Properties and Property Groups
  • About Generated Code
    • About the Location for Generated Code
    • About the Processor Interface
    • About the PropertyGroup and Properties Classes
• Implementing a Processor
  • About the Processor Finalizer
    • About the ProcessorFinalizer Interface
  • About Memory Considerations
• Implementing an Import Processor
• Implementing a Discovery Processor
  • Implementation Code Example
• Implementing the SNMP Processor
  • About the Generated Implementation and XML Beans
  • Supporting New MIBs
• Implementing an Assimilation Processor
• About Discrepancy Detection Processors
  • Discrepancy Detection Processor Patterns
    • Reusing the Base Detect Discrepancy Action
    • About the Base Detection Project and the Default Comparison Algorithm
    • Adding New Filters and Handlers
    • About Filters
    • About Handlers
    • Filters and CimType
    • Filter and Handler Examples
    • Adding Post-Processors
• About Discrepancy Resolution Processors
  • Creating a Discrepancy Resolution Processor
  • Implementing a Discrepancy Resolution Processor
    • About the Implementation Interface
    • About Input Parameters for the Invoke Method
    • Return Type of Invoke Method
  • About the General Flow of the Discrepancy Resolution Processor
  • Fetching Discrepancies
  • Grouping Discrepancies
  • Handling Discrepancies
  • Reporting the Resolution Result
  • Handling Discrepancies Asynchronously

4 Working with Discrepancies

• About Discrepancies
  • About the Compare and Reference Sides
  • About Discrepancy Types
    • Attribute Value Mismatch
    • Extra Entity and Missing Entity
    • Extra Association and Missing Association
    • Ordering Error and Association Ordering Error
  • About Discrepancy Status
  • About Discrepancy Detail

5 Working with the POMS SDK

• About POMS
• Working with POMS Entities
• Working with POMS Relationships
  • One-to-one Relationships
  • One-to-Many or Many-to-Many Relationships
  • Ordered and Unordered Relationships
  • Bi-directional Relationships
  • Relationship Entities
• Working with Specifications and Characteristics
• Working with the POMS Finder
  • Find by Entity
  • Find by JPQL
  • Find with Paged Results
  • POMS SDK Interfaces
• About Persist Results

6 Working with the Extensibility SDK

• About Extensibility Scenarios
• Extending MIB II SNMP Discovery for Updated Vendor and Interface Type
• Extending an Existing Cartridge to Discover and Reconcile New Characteristics
• Extending the MIB II SNMP Discovery to Change Interface Name Value
• Multiple Vendor SNMP Discovery
• Multiple Protocol Discoveries

7 Working with Automatic Discrepancy Resolution

• About Automatic Discrepancy Resolution
• About the Automatic Discrepancy Resolution Solution
  • Action and Processors
  • Scan Parameter Groups and the Network Integrity UI
  • Reference Implementations
• Implementing Automatic Discrepancy Resolution
  • Implementing Automatic Discrepancy Resolution in an Unsealed Cartridge Solution
  • Implementing Automatic Discrepancy Resolution in a Sealed Cartridge Solution
• Completing the Automatic Discrepancy Resolution Implementation
  • Completing Automatic Discrepancy Resolution Using a Properties File
  • Completing Automatic Discrepancy Resolution with a Custom Processor

8 Working with Incremental TMF814 Discovery

• About Incremental TMF814 Discovery
• About the Incremental TMF814 Discovery Solution
  • Action and Processors
  • Copying Information From Previous Scan Results
  • Scan Parameter Groups and the Network Integrity UI
  • Reference Implementations
• Implementing Incremental TMF814 Discovery
  • Implementing Incremental TMF814 Discovery in a Sealed Cartridge Solution

9 Working with CPU Utilization-enabled Discovery

• About CPU Utilization-enabled Discovery
• About CPU Utilization-enabled Discovery Solution
  • Action and Processors
  • About the Mechanism of Comparing CPU Usage Values
  • Scan Parameter Groups and the Network Integrity UI
  • Reference Implementations
• Implementing CPU Utilization-enabled Discovery
  • Implementing CPU Utilization-enabled Discovery in a Sealed Cartridge Solution

10 Working with the Network Integrity Web Service

• About the Network Integrity Web Service
  • Security
  • Model Based
  • Concurrency with UI and other Web Service Clients
  • Listing of Network Integrity Web Service Operations
• Network Integrity Web Service Operations
  • Create
    • Entity Type Support
  • Get
    • Entity Type Support
  • Get All
    • Entity Type Support
  • Delete
    • Entity Type Support
  • Update
    • Entity Type Support
  • Find
    • Entity Type Support
    • From and To Range
    • Ascending and Descending
    • Attribute Criteria
    • Multiple Attribute Criteria
    • Extended Attribute Criteria
    • Criteria Operators
    • Between/Not Between Operator
    • Data Criteria
    • Conjunction Criteria
    • Find Response
• Network Integrity Web Service Special Function Operations
  • Start Scan
  • Stop Scan
  • Get Latest Scan Status
  • Submit Discrepancies For Resolution Processing
• Network Integrity Web Service Scenarios
  • Creating a Scan
  • Starting, Stopping, and Monitoring a Scan
  • Retrieving Scan Results
  • Working with Discrepancies
• Network Integrity Web Service Samples
  • Contents of the Network Integrity Web Service Samples ZIP File
  • Sample Java Client
  • Sample Soap UI Project
    • Submitting Request to the Server
    • Specifying User Name and Password in Request

11 Working with Scan Run Complete Notifications

• About Clients for Monitoring Scan Run Complete Notification Messages
• Implementing Custom Code to Stop a Scan

12 Working with JCA Resource Adapters

• About Resource Adapters
  • Understanding JCA Resource Adapter Connectivity Options
  • Understanding JCA Resource Adapters with Network Integrity
• About Productized SNMP JCA Resource Adapter
  • Installing the SNMP JCA Resource Adapter
    • Extending the SNMP JCA Resource Adapter
    • Record and Playback Mode
    • Invoking the SNMP JCA Resource Adapter in a Network Integrity Cartridge
• About Third Party or Customized JCA Resource Adapters
  • Building a JCA Resource Adapter in WebLogic
  • Invoking a Third Party or Customized JCA Resource Adapter

13 Working with Reports Extensibility

• About BI Publisher
  • About BI Publisher Desktop
• Reports Provided with Network Integrity
  • Scan History Report
  • Discovery Scan Summary Report
  • Device Discrepancy Detection Summary Report
  • Device Discrepancy Detection Detail Report
  • Discrepancy Corrective Action Report
• Network Integrity Report Building Blocks
  • RTF Templates
  • Report Definition Files
    • Data Source Query Tools
    • Parameters
    • List of Values
    • Rendering Options
    • Report Properties
• Developing BI Publisher Reports
  • Report Requirements
    • Configuring a Data Source Tutorial
    • Creating a Report Tutorial
    • Building an RTF Template Tutorial
    • Using Microsoft Word Native Features and XSL
• Using BI Publisher Features
  • Scheduling Reports
    • Enabling BI Publisher Scheduler Tutorial
    • Using BI Publisher to Schedule Reports Tutorial
  • Localizing Reports
    • Localized Template Option
    • XLIFF File Option
• Installing and Integrating BI Publisher with Network Integrity
  • Installing BI Publisher in Standalone Mode
  • Deploying BI Publisher
  • Integrating BI Publisher with Network Integrity using WebLogic Enterprise Manager
  • Integrating BI Publisher with Network Integrity using JConsole
  • Integrating BI Publisher with the Network Integrity Installer
• Uploading and Exporting Reports
  • Exporting a Report
  • Uploading a Report

14 Working with SOA Extensibility

• About SOA Extensibility
  • Purpose of Documentation
• Extensibility Tasks
  • Extensibility Tasks
  • Installing Oracle Weblogic Server
  • Installing Oracle JDeveloper
  • Installing Oracle Application Runtime
  • Installing Oracle SOA Suite
  • Creating SOA Metadata Service Schemas
  • Updating JDeveloper for Latest SOA Composite Editor
  • Creating WebLogic Domain with SOA Products
  • Creating and Updating Sample SOA Application Using Network Integrity Web Service
  • Starting and Stopping SOA Servers
  • Building and Deploying the SOA Application
  • Testing Sample SOA application
    • Testing Network Integrity SOA Application Using EM
    • Testing Network Integrity SOA Application Using soa-infra
    • Testing Network Integrity SOA Application Using SOAP UI Tool

15 Localizing Network Integrity

• Software Requirements
• Setting the Language Preference in Internet Explorer
• Determining the Locale ID
• Localizing Network Integrity
  • About the Localization Pack
  • Creating the Localization Pack
  • Deploying the Cartridge Containing the Localized Files
  • Testing the Network Integrity Localization
• Localizing Network Integrity Help
  • About Network Integrity Help
    • About the Help Files
  • Localizing the Network Integrity Help Files
    • Extracting the Help Files
    • Translating the Help Files
    • Regenerating the Search Index File
    • Creating the Localized Help JAR File
    • Configuring the Oracle Help File
  • Deploying the Localized Help System
  • Testing the Network Integrity Help Localization

A Network Integrity Plug-in Validation Error Messages

• Error Message Classifications and Conditions
• Design Studio Logging