oracle® communications network intelligence · network intelligence developer’s guide: describes...

Oracle® Communications Network IntelligenceInstallation Guide

Release 7.2.4

E52754-01

July 2014

Oracle Communications Network Intelligence Installation Guide, Release 7.2.4

E52754-01

Copyright © 2010, 2014, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

iii

Contents

Preface ................................................................................................................................................................ vii

Audience...................................................................................................................................................... viiRelated Documents .................................................................................................................................... viiDocumentation Accessibility ................................................................................................................... viiiDocument Revision History .................................................................................................................... viii

1 Network Intelligence Installation Overview

Overview of Network Intelligence Installed Components.............................................................. 1-1Overview of Network Intelligence Installation Procedure.............................................................. 1-1Ensuring a Successful Network Intelligence Installation................................................................ 1-2

2 Network Intelligence System Requirements

Software Requirements........................................................................................................................... 2-1Hardware Sizing Guidelines ................................................................................................................. 2-2Information Requirements ..................................................................................................................... 2-3

Oracle Database Server Parameters................................................................................................. 2-3Oracle WebLogic Server Parameters............................................................................................... 2-4

3 Installing and Configuring the Oracle Database

Installing and Configuring Oracle Database Overview................................................................... 3-1Installing Oracle Database Software .............................................................................................. 3-1Database Information You Must Record ........................................................................................ 3-1

Core Database Information You Must Record ....................................................................... 3-1Staging Database Information You Must Record................................................................... 3-2Map Database Information You Must Record........................................................................ 3-2

Configuring the Oracle Database Instance..................................................................................... 3-2Creating Schema Users .............................................................................................................. 3-2Assigning Schema User Roles and Privileges......................................................................... 3-3Using a Sample Script to Assign Roles and Privileges.......................................................... 3-4

Installing and Configuring SQL*Plus and SQL*Loader............................................................... 3-6Adding Oracle SQL*Plus to the PATH.................................................................................... 3-6

Setting Up the Network Intelligence Database.............................................................................. 3-6

iv

4 Installing and Configuring Oracle WebLogic Server

Installing the Java Development Kit (JDK) ........................................................................................ 4-1Installing JDK...................................................................................................................................... 4-2Installing IBM Java............................................................................................................................. 4-2

Downloading and Installing Oracle WebLogic Server..................................................................... 4-2Installing Patches................................................................................................................................ 4-2Configuring the Oracle WebLogic Server Time Zone .................................................................. 4-2

Creating a WebLogic Domain for a Single Server Installation....................................................... 4-3WebLogic Server Connection Information..................................................................................... 4-3Creating the Standalone WebLogic Domain.................................................................................. 4-3

Installing and Configuring Oracle Fusion Middleware MapViewer ............................................ 4-6Installing Oracle Fusion Middleware MapViewer........................................................................ 4-7Creating System Views...................................................................................................................... 4-7Creating a Map Schema .................................................................................................................... 4-7Configuring MapViewer................................................................................................................... 4-8

Specifying a Permanent Data Source ....................................................................................... 4-8Using Map Outlines........................................................................................................................... 4-8

Downloading Maps .................................................................................................................... 4-8Using Prepackaged Outline Maps............................................................................................ 4-9

Defining the DATAPUMP Directory Before Importing Map Data ......................................... 4-10Populating the NI_MAP Table...................................................................................................... 4-10Configuring MapViewer in Network Intelligence ..................................................................... 4-10

Creating a WebLogic Domain for a Server Cluster Installation ................................................. 4-10Benefits of WebLogic Clustering................................................................................................... 4-11Key Capabilities of a Cluster ......................................................................................................... 4-11Installation Scenario........................................................................................................................ 4-12

Server Cluster Example........................................................................................................... 4-12Overview of Steps for Setting Up Network Intelligence on an Oracle WebLogic Server Cluster 4-13Installing Oracle WebLogic Server Instance ........................................................................ 4-13Creating a Domain................................................................................................................... 4-14Starting WebLogic Server ....................................................................................................... 4-17Starting the WebLogic Managed Servers ............................................................................. 4-18Starting the WebLogic Managed Servers in Administration Console ............................ 4-19Configuring the WebLogic Server for use with Oracle HTTP Server Load Balancing.. 4-19

Configuring Data Source on Oracle WebLogic Server Cluster ................................................ 4-19Installing and Configuring MapViewer on Oracle WebLogic Server Cluster ....................... 4-20

Configuring Spatial Data Source on Oracle WebLogic Server Cluster ............................ 4-20Configuring MapViewer......................................................................................................... 4-22Configuring MapViewer in Network Intelligence.............................................................. 4-23

Deploying Network Intelligence on WebLogic Server Domain or Cluster............................ 4-23Installing Oracle HTTP Server ...................................................................................................... 4-24

Installing Oracle HTTP Server ............................................................................................... 4-24Start or Stop Oracle HTTP Server ................................................................................................. 4-26

Using Oracle Enterprise Manager to Start Oracle HTTP Server....................................... 4-26Using opmnctl to Start Oracle HTTP Server........................................................................ 4-26Using Oracle Enterprise Manager to Stop Oracle HTTP Server ....................................... 4-26

v

Using opmnctl to Stop Oracle HTTP Server ........................................................................ 4-26Configure Oracle HTTP Server for Load Balancing................................................................... 4-26Configuring Identity and Trust for Network Intelligence ........................................................ 4-28

Configuring Demo Certificates for Network Intelligence Client connected to Oracle WebLogic Server 4-29Configuring Demo Certificates for Network Intelligence Client connected to Oracle HTTP Server 4-29

Activating Network Intelligence Logging to WebLogic Server Log ....................................... 4-30Setting Memory Requirements for Network Intelligence ............................................................ 4-33

5 Installing Network Intelligence

Installing Network Intelligence ............................................................................................................ 5-1

6 Post-Installation Tasks

Deploying Network Intelligence in the WebLogic Server Domain............................................... 6-1Configuring Historical Data Storage for Trail Statistics .................................................................. 6-1Configuring the APP_CONFIGURATION Table to Communicate with MapViewer .............. 6-2

Configuring MapViewer Values in the APP_CONFIGURATION Table .................................. 6-3Updating Tile Related Values ................................................................................................... 6-4Updating Style Related Values ................................................................................................. 6-4

Client-Machine Post-Installation Tasks .............................................................................................. 6-5Configuring Java Web Start to Bypass Proxy Servers .................................................................. 6-5Configuring Java Exception Site List for Unsigned or Self-Signed Applications..................... 6-5

7 Verifying the Network Intelligence Installation

Checking the JAVA_HOME Environment Variable......................................................................... 7-1Checking that the Oracle Database is Running ................................................................................. 7-1Checking the Database Schemas........................................................................................................... 7-1Checking the State of Installed Components ..................................................................................... 7-1Logging In to Network Intelligence ..................................................................................................... 7-1

8 Troubleshooting Network Intelligence

About Network Intelligence Installation Error Messages ............................................................... 8-1About Network Intelligence Server Installation Error Messages ............................................... 8-1About Network Intelligence Database Installation Error Messages........................................... 8-2

Problem: Unable to Load Performance Pack....................................................................................... 8-2Configuring Memory Settings............................................................................................................... 8-2

Increasing Network Intelligence Database Installer Memory..................................................... 8-3Increasing WebLogic Domain Memory.......................................................................................... 8-3

Configuring WebLogic Domains With Separate Listen Ports......................................................... 8-3Configuring Email and SMTP Settings ............................................................................................... 8-3Modifying the Scheduled Task Settings ............................................................................................ 8-4Adding Email Details .............................................................................................................................. 8-4Browser Character Encoding Issues with Oracle WebLogic Server ............................................... 8-5

vi

9 Upgrading Network Intelligence

About Upgrading Network Intelligence.............................................................................................. 9-1Supported Upgrade Paths................................................................................................................. 9-1

