IBM Tivoli Netcool Performance Manager 1.4.4Wireline ComponentDocument Revision R2E1

Moving Elements Between SNMPCollectors and Data Channels

IBM

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

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

Contents

Chapter 1. Overview . . . . . . . . . 1

Chapter 2. Moving elements betweenSNMP collectors . . . . . . . . . . . 3Considerations. . . . . . . . . . . . . . 3Procedure . . . . . . . . . . . . . . . 4

Chapter 3. Moving elements betweenDataChannels . . . . . . . . . . . . 5Considerations. . . . . . . . . . . . . . 5

Procedure . . . . . . . . . . . . . . . 5

Chapter 4. Moving elements betweenprofiles . . . . . . . . . . . . . . . 7

Notices . . . . . . . . . . . . . . . 9Trademarks . . . . . . . . . . . . . . 11Terms and conditions for product documentation. . 12

© Copyright IBM Corp. 2006, 2018 iii

iv IBM Tivoli Netcool Performance Manager: Moving Elements Between SNMP Collectors and Data Channels

Chapter 1. Overview

IBM® Tivoli® Netcool® Performance Manager supports moving elements betweenSNMP collectors that share the same DataChannel and also supports movingelements between separate DataChannels in your environment.

These sections discuss each process, and describe any special issues that must beconsidered.

© Copyright IBM Corp. 2006, 2018 1

2 IBM Tivoli Netcool Performance Manager: Moving Elements Between SNMP Collectors and Data Channels

Chapter 2. Moving elements between SNMP collectors

You can move elements between SNMP collectors that exist on the sameDataChannel.

This functionality allows you to make administrative changes, or redistributeresources to balance processing loads in your environment.

ConsiderationsAlthough moving elements between SNMP collectors is supported by TivoliNetcool Performance Manager, for the duration of the process there may be someissues with data synchronization, potential data loss, and some statisticalinaccuracy.

As information on an element’s state is stored in the subchannel that serves aspecific SNMP collector, moving an element from one SNMP collector to anothercan result in lost information and incorrect results for a brief period of time.

To minimize these effects, CMEs support transferring an element’s stateinformation at the boundary of its hourly processing cycle. The example belowdescribes how this process takes place.

Recall that an SNMP collector is associated with a subchannel, and that asubchannel is typically associated with its own CME. So, for the purposes ofmoving an element from one SNMP collector to another, we have a source SNMPcollector, subchannel, and CME, and a target SNMP collector, subchannel, andCME.

After the element has been moved from the source SNMP collector to the targetSNMP collector, the element’s state information will be transferred from the sourceCME to the target CME at the boundary of the source CME’s hourly processingcycle.

When the source CME begins processing the hour that follows the element move(that is, Hour T+1), it discovers that it no longer owns the element and musttransfer the element’s state information. The source CME saves the element’s stateinformation to a recovery directory that is common to the DataChannel, thendeletes the state information from the image. The state information containsresource aggregation buckets and data for the hour in which the element wasmoved (that is, Hour T). The source CME no longer outputs resource aggregationbuckets for the element’s resources, and the source CME is now free to processHour T+1.

When the target CME begins processing Hour T+1, it discovers that it now ownsthe element and must obtain the element’s state information for Hour T. The targetCME obtains the element’s state information by polling the recovery directory untilthe information appears. The target CME is aware that the element was processedby another subchannel prior to the hour that the element was moved.

If the target CME is ahead of the source CME, it has to wait until the source CMEhas processed Hour T, Hour T+1, and has written the element’s state information

© Copyright IBM Corp. 2006, 2018 3

to the recovery directory. If the SNMP collector for the element is late, both thesource CME and the target CME will have to wait, but the target CME will still beable to process its current hour.

If the target CME must wait for the element’s state information, it can query theDataChannel Channel Manager for the source subchannel’s state information forHour T. If the source subchannel has moved beyond Hour T+1, the target CME canstill proceed as it has data from Hour T, it now owns the element, and it knowsthe source subchannel that previously owned the element.

ProcedureFor more information, see Chapter 4, “Moving elements between profiles,” on page7.

