1/20

Contents

Title and Copyright Information

Preface

• Audience
• Related Documents
• Documentation Accessibility

1 Installation Overview

• Installation Process
• Software Requirements
• If You Are a New Customer
• If You Are an Existing Customer
• Database Upgrade Path
• Application Server Upgrade Path
  • Related Software Dependencies
• Downloading the Installation Files
  • Identifying the Installation Files
  • Where to Download the Files
• Data Migration
• Basic Installation Steps
• Pre-installation Checklist
• Installing on a UNIX/Linux Platform
• Directory Placeholders Used in This Guide

2 Setting Up The MSS Database

• Getting the Database to the Current GA Level
• Database Space Requirements
• Prerequisites
• Extracting the MSS Database Scripts
• Creating Tablespaces (New Customers Only)
• Running the Installation Scripts (New Customers Only)
  • Prerequisites
• Running the Upgrade Scripts (Existing 5.2.x Customers Only)
  • Prerequisites
  • Running the Upgrade Scripts
  • Dropping the appdata Tablespace
• Database Post-Installation Tasks

3 Preparing For the Application Server Installation

• About Required Software Installation
  • Oracle WebLogic Software Installation on an MSS Host Machine
  • About the Oracle WebLogic Installation
    • Where to Find Oracle WebLogic Server Software
    • Installation Notes
    • Setting the MW_HOME Environment Variable
    • Installing WebLogic Patches
• Using the IBM AIX Operating System
• About JacORB
• How the Installer Works
• Directory Structure
• Using Worksheets to Plan Your Installation
• Pre-requisites for the Latest MSS Release

4 Installing and Deploying MetaSolv Solution on a Single Server

• About Single Server Installation
  • Before You Start
  • Creating a Single Server WebLogic Domain
    • Configuring SSL for WebLogic Server
    • Installing the Self-Signed Certificate on the Client Machine
  • Installing and Deploying MSS
    • Prerequisites
  • Correcting the Specified Number of RAC Nodes
  • Verifying the Installation

5 Installing and Deploying MetaSolv Solution on a Clustered Server

• About Clustered Server Installation
  • Before You Start
  • Creating the Clustered Server WebLogic Domain
    • Verifying the Clustered WebLogic Domain Setup
    • Configuring SSL for WebLogic Server
    • Installing the Self-Signed Certificate on the Client Machine
  • Installing and Deploying MSS
    • Prerequisites
  • Verifying the Deployment and Configuration
    • JMS Connection Factories and Distributed Destinations
    • JMS Servers
  • Multiple Single Server Instances on the Same Machine

6 Upgrading Oracle Communications MetaSolv Solution

• MSS Application Server Upgrade Process
• Downloading the Maintenance Release or Patch Software
• Installing a Maintenance Release or Patch on the Database
  • Extracting the MSS Database Scripts
  • Updating the Database by Running SQL Scripts
  • Updating Stored Procedures
  • Running Reports
• Upgrading the MSS Application Server
  • Installation Options for the Application Server
  • Single Server Upgrade Basic Steps
  • Single Server Upgrade
    • Preparing for the Upgrade
    • Undeploy Previously Installed Applications
    • Installing the Upgrade
    • Deploying the Application
    • Completing Post-Upgrade Tasks
  • Clustered Server Upgrade Basic Steps
  • Clustered Server Upgrade
    • Preparing for the Upgrade
    • Undeploy Previously Installed Applications
    • Installing the Upgrade
    • Deploying the Application
    • Completing Post-Upgrade Tasks
• Updating Client Workstations

7 Installing The Client Workstation

• Installation Methods
• Editing Internet Explorer 11 Registry Settings
• Installing the Client Application Manually
• Starting the MSS Client
• Tools and Utilities
  • NPA NXX Split Utility
    • Modifying the NPASplit.ini File
    • Creating NPA NXX Split Utility Oracle Tables
  • MetaSolv Solution Utilities
  • Background Processor
  • Location and Routing Gateway
  • Installing a Utility to a Separate Installation Directory

8 Performing Post-Installation Tasks

• Verifying the Database
• Loading New and Updated Graphics to the Database
• Loading Preferences to the Database
• Compiling Invalid Objects for Oracle Database
• User Authentication
  • Oracle Database Authentication
  • Oracle WebLogic Authentication
  • Third-party Authentication
    • Developing a JAAS Logon Module
    • Configuring a JAAS Logon Module
  • Encrypting Network Traffic
  • Gateway Events Setup
  • Internationalization Web Service Character Set
• Adding Your Company Logo to the MSS My Desktop and Forms
• What to Do Next to Secure MSS

9 Configuring JDBC Active GridLink Data Sources

• About Oracle RAC
• Creating the JDBC Active GridLink Data Sources
  • JDBC Data Source Properties
  • Manually Creating the JDBC Active GridLink Data Sources
  • Creating JDBC Active Data Sources by Updating the Configuration Files
• Tuning JDBC Multi Data Source

10 Performing Maintenance and Troubleshooting

• Basic Maintenance
  • Starting the MSS System
  • Uninstalling MSS
  • Changing an IP Address
    • Changing an IP Address for Clustered Servers
    • Changing an IP Address for Single or Administration Servers
• Troubleshooting Database Issues
  • ORA-12519, TNS: No Appropriate Service Handler Found
  • ORA-01979: missing or invalid password for role WOTSTWTWWOO or ADMIN_ROLE
  • ORA-39384: Warning: User <USERNAME> Has Been Locked And The Password Expired During Import
  • SQL*Plus Quits During the Upgrade
  • Restarting a Failed Upgrade Attempt With the Incorrect Mode
  • Upgrade Failure and Losing Audits
  • Database Graphics Not Displaying Correctly
  • No Database Log Files
• Troubleshooting MSS Installation Issues
  • Destination Unreachable Error in AppServerLog.xml in IPv6 Environment
  • Generation Problem or Error for the Nameservice.ior File
  • Web Service Deployment Warning Message
  • Access Problem for the WebLogic Console and MSS Application Using IPv6 Address
  • The Runtime Information Page is Not Displayed
    • Enabling HTTP Tunneling
  • Check Box To Select the Server Name is Not Displayed in the MSS Installer
  • My Desktop Page is Not Displayed
  • Number Format Exception When Starting the Proxy Server
  • Unable to Log In to the MSS Application
  • Updates to the web.xml File of the Proxy Server are Not Reflected
  • Updates to orb.properties for SSL and AIX Platform
  • Managed Server Startup Warning When Servers on Different Machines
  • DLL Error when Connecting to the Database
  • Window Response Delay from MSS in SSL Environment After No Activity
  • CORBA Error During Integration Between MSS and Network Integrity
  • Known Issues with Reconfiguration Wizard (Only if Reconfiguration Wizard is used to Migrate WebLogic Domain)

A Proxy Server Setup

• Proxy Server Files
• Setting up the Proxy Server

B Oracle Communications MetaSolv Solution Components

C Planning Worksheets

• MSS Installation
  • Application Server Common Installation Worksheet
  • Single Server Installation Worksheet
  • Admin Server Installation Worksheet
  • Clustered Server General Installation Worksheet
  • Clustered Server Installation Worksheet
  • WebLogic Proxy Server Installation Worksheet
  • Hardware Load Balancer Installation Worksheet

D Configuration Values

E Load Balancer Configuration Example

F Tuning Servers For Performance

• Information on Tuning the Application Server
• Connection Pool Settings
• JVM Memory Argument Settings

G Configuration Files

• loggingconfig.xml File
• gateway.ini File