Planning Your Upgrade........................................................................................................................... 9-1Testing the Upgrade in a Test Environment ....................................................................................... 9-2Upgrade Impacts....................................................................................................................................... 9-2

Upgrade Impacts From 7.2.2.3 to 7.2.4 ............................................................................................ 9-2Java Development Kit changes ................................................................................................. 9-3WebLogic Server Changes......................................................................................................... 9-3Database Software Changes ...................................................................................................... 9-3Database Schema Changes ........................................................................................................ 9-3Application Component Changes ............................................................................................ 9-3

Upgrading From 7.2.2.x to 7.2.4 .............................................................................................................. 9-3Pre-Upgrade Tasks (7.2.2.x to 7.2.4) ................................................................................................ 9-4Upgrading the Network Intelligence Database (7.2.2.3 to 7.2.4)................................................. 9-5Upgrading the Network Intelligence Software (7.2.2.x to 7.2.4) ................................................. 9-7Post-Upgrade Tasks (7.2.2.x to 7.2.4)............................................................................................... 9-9

10 Uninstalling Network Intelligence

Uninstalling Network Intelligence from Oracle WebLogic Server............................................. 10-1Uninstalling the Network Intelligence Database........................................................................ 10-1Uninstalling the Network Intelligence Client ............................................................................. 10-1

vii

Preface

This guide provides instructions for installing Oracle Communications Network Intelligence.

AudienceInformation in this guide is intended for systems integrators, system administrators, database administrators, and developers who install and configure the Network Intelligence software.

The person installing the software should be familiar with the following topics:

■ Operating system commands

■ Database configuration

■ Oracle WebLogic Server

Network Intelligence requires Oracle Database and Oracle WebLogic Server. Refer to the documentation for those products for installation and configuration instructions.

Related DocumentsNetwork Intelligence Installation Guide is one book in the Oracle Communications Network Intelligence documentation set. For more information, refer to the following documents:

■ Network Intelligence System Administrator’s Guide: Describes administrative tasks such as starting and stopping Network Intelligence, managing security, and managing Network Intelligence.

■ Network Intelligence User’s Guide: Provides information about how to use and configure Network Intelligence.

■ Network Intelligence Developer’s Guide: Describes the architecture of Network Intelligence and explains how to customize reports and maps, extend the user interface, configure extensible attributes, configure security, populate the staging database, and load the database.

■ Network Intelligence Release Notes: Describes the new features, fixes and enhancements to existing features, known issues, troubleshooting tips, and required third party products and licensing.

■ Network Intelligence Concepts: Provides an overview of important concepts and an introduction to using Network Intelligence.

■ Network Intelligence Security Guide: Provides guidelines and recommendations for setting up Network Intelligence in a secure configuration.

viii

Documentation AccessibilityFor information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle SupportOracle customers have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.

Document Revision HistoryThe following table lists the revision history for this guide:

Version Date Description

E52724-01 July 2014 7.2.4 GA release.

1

Network Intelligence Installation Overview 1-1

1Network Intelligence Installation Overview

This chapter describes the installation process for Oracle Communications Network Intelligence.

Overview of Network Intelligence Installed ComponentsDuring the installation process, you install and configure the following components:

■ Oracle Database

■ Oracle WebLogic Server

■ Oracle Fusion Middleware MapViewer

■ SQL*Plus and SQL*Loader

■ Network Intelligence server software

Overview of Network Intelligence Installation ProcedureThe installation procedure follows these steps:

1. Plan your installation. When planning your installation, you do the following

■ Determine the scale of your implementation.

■ Determine how many servers you need, and which software components to install on each system.

■ Plan the system topology, for example, how the system components connect to each other over the network.

2. Review system requirements. System requirements include:

■ Hardware requirements, such as disk space.

■ System software requirements, such as operating system (OS) versions and OS patch requirements.

■ Information requirements, such as IP addresses and host names.

3. Perform pre-installation tasks:

■ Install and configure Oracle Database.

■ Install and configure WebLogic Server.

■ Install additional software components, such as Oracle Fusion Middleware MapViewer, SQL*Plus, and SQL*Loader.

Ensuring a Successful Network Intelligence Installation

1-2 Network Intelligence Installation Guide

4. Install the Network Intelligence database.

5. Install the Network Intelligence software.

6. Perform post-installation configuration tasks.

7. Verify the installation.

Ensuring a Successful Network Intelligence InstallationNetwork Intelligence installation should be performed only by qualified personnel. You must be familiar with the UNIX operating system and Oracle WebLogic Server. You should be experienced with installing Java-related packages. It is recommended that the installation and configuration of the Oracle Database be performed by an experienced database administrator.

Follow these guidelines:

■ As you install each component; for example, Oracle Database and WebLogic Server, verify that the component installed successfully before continuing the installation process.

■ Pay close attention to the system requirements. Before you begin installing the software, ensure your system has the required base software. In addition, ensure that you know all of the required configuration values, such as host names and port numbers.

■ As you create new configuration values, write them down. In some cases, you must reenter configuration values later in the procedure.

Note: Oracle Fusion Middleware MapViewer is an optional component. See "Installing and Configuring MapViewer on Oracle WebLogic Server Cluster".

2

Network Intelligence System Requirements 2-1

2Network Intelligence System Requirements

This chapter describes software, hardware, and information requirements for Oracle Communications Network Intelligence.

Software RequirementsThis section provides information about software requirements for installing and using Network Intelligence server and client applications.

Table 2–1 lists operating systems that support the Network Intelligence server.

Table 2–2 lists software required on the Network Intelligence server.

Table 2–1 Supported Operating Systems

Product Version

Oracle Linux on x86 (64-bit) 5.8 or 6.2

Red Hat Enterprise Linux on x86 (64-bit) 5.8 or 6.2

Oracle Solaris on SPARC (64-bit) 10, 11

IBM AIX on POWER Hardware (64-bit) 6.1 Technology Level (TL) 6 SP2

Table 2–2 Required Server-Side Software

Product Version

Oracle WebLogic Server Enterprise Edition 11gR1 PS5 (10.3.6)

Oracle WebLogic Server Patch 17572726

Sun Hotspot (JDK) for Linux or Solaris Linux: Java 7 with latest critical patch update

Solaris: Java 7 with latest critical patch update

IBM Java SE Runtime Environment for IBM AIX Java 7 with latest critical patch update

Oracle Database Enterprise Edition 11gR2 PS2 (11.2.0.3) or 11gR2 PS3 (11.2.0.4.1)

Hardware Sizing Guidelines


Table 2–3 lists the software requirements on the client machine for accessing Network Intelligence.

Hardware Sizing GuidelinesThe following tables provide hardware sizing guidelines for estimating hardware requirements that achieve acceptable performance in Network Intelligence:

■ Table 2–4, " Hardware Sizing Guidelines for Use with Solaris"

■ Table 2–5, " Hardware Sizing Guidelines for Use with Linux"

Contact your Oracle Sales Representative for hardware sizing guidelines for Network Intelligence systems deployed on the IBM AIX operating system.

Oracle Database Patches For 11gR2 PS2 (11.2.0.3):

■ None

For 11gR2 PS3 (11.2.0.4.1):

■ 18230522

■ (Linux only) Automated Release Update (ARU) patch 17394794

■ (Solaris only) ARU patch 17398276

Hibernate Object Relational Mapping (ORM) libraries

3.2.6

Note: You must download the hibernate-3.2.6.ga.zip file from:

http://downloads.sourceforge.net/hibernate/hibernate-3.2.6.ga.zip

After downloading, make note of the location where you downloaded the ZIP file. You must provide this during the installation process. You do not need to unzip the archive.

Table 2–3 Network Intelligence Client-Side Software Requirements

Product Version

Operating System Microsoft Windows 7

Java Runtime Environment (JRE) Java 7 with latest critical patch update

Web browser Microsoft Internet Explorer (IE) 8 or 9

