with ibm corp. · installing oracle 12c ..... . 39 installing oracle rdbms (stand-alone system or...

144
IBM Tivoli Netcool Performance Manager 1.4.3 Wireless Component Document Revision R2E1 Installation Guide IBM

Upload: others

Post on 30-Jul-2020

19 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

IBM Tivoli Netcool Performance Manager 1.4.3Wireless ComponentDocument Revision R2E1

Installation Guide

IBM

Page 2: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

NoteBefore using this information and the product it supports, read the information in “Notices” on page 125.

© Copyright IBM Corporation 2006, 2017.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

Page 3: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Contents

Introduction . . . . . . . . . . . . . vIntended audience . . . . . . . . . . . . vRequired skills and knowledge . . . . . . . . viThe Tivoli Netcool Performance Manager - Wirelesscomponent user publications. . . . . . . . . viService Management Connect . . . . . . . . viiTivoli Netcool Performance Manager technicaltraining . . . . . . . . . . . . . . . viiSupport information . . . . . . . . . . . viiConventions used in this publication . . . . . . vii

Typeface conventions . . . . . . . . . . vii

Chapter 1. Installation process . . . . . 1Preinstallation roadmap . . . . . . . . . . 1Installation roadmap. . . . . . . . . . . . 2

Chapter 2. Planning your installation . . 3Tivoli Netcool Performance Manager distribution . . 3Components of Tivoli Netcool Performance Manager 3

Supported configurations . . . . . . . . . 4

Chapter 3. Preparing for the Installation 5Server hardware and software requirements . . . . 5

Server hardware requirements . . . . . . . 5Server software requirements . . . . . . . . 5

Client computer hardware and softwarerequirements on Microsoft Windows . . . . . . 11

Client hardware requirements . . . . . . . 11Client software requirements . . . . . . . 11

Chapter 4. Preinstallation tasks . . . . 13Prerequisites . . . . . . . . . . . . . . 13

Required server information . . . . . . . . 13Required file systems . . . . . . . . . . . 13Ports and firewall configurations . . . . . . . 15

Distributed installations with Application,Loader, or Directory Servers on RHEL . . . . 16

Installing the platform package . . . . . . . . 17Creating user and group accounts . . . . . . . 18Setting directory ownership . . . . . . . . . 19Configuring the kernel . . . . . . . . . . 19Setting up the domain name. . . . . . . . . 20Setting up the host name . . . . . . . . . . 21Building Perl on Gateway servers . . . . . . . 21Setting memory for Java client processes . . . . 22

Chapter 5. Installing Jazz for ServiceManagement . . . . . . . . . . . . 23Hardware and software requirements for installingJazz for Service Management . . . . . . . . 24Quick reference to Jazz for Service Managementinstallation . . . . . . . . . . . . . . 24

Starting Jazz for Service Management applicationservers . . . . . . . . . . . . . . . 28

Stopping Jazz for Service Managementapplication servers . . . . . . . . . . . 28

Disabling the Cognos Application Firewall forbrowser security . . . . . . . . . . . . . 29Uninstalling Jazz for Service Management . . . . 29

Chapter 6. Running the DependencyChecker tool . . . . . . . . . . . . 31

Chapter 7. Installing Oracle RDBMSand the Oracle client. . . . . . . . . 37Configuring Oracle environment variables . . . . 37Setting kernel parameters. . . . . . . . . . 38Installing Oracle 12c . . . . . . . . . . . 39

Installing Oracle RDBMS (stand-alone system ordatabase server) . . . . . . . . . . . . 39Installing Oracle database 12c Client (ApplicationServer or Tivoli Common Reporting server inDistributed Systems only) . . . . . . . . 41Installing Oracle 12.1.0.2.0 Instant Client(stand-alone Server or database Server combinedwith Tivoli Common Reporting server) . . . . 43

Checking Oracle configuration . . . . . . . . 44Stopping the listener process . . . . . . . . 44

Chapter 8. Installing the SecurityDirectory Server and IBM DB2 . . . . 45Required packages . . . . . . . . . . . . 45Running the Security Directory Server installationscripts . . . . . . . . . . . . . . . . 46Installing the Security Directory Server client . . . 48

Chapter 9. Installing the Tivoli NetcoolPerformance Manager software . . . . 49Prerequisites . . . . . . . . . . . . . . 49Installing Tivoli Netcool Performance Manager onOracle Solaris 11 . . . . . . . . . . . . . 50Installing a stand-alone system unattended . . . . 51Installation of a stand-alone system . . . . . . 52

Running an interactive installation. . . . . . 52Installing the JBoss application server . . . . 53Installing the directory server schema . . . . 54Installing the database . . . . . . . . . . 54Installing the database schema . . . . . . . 55Database schema post-installation tasks . . . . 56Installing the cronjobs . . . . . . . . . . 56Installing the Gateways . . . . . . . . . 57Installing the technology packs . . . . . . . 57Encrypting passwords . . . . . . . . . . 60

Installing a distributed system . . . . . . . . 61Running an interactive installation. . . . . . 61Installing a database server . . . . . . . . 61Installing a separate directory server . . . . . 67Installing the Application Server . . . . . . 70

© Copyright IBM Corp. 2006, 2017 iii

Page 4: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Installing a Loader Server . . . . . . . . 76Installing the Gateways separately. . . . . . 79

Chapter 10. Installing the technologypacks separately . . . . . . . . . . 81Starting the system . . . . . . . . . . . . 81Setting up users and data sources . . . . . . . 82Checking database space . . . . . . . . . . 82Installing the technology pack: step 1. . . . . . 83Installing the technology pack: step 2. . . . . . 84Performing postinstallation checks for thetechnology packs . . . . . . . . . . . . 84Starting the SAP process monitor tool . . . . . 86Starting the Application Server . . . . . . . . 87Starting the Loaders . . . . . . . . . . . 87Configuring multiple identical Loaders . . . . . 88Loading data . . . . . . . . . . . . . . 89

Verifying data loading . . . . . . . . . . 89Removing Loadmaps and Loader configuration . . 90Creating a Loader on a distributed server . . . . 91

Chapter 11. Postinstallation tasks . . . 93Provisioning stored Busy Hours, Summaries, andData Availability. . . . . . . . . . . . . 93

Stored Busy Hours definitions . . . . . . . 93Summary definitions . . . . . . . . . . 94Data Availability definitions . . . . . . . . 94

Configuration of the Application Server memory(Optional) . . . . . . . . . . . . . . . 95

The jvm.args property . . . . . . . . . . 95Recommended jvm.args Property settings forApplication Servers. . . . . . . . . . . 96

Configuration of Loader Server memory(Recommended) . . . . . . . . . . . . . 96

The SAP configuration params property . . . . 97Recommended JVM memory size settings forLoader Servers . . . . . . . . . . . . 98

Checking the Time Zone settings for the ReportScheduler . . . . . . . . . . . . . . . 98

Setting the Time Zone . . . . . . . . . . 98Changing the default client ports . . . . . . . 99Editing the default.properties file . . . . . . 99Integrating IBM Tivoli Monitoring . . . . . . . 99Integrating IBM Tivoli Netcool/OMINbus WebGUI . . . . . . . . . . . . . . . . 100

Chapter 12. Starting Tivoli NetcoolPerformance Manager. . . . . . . . 101Rebooting the server . . . . . . . . . . . 101Process checks for Solaris . . . . . . . . . 102Process checks for AIX . . . . . . . . . . 102Process checks for Linux . . . . . . . . . 103Completing startup of Tivoli Netcool PerformanceManager - Wireless component . . . . . . . 104

Chapter 13. Enable CommonReporting on Tivoli NetcoolPerformance Manager. . . . . . . . 107Tivoli Netcool Performance Manager - ApplicationStudio . . . . . . . . . . . . . . . . 107

Appendix A. Installation output. . . . 109

Appendix B. Log file errors . . . . . 119

Appendix C. Dependency Checkererrors. . . . . . . . . . . . . . . 121

Notices . . . . . . . . . . . . . . 125Trademarks . . . . . . . . . . . . . . 127Terms and conditions for product documentation 128

Index . . . . . . . . . . . . . . . 131

iv IBM Tivoli Netcool Performance Manager: Installation Guide

Page 5: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Introduction

Explains how to install and configure Tivoli® Netcool® Performance Manager, 1.4.3.

Note: If you are upgrading Tivoli Netcool Performance Manager, see theUpgrading Tivoli Netcool Performance Manager - Wireless Component.

Important: Before you install Tivoli Netcool Performance Manager, you areadvised to read the Release Summary for Tivoli Netcool Performance Manager.Release summary contains information specific to your installation that is not apart of this guide. Failure to consult the release notes might result in a corrupted,incomplete, or failed installation.

Intended audienceRead this information if you want to install Tivoli Netcool Performance Manager,1.4.3- Wireless Component. This information is intended for:v Experienced system administratorsv Database administratorsv Product installers

Required skills and knowledge

Readers must be familiar with the following topics:v Hardware:

– IBM® PowerPC®

– Oracle– x86-64

v Operating System:

AIX®

Oracle Solaris

Red Hat Enterprise Linux

Microsoft Windowsv Database:

– Oracle databasev Other software

– Jazz™ for Service Management and its components

© Copyright IBM Corp. 2006, 2017 v

Page 6: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Required skills and knowledgeTo install Tivoli Netcool Performance Manager, you must be familiar with thefollowing technologies:v Hardware:

– Oracle Solaris– x86-64– IBM PowerPC

v Operating System:

AIX

Oracle Solaris

Red Hat Enterprise Linux

Microsoft Windowsv Database:

– Oracle

The Tivoli Netcool Performance Manager - Wireless component userpublications

Tivoli Netcool Performance Manager - Wireless component consists of thefollowing publications:

Table 1. Tivoli Netcool Performance Manager - Wireless component user documentation

Document Description

Release Summary for Tivoli Netcool PerformanceManager

Additional release-specific information not in theguides.

Installing Tivoli Netcool Performance Manager -Wireless Component

Instructions for installing and configuring theTivoli Netcool Performance Manager software.

Upgrading Tivoli Netcool Performance Manager -Wireless Component

Instructions for upgrading Tivoli NetcoolPerformance Manager software.

Administering Tivoli Netcool Performance Manager -Wireless Component

Instructions and general information about how tomaintain and support Tivoli Netcool PerformanceManager

Using Tivoli Netcool Performance Manager - WirelessComponent

Conceptual information and procedures for usingTivoli Netcool Performance Manager software forperformance, trending analysis and performancealarms.

Installing and Using Tivoli Netcool PerformanceManager - Application Studio - Wireless Component

Provides instructions for installation and usage ofthe Tivoli Netcool Performance Manager -Application Studio.

Integrating with Tivoli Monitoring - WirelessComponent

Provides instructions for integrating IBM TivoliMonitoring with Tivoli Netcool PerformanceManager.

Integrating with Tivoli Netcool/OMNIbus Web GUI -Wireless Component

Provides instructions for integrating IBM TivoliNetcool/OMNIbus Web GUI with Tivoli NetcoolPerformance Manager.

The documentation is available on the knowledge center at http://www-01.ibm.com/support/knowledgecenter/SSBNJ7/welcome.

vi IBM Tivoli Netcool Performance Manager: Installation Guide

Page 7: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Service Management ConnectConnect, learn, and share with Service Management professionals: product supporttechnical experts who provide their perspectives and expertise.

Access Network and Service Assurance community at https://www.ibm.com/developerworks/servicemanagement/nsa/index.html. Use Service ManagementConnect in the following ways:v Become involved with transparent development, an ongoing, open engagement

between other users and IBM developers of Tivoli products. You can access earlydesigns, sprint demonstrations, product roadmaps, and prerelease code.

v Connect one-on-one with the experts to collaborate and network about Tivoliand the Network and Service Assurance community.

v Read blogs to benefit from the expertise and experience of others.v Use wikis and forums to collaborate with the broader user community.Related information:

Tivoli Netcool Performance Manager 1.4 community on developerWorks

Tivoli Netcool Performance Manager technical trainingFor Tivoli Netcool Performance Manager technical training information, see thefollowing Tivoli Netcool Performance Manager Training website at:https://tnpmsupport.persistentsys.com/training.

Support informationIf you have a problem with your IBM software, you want to resolve it quickly. IBMprovides the following ways for you to obtain the support you need:

OnlineAccess the IBM Software Support site at http://www.ibm.com/software/support/probsub.html .

IBM Support AssistantThe IBM Support Assistant is a free local software serviceability workbenchthat helps you resolve questions and problems with IBM softwareproducts. The Support Assistant provides quick access to support-relatedinformation and serviceability tools for problem determination. To installthe Support Assistant software, go to http://www.ibm.com/software/support/isa.

Troubleshooting GuideFor more information about resolving problems, see the problemdetermination information for this product.

Conventions used in this publicationSeveral conventions are used in this publication for special terms, actions,commands, and paths that are dependent on your operating system.

Typeface conventionsThis publication uses the following typeface conventions:

Bold

Introduction vii

Page 8: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

v Lowercase commands and mixed case commands that are otherwisedifficult to distinguish from surrounding text

v Interface controls (check boxes, push buttons, radio buttons, spinbuttons, fields, folders, icons, list boxes, items inside list boxes,multicolumn lists, containers, menu choices, menu names, tabs, propertysheets), labels (such as Tip:, and Operating system considerations:)

v Keywords and parameters in text

Italic

v Citations (examples: titles of publications, diskettes, and CDs)v Words defined in text (example: a nonswitched line is called a

point-to-point line)v Emphasis of words and letters (words as words example: "Use the word

that to introduce a restrictive clause."; letters as letters example: "TheLUN address must start with the letter L.")

v New terms in text (except in a definition list): a view is a frame in aworkspace that contains data.

v Variables and values you must provide: ... where myname represents....

Monospace

v Examples and code examplesv File names, programming keywords, and other elements that are difficult

to distinguish from surrounding textv Message text and prompts addressed to the userv Text that the user must typev Values for arguments or command options

Bold monospace

v Command names, and names of macros and utilities that you can typeas commands

v Environment variable names in textv Keywordsv Parameter names in text: API structure parameters, command

parameters and arguments, and configuration parametersv Process namesv Registry variable names in textv Script names

viii IBM Tivoli Netcool Performance Manager: Installation Guide

Page 9: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Chapter 1. Installation process

The preinstallation and installation roadmaps describe how to install Tivoli NetcoolPerformance Manager.

Before installation, ensure that you have all the hardware you need, and have theappropriate software ready to install.

Preinstallation roadmapBefore you install Tivoli Netcool Performance Manager, you must complete each ofthe steps in this preinstallation roadmap.

© Copyright IBM Corp. 2006, 2017 1

Page 10: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Installation roadmapTo install Tivoli Netcool Performance Manager, you must complete each of thetasks in the following installation roadmap.

2 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 11: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Chapter 2. Planning your installation

You must install Tivoli Netcool Performance Manager on ahigh-performance and scalable platform.

Choose between the various installation options and ensure that you follow theinstructions that apply to your installation.

Tivoli Netcool Performance Manager distributionHow to get the product distribution.

The Tivoli Netcool Performance Manager distribution is available as an electronicimage. These instructions assume that you are installing from an electronic image.

If you install the product from an electronic image, be sure to keep a copy of thedistribution image in a well-known directory because you will need this image inthe future to make changes to the environment, including uninstalling TivoliNetcool Performance Manager.

The Tivoli Netcool Performance Manager distribution contains the softwarerequired to install Tivoli Netcool Performance Manager 1.4.3.

Components of Tivoli Netcool Performance ManagerDescribes the components that made up of a Tivoli Netcool Performance Managerinstallation.

A typical Tivoli Netcool Performance Manager installation consists of the followingcomponents:v Application server component - Runs a core application framework.v Gateway component - Processes data that is downloaded from the adapter data

sources.v Loader components - Parse and load data into a database.v Database component - Stores data in an Oracle database.v Directory server - Provides directory services by using Lightweight Directory

Access Protocol that is based on Security Directory Server.v Tivoli Common Reporting server- Provides the new Common Reporting GUI

that is accessed by using a browser. Tivoli Common Reporting is installed fromJazz for Service Management. To use Common Reporting, you must also installTivoli Netcool Performance Manager - Application Studio on a Windowscomputer. Tivoli Netcool Performance Manager - Application Studio is anadministrative and modeler tool for Common Reporting on Tivoli NetcoolPerformance Manager.

Note: You can use Model Maker if you have earlier Cognos models.

© Copyright IBM Corp. 2006, 2017 3

Page 12: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

v Client software provides graphical user interface (GUI) access from clientcomputers.

Supported configurationsSupported system configurations for the installation of the Tivoli NetcoolPerformance Manager components.

Install Tivoli Netcool Performance Manager components in one of the two mainconfigurations as follows:v A stand-alone system, where you install all components on a single stand-alone

server.v A distributed system, where you can install components over several servers in

different combinations.

For example, you can install the database, application, gateway, and loadercomponents, plus the directory server, on one server, or install each component onseparate servers.

Servers can also be defined by using Solaris Containers. Solaris

Containers is a virtualization technology in Solaris 11 that provides isolated andsecure runtime environments for applications. It uses zones, which are separateenvironments that can be viewed as individual OS instances that are running onthe same server. A container can be defined as a zone with resources (processor,memory) allocated by using the resource management features available in Solaris11. A distributed system can consist of components that are installed on separatezones that can span one or more Solaris servers.

Installation on VMware ESX is also supported by using RHEL as the

guest operating system. For more information about VMware, see:http://www.vmware.com/index.html

In this information, a server refers to the individual OS instance on which theTivoli Netcool Performance Manager - Wireless component software is installed.This can be a non-global Solaris 11 zone or an RHEL instance that is running onVMWare ESX. If the servers are defined as non-global Solaris zones, perform allinstallation tasks on these zones rather than on the global zone, unless otherwisespecified.

4 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 13: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Chapter 3. Preparing for the Installation

Ensure that you have the hardware and software required for a Tivoli NetcoolPerformance Manager installation.

Server hardware and software requirements

Ensure that you have the necessary server hardware and softwarerequirements.

Server hardware requirementsThe minimum hardware requirements for a Tivoli Netcool Performance Managerinstallation.

The minimum hardware requirements for a Tivoli Netcool Performance Managerserver are as follows:

v 4 x UltraSPARC IV, IV+

v 4 x x86-64 dual-core processors

v 4 x POWER7 and POWER8 processorsv 32 GB core memoryv 4 x 146 GB and 6 x 300 GB hard disksv Optical drive (DVD ROM/R/RW)

If you are deploying in a distributed environment, each server, or the virtualmachine requires the following configuration:v 1 x Intel Xeon 5500/5600 series processor (quad-core) 2.4 GHzv 4 GB RAMv 300 GB disk space

Server software requirementsThe minimum software requirements for a Tivoli Netcool Performance Managerinstallation.

To install a Tivoli Netcool Performance Manager system, you need the appropriatenumber of AIX, Solaris, or Linux servers, extra IBM, and third-party software foreach server. Depending on the server type, you need some or all of the followingextra software.

© Copyright IBM Corp. 2006, 2017 5

Page 14: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Prerequisite softwareThe prerequisite software for a Tivoli Netcool Performance Manager installation.

Product Version

Operating system 64-bit onlyv Red Hat Enterprise Linux

(RHEL) 7.x

v IBM AIX 7.1

v Oracle Solaris 11

v MicrosoftWindows 7 (For Cognos® 10 modelsthat are created by using Tivoli NetcoolPerformance Manager - Application Studio ).

v Oracle Enterprise Edition withpartitioning option

v Oracle Client

v Oracle Instant Client

v Oracle Instant Client SQL*PlusExtension package

v Oracle 32-bit libraries

v Oracle database Enterprise 12.1.0.2.0, 64-bitwith partitioning option.Note: Oracle 12.1.0.2.0 is a full installation.

v You must install The Oracle 32-bit librariesthat are contained in the Oracle 32-bit instantclient package.

Important: You must give vtdb as the databaseSID.

Jazz for Service Management 1.1.3.0

Tivoli Common Reporting 3.1.3.0

JBoss Application Server 4.0.3 Service Pack 1

Perl 5.6.1 for Gateway servers on Solaris and RHEL

Related information:

Download Jazz for Service Management Version 1.1.3.0

Bundled softwareThe software that is bundled with Tivoli Netcool Performance Manager.

Product Version

IBM Security Directory Server (required) 6.4

IBM DB2 (required) 10.5 (version 10.5.0.3)

IBM Tivoli Monitoring agent script(optional)

6.3

IBM Java 1.8.0 SR3 FP20 64-bit

Location of the Tivoli Netcool Performance Manager softwareNote the location of the Tivoli Netcool Performance Manager software before youstart the installation.

In addition to the Tivoli Netcool Performance Manager software, the followingIBM products are included.v IBM Security Directory Serverv Jazz for Service Managementv WebSphere Application Serverv Tivoli Common Reportingv IBM DB2

6 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 15: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

v IBM Tivoli Monitoring

You can install Tivoli Netcool Performance Manager either by using the productmedia, or by downloading it from the IBM Passport Advantage website:http://www.ibm.com/software/howtobuy/passportadvantage/

The following is a list of the core package files:v vallent-vt-ant-<version>.tar.gz

v vallent-vt-as-core-<version>.tar.gz

v vallent-vt-common-<version>.tar.gz

v vallent-vt-core-<version>.tar.gz

v vallent-vt-db-conf-<version>.tar.gz

v vallent-vt-db-install-<version>.tar.gz

v vallent-vt-ds-conf-<version>.tar.gz

v vallent-vt-java-libs-<version>.tar.gz

v vallent-vt-jre-<version>.tar.gz

v vallent-vt-njloader-<version>.tar.gz

v vallent-vt-sap-<version>.tar.gz

v vallent-vt-tcr-<version>.tar.gz

v vallent-vt-test-framework-<version>.tar.gz

v pmw_install

v default.rsp

v dependency_checker

v wireless_db_post_install.ksh

v TNPMWAppserverAgent.tar.gz

v TNPMWGatewayAgent.tar.gz

v TNPMWLoaderAgent.tar.gz

Location of Oracle Solaris software

For each server that runs on Oracle Solaris, a full installation (all components) ofSolaris 11 must be available on the server.

Note the location of the Solaris software before you start the installation.

To check whether a package is installed, run the following command:pkginfo -i SUNWarc SUNWbtool SUNWhea SUNWlibC SUNWlibm SUNWlibms SUNWsprot

SUNWtoo SUNWi1of SUNWi1cs SUNWi15cs SUNWxwfnt SUNWcsl SUNWeu8os

Note: In Solaris 11, some packages are renamed and some are obsolete. Make surethat renamed packages are installed. The obsolete packages can be ignored.

Renamed packages:v SUNWhea renamed to consolidation/osnet/osnet-incorporationv SUNWsprot renamed to consolidation/sunpro/sunpro-incorporation

Obsolete packages:v SUNWi15csv SUNWeu8os

Chapter 3. Preparing for the Installation 7

Page 16: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Extra Solaris packages required for installing Oracle 12c:

The following packages (or later versions) are required for Oracle database 12c forOracle Solaris.SUNWarcSUNWbtoolSUNWheaSUNWlibCSUNWlibmSUNWlibmsSUNWsprotSUNWtooSUNWi1ofSUNWi1cs (ISO8859-1)SUNWi15cs (ISO8859-15)SUNWxwfntSUNWcslSUNWeu8os

Location of Red Hat Enterprise Linux software

For each server that runs on Red Hat Enterprise Linux (RHEL), you need a basicRHEL installation. In addition, depending on the server type, install all of thespecified extra RHEL packages.

To check whether a package is installed, run the following command:rpm -qa | grep <package_name>

The dependency_checker tool also reports any missing packages. See Chapter 6,“Running the Dependency Checker tool,” on page 31 for details of the tool.

Any additional required packages must be in the Server directory of the RHELinstallation media.

If any packages are missing, install them by running the following command asuser root:rpm -i <RPM package file>

All the extra packages that are listed in the following sections are x86_64 versionsunless otherwise stated.

You must have all the packages that are installed, regardless of whether they are 32bit or 64 bit.

For example, the libXp package has two packages that are listed, the i386 and thex86_64 version; you must install both.

The architecture is displayed in bold for each package listed.

Extra RHEL packages required for installing Oracle 12c:

Before you install Oracle 12c on an RHEL server, install each of the followingpackages (specified versions or higher) on the server.

RHEL 7.x

8 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 17: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

binutils,2.23.52.0.1,16.el7,x86_64compat-db,4.7.25,27.el7,x86_64compat-libstdc++-33,3.2.3,71.el7,x86_64compat-libstdc++-33,3.2.3,71.el7,i686control-center,3.8.6,15.el7,x86_64elfutils-libelf-devel,0.158,3.el7,x86_64gcc,4.8.2,16.2.el7,x86_64gcc-c++,4.8.2,16.2.el7,x86_64glibc,2.17,55.el7,x86_64glibc,2.17,55.el7,i686glibc-common,2.17,55.el7,x86_64glibc-devel,2.17,55.el7,x86_64glibc-devel,2.17,55.el7,i686glibc-headers,2.17,55.el7,x86_64libgcc,4.8.2,16.2.el7,x86_64libgcc,4.8.2,16.2.el7,i686libaio,0.3.109,12.el7,x86_64libaio,0.3.109,12.el7,i686libaio-devel,0.3.109,12.el7,x86_64libaio-devel,0.3.109,12.el7,i686libstdc++,4.8.2,16.2.el7,x86_64libstdc++-devel,4.8.2,16.2.el7,x86_64libgomp,4.8.2,16.2.el7,x86_64libXp,1.0.2,2.1.el7,x86_64make,3.82,21.el7,x86_64sysstat,10.1.5,4.el7,x86_64

Extra RHEL packages required for installing IBM Security Directory Server andIBM DB2:

Before you install IBM Security Directory Server and IBM DB2 on an RHEL server,you must install each of the following packages (specified versions or higher) onthe server.

RHEL 7.xcompat-libstdc++-296,2.96,138,i386compat-libstdc++-33,3.2.3,61,x86_64compat-libstdc++-33,3.2.3,61,i386compat-gcc-34,3.4.6,4,x86_64compat-gcc-34-c++,3.4.6,4,x86_64compat-libf2c-34,3.4.6,4,x86_64compat-libf2c-34,3.4.6,4,i386kernel-headers,2.6.18,53.el5,x86_64glibc-headers,2.5,18,x86_64glibc-devel,2.5,18,x86_64glibc-devel,2.5,18,i386libgomp,4.1.2,14.el5,x86_64

Extra RHEL packages required for installing Tivoli Common Reporting:

Before you install IBM Tivoli Common Reporting on an RHEL server, you mustinstall each of the following packages (specified versions or higher) on the server:

RHEL 7.xcompat-libstdc++-33,3.2.3,71.el7,x86_64compat-libstdc++-33,3.2.3,71.el7,i686glibc,2.17,55.el7,x86_64glibc,2.17,55.el7,i686motif,2.3.4,7.el7,x86_64

Related information:

Jazz for Service Management Detailed System Requirements

Reporting Services requirements

Chapter 3. Preparing for the Installation 9

Page 18: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Extra RHEL packages required for installing JBoss Application Server:

Before you install JBoss Application Server on an RHEL server, install each of thefollowing packages (specified versions or higher) on the server.

RHEL 7.xecj,4.2.1,6.el7,x86_64zlib-devel,1.2.7,13,x86_64java-1.8.0-openjdk,1.8.0.65,2.4.5.5.el7,x86_64

Location of AIX software

For each server that runs on AIX, a full installation (all components) of AIX 7.1must be available on the server. Ensure that you have the required AIX softwarebefore you start with the installation.

Extra AIX packages required for installing Oracle 12c:

Before you install Oracle 12c on an AIX server, install each of the followingpackages (specified versions or higher) on the server.bos.adt.basebos.adt.libbos.adt.libmbos.perf.libperfstatbos.perf.perfstatbos.perf.proctools

AIX packages for AIX 6.1xlC.aix61.rte:9.0.0.1 or laterxlC.rte:9.0.0.1 or later

Extra AIX packages required for installing Security Directory Server and IBMDB2:

Before you install Security Directory Server and IBM DB2 on an AIX server, installeach of the following packages (specified versions or higher) on the server.rsct.basic.rtersct.opt.storagerm

Location of Oracle RDBMS and Oracle Client softwareNote the location of the Oracle RDBMS and Client software before you start theinstallation.

Location of JBoss Application Server softwareDescribes the location of the JBoss Application Server software.

Note the location of the JBoss Application Server software before starting theinstallation. Ensure that the JBoss archive is in the /appl directory and is in .zip,.tar.gz or .tar.bz2 format.

Installation scripts automatically install JBoss during the Tivoli NetcoolPerformance Manager software installation.

If necessary, download the JBoss Application Server software from the followinglocation:http://www.jboss.org/jbossas/downloads/

10 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 19: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Note: The version that is required is 4.0.3 Service Pack 1. For example:jboss-4.0.3SP1.tar.gz.

Location of Perl softwareThe following section describes the location of the Perl software.

Note: The location of the Perl software before you start the installation.

If necessary, download the required Perl software source code fromhttp://www.perl.com/CPAN/src.

Client computer hardware and software requirements on MicrosoftWindows

Ensure that the client computer has the necessary hardwareand software requirements.

Client hardware requirementsThe minimum hardware requirements for a Tivoli Netcool Performance Managerclient installation.

The minimum client hardware requirements for a Tivoli Netcool PerformanceManager client are as follows:v 1.4 GHz Pentium III (or above) processorv 4 GB memory

Client software requirementsThe minimum software requirements for a Tivoli Netcool Performance Managerclient installation.

Table 2 lists the software products that you need on a client computer to access theTivoli Netcool Performance Manager system. The required software must beinstalled on the client computer before you start the installation.

Table 2. Client software requirements

Product Version

Operating system Windows 7

Web browser v Internet Explorer 9, 10, and 11

v Mozilla Firefox ESR 17, 24, 31

Java Runtime Environment (JRE) JRE 1.8 SR3 FP20

Flash Player Adobe Flash Player 10.0.22 or later

Downloading the Java Runtime Environment Software

Download the Java Runtime Environment from http://www.oracle.com/technetwork/java/index.html.

Chapter 3. Preparing for the Installation 11

Page 20: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

12 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 21: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Chapter 4. Preinstallation tasks

You must prepare and configure each server individually.

Prerequisites

Prerequisites before you start the installation.

Before you start the installation, ensure that you have installed the appropriateoperating system on each of the servers. Also, depending on the components thatyou want to install on a particular server, ensure that you install any additionaloperating system packages required.

Required server informationImportant server information for installation.

Before you start the installation, you need the following information for each of theservers in your configuration.v Server IP addressv Server hostnamev Server domain namev Router IP address

Required file systems

Ensure that you set up the required file systems for the TivoliNetcool Performance Manager installation.

Using Table 3 on page 14 as a guide, create the required file systems on eachserver. Ensure that the file system sizes meet your specific requirements; theminimum file system sizes in this table are only sufficient for a base applicationsetup. Refer to the sizing document provided for your system for accurate sizings.All external file systems must reside on storage area networks (SAN) file systemonly.

© Copyright IBM Corp. 2006, 2017 13

Page 22: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Note: In a default installation, the Oracle database is configured in NOARCHIVELOGmode and archived redo log files are not created. Online redo log files are placedin both the /oralogs1/vtdb and /oralogs2/vtdb directories. You must keeparchived Oracle redo log files and online redo log files on separate devices/LUNs. Ifyou want to use ARCHIVELOG mode, update the Oracle database configurationparameter log_archive_dest to point to a directory on a separate device/LUN thanthe online redo log files, such as the /oradump mount point.

Note: If you are installing the database server on a Solaris non-global zone,configure the zone with access to the raw disk devices to implement RAID 1+0 forthe Oracle DB file systems.

Table 3. Required file systems

File system Description

Minimum

Size Partition Type Server Type

/ OperatingSystem

8 GB System diskpartition or LVMdevice

All

swap OperatingSystem

8 GB System diskpartition or LVMdevice

All

/var OperatingSystem

4 GB System diskpartition or LVMdevice

All

/appl Oracle andTivoli NetcoolPerformanceManagerapplicationsoftware

24 GB Non-system diskpartition or LVMdevice

All

/export/home Users HomeAccounts

2 GB Non-system diskpartition or LVMdevice

All

/oradata01 Oracle databasefiles StorageLocation 1

32 GB Non-system diskpartition or LVMdevice

Database

/oradata02 Oracle databasefiles StorageLocation 2

32 GB Non-system diskpartition or LVMdevice

Database

/oradata03 Oracle databasefiles StorageLocation 3

32 GB Non-system diskpartition or LVMdevice

Database

/oradata04 Oracle databasefiles StorageLocation 4

32 GB Non-system diskpartition or LVMdevice

Database

/oralogs1 Oracle Redo Loglocation 1

8 GB Non-system diskpartition or LVMdevice

Database

/oralogs2 Oracle Redo Loglocation 2

8 GB Non-system diskpartition or LVMdevice

Database

14 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 23: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Table 3. Required file systems (continued)

File system Description

Minimum

Size Partition Type Server Type

/oratemp OracleTemporary tablespace storagelocation

8 GB Non-system diskpartition or LVMdevice

Database

/oradump Oracle memorydump Locationfor archive logsand for databasebackups

8 GB Non-system diskpartition or LVMdevice

Database

/data/trace_log1

Trace LogLocation forapplication logs

8 GB Non-system diskpartition or LVMdevice

Application,Loader

/data/trace_archive1

Trace ArchiveLocation forarchivedapplication logs

8 GB Non-system diskpartition or LVMdevice

Application,Loader

Note: IBM recommends RAID 1+0 (implemented in hardware if possible) for thenon-system file systems. RAID 10 is the supported RAID configuration for allOracle file systems such as /oradata*, /oralogs*, and /oradump.

Ports and firewall configurations

You must configure a number of ports and firewalls for a TivoliNetcool Performance Manager system.

Table 4. Ports needed for Tivoli Netcool Performance Manager

Port Description

LDAPPORT=1389 LDAP authentication interface

ORACLEPORT=1521 Oracle database port

SAPMONPORT=9009 Port for Service Application Processor (SAP)

OMPORT=9008 Framework RMI communication

ASHTTPPORT=8080 Application server HTTP port

ASREDIRPORT=8443 Application server Redirect port

ASAJPPORT=8086 Apache Integration

ASWEBSRVPORT=8083 Application server Web port

ASBRIDGEPORT=10091 Application server Bridge port

ASNSPORT=1099 JNDI Communications

ASJRMPINVOKPORT=4444 EJB Communications

ASPOOLINVOKPORT=4445 EJB Communications

ASRMIPORT=1098 EJB Communications

ASUIL2PORT=8093 JMS Communications

ASHSQLPORT=1701 Internal DB

Chapter 4. Preinstallation tasks 15

Page 24: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Table 4. Ports needed for Tivoli Netcool Performance Manager (continued)

Port Description

ORBPORT=3528 CORBA Alarm notification

ORBSSLPORT=3529 Secure CORBA alarm notification

SMTP_PORT=25 Mail relay port

MSTRCACHE_RMI=9876 Java Remote Method Invocation port forMaster Cache

ALRMCACHE_RMI=9877 Java Remote Method Invocation port forAlarm Cache

4000 -> 4010 SNMP Gateway Admin port range (Port4444 must be open to enable the use of theAlarm tools.)

IBM DB2 port=50000 Default port for IBM DB2

Dashboard Application Services Hubport=16310 and 16311

Default ports for Dashboard ApplicationServices Hub

All ports that are listed are required for communication between the applicationcomponents. If these components are distributed between different servers, thenthe servers must be able to connect via these ports through any firewall.

The ports that are identified by ASHTTPPORT, ASJRMPINVOKPORT and ORACLEPORT arerequired for communication between the client workstations and the server. Allowthese ports through any firewalls present between the client and the servers.

Distributed installations with Application, Loader, or DirectoryServers on RHEL

When you deploy the Application, Directory or Loader servers on RHEL as part ofa distributed installation, configure the firewall on each RHEL server to allowcommunication to and from each of the other servers, regardless of the operatingsystem.

About this task

To allow distributed installations with Application, Loader or Directory Servers onRHEL, configure the IPTables service on the RHEL system by using the IPaddresses of the other servers as follows:

Procedure1. Determine if the firewall is enabled.

For RHEL 7.x:v Checking status:

systemctl status firewalld

v Stopping the firewall:service firewalld stop

v Starting the firewall:service firewalld start

16 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 25: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Note: If the firewall is not enabled, you do not need to complete the followinginstructions. Ignore the remainder of this section.

2. Allow a server through the RHEL firewall by editing the /etc/sysconfig/iptables file as user root and specifying the server IP address. For each server,place an entry similar to the following after the first -A RH-Firewall entry inthe file:A RH-Firewall-1-INPUT -p all -s <IP address> -j ACCEPT

This entry allows access from the specified server through the firewall on allports.

3. Ensure that you add the following ports to allow clients to access theapplication server and alarms component. Enter each entry on a single line.-A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp -dport<ASHTTPPORT> -j ACCEPT-A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp -dport<ASJRMPINVOKPORT> -j ACCEPT-A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp -dport<ORACLEPORT> -j ACCEPT

4. Substitute the correct port numbers for <ASHTTPPORT>, <ASJRMPINVOKPORT>, and<ORACLEPORT>. Here is an example of how the /etc/sysconfig/iptables filelooks afterward:*filter:INPUT ACCEPT [0:0]:FORWARD ACCEPT [0:0]:OUTPUT ACCEPT [0:0]:RH-Firewall-1-INPUT - [0:0]-A INPUT -j RH-Firewall-1-INPUT-A FORWARD -j RH-Firewall-1-INPUT-A RH-Firewall-1-INPUT -i lo -j ACCEPT-A RH-Firewall-1-INPUT -p all -s <IP address> -j ACCEPT-A RH-Firewall-1-INPUT -p icmp --icmp-type any -j ACCEPT-A RH-Firewall-1-INPUT -m state --state ESTABLISHED,RELATED -j ACCEPT-A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 8080 -j ACCEPT-A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 4444 -j ACCEPT-A RH-Firewall-1-INPUT -m state --state NEW -m tcp -p tcp --dport 1521 -j ACCEPT-A RH-Firewall-1-INPUT -j REJECT --reject-with icmp-host-prohibitedCOMMIT

5. Run the command as user root:# service iptables restart

Installing the platform package

Install the platform package provided with your softwaredistribution. The platform package provides some system administration functionsand installation scripts to help you correctly install the Oracle database and thedirectory server.

About this task

The name of the package is ibm-tn-plat-install-PLAT<version>.tar.gz. Installthis package on all Tivoli Netcool Performance Manager servers even in thedistributed environment. The package consists of the following files:v ibm-tn-plat-install.install

Chapter 4. Preinstallation tasks 17

Page 26: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

v ibm-tn-plat-install.remove

v ibm-tn-plat-install.sw

v ibm-tn-plat-install.license

To install the platform package, complete the following steps as user root:

Note: If the installation is using Solaris containers, the platformpackage must be installed on the global zone as well as the non-global zones.

Procedure1. Place the platform package in the /appl directory or the directory where Tivoli

Netcool Performance Manager is to be installed.2. Enter the following command to extract the package:

# gzip -dc ibm-tn-plat-install-PLAT<version>.tar.gz | tar xf -

3. Run the installation script.# ./ibm-tn-plat-install.install now

The platform package is installed under the /var/install directory.

Creating user and group accounts

Describes how to create user and group accounts.

Before you begin

Ensure that no Tivoli Netcool Performance Manager users, such as oracle orvirtuo, are logged in while you run the following commands.

About this task

To create the required users and groups, complete the following on all servers:

Procedure1. On the server on which you want to install the Security Directory Server

software, run the following command as user root:# /var/install/sbin/setup_users -product virtuo -sds

2. On all other servers, run the following command as user root:# /var/install/sbin/setup_users -product virtuo

3. At the prompts, create a password for each new user created.

Important: You need the password for the idsinst user when you install IBMSecurity Directory Server and IBM DB2 (see Chapter 8, “Installing the SecurityDirectory Server and IBM DB2,” on page 45).

18 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 27: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Setting directory ownership

Describes how to set directory ownership.

About this task

Perform the following task to set the owner of the Oracle database directories tooracle:

Procedure

Run the following command as user root on the database server:# chown oracle:dba /ora*

Configuring the kernel

Describes how to configure the kernel.

About this task

Correctly configure the OS kernel so that you can install Oracle and the SecurityDirectory Server.

Procedure1. To configure the kernel, run the following command as user root on the

database and application servers:# /var/install/sbin/system_configure

On Solaris, the system_configure command must be run on the global zone.2. Reboot the server by using the appropriate commands:

# /usr/sbin/shutdown -i6 -g0 -y

This updates the /etc/system file and backs up the original file as/etc/system.backup.IBM.<datestamp>

# shutdown -r now

This updates the /etc/sysctl.conf file and backs up the original file as/etc/original_sysctl.conf.

# shutdown -Fr

3. Disable the firewall by using these commands:Determine if the firewall is enabled.For RHEL 7.x:v Check status:

Chapter 4. Preinstallation tasks 19

Page 28: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

systemctl status firewalld

v Stop the firewall:service firewalld stop

v Start the firewall:service firewalld start

Setting up the domain name

Describes how to set up the domain name.

About this task

You must set up each of the servers on a common domain, typically, a DNSdomain. If you do not set up the DNS domain name, you might not be able toview the Alarm UI from the Tivoli Netcool Performance Manager Wireless webclient after the installation is complete.

To set up the servers on a common domain, follow these steps:

Procedure1. Run the following command as user root:

# grep domain /etc/resolv.conf

If a DNS domain is configured, you see output as follows:domain this.domain.com

If a DNS domain is not being used, set up the domain name by completing asfollows:a. As user root on the servers, check to see if the domain name is set by

running the following command:# domainname

If nothing is returned, the domain is not set.b. To set the domain, run the following command:

# domainname <domain>

<domain> is the selected domain name for the system, for example, ibm.com.2. Do one of the following based on your system:

v On Solaris systems, edit the /etc/hosts file and change the<hostname>.domainname entry to the local host name appended with thedomainname. The entry in /etc/hosts must be as follows:<IP address> <hostname>.<domainname> <hostname> loghost

v On systems with Linux application servers that are usingDNS, edit the /etc/hosts file:a. If the entry for localhost in /etc/hosts as follows:

127.0.0.1 <hostname>.<domainname> <hostname>localhost.localdomain localhost

20 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 29: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Change the localhost entry so that it looks as follows:127.0.0.1 localhost.localdomain localhost

b. If the system is not using DNS, add the following line to /etc/hosts file.<IP address> <hostname>.<domainname> <hostname>

v On Solaris systems, add the domain name to the/etc/defaultdomain file:<domainname>

v On AIX systems, the entry in /etc/hosts must be:<IP address> <hostname> <hostname>.<domainname>

If the entry does not conform to this format, edit the file.

Setting up the host name

Describes how to set up the host name.

About this task

You must set up the host name. If you are installing a distributed system and arenot using DNS, ensure that the host name of each server is present in the/etc/hosts file of each server.

Procedure1. Modify the /etc/hosts file as user root on each server.2. Ensure the host name and IP addresses of the application server, database

server, and loader servers and, if separate, the directory server is present in the/etc/hosts file.

Note: The host name must not contain an underscore (_), when it is set up ona Linux system. It results in installation failure. There is a limitation on parsingthe host name that contains underscore on Linux systems.

Building Perl on Gateway servers

Perl installation information.

By default, Perl has threading enabled in a Solaris or Linux distribution. However,for correct functioning of the Gateways, reinstall Perl without threading enabledand without 64int. For guidance on correctly installing Perl without 64int, refer tothe Gateway Framework Distribution Note in your distribution.

Install Perl in the $WMCROOT/gways/ directory of the server on which you areinstalling the gateway components. For the instructions on the Perl build, see:

http://www-01.ibm.com/support/docview.wss?uid=swg27015401

Chapter 4. Preinstallation tasks 21

Page 30: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

http://www-01.ibm.com/support/docview.wss?uid=swg27015399

http://www-01.ibm.com/support/docview.wss?uid=swg27015400

Setting memory for Java client processes

Describes how to increase the memory available to Java clientprocesses.

If a Java client process requires an extensive use of memory and the default Javaheap size is insufficient, then the process can fail with an OutOfMemoryError Javaexception:java.lang.OutOfMemoryError: Java heap space

This error can occur in the following scenarios:v When you install or upgrade large technology packs.v When you run the secondary key removal tool sbh_sk_remover to remove

secondary key fields before the provisioning of SBH definitions.

This problem is resolved by increasing the memory available to Java clientprocesses. Available memory is increased by amending the ANT_OPTS variable.

Important: If you are installing large technology packs, it is recommended thatyou set the ANT_OPTS variable to a value of 1 G before installation. Do not allow theinstallation to fail before you increase the ANT_OPTS value.

For information about increasing the memory available to Java client processes, seeJava client processes topic of the Administering Tivoli Netcool Performance Manager- Wireless Component

22 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 31: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Chapter 5. Installing Jazz for Service Management

The Jazz for Service Management installation supports different installationscenarios, user types, installation modes, and server topologies according to yourorganization needs and target server environments. You can use either a launchpador IBM Installation Manager to install and configure Jazz for Service Management.You can install and configure one or more integration services on a one, two, orthree servers.

About this task

To plan the Jazz™ for Service Management installation, you must choose yourinstallation scenario. This choice depends on the following factors:v Number of integration services to installv Reuse the existing database and application server middlewarev Installation modev User type

These factors determine your installation scenario that you use to install Jazz forService Management. You can also use the decision maps. See Installation decisionmaps.

Important:

v Do not install Jazz for Service Management 1.1.3.0 on a Solaris machine in adistributed or a stand-alone environment.

v For minimal installation of Tivoli Netcool Performance Manager, use onlysmadmin as the administration user name and smadmin1 as the administrationpassword for Jazz for Service Management. The default administration username is smadmin.

v To start or stop the server, you must log in with the same user that you used toinstall Jazz for Service Management. If Jazz for Service Management is installedwith non-root user, never restart Jazz for Service Management applicationservers with root user, or else the Dashboard Application Services Hub becomesunusable.

Related information:

Jazz for Service Management Version 1.1.3.0 Readme

Jazz for Service Management on IBM Knowledge Center

Installing Jazz for Service Management

Common directory locations

© Copyright IBM Corp. 2006, 2017 23

Page 32: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Hardware and software requirements for installing Jazz for ServiceManagement

Jazz for Service Management and its integration services have hardware andsoftware requirements, including supported middleware and installationtechnologies.

Important: Jazz for Service Management installation is not supported on Solarisplatform.

Important: You must add the following list of Linux libraries, which areprerequisite when you install Jazz for Service Management. If you do not includethese libraries, it can cause failure of prerequisite scanner or the installation of Jazzfor Service Management.os.lib.libSM.so.6_32os.lib.libICE.so.6_32os.lib.libfreetype.so.6_32os.lib.libuuid.so.1_32os.lib.libfontconfig.so.1_32os.lib.libjpeg.so.62_32os.lib.libpng12.so.0_32os.lib.libz.so.1_32os.lib.libstdc.so.5_32os.lib.libstdc.so.6_32

Related information:

Jazz for Service Management Detailed System Requirements

Quick reference to Jazz for Service Management installationUse this information to download and install Jazz for Service Management 1.1.3.0.Jazz for Service Management Version 1.1.3.0 is a full refresh of Jazz for ServiceManagement Version 1.1 Base with Modification 3.

This table summarizes the steps to plan and install Jazz for Service Management.1. This table summarizes the steps to plan and install Jazz for Service

Management.

24 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 33: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Task Description

Download and extract the softwareDownload and extract the Jazz for ServiceManagement Version 1.1.3.0 and otherrequired components from IBM PassportAdvantage.

v 1.1.3.0-TIV-JazzSM-multi.zip: 64-bit,multiplatform IBM Installation Managersoftware package repository for thefollowing Jazz for Service Managementintegration services and components:

– IBM Dashboard Application ServicesHub 3.1.3.0

– Jazz for Service Management extensionfor IBM WebSphere Version 1.1.3.0

– IBM Tivoli Common Reporting 3.1.3.0

v IBM-was-8.5.5.9-platform.zip:Platform-specific WebSphere ApplicationServer Version 8.5.5.9

v 3.1.3.0-TIV-JazzSM-TCR-COGNOS-platform.tar.gz|.zip: Platform-specificIBM Cognos Business IntelligenceReporting for Tivoli Common ReportingVersion 3.1.3.0.

System requirementsAssess the hardware and softwarerequirements. See Hardware and softwarerequirements.

Plan your installationYou can choose to perform a full or custominstallation of Jazz for Service Management.Different factors determine whichinstallation scenario you must choose, forexample, the integration services to install,business and security policies, your targetenvironments, and user types. See Planningyour deployment.

Prepare your environmentPrepare your environment whether youperform a fresh or upgrade. See Preparingyour environment.

Chapter 5. Installing Jazz for Service Management 25

Page 34: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Task Description

Perform a fresh installation20 GB of free disk space is required for afresh installation. Follow these steps:

v Download and extract1.1.3.0-TIV-JazzSM-multi.zip and otherrequired software to a local directory, forexample, <JazzSM_FP_Home>.

v Add the JazzSM_FP_Home/1.1.3.0-TIV-JazzSM-multi/JazzSMFPRepository/disk1/diskTag.inf file along with the repositorylocations for any other earlier Jazz forService Management versions toInstallation Manager > File > Preferences> Add Repository.

v Follow the installation instructions. SeePerforming a full installation.

Important: Jazz for Service Management1.1.3.0 installation fails on RHEL 7.2 usingFull Installation option.

To troubleshoot, see Issues with Jazz forService Management 1.1.3.0 Full Installationmode on RHEL 7.2 in Troubleshooting TivoliNetcool Performance Manager guide.

Perform an upgradeJazz for Service Management Version 1.1.3.0can be installed on top of earlier Jazz forService Management releases (1.1, 1.1.0.1,1.1.0.2, 1.1.0.3, 1.1.1.0, 1.1.2.0, 1.1.2.1). UseIBM Installation Manager in GUI or silentmodes to first update the Jazz for ServiceManagement extension for IBM WebSphereand then install Jazz for ServiceManagement Version 1.1.3.0 for DashboardApplication Services Hub installation. SeeApplying fix pack by using InstallationManager GUI mode.

Perform post-installation tasksVerify the installation. See Post-installationtasks.

Configuring Jazz for Service Management

2. This table summarizes the steps to configure Jazz for Service Management.

26 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 35: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Task Description

Cross-serviceYou can configure a central user registry,such as a Lightweight Directory AccessProtocol (LDAP) registry, for Jazz for ServiceManagement user management andauthentication.

Configure WebSphere Application Server touse a central federated repository with anLDAP user registry. After configuration, youcan add users to the federated repository.

You can configure the integration servicesfor single sign-on, so that users can accessJazz for Service Management applications bylogging in only once.

During installation, the global securityconfiguration is enabled that applies to thesecurity policy for all administrativefunctions in each Jazz for ServiceManagement application server. Theconfiguration is also used as a defaultsecurity policy for user applications.

See Configuring Jazz for ServiceManagement.

Dashboard Application Services HubFor installations of Dashboard ApplicationServices Hub with large user populations,you can set up a load balancing cluster ofconsole nodes with identical configurationsto evenly distribute user sessions.

You can choose to configure DashboardApplication Services Hub to use TivoliAccess Manager WebSEAL Version tomanage authentication.

You can also configure the Context MenuService (CMS) to use a remote database,which can be used by products to shareinformation outside of the DashboardApplication Services Hub environment.

See Configuring Dashboard ApplicationServices Hub.

Tivoli Common ReportingAfter you install Tivoli Common Reporting,prepare your report packages to be able togenerate, publish, and edit your reports.

You can configure database connectiondetails to a data source other than DB2.

See Configuring Tivoli Common Reporting.

Related information:

Download Jazz for Service Management Version 1.1.3.0

Chapter 5. Installing Jazz for Service Management 27

Page 36: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Getting started with Jazz for Service Management

Starting Jazz for Service Management application serversYou can start any Jazz for Service Management virtualization and reporting serversby using the IBM WebSphere startServer command. You might need to restart theapplication server after you complete a configuration task for an integrationservice, or after you stop the application server for maintenance.

About this task

The same procedure applies to any Jazz for Service Management applicationserver.

Procedure1. On the relevant Jazz for Service Management server, open a command window.2. Change to the JazzSM_WAS_Profile/bin directory.

The default location for <JazzSM_WAS_Profile> is /opt/IBM/JazzSM/profile.3. Run the following command:

./startServer.sh server_name

Where

server_nameEnter the name of the application server that was specified when theapplication server profile was created.

For example, server1.Related information:

Common directory locations

Stopping Jazz for Service Management application serversYou can stop any Jazz for Service Management application server by using the IBMWebSphere stopServer command. You might need to restart the application serverafter you complete a configuration task for an integration service, or stop theapplication server for maintenance. To start the server again, use the startServercommand.

Procedure1. On the relevant Jazz for Service Management server, open a command window.2. Change to the <JazzSM_WAS_Profile>/bin directory. The default location for

<JazzSM_WAS_Profile> is /opt/IBM/JazzSM/profile.3. Run the following command:

./stopServer.sh <server_name> -username <WAS_admin_user_name> -password <WAS_admin_password>

Where

server_nameEnter the name of the application server that was specified when theapplication server profile was created. For example, server1.

28 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 37: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

WAS_admin_user_nameThe default user name is smadmin.

WAS_admin_passwordPassword that is specified at the time of installation.

Example

stopServer.sh server1 -username smadmin -password jazzsmpwd

Related information:

Common directory locations

Disabling the Cognos Application Firewall for browser securityTo prevent URL redirection attacks in Cognos, enable Cognos Application Firewall.IBM Cognos Application Firewall (CAF) analyzes and validates HTTP and XMLrequests before they are processed.

Procedure1. Log on to the reporting server as a user with administrative privileges.2. Start IBM Cognos Configuration by using the following commands:

<JazzSM_Home>/reporting/cognos/bin64/cogconfig.sh

Where <JazzSM_Home> is /opt/IBM/JazzSM.3. In the Explorer pane, under Security, click IBM Cognos Application Firewall.4. In right pane, set Enable CAF validation and Is third party XSS checking

enabled properties to False.

Uninstalling Jazz for Service ManagementYou can uninstall most integration services and the application server by usingInstallation Manager GUI mode or silent mode. You might need to clean up yourenvironment after either a successful uninstallation or a failed installation.

About this task

Attention: You cannot roll back Tivoli Common Reporting Version 3.1.3.0 as itsupports only fresh installation. You can perform a full uninstallation of TivoliCommon Reporting.

Procedure

Use IBM Installation Manager in GUI or silent modes to uninstall Jazz for ServiceManagement Version 1.1.3.0.See Uninstalling fix packs by using Installation Manager GUI mode.See Uninstalling fix packs by using Installation Manager silent mode.

Important: When you revert to the previous version of Jazz for ServiceManagement, Installation Manager does not automatically account for interimfixes. You must manually install interim fixes after you roll back.Related information:

Uninstalling fix packs

Chapter 5. Installing Jazz for Service Management 29

Page 38: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Uninstalling Jazz for Service Management and related software

30 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 39: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Chapter 6. Running the Dependency Checker tool

The dependency_checker tool helps you to validate the configuration of a serverbefore you begin an installation or upgrade. It detects any problems with theplatform configuration.

Before you begin

Before you run the dependency_checker, ensure that Korn Shell (ksh) is present inthe /usr/bin path. If ksh is not available, then create a softlink by using thefollowing command:ln -s /bin/ksh /usr/bin/ksh

Note: Dependency Checker tool must be run only after you install the Jazz forService Management.

About this task

The dependency_checker checks the following aspects:v Operating system type and versionv Existing file systems and available disk spacev Installation of prerequisite packagesv Location of Tivoli Netcool Performance Manager packagesv Oracle configuration, if Oracle is already installed

For installation, on distributed servers, use the -t option to specify the type ofserver you are checking.

Procedure1. Copy all of the Tivoli Netcool Performance Manager package files to a

designated target directory on the server. The recommended location for thepackage files is /appl.

2. Set the permissions on dependency_checker before you run by giving thefollowing command:chmod u+x dependency_checker

3. Run the following commands as user root:cd <package location>./dependency_checker [ -t app|db|ds|ldr|standalone ] [ -upgrade ] [ -pkgs <packages_list>][ -nopkgcheck ]

For upgrade, run the dependency checker with the -upgrade option on eachserver before you upgrade the server.v -t app (Application server)v -t db (Database server)v -t ds (Directory server)v -t ldr (Loader server)v -t standalone (Stand-alone Server)v -upgrade (All servers)

© Copyright IBM Corp. 2006, 2017 31

Page 40: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Results

The script performs a number of checks on the system. The following exampleoutput shows a successful check with no reported problems:./dependency_checker======================================================================Tivoli Netcool Performance Manager pre-installation check======================================================================

Checking PATH.../usr/sbin: OK/usr/bin: OK

Performing checks for server type: all

-------------------------------------------------------------Perform Operating System configuration checks-------------------------------------------------------------

Hostname: tnpminlnx0204Processor type x86_64 is supported.Operating system version Red Hat Enterprise Linux Server release 7.2 (Maipo) is at supported level.

-------------------------------------------------------------Perform Host Setup configuration checks-------------------------------------------------------------

Fully Qualified Domain name: tnpminlnx0204.persistent.co.inChecking IP address... OKChecking root user umask...OK

-------------------------------------------------------------Checking installed Linux packages for sds-------------------------------------------------------------

pkg_full_version: 1.9.29.2.2Checking package: byacc x86_64... Status: OKpkg_full_version: 2.5.18Checking package: nscd x86_64... Status: OKpkg_full_version: 3.2.3.71.el7Checking package: compat-libstdc++-33 i686... Status: OKpkg_full_version: 4.8.2.16.2.el7Checking package: libstdc++ i686... Status: OKpkg_full_version: 3.2.3.71.el7Checking package: compat-libstdc++-33 x86_64... Status: OKpkg_full_version: 3.2.3.71.el7Checking package: compat-libstdc++-33 i686... Status: OKpkg_full_version: 4.4.7.8.el7Checking package: compat-gcc-44 x86_64... Status: OKpkg_full_version: 4.4.7.8.el7Checking package: compat-gcc-44-c++ x86_64... Status: OKpkg_full_version: 3.4.6.32.el7Checking package: compat-libf2c-34 x86_64... Status: OKpkg_full_version: 3.4.6.32.el7Checking package: compat-libf2c-34 i686... Status: OKpkg_full_version: 3.10.0.123.20.1.el7Checking package: kernel-headers x86_64... Status: OKpkg_full_version: 2.17.55.el7Checking package: glibc-headers x86_64... Status: OKpkg_full_version: 2.17.55.el7Checking package: glibc-devel x86_64... Status: OKpkg_full_version: 2.17.55.el7Checking package: glibc-devel i686... Status: OKpkg_full_version: 4.8.2.16.2.EL7Checking package: libgomp x86_64... Status: OK

-------------------------------------------------------------Checking installed Linux packages for oracle-------------------------------------------------------------

pkg_full_version: 1.9.29.2.2Checking package: byacc x86_64... Status: OKpkg_full_version: 2.5.18Checking package: nscd x86_64... Status: OKpkg_full_version: 2.23.52.0.1.16.el7Checking package: binutils x86_64... Status: OKpkg_full_version: 4.7.25.27.el7Checking package: compat-db x86_64... Status: OKpkg_full_version: 3.2.3.71.el7

32 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 41: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Checking package: compat-libstdc++-33 x86_64... Status: OKpkg_full_version: 3.2.3.71.el7Checking package: compat-libstdc++-33 i686... Status: OKpkg_full_version: 3.8.6.15.el7Checking package: control-center x86_64... Status: OKpkg_full_version: 0.158.3.el7Checking package: elfutils-libelf-devel x86_64... Status: OKpkg_full_version: 4.8.2.16.2.el7Checking package: gcc x86_64... Status: OKpkg_full_version: 4.8.2.16.2.el7Checking package: gcc-c++ x86_64... Status: OKpkg_full_version: 2.17.55.el7Checking package: glibc x86_64... Status: OKpkg_full_version: 2.17.55.el7Checking package: glibc i686... Status: OKpkg_full_version: 2.17.55.el7Checking package: glibc-common x86_64... Status: OKpkg_full_version: 2.17.55.el7Checking package: glibc-devel x86_64... Status: OKpkg_full_version: 2.17.55.el7Checking package: glibc-devel i686... Status: OKpkg_full_version: 2.17.55.el7Checking package: glibc-headers x86_64... Status: OKpkg_full_version: 4.8.2.16.2.el7Checking package: libgcc x86_64... Status: OKpkg_full_version: 4.8.2.16.2.el7Checking package: libgcc i686... Status: OKpkg_full_version: 0.3.109.12.el7Checking package: libaio x86_64... Status: OKpkg_full_version: 0.3.109.12.el7Checking package: libaio i686... Status: OKpkg_full_version: 0.3.109.12.el7Checking package: libaio-devel x86_64... Status: OKpkg_full_version: 0.3.109.12.el7Checking package: libaio-devel i686... Status: OKpkg_full_version: 4.8.2.16.2.el7Checking package: libstdc++ x86_64... Status: OKpkg_full_version: 4.8.2.16.2.el7Checking package: libstdc++-devel x86_64... Status: OKpkg_full_version: 4.8.2.16.2.el7Checking package: libgomp x86_64... Status: OKpkg_full_version: 1.0.2.2.1.el7Checking package: libXp x86_64... Status: OKpkg_full_version: 3.82.21.el7Checking package: make x86_64... Status: OKpkg_full_version: 10.1.5.4.el7Checking package: sysstat x86_64... Status: OK

-------------------------------------------------------------Checking installed Linux packages for jboss-------------------------------------------------------------

pkg_full_version: 1.9.29.2.2Checking package: byacc x86_64... Status: OKpkg_full_version: 2.5.18Checking package: nscd x86_64... Status: OKpkg_full_version: 4.2.1.6.el7Checking package: ecj x86_64... Status: OKpkg_full_version: 1.2.7.13Checking package: zlib-devel x86_64... Status: OKpkg_full_version: 1.8.0.65.2.4.5.5.el7Checking package: java-1.8.0-openjdk x86_64... Status: OK

-------------------------------------------------------------Perform Filesystem configuration checks-------------------------------------------------------------

Checking space on / partition...OK

-------------------------------------------------------------Perform Oracle configuration checks-------------------------------------------------------------

Checking if Oracle User exists... OKChecking oracle user shell... OKChecking oracle user umask... OKChecking oracle group... OKChecking oracle profile......OKChecking installed oracle version 12.1.0.2.0Oracle Release is: 12.1

Chapter 6. Running the Dependency Checker tool 33

Page 42: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Checking Oracle is installed correctly in /appl/oracle/product/12.1.0.2.0/db_1Checking Oracle version in /appl/oracle/product/12.1.0.2.0/db_1Oracle Database 12c is installed.GYMWI0033E FAIL: Oracle Partitioning is not installedChecking Oracle directory /appl/oracle/product/12.1.0.2.0/db_1/network...OKChecking Oracle directory /appl/oracle/product/12.1.0.2.0/db_1/network/admin...OKChecking Oracle binary /appl/oracle/product/12.1.0.2.0/db_1/bin/dbca...GYMWI0038E FAIL: dbca does not existChecking Oracle binary /appl/oracle/product/12.1.0.2.0/db_1/bin/sqlplus...OKChecking Oracle binary /appl/oracle/product/12.1.0.2.0/db_1/bin/netca...OKChecking Oracle binary /appl/oracle/product/12.1.0.2.0/db_1/bin/emca...GYMWI0038E FAIL: emca does not existChecking for listener.ora... not found, OKChecking for tnsnames.ora...GYMWI0042E FAIL: /appl/oracle/product/12.1.0.2.0/db_1/network/admin/tnsnames.ora must be owned by oracle

-------------------------------------------------------------Perform TNPM core package checks-------------------------------------------------------------

Checking for core packages in /applChecking for package jre... OKChecking for package ant... OKChecking for package java-libs... OKChecking for package as-core... OKChecking for package core... OKChecking for package sap... OKChecking for package njloader... OKChecking for package ds-conf... OKChecking for package db-install... OKChecking for package db-conf... OKChecking for pmw_install... OKChecking for Platform package... OK

-------------------------------------------------------------Checking for JBoss package-------------------------------------------------------------

Checking for package jboss-4.0.3SP1.tar.gz ... OK

-------------------------------------------------------------Perform SDS / DB2 package checks-------------------------------------------------------------

Checking for SDS packages in /appl/depends/sds64Checking for SDS package base... OKChecking for SDS package db2... OKChecking for SDS package gskit... OK

-------------------------------------------------------------Perform JAZZ SM/ TCR installation checks-------------------------------------------------------------

Checking default ports (16310 / 16311) for TCR... Not ConfiguredChecking default installation directories for Jazz SM & TCR:/opt/IBM/JazzSM/profile/bin/ ... Missing/opt/IBM/JazzSM/reporting/bin ... Missing

Jazz SM and TCR are not installed on the system.

GYMWI0069E FAIL: Missing Jazz SM & TCR Installation

-------------------------------------------------------------Perform files checks-------------------------------------------------------------

Checking required files.../usr/bin/ksh: OK

-------------------------------------------------------------The following tests failed -- you must investigate and fixthese failures before beginning the installation-------------------------------------------------------------

FAILURE: 1GYMWI0033E Oracle Partitioning is not installed

-------------------------------------------------------------FAILURE: 2GYMWI0038E dbca does not exist

34 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 43: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

-------------------------------------------------------------FAILURE: 3GYMWI0038E emca does not exist

-------------------------------------------------------------FAILURE: 4GYMWI0042E /appl/oracle/product/12.1.0.2.0/db_1/network/admin/tnsnames.ora must be owned by oracle

-------------------------------------------------------------FAILURE: 5GYMWI0069E Missing Jazz SM & TCR InstallationYou must install Jazz SM along with TCR before installing TNPM Wireless Component.-------------------------------------------------------------

The script reports a FAIL message for any checks that return an invalid result. Asummary of these errors displays when the script completes. The followingexample output shows a number of FAIL messages:-------------------------------------------------------------The following tests failed -- you must investigate and fixthese failures before beginning the installation-------------------------------------------------------------FAILURE: 1GYMWI0020E oracle Linux packages are missingcompat-db:x86_64 libaio-devel:x86_64 libXp:x86_64 sysstat:x86_64-------------------------------------------------------------FAILURE: 2GYMWI0069E Missing Jazz SM & TCR InstallationYou must install Jazz SM along with TCR before installing TNPM Wireless Component.-------------------------------------------------------------

A full list of error messages is given in Appendix C, “Dependency Checker errors,”on page 121.

Chapter 6. Running the Dependency Checker tool 35

Page 44: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

36 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 45: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Chapter 7. Installing Oracle RDBMS and the Oracle client

Describes the Oracle RDBMS and Oracle client installation andconfiguration information.

Install the Oracle 12c RDBMS software on a stand-alone system or on the databaseserver in a distributed system. Do not install the Oracle 12c Client software on astand-alone system. Install the Oracle 12c Client software on the application serverin a distributed system only, to make SQL*Plus available to certain programs.

Configuring Oracle environment variables

If Oracle 12c is already installed on the stand-alone or databaseserver, then ensure that the correct Oracle environment variables are set in theprofile of the oracle user.

Before you begin

You must have created User and Group Accounts before you can ensure that thecorrect Oracle environment variables are set.

About this task

The procedure uses the default variables, ensure that you use the correct variablevalues for your Oracle installation.

Procedure

To set the correct Oracle environment variables, as user oracle, edit the file${HOME}/.profile to include the following variables:ORACLE_OWNER=oracleexport ORACLE_OWNERORACLE_BASE=/appl/oracleexport ORACLE_BASEORACLE_HOME=/appl/oracle/product/12.1.0.2.0/db_1export ORACLE_HOMEPATH=$PATH:$ORACLE_HOME/binexport PATHLD_LIBRARY_PATH=$ORACLE_HOME/libexport LD_LIBRARY_PATHNLS_LANG=_.WE8ISO8859P1export NLS_LANG

© Copyright IBM Corp. 2006, 2017 37

Page 46: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Setting kernel parametersSetting the appropriate ulimit values on your operating system can affect how theOracle database performs.

About this task

Follow these commands on different operating systems to set ulimits:

Procedure

v ulimit –n 65536

Do not restart the system after this task or close session. If needed, set theulimits again.

v Add the following lines to etc/security/limits.conf file:* soft nofile 65536* hard nofile 65536* soft nproc 65536* hard nproc 65536

Restart the system after this taskIf the limits.conf file is not available then run system configuration by using thefollowing steps:v To configure the kernel, run the following commands as root on the database

and application servers:

# /var/install/sbin/system_configure

The system_configure command must be run on the global zone.v Restart the server by using the appropriate commands:

# /usr/sbin/shutdown -i6 -g0 -y

Note: This command updates /etc/system file and the original file/etc/system.backup.IBM.<datestamp> is backed up.

# shutdown -r now

Note: This command updates /etc/sysctl.conf file and the original file/etc/original_sysctl.conf is backed up.

# shutdown –Fr

38 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 47: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Installing Oracle 12cBefore you install the Oracle software, note the location of the following software.v Oracle 12.1.0.2.0 software and Patch Setv Oracle 12.1.0.2.0 client software, consists of:

– Oracle 12.1.0.2.0 Client– Oracle Instant Client basic– Oracle Instant Client SQL*Plus

For Solaris 11, make sure that following packages are installed before you installOracle 12c:v pkg://solaris/system/dtrace

v pkg://solaris/developer/assembler

v pkg://solaris/developer/build/make

v pkg://solaris/system/xopen/xcu4 (If it is not installed as part of standardOracle Solaris 11 installation)

v pkg://solaris/x11/diagnostic/x11-info-clients

v pkg://solaris/compress/unzip

Installing Oracle RDBMS (stand-alone system or databaseserver)

Install Oracle 12c by using the scripts that are provided in the platform package.Must be installed on a stand-alone server, or on the database server in adistributed environment. The Oracle installation takes approximately 30 minutesdepending on the specification of the server.

About this task

The Oracle RDBMS (stand-alone system or database server) must be installed on astand-alone server, or on the DB server in a distributed environment.

Note: If Oracle was previously installed on the server, you must respond to theon-screen questions. Default values are displayed and it is recommended that youoverwrite the files if they exist.

Note: Ignore the message ksh: : not found.

Note: If you have a problem with the installation, you can remove the <Oraclebase> directory and restart the Oracle 12c installation by running theoracle12C_install command again.

Procedure1. Optional: Validate the installed package and set the ulimit value to 65536 by

using the following command:ulimit -n 65536

If you encounter an issue when you run run the root.sh script, this step isneeded.

2. Run the commands as user root on the server:#/var/install/sbin/oracle12C_install

The installation conducts a number of checks:

Chapter 7. Installing Oracle RDBMS and the Oracle client 39

Page 48: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Check Oracle User exists....... DoneCheck oinstall group exists...group oinstall does not exist, creating...OK.Check dba group exists....... OK-----------------------------------------------------------------------Please select the Type of Install you wish to executeby entering the number associated with the Install Type :

Full install (Oracle 12.1.0.2.0 + 12.1.0.x.x patch set update) (1)Oracle 12.1.0.2.0 Client only (2)Oracle 12.1.0.2.0 Instant Client only (3)12.1.0.x Patch Set (4)12.1.0.x.x Patch Set Update (5)Oracle 12.1.0.x oneoff patches (6)

-----------------------------------------------------------------------[ 1 / 2 / 3 / 4 / 5 / 6 ] :

3. For a full installation, select option 1.4. At the prompts, specify the location of the Oracle Software and where you

want to install the software. Enter the paths to the Oracle software distributionas requested.Please enter the location of the Oracle 12.1.0.2.0 Software [cdrom/cdrom0/database]:

5. Enter the destinations for the Oracle software.Typically, the defaults are acceptable.Please enter the install location of the Oracle Base [/appl/oracle]:

Please enter the value of ORACLE_HOME [/appl/oracle/product/12.1.0.2.0/db_1]:

The directory /appl/oracle/product/12.1.0.2.0/db_1 does not exist and will be createdPlease enter the value of ORACLE_HOME_NAME [OraDBHome12C]:

When the Oracle Software installation is finished, the installation continues onto run the Oracle root.sh script.

6. You do not require any patches with Oracle 12.1.0.2.0. At the prompt, enternone:Please enter the location of the Oracle 12.1.0.2.0 compressed OPatch patch zip(’none’ for none) [/cdrom/cdrom0/patches/opatch]:noneNo OPatch patch available to be installedPlease enter the location of the Oracle PSU 12.1.0.x.x uncompressed patches(’none’ for none) [/cdrom/cdrom0/patches/psu]:noneNo PSU patches to be installed

7. At the prompt for the location of the Oracle one-off patches, enter none.Currently, there are no one-off patches for Tivoli Netcool Performance Manager,Version 1.4.3 and Oracle 12c.Please enter the location of the Oracle 12.1.0.2.0 uncompressed one-off patches(’none’ for none) [/cdrom/cdrom0/patches/oneoff]:noneNo one-off patches to be installed

What to do next

See the Oracle Installation log output in /var/install/logs/oracle12C_install_<PID>.log.

40 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 49: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Installing Oracle database 12c Client (Application Server orTivoli Common Reporting server in Distributed Systems only)

Install the Oracle database 12c Client software only on an application server orTivoli Common Reporting server in a distributed system. The Oracle database 12csoftware files must be on the application server or Tivoli Common Reportingserver during the Oracle database Client installation.

Before you begin

Important: Do not install Oracle database Client on a stand-alone system.

About this task

You must install the Oracle database 12c Client on any server where TivoliCommon Reporting is installed. Using the scripts that are provided in the platformpackage to install. The Oracle database Client installation takes approximately 5minutes depending on the specification of the server.

Note: You can ignore the message ksh: : not found.

The Oracle Instant_Client 64-bit files are in the following format:

v instantclient-basic-solaris.sparc64-12.1.0.2.0.zip

v instantclient-sqlplus-solaris.sparc64-12.1.0.2.0.zip

The Oracle Instant_Client 32-bit files are in the following format:v instantclient-basic-solaris.sparc32-12.1.0.2.0.zip

v instantclient-sqlplus-solaris.sparc32-12.1.0.2.0.zip

The Oracle Instant_Client 64-bit files are in the following format:v instantclient-basic-aix.ppc64-12.1.0.2.0.zipv instantclient-sqlplus-aix.ppc64-12.1.0.2.0.zip

The Oracle Instant_Client 32-bit files are in the following format:

v instantclient-basic-aix.ppc32-12.1.0.2.0.zipv instantclient-sqlplus-aix.ppc32-12.1.0.2.0.zip

The Oracle Instant_Client 64-bit files are in the following format:

v instantclient-basic-linux.x64-12.1.0.2.0.zipv instantclient-sqlplus-linux.x64-12.1.0.2.0.zip

The Oracle Instant_Client 32-bit files are in the following format:

v instantclient-basic-linux-12.1.0.2.0-32.zipv instantclient-sqlplus-linux-12.1.0.2.0-32.zip

Procedure1. Copy the required Oracle files to the application server or Tivoli Common

Reporting server.2. To install the Oracle 12c client, run the following commands as user root on

the server:

Chapter 7. Installing Oracle RDBMS and the Oracle client 41

Page 50: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

# /var/install/sbin/oracle12C_install

The installation conducts a number of checks:Check Oracle User exists....... DoneCheck oinstall group exists...group oinstall does not exist, creating...OK.Check dba group exists....... OK-----------------------------------------------------------------------Please select the Type of Install you wish to executeby entering the number associated with the Install Type :

Full install (Oracle 12.1.0.2.0 + 12.1.0.x.x patch set update) (1)Oracle 12.1.0.2.0 Client only (2)Oracle 12.1.0.2.0 Instant Client only (3)12.1.0.x Patch Set (4)12.1.0.x.x Patch Set Update (5)Oracle 12.1.0.x oneoff patches (6)

-----------------------------------------------------------------------[ 1 / 2 / 3 / 4 / 5 / 6 ] : 2

3. To install the client, select option 2.4. At the prompts, specify the location of the Oracle Software and the location

where you want to install the Oracle software. Enter the paths to the OracleClient software distribution as requested.Please enter the location of the Oracle 12.1.0.2.0 Software[/cdrom/cdrom0/client]:

5. Enter the destinations for the Oracle software. In most cases, the defaults areacceptable.Please enter the install location of the Oracle Base [/appl/oracle]:

Please enter the value of ORACLE_HOME [/appl/oracle/product/12.1.0.2.0/db_1]:

The directory /appl/oracle/product/12.1.0.2.0/db_1 does not exist and will be createdPlease enter the value of ORACLE_HOME_NAME [OraDBHome12C]:

6. When the Oracle Software installation is finished, the installation continues onto run the Oracle root.sh script. When prompted, enter the location of theOracle 64-bit Instant Client and the SQL*Plus extension .zip files. In mostcases, the defaults are acceptable.Please enter the location of the Oracle Instant Client ziparchive(s): [/cdrom/cdrom0/Instant_Client]

7. When prompted, enter the location of the Oracle 32-bit Instant Clientcompressed file archive.Please enter the location of the Oracle 32 Bit Instant Clientzip archive(s): [/cdrom/cdrom0/Instant_Client]

What to do next

Note: If Oracle was previously installed on the server, you must respond to theon-screen questions. Default values are displayed and it is recommended that youoverwrite the files if they exist.

Note: If you have a problem during the installation, you can remove the <Oraclebase> directory and restart the Oracle 12c installation by running theoracle12C_install command again.

42 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 51: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

You can see the Oracle Installation log output in the /var/install/logs/oracle12C_install_<PID>.log file.

Installing Oracle 12.1.0.2.0 Instant Client (stand-alone Serveror database Server combined with Tivoli Common Reportingserver)

Install the Oracle database 12.1.0.2.0 Instant Client on the server where TivoliCommon Reporting is to be installed or upgraded. The Instant Client must beaccompanied by either the Oracle Client or Oracle Server.

Procedure1. Copy the Oracle files to the Tivoli Common Reporting server.2. To install the Oracle 12.1.0.2.0 Instant Client, run the following command as

user root on the server:# /var/install/sbin/oracle12C_install

The installation conducts a number of checks:Check Oracle User exists....... DoneCheck oinstall group exists...group oinstall does not exist, creating...OK.Check dba group exists....... OK-----------------------------------------------------------------------Please select the Type of Install you wish to executeby entering the number associated with the Install Type :

Full install (Oracle 12.1.0.2.0 + 12.1.0.x.x patch set update) (1)Oracle 12.1.0.2.0 Client only (2)Oracle 12.1.0.2.0 Instant Client only (3)12.1.0.x Patch Set (4)12.1.0.x.x Patch Set Update (5)Oracle 12.1.0.x oneoff patches (6)

-----------------------------------------------------------------------[ 1 / 2 / 3 / 4 / 5 / 6 ] : 3

3. To install the Oracle Instant Client only, select option 3.4. Enter the destinations for the Oracle software. In most cases, the defaults are

acceptable.lease enter the install location of the Oracle Base[/appl/oracle]:Please enter the value of ORACLE_HOME[/appl/oracle/product/12.1.0.2.0/db_1]:Please enter the value of ORACLE_HOME_NAME[OraDBHome12C]:

5. When prompted, enter the location of the Oracle Instant Client and theSQL*Plus extension .zip files. In most cases, the defaults are acceptable.Please enter the location of the Oracle Instant Client ziparchive(s): [/cdrom/cdrom0/Instant_Client]

6. When prompted, enter the location of the Oracle 32-Bit Instant Clientcompressed file.Please enter the location of the Oracle 32 Bit Instant Client zip archive(s):[/cdrom/cdrom0/Instant_Client]

Chapter 7. Installing Oracle RDBMS and the Oracle client 43

Page 52: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Results

You see the output as follows:--------Oracle 12c installation completed-----

What to do next

Note: If you have a problem during the installation, you can remove the <Oraclebase> directory and restart the Oracle 12.1.0.2.0 installation by running theoracle12C_install command again.

You can see the Oracle Installation log output in the /var/install/logs/oracle12C_install_<PID>.log file.

Checking Oracle configurationYou use the dependency checker tool to validate Oracle configuration beforeproceeding.

Procedure

Run the following command to validate Oracle configuration, as user root:cd <target_directory>./dependency_checker -t db

The script validates that Oracle is installed correctly. If any FAIL messages display,investigate them and resolve the problems before you continue the installation.

Stopping the listener processBefore you start the installation, check that there is no listener process that isrunning on the system.

About this task

You must ensure that the listener process is stopped before you begin theinstallation:

Procedure1. Run the following command on the database server (or stand-alone server if

you are installing on a single computer):ps -ef | egrep [t]ns

If this command returns nothing, then proceed with the installation.2. If the previous step returns output similar to the following:

oracle 13238434 1 0 18:03:41 pts/0 0:58/appl/oracle/product/12.1.0.2.0/db_1/bin/tnslsnr LISTENER -inherit

Then, this process must be stopped by running the following command as thedatabase owner:$ lsnrctl stop <LISTENER_NAME>

Where <LISTENER_NAME> is the name of the listener that is returned by the pscommand. In the above example, the listener name is LISTENER.

44 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 53: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Chapter 8. Installing the Security Directory Server and IBMDB2

You use the scripts that are provided in the platform package toinstall Security Directory Server and IBM DB2.

Note: Perform these procedures on a stand-alone directory server, or applicationserver.

Required packagesThe required packages for the installation are distributed on the Tivoli NetcoolPerformance Manager installation media in the folder /appl/depends/sds64.

v IBM Security Directory Server 6.4 Client-Server with entitlement Solaris(sds64-solaris-sparc-base.tar)

v IBM Security Directory Server 6.4 GSkit Solaris (sds64-solaris-sparc-gskit.tar)v IBM Security Directory Server 6.4, DB2 v 10.5 Solaris (sds64-solaris-sparc-

db2.tar)

v IBM Security Directory Server 6.4 Client-Server with entitlement Linux x86-64(sds64-linux-x86-64-base.tar)

v IBM Security Directory Server 6.4 GSkit Linux x86-64 (sds64-linux-x86-64-gskit.tar)

v IBM Security Directory Server 6.4, DB2 v 10.5 Linux x86-64 (sds64-linux-x86-64-db2.tar)

v IBM Security Directory Server 6.4 Client-Server with entitlement AIX x86-64(sds64-aix-ppc64-base.tar)

v IBM Security Directory Server 6.4 GSkit AIX x86-64 (sds64-aix-ppc64-gskit.tar)v IBM Security Directory Server 6.4, DB2 v 10.5 AIX x86-64 (sds64-aix-ppc64-

db2.tar)

© Copyright IBM Corp. 2006, 2017 45

Page 54: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Running the Security Directory Server installation scriptsYou install Security Directory Server and IBM DB2 by using the scripts that areprovided in the platform package.

About this task

Note: The default encryption seed for the LDAP instance referred to by theSecurity Directory Server and DB2 installation is autogenerated by the operatingsystem's pseudorandom number generator. The encryption seed that is used for theinstance is logged in /var/install/logs/sds_install_<PID>.log and must benoted securely for future reference.

Note:

If the idsinst user account becomes unavailable, for example, due to an expired orchanged password, Security Directory Server can no longer be able to authenticateaccess to DB2 and the LDAP server becomes inoperative. To rectify this issue, seethe following IBM technote for information about updating the Security DirectoryServer password for the DB2 instance: http://www-01.ibm.com/support/docview.wss?uid=swg21297067.

Ensure that you enter the correct password for the idsinst user.At the prompts, enter and confirm the password for the DB2 Administrator(idsinst user). This password was set up when the idsinst user was created (see“Creating user and group accounts” on page 18).

Procedure1. Run the following command as user root:

# /var/install/sbin/sds_install -base <target directory> -product virtuo -version 6.4

Use the /appl directory as the <target directory> value.2. Provide the required information at the prompts, including the requests for the

absolute path names of the Security Directory Server, DB2, and GSK packages:Enter the full pathname of the DS package:/appl/depends/sds64/sds64-<OS>-<arch>-base.tarEnter the full pathname of the DS DB2 package:/appl/depends/sds64/sds64-<OS>-<arch>-db2.tarEnter the full pathname of the GSK package:/appl/depends/sds64/sds64-<OS>-<arch>-gskit.tarEnter the full pathname of the sds patch package, if required:Enter the full pathname of the DB2 patch package, if required:

...performing pre-install steps for Security Directory ServerDOMAIN set to server.ibm.com

3. Enter the remaining information that is requested by the script. The defaultscan be used.Please, enter the DB2 Administrator (idsinst user) password: []---->----><idsinst password>

Please, enter the DB2 Administrator (idsinst user) password a second time: []

---->----><idsinst password>Please, Enter the LDAP instance location: [/appl/ldap]---->Instance location set to /appl/ldap

46 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 55: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Please, Enter the encryption seed (12 digits): [240811423792]---->

Encryption seed set to 240811423792

Please, Enter the LDAP Administrator DN: [cn=Directory Manager]

---->Administrator DN set to cn=Directory Manager

Please, Enter the LDAP Administrator password: [Dirmgr01]

---->Administrator password set to Dirmgr01Please, Enter the LDAP port number: [1389]

---->Port number set to 1389

Please, Enter the LDAP secure port number: [1636]

---->

Secure port number set to 1636

Please, Enter the DB2 database name: [idsdb]DB name set to idsdb... Unpacking IBM Security Directory Server.

4. Enter 1 to accept the license agreement in the following screen:

Press Enter to continue viewing the licenseagreement, or, Enter 1" to accept the agreement, "2" to decline itor "99" to go back to the previous screen, "3" Print.

The installation log files are var/install/logs/sds_install_<PID>.log and/tmp/db2_install.log.<PID>.The sds_install script also supports a -remove option. You can completelyremove the Security Directory Server and DB2 installation by entering thefollowing command:# /var/install/sbin/sds_install –base <target directory> –product virtuo-remove -version 6.4

Note: You can ignore the mbind: Invalid argument error message that youmight see when you are installing Security Directory Server on a Linux server.

What to do next

Set the Directory Server Password Policy. For more information about the DirectoryServer Password Policy, see Administering Tivoli Netcool Performance Manager -Wireless Component.

Chapter 8. Installing the Security Directory Server and IBM DB2 47

Page 56: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Installing the Security Directory Server clientInstall the Security Directory Server client on the application server if you areusing a remote directory server.

About this task

If you have the directory server that is installed on the application server, you donot need to install the directory server client.

Procedure1. To install the Security Directory Server client, as user root, enter the following

command in one line:# /var/install/sbin/sds_install -base <target directory>-product virtuo -version 6.4 -client

It is recommended to use the /appl directory as the <target directory> value.2. Provide the required information at the prompts, including the requests for the

absolute path names of the Security Directory Server package.Enter the full path name of the directory server package: /var/install/packages/sds64-<OS>-<arch>-base.tar

.... Unpacking IBM Security Directory Server.

The installation log files are in /var/install/logs/sds_install_<PID>.logThe sds_install script also supports a -remove option. You can completelyremove the Security Directory Server Client installation by entering thefollowing command on one line:# /var/install/sbin/sds_install -base <target directory> -productvirtuo -client -remove -version 6.4

48 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 57: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Chapter 9. Installing the Tivoli Netcool Performance Managersoftware

Install the Tivoli Netcool Performance Manager software by usingone of the following scenarios.v Unattended installation of a stand-alone system (if a response file is available)v Installation of a stand-alone systemv Installation of a distributed system

Note: If you are upgrading Tivoli Netcool Performance Manager, consultUpgrading Tivoli Netcool Performance Manager - Wireless Component.

Important: Before installing Tivoli Netcool Performance Manager, you are stronglyadvised to read the Release Summary for Tivoli Netcool Performance Manager.Release Summary can contain information specific to your installation that is notcontained in this information. Failure to consult the release notes might result in acorrupted, incomplete or failed installation. You are also advised to refer to thefollowing link for all the existing known issues in Tivoli Netcool PerformanceManager, 1.4.3.

Note: It is recommended not to interrupt the installation at any point. Theinstallation will exit if there is a problem.

Prerequisites

The prerequisites for Tivoli Netcool Performance Manager softwareinstallation.

Installed software:v Oracle 12c RDBMSv Security Directory Server and IBM DB2v Jazz for Service Managementv All the required RHEL packages on RHEL serversv All the required AIX packages on AIX serversv All the required Oracle Solaris packages on Solaris servers

© Copyright IBM Corp. 2006, 2017 49

Page 58: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Installing Tivoli Netcool Performance Manager on Oracle Solaris 11When you install Tivoli Netcool Performance Manager on Solaris 11, you mightencounter some issues.

Procedure1. After you install the database and before the installation of the database

schema, the database schema installation might fail as services are notregistered due to svccfg import and delete changes. The behavior of svccfgimport and svccfg delete fmri are changed in Solaris 11. You might see thefollowing error message during the pmw_install:svccfg: Restarting svc:/system/manifest-import

Use the following steps to work around this issue:a. Check whether all services are registered and are up and running by using

the following command:svcs *-na*

You must see the status as follows:

STATE STIME FMRIonline 17:58:26 svc:/application/virtuo/sds-na:naonline 17:59:27 svc:/application/virtuo/sapmon-na:naonline 18:23:17 svc:/application/virtuo/database-na:globalonline 18:43:10 svc:/application/virtuo/sap-na:naonline 19:12:57 svc:/application/virtuo/sapmgr-na:na

If any of the services are not displayed with the svcs command, you mightencounter a failure in DB_SCHEMA_INSTALL and might see the following errormessages:svcs: Pattern ’database-na’ doesn’t match any instancesERROR: Database not running. The database must be running to install the schemaTask DB_SCHEMA_INSTALL exited with value 1. Quitting.

b. Check whether the service is unmasked by using the following command:# svccfg listcust -M | grep <service-name>

Foe example:# svccfg listcust -M | grep sapmon-na

If the service is masked, you might see the following output:

svc:/application/virtuo/sapmon-na manifest MASKEDmanifestfiles/var_svc_manifest_site_application_virtuo_sapmon-na_xml astring adminMASKED /var/svc/manifest/site/application/virtuo/sapmon-na.xmlsvc:/application/virtuo/sapmon-na:na manifest MASKED

c. Unmask the service by using the following command:# svccfgsvc:> select <service-name>svc:/application/virtuo/<service-name> delcustDeleting customizations for service: application/virtuo/<service-name>svc:/application/virtuo/<service-name>>quit

d. Confirm that the service is unmasked by using the following command:# svcs <service_name>STATE STIME FMRIoffline* 12:36:59 svc:/application/virtuo/<service_name>:na

e. Proceed with the installation.

50 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 59: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

2. If you encounter the following error message during theDB_SCHEMA_POST_INSTALL step:Inventory load failed... OPatch cannot load inventory for the given Oracle Home.

LsInventorySession failed: LsInventory cannot create the log directory/appl/oracle/product/12.1.0.2.0/db_1/cfgtoollogs/opatch/lsinv/lsinventory2016-11-08_12-18-03PM.txt

This error message has no functional impact and can be ignored.

Installing a stand-alone system unattended

You can install Tivoli Netcool Performance Manager on a singleserver by using a response file to provide the necessary configuration information.

About this task

Response files that are provided with some distributions provide all of theinformation necessary for an unattended installation. Check the Release Notes tosee if your software distribution includes a response file.

Note: If you are using a response file, ensure that all required software packagesare in the expected locations.

Note: If you want to install Tivoli Netcool Performance Manager in a directoryother than the default directory: /appl/virtuo, specify the directory by using the-wmcr switch.

Procedure1. To install Tivoli Netcool Performance Manager by using a response file, place

all of the Tivoli Netcool Performance Manager core packages in to the /appldirectory. Core packages are listed in section “Location of the Tivoli NetcoolPerformance Manager software” on page 6

2. Copy all the technology pack packages, the technology pack order file, andgateway packages in to /appl.

3. Run the following command as user root:# cd /appl# ksh pmw_install -wmcr /appl/virtuo -r <path to response file name>

<path to response_file name> is the name and path of the response file.

What to do next

After you have accepted the license agreement, the unattended installationproceeds. After you install the Tivoli Netcool Performance Manager software, theinstallation automatically installs the gateways and technology packs.

For detailed information about the installation and the database creation consultthe log files:

$WMCROOT/admin/logs/pmw_install.log

/appl/oracle/cfgtoollogs/dbca/vtdb/trace.log

Chapter 9. Installing the Tivoli Netcool Performance Manager software 51

Page 60: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Installation of a stand-alone system

Use the interactive installation scripts to install Tivoli NetcoolPerformance Manager on a single server.

Running an interactive installationYou start an interactive installation by running the pmw_install script. At theprompts, provide the required information.

Procedure1. Place all of the Tivoli Netcool Performance Manager software packages in the

/appl directory of the server.2. Run the following as user root:

# cd /appl# ksh pmw_install -wmcr <WMCROOT>

<WMCROOT> is the location where you want to install Tivoli Netcool PerformanceManager. The recommended installation directory is: /appl/virtuo.Read and accept the license agreement. The following menu is displayed:What Type of System Are you Installing?1. Standalone server2. Application Components only3. Loader Components only4. Directory Server Components only5. Database Components only6. Skip package deployment7. Exit PMW Install---->

3. To install a stand-alone system, select option 1.4. At the prompt, enter yes to deploy the packages.

Do you want to deploy the packages? [yes/no] >yesPlease, Verify Environment Settings..........................

The installation lists the default values of Tivoli Netcool Performance Managerenvironment variables. These variables set server host names and various TCPport numbers and varies from location to location. You can accept the defaultvalues, restore values to their default settings, or change individual values.

Important: It is important that you set each of these environment variables tothe correct value.

5. Accept the default values listed, or select individual values to change them.6. When you are satisfied that the environmental variable values are correct,

accept the values and proceed.

52 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 61: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Installing the JBoss application serverThe installation proceeds to install the JBoss Application Server.

Procedure1. At the prompt, enter yes to install the JBoss Application Server.

Would you like to perform task JBOSS_INSTALL ? [yes/no] >yes

2. At the prompt, enter the location of the JBoss archive. The installation searchesthe location that you provide for version 4.0.3 SP1 of the JBoss ApplicationServer in .zip, .tar.gz , or .tar.bz2 format.Please enter the location of the JBoss 4.0.3SP1 archive(or q to quit)!: [/appl]---->/appl

The installation expands the archive into the necessary location:Deploying JBoss 4.0.3SP1...Buildfile: /appl/virtuo/admin/common/install/scripts/build.xml

init:[echo] JBOSS VERSION=4.0.3SP1[echo] JBoss Location=/appl

upgrade:

init:[echo] JBOSS VERSION=4.0.3SP1[echo] JBoss Location=/appl

copy-libs:[copy] Copying 2 files to /appl/virtuo/as/server/default/lib[copy] Copying 10 files to /appl/virtuo/lib/tp

init:[echo] JBOSS VERSION=4.0.3SP1[echo] JBoss Location=/appl

fix-alarm-war:[mkdir] Created dir: /appl/virtuo/temp[mkdir] Created dir: /appl/virtuo/temp/war/apps/lib[unjar] Expanding:

/appl/virtuo/as/server/default/deploy_core/S02-na-alarm-manager.ear into /appl/virtuo/temp

[unjar] Expanding: /appl/virtuo/lib/na-alarm-service-server.jar into /appl/virtuo/temp

init:[echo] JBOSS VERSION=4.0.3SP1[echo] JBoss Location=/appl

fix-alarm-war:[mkdir] Created dir: /appl/virtuo/temp[mkdir] Created dir: /appl/virtuo/temp/war/apps/lib[unjar] Expanding: /appl/virtuo/as/server/default/deploy_core/S02-na-alarm-manager.ear into /appl/virtuo/temp[unjar] Expanding: /appl/virtuo/temp/S02-na-alarm-manager.war into/appl/virtuo/temp/war/apps/lib[unjar] Expanding: /appl/virtuo/lib/na-alarm-service-server.jar into/appl/virtuo/temp[copy] Copying 1 file to /appl/virtuo/temp/war/apps/lib[copy] Copying 1 file to /appl/virtuo/as/client[jar] Updating jar: /appl/virtuo/temp/S02-na-alarm-manager.war[jar] Updating jar: /appl/virtuo/as/server/default/deploy_core/

Chapter 9. Installing the Tivoli Netcool Performance Manager software 53

Page 62: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

S02-na-alarm-manager.ear

BUILD SUCCESSFULTotal time: 14 seconds

If you provide an invalid location for the JBoss archive, the installer promptsagain until you provide a correct location.

Installing the directory server schemaThe installation proceeds to install the directory server schema.

Procedure1. At the prompt, enter yes to install the directory server schema.

Would you like to perform task DS_SCHEMA_INSTALL ? [yes/no] >yes

2. At the prompt, enter the LDAP passwords for the directory server users:Directory Manager and SysAdmin:Please enter the password for ’Directory Manager’,the Directory Server User [<Dirmgr01>]:Please enter the password for ’SysAdmin’,the Directory Server User [<Sysadm01>]:Directory Server "SysAdmin" user password set to "Sysadm01"

Installing Directory server schema...Performing sanity check on Directory Server schema......doneDS schema installed.

Installing the databaseThe installation proceeds to install the Tivoli Netcool Performance Managerdatabase. You must enter the required information at the prompts.

About this task

Do not interrupt the installation during database installation.

Procedure1. At the prompt, enter yes to install the Tivoli Netcool Performance Manager

database.Would you like to perform task DB_INSTALL ? [yes/no] >yes

2. At the prompts, enter your database System Identifier (SID) and the sys andsystem database user passwords. You can choose to specify a different databasecreation template. If you do, ensure that the templates name is of the format<template name>.dbt:Please enter your Database SID (8 character maximum): [vtdb]---->Found default template: /appl/virtuo/admin/oracle/conf/vtdb.dbtPlease enter the full path of the PMW database template:[/appl/virtuo/admin/oracle/conf/vtdb.dbt]---->/appl/virtuo/admin/oracle/conf/vtdb.dbtPMW database will be created using template/appl/virtuo/admin/oracle/conf/vtdb.dbtPlease enter your ADDM license type[NONE | DIAGNOSTIC | DIAGNOSTIC+TUNING ]: [NONE]---->ADDM license type is set to "NONE"You must create passwords for the sys and system database users.

54 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 63: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Please enter a password for the sys user: [Sysdb01]---->Please enter a password for the system user: [Sysdb01]---->

Important: You must give vtdb as the database SID.

Installing the database schemaThe installation proceeds to install the database schema.

Procedure

At the prompt, enter yes to install the database schema.Would you like to perform task DB_SCHEMA_INSTALL ? [yes/no] >yes--------------------------------------------------------------------Please, Enter the Virtuo Database SID: [vtdb]---->Database SID set to "vtdb"Please, Enter the Database sys user password: [<password>]---->Database user sys password set to "<password>"Please, Enter the Database virtuo user password: [<password>]---->Database user virtuo password is set to "<password>".... Starting Database Schema ’core’Creating database schema ’core’ in SID ’vtdb’. This may take several minutes ........ Database Schema Creation finished successfully

What to do next

You might encounter the following error during the installation of databaseschema:Creating database schema ’core’ in SID ’vtdb’. This may take several minutes ...\### ERROR: Database Schema Created with errors.... Log file is located in /appl/virtuo/admin/oracle/schema/core/install_schema.logTask DB_SCHEMA_INSTALL exited with value 7. Quitting.

To resolve this issue, perform the following tasks:v Edit the following file:

/appl/virtuo/admin/oracle/schema/core/install_schema

Change the following line:LD_LIBRARY_PATH=/lib:/usr/lib

ToLD_LIBRARY_PATH=$LD_LIBRARY_PATH:/lib:/usr/lib

v Run the following command:#cd /appl#ksh pmw_install –wmcr <WMCROOT>

Chapter 9. Installing the Tivoli Netcool Performance Manager software 55

Page 64: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Database schema post-installation tasksThe installation proceeds to run post-installation tasks on the database schema.

Procedure

At the prompt, enter yes to run post-installation tasks on the schema:Would you like to perform task DB_SCHEMA_POST_INSTALL ? [yes/no] >yes--------------------------------------------------------------------Please, Enter the TNPMW Database SID: [vtdb]---->Database SID set to "vtdb"Please, Enter the SYSDBA Database user name: []---->sysDatabase user name with SYSDBA priv is set to "sys"Please, Enter the SYSDBA Database user sys password: []----><password>Database user sys password is set to "<password>"Please, Enter the Database user virtuo name: [virtuo]---->Database schema name is set to "virtuo"Please, Enter the Database user virtuo password: [<password>]---->Database user virtuo password is set to "<password>".... Starting Loading JAR Files To ’virtuo’ SchemaLoading JAR files to database schema ’virtuo’ in ’vtdb’ database.........Trigger created..... Importing Stored Outline To ’virtuo’ Schema Is Completed

Installing the cronjobsThe installation proceeds to install the cronjobs. You must provide the requiredinformation when prompted. The recommended responses are shown.

Procedure

At the prompt, enter yes to install the cronjobs.Would you like to perform task CORE_CRONJOB_INSTALL ? [yes/no] >yesConfiguring core cronjobs.......

What Type of PMW System Are you Installing ?----------------------------------------------------------------------Please select the type of PMW System you are installing byentering the number associate with the system type :All Inclusive (1)Application (2)Loader (3)Directory Server (4)Database (5)Gateway (6)----------------------------------------------------------------------[ 1 / 2 / 3 / 4 / 5 / 6] :Select option 1 to see all of the cronjobs on the system.Please enter the ORACLE_HOME Directory [/appl/oracle/product/12.1.0.2.0/db_1]:(Enter . if unknown)Please enter the ORACLE_BASE Directory [/appl/oracle]:(Enter . if unknown)Please enter the ORACLE_SID Parameter [vtdb]:(Enter . if unknown)Please enter the vtdb Database Archive Directory [/oradump/vtdb]:(Enter . if unknown)Please enter the Directory Server log Directory [/appl/ldap/idsslapd-idsinst/logs]:(Enter . if unknown)

56 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 65: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Please enter the PMW Log Directory [/appl/virtuo/logs]:(Enter . if unknown)Please enter the PMW Archive Logs Directory [/data/trace_archive1]:(Enter . if unknown)

What to do next

The installation continues on to install the root user and virtuo user cronjobs.

After the cronjob installation is completed successfully, see the cronjob installationlog output at the following location:

$WMCROOT/admin/logs/pmw_install.log

On completion of the cronjobs installation, the installation proceeds to install thegateways.

Installing the GatewaysThe installation proceeds to install the gateways and to deploy the gatewaypackages.

About this task

Note: The gateways do not function without the required Perl version is installed.Perl must be installed without threading enabled, and must be installed in the$WMCROOT/gways/ directory.

Procedure1. At the prompt, enter yes to deploy the gateways on the Tivoli Netcool

Performance Manager server.Would you like to perform task GATEWAYS_INSTALL ? [yes/no] >yes................................Checking packages: gwaysperl /appl/vallent-vt-gways-vallent-NA<version>.tar.gz................................Verified the following packages:* /appl/vallent-vt-gways-vallent-NA<version>.tar.gz

2. At the prompt, enter yes to deploy the packages.Do you want to deploy the packages? [yes/no] >yes

What to do next

On completion of the gateways installation, the installation proceeds to install thetechnology packs.

Installing the technology packsThe installation proceeds to install the technology packs. To install technologypacks, you must install and deploy packages, initialize the system, and apply thetechnology packs.

About this task

Note: It is recommended not to interrupt the installation during technology packinstallation.

Chapter 9. Installing the Tivoli Netcool Performance Manager software 57

Page 66: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Ensure that the technology pack packages and order file (vallent-vt-techpack_order) is in the /appl directory. The order file contains a list oftechnology packs for installation and the correct order for their deployment.

Note: By default, summary definition provisioning during technology packinstallation is switched off. If summary definition provisioning during technologypack installation is required, then edit the file $WMCROOT/conf/vmm/default.properties and change the value of the following property to true:vallent.vmm.techpack.provision.summaries.

Procedure1. At the prompt, enter yes to install the technology packs now.

Would you like to perform task TECHPACKS_INSTALL ? [yes/no] >yes................Techpack install order file found in /applChecking packages: vallent-vt-Neutral_Core_GOM vallent-vt-................Verified the following packages:* /appl/vallent-vt-Neutral_Core_GOM-1.0.tar.gz............

2. At the prompt, enter yes to deploy the packages.Do you want to deploy the packages? [yes/no] >yes InstallingNeutral_Core_GOM (1.0) ... ok............Ericsson_UMTS_UTRAN (1.0) ... okAll packages installed successfullyDetails in pmw_install.log

You might notice the following error:Waiting for appserver...Tue Apr 1 16:20:13 IST 2014: as is at state exec. Waiting for state STARTEDTue Apr 1 16:20:33 IST 2014: as is at state unknown. Waiting for state STARTEDTue Apr 1 16:20:45 IST 2014: as is at state unknown. Waiting for state STARTEDTue Apr 1 16:20:59 IST 2014: as is at state unknown. Waiting for state STARTED

To resolve this issue, follow these steps:v Restart the sap, sapmgr and sapmon services. If you have any problem in

restarting the services, check the <WMCROOT>/var/pid file for these processesand kill them.

v If the problem persists, check the error log in <WMCROOT>/logs/sapmon/sapmon-server.log and <WMCROOT>/logs/sapmgr/sapmgr-server.log and fix it.

3. At the prompt, enter yes to initialize the system.Would you like to perform task SYSINIT ? [yes/no] >yes..............

4. At the prompt, enter yes to apply the technology packs.Would you like to perform task TECHPACK_ADMIN ? [yes/no] >yesBuildfile: /appl/virtuo/admin/techpacks/build.xml..............[wmcInit] 13:03:09,320 [main] DEBUG logging - Created Logging Directory :/appl/ virtuo/logs/vmm[applyTechPacks] About to install modules. View logs for installation results.

5. For each technology pack you are applying, the techpack_admin tool looks inthe conf/vmm directory for a table space mapping properties file specific to thattechnology pack.Table mappings are used to assign technology pack tables optimal table spaces.The file name consists of:

58 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 67: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

tablespace_" + techpack_dir + "_" + release_version + ".properties"

For example: tablespace_Ericsson_UMTS_UTRAN_1.0.properties

Note: techpack_dir is the technology pack directory name underadmin/techpacks, for example Ericsson_UMTS_UTRAN, and not the technologypack name.If a properties file exists, it is loaded and validated:Using custom tablespace settings from file/appl/virtuo/conf/vmm/ tablespace_Ericsson_UMTS_UTRAN_1.0.propertiesfor techpack Ericsson UMTS UTRAN

Example parameters that are to be set in the properties file are as follows:v ERI_AAL2_PATH_VCC_TP_MBH, TRAFFIC_MEDIUMv ERI_RADIO_LINK_STATE_MBH,TRAFFIC_JUMBOThe techpack_admin tool maps each table name to a table space by matchingagainst patterns in the mappings file. It logs the warning messages todocument the table space that is used to create each table, for example:Creating table ERI_AAL2_PATH_VCC_TP_MBH in user defined tablespace

TRAFFIC_MEDIUM

Or;Creating table ERI_RADIO_LINK_STATE_MBH in default tablespace TRAFFIC_JUMBO

If the file is found to contain invalid syntax, the following error is returned andthe installation fails:Syntax error in tablespace properties file/appl/virtuo/conf/vmm/tablespace_Ericsson_UMTS_UTRAN_1.0.properties

If no file is found or if the file is not readable, you must confirm that you wantto proceed with the default table space configuration, for example:

Note: Tablespace properties file /appl/virtuo/conf/vmm/tablespace_Ericsson_UMTS_UTRAN_1.0.properties does notexist!

Enter y to use default table space settings. If you enter N the installation failsand no technology packs are applied.

6. If the specific or default table space settings are applied successfully, theinstallation continues:..............[applyTechPacks] All modules installed successfully.[delete] Deleting: /appl/virtuo/admin/techpacks/new_techpacks[echo] Analyzing Tech Pack tables ...[wsqlplus] Reading /appl/virtuo/admin/techpacks/analyze/vmm_analyze.pks..............[wsqlplus] Package dropped.[wsqlplus] Commit complete.[echo] Analyze completeBUILD SUCCESSFULTotal time: 40 minutes 18 seconds

Chapter 9. Installing the Tivoli Netcool Performance Manager software 59

Page 68: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Encrypting passwordsThe installation proceeds to encrypt all stored Tivoli Netcool Performance Managersystem passwords.

About this task

The installation prints an individual message for each file that is encrypted.

Procedure

At the prompt, enter yes to encode the system passwords.Would you like to perform task ENCODE_PASSWDS ? [yes/no] >yesReplacing all passwords with encoded passwords...Encoding values in /appl/virtuo/conf/alarm_external_api/alarmapi.propertiesEncoding values in /appl/virtuo/conf/alarm_external_api/alarmapi.properties.NEncoding values in /appl/virtuo/conf/externalreporting/default.propertiesEncoding values in /appl/virtuo/conf/externalreporting/default.properties.NEncoding values in /appl/virtuo/conf/as/as-default.properties.NEncoding values in /appl/virtuo/conf/as/as-default.properties.BACKUPEncoding values in /appl/virtuo/conf/as/as-default.propertiesEncoding values in /appl/virtuo/conf/dbconnection/vtdb.propertiesEncoding values in /appl/virtuo/conf/dbconnection/vtdb.properties.BACKUPEncoding values in /appl/virtuo/conf/dbconnection/vtdb.properties.NEncoding values in /appl/virtuo/conf/ldap/default.propertiesEncoding values in /appl/virtuo/conf/ldap/default.properties.NEncoding values in /appl/virtuo/conf/ldap/default.properties.BACKUPPasswords may also be stored in /appl/virtuo/admin/logs/pmw_install.log,so it should be removed when not needed anymore.

What to do next

Mandatory postinstallation tasks:v Ensure that following Oracle 12c related prerequisites are met:

– Check whether /appl/oracle/product/12.1.0.2.0/db_1/network/admin/sqlnet.ora has following configuration:SQLNET.ALLOWED_LOGON_VERSION=8

If sqlnet.ora does not have SQLNET.ALLOWED_LOGON_VERSION=8, login asoracle, and then run the following command:bash: echo 'SQLNET.ALLOWED_LOGON_VERSION=8' >>/appl/oracle/product/12.1.0.2.0/db_1/network/admin/sqlnet.ora

– Copy JDBC library files to Tivoli Netcool Performance Manager system.Ensure that oraclejdbc.jar from /appl/virtuo/lib/tp has same file size asojdbc7.jar from /appl/oracle/product/12.1.0.2.0/db_1/jdbc/lib.If the file size is not the same, then run the following command as uservirtuo:${WMCROOT}/admin/oracle/install/scripts/copy_jdbc_libs -wmcr ${WMCROOT}Copying database JDBC library files...Copying database library files...Done.

v Ensure that environment variable JAVA_TOOL_OPTIONS for virtuo user is correctlyset as follows:

env | grep JAVA_TOOL_OPTIONSJAVA_TOOL_OPTIONS=-Doracle.jdbc.autoCommitSpecCompliant=false

60 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 69: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

If it is not set, run following as user virtuo and confirm that it is set correctly byusing these commands:echo ’export JAVA_TOOL_OPTIONS=-Doracle.jdbc.autoCommitSpecCompliant=false’>> /export/home/virtuo/.profile

Set JAVA_TOOL_OPTIONS in /appl/virtuo/conf/as/jvm-default.ini by addingfollowing lines:export JAVA_TOOL_OPTIONS=-Doracle.jdbc.autoCommitSpecCompliant=false

The installation is now complete. To configure your Tivoli Netcool PerformanceManager system, see Chapter 11, “Postinstallation tasks,” on page 93.

Installing a distributed systemDetails the steps on installing a distributed system.

You can distribute Tivoli Netcool Performance Manager across a number of serversby using the interactive installation scripts that are provided.

Running an interactive installationSteps to start an interactive installation for a distributed system.

To install a distributed system, run the pmw_install script on each individualserver to install the required components. Enter information as required by theinstallation scripts. You must install the servers (or components on shared servers)in the following order:v Database serverv Directory serverv Application server (includes gateways and technology packs if applicable)v Loader serverv Gateway server (if installed separately)v Technology packs (if installed separately)

Installing a database serverThis section details the installation of the database server.

About this task

Interactive installation of a database server for a distributed system.

Procedure1. To install a database server, place all of the Tivoli Netcool Performance

Manager software packages in the /appl directory of the database server.2. Run the following as user root:

Chapter 9. Installing the Tivoli Netcool Performance Manager software 61

Page 70: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

# cd /appl# ksh pmw_install -wmcr <WMCROOT> [ -a ]

<WMCROOT> is the location where you want to install Tivoli Netcool PerformanceManager. The default installation directory is: /appl/virtuo.The –a option is used when a different type of Tivoli Netcool PerformanceManager server is to be installed “on top” of an existing one, for example, aLoader component on top of a previously installed application server.

3. Read and accept the license agreement and the following menu is displayed:What Type of System Are you Installing?

1. Standalone server2. Application Components only3. Loader Components only4. Directory Server Components only5. Database Components only6. Skip package deployment7. Exit PMW Install---->---->

4. Select option 5, Database Components only.5. At the prompt, enter yes to deploy the packages.

Do you want to deploy the packages? [yes/no] >yes

Configuring the databaseThis section details the configuration of the database.

About this task

The installation proceeds to configure the core software.

Procedure1. Verify the Environment Settings.

Please, Verify Environment Settings1. Accept Variable Values below2. Reset Variables to Default values3. Change WMCHOST=<server_name>..........................

The installation lists the default values of Tivoli Netcool Performance Managerenvironment variables. These variables set server hostnames and various TCPport numbers and will vary from location to location. You can accept thedefault values, restore values to their default settings or change individualvalues.

Important: It is extremely important that you set each of these environmentvariables to the correct value.

2. Select option 3 and change the value of WMCHOST to the hostname of theapplication server.

3. Change any other values that you want to change from the default values.4. When you are satisfied that the environment variable values are correct, accept

the values and proceed.

Installing the databaseDetails the installation of the database.

62 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 71: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

About this task

Do not interrupt the installation during database installation.

Procedure1. At the prompt, enter yes to install the database.

Would you like to perform task DB_INSTALL ? [yes/no] >yes

2. At the prompts, enter your database System Identifier (SID), ADDM licensetype, and system passwords. You can choose to specify a different databasecreation template. If you do, ensure that the template's name is of the format<template name>.dbt:Please enter your Database SID (8 character maximum): [vtdb]---->Found default template: /appl/virtuo/admin/oracle/conf/vtdb.dbtPlease enter the full path of the PMW databasetemplate: [/appl/virtuo/admin/oracle/conf/vtdb.dbt]---->/appl/virtuo/admin/oracle/conf/vtdb.dbtPMW database will be created usingtemplate /appl/virtuo/admin/oracle/conf/vtdb.dbtPlease enter your ADDM license type[NONE | DIAGNOSTIC | DIAGNOSTIC+TUNING ]: [NONE]---->ADDM license type is set to "NONE"You must create passwords for the sys and system database users.

Please enter a password for the sys user: [Sysdb01]---->Please enter a password for the system user: [Sysdb01]---->

Important: You must give vtdb as the database SID.

Installing the database schemaDescribes the steps for installing the database schema.

About this task

The installation proceeds to install the database schema as follows.

Procedure1. At the prompt, enter yes to install the database schema:

Would you like to perform task DB_SCHEMA_INSTALL ? [yes/no] >yes

2. At the prompts, enter the database SID:Please, Enter the Virtuo Database SID:[vtdb]---->Database SID set to "vtdb"

3. At the prompt, enter the password for the database system user:Please, Enter the Database sys user password:[<password>]---->Database user sys password set to "<password>"

4. At the prompt, enter the password for the database virtuo user:Please, Enter the Database virtuo user password:[<password>]---->Database user virtuo password is set to "<password>".... Starting Database Schema ’core’Creating Database Schema ’core’ in SID ’vtdb’. This may take several minutes ......... Database Schema Creation finished successfully

Chapter 9. Installing the Tivoli Netcool Performance Manager software 63

Page 72: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

What to do next

You might encounter the following error during installation of the databaseschema:Creating database schema ’core’ in SID ’vtdb’. This may take several minutes ...\### ERROR: Database Schema Created with errors.... Log file is located in /appl/virtuo/admin/oracle/schema/core/install_schema.logTask DB_SCHEMA_INSTALL exited with value 7. Quitting.

To resolve this issue, perform these tasks:v Edit the following file:

/appl/virtuo/admin/oracle/schema/core/install_schema

Change the following line:LD_LIBRARY_PATH=/lib:/usr/lib

ToLD_LIBRARY_PATH=$LD_LIBRARY_PATH:/lib:/usr/lib

v Run the following command:# cd /appl# ksh pmw_install -wmcr <WMCROOT> [-a]

Running postinstallation tasks on the database schemaSteps to run postinstallation tasks on the database schema for a distributed system.

About this task

The installation proceeds to run postinstallation tasks on the database schema asfollows.

Procedure1. At the prompt, enter yes to run postinstallation tasks on the Tivoli Netcool

Performance Manager database schema.Would you like to perform task DB_SCHEMA_POST_INSTALL ? [yes/no] >yes

2. At the prompt, enter the database SID:Please, Enter the TNPMW Database SID: [vtdb]---->Database SID set to "vtdb"

3. At the prompt, enter the name of the database system user:Please, Enter the SYSDBA Database user name: [sys]---->Database user name with SYSDBA priv is set to "sys"

4. At the prompt, enter the password for the database system user:Please, Enter the SYSDBA Database user sys password: [<password>]---->Database user sys as sysdba password is set to "[<password>]"

5. At the prompt, enter the name of the database virtuo user:Please, Enter the Database user virtuo name:[<virtuo>]---->Database schema name is set to "virtuo"

6. At the prompt, enter the password for the database virtuo user:Please, Enter the Database user virtuo password:[<password>]---->Database user virtuo password is set to "<password>".... Starting Loading JAR Files To ’virtuo’ SchemaLoading JAR files to database schema ’virtuo’ in ’vtdb’ database...|.... Loading JAR Files To ’virtuo’ Schema Is Completed

64 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 73: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

.... Starting Importing Stored Outline To ’virtuo’ SchemaImporting outline to database schema ’virtuo’ in ’vtdb’ database....... Importing Stored Outline To ’virtuo’ Schema Is Completed

Installing the cronjobsThe installation proceeds to install the cronjobs.

About this task

To install the cronjobs, provide the required information when prompted. Therecommended responses are shown.

Note: The prompts that are displayed can vary depending on your installation.

Procedure

At the prompt, enter yes to install the cronjobs.Would you like to perform task CORE_CRONJOB_INSTALL ? [yes/no] >yesWhat Type of PMW System Are you Installing ?-----------------------------------------------------------------------Please select the type of PMW System you are installing byentering the number associate with the system type :All Inclusive (1)Application (2)Loader (3)Directory Server (4)Database (5)Gateway (6)-----------------------------------------------------------------------[ 1 / 2 / 3 / 4 / 5 / 6] :5Server type selected: DBPlease enter the ORACLE_HOME Directory [/appl/oracle/product/12.1.0.2.0/db_1]:(Enter . if unknown)Please enter the ORACLE_BASE Directory [/appl/oracle]:(Enter . if unknown)Please enter the ORACLE_SID Parameter [vtdb]:(Enter . if unknown)Please enter the vtdb Database Archive Directory [/oradump/vtdb]:(Enter . if unknown)

The installation continues on to install the root user and virtuo user cronjobs.

Encrypting passwordsThe installation proceeds to encrypt all stored Tivoli Netcool Performance Managersystem passwords.

About this task

The installation prints an individual message for each file that is encrypted.

Procedure

At the prompt, enter yes to encode the system passwords.Would you like to perform task ENCODE_PASSWDS ? [yes/no] >yesReplacing all passwords with encoded passwords...Encoding values in /appl/virtuo/conf/alarm_external_api/alarmapi.propertiesEncoding values in /appl/virtuo/conf/alarm_external_api/alarmapi.properties.NEncoding values in /appl/virtuo/conf/externalreporting/default.propertiesEncoding values in /appl/virtuo/conf/externalreporting/default.properties.NEncoding values in /appl/virtuo/conf/as/as-default.properties.N

Chapter 9. Installing the Tivoli Netcool Performance Manager software 65

Page 74: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Encoding values in /appl/virtuo/conf/as/as-default.properties.BACKUPEncoding values in /appl/virtuo/conf/as/as-default.propertiesEncoding values in /appl/virtuo/conf/dbconnection/vtdb.propertiesEncoding values in /appl/virtuo/conf/dbconnection/vtdb.properties.BACKUPEncoding values in /appl/virtuo/conf/dbconnection/vtdb.properties.NEncoding values in /appl/virtuo/conf/ldap/default.propertiesEncoding values in /appl/virtuo/conf/ldap/default.properties.NEncoding values in /appl/virtuo/conf/ldap/default.properties.BACKUPPasswords may also be stored in /appl/virtuo/admin/logs/pmw_install.log,so it should be removed when not needed anymore.

What to do next

Mandatory postinstallation tasks:v Ensure that following Oracle 12c related prerequisites are met:

– Check whether /appl/oracle/product/12.1.0.2.0/db_1/network/admin/sqlnet.ora has following configuration:SQLNET.ALLOWED_LOGON_VERSION=8

If sqlnet.ora does not have SQLNET.ALLOWED_LOGON_VERSION=8, login asoracle, and then run the following command:bash: echo 'SQLNET.ALLOWED_LOGON_VERSION=8' >>/appl/oracle/product/12.1.0.2.0/db_1/network/admin/sqlnet.ora

– Copy JDBC library files to Tivoli Netcool Performance Manager system.Ensure that oraclejdbc.jar from /appl/virtuo/lib/tp has same file size asojdbc7.jar from /appl/oracle/product/12.1.0.2.0/db_1/jdbc/lib.If the file size is not the same, then run the following command as uservirtuo:${WMCROOT}/admin/oracle/install/scripts/copy_jdbc_libs -wmcr ${WMCROOT}Copying database JDBC library files...Copying database library files...Done.

v Ensure that environment variable JAVA_TOOL_OPTIONS for virtuo user is correctlyset as follows:

env | grep JAVA_TOOL_OPTIONSJAVA_TOOL_OPTIONS=-Doracle.jdbc.autoCommitSpecCompliant=false

If it is not set, run following as user virtuo and confirm that it is set correctly byusing these commands:echo ’export JAVA_TOOL_OPTIONS=-Doracle.jdbc.autoCommitSpecCompliant=false’>> /export/home/virtuo/.profile

Set JAVA_TOOL_OPTIONS in /appl/virtuo/conf/as/jvm-default.ini by addingfollowing lines:export JAVA_TOOL_OPTIONS=-Doracle.jdbc.autoCommitSpecCompliant=false

The installation is now complete. To configure your Tivoli Netcool PerformanceManager system, see Chapter 11, “Postinstallation tasks,” on page 93.

66 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 75: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Installing a separate directory serverA directory server can be installed separately from the application server. Ensurethat the directory server schema is installed on the directory server.

About this task

You can separate the directory server from the application server by using thefollowing method:v Install the directory server packages and configure the directory server schema

on the directory server by using the pmw_install script, as described in thisprocedure. Enter extra information at the prompts, such as the locations of theapplication and database servers.

Procedure1. Place all of the Tivoli Netcool Performance Manager software packages in the

/appl directory of the directory server.2. Run the following as user root:

# cd /appl# ksh pmw_install -wmcr <WMCROOT> [-a]

<WMCROOT> is the location where you want to install Tivoli Netcool PerformanceManager. The default installation directory is /appl/virtuo.The –a option is used in a distributed installation scenario, where a differenttype of Tivoli Netcool Performance Manager server is to be installed “on top”of an existing one, for example, a Loader server on top of a previously installedapplication server.

3. Read and accept the license agreement and the following menu is displayed:What Type of System Are you Installing?

1. Standalone server2. Application Components only3. Loader Components only4. Directory Server Components only5. Database Components only6. Skip package deployment7. Exit PMW Install---->

4. Select option 4, Directory Server Components only.5. At the prompt, enter yes to deploy the packages.

Do you want to deploy the packages? [yes/no] >yes

Installing the JBoss application serverThe installation proceeds to install the JBoss Application Server.

Procedure1. At the prompt, enter yes to install the JBoss Application Server.

Would you like to perform task JBOSS_INSTALL ? [yes/no] >yes

2. At the prompt, enter the location of the JBoss archive. The installation searchesthe location that you provide for version 4.0.3 SP1 of the JBoss ApplicationServer in .zip, .tar.gz , or .tar.bz2 format.Please enter the location of the JBoss 4.0.3SP1 archive(or q to quit)!: [/appl]---->/appl

The installation expands the archive into the necessary location:

Chapter 9. Installing the Tivoli Netcool Performance Manager software 67

Page 76: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Deploying JBoss 4.0.3SP1...Buildfile: /appl/virtuo/admin/common/install/scripts/build.xml

init:[echo] JBOSS VERSION=4.0.3SP1[echo] JBoss Location=/appl

upgrade:

init:[echo] JBOSS VERSION=4.0.3SP1[echo] JBoss Location=/appl

copy-libs:[copy] Copying 2 files to /appl/virtuo/as/server/default/lib[copy] Copying 10 files to /appl/virtuo/lib/tp

init:[echo] JBOSS VERSION=4.0.3SP1[echo] JBoss Location=/appl

fix-alarm-war:[mkdir] Created dir: /appl/virtuo/temp[mkdir] Created dir: /appl/virtuo/temp/war/apps/lib[unjar] Expanding:

/appl/virtuo/as/server/default/deploy_core/S02-na-alarm-manager.ear into /appl/virtuo/temp

[unjar] Expanding: /appl/virtuo/lib/na-alarm-service-server.jar into /appl/virtuo/temp

init:[echo] JBOSS VERSION=4.0.3SP1[echo] JBoss Location=/appl

fix-alarm-war:[mkdir] Created dir: /appl/virtuo/temp[mkdir] Created dir: /appl/virtuo/temp/war/apps/lib[unjar] Expanding: /appl/virtuo/as/server/default/deploy_core/S02-na-alarm-manager.ear into /appl/virtuo/temp[unjar] Expanding: /appl/virtuo/temp/S02-na-alarm-manager.war into/appl/virtuo/temp/war/apps/lib[unjar] Expanding: /appl/virtuo/lib/na-alarm-service-server.jar into/appl/virtuo/temp[copy] Copying 1 file to /appl/virtuo/temp/war/apps/lib[copy] Copying 1 file to /appl/virtuo/as/client[jar] Updating jar: /appl/virtuo/temp/S02-na-alarm-manager.war[jar] Updating jar: /appl/virtuo/as/server/default/deploy_core/S02-na-alarm-manager.ear

BUILD SUCCESSFULTotal time: 14 seconds

If you provide an invalid location for the JBoss archive, the installer promptsagain until you provide a correct location.

Installing the directory server schemaThe following section details the directory server schema installation.

About this task

The installation proceeds to install the directory server schema.

Procedure1. At the prompt, enter yes to install the directory server schema.

Would you like to perform task DS_SCHEMA_INSTALL ? [yes/no] >yes

68 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 77: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

2. At the prompt, enter the LDAP password for the directory server userDirectory Manager:Please enter the password for ’Directory Manager’,the Directory Server User [<Dirmgr01>]:

3. At the prompt, enter the LDAP password for the directory server userSysAdmin:Please enter the password for ’SysAdmin’,the Directory Server User [<password>]:

4. At the prompt, enter the application server host name:Please enter the TNPMW appserver hostname:

5. At the prompt, enter the database server host name:Please enter the database server hostname:

(If the installation cannot find IP addresses for the application server anddatabase server, you must provide the IP addresses).

6. At the prompt, enter the LDAP password for the directory server user System:Please enter the password for 'System’,the Directory Server User [<password>]:

Installing the cronjobsThis section describes the steps to install the cronjobs.

About this task

The installation proceeds to install the cronjobs. To install the cronjobs, provide therequired information when prompted. The recommended responses are shownbelow.

Procedure

At the prompt, enter yes to install the cronjobs.Would you like to perform task CORE_CRONJOB_INSTALL ? [yes/no] >yes-----------------------------------------------------------------------Please select the type of TNPMW System you are installing byentering the number associate with the system type :All Inclusive (1)Application (2)Loader (3)Directory Server (4)Database (5)Gateway (6)-----------------------------------------------------------------------[ 1 / 2 / 3 / 4 / 5 / 6] : 4Please enter the Directory Server log Directory [/appl/ldap/idsslapd-idsinst/logs]:(Enter . if unknown)

What to do next

The installation continues on to install the root user and virtuo user cronjobs.

Once the cronjob installation has completed successfully, see the cronjobinstallation log output at the following location:

$WMCROOT/admin/logs/pmw_install.log

Encrypting the passwordsThe installation proceeds to encrypt all stored Tivoli Netcool Performance Managersystem passwords.

Chapter 9. Installing the Tivoli Netcool Performance Manager software 69

Page 78: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

About this task

The installation prints an individual message for each file that is encrypted.

Procedure

At the prompt, enter yes to encode the system passwords.Would you like to perform task ENCODE_PASSWDS ? [yes/no] >yesReplacing all passwords with encoded passwords......Passwords may also be stored in/appl/virtuo/admin/logs/pmw_install.log,so it should be removed when not needed anymore.

Installing the Application ServerDetails the steps to install the application server.

About this task

The installation proceeds to install the application server for the Tivoli NetcoolPerformance Manager.

Procedure1. Place all of the Tivoli Netcool Performance Manager software packages in the

/appl directory of the server.2. Run the following command as user root:

# cd /appl# ksh pmw_install -wmcr <WMCROOT> [ -a ]

<WMCROOT> is the location in which you want to install Tivoli NetcoolPerformance Manager. The default installation directory is: /appl/virtuo.The –a option is used in a distributed installation scenario, where a differenttype of Tivoli Netcool Performance Manager system is to be installed “on top”of an existing one, for example, a Loader system on top of a previouslyinstalled application server.

3. Read and accept the license agreement and the following menu is displayed:What Type of System Are you Installing ?

1. Standalone server2. Application Components only3. Loader Components only4. Directory Server Components only5. Database Components only6. Skip package deployment7. Exit PMW Install---->

4. Select option 2, Application Components only.5. At the prompt, enter yes to deploy the packages.

Do you want to deploy the packages? [yes/no] >yes

6. Verify the correct values for the following variables:WMCHOST The hostname of the application serverVTDBHOST The hostname of the database serverLDAPHOST The hostname of the LDAP server

The installation proceeds to configure the core software.

70 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 79: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Please, Verify Environment Settings1. Accept Variable Values below2. Reset Variables to Default values3. Change WMCHOST=<server_name>4. Change VTDBHOST=<server_name>5. Change LDAPHOST=<server_name>..........................

The installation lists the default values of Tivoli Netcool Performance Managerenvironment variables. These variables set server host names and various TCPport numbers vary from location to location. Accept the default values, restorevalues to their default settings, or change individual values.

Important: Set each of these environment variables to the correct value.7. Select option 4 and change the value of VTDBHOST to the host name of the

database server.8. Change any other values that you want to change from the default values.9. When you are satisfied that the environment variable values are correct, accept

the values and proceed.

Installing the JBoss application serverThe installation proceeds to install the JBoss Application Server.

Procedure1. At the prompt, enter yes to install the JBoss Application Server.

Would you like to perform task JBOSS_INSTALL ? [yes/no] >yes

2. At the prompt, enter the location of the JBoss archive. The installation searchesthe location that you provide for version 4.0.3 SP1 of the JBoss ApplicationServer in .zip, .tar.gz , or .tar.bz2 format.Please enter the location of the JBoss 4.0.3SP1 archive(or q to quit)!: [/appl]---->/appl

The installation expands the archive into the necessary location:Deploying JBoss 4.0.3SP1...Buildfile: /appl/virtuo/admin/common/install/scripts/build.xml

init:[echo] JBOSS VERSION=4.0.3SP1[echo] JBoss Location=/appl

upgrade:

init:[echo] JBOSS VERSION=4.0.3SP1[echo] JBoss Location=/appl

copy-libs:[copy] Copying 2 files to /appl/virtuo/as/server/default/lib[copy] Copying 10 files to /appl/virtuo/lib/tp

init:[echo] JBOSS VERSION=4.0.3SP1[echo] JBoss Location=/appl

fix-alarm-war:[mkdir] Created dir: /appl/virtuo/temp[mkdir] Created dir: /appl/virtuo/temp/war/apps/lib[unjar] Expanding:

/appl/virtuo/as/server/default/deploy_core/S02-na-alarm-manager.ear into /appl/virtuo/temp

Chapter 9. Installing the Tivoli Netcool Performance Manager software 71

Page 80: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

[unjar] Expanding: /appl/virtuo/lib/na-alarm-service-server.jar into /appl/virtuo/temp

init:[echo] JBOSS VERSION=4.0.3SP1[echo] JBoss Location=/appl

fix-alarm-war:[mkdir] Created dir: /appl/virtuo/temp[mkdir] Created dir: /appl/virtuo/temp/war/apps/lib[unjar] Expanding: /appl/virtuo/as/server/default/deploy_core/S02-na-alarm-manager.ear into /appl/virtuo/temp[unjar] Expanding: /appl/virtuo/temp/S02-na-alarm-manager.war into/appl/virtuo/temp/war/apps/lib[unjar] Expanding: /appl/virtuo/lib/na-alarm-service-server.jar into/appl/virtuo/temp[copy] Copying 1 file to /appl/virtuo/temp/war/apps/lib[copy] Copying 1 file to /appl/virtuo/as/client[jar] Updating jar: /appl/virtuo/temp/S02-na-alarm-manager.war[jar] Updating jar: /appl/virtuo/as/server/default/deploy_core/S02-na-alarm-manager.ear

BUILD SUCCESSFULTotal time: 14 seconds

If you provide an invalid location for the JBoss archive, the installer promptsagain until you provide a correct location.

Installing the directory server schemaDescribes the steps that are required to install the directory server schema.

About this task

The installation proceeds to install the directory server schema.

Note: If you have already configured the Directory server schema by using theprocedure in “Installing a separate directory server” on page 67, then answer no atthe prompt.

Procedure1. At the prompt, enter yes to install the directory server schema:

Would you like to perform task DS_SCHEMA_INSTALL ? [yes/no] >yes

2. At the prompts, enter the LDAP passwords for the directory server users:Directory Manager, SysAdmin, and System:Please enter the password for ’Directory Manager’,

the Directory Server User [<password>]:

Please enter the password for ’SysAdmin’,

the Directory Server User [<password>]:

Please enter the password for 'System&apos;,

the Directory Server User [<password>]:

Installing the cronjobsDescribes the steps to install the cronjobs.

About this task

The installation proceeds to install the cronjobs. To install the cronjobs, provide therequired information when prompted. The recommended responses are shown asfollows.

72 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 81: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Procedure1. At the prompt, enter yes to install the cronjobs. You see the following

information:

What Type of PMW System Are you Installing ?-----------------------------------------------------------------------Please select the type of PMW System you are installing byentering the number associate with the system type :All Inclusive (1)Application (2)Loader (3)Directory Server (4)Database (5)Gateway (6)-----------------------------------------------------------------------[ 1 / 2 / 3 / 4 / 5 / 6] :(Enter . if unknown)

2. Enter 2.

Server type selected: APPLPlease enter the Directory Server log Directory [/appl/ldap/idsslapd-idsinst/logs]:(Enter . if unknown)

Please enter the PMW Log Directory [/appl/virtuo/logs]:(Enter . if unknown)

Please enter the PMW Archive Logs Directory [/data/trace_archive1]:(Enter . if unknown)

The installation continues on to install the root user and virtuo user cronjobs.

Installing the GatewaysDescribes the Gateways installation procedure.

About this task

The Tivoli Netcool Performance Manager are installed in $WMCROOT/gways. Thegateways installation package must be placed in the same directory as the coreTivoli Netcool Performance Manager packages. The gateways installation packagefile is: gways-gateway-framework-<version>.tar.gz.

Procedure1. At the prompt, enter yes to deploy the gateways on the Tivoli Netcool

Performance Manager server:Would you like to perform task GATEWAYS_INSTALL ? [yes/no] > yes................................Checking packages: gwaysperl /appl/vallent-vt-gways-vallent-NA<version>.tar.gz................................Verified the following packages:* /appl/vallent-vt-gways-vallent-NA<version>.tar.gz

2. At the prompt, enter yes to deploy the packages:Do you want to deploy the packages? [yes/no] > yesInstallinggways-vallent (NA<version>) ... okAll packages installed successfullySee $WMCROOT/admin/logs/pmw_install.log log file for installation errors.

Chapter 9. Installing the Tivoli Netcool Performance Manager software 73

Page 82: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

What to do next

On completion of the gateways installation, the installation proceeds to install thetechnology packs.

Installing the technology packsThe installation proceeds to install the technology packs. To install technologypacks, you must install and deploy packages, initialize the system, and apply thetechnology packs.

About this task

Note: It is recommended not to interrupt the installation during technology packinstallation.

Ensure that the technology pack packages and order file (vallent-vt-techpack_order) is in the /appl directory. The order file contains a list oftechnology packs for installation and the correct order for their deployment.

Note: By default, summary definition provisioning during technology packinstallation is switched off. If summary definition provisioning during technologypack installation is required, then edit the file $WMCROOT/conf/vmm/default.properties and change the value of the following property to true:vallent.vmm.techpack.provision.summaries.

Procedure1. At the prompt, enter yes to install the technology packs now.

Would you like to perform task TECHPACKS_INSTALL ? [yes/no] >yes................Techpack install order file found in /applChecking packages: vallent-vt-Neutral_Core_GOM vallent-vt-................Verified the following packages:* /appl/vallent-vt-Neutral_Core_GOM-1.0.tar.gz............

2. At the prompt, enter yes to deploy the packages.Do you want to deploy the packages? [yes/no] >yes InstallingNeutral_Core_GOM (1.0) ... ok............Ericsson_UMTS_UTRAN (1.0) ... okAll packages installed successfullyDetails in pmw_install.log

You might notice the following error:Waiting for appserver...Tue Apr 1 16:20:13 IST 2014: as is at state exec. Waiting for state STARTEDTue Apr 1 16:20:33 IST 2014: as is at state unknown. Waiting for state STARTEDTue Apr 1 16:20:45 IST 2014: as is at state unknown. Waiting for state STARTEDTue Apr 1 16:20:59 IST 2014: as is at state unknown. Waiting for state STARTED

To resolve this issue, follow these steps:v Restart the sap, sapmgr and sapmon services. If you have any problem in

restarting the services, check the <WMCROOT>/var/pid file for these processesand kill them.

v If the problem persists, check the error log in <WMCROOT>/logs/sapmon/sapmon-server.log and <WMCROOT>/logs/sapmgr/sapmgr-server.log and fix it.

3. At the prompt, enter yes to initialize the system.

74 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 83: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Would you like to perform task SYSINIT ? [yes/no] >yes..............

4. At the prompt, enter yes to apply the technology packs.Would you like to perform task TECHPACK_ADMIN ? [yes/no] >yesBuildfile: /appl/virtuo/admin/techpacks/build.xml..............[wmcInit] 13:03:09,320 [main] DEBUG logging - Created Logging Directory :/appl/ virtuo/logs/vmm[applyTechPacks] About to install modules. View logs for installation results.

5. For each technology pack you are applying, the techpack_admin tool looks inthe conf/vmm directory for a table space mapping properties file specific to thattechnology pack.Table mappings are used to assign technology pack tables optimal table spaces.The file name consists of:tablespace_" + techpack_dir + "_" + release_version + ".properties"

For example: tablespace_Ericsson_UMTS_UTRAN_1.0.properties

Note: techpack_dir is the technology pack directory name underadmin/techpacks, for example Ericsson_UMTS_UTRAN, and not the technologypack name.If a properties file exists, it is loaded and validated:Using custom tablespace settings from file/appl/virtuo/conf/vmm/ tablespace_Ericsson_UMTS_UTRAN_1.0.propertiesfor techpack Ericsson UMTS UTRAN

Example parameters that are to be set in the properties file are as follows:v ERI_AAL2_PATH_VCC_TP_MBH, TRAFFIC_MEDIUMv ERI_RADIO_LINK_STATE_MBH,TRAFFIC_JUMBOThe techpack_admin tool maps each table name to a table space by matchingagainst patterns in the mappings file. It logs the warning messages todocument the table space that is used to create each table, for example:Creating table ERI_AAL2_PATH_VCC_TP_MBH in user defined tablespace

TRAFFIC_MEDIUM

Or;Creating table ERI_RADIO_LINK_STATE_MBH in default tablespace TRAFFIC_JUMBO

If the file is found to contain invalid syntax, the following error is returned andthe installation fails:Syntax error in tablespace properties file/appl/virtuo/conf/vmm/tablespace_Ericsson_UMTS_UTRAN_1.0.properties

If no file is found or if the file is not readable, you must confirm that you wantto proceed with the default table space configuration, for example:

Note: Tablespace properties file /appl/virtuo/conf/vmm/tablespace_Ericsson_UMTS_UTRAN_1.0.properties does notexist!

Enter y to use default table space settings. If you enter N the installation failsand no technology packs are applied.

6. If the specific or default table space settings are applied successfully, theinstallation continues:..............[applyTechPacks] All modules installed successfully.[delete] Deleting: /appl/virtuo/admin/techpacks/new_techpacks[echo] Analyzing Tech Pack tables ...[wsqlplus] Reading /appl/virtuo/admin/techpacks/analyze/vmm_analyze.pks

Chapter 9. Installing the Tivoli Netcool Performance Manager software 75

Page 84: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

..............[wsqlplus] Package dropped.[wsqlplus] Commit complete.[echo] Analyze completeBUILD SUCCESSFULTotal time: 40 minutes 18 seconds

Encrypting passwordsThe installation proceeds to encrypt all stored Tivoli Netcool Performance Managersystem passwords.

About this task

The installation prints an individual message for each file that is encrypted.

Procedure

At the prompt, enter yes to encode the system passwords.Would you like to perform task ENCODE_PASSWDS ? [yes/no] >yesReplacing all passwords with encoded passwords...Encoding values in /appl/virtuo/conf/alarm_external_api/alarmapi.propertiesEncoding values in /appl/virtuo/conf/alarm_external_api/alarmapi.properties.NEncoding values in /appl/virtuo/conf/externalreporting/default.propertiesEncoding values in /appl/virtuo/conf/externalreporting/default.properties.NEncoding values in /appl/virtuo/conf/as/as-default.properties.NEncoding values in /appl/virtuo/conf/as/as-default.properties.BACKUPEncoding values in /appl/virtuo/conf/as/as-default.propertiesEncoding values in /appl/virtuo/conf/dbconnection/vtdb.propertiesEncoding values in /appl/virtuo/conf/dbconnection/vtdb.properties.BACKUPEncoding values in /appl/virtuo/conf/dbconnection/vtdb.properties.NEncoding values in /appl/virtuo/conf/ldap/default.propertiesEncoding values in /appl/virtuo/conf/ldap/default.properties.NEncoding values in /appl/virtuo/conf/ldap/default.properties.BACKUPPasswords may also be stored in /appl/virtuo/admin/logs/pmw_install.log,so it should be removed when not needed anymore.

What to do next

You must also install the loader components on the application server. See“Installing a Loader Server.” When installing the loader components, run thepmw_install script with the -a option.

Installing a Loader ServerDescribes the installation of a loader server.

About this task

Follow the steps to install a loader server.

Procedure1. Place all of the Tivoli Netcool Performance Manager software packages in the

/appl directory of the server:2. Run the following as user root:

# cd /appl# ksh pmw_install -wmcr <WMCROOT> [ -a ]

<WMCROOT> is the location where you want to install Tivoli Netcool PerformanceManager. The default installation directory is: /appl/virtuo.

76 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 85: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

The –a option is used where a different type of Tivoli Netcool PerformanceManager system is to be installed “on top” of an existing one, for example, aLoader system on top of a previously installed Application server.

3. Read and accept the license agreement and the following menu is displayed:What Type of System Are you Installing?

1. Standalone server2. Application Components only3. Loader Components only4. Directory Server Components only5. Database Components only6. Skip package deployment7. Exit PMW Install---->---->

4. Select option 3, Loader Components only.5. At the prompt, enter yes to deploy the packages:

Do you want to deploy the packages? [yes/no] >yes

Configuring the loadersEnter the configuration details for the loaders.

Procedure1. Ensure that you enter the correct values for the following variables:

WMCHOST The hostname of the application serverVTDBHOST The hostname of the database serverLDRHOST The hostname of the loader server

The installation proceeds to configure the core software.Please, Verify Environment Settings..........................1. Accept Variable Values below2. Reset Variables to Default values3. Change LDRHOST=<server_name>4. Change WMCHOST=<server_name>5. Change VTDBHOST=<server_name>

The installation lists the default values of Tivoli Netcool Performance Managerenvironment variables. These variables set server host names and various TCPport numbers vary from location to location. Accept the default values, restorevalues to their default settings, or change individual values.

Important: Set each of these environment variables to the correct value.2. Select option 4 and change the value of WMCHOST to the host name of the

application server.3. Select option 5 and change the value of VTDBHOST to the host name of the

database server.4. Change any other values that you want to change from the default values.5. When you are satisfied that the environment variable values are correct, accept

the values and proceed.

Installing the cronjobsThe installation proceeds to install the cronjobs.

Chapter 9. Installing the Tivoli Netcool Performance Manager software 77

Page 86: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

About this task

To install the cronjobs, provide the required information when prompted. Therecommended responses are shown.

Procedure1. At the prompt, enter yes to install the cronjobs.

What Type of PMW System Are you Installing ?-----------------------------------------------------------------------Please select the type of PMW System you are installing byentering the number associate with the system type :All Inclusive (1)Application (2)Loader (3)Directory Server (4)Database (5)Gateway (6)----------------------------------------------------------------------[ 1 / 2 / 3 / 4 / 5 / 6] :

2. Enter 3 to install the cronjobs.

What to do next

The installation continues on to install the root user and virtuo user cronjobs.

Once the cronjob installation is completed successfully, see the cronjob installationlog output at the following location:

$WMCROOT/admin/logs/pmw_install.log

Encrypting the passwordsThe installation proceeds to encrypt all stored Tivoli Netcool Performance Managersystem passwords.

About this task

The installation prints an individual message for each file that is encrypted.

Procedure

At the prompt, enter yes to encode the system passwords:Would you like to perform task ENCODE_PASSWDS ? [yes/no] >yesReplacing all passwords with encoded passwords...Encoding values in /appl/virtuo/conf/alarm_external_api/alarmapi.propertiesEncoding values in /appl/virtuo/conf/alarm_external_api/alarmapi.properties.NEncoding values in /appl/virtuo/conf/externalreporting/default.propertiesEncoding values in /appl/virtuo/conf/externalreporting/default.properties.NEncoding values in /appl/virtuo/conf/as/as-default.properties.NEncoding values in /appl/virtuo/conf/as/as-default.properties.BACKUPEncoding values in /appl/virtuo/conf/as/as-default.propertiesEncoding values in /appl/virtuo/conf/dbconnection/vtdb.propertiesEncoding values in /appl/virtuo/conf/dbconnection/vtdb.properties.BACKUPEncoding values in /appl/virtuo/conf/dbconnection/vtdb.properties.NEncoding values in /appl/virtuo/conf/ldap/default.propertiesEncoding values in /appl/virtuo/conf/ldap/default.properties.NEncoding values in /appl/virtuo/conf/ldap/default.properties.BACKUPPasswords may also be stored in /appl/virtuo/admin/logs/pmw_install.log,so it should be removed when not needed anymore.

78 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 87: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

What to do next

Note: For instructions on how to proceed after the loader software is installed onthe new server, see “Creating a Loader on a distributed server” on page 91

Installing the Gateways separatelyDescribes separate Gateways installation procedure.

About this task

You can install the gateways separately from a core installation. The gateways areinstalled in $WMCROOT/gways. Place the gateways installation package in the samedirectory as the core Tivoli Netcool Performance Manager packages. Therecommended location is /appl.

Note:

To install the gateways, copy the EPM packages to a directory of your choice. Inthe following example, the /appl directory is used.

Procedure1. Run the following commands as user virtuo:

cd /appl/virtuo/admin/common/install/scripts./deploy_gateways -pkgdir /appl

The deploy_gateways script searches the location that you specify for files ofthe form gways-gateway-framework-*.tar.gz. If you do not specify a directory,it searches in the current directory. If no file names that match this pattern arefound, it looks for files that match the pattern vallent-vt-gway*.tar.gz.

Note: If you want to install gateways other than the standard ones, rundeploy_gateways as follows:./deploy_gateways -pkgdir /appl -gateways <gw1>,<gw2>,...

Where <gw1>,<gw2>,... is a comma-separated list of gateway packages.2. At the prompt, enter yes to deploy the packages.

Do you want to deploy the packages? [yes/no] > yesInstallinggways-vallent (NA9.1.2.18.01) ... okAll packages installed successfully

What to do next

For installation error messages, see the $WMCROOT/admin/logs/pmw_install.log logfile.

Chapter 9. Installing the Tivoli Netcool Performance Manager software 79

Page 88: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

80 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 89: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Chapter 10. Installing the technology packs separately

Instructions to install the technology packs.

Note: In a distributed installation, install the technology packs on the applicationserver only unless otherwise indicated.

Note: It is recommended not to interrupt the installation of technology packinstallation.

You install technology packs by using the deploy_techpacks script and thetechpack_admin tool. Before you install a technology pack, ensure that the mainTivoli Netcool Performance Manager schema is installed. For more informationabout using the techpack_admin tool, see the Administering Tivoli NetcoolPerformance Manager - Wireless Component.

Note: By default, summary definition provisioning during technology packinstallation is switched off. If summary definition provisioning during technologypack installation is required, then edit the file $WMCROOT/conf/vmm/default.properties and change the value of the following property to true:vallent.vmm.techpack.provision.summaries

Starting the systemStarting the SAP application server.

About this task

Follow these steps as user virtuo to start the system:

Procedure1. Check if the application server has started:

sap disp

2. If the application server is not started, run the following command:sap start as

© Copyright IBM Corp. 2006, 2017 81

Page 90: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Setting up users and data sourcesCreate the users and data sources before you install the technology packs.

About this task

Before you install the technology packs, create the users and data sources asfollows:

Procedure1. As user virtuo, run the command:

sys_init -u sysadm -p <password> -h <fully-qualified hostname>

If the users and data sources exist on the system, you see the followingmessage. You can continue the installation.ERROR: The system is already initialized

2. Alternatively, use a web browser to open:http://<hostname>:8080/sysinit

Log in with the user ID sysadm and password to create the users and datasources.

Checking database spaceCheck the database space to ensure that the table space sizing is correct.

About this task

Check the Tivoli Netcool Performance Manager database to make sure that tablespace sizing is correct, as per the customer sizing response file. All table spacesshould be the correct size for your network.

Before you install the technology packs, there should be at least 50% free space ineach table space.

To check table spaces using Oracle Enterprise Manage Console (or another tool),perform the following:

Procedure1. Connect to the database as user virtuo.2. Select Storage on Enterprise Manage Console; select table spaces.3. Check the Used % column (last column on right) and confirm that none have

exceeded 50%. If they have, add a new database file by: For example,WM_CLIENT.a. Double-click table space.b. Copy a database file entry that exists and pasting it into a new row.c. Modify the name to make it unique.

82 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 91: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Installing the technology pack: step 1The first installation process for the technology pack.

Before you begin

Run the following commands as user virtuo:sapmon startsapmgr startsap start as

About this task

Follow the steps to install the technology pack:

Procedure1. As user virtuo copy the technology pack Enterprise Performance Management

(EPM) packages. For example, copy the vallent-vt-<techpack name1>.gz,vallent-vt-<techpack name2>.gz and the order file that is calledvallent-vt-techpack_order into the $WMCROOT/admin/techpacks/packagesdirectory. The order file contains a list of technology packs for installation andthe correct order for their deployment. For example:vallent-vt-Neutral_Core_GOMvallent-vt-Neutral_GSM_BSS_NSS_GOMvallent-vt-Neutral_GPRS_UMTS_CN_GOMvallent-vt-Neutral_GPRS_BSS_GOMvallent-vt-Neutral_UMTS_UTRAN_GOMvallent-vt-NOK_GOMletvallent-vt-GSM_Nokia_BSS_RG20

2. Install the technology packs as user virtuo as follows:cd /appl/virtuo/admin/common/install/scripts./deploy_techpacks -wmcr $WMCROOT -pkgdir $WMCROOT/admin/techpacks/packages

The installation searches the directory that is specified by -pkgdir for thevallent-vt-techpack_order file. The script uses this list and attempt to installeach of the technology packs in turn. The installation looks for the technologypack packages in the same directory as the vallent-vt-techpack_order file.To install a custom set of technology packs, run deploy_techpacks as follows:./deploy_techpacks -wmcr $WMCROOT -pkgdir $WMCROOT/admin/techpacks/packages -techpacks <techpack1>,<techpack2>,...

<techpack1>,<techpack2>,... is a comma-separated list of technology packpackages. The release notes for your distribution states if this step is necessary.The following output is displayed:Techpack install order file found in /appl/virtuo/admin/techpacks/packagesChecking packages: <techpacks>Verified the following packages:<package 1><package 2>...Do you want to deploy the packages? [yes/no] >

3. Enter yes to confirm the package deployment.

What to do next

After the installation is complete, check the following points:v The technology packs are installed in $WMCROOT/admin/techpacks directory.

Chapter 10. Installing the technology packs separately 83

Page 92: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

v The generated file $WMCROOT/admin/techpacks/new_techpacks contains thecomplete list of installed technology packs in the correct order.

v If any errors occurred during the installation. See the $WMCROOT/admin/logs/pmw_install.log file for any error messages.

Installing the technology pack: step 2The second installation process for the technology pack.

Before you begin

Run the $WMCROOT/bin/techpack_admin script to configure the new technologypacks.

The techpack_admin script looks for a file that is called new_techpacks generatedduring “Installing the technology pack: step 1” on page 83. This file contains a listof technology packs to install in the database by using the techpack_admin script.

About this task

Follow the steps to install the technology pack:

Procedure

To apply the technology packs, as user virtuo, run the following command:techpack_admin -a

The techpack_admin -a script causes a number of changes that you must verify:v Creation of technology pack traffic tables in the databasev Loading of the technology pack loadmapsv Configuration of the new loadersv Service Application Server (SAP) configuration for new loaders

Performing postinstallation checks for the technology packs

Details the postinstallation checks for the technology packs.

About this task

To ensure that the technology packs are installed correctly, check the followingitems.

Procedure1. The technology packs are successfully installed under $WMCROOT/admin/

techpacks

2. There are no error messages in log file $WMCROOT/logs/vmm/vmm-server.log3. The wmd_field_def table in the database is populated.4. Run this command as user virtuo:

84 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 93: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

schema_admin -checkmodel

This query determines the hierarchy that is used in reporting. If the queryreturns NULL, or if the reportable column in the output is set to N, then there isa problem. Uninstall and reinstall the technology packs.

5. Generic loader start script generated called $WMCROOT/bin/run_njloader.6. Check the database for rows that are entered in the following loadmap tables:

LC_DATASOURCELC_LOADMAPLC_RELATIONSLC_RULESETLC_LOADER_CONFIG_PROPERTIES

SOURCE_TABNAME can be null, this means that the nc table has noassociated performance tables.

7. Loader data directories created:$WMCROOT/var/loader/spool/<DSname_DSversion>/<DS_version>/$WMCROOT/var/loader/spool/<DSname_DSversion>/<DS_version>/good$WMCROOT/var/loader/spool/<DSname_DSversion>/<DS_version>/bad

8. To get information about the rulesets associated with the technology packsinstalled, enter the following query:SQL> select RULESET_ID, DESCRIPTION, TYPE from LC_RULESET;

9. Ensure that the source folder for loading files is set correctly in the loaderproperties.Run the following command as user virtuo:loader_admin -unload all_loader_properties.xml -instance ALL

A file that is called all_loader_properties.xml is created.Example content of a all_loader_properties.xml is shown:<loaderconfig><loader><name>alcgsmbss_b9</name><property><name>itm.enabled</name><value>FALSE</value></property>.....</loader><loader><name>motgsmbss_gsr80</name>....</loader></loaderconfig>

There must be a <loader> section for each installed loader. If there is not a<loader> section for each loader, then there is a problem during technologypack installation. In this case uninstall and reinstall the technology pack.Check that each <loader> section contains a datasource.folder property:<property><name>datasource.folder</name><value>/appl/virtuo/var/loader/spool/dsname_dsversion/dsversion</value></property>

The datasource name and version has white spaces and non-alphanumericcharacters removed. For example,<property> <name>datasource.folder</name> <value>/appl/virtuo/var/loader/spool/nkbss_oss31ed3/OSS3.1_ED3</value> </property>

The datasource folders do not need to exist when the technology pack isinstalled. If they do not exist, they are created by the loader on first start. Inthis case, they must to be specified in a location where the virtuo user has

Chapter 10. Installing the technology packs separately 85

Page 94: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

permission to create them. The datasource.good and datasource.baddirectories must also be specified in a location where the virtuo user haspermission to create them. By default they are subdirectories of the datasourcefolder, and so have the correct permissions.If the datasource folder properties are not correct, update them. A fulldescription of how to update loader properties is given in the LoaderConfiguration section of the Administering Tivoli Netcool PerformanceManager - Wireless Component.The rest of the all_loader_properties.xml file can also be examined to seethat the properties are correct for the current installation. When you updateloader properties, it is better to export the properties for just the instance youwant to change by specifying the instance name when you use theloader_admin tool.

10. To get information on data sources associated with the loadmaps andtechnology packs installed, enter the following query:SQL> select DATASOURCE_NAME, DATASOURCE_VERSION from LC_DATASOURCE;

Ensure the following tasks:v The DATASOURCE_NAME and version are contained within the VALUE of the

property.v The directory that is specified in the DATASOURCE_NAME exists. For

example:/appl/virtuo/var/loader/spool/<DSname_DSversion>/<DS_version>

DATASOURCE_NAME DATASOURCE_VERSION--------------- ------------------Nokia GSM BSS RG20Huawei LTE PCRF_UPCC V300R005C00

/appl/virtuo/var/loader/spool/nokiabss_oss31ed3/OSS3.1_ED3

v SAP property files that are created for each loader type:$WMCROOT/conf/processes/processes-load_<loader>.properties

Note: The timezone setting for a loader currently defaults to the time zone onthe installation server. Confirm that this setting is correct for the data you areloading. If necessary, change the setting by using the loader_admin tool.

Starting the SAP process monitor toolStart the Tivoli Netcool Performance Manager process management tool.

About this task

Perform the following steps to start the SAP process monitor tool.

Procedure1. Run the commands that are specified for the system, as root user:

v/etc/rc.d/init.d/sapmgrvirtuo start

vsvcadm disable sapmgr-nasvcadm enable sapmgr-na

vservice sapmgrvirtuo --full-restart

86 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 95: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

2. Check that the application server is started and that all the configured loadersare stopped by running the following command as user virtuo:sap disp

The following output is displayed showing the application server is started andall the configured loaders are stopped:NAME STATE SINCEas STARTED 17:54:38nc_cache STARTED 17:55:07alarm_cache STARTED 17:55:13<loader> stopped -. . .. . .

Starting the Application ServerSteps to start the Application Server.

About this task

To check if the application server is started.

Procedure1. Run the following command as user virtuo:

sap disp

If the application server is started, you see output similar to the following:NAME STATE SINCEas STARTED 17:54:38nc_cache STARTED 17:55:07alarm_cache STARTED 17:55:13

2. If the application server is not started, run the following commands as uservirtuo.sap start assap disp

The application server status is shown as started.NAME STATE SINCEas STARTED 17:54:38nc_cache STARTED 17:55:07alarm_cache STARTED 17:55:13

Starting the LoadersSteps to start the Loaders.

About this task

You can now start the newly configured loaders.

Procedure1. Start the loaders as user virtuo:

$ sap start <loader name>

2. Check that the latest loaders are shown as added:$ sap dispNAME STATE SINCEas STARTED 12:15:55

Chapter 10. Installing the technology packs separately 87

Page 96: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

nc_cache stopped 12:16:32alarm_cache stopped 12:17:48<loader> STARTED 12:15:50<loader>1 STARTED 12:15:52

3. Check the loader logs for startup issues with any of the loaders:$WMCROOT/logs/loader/*.log

Configuring multiple identical LoadersSteps to configure multiple identical Loaders.

About this task

Typically, you would configure and start more than one loader of a particular type.

The following examples illustrate how to add extra loaders of a particular type.Run commands as user virtuo unless otherwise indicated.

Procedure1. Create a loader instance by using default system properties, or by using the

properties of an existing loader instance. To create a loader instance by usingdefault properties, first use lcm_admin to check the data source name andversion of the loader you want to create:$ lcm_admin –listData Source InformationTechpack Name Version DataSource Name Version Technology Vendor----------------------------------------------------------------------Ericsson GSM BSS 1.0 Ericsson BSS R10 GSM Ericsson

2. Add a loader instance, by using the loader_admin command, giving anarbitrary name for the instance and the data source name and version from therequired technology pack:$ loader_admin –init –instance ericssconbss_r10_1 –dsname “Ericsson BSS”–dsversion R10Buildfile: /appl/virtuo/conf/loader/loader_admin.xmlinit:[initlog] 18:14:11,483 [main] WARN logging - TRCE-0022 :The name of the process is null or empty.initloader:[initloader] Initialise Loader:[initloader] Instance Name: [ericssconbss_r10_1][initloader] Datasource Name: [Ericsson BSS][initloader] Datasource Version: [R10][initloader] New properties created for [ericssconbss_r10_1][initloader] Created sap process file for [ericssconbss_r10_1][initloader] Restarted sapmgr[initloader] New instance creation completed

3. Create an instance from the properties of an existing instance:$ loader_admin –init –instance ericssconbss_r10_1 -copy ericssonbss_r10Buildfile: /appl/virtuo/conf/loader/loader_admin.xmlinit:[initlog] 18:17:27,389 [main] WARN logging - TRCE-0022 :The name of the process is null or empty.initloader:[initloader] Initialise Loader:[initloader] Instance Name: [ericssconbss_r10_1][initloader] Source instance name: [ericssonbss_r10][initloader] New properties created for [ericssconbss_r10_1][initloader] Created sap process file for [ericssconbss_r10_1]

88 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 97: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

[initloader] Restarted sapmgr[initloader] New instance creation completedBUILD SUCCESSFULTotal time: 8 seconds

4. Whichever method you use to create the new loader, use the sap dispcommand to check that it is now in the SAP process list. (Note SAP might beunavailable for a few seconds after loader_admin –init while the sapmgrprocess reinitializes):NAME STATE SINCEas STARTED Oct 23, 2008nc_cache STARTED Oct 29, 2008alarm_cache STARTED Oct 29, 2008load_ericsson bss_r10 stopped -load_ericssconbss_r10_1 stopped –

Loading dataDescribes the data loading on the loaders on the distributed systems.

Note: Distributed systems only. In a distributed installation, load data on theloader servers only.

Place data files (.lif) in the loader spool directory. Files are processed and placedin either the good or bad directory. You can configure Tivoli Netcool PerformanceManager gateways to generate .lif files in the appropriate loader directory.

For example:/appl/virtuo/var/loader/spool/<DSname_DSversion>/<DS_version>

Verifying data loadingThis procedure describes the verification process of the data loading on the loaderson the distributed systems.

About this task

Check the technology pack tables for network configuration (NC) and traffic dataloading into tables. Check if the data .lif files are processed and put in the rightdirectories.

Procedure1. Check if the Traffic tables are stored in the traffic_large table space in the

database pointed to by ORACLE_SID. For example.vtdb.2. Data .lif files must be processed and put in either the good or bad directories

under the generated loader directory for the configured loader. For example:$WMCROOT/var/loader/spool/<DSname_DSversion>/<DS_version>/good$WMCROOT/var/loader/spool/<DSname_DSversion>/<DS_version>/bad

Chapter 10. Installing the technology packs separately 89

Page 98: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Removing Loadmaps and Loader configurationUse this procedure if loader configuration fails or for a point release upgrade.

About this task

This procedure removes all of the loader properties files in /appl/virtuo/conf/processes/.

Important: Remove all installed technology packs before this procedure. Use thetechpack_admin -u command to uninstall technology packs. See the AdministeringTivoli Netcool Performance Manager - Wireless Component for information aboutuninstalling technology packs.

To perform a reinstall of the loader and loadmap configuration, complete thefollowing steps.

Procedure1. Stop LCM, sapmgr, and sapmon as user root:

v/etc/rc.d/init.d/sapvirtuo stop/etc/rc.d/init.d/sapmgrvirtuo stop/etc/rc.d/init.d/sapmonvirtuo stop

vsvcadm disable sap-nasvcadm disable sapmgr-nasvcadm disable sapmon-na

vservice sapvirtuo stopservice sapmgrvirtuo stopservice sapmonvirtuo stop

2. Remove spool directories as user virtuo.rm -rf /appl/virtuo/var/loader/spool/*

3. Delete LC_* table rows as user virtuo.SQL> delete from lc_datasource;SQL> delete from lc_loadmap;SQL> delete from lc_relations;SQL> delete from lc_ruleset;SQL> delete from lc_loader_config_properties where loader_name != ’SYSTEM’;

4. Remove SAP loader properties files as user virtuo.rm -rf /appl/virtuo/conf/processes/*load*.properties

5. Reinstall the technology packs and loaders by using the procedures that start at“Starting the system” on page 81

90 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 99: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Creating a Loader on a distributed serverSteps to create a Loader on a distributed server.

About this task

When you install technology packs on the application server, the installationcreates the loader instances on the application server by default. To configure aseparate loader server, you must relocate these instances to the loader server.

Note: Before you can move a loader instance to another server, you must installthe loader software packages on the new server.

Ensure that the loader server is installed by using the procedure in “Installing aLoader Server” on page 76. You must also install the loader components on theapplication server. When you install the loader components, run the pmw_installscript with the -a option.

To start a loader instance on a distributed server, it is necessary to relocate the sapprocess manually. (If a new instance is required, first create the instance on theapplication server as described in “Starting the Loaders” on page 87).

To relocate the SAP process, complete the following steps on the application server.

Procedure1. If the loader instance that you want to relocate is running, stop the instance:

$ sap stop load_<loadername>

2. Edit the SAP process file for the loader:$WMCROOT/conf/processes/processes-load_<loadername>.properties.

Change the value of the host name property to the required target server:com.comnitel.process.load_<loadername>.host=<servername>

Save the file.3. Stop and restart the SAP manager. To stop the SAP manager, run the following

commands as user root:

v/etc/rc.d/init.d/sapmgrvirtuo stop

vsvcadm disable sapmgr-nasvcs "*-na*"

Check that the SAP manager is disabled:svcs "*-na*"

vservice sapmgrvirtuo stop

4. Restart the SAP manager:

v/etc/rc.d/init.d/sapmgrvirtuo start

vsvcadm enable sapmgr-na

Chapter 10. Installing the technology packs separately 91

Page 100: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

vservice sapmgrvirtuo start

5. Check the loader status:sap disp -l

The loader being moved shows the new host name:NAME STATE SINCE HOST GROUP STIME PIDas STARTED Oct 23 <core_host> asgroup Oct 23 17277nc_cache STARTED Oct 29 <core_host> loadercache Oct 29 6716alarm_cache STARTED Oct 29 <core_host> loadercache Oct 29 6726load_<loadername>stopped - <target_host> Ericsson GSM - -

You can now stop and start this loader as normal by using sap start fromeither the application server or the distributed loader server.

Note: When the loader first starts on the new server, it creates its data sourcefolder on the new server.

92 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 101: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Chapter 11. Postinstallation tasks

The postinstallation tasks that are required for the Tivoli Netcool PerformanceManager installation

Complete the following postinstallation tasks:v Provisioning Stored Busy Hours, Summaries, and Data Availability.v Configuring Application Server Memory (optional).v Configuring Loader Server Memory (recommended).v Checking the Time Zone Settings for the Report Scheduler.v Changing the Default Client Ports.v Integrating IBM Tivoli Monitoring (optional).

Provisioning stored Busy Hours, Summaries, and Data AvailabilityDetails the provisioning of stored Busy Hours, Summaries, and Data Availability.

A number of technology packs contain Stored Busy Hour (SBH), Summary, andData Availability definitions. You must provision these definitions before you canuse them.

Stored Busy Hours definitionsIf a technology pack contains SBH definitions, these definitions are contained in anXML file.

Location

The SBH definition file for each technology pack is:

<TP_ROOT>/busyhours/BusyHourInstance.xmlwhere <TP_ROOT> is $WMCROOT/admin/techpacks/<techpack_name>/<techpack_version>

You can provision SBH definitions by using the sbh_admin tool to import an SBHdefinition file. The sbh_admin tool is in:$WMCROOT/bin

You can run the sbh_admin tool from any directory as user virtuo.

Usagesbh_admin -i [-f <file> | -p <directory>] -m [overwrite | ignore | fail]-i Import-f Import the Stored Busy Hour Definition from <file>.-p Import all busy hour definitions stored in <directory>.

© Copyright IBM Corp. 2006, 2017 93

Page 102: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

All files with an .xml suffix are imported.-m mode:overwrite: If the definition already exists, update it.ignore: If the definition already exists, do not update it and do not fail the

importfail: If the definition already exists, fail the import.

sbh_admin -i -f BusyHourInstance.xml -m overwrite

Import the SBHs defined in BusyHourInstance.xml, overwriting the definitions ifthey exist.sbh_admin -i -p indir -m overwrite

If the two files SBH1.xml and SBH2.xml exist in the indir directory, the definitionsin SBH1.xml and SBH2.xml are imported.

Summary definitionsIf a technology pack contains Summary definitions, these definitions are containedin an XML file.

Location

The Summary definition file for each technology pack is:<TP_ROOT>/summaries/SummaryInstance.xml

You can provision summary definitions by using the summary_admin tool to createeach definition in a definition file. The summary_admin tool is in:$WMCROOT/bin

You can run the summary_admin tool from any directory as user virtuo.

Note: If Summary definitions are provided but not provisioned, an attempt to usethese definitions result in an error. For example, opening a report template thatuses KPIs with Summary definitions specified in a technology pack'sSummaryInstance.xml.

Usage

The full usage of the tool is not documented here. Only usage relevant toprovisioning a definition file is shown.summary_admin -c -f <file>-c Create-f Create Summary Definitions from <file>.

summary_admin -c -f SummaryInstance.xml

Create the Summaries that are defined in SummaryInstance.xml.

Data Availability definitionsIf a technology pack contains Data Availability definitions, these definitions arecontained in an XML file.

Location

This file contains information about the technology pack, and a list of blocks ofdata that is loaded for that technology pack.

94 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 103: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

If the value of the block is set to true, that is, <block name="ATMUSAGE">true</block>, then after the file is loaded the loader starts producing Data Availability(DA) statistics every time it loads a block of ATMUSAGE data.

Note: This file is intended to be user-customized: you can switch blocks on or off.It is important to realize that blocks, which are tracked take twice as long to loadas blocks that are not. Only high-level entities (MSC, BSC, ...) must be tracked, butnot low-level entities (TRX, ...).

The Data Availability definition file for each technology pack is:<TP_ROOT>/loadmaps/dataavailability/dataavailability<techpack_name>.xml

You can provision data availability definitions by using the lcm_admin tool. Thelcm_admin tool is in:$WMCROOT/bin

You can run the lcm_admin tool from any directory as user virtuo.

Usage

The full usage of the tool is not documented here. Only usage relevant toprovisioning a definition file is shown.lcm_admin -load <data_availability.xml>

lcm_admin -load dataavailability_umts_siemens_utran_umr050_1.0.0.0.xml

Configuration of the Application Server memory (Optional)On larger Tivoli Netcool Performance Manager installations, configuring Javavirtual machine (JVM) heap memory settings can improve performance and allowfor better application server usage.

You can configure the heap memory to suit the size of your system and theamount of system usage, particularly for running large reports.

To configure the heap memory, edit the jvm.args property in the$WMCROOT/conf/as/jvm-default.ini file.

The jvm.args propertyDescribes the jvm.args property for the heap memory configuration.

The jvm.args property contains the following settings:-Xms512m -Xmx512m -XX:+AggressiveHeap

-Xms<n>Describes the -Xms<n> argument.

-Xms<n> specifies the initial size of the memory allocation pool in bytes. Appendthe letter m or M to indicate megabytes, or g or G to indicate gigabytes. The defaultvalue is 1024 MB.v -Xms1024m

v -Xms1G

-Xmx<n>Describes the -Xmx<n> argument.

Chapter 11. Postinstallation tasks 95

Page 104: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

-Xmx<n> specifies the maximum size of the memory allocation pool in bytes.Append the letter m or M to indicate megabytes, or g or G to indicate gigabytes. Thedefault value is 1024 MB.v -Xmx2048m

v -Xmx2G

-XX:+AggressiveHeapDescribes the -XX:+AggressiveHeap argument.

-XX:+AggressiveHeap is a Garbage Collection Tuning setting. The option inspectsthe server resources (size of memory and number of processors), and attempts toset various parameters to be optimal for long-running, memory allocation-intensivejobs. The physical memory on the servers must be at least 256 MB beforeAggressiveHeap can be used. The size of the initial heap is calculated based on thesize of the physical memory and attempts to make maximal use of the physicalmemory for the heap (that is, the algorithms attempt to use heaps nearly as largeas the total physical memory).

Recommended jvm.args Property settings for ApplicationServers

Describes the recommended jvm.args property settings for Application Servers.

It is highly recommended to set the same values for both –Xms and –Xmx. Table 5lists the recommended settings.

Table 5. Recommended jvm.args Property Settings for Application Servers

System Size Memory Setting

Demo -Xms512m and -Xmx512m

Small -Xms512m and -Xmx512m

Production At least -Xms2048m and -Xmx2048m (Confirm thisrecommendation with performance testing)

Complete documentation for all JVM settings is available from the Sun Javawebsite http://www.oracle.com/technetwork/java/index.html.

Configuration of Loader Server memory (Recommended)You can improve loader performance by configuring the Java virtual machine(JVM) memory settings.

You can configure each loader individually. It is recommended that you balancethe memory for loaders according to their throughput.

To configure the heap memory, edit the loader properties file for the loaderprocess.

96 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 105: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

The SAP configuration params propertyEach loader properties file contains a params property.

By default, it is of the form:com.comnitel.process.load_<instance-name>.params=<instance-name>

For example:com.comnitel.process.load_nokiabss_oss31ed3.params=nokiabss_oss31ed3

The location for a loader's properties file is:

<WMCROOT>/conf/processes/processes-load_<loader>.properties

By default, the JVM heap memory setting for loaders is 1,536 MB (1.5 GB) for bothmaximum and minimum. You can modify the default settings by providingalternate values for the initial size of the memory allocation pool as follows:com.comnitel.process.load_<instance-name>.params=<instance-name> <min> <max>

By default, the value is in bytes. Append the letter m or M to indicate megabytes,or g or G to indicate gigabytes. If you provide only one value, it becomes bothminimum and maximum. For optimal performance, it is highly recommended touse identical settings for both.

For example, enter the following to set both the minimum and maximum memoryto 2 GB:com.comnitel.process.load_nokiabss_oss31ed3.params=nokiabss_oss31ed3 2g

Note: It is only possible to set loader process settings in this way. You cannot setother SAP processes with this mechanism.

Restart sapmgr after you change a process configuration file. As user virtuo, runthe command:$ sapmgr restart

Note: This action does not restart any of the services, such as loaders or theapplication server.

When you change the configuration of a running loader, you must restart theloader process to use the new settings as follows:1. Run this command:

$ sap stop load_nokiagsmbss_rg20

2. Wait until the loader stops, and then run the following command:$ sap start load_nokiagsmbss_rg20

Chapter 11. Postinstallation tasks 97

Page 106: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Recommended JVM memory size settings for Loader ServersThe amount of memory that you must allocate to each loader process depends onthe throughput and size of files that are handled by the loader.

Low-volume processes can be set with a maximum of 1 GB. High-volumeprocesses that are configured without multithreading must be set to at least 2 GB,and high-volume processes with multithreading set to at least 3 GB.

Table 6 lists the recommended settings for both maximum and minimum memory:

Table 6. Recommended JVM size settings for Loader servers

System Size Memory Setting

Demo 1 g

Small 1526 m

Production At least 2 g (Confirm this recommendationwith performance testing)

Checking the Time Zone settings for the Report SchedulerThe location to check the time zone settings.

Check that the time zone settings for the report scheduler correct in the followinglocation:

v/etc/environment

v/etc/default/login

v/etc/localtime

Setting the Time ZoneIf the timezone is not set or is incorrectly set, use the tz_admin tool to set orchange the timezone.

For example:tz_admin -addcurtzr <timezone_name>

For more information on setting time zones for the report scheduler, see Timezonesupport for reporting section of the Administering Tivoli Netcool Performance Manager -Wireless Component.

98 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 107: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Changing the default client portsThe defaults ports that are used by the Tivoli Netcool Performance Manager clientcan be changed.

The default ports that are used by the Tivoli Netcool Performance Manager clientare as follows:v HTTP server: 8080v Alarm service: 4444 (required for the alarm window)

After installation, information for these ports is stored in the two files:v $WMCROOT/conf/as/as-default.properties

v $WMCROOT/as/server/default/deploy/jbossweb-tomcat55.sar/server.xml

The conf/as/as-default.properties file contains both port values. The$WMCROOT/as/server/default/deploy/jbossweb-tomcat55.sar/server.xml filecontains the HTTP server port.

To change the default ports, update the port values in both files. After you makechanges, stop and restart the application server.

Note: For the Tivoli Netcool Performance Manager client to work, the two portsmust be open on any firewall between the server and the client PC.

Editing the default.properties fileEdit the default.properties file to add additional entries to deactivate thenetwork elements that do not have data for a specified number of days.

About this task

the default.properties file is located here:

/appl/virtuo/conf/nc_manager/default.properties

Procedure

Edit the file to add the following entries to thecom.ibm.tivoli.tnpmw.ncmanager.entities field:EUtranCell,EUtranRelation

Integrating IBM Tivoli MonitoringIBM Tivoli Monitoring integration is an optional feature. The Tivoli NetcoolPerformance Manager installation procedure will not automatically configure theTivoli Netcool Performance Manager Tivoli Monitoring agents.

For information on installing and configuring Tivoli Monitoring and TivoliMonitoring agents, integrating Tivoli Monitoring with Tivoli Netcool PerformanceManager and information on deploying agents to a server, see IBM TivoliMonitoring Integration. For information about the IBM Tivoli Monitoring productdocumentation, see:http://www.ibm.com/support/knowledgecenter/SSTFXA_6.3.0.2/com.ibm.itm.doc_6.3fp2/welcome.htm

Chapter 11. Postinstallation tasks 99

Page 108: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Integrating IBM Tivoli Netcool/OMINbus Web GUIIBM Tivoli Netcool/OMINbus Web GUI 8.1 integration is an optional feature. TheTivoli Netcool Performance Manager installation procedure does not automaticallyconfigure the Tivoli Netcool Performance Manager Tivoli Netcool/OMINbus WebGUI.

About this task

For more information about this integration, see Integrating with TivoliNetcool/OMNIbus Web GUI - Wireless Component.

100 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 109: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Chapter 12. Starting Tivoli Netcool Performance Manager

Start Tivoli Netcool Performance Manager after installation.

Rebooting the serverReboot the server to ensure all the Tivoli Netcool Performance Manager processesstart automatically and correctly.

Before you begin

Before you reboot a server, stop all processes by running the command as uservirtuo:$ sap stop -f

About this task

Run the commands to reboot the server.

Procedure1. To reboot the server, run the commands as user root on each of the Tivoli

Netcool Performance Manager servers:

v# shutdown -Fr

v# /usr/sbin/shutdown -i6 -g0 -y

v# shutdown -r now

Important: Distributed systems only. In a distributed system, you must rebootthe Tivoli Netcool Performance Manager servers in the following order:database server, directory server, application server, and loader servers.

2. Disable the firewall by using these commands:Determine if the firewall is enabled.For RHEL 7.x:v Checking status:

systemctl status firewalld

v Stopping the firewall:service firewalld stop

v Starting the firewall:service firewalld start

© Copyright IBM Corp. 2006, 2017 101

Page 110: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Process checks for Solaris

Run process checks to ensure that the processes are running correctly.

On Solaris 11, run this command as user root to check the status of the system:# svcs -x "application/virtuo*"

Sample output from a monolithic server.svc:/application/virtuo/database-na:global(NetworkAssure Database instance)State: online since Tue Oct 04 13:28:41 2011See: /var/svc/log/application-virtuo-database-na:global.log

Impact: None.

svc:/application/virtuo/sap-na:na (Virtuo SAP server instance na)State: online since Fri Sep 23 04:47:27 2011See: /var/svc/log/application-virtuo-sap-na:na.log

Impact: None.

svc:/application/virtuo/sapmgr-na:na (Virtuo SAP manager instance na)State: online since Fri Sep 23 04:45:13 2011See: /var/svc/log/application-virtuo-sapmgr-na:na.log

Impact: None.

svc:/application/virtuo/sapmon-na:na (Virtuo SAP monitor instance na)State: online since Fri Sep 23 04:44:56 2011See: /var/svc/log/application-virtuo-sapmon-na:na.log

Impact: None.

svc:/application/virtuo/sds-na:na (PMW sds instance na)State: online since Fri Sep 23 04:45:19 2011See: /var/svc/log/application-virtuo-sds-na:na.log

Impact: None.

svc:/application/virtuo/database-na:global (NetworkAssure Database instance)State: online since Fri Sep 23 04:42:59 2011See: /var/svc/log/application-virtuo-database-na:global.log

Impact: None.

Process checks for AIXRun process checks to ensure that the processes are running correctly.

On AIX, run the following commands to check the status of

processes:/etc/rc.d/init.d/dboravirtuo status/etc/rc.d/init.d/sdsna status/etc/rc.d/init.d/sapmonvirtuo status/etc/rc.d/init.d/sapmgrvirtuo status/etc/rc.d/init.d/sapvirtuo status

Sample output:# /etc/rc.d/init.d/dboravirtuo statusDatabase listener is running.Database instance vtdb is running.

# /etc/rc.d/init.d/sdsna statusSDS LDAP server is runningSDS admin server is running

102 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 111: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

# /etc/rc.d/init.d/sapmonvirtuo statussapmon process running

# /etc/rc.d/init.d/sapmgrvirtuo statussapmgr process running

# /etc/rc.d/init.d/sapvirtuo status

............

............

NAME STATE SINCEas STARTED Oct 08, 2017asd STARTED Oct 08, 2017nc_cache STARTED Oct 08, 2017alarm_cache STARTED Oct 08, 2017load_erics_r10 STARTED Oct 08, 2017load_nok_oss31ed3 STARTED Oct 08, 2017load_motor_gsr7 STARTED Oct 08, 2017load_erics_r30 STARTED Oct 08, 2017

Separate services are installed for each instance of Tivoli Common Reporting youinstalled on each server. Use the trcmd -checkstatus command to check the statusof a specific Tivoli Common Reporting component.Related information:

Tivoli Common Reporting commands

Process checks for Linux

Process checks can ensure that the processes are running correctly.

On Linux, use the following status commands to the init.d services as root user:# service dboravirtuo status# service sdsna status# service sapmonvirtuo status# service sapmgrvirtuo status# service sapvirtuo status

Separate services are installed for each instance of Tivoli Common Reporting youinstalled on each server. Use the trcmd -checkstatus command to check the statusof a specific Tivoli Common Reporting component.

Sample output:# service dboravirtuo statusDatabase listener is running.Database instance vtdb is running.# service sdsna statussds LDAP server is runningsds admin server is running# service sapmonvirtuo statussapmon process running# service sapmgrvirtuo statussapmgr process running# service sapvirtuo statusNAME STATE SINCEas STARTED 17:21:28asd STARTED 17:25:04

Chapter 12. Starting Tivoli Netcool Performance Manager 103

Page 112: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

nc_cache STARTED 17:25:51alarm_cache STARTED 17:26:34load_ericssonbss_r10 STARTED 17:26:39load_nokiabss_oss31ed3 STARTED 17:26:44load_motorolabss_gsr7 STARTED 17:26:49load_motorolautran_usr10 STARTED 17:26:54load_ericssonutran_r30 STARTED 17:26:59

Related information:

Tivoli Common Reporting commands

Completing startup of Tivoli Netcool Performance Manager - Wirelesscomponent

Details the final steps of completing the startup of Tivoli Netcool PerformanceManager - Wireless component.

About this task

Important: Distributed systems only. In a distributed system, perform a completestartup on the server that is hosting the application component.

Run the following commands to ensure that SAP process management is running,and then start the remaining Tivoli Netcool Performance Manager processes.

Procedure1. Run the following commands as user root:

v/etc/rc.d/init.d/sapmonvirtuo start/etc/rc.d/init.d/sapmgrvirtuo start

vsvcadm enable sapmon-nasvcadm enable sapmgr-na

vservice sapmonvirtuo startservice sapmgrvirtuo start

2. Run the following command as user virtuo:sap disp

3. Run the following command as user root:

v/etc/rc.d/init.d/sapvirtuo start

vsvcadm enable sap-na

vservice sapvirtuo start

What to do next

The location of the process log files is determined by the WMCLOGDIR setting in the$WMCROOT/conf/environment/default.properties file.

104 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 113: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Ensure that no exceptions occurred in these files. If the process started successfully,each process log file must return the line Process Startup done when it is startedsuccessfully.

Chapter 12. Starting Tivoli Netcool Performance Manager 105

Page 114: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

106 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 115: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Chapter 13. Enable Common Reporting on Tivoli NetcoolPerformance Manager

Extra software is required if you want to use the Tivoli Common Reporting serverthat is installed with Tivoli Netcool Performance Manager.

IBM Tivoli Common Reporting is an enterprise reporting solution that delivers acommon reporting platform across the Tivoli portfolio. To make full use ofCommon Reporting, you must install Tivoli Netcool Performance Manager -Application Studio in your system.

The Tivoli Netcool Performance Manager - Application Studio tooling greatlysimplifies the task of reporting on network performance by using Tivoli CommonReporting.

For more information about Tivoli Netcool Performance Manager - ApplicationStudio, see Installing and Using Tivoli Netcool Performance Manager - ApplicationStudio.Related information:

Installing and Using IBM Tivoli Netcool Performance Manager - ApplicationStudio

Tivoli Netcool Performance Manager - Application StudioA new tool for creating and publishing simplified and enhanced data models onDashboard Application Services Hub with IBM Cognos 10 support.

For information about this tool, see Installing and Using Tivoli Netcool PerformanceManager - Application Studio from the following link:http://www.ibm.com/support/knowledgecenter/SSBNJ7_1.4.3/npm_as/ctnpm_npm_as_intro_14.html.

© Copyright IBM Corp. 2006, 2017 107

Page 116: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

108 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 117: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Appendix A. Installation output

This appendix details example output associated with the installation of all thepackages on a distributed Tivoli Netcool Performance Manager server.

The output shown is for an interactive installation.ksh pmw_install -wmcr /appl/virtuoMaking PMW top-level directory: /appl/virtuoMaking software archive directories: under /appl/virtuo/admin/softwareLooking for bootstrap packageFound vallent-vt-common-TNPM1.4.3.0.tar.gzExtracting and running bootstrap packageLooking for bootstrap scriptRunning vallent-vt-common.installCopyright 2013 IBM Corporation, All Rights ReservedThis installation script will install the Tivoli Netcool Performance Manager commonsoftware version TNPM1.4.3.0 on your system.Do you wish to continue? yes

Do you agree with the terms of this license? yesRunning pre-install commands...Backing up old versions of non-shared files to be installed...Creating installation directories...Installing software...Checking configuration files...Updating file permissions...Setting up init scripts...Running post-install commands...... Checking Virtuo File Permissions... Setup Virtuo profileSetting up virtuo User Profile....done

Completed Virtuo Software InstallationLogs can be seen in pmw_install.logInstallation is complete.

What Type of System Are you Installing?

1. Standalone server2. Application Components only3. Loader Components only4. Directory Server Components only5. Database Components only6. Skip package deployment7. Exit PMW Install

---->1Checking packages: jre ant java-libs as-core core sap njloader ds-conf db-install db-conf tcrVerified the following packages:

* /appl/vallent-vt-jre-TNPM1.4.3.0.tar.gz* /appl/vallent-vt-ant-TNPM1.4.3.0.tar.gz* /appl/vallent-vt-java-libs-TNPM1.4.3.0.tar.gz* /appl/vallent-vt-as-core-TNPM1.4.3.0.tar.gz* /appl/vallent-vt-core-TNPM1.4.3.0.tar.gz* /appl/vallent-vt-sap-TNPM1.4.3.0.tar.gz* /appl/vallent-vt-njloader-TNPM1.4.3.0.tar.gz* /appl/vallent-vt-ds-conf-TNPM1.4.3.0.tar.gz* /appl/vallent-vt-db-install-TNPM1.4.3.0.tar.gz* /appl/vallent-vt-db-conf-TNPM1.4.3.0.tar.gz* /appl/vallent-vt-tcr-TNPM1.4.3.0.tar.gz

Do you want to deploy the packages? [yes/no] >yesInstalling

© Copyright IBM Corp. 2006, 2017 109

Page 118: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

jre (TNPM1.4.3.0) ... okant (TNPM1.4.3.0) ... okjava-libs (TNPM1.4.3.0) ... okas-core (TNPM1.4.3.0) ... okcore (TNPM1.4.3.0) ...

Please Verify Environment Settings

1. Accept Variable Values below2. Reset Variables to Default values3. Change WMCHOST=tnpminlnx0208.persistent.co.in4. Change VTDBHOST=tnpminlnx0208.persistent.co.in5. Change LDAPHOST=tnpminlnx0208.persistent.co.in6. Change SMTP_HOST=tnpminlnx0208.persistent.co.in7. Change SMTP_PORT=258. Change [email protected]. Change SERVER_IP_ADDRESS=127.0.0.110. Change SHORT_IP_ADDRESS=127.0.011. Change WMCROOT=/appl/virtuo12. Change WMCLOGDIR=/appl/virtuo/logs/13. Change WMCVARDIR=/appl/virtuo/var/14. Change LDAPPORT=138915. Change LDAPROOT=dc=persistent,dc=co,dc=in16. Change LDAP_PASSWORD=Virtuo0117. Change OPERATOR=Company118. Change ORACLEPORT=152119. Change VTDBSID=vtdb20. Change VTDB_USERNAME=virtuo21. Change VTDB_PASSWORD=Virtuo0122. Change SAPMONPORT=900923. Change OMPORT=900824. Change ASHTTPPORT=808025. Change ASREDIRPORT=844326. Change ASAJPPORT=808627. Change ASWEBSRVPORT=808328. Change ASBRIDGEPORT=1009129. Change ASNSPORT=109930. Change ASJRMPINVOKPORT=444431. Change ASPOOLINVOKPORT=444532. Change ASRMIPORT=109833. Change ASUIL2PORT=809334. Change ASHSQLPORT=170135. Change ORBPORT=352836. Change ORBSSLPORT=3529

---->1Configuring /appl/virtuo files .......doneok

sap (TNPM1.4.3.0) ... oknjloader (TNPM1.4.3.0) ...

Please Verify Environment Settings

1. Accept Variable Values below2. Reset Variables to Default values3. Change LDRHOST=tnpminlnx0208.persistent.co.in4. Change WMCHOST=tnpminlnx0208.persistent.co.in5. Change VTDBHOST=tnpminlnx0208.persistent.co.in6. Change ORACLEPORT=15217. Change VTDBSID=vtdb8. Change VTDB_USERNAME=virtuo9. Change VTDB_PASSWORD=Virtuo0110. Change WMCROOT=/appl/virtuo11. Change WMCLOGDIR=/appl/virtuo/logs/12. Change WMCVARDIR=/appl/virtuo/var/13. Change SAPMONPORT=900914. Change OMPORT=9008

110 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 119: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

15. Change ASNSPORT=1099---->1Configuring /appl/virtuo files .......doneok

ds-conf (TNPM1.4.3.0) ... okdb-install (TNPM1.4.3.0) ... okdb-conf (TNPM1.4.3.0) ...

Please Verify Environment Settings

1. Accept Variable Values below2. Reset Variables to Default values3. Change WMCHOST=tnpminlnx0208.persistent.co.in4. Change WMCLOGDIR=/appl/virtuo/logs/5. Change WMCVARDIR=/appl/virtuo/var/6. Change ASNSPORT=10997. Change MSTRCACHE_RMI=98768. Change ALRMCACHE_RMI=9877

---->1Configuring /appl/virtuo files .......doneok

tcr (TNPM1.4.3.0) ... okAll packages installed successfully

Details in pmw_install.log

Would you like to perform task JBOSS_INSTALL ? [yes/no] >yesPlease enter the location of the JBoss 4.0.3SP1 archive (or q to quit)!: [/appl]---->/applDeploying JBoss 4.0.3SP1...Buildfile: /appl/virtuo/admin/common/install/scripts/build.xml

init:[echo] JBOSS VERSION=4.0.3SP1[echo] JBoss Location=/appl

find-archive:

expand-tar-gz:[echo] Expanding gzipped tarfile

[untar] Expanding: /appl/jboss-4.0.3SP1.tar.gz into /appl/virtuo[untar] Expanding: /appl/jboss-4.0.3SP1.tar.gz into /appl/virtuo

expand-tar-bz2:

expand-zip:

all:[echo] Expansion complete[move] Moving 1272 files to /appl/virtuo/as[move] Moving 5 files to /appl/virtuo/as/server/default

init:[echo] JBOSS VERSION=4.0.3SP1[echo] JBoss Location=/appl

copy-libs:[copy] Copying 3 files to /appl/virtuo/as/server/default/lib[copy] Copying 10 files to /appl/virtuo/lib/tp

[delete] Deleting directory /appl/virtuo/jboss-4.0.3SP1

init:[echo] JBOSS VERSION=4.0.3SP1[echo] JBoss Location=/appl

Appendix A. Installation output 111

Page 120: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

fix-alarm-war:[mkdir] Created dir: /appl/virtuo/temp[mkdir] Created dir: /appl/virtuo/temp/war/apps/lib[unjar] Expanding: /appl/virtuo/as/server/default/deploy_core/S02-na-alarm-manager.ear into

/appl/virtuo/temp[unjar] Expanding: /appl/virtuo/temp/S02-na-alarm-manager.war into

/appl/virtuo/temp/war/apps/lib[unjar] Expanding: /appl/virtuo/lib/na-alarm-service-server.jar into

/appl/virtuo/temp[copy] Copying 1 file to /appl/virtuo/temp/war/apps/lib[copy] Copying 1 file to /appl/virtuo/as/client[jar] Updating jar: /appl/virtuo/temp/S02-na-alarm-manager.war[jar] Updating jar: /appl/virtuo/as/server/default/deploy_core/S02-na-alarm-manager.ear

BUILD SUCCESSFULTotal time: 11 secondsWould you like to perform task DS_SCHEMA_INSTALL ? [yes/no] >yesUsing local LDAP server, port 1389... OK.Please enter the password for ’Directory Manager’, the Directory Server User [Dirmgr01]:

Please enter the password for ’SysAdmin’, the Directory Server User [Sysadm01]:Directory Server "SysAdmin" user password set to "Sysadm01"

Installing Directory server schema...Performing sanity check on Directory Server schema......doneDS schema installed.Would you like to perform task DB_INSTALL ? [yes/no] >yes--------------------------------------------------------------------Please enter your Database SID (8 character maximum): [vtdb]---->Found default template: /appl/virtuo/admin/oracle/conf/vtdb.dbtPlease enter the full path of the PMW database template: [/appl/virtuo/admin/oracle/conf/vtdb.dbt]---->PMW database will be created using template /appl/virtuo/admin/oracle/conf/vtdb.dbtPlease enter your ADDM license type [NONE | DIAGNOSTIC | DIAGNOSTIC+TUNING ]: [NONE]---->ADDM license type is set to "NONE"You must create passwords for the sys and system database users.

Please enter a password for the sys user: [Sysdb01]---->Please enter a password for the system user: [Sysdb01]---->Creating and starting Oracle instance1% complete2% complete3% complete7% completeCreating database files8% complete9% complete10% complete11% complete12% complete13% complete14% complete15% completeCreating data dictionary views17% complete22% complete23% complete24% complete25% complete26% complete27% complete28% complete29% complete

112 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 121: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

30% complete31% complete36% complete38% complete40% completeAdding Oracle JVM52% complete63% complete75% complete79% completeCompleting Database Creation81% complete83% complete86% complete93% complete100% completeLook at the log file "/appl/oracle/cfgtoollogs/dbca/vtdb/vtdb.log" for further details.Completed vtdb database creationRunning Oracle Net ConfigurationGenerating dbora startup scripts ....Waiting for DB listener for vtdbListener is up. Continuing...Running post-install procedures for vtdb database.Making post-install changesWould you like to perform task DB_SCHEMA_INSTALL ? [yes/no] >yes--------------------------------------------------------------------Please enter the Virtuo Database SID: [vtdb]---->Database SID set to "vtdb"Please enter the Database sys user password: [Sysdb01]---->Database user sys password set to "Sysdb01"Please enter the Database virtuo user password: [Virtuo01]---->Database user virtuo password is set to "Virtuo01".... Starting Database Schema ’core’Creating database schema ’core’ in SID ’vtdb’. This may take several minutes.... Database Schema Creation finished successfully.... Log file is located in /appl/virtuo/admin/oracle/schema/core/install_schema.log.... Database Schema ’core’ Creation completedWould you like to perform task DB_SCHEMA_POST_INSTALL ? [yes/no] >yes--------------------------------------------------------------------Please enter the TNPMW Database SID: [vtdb]---->Database SID set to "vtdb"Please enter the SYSDBA Database user name: [sys]---->Database user name with SYSDBA priv is set to "sys"Please enter the SYSDBA Database user sys password: [Sysdb01]---->Database user sys password is set to "Sysdb01"Please enter the Database user name: [virtuo]---->Database schema name is set to "virtuo"Please enter the Database user virtuo password: [Virtuo01]---->Database user virtuo password is set to "Virtuo01".... Starting Loading JAR Files To ’virtuo’ SchemaLoading JAR files to database schema ’virtuo’ in ’vtdb’ database.../.... Loading JAR Files To ’virtuo’ Schema Is Completed.... Starting Importing Stored Outline To ’virtuo’ SchemaImporting outline to database schema ’virtuo’ in ’vtdb’ database....... Importing Stored Outline To ’virtuo’ Schema Is Completed.... Setting Compatible to 12.1.0.2.0 and restarting DatabaseSet COMPATIBLE parameter to 12.1.0.2.0 in ’vtdb’ database...Database is up and runningConfigure Dictionary Statistics Refresh in ’vtdb’ database...

Appendix A. Installation output 113

Page 122: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

setting JAVA_TOOL_OPTIONS environment variableCopying database JDBC library files...Copying database library files...Done..... Adding overflow tablepaces.... Adding overflow tablepaces Complete.... Creating Part Maint views ext.... Creating Part Maint views ext CompleteWould you like to perform task CORE_CRONJOB_INSTALL ? [yes/no] >yesConfiguring core cronjobs.......

What Type of PMW System Are you Installing ?-----------------------------------------------------------------------Please select the type of PMW System you are installing byentering the number associate with the system type :All Inclusive (1)Application (2)Loader (3)Directory Server (4)Database (5)Gateway (6)-----------------------------------------------------------------------[ 1 / 2 / 3 / 4 / 5 / 6 ] :1Server type selected: ALLPlease enter the ORACLE_HOME Directory [/appl/oracle/product/12.1.0.2.0/db_1]:(Enter . if unknown)

Please enter the ORACLE_BASE Directory [/appl/oracle]:(Enter . if unknown)

Please enter the ORACLE_SID Parameter [vtdb]:(Enter . if unknown)

Please enter the vtdb Database Archive Directory [/oradump/vtdb]:(Enter . if unknown)

Please enter the Directory Server log Directory [/appl/ldap/idsslapd-idsinst/logs]:(Enter . if unknown)

Please enter the PMW Log Directory [/appl/virtuo/logs]:(Enter . if unknown)

Please enter the PMW Archive Logs Directory [/data/trace_archive1]:(Enter . if unknown)

Setting up CRON environment ...

Filtering old cronjobs ....... Done

Setting up root cronjobs ...Finished setting up root cronjobsSetting up virtuo user cronjobs ...Finished setting up virtuo cronjobsRestarting Cron ...Stopping crond service.... cron daemon stoppedstarting crond service.... cron daemon started

Please view pmw_install.log for install details

Would you like to perform task GATEWAYS_INSTALL ? [yes/no] >noWould you like to perform task TECHPACKS_INSTALL ? [yes/no] >yesTechpack install order file found in /appl

114 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 123: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Checking packages: vallent-vt-Neutral_Core_GOMvallent-vt-Neutral_GSM_BSS_NSS_GOMvallent-vt-Neutral_GPRS_UMTS_CN_GOMvallent-vt-Neutral_GPRS_BSS_GOMvallent-vt-Neutral_UMTS_UTRAN_GOMvallent-vt-NOK_GOMlet vallent-vt-GSM_Nokia_BSS_RG20Verified the following packages:

* /appl/vallent-vt-Neutral_Core_GOM-1.0.tar.gz* /appl/vallent-vt-Neutral_GSM_BSS_NSS_GOM-1.0.tar.gz* /appl/vallent-vt-Neutral_GPRS_UMTS_CN_GOM-1.0.tar.gz* /appl/vallent-vt-Neutral_GPRS_BSS_GOM-1.0.tar.gz* /appl/vallent-vt-Neutral_UMTS_UTRAN_GOM-1.0.tar.gz* /appl/vallent-vt-NOK_GOMlet-2.1.tar.gz* /appl/vallent-vt-GSM_Nokia_BSS_RG20-4.0.0.tar.gz

Do you want to deploy the packages? [yes/no] >yesInstalling

Neutral_Core_GOM (1.0) ... okNeutral_GSM_BSS_NSS_GOM (1.0) ... okNeutral_GPRS_UMTS_CN_GOM (1.0) ... okNeutral_GPRS_BSS_GOM (1.0) ... okNeutral_UMTS_UTRAN_GOM (1.0) ... okNOK_GOMlet (2.1) ... okGSM_Nokia_BSS_RG20 (4.0.0) ... ok

All packages installed successfully

Details in pmw_install.log

Starting application server...

Licensed Materials - Property of IBM

5724W86

(C) Copyright IBM Corp. 2005, 2009 All Rights Reserved.

Waiting for appserver...Mon Mar 13 10:50:10 IST 2017: as is at state exec. Waiting for state STARTEDMon Mar 13 10:50:25 IST 2017: as is at state exec. Waiting for state STARTEDMon Mar 13 10:50:37 IST 2017: as is at state exec. Waiting for state STARTEDMon Mar 13 10:51:01 IST 2017 as now up, clock started 104955000, now 105101000Appserver ready.Would you like to perform task SYSINIT ? [yes/no] >yes

Licensed Materials - Property of IBM

5724W86

(C) Copyright IBM Corp. 2006, 2009 All Rights Reserved.

10:51:09,564 INFO [SystemInit] Login...10:51:25,217 INFO [SystemInit] Operation SucceededWould you like to perform task TECHPACK_ADMIN ? [yes/no] >yesBuildfile: /appl/virtuo/admin/techpacks/build.xml

copyright-info:[echo] Licensed Materials - Property of IBM[echo] 5724W86[echo] (C) Copyright IBM Corp. 2005, 2009 All Rights Reserved.

set-install-mode-from-env:

set-default-install-mode:

set-install-mode:

init:[wmcInit] 10:51:30,477 [main] DEBUG logging - Created Logging Directory :

Appendix A. Installation output 115

Page 124: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

/appl/virtuo/logs/vmm

apply:[applyTechPacks] About to install modules. View logs for installation results.[applyTechPacks][applyTechPacks] WARNING: Tablespace properties file/appl/virtuo/conf/vmm/tablespace_Neutral_Core_GOM_1.0.properties does not exist![applyTechPacks] Do you want to continue with techpack default tablespace settings? [y|n]y[applyTechPacks] Using default tablespace settings for techpack Neutral Core GOM[applyTechPacks][applyTechPacks] No report templates to apply.[applyTechPacks] elapsedTime for Install = 17497[applyTechPacks] Module Neutral_Core_GOM 1.0 processed in under 18 seconds.[applyTechPacks][applyTechPacks] WARNING: Tablespace properties file/appl/virtuo/conf/vmm/tablespace_Neutral_GSM_BSS_NSS_GOM_1.0.properties does not exist![applyTechPacks] Do you want to continue with techpack default tablespace settings? [y|n]y[applyTechPacks] Using default tablespace settings for techpack Neutral GSM BSS/NSS GOM[applyTechPacks][applyTechPacks] No report templates to apply.[applyTechPacks] elapsedTime for Install = 40339[applyTechPacks] Module Neutral_GSM_BSS_NSS_GOM 1.0 processed in under 41 seconds.[applyTechPacks][applyTechPacks] WARNING: Tablespace properties file/appl/virtuo/conf/vmm/tablespace_Neutral_GPRS_UMTS_CN_GOM_1.0.properties does not exist![applyTechPacks] Do you want to continue with techpack default tablespace settings? [y|n]y[applyTechPacks] Using default tablespace settings for techpack Neutral GPRS/UMTS CN GOM[applyTechPacks][applyTechPacks] No report templates to apply.[applyTechPacks] elapsedTime for Install = 17329[applyTechPacks] Module Neutral_GPRS_UMTS_CN_GOM 1.0 processed in under 18 seconds.[applyTechPacks][applyTechPacks] WARNING: Tablespace properties file/appl/virtuo/conf/vmm/tablespace_Neutral_GPRS_BSS_GOM_1.0.properties does not exist![applyTechPacks] Do you want to continue with techpack default tablespace settings? [y|n]y[applyTechPacks] Using default tablespace settings for techpack Neutral GPRS BSS GOM[applyTechPacks][applyTechPacks][applyTechPacks][applyTechPacks][applyTechPacks] No report templates to apply.[applyTechPacks] elapsedTime for Install = 12988[applyTechPacks] Module Neutral_GPRS_BSS_GOM 1.0 processed in under 13 seconds.[applyTechPacks][applyTechPacks] WARNING: Tablespace properties file/appl/virtuo/conf/vmm/tablespace_Neutral_UMTS_UTRAN_GOM_1.0.properties does not exist![applyTechPacks] Do you want to continue with techpack default tablespace settings? [y|n]y[applyTechPacks] Using default tablespace settings for techpack Neutral UMTS UTRAN GOM[applyTechPacks][applyTechPacks][applyTechPacks][applyTechPacks][applyTechPacks] No report templates to apply.[applyTechPacks] elapsedTime for Install = 24974[applyTechPacks] Module Neutral_UMTS_UTRAN_GOM 1.0 processed in under 25 seconds.[applyTechPacks][applyTechPacks] WARNING: Tablespace properties file/appl/virtuo/conf/vmm/tablespace_NOK_GOMlet_2.1.properties does not exist![applyTechPacks] Do you want to continue with techpack default tablespace settings? [y|n]y[applyTechPacks] Using default tablespace settings for techpack NOK GOMlet[applyTechPacks]

116 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 125: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

[applyTechPacks][applyTechPacks][applyTechPacks][applyTechPacks][applyTechPacks] No report templates to apply.[applyTechPacks] elapsedTime for Install = 8972[applyTechPacks] Module NOK_GOMlet 2.1 processed in under 9 seconds.[applyTechPacks][applyTechPacks] WARNING: Tablespace properties file/appl/virtuo/conf/vmm/tablespace_GSM_Nokia_BSS_RG20_4.0.0.properties does not exist![applyTechPacks] Do you want to continue with techpack default tablespace settings? [y|n]y[applyTechPacks] Using default tablespace settings for techpack Nokia GSM BSS[applyTechPacks][applyTechPacks][applyTechPacks][applyTechPacks][applyTechPacks][applyTechPacks] Configuring LocalizedMessageFactory with country ’United States’and language ’English’with bundle ’localization.LocalizedMessages’[applyTechPacks] elapsedTime for Install = 430312[applyTechPacks] Module GSM_Nokia_BSS_RG20 4.0.0 processed in under 8 minutes.

[delete] Deleting: /appl/virtuo/admin/techpacks/new_techpacks

BUILD SUCCESSFULTotal time: 9 minutes 37 seconds[applyTechPacks] All modules installed successfully.

Licensed Materials - Property of IBM

5724W86

(C) Copyright IBM Corp. 2005, 2009 All Rights Reserved.

INFO: Shutting down the framework manager (does not stop framework processes).

Licensed Materials - Property of IBM

5724W86

(C) Copyright IBM Corp. 2005, 2009 All Rights Reserved.

Would you like to perform task ENCODE_PASSWDS ? [yes/no] >yes

Replacing all passwords with encoded passwords...

Encoding values in /appl/virtuo/conf/alarm_external_api/alarmapi.properties.NEncoding values in /appl/virtuo/conf/alarm_external_api/alarmapi.propertiesEncoding values in /appl/virtuo/conf/as/as-default.properties.NEncoding values in /appl/virtuo/conf/as/as-default.propertiesEncoding values in /appl/virtuo/conf/dbconnection/vtdb.propertiesEncoding values in /appl/virtuo/conf/dbconnection/vtdb.properties.NEncoding values in /appl/virtuo/conf/externalreporting/default.properties.NEncoding values in /appl/virtuo/conf/externalreporting/default.propertiesEncoding values in /appl/virtuo/conf/dbspace_admin/dbspace_admin.xmlEncoding values in /appl/virtuo/conf/dbspace_admin.xmlEncoding values in /appl/virtuo/conf/ldap/default.properties.NEncoding values in /appl/virtuo/conf/ldap/default.properties

Passwords may also be stored in /appl/virtuo/admin/logs/pmw_install.log,so it should be removed when not needed anymore.Enabling sap...Done.

Appendix A. Installation output 117

Page 126: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

118 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 127: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Appendix B. Log file errors

This appendix shows the Oracle installation errors that can be safely ignored.

Oracle installation1. Checking for noexec_user_stack=1; found no entry. Failed

The Oracle Installation log output is found in:/var/install/logs/oracle12C_install_6451.log

Following the installation of Oracle, the following error may be seen in theOracle Installation log.Checking for noexec_user_stack=1; found no entry. Failed

This error can be safely ignored.2. Performing check for SwapSpace

The Oracle Inventory log output is found in:/appl/oracle/product/oraInventory/logs/oraInstall<timestamp>.out

Following the installation of Oracle, the following error may be seen in theInventory log.Performing check for SwapSpaceChecking available swap space requirements ...Expected result: <size>MBActual Result: <size>MBCheck complete. The overall result of this check is: Failed <<<<

This error can be safely ignored.

© Copyright IBM Corp. 2006, 2017 119

Page 128: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

120 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 129: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Appendix C. Dependency Checker errors

Dependency Checker errors.

ErrorsGYMWI0001E Directories missing from root user PATHThe following directories are missing from the root user PATH: <missing_dirs>You must ensure that the root user profile is sourced beforerunning the installation.Hint: If you use ’su’ to change to the root user, use the ’-’argument to source the profile, i.e. ’su -’-------------------------------------------------------------GYMWI0002E No domain name configuredYou must set up a domain name on the server and ensure the fully qualified hostname is valid-------------------------------------------------------------GYMWI0003E Hostname <FQDN> resolves to loopbackIP address x.x.x.x - must be a real IP addressThe server hostname must resolve to a non-loopback IP address.Otherwise the alarms UI will not function correctly.-------------------------------------------------------------GYMWI0004E Hosts entry for <FQDN> not found-------------------------------------------------------------GYMWI0054E Invalid umask for root user:022 The umask for the root user must be set to 0022-------------------------------------------------------------GYMWI0005E OS <OS> is not supported. Must be one of: Linux SunOS AIXOnly Linux, AIX and SunOS (Solaris) are supported-------------------------------------------------------------GYMWI0006E SunOS version <OS_VER> is not supported. Must be 5.11Solaris 11 is the only supported version-------------------------------------------------------------GYMWI0007E Processor type <PROC_TYPE> is not supported for <OS>Solaris is only supported on SPARC processors-------------------------------------------------------------GYMWI0008E Platform must support 64-bit kernel-------------------------------------------------------------GYMWI0009E Unable to determine update level for SunOS-------------------------------------------------------------GYMWI0011E Update level for SunOS is &ltSOLARIS_UPDATE>:required level is &ltREQUIRED_UPDATE>You must install the latest recommended update-------------------------------------------------------------GYMWI0012E Processor type <PROC_TYPE> is not supported for LinuxLinux is only supported on x86_64 architecture-------------------------------------------------------------GYMWI0013E Linux distribution must be Red Hat-------------------------------------------------------------GYMWI0014E Linux distribution must be Red Hat Enterprise Linux Server-------------------------------------------------------------GYMWI0015E Red Hat Release <RHEL_VERSION> is not supported:must be 5.9 or later-------------------------------------------------------------GYMWI0016E &ltdir&gt;is not a directory-------------------------------------------------------------GYMWI0017E Insufficient space on <fs> partition.Space required on this partition:KB Space available: KBThe following required directories are mounted on this partition:-------------------------------------------------------------GYMWI0018E One or more required <OS> packages not installedMissing packages:-------------------------------------------------------------GYMWI0019E ERROR: invalid argument to linux_pkg_checks():-------------------------------------------------------------GYMWI0049E ERROR: invalid format for package info: <pkg>

© Copyright IBM Corp. 2006, 2017 121

Page 130: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

-------------------------------------------------------------GYMWI0050E ERROR: incomplete package information: <pkg>-------------------------------------------------------------GYMWI0051E ERROR: invalid package version for <pkg>: <ver>-------------------------------------------------------------GYMWI0052E ERROR: invalid package release for <pkg>: <rel>-------------------------------------------------------------GYMWI0020E <tpp_type> <OS> packages are missing-------------------------------------------------------------GYMWI0021E <tpp_type> <OS> packages require upgrade-------------------------------------------------------------GYMWI0022E User oracle shell <ORACLE_USER_SHELL> is not supported:must be /bin/ksh-------------------------------------------------------------GYMWI0055E Invalid oracle user umask: <ORACLE_USER_UMASK>The oracle user umask must be set to 022-------------------------------------------------------------GYMWI0023E ORACLE_BASE environment variable not set-------------------------------------------------------------GYMWI0024E ORACLE_BASE directory /appl/oracle does not exist-------------------------------------------------------------GYMWI0025E ORACLE_OWNER: <ORACLE_OWNER> is expected to be oracle-------------------------------------------------------------GYMWI0026E ORACLE_HOME environment variable not set-------------------------------------------------------------GYMWI0027E ORACLE_HOME directory <ORACLE_HOME> does not exist-------------------------------------------------------------GYMWI0028E PATH for oracle does not contain <ORACLE_HOME>/bin-------------------------------------------------------------GYMWI0029E LD_LIBRARY_PATH for oracle does not contain <ORACLE_HOME>/lib-------------------------------------------------------------GYMWI0030E NLS_LANG environment variable for oracle user must be set to<VALID_NLS_LANG>-------------------------------------------------------------GYMWI0031E Installed Oracle version is invalidInstalled Oracle version is <installed_ver>- required version is<required_ver>-------------------------------------------------------------GYMWI0032E Oracle oneoff patches not installedThe following oneoff Oracle patches are missing:-------------------------------------------------------------GYMWI0033E Oracle Partitioning is not installed-------------------------------------------------------------GYMWI0034E <dir> does not exist-------------------------------------------------------------GYMWI0035E <dir> must be owned by oracle-------------------------------------------------------------GYMWI0036E <dir> must be executable by owner oracle-------------------------------------------------------------GYMWI0037E <dir> must be executable for non-oracle users-------------------------------------------------------------GYMWI0038E <binary> does not exist-------------------------------------------------------------GYMWI0039E <binary> must be owned by oracle-------------------------------------------------------------GYMWI0040E <binary> must be executable by owner oracle-------------------------------------------------------------GYMWI0041E <binary> must be executable for non-oracle users-------------------------------------------------------------GYMWI0042E <ORACLE_HOME>/network/admin/<ora_file> must be owned by oracle-------------------------------------------------------------GYMWI0043E <ora_file> must be writable by owner oracle-------------------------------------------------------------GYMWI0044E <ora_file> must be readable for non-oracle users-------------------------------------------------------------GYMWI0045E <ORACLE_HOME>/network/admin/<ora_file> must be an empty fileDB creation may fail if this file has invalid contents.-------------------------------------------------------------GYMWI0046E <pkg_count> versions of <core_pkg> foundThere can only be 1 version of each package in <pkg_dir>-------------------------------------------------------------

122 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 131: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

GYMWI0047E TNPM core packages not foundThe following core packages could not be found: <missing_pkgs>-------------------------------------------------------------GYMWI0053E JBoss archive not foundThe JBoss 4.0.3 SP1 package should be located in <BASE_DIR>-------------------------------------------------------------GYMWI0046E <pkg_count> versions foundThere can only be 1 version of each package in <pkg_dir>-------------------------------------------------------------GYMWI0048E SDS/DB2 packages not foundThe following SDS/DB2 packages could not be found:-------------------------------------------------------------GYMWI0056E AIX version <version> is not supported.Must be 5.3 or greater-------------------------------------------------------------GYMWI0057E Processor type <PROC_TYPE> is not supported for AIXAIX is only supported on powerpc processors-------------------------------------------------------------GYMWI0059E Platform must support 64-bit hardware-------------------------------------------------------------GYMWI0060E Maintenance level for AIX is <OS_LEVEL>:Minimum required level is 5300-09-------------------------------------------------------------GYMWI0061E <req_fs>is required for SDS. Please install it.-------------------------------------------------------------GYMWI0063E <req_fs>is required for Oracle. Please install it.-------------------------------------------------------------GYMWI0064E Physical RAM is <P_RAM>KB which is under the minimum requirement of262144 KB (256 MB)-------------------------------------------------------------GYMWI0065E Swap space does not meet requirements.Should be twice the size of RAM or 1 GB (2097152 KB), whichever is smaller-------------------------------------------------------------GYMWI0066E Free disk space in /tmp directory is <tmpSpace>which is less than the minimum requirement of 400 MB.-------------------------------------------------------------GYMWI0067E oracle is not in <DBA_GROUP>group-------------------------------------------------------------GYMWI0068E SDS/DB2 fixpack not installedThe following db2fixpack is not installed: <SDS_FP_PREFIX>_fixpack.tar.gz }-------------------------------------------------------------GYMWI0069E Missing Jazz SM & TCR InstallationYou must install Jazz SM along with TCR before installing TNPM Wireless Component.-------------------------------------------------------------GYMWI0070E Required file missing. The following files are missing from the root user: <missing_dirs>You must ensure that the required file exist at the specified path.If the file exists in another path, you may add a softlink-------------------------------------------------------------

Warnings-------------------------------------------------------------WARNING: 1GYMWI0001W Default Jazz SM Port <port> is already in useYou must check the port configuration if you are installing Jazz SM on this Server.-------------------------------------------------------------

Additional note when you run the dependency_checker with -t app option forApplication Server:------------------------------------------------------------------------------------Note: Please make sure to install Jazz SM & TCR before installing Application server"when you plan to install Jazz SM, TCR and SDS on the same server.------------------------------------------------------------------------------------

Appendix C. Dependency Checker errors 123

Page 132: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

124 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 133: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Notices

This information was developed for products and services offered in the US. Thismaterial might be available from IBM in other languages. However, you may berequired to own a copy of the product or product version in that language in orderto access it.

IBM may not offer the products, services, or features discussed in this document inother countries. Consult your local IBM representative for information on theproducts and services currently available in your area. Any reference to an IBMproduct, program, or service is not intended to state or imply that only that IBMproduct, program, or service may be used. Any functionally equivalent product,program, or service that does not infringe any IBM intellectual property right maybe used instead. However, it is the user's responsibility to evaluate and verify theoperation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matterdescribed in this document. The furnishing of this document does not grant youany license to these patents. You can send license inquiries, in writing, to:

IBM Director of LicensingIBM CorporationNorth Castle Drive, MD-NC119Armonk, NY 10504-1785US

For license inquiries regarding double-byte character set (DBCS) information,contact the IBM Intellectual Property Department in your country or sendinquiries, in writing, to:

Intellectual Property LicensingLegal and Intellectual Property LawIBM Japan Ltd.19-21, Nihonbashi-Hakozakicho, Chuo-kuTokyo 103-8510, Japan

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THISPUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHEREXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESSFOR A PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer ofexpress or implied warranties in certain transactions, therefore, this statement maynot apply to you.

This information could include technical inaccuracies or typographical errors.Changes are periodically made to the information herein; these changes will beincorporated in new editions of the publication. IBM may make improvementsand/or changes in the product(s) and/or the program(s) described in thispublication at any time without notice.

Any references in this information to non-IBM websites are provided forconvenience only and do not in any manner serve as an endorsement of those

© Copyright IBM Corp. 2006, 2017 125

Page 134: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

websites. The materials at those websites are not part of the materials for this IBMproduct and use of those websites is at your own risk.

IBM may use or distribute any of the information you provide in any way itbelieves appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purposeof enabling: (i) the exchange of information between independently createdprograms and other programs (including this one) and (ii) the mutual use of theinformation which has been exchanged, should contact:

IBM Director of LicensingIBM CorporationNorth Castle Drive, MD-NC119Armonk, NY 10504-1785US

Such information may be available, subject to appropriate terms and conditions,including in some cases, payment of a fee.

The licensed program described in this document and all licensed materialavailable for it are provided by IBM under terms of the IBM Customer Agreement,IBM International Program License Agreement or any equivalent agreementbetween us.

The performance data discussed herein is presented as derived under specificoperating conditions. Actual results may vary.

The client examples cited are presented for illustrative purposes only. Actualperformance results may vary depending on specific configurations and operatingconditions.

Information concerning non-IBM products was obtained from the suppliers ofthose products, their published announcements or other publicly available sources.IBM has not tested those products and cannot confirm the accuracy ofperformance, compatibility or any other claims related to non-IBM products.Questions on the capabilities of non-IBM products should be addressed to thesuppliers of those products.

Statements regarding IBM's future direction or intent are subject to change orwithdrawal without notice, and represent goals and objectives only.

All IBM prices shown are IBM's suggested retail prices, are current and are subjectto change without notice. Dealer prices may vary.

This information is for planning purposes only. The information herein is subject tochange before the products described become available.

This information contains examples of data and reports used in daily businessoperations. To illustrate them as completely as possible, the examples include thenames of individuals, companies, brands, and products. All of these names arefictitious and any similarity to actual people or business enterprises is entirelycoincidental.

COPYRIGHT LICENSE:

126 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 135: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

This information contains sample application programs in source language, whichillustrate programming techniques on various operating platforms. You may copy,modify, and distribute these sample programs in any form without payment toIBM, for the purposes of developing, using, marketing or distributing applicationprograms conforming to the application programming interface for the operatingplatform for which the sample programs are written. These examples have notbeen thoroughly tested under all conditions. IBM, therefore, cannot guarantee orimply reliability, serviceability, or function of these programs. The sampleprograms are provided "AS IS", without warranty of any kind. IBM shall not beliable for any damages arising out of your use of the sample programs.

Each copy or any portion of these sample programs or any derivative work mustinclude a copyright notice as follows:

© (your company name) (year).Portions of this code are derived from IBM Corp. Sample Programs.© Copyright IBM Corp. _enter the year or years_.

TrademarksIBM, the IBM logo, and ibm.com are trademarks or registered trademarks ofInternational Business Machines Corp., registered in many jurisdictions worldwide.Other product and service names might be trademarks of IBM or other companies.A current list of IBM trademarks is available on the web at "Copyright andtrademark information" at www.ibm.com/legal/copytrade.shtml.

Adobe, Acrobat, PostScript and all Adobe-based trademarks are either registeredtrademarks or trademarks of Adobe Systems Incorporated in the United States,other countries, or both.

IT Infrastructure Library is a registered trademark of the Central Computer andTelecommunications Agency which is now part of the Office of GovernmentCommerce.

Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo,Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks orregistered trademarks of Intel Corporation or its subsidiaries in the United Statesand other countries.

Linux is a registered trademark of Linus Torvalds in the United States, othercountries, or both

Microsoft and Windows are trademarks of Microsoft Corporation in the UnitedStates, other countries, or both.

ITIL is a registered trademark, and a registered community trademark of TheMinister for the Cabinet Office, and is registered in the U.S. Patent and TrademarkOffice.

UNIX is a registered trademark of The Open Group in the United States and othercountries.

Notices 127

Page 136: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Java and all Java-based trademarks and logosare trademarks or registered trademarks ofOracle and/or its affiliates.

Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in theUnited States, other countries, or both and is used under license therefrom.

Linear Tape-Open, LTO, the LTO Logo, Ultrium, and the Ultrium logo aretrademarks of HP, IBM Corp. and Quantum in the U.S. and other countries.

Terms and conditions for product documentationPermissions for the use of these publications are granted subject to the followingterms and conditions.

Applicability

These terms and conditions are in addition to any terms of use for the IBMwebsite.

Personal use

You may reproduce these publications for your personal, noncommercial useprovided that all proprietary notices are preserved. You may not distribute, displayor make derivative work of these publications, or any portion thereof, without theexpress consent of IBM.

Commercial use

You may reproduce, distribute and display these publications solely within yourenterprise provided that all proprietary notices are preserved. You may not makederivative works of these publications, or reproduce, distribute or display thesepublications or any portion thereof outside your enterprise, without the expressconsent of IBM.

Rights

Except as expressly granted in this permission, no other permissions, licenses orrights are granted, either express or implied, to the publications or anyinformation, data, software or other intellectual property contained therein.

IBM reserves the right to withdraw the permissions granted herein whenever, in itsdiscretion, the use of the publications is detrimental to its interest or, asdetermined by IBM, the above instructions are not being properly followed.

You may not download, export or re-export this information except in fullcompliance with all applicable laws and regulations, including all United Statesexport laws and regulations.

128 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 137: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

IBM MAKES NO GUARANTEE ABOUT THE CONTENT OF THESEPUBLICATIONS. THE PUBLICATIONS ARE PROVIDED "AS-IS" AND WITHOUTWARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDINGBUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY,NON-INFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE.

Notices 129

Page 138: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

130 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 139: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Index

Special characters-Xms<n>

property 95-Xmx<n>

property 96-XX:+AggressiveHeap

property 96

AAIX 102AIX packages

Oracle 12c installation 10AIX software location 10Application server installation 70Application server memory

configuration 95Audience v

BBuilding

Perl on Gateway servers 21Bundled software 6Busy Hours definitions 93

CCheck

Oracle configuration 44Checking

time zone 98Checking database space 82Client

hardware and softwarerequirements 11

Client hardware requirements 11Client software requirements 11Complete startup 104Components 3Configuration

ports and firewalls 15, 17SAP params property 97

Configurekernel 19Oracle environment variables 37

Configuringapplication server memory 95database 62loader server memory 96loaders 77multiple identical loaders 88

conventionstypeface vii

Copy packages 45Create

user and group accounts 18Creating

loader 91

Cronjobs installationapplication server 72distributed system 65loaders 78separate directory server 69standalone system 56

DData Availability definitions 94Database configuration 62Database installation

distributed system 63standalone system 54

Database schemapost-installation 56

Database schema installationdistributed system 63standalone system 55

Database server installation 61DB2 Installation 45Definitions

Busy Hours 93Data Availability 94Summary 94

Dependency Checker 31Dependency Checker errors 121Directory ownership configuration 19Directory server schema installation 54,

68application server 72

Distributed installation 61Distributed system installation 61Domain name set up 20Download

Java Runtime Environment 11

Eeducation

See Tivoli technical trainingEnabling

Tivoli Common Reporting 107Encrypting

distributed system passwords,separate directory server 70

passwords 60, 65, 76passwords, loaders 78

FFile systems 13

GGateways installation

distributed system 73separately 79stand-alone system 57

Hhostname set up 21

IIBM Security Directory Server client

installation 48IBM Tivoli Monitoring integration 99installation

Security Directory Server and IBMDB2 9

InstallationApplication Server in Distributed

Systems 41copy packages 45database server 43distributed 16IBM DB2 45IBM Security Directory Server

client 48interactive distributed system 61interactive standalone system 52JBoss 10Oracle 12.1.0.2.0 client 43Oracle 12c 8, 10Oracle 12c client 41Oracle client 37Oracle RDBMS 37, 39Oracle stand-alone or database

server 39output 109planning 3preparation 5prerequisites 13process 1roadmap 2Security Directory Server 45Software installation 49standalone system 51TCR 9Technology Packs 81Tivoli Netcool Performance Manager

software 49unattended 51

Installation prerequisitesSoftware installation prerequisites 49Tivoli Netcool Performance Manager

software 49Installation script 46installing vInstalling

application server 70cronjobs, application server 72cronjobs, distributed system 65cronjobs, loaders 78cronjobs, separate directory server 69cronjobs, standalone system 56database server 61directory server schema 54, 68

© Copyright IBM Corp. 2006, 2017 131

Page 140: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Installing (continued)directory server schema, application

server 72distributed system 61gateways, distributed system 73gateways, separately 79gateways, stand-alone system 57JBoss application server 53, 67, 71loader server 76separate directory server 67stand-alone system 52Technology Pack Step 1 83Technology Pack Step 2 84technology packs 57, 74

Installing distributed systemdatabase 63database schema 63

Installing standalone systemdatabase 54database schema 55

IntegratingIBM Tivoli Monitoring 99

Interactive installation 52

JJava memory configuration 22Java Runtime Environment

download 11JBoss Application Server

location 10JBoss application server installation 53,

67, 71JVM memory

loader servers 98jvm.args

property 95

KKernel configuration 19

Llistener 44Loader

creation 91Loader configuration removal 90Loader server

JVM memory 98Loader server installation 76Loader server memory configuration 96Loaders configuration 77Loading data

distributed systems 89loaders 89verifying 89

Loadmaps removal 90Locating

Oracle RDBMS and Clientsoftware 10

Locating softwareAIX 10

LocationJBoss Application Server 10Oracle 12c 39

Location (continued)Oracle software 39Oracle Solaris 7Perl 11Red Hat Enterprise Linux 8software 6

Log file errors 119

OOracle 12.1.0.2.0 client installation 43Oracle 12c client installation 41Oracle client

installation 37Oracle configuration validation 44Oracle environment variables

configuration 37Oracle RDBMS

installation 37Oracle RDBMS and Client software

location 10Oracle RDBMS installation 39Oracle software location 39Oracle Solaris location 7

Ppackages

DB2 9Security Directory Server 9

Packages for installation 45Passwords encryption 60, 65, 76

distributed system, separate directoryserver 70

loaders 78Performing post-installation checks

Technology Packs 84Perl location 11Perl on Gateway servers set up 21Planning installation 3Ports and firewalls configuration 15, 17Post-installation

database schema 56, 64distributed system 64

Post-installation tasks 93Preinstallation

road map 1Preinstallation tasks 13Preparing installation 5Prerequisite

server software 6Prerequisites 13Process checks 102

Linux 103Property

-Xms<n> 95-Xmx<n> 96-XX:+AggressiveHeap 96jvm.args 95recommended jvm.args 96

ProvisioningBusy Hours 93Data Availability 93Summaries 93

Publications vi

RReboot

server 101Recommended jvm.args

property 96Red Hat Enterprise Linux location 8Remove

Loader configuration 90Loadmaps 90

Required file systems 13Required server information 13Required skills and knowledge viRequirements

client hardware 11Client hardware and software 11client software 11server hardware 5server hardware and software 5server software 5

RHELdistributed installation 16

RHEL packagesDB2 9JBoss installation 10Oracle 12c installation 8, 10Security Directory Server 9TCR 9Tivoli Common Reporting 9

Road mappreinstallation 1

Roadmapinstallation 2

Runinstallation script 46

RunningDependency Checker 31

SSAP configuration

params property 97Security Directory Server client 48Security Directory Server Installation 45Separate directory server installation 67Server hardware and software

requirements 5Server hardware requirements 5Server rebooting 101Server software

prerequisite 6Server software requirements 5service viiservice management connect viiSet

directory ownership 19Set up

domain name 20host name 21

SettingJava memory 22time zone 98

Setting updata sources 82users 82

Skills and knowledge viSMC vii

132 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 141: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

Softwarebundled 6

Software location 6Stand-alone system installation 52Starting

SAP application server 81SAP process monitor tool 86SAP system 81Tivoli Netcool Performance

Manager 101Starting Application Server 87Starting Loaders Server 87Starting TNPM 101startup 104Summary definitions 94support viiSupported configurations

distributed system 4stand-alone system 4

TTechnology packs installation 57, 74Technology Packs installation 81Time zone checking 98Time zone settings 98Tivoli Common Reporting

enabling 107Tivoli Netcool Performance Manager

components 3Tivoli technical training viitraining, Tivoli technical viitypeface conventions vii

UUnattended installation on standalone

system 51User and group accounts creation 18

VVerifying data loading 89

Index 133

Page 142: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

134 IBM Tivoli Netcool Performance Manager: Installation Guide

Page 143: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server
Page 144: with IBM Corp. · Installing Oracle 12c ..... . 39 Installing Oracle RDBMS (stand-alone system or database server) ..... . 39 Installing Oracle database 12c Client (Application Server

IBM®

Printed in USA