4 IBM Tivoli Netcool Performance Manager: Moving Elements Between SNMP Collectors and Data Channels

Chapter 3. Moving elements between DataChannels

You can move elements from one DataChannel to another.

About this task

This functionality allows you to make administrative changes, or redistributeresources to balance processing loads in your environment.

ConsiderationsAlthough moving elements between DataChannels is supported by Tivoli NetcoolPerformance Manager, for the duration of the process there may be some issueswith data synchronization, potential data loss, and some statistical inaccuracy.

DataChannels near the end of an SLA period (for example, at end of the month) inorder to reduce the inaccuracy of threshold calculations. Basic statistics such asmin, max, sum, and count calculations remain accurate as these statistics areaggregated by DataView across the database channels. However, moving anelement between DataChannels will produce inaccurate threshold calculations for abrief period of time as all threshold processing must remain in a single CME forthe duration of the threshold period.

ProcedureFor more information, see Chapter 4, “Moving elements between profiles,” on page7.

© Copyright IBM Corp. 2006, 2018 5

6 IBM Tivoli Netcool Performance Manager: Moving Elements Between SNMP Collectors and Data Channels

Chapter 4. Moving elements between profiles

Explains how to move elements between profiles.

About this task

To move elements between SNMP collectors or separate DataChannels, followthese steps:

Procedure1. Log in as pvuser on the system where DataMart is installed.2. Ensure that your DISPLAY variable has been set and exported.3. Change to the DataMart directory (/opt/datamart by default) by entering the

following command:cd /opt/datamart

4. Set the DataMart environment by entering the following command:. ./dataMart.env

5. Launch the Tivoli Netcool Performance Manager Inventory Tool by enteringthe following command:inventory

The Inventory Tool is used to create profiles that define your networkinventory.

6. Select the name of the source profile that contains the elements that you wishto move.

7. Select Edit profile from the Edit menu.8. If the Use duplicate IP addresses option is cleared in the source profile,

continue with the element movement procedure.

Important: If the Use duplicate IP addresses option is previously selected inthe source profile, the elements contained within the profile cannot be moved.Do not attempt to clear the option and continue with the element movementprocess, as performing this action will damage your inventory and collectionresults

9. Remove the IP addresses of the elements you wish to move from the sourceprofile. For more information, see Specifying IP Addresses in the Configuring andOperating DataMart.

10. Click Finish to save the changes to the source profile, but do not run theprofile.

11. If you need to create a new profile, see the Configuring and Operating DataMartfor more information. Otherwise, select the name of the target profile intowhich you wish to move the elements, then select Edit profile from the Editmenu.

12. Ensure that the Use duplicate IP addresses option in not selected. It is notpossible to move elements between profiles if this option is selected in eitherthe source profile or target profile.

13. Add the IP addresses of the elements you wish to move to the target profile.14. Ensure that other than specifying a different Collector Number in the

Collector Configuration fields, the target profile exactly matches all of the

© Copyright IBM Corp. 2006, 2018 7

settings specified in the source profile. If the source and target profiles do notshare identical settings, the element movement procedure will fail.

15. Click Finish to save the changes to the target profile.16. Select Run profile from the Actions menu.

The target profile discovers the IP addresses, synchronization determines thatthey are discovered previously, and the target collector is notified that it nowowns the new IP addresses.

17. From a command line, issue the following command:confReload PVMResources

This command forces SNMP DataLoad to resynchronize its memory model forall resources, which notifies all SNMP collectors of the changes that haveoccurred in the environment, and prevents double collections from takingplace.

8 IBM Tivoli Netcool Performance Manager: Moving Elements Between SNMP Collectors and Data Channels

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, 2018 9

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:

10 IBM Tivoli Netcool Performance Manager: Moving Elements Between SNMP Collectors and Data Channels

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 11

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.

12 IBM Tivoli Netcool Performance Manager: Moving Elements Between SNMP Collectors and Data Channels

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 13

14 IBM Tivoli Netcool Performance Manager: Moving Elements Between SNMP Collectors and Data Channels

IBM®

Printed in USA