Mozilla Firefox 10, 17

Note: The information in this section is meant as a guideline only. The values in this section are approximate. Accurate sizing for a production system requires a detailed analysis of the proposed business requirements.

Table 2–2 (Cont.) Required Server-Side Software

Product Version

Information Requirements

Network Intelligence System Requirements 2-3

Information RequirementsThe Network Intelligence installer requires the following information about Oracle database and the application server during the installation process. When possible, gather this information in advance. Most of this information can be obtained from your Oracle DBA and your system administrator.

Oracle Database Server ParametersTable 2–6 lists information about your Oracle database required during the Network Intelligence installation.

Table 2–4 Hardware Sizing Guidelines for Use with Solaris

Hardware Small Deployment Medium Deployment Large Deployment

Concurrent users 10 30 30

Trails Fewer than 100,000 Between 100,000 and 2,000,000

Between 2,000,000 and 6,000,000

Equipment Fewer than 50,000 Between 20,000 and 200,000 Between 200,000 and 600,000

Server model SPARC T4-1 SPARC T4-1 SPARC T4-2

CPU 1 core zone of SPARC T4 2.85 GHz (8-Core)

1 SPARC T4 2.85 GHz (8-Core)

2 SPARC T4 2.85 GHz (8-Core)

RAM 16 GB 64 GB 128 GB

Internal disk space 4x600 SAS-2 HDD (RAID10) 2x300 (RAID1) 2x300 (RAID1)

Table 2–5 Hardware Sizing Guidelines for Use with Linux

Hardware Small Deployment Medium Deployment Large Deployment

Concurrent users 10 30 30

Trails Fewer than 100,000 Between 100,000 and 2,000,000

Between 2,000,000 and 6,000,000

Equipment Fewer than 50,000 Between 20,000 and 200,000 Between 200,000 and 600,000

Server model Sun Server X3-2 Sun Server X3-2 Sun Server X2-4

CPU 1 Intel Xeon E5-2609 2.4GHz (4-Core)

2 Intel Xeon E5-2640 2.5GHz (6-Core)

2 Intel Xeon E7-4870 series 2.40GHz (10-Core)

RAM 16 GB 64 GB 128 GB

Internal disk space 4x600 SAS-2 HDD (RAID10) 2x300 (RAID1) 2x300 (RAID1)

Note: If you are installing Network Intelligence into an Oracle 11g Database in an Oracle Real Application Clusters configuration, enter the connection details for a single node of the Oracle Real Application Clusters only.

Table 2–6 Oracle Database Server Parameters

Information Type Description Default Value

Database SID (Service ID) The Oracle database system identifier or service name.

ORCL

Information Requirements


Oracle WebLogic Server ParametersTable 2–7 lists the information about your Oracle WebLogic Server instance required during the Network Intelligence installation.

Database Server Host The DNS name or IP address of the Oracle database server.

localhost

Database Server Port The port that the Oracle database server is listening on.

1521

Database user name The user name of the Network Intelligence schema owner.

N/A

Database user password The password of the Network Intelligence schema owner.

N/A

Table 2–7 Application Server Parameters


Server Hostname Host name of the WebLogic Server

Current host name

Server Port Port number of the WebLogic Server

7001

Data source JNDI name The Java Naming and Directory Interface (JNDI) name assigned to the data source

oracle/communications/networkintelligence/dat/OracleDS

Table 2–6 (Cont.) Oracle Database Server Parameters


3

Installing and Configuring the Oracle Database 3-1

3Installing and Configuring the Oracle Database

This chapter describes the process of installing the Oracle Database and configuring the Oracle Database for Oracle Communications Network Intelligence.

Installing and Configuring Oracle Database OverviewTo install and configure Oracle Database, the tasks include:

■ Installing Oracle Database Software

■ Database Information You Must Record

■ Configuring the Oracle Database Instance

■ Installing and Configuring SQL*Plus and SQL*Loader

■ Setting Up the Network Intelligence Database

Installing Oracle Database Software For information on installing Oracle Database Enterprise Edition, refer to the Oracle Database Enterprise Edition installation documentation.

Database Information You Must RecordWhen you install and configure Oracle Database, you define system configuration values that you must enter when you install Network Intelligence. When you create the following values, write them down so you can use them later in the installation process:

■ Database server host name

■ Database SID (Service ID) or service name

■ Database server port number

■ Database user login

■ Database user password

Core Database Information You Must RecordWhen you create the Oracle Database user for the Network Intelligence core schema, you define schema connection values that you must enter when you install the Network Intelligence database. When you create the following values, write them down so you can use them later in the installation process:

■ Core user account

Installing and Configuring Oracle Database Overview


■ Core user password

Staging Database Information You Must RecordWhen you create the Oracle Database user for the Network Intelligence staging schema, you define schema connection values that you must enter when you install the Network Intelligence database. When you create the following values, write them down so you can use them later in the installation process:

■ Staging user account

■ Staging user password

Map Database Information You Must RecordWhen you create the Oracle Database user for the map schema, you define schema connection values that you must enter when you install the Network Intelligence database. When you create the following values, write them down so you can use them later in the installation process:

■ Map user account

■ Map user password

Configuring the Oracle Database InstanceThe Network Intelligence core database is a storage area created to model and manage application data, typically from one or more Inventory Management Systems (IMS). It is the production database for the Network Intelligence application, and uses a core schema to describe the layout of the core database, that is, the way in which the application data is organized into tables.

The Network Intelligence staging database is a storage area separate from the Network Intelligence core database that is created to provide continuous access to application data; the staging schema describes the layout of the staging database, and consists of a subset of tables based on the equivalent tables in the core schema.

Data loaders, which are processes written using Java and PL/SQL procedures, are used to extract data from an IMS and insert it into a Network Intelligence database. This data is first cleansed and normalized to be written into the Network Intelligence staging database.

Each customer implementation has different data content from various data sources that requires mapping and synchronization to the network model depicted in the database tables. The data loader extracts the data from each table in the staging schema and loads it into the equivalent table in the core schema.

Creating Schema UsersAfter Oracle Database is installed, the database administrator must create three Oracle Database users (with three underlying schemas); for example:

■ NI_CORE (for the Network Intelligence core schema)

■ NI_STG (for the Network Intelligence staging schema)

■ NI_MAP (for the Network Intelligence map schema)

The users must be created in the same database instance. The Network Intelligence Database is installed after the database users have been created and the users information is entered as input on the installer screens. For more details, see "Setting Up the Network Intelligence Database".



For further information on database schema creation and configuration, refer to Oracle Database installation documentation.

For further information on schema tables, see Network Intelligence Developer’s Guide.

Assigning Schema User Roles and PrivilegesThere are three separate and distinct schemas in Network Intelligence:

■ The Network Intelligence core database schema

■ The Network Intelligence staging database schema

■ The Network Intelligence map database schema

Table 3–1 lists the roles and privileges assigned to the Network Intelligence schema users.

Note: The creation of an Oracle Database user and schema for the Network Intelligence map functionality must be carried out irrespective of whether you intend to use the (optional) Oracle Fusion Middleware MapViewer implementation for overlaying site, equipment, and circuit information on background maps within Network Intelligence.

Note: The EXECUTE command specified in the Object Privileges column may be run only by root users, that is, by users with system administrator privileges. All other commands in the Roles and System Privileges columns may be run from the default local user, as they do not need administrator privileges.



Using a Sample Script to Assign Roles and PrivilegesRun this script to create Network Intelligence users and roles, before running the database installer.

set ECHO onSET VERIFY ONWHENEVER OSERROR EXIT OSCODEWHENEVER SQLERROR EXIT SQL.sqlCODE PROMPT 'User And Role Names Must Be Different'ACCEPT nicore_role Char Default 'netintel_core_role' PROMPT 'Enter Name of Role (CORE):'ACCEPT nistaging_role Char Default 'netintel_stg_role' PROMPT 'Enter Name of Role (STG):'ACCEPT nimap_role CHAR DEFAULT 'netintel_map_role' PROMPT 'Enter Name of Role (MAP):' CREATE ROLE &&nicore_role;CREATE ROLE &&nistaging_role;CREATE ROLE &&nimap_role;

Table 3–1 Assigning Network Intelligence Database Roles and Privileges

Schema Roles System Privileges Object Privileges

Core Database (NI_CORE)

CONNECT

RESOURCE

CREATE ANY SYNONYM

DROP ANY SYNONYM

CREATE MATERIALIZED VIEW

CREATE PROCEDURE

CREATE SEQUENCE

CREATE SYNONYM

CREATE TABLE

CREATE TYPE

CREATE VIEW

DROP ANY TABLE

CREATE TRIGGER

CREATE ANY CONTEXT

DROP ANY CONTEXT

EXECUTE ON SYS.DBMS_APPLICATION_INFO

EXECUTE ON SYS.DBMS_APPLICATION_INFO

Staging Database (NI_STG)

CONNECT

RESOURCE

CREATE SEQUENCE

CREATE ANY SYNONYM

DROP ANY SYNONYM

CREATE TABLE

CREATE TYPE

CREATE VIEW

DROP ANY TABLE

DROP ANY VIEW

N/A

Map Schema (NI_MAP)

CONNECT

RESOURCE

CREATE SEQUENCE

CREATE ANY SYNONYM

DROP ANY SYNONYM

CREATE TABLE

DROP ANY TABLE

N/A



--core roleGRANT CREATE ANY SYNONYM TO &&nicore_role;GRANT DROP ANY SYNONYM TO &&nicore_role;GRANT CREATE MATERIALIZED VIEW TO &&nicore_role;GRANT CREATE PROCEDURE TO &&nicore_role;GRANT CREATE SEQUENCE TO &&nicore_role;GRANT CREATE SYNONYM TO &&nicore_role;GRANT CREATE TABLE TO &&nicore_role; --The CONNECT and RESOURCE roles include the CREATE TYPE system privilegeGRANT CREATE TYPE TO &&nicore_role;GRANT CREATE VIEW TO &&nicore_role;GRANT DROP ANY TABLE TO &&nicore_role;GRANT CREATE TRIGGER TO &&nicore_role;GRANT CREATE ANY CONTEXT to &&nicore_role;GRANT DROP ANY CONTEXT to &&nicore_role;GRANT EXECUTE ON SYS.DBMS_APPLICATION_INFO TO &&nicore_role; --staging roleGRANT CREATE SEQUENCE TO &&nistaging_role;GRANT CREATE ANY SYNONYM TO &&nistaging_role;GRANT DROP ANY SYNONYM TO &&nistaging_role;GRANT CREATE TABLE TO &&nistaging_role;GRANT CREATE TYPE TO &&nistaging_role;GRANT CREATE VIEW TO &&nistaging_role;GRANT DROP ANY TABLE TO &&nistaging_role;GRANT DROP ANY VIEW TO &&nistaging_role; --map roleGRANT CREATE SEQUENCE TO &&nimap_role;GRANT CREATE ANY SYNONYM TO &&nimap_role;GRANT DROP ANY SYNONYM TO &&nimap_role;GRANT CREATE TABLE TO &&nimap_role;GRANT DROP ANY TABLE TO &&nimap_role; ACCEPT nicore_owner CHAR DEFAULT 'netintel_core' PROMPT 'Enter Name of User (CORE):'ACCEPT nicore_owner_password CHAR PROMPT 'Enter Password of User (CORE):' HIDEACCEPT nicore_tablespace CHAR PROMPT 'Enter Tablespace of User (CORE):'ACCEPT nistaging_owner CHAR DEFAULT 'netintel_stg' PROMPT 'Enter Name of User (STG):'ACCEPT nistaging_owner_password CHAR PROMPT 'Enter Password of User (STG):' HIDEACCEPT nistaging_tablespace CHAR PROMPT 'Enter Tablespace of User (STG):'ACCEPT nimap_owner CHAR DEFAULT 'netintel_map' PROMPT 'Enter Name of User (MAP):'ACCEPT nimap_owner_password CHAR PROMPT 'Enter Password of User (MAP):' HIDEACCEPT nimap_tablespace CHAR PROMPT 'Enter Tablespace of User (MAP):' --1. create the core owner userCREATE USER &&nicore_owner IDENTIFIED BY &&nicore_owner_passwordDEFAULT TABLESPACE &&nicore_tablespaceTEMPORARY TABLESPACE TEMP;--with some grants??GRANT CONNECT TO &&nicore_owner;GRANT RESOURCE TO &&nicore_owner;--Solve issues with 'execute immediate'. Oracle does support certain grantson role , requires grants directly on userGRANT CREATE TABLE TO &&nicore_owner;GRANT QUERY REWRITE TO &&nicore_owner; --needed for Function based indexes GRANT CREATE MATERIALIZED VIEW TO &&nicore_owner;GRANT DROP ANY MATERIALIZED VIEW TO &&nicore_owner;



GRANT ALTER ANY MATERIALIZED VIEW TO &&nicore_owner; --2. create the staging owner userCREATE USER &&nistaging_owner IDENTIFIED BY &&nistaging_owner_passwordDEFAULT TABLESPACE &&nistaging_tablespaceTEMPORARY TABLESPACE TEMP;--with some grants??GRANT CONNECT TO &&nistaging_owner;GRANT RESOURCE TO &&nistaging_owner; --3. create the map owner userCREATE USER &&nimap_owner IDENTIFIED BY &&nimap_owner_passwordDEFAULT TABLESPACE &&nimap_tablespaceTEMPORARY TABLESPACE TEMP;--with some grants??GRANT CONNECT TO &&nimap_owner;GRANT RESOURCE TO &&nimap_owner; --then grant the roles to the new usersGRANT &&nicore_role to &&nicore_owner;GRANT &&nistaging_role TO &&nistaging_owner;GRANT &&nimap_role TO &&nimap_owner; SHOW ERRORS/

Installing and Configuring SQL*Plus and SQL*LoaderSQL*Plus and SQL*Loader (also known as the sqlldr client tool, and part of the utilities provided with Oracle Database) must be present to run the Network Intelligence Installer (for both server and database). SQL*Loader is a bulk loader utility used for moving data from external files into the Oracle database.

SQL*Plus and SQL*Loader can be installed as part of Oracle Database, or as part of Oracle Database Client (SQL*Loader is available only for an “Administration” installation type).

For instructions on installing SQL*Plus, refer to the SQL*Plus documentation.

For instructions on installing SQL*Loader, refer to the SQL*Loader documentation.

Adding Oracle SQL*Plus to the PATHEnsure that the PATH environment variable contains the path to the /bin directory on UNIX-based systems (or \bin directory on Windows) of the Oracle Database, or the Oracle Database Client.

To check that Oracle SQL*Plus is correctly installed, open a console and run the following command to return the SQL*Plus version number in the format SQL*Plus: Release 11.2.0.1.0 Production:

■ (On Windows) sqlplus.exe -V

■ (On UNIX) sqlplus -V

Setting Up the Network Intelligence DatabaseTo set up the Network Intelligence database:

1. Run the Oracle Database netintel-database-installer.jar file by performing one of the following:



■ On UNIX, run the following command in a shell that has Java on its path in the directory where the netintel-database-installer.jar file is located:

java -jar netintel-database-installer.jar

■ From a graphical directory browser, double-click

netintel-database-installer.jar

The Introduction screen appears.

2. Click Next.

The Copyright screen appears.

3. Click Accept.

The Welcome screen appears.

4. Click Next.

The Installer mode screen appears.

5. Select Install database, then click Next.

The Database Server Connection Details screen appears.

6. Do the following:

a. Specify the connection type for how you want to connect to the database: either SID or Service Name.

b. In the Connection Name field:

– If you selected SID as the connection type, enter the database service ID.

– If you selected Service Name as the connection type, enter the database service name.

The default is ORCL.

Note down this value, as you need it when installing Network Intelligence to the target server.

c. In the Database Server Host field, enter the name of the machine on which the database is to be installed. The default is localhost.


d. In the Database Server Port field, enter the Oracle listener port. The default is 1521.


Note: Before running this command, verify that the JAVA_HOME variable is set to the correct JDK. Do not use the JRE, as an error message will be displayed.

Note: Type the command at the prompt. Do not copy and paste the command from this document because certain characters may not be copied properly.



7. Click Next.

The Core Database Schema Connection Details screen appears.


a. In the Core User Account field, enter the user of this database schema. The default is netintel_core.

You should note this value, as it is required during the installation of Network Intelligence on the target server.

b. In the Core User Account Password field, enter the password associated with the database schema user. Input appears as a series of asterisks. There is no default.

You should note this value, as it is required during the installation of Network Intelligence on the target server.

c. In the Confirm Core User Account Password field, reenter the password.

9. Click Next.

The Staging Database Schema Connection Details screen appears.

The staging database is populated by the system integrator with the data from the source systems. The staging database contains “delta” information that marks out which data has changed, and when. This information is used to upgrade the core database in an efficient manner.


a. In the Staging User Account field, enter the user of this database schema. The default is netintel_stg.

b. In the Staging User Account Password field, enter the password associated with the database schema user. Input appears as a series of asterisks. There is no default.

c. In the Confirm Staging User Account Password field, reenter the password.

11. Click Next.

The Map Database Schema Connection Details screen appears.

After installation, the map schema contains a basic geometry theme (NI_MAP_THEME), a base map (NETWORK_INTELLIGENCE_MAP_OUTLINE), and several metadata styles.


a. In the Map User Account field, enter the user of this database schema. The default is netintel_map.

b. In the Map User Account Password field, enter the password associated with the database schema user. Input appears as a series of asterisks. There is no default.

c. In the Confirm Map User Account Password field, reenter the password.

Note: If you are installing Network Intelligence into an Oracle 11g database in an Oracle Real Application Clusters configuration, enter the connection details for a single node of the Oracle Real Application Clusters only.



13. Click Next.

The Configure Administrative User Name and Password screen appears. Create a user with the Administrator role.


a. In the Administrative User Name field, enter the name of the user to be assigned the role of administrator in Network Intelligence.

Refer to the Network Intelligence System Administrator’s Guide for more information on using roles in Network Intelligence.

b. In the Administrative User Password field, enter the password associated with the administrator. Input appears as a series of asterisks. There is no default.

c. In the Confirm Administrative User Password field, reenter the password.

15. Click Next.

The Installation Progress screen appears.

16. Click Install.

When the installation is complete, an “Install Finished” message appears. If the installation has not been successful, the error status appears.

17. Select Show Details to display log information listing output and errors (if any) during the installation.

Click OK.

18. Click Exit to complete the installation of the Network Intelligence database.

4

Installing and Configuring Oracle WebLogic Server 4-1

4Installing and Configuring Oracle WebLogicServer

Oracle Communications Network Intelligence is installed and run on an instance of the Oracle WebLogic Administration Server. This chapter describes procedures relating to installing the WebLogic Administration Server and other required applications, and also configuring the WebLogic domain where you install Network Intelligence.

Installation and configuration tasks include:

■ Installing the Java Development Kit (JDK)

■ Downloading and Installing Oracle WebLogic Server

■ Creating a WebLogic Domain for a Single Server Installation

■ Installing and Configuring Oracle Fusion Middleware MapViewer

■ Creating a WebLogic Domain for a Server Cluster Installation

■ Configuring Data Source on Oracle WebLogic Server Cluster

■ Installing and Configuring MapViewer on Oracle WebLogic Server Cluster

■ Deploying Network Intelligence on WebLogic Server Domain or Cluster

■ Installing Oracle HTTP Server

■ Start or Stop Oracle HTTP Server

■ Configure Oracle HTTP Server for Load Balancing

■ Configuring Identity and Trust for Network Intelligence

■ Activating Network Intelligence Logging to WebLogic Server Log

Installing the Java Development Kit (JDK)WebLogic Server is a Java application and needs a Java environment in which to run. You can use any of the available Java environments for your WebLogic server.

When WebLogic Server is installed on IBM AIX, Oracle recommends installing IBM Java.

Note: Ensure that the Administration Server is up and running in the WebLogic domain before you install Network Intelligence.

Downloading and Installing Oracle WebLogic Server


Installing JDKDownload the JDK for the required platform from the Oracle Technology Network web site:

http://www.oracle.com/technology

For information on installing JDK, see the JDK installation documentation.

Installing IBM JavaDownload the Java SDK from the IBM Web site.

For information on installing IBM Java, refer to IBM Java installation documentation.

Downloading and Installing Oracle WebLogic ServerOracle WebLogic Server is available as a component of the Oracle Communications Network Intelligence media pack.

Download Oracle WebLogic Server from the Oracle Communications Network Intelligence media pack on the Oracle software delivery Web site:

https://edelivery.oracle.com/

For information about installing Oracle WebLogic Server, see the Oracle WebLogic Server documentation.

To create a domain for a single server installation refer to "Creating a WebLogic Domain for a Single Server Installation".

To create a domain for a cluster server installation refer to "Creating a WebLogic Domain for a Server Cluster Installation".

Installing PatchesAfter you install Oracle WebLogic Server, you must install any applicable patches. See Table 2–2, " Required Server-Side Software" for information about which patches to download and install.

Download the patches from the My Oracle Support web site:

https://support.oracle.com

Apply the patches using the WebLogic Smart Update tool.

For information about downloading and applying patches, see Knowledge Article 1302053.1 - Master Note: How to Locate and Download Patches for WebLogic Server Using My Oracle Support and Knowledge Article 1075833.1 - Master Note on WebLogic Server (WLS) Patches, Upgrade Installers, and Full Installers.

Configuring the Oracle WebLogic Server Time ZoneYour application server and database server must be set to the same time zone.

Note: The first time you use the update tool, you will be prompted to perform an upgrade. Accept this upgrade, as the tool shipped with the WebLogic Server is outdated.

Creating a WebLogic Domain for a Single Server Installation


To configure the WebLogic Server time zone, you may need to modify the WebLogic domain environment settings for your domain in the following files:

■ On UNIX platforms: setDomainEnv.sh

■ On Windows platforms: setDomainEnv.cmd

Within the file, edit the EXTRA_JAVA_PARAMETERS environment variable definition by adding the following Java argument: -Duser.timezone=required timezone

For example, on Windows, set:

set EXTRA_JAVA_PARAMETERS=%EXTRA_JAVA_PARAMETERS% -Duser.timezone=GMT

See your Oracle WebLogic Server documentation for more information.

Creating a WebLogic Domain for a Single Server InstallationThis section provides instructions on creating a WebLogic domain for a standalone installation.

WebLogic Server Connection InformationTable 4–1 lists WebLogic Server connection details that you are required to provide during the WebLogic Server installation.

Creating the Standalone WebLogic DomainTo create a standalone WebLogic domain:

1. Navigate to the following directory:

WL_Home/common/bin

2. Enter the following command:

./config.sh

The Welcome screen of the Fusion Middleware Configuration Wizard appears.

3. Select Create a New WebLogic domain and click Next.

Table 4–1 Application Server Connection Information


Host Name The host name for this WebLogic Server instance.

current_hostname

Port Number

The number assigned to this specific port. Port numbers are usually predefined and you can accept the provided default value.

7001

User Name Your WebLogic Server user name. You define this name when you install WebLogic Server.

weblogic

Password The password to connect to WebLogic Server as the user for which you provided the user name. You define this password along with the user name during the WebLogic Server installation.

This option has no default value.



The Select Domain Source screen appears.

4. Select Generate a domain configured automatically to support the following products, and from the provided list, select the following products:

■ Oracle Enterprise Manager - version [oracle_common]

■ Oracle JRF - version [oracle_common]

5. Click Next.

The Specify Domain Name and Location screen appears.

6. In the Domain name field, enter a domain name.

7. In the Domain location field, enter the path and directory where the domain files will be created. For example, enter WLS_Home/user_projects/domains/netintel_domain.

Click Next.

The Configure Administrator User Name and Password screen appears.

8. In the User name field, enter the administrator user name.

9. In the User password field, enter the administrator user password. The password must be a minimum of eight alphanumeric characters, and must contain at least one number or special character.

In the Confirm password field, reenter your password.

10. (Optional) In the Description field, enter information about the administrator. For example, enter This user is the default administrator (or whatever text fits your business practices).

11. In the WebLogic Domain Startup Mode section, select the Production Mode option.

In the Available JDKs section, select the required JDK.

12. Click Other JDK to browse to the location of another JDK. Ensure that this JDK is supported.

Click Next.

The Select Optional Configuration page appears.

13. Select the following:

■ Administration Server

■ Managed Servers, Clusters and Machines

■ Deployments and Services

14. Click Next.

Note: Oracle recommends that production environments for Network Intelligence use a minimum of an Administration Server and one or more Managed Servers or Clusters. Lab environments can be installed on an Administration Server only, if desired.

If you select only Administration Server option, the Fusion Middleware Configuration Wizard does not display some dialog boxes pertaining to managed servers or clusters.



The Configure the Administration Server screen appears.


a. In the Name field, enter the Administration Server name.

This single server serves as the Network Intelligence domain Administration Server.

b. In the Listen Address field, select a DNS or an IP address.

c. In the Listen Port field, accept the default 7001 port.

d. In the SSL Listen Port field, enter a port that is not used by another domain.

e. Select SSL enabled if you are enabling SSL.

It is not a requirement to either enable or disable SSL.

f. Click Next.

The Configure Managed Servers screen appears.

16. (Optional) Do the following:

a. Click Add to add a managed server to the cluster.

b. In the Name field, enter a name for the managed server.

c. In the Listen address field, enter the host, or IP address of the machine where the managed server is running.

d. In the Listen port field, enter the number of the port where the managed server will listen for incoming messages.

e. In the SSL listen port field, enter the appropriate value only if SSL is selected.

f. Select SSL enabled as required.

g. (Optional) Click Add to add more managed servers as required on your Network Intelligence deployment.

h. Click Next.

The Configure Clusters screen appears.

17. Click Next, as you are performing a standalone installation, that is, you are not using clustering in this installation.

The Configure Machines screen appears.

Use this screen to change the configuration information for systems. A computer is the logical expression of the system that hosts one or more WebLogic Server instances. The Administration Server and the Node Manager application use the system definition to start remote servers.

Note: Use listener addresses that are equal to a resolvable DNS host or IP address. Do not use localhost or 127.0.0.1. Those addresses interfere with clustered servers.


Installing and Configuring Oracle Fusion Middleware MapViewer


18. Add the machines by doing one of the following:

■ Select the Machine tab, and do the following:

a. Click Add to create the first machine.

b. In the Name field, enter a name for the machine.

c. In the Node manager listen address field, enter the DNS host or IP address of the node manager.

d. In the Node manager listen port, enter the port number for the node manager.

e. Create further machines as required on your Network Intelligence deployment.

f. Click Next.

The Assign Servers to Machines screen appears.

■ Select the Unix Machine tab, and do the following:

a. Click Add to create the first UNIX machine.

b. If required, select Post bind GID enabled. The default state is unselected.

c. In the Post bind GID field, enter a value or select the default.

d. In the Post bind UID field, enter a value or select the default.

e. In the Node manager listen address field, enter the host, or IP address of the node manager.

f. In the Node manager listen port field, enter the port number of the node manager.

g. (Optional) Create further machines or UNIX machines as required on your Network Intelligence deployment.

h. Click Next.


19. Select servers in the left pane and click Select All to select all of the servers in the right pane to target them to the selected machine.

Click Next.

The Configuration Summary screen appears.

20. Review the summary to verify the contents of your domain.

Click Previous to return to prior screens to modify their content.

21. Click Create to create the domain.

22. To finish the domain creation process, click Done, after the domain is created successfully.

For more information on Oracle WebLogic Server domains, see Oracle Fusion Middleware Installation Guide for Oracle Enterprise Content Management.

Installing and Configuring Oracle Fusion Middleware MapViewerOracle Fusion Middleware MapViewer is a tool for rendering maps using spatial data. It provides the functionality for overlaying site, equipment, and circuit information on background maps within Network Intelligence.



MapViewer must be installed so that Network Intelligence users can access geographical map reports within Network Intelligence. MapViewer must be installed before installing the Network Intelligence database because the MapViewer install creates metadata tables that the Network Intelligence database install subsequently populates.

Installing Oracle Fusion Middleware MapViewerTo install MapViewer in a production environment, Oracle recommends that you create a separate WebLogic domain for MapViewer, and install MapViewer in this WebLogic domain.

To download the correct version of Oracle Fusion Middleware MapViewer for use with Network Intelligence:

1. Click the following link:

http://www.oracle.com/technetwork/middleware/mapviewer/downloads/index-100641.html

2. Download the Oracle Fusion Middleware User's Guide for Oracle MapViewer document, from the Oracle Fusion Middleware MapViewer Version 11g ps5 (11.1.1.6).

3. To install MapViewer, refer to the chapter "Installing and Deploying MapViewer" in the Oracle Fusion Middleware User's Guide for Oracle MapViewer document.

Creating System ViewsMapViewer uses a set of system views to store necessary mapping metadata in a target database. A target database is a database with Oracle Spatial or Oracle Locator (Release 8.1.6 or later) installed and from which you want MapViewer to be able to render maps. MapViewer requires following system views:

■ USER_SDO_MAPS

■ USER_SDO_THEMES

■ USER_SDO_STYLES

■ USER_SDO_CACHED_MAPS

To create the system views, refer to the chapter "Running SQL Scripts" in the Oracle Fusion Middleware User's Guide for Oracle MapViewer.

Creating a Map SchemaYou must create a map schema similar to the schemas required for the core database and the staging database. See "Map Database Information You Must Record".

During the installation of the Network Intelligence database, enter the schema connection values in the Map Database Schema Connection Details screen. See "Setting Up the Network Intelligence Database".

Note: MapViewer must be installed for users to view networks on geographical maps, but if users are using only standard network diagrams, MapViewer is not required. If MapViewer is not installed, and a user attempts to view a geographic map in Network Intelligence, an error message appears.



Configuring MapViewerTo deploy and start MapViewer in WebLogic Server, refer to the “Introduction to MapViewer” chapter of Oracle Fusion Middleware User's Guide for Oracle MapViewer.

After you download, install, deploy, and start MapViewer, log on to the MapViewer Admin console using the MapViewer URL:

http://host_name:mapviewer-port/mapviewer

Where host_name is the name of the Network Intelligence host and mapviewer-port is the port number on which MapViewer listens.

Specifying a Permanent Data SourceTo specify a permanent data source:

1. From the MapViewer Admin console, click the Configuration link.

2. Modify the mapViewerConfig.xml file.

The following is an example of the mapViewerConfig.xml file. The relevant parameters (jdbc_host, jdbc_sid, jdbc_port, jdbc_user, jdbc_password) must be updated to point to the Network Intelligence core schema and the Network Intelligence map schema:

3. Click Save & Restart.

Using Map OutlinesThis section deals with using map outlines. It consists of the following topics:

■ Downloading Maps

■ Using Prepackaged Outline Maps

Downloading MapsThe installation of MapViewer includes several pre-packaged outline maps. If you require additional maps, you can obtain maps from a variety of sources, including recognized vendors like NAVTEQ. To obtain sample map data, refer to the NAVTEQ section at the following link:

http://www.oracle.com/technetwork/database/options/spatial/index.html

Note: The permanent data source must use the JDBC credentials of the Network Intelligence core schema and the Network Intelligence map schema. For more information about defining permanent data sources, see Oracle Fusion Middleware User's Guide for Oracle MapViewer.



For detailed instructions on building maps and loading them into MapViewer, see the MapViewer documentation.

Using Prepackaged Outline MapsTo use the pre-packaged outline maps supplied with this release of Network Intelligence:

1. Download the Network Intelligence Map Data ZIP file from the Network Intelligence media pack from the Oracle software delivery Web site:

https://edelivery.oracle.com

2. Unzip the map data ZIP file into a temporary directory.

The ZIP file contains the following:

■ map_outline_metadata_scripts.zip: Contains scripts used to add the appropriate entries into the user_sdo_geom_metadata table, and create relevant spatial indexes for each of the tables contained in the ni_map_34100.dmp file.

■ ni_map_version.dmp: Contains the database tables populated by the metadata scripts.

3. Log in to SQL*Plus as SYSTEM, and execute the following scripts to create a directory containing a dump file:

SQL> create or replace directory DATAPUMP as '/home/oracle/installfiles';SQL> grant read, write on directory DATAPUMP to NI_MAP;

Where DATAPUMP is the directory containing the dump file to be imported, and NI_MAP is the username into whose schema the data is being imported.

4. Log out of SQL*Plus, and exit to the command line.

5. Import the ni_map_72200.dmp file using Oracle Data Pump, which enables you to move data and metadata from one database to another.

The following sample code carries out an import of a dump file. This example may be different for your installation:

$ impdp ni_core_map/ni_core_map@athe6dbremap_schema=ni_map_dump:ni_core_map TRANSFORM=oid:n:typeDUMPFILE=DATAPUMP:ni_map_72200.dmpLOGFILE=DATAPUMP:ni_map_dump_72200.log

Refer to the Oracle Data Pump documentation in Oracle Database Utilities for further information.

6. Use SQL*Plus to run the following scripts connected as the map schema:

POPULATE_NTC_MAP_OCEAN_AREA_METADATA.sqlPOPULATE_NTC_MAP_POI_CITY_GE_1000_GEOMETRIC_METADATA.sqlPOPULATE_NTC_MAP_ROAD_HIGHWAY_AGGR_GEOMETRIC_METADATA.sqlPOPULATE_NTC_MAP_WATER_AREA_METADATA.sqlPOPULATE_WOM_ADMIN_LINE_GEOMETRIC_METADATA.sqlPOPULATE_WOM_AREA_GEOMETRIC_METADATA.sql

Note: These scripts add the appropriate entries into the user_sdo_geom_metadata table and create relevant spatial indexes for each of the tables contained in the ni_map_version.dmp file.

Creating a WebLogic Domain for a Server Cluster Installation


After the data has been imported, and these scripts executed, the data in these tables are available to be rendered; for example: from Oracle Map Builder, new geometry themes based on these tables (for example: the WOM_AREA table) can be created.

Defining the DATAPUMP Directory Before Importing Map DataIn the sample SQL for importing map data in the “Using Prepackaged Outline Maps” section of the Network Intelligence Pre-Installation Tasks chapter of Network Intelligence System Administration and Installation Guide, it is not explicitly stated that you must first define the DATAPUMP directory before executing the impdp command.

To create the DATAPUMP directory, follow these steps. These commands are examples, and may be different for your installation:

1. Log in to SQL*Plus as SYSTEM, and execute the following scripts:

SQL> create or replace directory DATAPUMP as '/home/oracle/installfiles';SQL> grant read, write on directory DATAPUMP to NI_MAP;

Where DATAPUMP is the directory containing the dump file to be imported, and NI_MAP is the username into whose schema the data is being imported.

2. Exit to the command line, and execute the impdp command as described in the procedure in the “Using Prepackaged Outline Maps” section, that is:

$ impdp ni_core_map/ni_core_map@athe6dbremap_schema=ni_map_dump:ni_core_map TRANSFORM=oid:n:typeDUMPFILE=DATAPUMP:ni_map_72200.dmpLOGFILE=DATAPUMP:ni_map_dump_72200.log

Populating the NI_MAP TableAfter the steps outlined in "Using Prepackaged Outline Maps" have been carried out, the map data is available in the map schema (that is, the required tables have been correctly populated), and the NI_MAP table can also be populated.

Populating the NI_MAP table can be done using SQL*Plus; for example to do this for Ireland (denoted by IRL):

insert into ni_map (select carto_id, name, iso_country_code, geometry from wom_area where iso_country_code = 'IRL');

More detailed maps or tiles can be configured using the map outline data included with Network Intelligence, or other map outline data, with MapBuilder.

Configuring MapViewer in Network IntelligenceTo configure MapViewer in Network Intelligence, refer to "Configuring the APP_CONFIGURATION Table to Communicate with MapViewer".

To set the memory requirements for Network Intelligence refer to "Setting Memory Requirements for Network Intelligence".

Creating a WebLogic Domain for a Server Cluster Installation A WebLogic Server cluster consists of multiple WebLogic Server instances running simultaneously and working together to provide increased scalability and reliability. A



cluster appears to clients to be a single WebLogic Server instance. The server instances that constitute a cluster can run on the same machine, or be located on different machines. You can increase a cluster's capacity by adding additional server instances to the cluster on an existing machine, or you can add machines to the cluster to host the incremental server instances.

In each WebLogic domain, one WebLogic Server instance acts as the Administration Server—the server instance which configures, manages, and monitors all other server instances and resources in the domain. Each Administration Server manages one domain only. If a domain contains multiple clusters, each cluster in the domain has the same Administration Server. All server instances in a cluster must reside in the same domain; you cannot "split" a cluster over multiple domains. Similarly, you cannot share a configured resource or subsystem between domains.

Detailed configuration recommendations are included throughout the instructions in Setting up WebLogic Clusters in the Oracle Fusion Middleware Using Clusters for Oracle WebLogic Server 11g Release 1 (10.3.6) documentation.

Benefits of WebLogic ClusteringA WebLogic Server cluster provides these benefits:

■ Scalability

The capacity of an application deployed on a WebLogic Server cluster can be increased dynamically to meet demand. You can add server instances to a cluster without interruption of service—the application continues to run without impact to clients and end users.

■ High-Availability

In a WebLogic Server cluster, application processing can continue when a server instance fails. You "cluster" application components by deploying them on multiple server instances in the cluster—so, if a server instance on which a component is running fails, another server instance on which that component is deployed can continue application processing.

Key Capabilities of a ClusterThe key capabilities of a cluster include:

■ Failover and Replication

Failover means that when an application component doing a particular "job"—some set of processing tasks—becomes unavailable for any reason, a redirect the “job” to replicated instance for finish. By default, WebLogic Server attempts to create session state replicas on a different machine than the one that hosts the primary session state.

Network Intelligence use WebLogic in-memory HTTP session replication, server copies a session state from one server instance to another. The primary server creates a primary session state on the server to which the client first connects, and a secondary replica on another WebLogic Server instance in the cluster. The replica is kept up-to-date so that it may be used if the server that hosts the servlet fails. For more details, see Failover and Replication in a Cluster in the Oracle Fusion Middleware Using Clusters for Oracle WebLogic Server 11g Release 1 (10.3.6) documentation.

■ Load Balancing HTTP Session



Load balancer provides a virtual server acting as the single point of entry for a group of real servers and distributes requests across the real servers depending on the load balancing algorithm and the availability of the servers. For more details, see Load Balancing in a Cluster in the Oracle Fusion Middleware Using Clusters for Oracle WebLogic Server 11g Release 1 (10.3.6) documentation.

Installation ScenarioThis installation scenario includes three clustered Managed Servers (netintel01, netintel02 and netintel03) that are separate from the Administration Server, an Administration server, and an Oracle HTTP Server, used for load balancing. Managed Servers in cluster are instances of WebLogic used to host enterprise applications, in this case, Network Intelligence.

Server Cluster ExampleRefer to Table 4–2 and Figure 4–1, "Servers in a Sample Cluster" to set up the cluster arrangement.

Figure 4–1 shows the servers in a sample server cluster.

Note: Oracle Fusion Middleware MapViewer tool will be installed on the same clustered Managed Servers as Network Intelligence application provides MapViewer the same WebLogic Cluster benefits - balancing, scalability, and failover.

Table 4–2 Server Cluster Example Values

Value Example

Domain_Home WLS_Home/user_projects/domains/netintel_domain

Domain login weblogic

Domain password weblogic1

Table 4–3 Servers in a Sample Cluster

ValueAdministration Server

Cluster-Managed Server #1



WebLogic server AdminServer netintel01 netintel02 netintel03

Listening http port IP_Address:7001 IP_Address:7004 IP_Address:7005 IP_Address:7006

Listening https port IP_Address:7011 IP_Address:7014 IP_Address:7015 IP_Address:7016

Machine SERVER_1 SERVER_1 SERVER_1 SERVER_1

Note: For Server Cluster Example all WebLogic servers are installed on one machine. This installation is not ideal for production installation where every server in WebLogic Domain should be running on different machine. But new hardware and software technologies provide high performance solutions where is possible effectively run more WebLogic servers on one machine or on separate OS slices on one machine.



Figure 4–1 Servers in a Sample Cluster

Overview of Steps for Setting Up Network Intelligence on an Oracle WebLogic Server ClusterFor the considered scenario, installing an Oracle WebLogic Server cluster arrangement involves:

■ Installing Oracle WebLogic Server Instance

■ Creating a Domain

■ Starting WebLogic Server

■ Starting the WebLogic Managed Servers

■ Starting the WebLogic Managed Servers in Administration Console

■ Configuring the WebLogic Server for use with Oracle HTTP Server Load Balancing

Installing Oracle WebLogic Server InstanceInstall WebLogic on the SERVER_1 machine, except the procedure to create a domain.

After you install WebLogic Server:

■ Create a domain

■ Start the WebLogic server



Creating a DomainTo create a domain:

1. Navigate to the WLS_Home/common/bin directory and run the following command:

./config.sh

The Welcome screen appears.

2. Select Create a new WebLogic domain and click Next.

The Select Domain Source screen appears.

3. Select the Generate a domain configured automatically to support the following products: option, and from the provided list, select the following products:

■ Oracle Enterprise Manager - 11.1.1.0 [oracle_common]

■ Oracle JRF - 11.1.1.0 [oracle_common]

The Specify Domain Name and Location screen appears.


a. In the Domain name field, enter a domain name that meets your requirements or standards.

b. In the Domain location field, enter the path and directory where the domain files will be created. For example, enter WLS_Home/user_projects/domains/netintel_domain.

c. In the Application location field, enter the path and directory for the application files. For example, enter WLS_Home/user_projects/domains/netintel_domain.

d. Click Next.

The Configure Administrator User Name and Password screen appears.


a. In the User name field, enter the administrator user name.

b. In the User password field, enter the administrator user password. The password must be a minimum of 8 alphanumeric characters, and must contain at least one number or special character.

c. In the Confirm password field, reenter your password.

d. (Optional) In the Description field, enter information about the administrator.

For example: This user is the default administrator.

Note: You have to install Oracle Application Development Runtime 11g to make the Oracle Enterprise Manager and Oracle JRF products available when creating the domain.

For information on installing Oracle Application Development Runtime 11g, see the Oracle WebLogic documentation. For more information on the Application Development Framework, see Oracle Fusion Middleware Fusion Developer's Guide for Oracle Application Development Framework.



e. Click Next.

The Configure Server Start Mode and JDK screen appears.

6. In the WebLogic Domain Startup Mode section, select one of the following:

■ Development Mode, or

■ Production Mode (recommended mode)

7. In the Available JDKs section, select the required JDK.

8. Click Other JDK and browse to the location of another JDK and click Next.

The Select Optional Configuration page appears.

9. Select the following:

■ Administration Server

■ Managed Servers, Clusters and Machines

■ Deployments and Services

Click Next.

The Configure the Administration Server screen appears.


a. In the Name field, enter your Administration Server name.

b. In the Listen Address field, select a DNS or an IP address.

c. In the Listen Port field, accept the default 7001 port.

d. In the SSL Listen Port field, enter a port that is not used by another domain.

e. Select SSL enabled if you are enabling SSL.

It is not a requirement to either enable or disable SSL.

f. Click Next.

The Configure Managed Servers screen appears.


a. Click Add to add a managed server to the cluster.

b. In the Name field, enter a name for the managed server.

c. In the Listen address field, enter the DNS host, or IP address of the machine where the managed server is running.

Note: Ensure that your selected JDK is supported.





d. In the Listen port field, enter the number of the port where the managed server will listen for incoming messages.

e. In the SSL listen port field, enter the appropriate value only if SSL is selected.

f. Select SSL enabled as required.

g. (Optional) Click Add to repeat the Managed Server creation steps for all required servers (netintel01, netintel02, netintel03).

h. Click Next.

The Configure Clusters screen appears.


a. Click Add to start configuring the cluster.

b. In the Name field, enter the name for the cluster. Example: netintel_cluster.

c. In the Cluster messaging mode field, provide information about the messaging type to use in the cluster - use unicast type.

d. Leave the Multicast address field empty.

e. Leave the Multicast port field empty.

f. Leave the Cluster address field empty, WebLogic Server will generate the address automatically.

g. Click Next.

The Assign Servers to Clusters screen appears.

13. Assign the Managed Servers (netintel01, netintel02, netintel03) to the cluster by moving the managed servers in the left pane to the required cluster in the right pane.

Click Next.

The Configure Machines screen appears. Use this screen to change the configuration information for the machines. A machine is the logical expression of the system that hosts one or more WebLogic Server instances. The Administration Server and the Node Manager application use the machine definition to start remote servers.

14. (Optional) Add the machines by doing one of the following:

■ Select the Machine tab, and do the following:

a. Click Add to create the first machine.

b. In the Name field, enter a name for the machine.

c. In the Node manager listen address field, enter the host, or IP address of the node manager.

d. In the Node manager listen port, enter the port number for the node manager.

Note: For manual Cluster address setup follow next syntax: The cluster address contains each managed server along with the managed server's port separated by a comma. Separate the managed server and the port number by a colon.



e. Create further machines as required on your Network Intelligence deployment.

f. Click Next.

■ Select the Unix Machine tab, and do the following:

a. Click Add to create the first UNIX machine.

b. If required, select Post bind GID enabled. The default state is unselected.

c. In the Post bind GID field, enter a value or select the default.

d. In the Post bind UID field, enter a value or select the default.

e. In the Node manager listen address field, enter the host, or IP address of the node manager.

f. In the Node manager listen port field, enter the port number of the node manager.

g. (Optional) Create further machines or UNIX machines as required on your Network Intelligence deployment.

h. Click Next.


15. Select servers in the left pane and click Select All to select all of the applications in the right pane to target them to the selected clusters or servers.

Click Next.

The Configuration Summary screen appears.

16. Review the summary to verify the contents of your domain. Click Previous to return to prior screens to modify their content.

17. Click Create to create the domain.

18. After the domain is created successfully, click Done.

19. Continue with the procedures in "Starting WebLogic Server".

For more information on configuring managed cluster servers, see Configuring Managed Cluster Servers.

Starting WebLogic ServerTo start the WebLogic server:

1. Open a comma