IBM. Tivoli Netcool Performance Manager Wireline Component. dbmgr Reference Guide. Document Revision R2E1

Transcription

1 Tivoli Netcool Performance Manager Wireline Component Document Revision R2E1 IBM dbmgr Reference Guide

2 Note Before using this information and the product it supports, read the information in Notices on page 43. Copyright IBM Corp. 1997, 2011 US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

3 Contents Preface v Audience v Organization v The Tivoli Netcool Performance Manager Product Suite v Tivoli Netcool Performance Manager Documentation vi dbmgr Command Reference dbmgr adjustdataloadstemptablespace altertablespacereadonly analyzemetadatatables audittrail deleteoffhoursperiod generatefilescoldbackup insertoffhoursperiod monitorfilesystem monitortablespaces purgepartitions resizetablespacefile selectoffhoursperiod setloglevel showdbpackageversions showpurgeablepartitions showtablespacefiles versiondeletebysingleprovisocomp versiondeleteprovisoglobal versionreregisterinstall versionrptbyprovisoapp versionrptbyprovisocomponent versionrptbyprovisohost versionrptprovisosummary versionsupportleveldump Tivoli Netcool Performance Manager dbmgr Reference Guide Version iii

4 Contents Notices Trademarks Additional Copyright Information Tcl 8.3.3, Combat/TCL 0.7.3, Combat/TCL 0.7.5, TclX 8.3, TK SCOTTY Stack BLT 2.4u CMU-SNMP Scotty 2.8, incrtcl 3.0, [incr TCL] UCD SNMP JDOM Regex 1.1a iv Tivoli Netcool Performance Manager dbmgr Reference Guide Version 1.3.1

5 Preface IBM Tivoli Netcool Performance Manager consists of a wireline component (formerly Tivoli Netcool/Proviso) and a wireless component (formerly Tivoli Netcool Performance Manager for Wireless). This guide explains in reference format how to use the dbmgr utility. It is meant to be used in conjunction with the following documentation: Tivoli Netcool Performance Manager: Database Administration Guide Tivoli Netcool Performance Manager Technical Note: Tools for Version Reporting Audience The audience for this guide is the Tivoli Netcool Performance Manager database administrator. Organization This guide is organized as follows: This chapter General information about the audience, guide, conventions, documentation, and technical support. Chapter dbmgr Command Reference on page 1 Provides reference pages for the dbmgr utility and its attendant commands. The Tivoli Netcool Performance Manager Product Suite Tivoli Netcool Performance Manager is made up of the following components: Tivoli Netcool Performance Manager DataMart is a set of management, configuration and troubleshooting GUIs that the Tivoli Netcool Performance Manager System Administrator uses to define policies and configuration, as well as verify and troubleshoot operations. Tivoli Netcool Performance Manager DataLoad provides flexible, distributed data collection and data import of SNMP and non-snmp data to a centralized database. Tivoli Netcool Performance Manager DataChannel aggregates the data collected through Tivoli Netcool Performance Manager DataLoad for use by the Tivoli Netcool Performance Manager DataView reporting functions. It also processes on-line calculations and detects real-time threshold violations. Tivoli Netcool Performance Manager DataView is a reliable application server for on-demand, webbased network reports. Tivoli Netcool Performance Manager Technology Packs extend the Tivoli Netcool Performance Manager system with service-ready reports for network operations, business development, and customer viewing. The following figure shows the different Tivoli Netcool Performance Manager modules. Tivoli Netcool Performance Manager dbmgr Reference Guide, Version v

6 Preface Figure 1: Tivoli Netcool Performance Manager Modules DataLoad collects network data. DataChannel computes aggregations and stores data in DataMart. DataMart provides data management and applications. DataView produces and manages reports. Tivoli Netcool Performance Manager Documentation Tivoli Netcool Performance Manager documentation consists of the following: release notes configuration recommendations user guides technical notes online help The documentation is available for viewing and downloading on the infocenter at: vi Tivoli Netcool Performance Manager dbmgr Reference Guide, Version 1.3.1

7 dbmgr Command Reference This chapter contains the following manpages for the dbmgr utility and the various commands that it supports: Command Page dbmgr page 2 adjustdataloadstemptablespace page 5 altertablespacereadonly page 6 analyzemetadatatables page 7 analyzemetadatatables page 7 deleteoffhoursperiod page 10 generatefilescoldbackup page 11 insertoffhoursperiod page 13 monitorfilesystem page 15 monitortablespaces page 16 purgepartitions page 17 resizetablespacefile page 19 selectoffhoursperiod page 20 setloglevel page 21 showdbpackageversions page 23 showpurgeablepartitions page 24 showtablespacefiles page 25 versiondeletebysingleprovisocomp page 26 versiondeleteprovisoglobal page 27 versionrptbyprovisoapp page 30 versionrptbyprovisocomponent page 32 versionrptbyprovisohost page 34 versionrptprovisosummary page 36 versionsupportleveldump page 38 Tivoli Netcool Performance Manager dbmgr Reference Guide, Version

8 dbmgr Function Database Management Utility Synopsis dbmgr dbmgr command [parameter(s)] dbmgr [ [-connect username password TNS_entry] [-debug -d level] [-help] [-list -l] [-usage command "*"] [-version -v] ] Description The dbmgr CLI utility (which resides in the $PVMHOME/bin directory) supports a variety of database management operations, and can be invoked either interactively, with character-cell menus, or as a single command entered on the command line. Command Line In command-line mode, the dbmgr utility is called either with a command or a supported option or run as a cron job. Interactive In interactive mode, dbmgr is invoked with no arguments, and displays a menu like the following: Netcool/Proviso DataMart (1.2.1) Licensed Materials - Property of IBM 5724-T61, 5724-P55, 5724-P57, 5724-P58, 5724-P59 Copyright IBM Corporation 2000, All Rights Reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. List of Procedures 1. adjustdataloadstemptablespace 2. altertablespacereadonly 3. analyzemetadatatables 4. deleteoffhoursperiod 5. generatefilescoldbackup 6. insertoffhoursperiod 7. monitorfilesystem 8. monitortablespaces 9. purgepartitions 10. resizetablespacefile 11. selectoffhoursperiod 12. showdbpackageversions 13. showpurgeablepartitions 14. showtablespacefiles 15. versiondeletebysingleprovisocomp 16. versiondeleteprovisoglobal 17. versionrptbyprovisoapp 2 Tivoli Netcool Performance Manager dbmgr Reference Guide, Version 1.3.1

9 dgmgr (continued) 18. versionrptbyprovisocomponent Q. Quit P. Previous N. Next Choice : You navigate using the Next and Previous commands, and you select a command to execute by entering its corresponding number at the Choice prompt, as follows: Netcool/Proviso DataMart (1.2.1) Licensed Materials - Property of IBM 5724-T61, 5724-P55, 5724-P57, 5724-P58, 5724-P59 Copyright IBM Corporation 2000, All Rights Reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Procedure : adjustdataloadstemptablespace argument value Temp size per dataload B. Back P. Previous N. Next E. Execute Choice : Once you select a command, you define the parameters associated with the command by choosing the corresponding parameter number. When you are satisfied with the parameter values, you enter E to execute the command. Parameters command [parameter] Executes a database management command. For a list of supported commands, see the SEE ALSO section of this manpage. -connect username password TNS_entry Connects to the Oracle Transparent Network Substrate (TNS). This option is used whenever the dbmgr utility is on a machine that is not the DataMart server (copied by Professional Services, for example). In that case, in order to run dbmgr, you need to connect to the system where DataMart is installed so that you can access the DataMart configuration file. Note: If this option is not specified, dbmgr uses the connection string defined in the $PVMHOME/conf/database/conf file. -debug -d level -help Executes in debug mode. The following levels are supported: 1 (HistoryLevel) 2 (DetailledLevel and AggregLevel) 3 (DetailledCleanIndexLevel, MoreDetailledLevel, and SQLAggregLevel) 4 (SQLInterfaceLevel) 5 (DetailledInterfaceLevel) Tivoli Netcool Performance Manager dbmgr Reference Guide, Version

10 dgmgr (continued) Writes a list of supported options to the console. -list -l Writes a list of supported commands to the console with a brief description of each command. -usage command "*" Writes the usage statement to the console for the named command or, if an asterisk in double quotes is specified, for every command. -version -v Writes the version number to the console. See Also The following commands are supported by the dbmgr utility: Database Backup altertablespacereadonly generatefilescoldbackup Database Space Management adjustdataloadstemptablespace monitorfilesystem monitortablespaces purgepartitions resizetablespacefile showpurgeablepartitions showtablespacefiles Database Statistics analyzemetadatatables deleteoffhoursperiod insertoffhoursperiod selectoffhoursperiod Database Versioning showdbpackageversions versiondeletebysingleprovisocomp versiondeleteprovisoglobal versionrptbyprovisoapp versionrptbyprovisocomponent versionrptbyprovisohost versionrptprovisosummary versionsupportleveldump 4 Tivoli Netcool Performance Manager dbmgr Reference Guide, Version 1.3.1

11 adjustdataloadstemptablespace Function Database Space Management Synopsis dbmgr adjustdataloadstemptablespace NewTmpSize[Units] Description The adjustdataloadstemptablespace command resizes the temporary tablespace for every installed DataLoad component (both SNMP and BULK). This command is only used if the number of resources managed by DataLoad has changed significantly from the initial sizing and deployment. You can determine if this is the case by checking the file, Prefix_COLL_TEMP, for Oracle errors that state that the temporary tablespaces for the collector is too small. Note: Tivoli Netcool Performance Manager automatically resizes the temporary tablespace when you add a new collector. Never use this command after installing a new collector. Important: This command should only be used at the direction of IBM Support. Parameters NewTmpSize [Units] Specifies the new size of the temporary tablespace (integer) and the unit of the new size. The unit must be one of the following: K (kilobytes) M (megabytes) The size can be null, in which case the value is taken from the registry. Return Values If successful, the _Command command returns 0 and displays one of the following messages: The temporary tablespace was extended. It was too small according to the registry entry DATALOAD.COMMON.TEMP_TSPACE_SIZE_PER_COLL. The temporary tablespace was not changed. It was the right size (or above) according to the registry entry DATALOAD.COMMON.TEMP_TSPACE_SIZE_PER_COLL. Tivoli Netcool Performance Manager dbmgr Reference Guide, Version

12 altertablespacereadonly Function Database Backup Synopsis dbmgr altertablespacereadonly Description Used when backing up the database, the altertablespacereadonly command changes the status of all tablespaces that have a status of "pending read-only" to "read-only" mode. This command does not take any parameters. Return Values If successful, the altertablespacereadonly command returns 0 and the following message: Alter Read Only completed successfully. Example dbmgr altertablespacereadonly result : 0 Alter Read Only completed successfully [pvuser@kafka:/opt/oracle] See Also Tivoli Netcool Performance Manager: Database Administration Guide 6 Tivoli Netcool Performance Manager dbmgr Reference Guide, Version 1.3.1

13 analyzemetadatatables Function Database Statistics Synopsis dbmgr analyzemetadatatables TableSetToAnalyze ForceCollection Description The SQL queries that Tivoli Netcool Performance Manager submits to the Oracle database are based on the Oracle cost-based optimizer, which determines the best execution plan for each query. To assist the optimizer, the analyzemetadatatables command gathers the necessary Oracle statistics on metadata tables according to Tivoli Netcool Performance Manager internal parameters. Without these statistics, Oracle cannot properly determine the most efficient way to access the Tivoli Netcool Performance Manager data. Note: The analyzemetadatatables command is normally placed into cron so that statistics can be gathered at regular intervals, based on an internal calendar. In some cases, however, you may need to gather these statistics manually (after an initial installation of Tivoli Netcool Performance Manager and an initial inventory, for example). Parameters TableSetToAnalyze Specifies the tableset to analyze. Possible values are: A (All) G (Grouping) H (History) I (Inventory) ForceCollection Note: If you are using the command manually, IBM recommends that you use the A (All) option. Specifies whether or not Oracle statistics are to be gathered on every Tivoli Netcool Performance Manager metadata table, regardless of the internal calendar. Possible values are Y (Yes) or N (No). The default is N (No). Tivoli Netcool Performance Manager dbmgr Reference Guide, Version

14 analyzemetadatatables (continued) Return Values If successful, the analyzemetadatatables command returns 0 and displays the following message: Metadata tables analyzed. Example To improve performance, IBM recommends that you regularly compute the statistics on metadata tables, which is why we recommend that this command be placed in cron. The following example shows a cron entry that checks statistics every hour at 30 minutes past the hour. Note that the ForceCollection option is set to N, so that statistics will only be calculated when the internal calendar determines that it is necessary, and not every hour: 30 * * * * [ -f /opt/dm/datamart.env ] && [ -x /opt/dm/bin/dbmgr ] &&. /opt/dm/datamart.env && dbmgr analyzemetadatatables A N 8 Tivoli Netcool Performance Manager dbmgr Reference Guide, Version 1.3.1

15 audittrail Function Database Statistics Synopsis dbmgr audittrail TableType StartDate StartFormat EndDate EndFormat RecordSeparator Description The audittrail command creates an audit history of changes made to the Tivoli Netcool Performance Manager database. Whenever an insert, update, or delete operation is performed on a database table, the action is stored in a historical table for auditing purposes. The audittrail command queries this historical table to return records for a specific period of time and outputs the results to a log file. Note: The period defined by the start and end dates is limited to a maximum of 45 days for performance reasons. Parameters TableType StartDate Specifies the table type for the query. Possible values are: I (Install Config) - Installation and configuration tables, such as aggregation sets, configuration statistics, etc. S (Security Config) - Users and group tables, such as RUSER and USER. DM (DataMart) - DataMart tables, such as calendar, formulas, inventory, thresholds, etc. DV (DataView) - DataView tables, such as APP, scheduler, etc. DO (Dynamic Objects) - Subelements, elements, properties, etc. A (All) - All tables. Start time of the audit period, using the following designation which must conform to the format specified by StartFormat: YYYY.MM.DD-HH24 StartFormat EndDate Tells audittrail what time format to use. The preferred format is as follows: YYYY.MM.DD-HH24 End time of the audit period, using the following designation which must conform to the format specified by EndFormat: YYYY.MM.DD-HH24 EndFormat Tells audittrail what time format to use. The preferred format is as follows: YYYY.MM.DD-HH24 Tivoli Netcool Performance Manager dbmgr Reference Guide, Version

16 deleteoffhoursperiod Function Database Statistics Synopsis dbmgr deleteoffhoursperiod PeriodToDelete Description The deleteoffhoursperiod command deletes an off-hours period that was created by the insertoffhoursperiod command. Note: You determine the index of the period to delete by first running the selectoffhoursperiod command. Parameters PeriodToDelete Index of the off hours period you want to delete, as returned by the selectoffhoursperiod command. Return Values If successful, the deleteoffhoursperiod command returns 0 and the following message: Off hours period deleted. Example dbmgr selectoffhoursperiod result : 0 Off hours periods : Period# Start End :00:00 22:00:00 dbmgr deleteoffhoursperiod result : 0 Off hours period deleted. See Also insertoffhoursperiod selectoffhoursperiod 10 Tivoli Netcool Performance Manager dbmgr Reference Guide, Version 1.3.1

17 generatefilescoldbackup Function Database Backup Synopsis dbmgr generatefilescoldbackup [Y N] Description The generatefilescoldbackup command creates shell scripts that you use to perform a cold backup and restore of the database. Depending upon the parameter you select, the generatefilescoldbackup command does one of the following: Creates two scripts with a list of files to copy and restore. Creates two scripts with a list of files to copy and restore, and includes the UNIX copy commands. The two shell scripts that the generatefilescoldbackup command creates are: backup_files_dateformat.sh restore_files_dateformat.sh The two shell scripts are placed on the Database server in the following directory: $ORACLE_BASE/admin/Instance/udump An actual directory path and file names would resemble the following: /opt/oracle/admin/pv/udump/backup_files_2004_10_27.sh /opt/oracle/admin/pv/udump/restore_files_2004_10_27.sh Note: The backup and restore scripts use environment variables to define the directories where the backups and restore are to take place. Ensure that $BACKUP_DIRECTORY variable is defined before running the backup and restore scripts. Important: Before performing a cold database backup, ensure that the database is shut down. Parameters Y N Specifies whether or not you want to add UNIX copy commands to the generated files. Can be either Y (Yes) or N (No). The default is No. Tivoli Netcool Performance Manager dbmgr Reference Guide, Version

18 generatefilescoldbackup (continued) Return Values If successful, the command returns 0 and the following message: The cold backup file is available on the DB server under /opt/oracle/admin/pv/udump/backup_files_dateformat.sh. Example dbmgr altertablespacereadonly result : 0 Alter Read Only completed successfully [pvuser@kafka:/opt/oracle] [pvuser@kafka:/opt/oracle] dbmgr generatefilescoldbackup result : 0 The cold backup file is available on the DB server under /opt/oracle/admin/pv/udump/backup_files_2005_05_04.sh 12 Tivoli Netcool Performance Manager dbmgr Reference Guide, Version 1.3.1

19 insertoffhoursperiod Function Database Statistics Synopsis insertoffhoursperiod StartTime StarTimeFormat EndTime EndTimeFormat Description Gathering Oracle statistics is a CPU and I/O intensive operation. The insertoffhoursperiod command allows you to specify a time when Tivoli Netcool Performance Manager gathers Oracle statistics, so that the gathering can be done at a time when the system load is low and users or programs are not impacted. Parameters StartTime Start time of the off period, using the following designation which must conform to the format specified by StartTimeFormat: 00:00:00 StartTimeFormat EndTime Tells dbmgr what time format to use. The preferred format is as follows: HHS24:MI:SS End time of the off period, using the following designation which must conform to the format specified by EndTimeFormat: 00:00:00 EndTimeFormat Tells dbmgr what time format to use. The preferred format is as follows: HHS24:MI:SS Return Values If successful, the command returns 0 and the following message: Off hours period inserted. If unsuccessful, the command returns 1 and the following message: Start time is over end time. Offhour period creation failed. Tivoli Netcool Performance Manager dbmgr Reference Guide, Version

20 insertoffhoursperiod (continued) Example dbmgr insertoffhoursperiod 06:00:00 HH24:MI:SS 22:00:00 HH24:MI:SS dbmgr insertoffhoursperiod 06:00:00 HH24:MI:S S 22:00:00 HH24:MI:SS result : 0 Off hours period inserted [pvuser@kafka:/export/home/pvuser] See Also deleteoffhoursperiod selectoffhoursperiod 14 Tivoli Netcool Performance Manager dbmgr Reference Guide, Version 1.3.1

21 monitorfilesystem Function Database Space Management Synopsis dbmgr monitorfilesystem Description The monitorfilesystem command analyzes the free space on each filesystem according to the userdefined thresholds. Possible status is as follows: NORMAL Free space is within bounds. WARNING Free space has exceeded the WARNING threshold. CRITICAL Free space has exceeded the CRITICAL threshold. If any threshold is exceeded, the monitorfilesystem command calls the $ORACLE_HOME/bin/notifyDbSpace script, which if properly configured sends to a specified user with a status message. This command does not take any parameters. Return Values If successful, the command returns 0, and lists the mount points, percentage of space used, and the status based on the threshold values defined in the database registry. Example dbmgr monitorfilesystem Mount Point Busy Status / 77% -normal- /var 58% -normal- /export/home0 68% -normal- See Also Tivoli Netcool Performance Manager: Database Administration Guide Tivoli Netcool Performance Manager dbmgr Reference Guide, Version

22 monitortablespaces Function Database Space Management Synopsis dbmgr monitortablespaces Description The monitortablespaces command analyzes the free space of each metadata tablespace according to userdefined thresholds. Possible status is as follows: NORMAL Tablespace is within bounds. WARNING Some of the tablespace utilization has exceeded the WARNING threshold. CRITICAL Some of the tablespace utilization has exceeded the CRITICAL threshold. If any threshold is exceeded, the monitortablespaces command calls the $ORACLE_HOME/bin/notifyDbSpace script, which if properly configured sends to a specified user with a status message. This command does not take any parameters. Return Values If successful, the command returns 0 and a status of either NORMAL, WARNING, or CRITICAL. Example dbmgr monitortablespaces result : 0 Tablespace status found : NORMAL [pvuser@kafka:/opt/oracle] See Also Tivoli Netcool Performance Manager: Database Administration Guide 16 Tivoli Netcool Performance Manager dbmgr Reference Guide, Version 1.3.1

23 purgepartitions Function Database Space Management Synopsis dbmgr purgepartitions ChannelNumber TableSetType PurgeDate Description The purgepartitions command purges the oldest partitions from the historic metric data tables (H2). If a tablespace that contains purged partitions becomes empty, it is automatically dropped. Note: Before purging, dbmgr will validate that the partitions are eligible to be purged. Only partitions that exist in the H2 table are eligible to be purged. The result of the purgepartitions command is placed in a log file named purges_yyyy_mm_dd_hh24_mi_ss.log. The log file is placed in the udump directory on the DB server (for example, $ORACLE_BASE/admin/InstanceName/udump). Note: Before running this command, you need to run the showpurgeablepartitions command to get a list of partitions that can be purged. Parameters ChannelNumber Integer that specifies the channel that the tablespace is to be added to. TableSetType Specifies the type of tablespace. Valid types are: NRAW, BASE, 1DRA, 1WRA, 1MRA, 1DGA, 1WGA, and 1MGA. PurgeDate Specifies the date before which partitions are to be purged. The format is as follows: YYYY.MM.DD- HH24 Tivoli Netcool Performance Manager dbmgr Reference Guide, Version

24 purgepartitions (continued) Return Values If successful, the purgepartitions command returns 0 and one of the following messages: No partition found. See the following log file contents for purge results Filename. If unsuccessful, the purgepartitions returns 1 and the following message: See the following log file contents for purge results Filename. Example dbmgr purgepartitions 1 1DRA See Also showpurgeablepartitions Tivoli Netcool Performance Manager: Database Administration Guide 18 Tivoli Netcool Performance Manager dbmgr Reference Guide, Version 1.3.1

25 resizetablespacefile Function Database Space Management Synopsis dbmgr resizetablespacefile NumberOfFileToResize NewFileSize [Units] Description The resizetablespacefile command only resizes an Oracle datafile for metric tablespaces. Important: Under normal circumstances, this feature should never be used, since the DataChannel (LDR/DLDR) automatically creates tablespaces. Important: This command should only be used at the direction of IBM Support. Parameters NumberOfFileToResize Specifies the file number to resize, derived from the showtablespacefiles command. NewFileSize [Units] Specifies the new size of the file (integer) and the unit of the new size: B (bytes) K (kilobytes) M (megabytes) Return Values If successful, the command returns 0 and the following message: Resized datafile successfully. See Also showtablespacefiles Tivoli Netcool Performance Manager dbmgr Reference Guide, Version

26 selectoffhoursperiod Function Database Statistics Synopsis dbmgr selectoffhoursperiod Description The selectoffhoursperiod command lists all of the current off-hour periods, which were defined by the insertoffhours command. This command does not take any parameters. Return Values If successful, the selectoffhoursperiod command returns 0. Example dbmgr selectoffhoursperiod result : 0 Off hours periods : Period# Start End :00:00 22:00: [pvuser@kafka:/export/home/pvuser] See Also deleteoffhoursperiod insertoffhoursperiod 20 Tivoli Netcool Performance Manager dbmgr Reference Guide, Version 1.3.1

27 setloglevel Function Database level tracing Synopsis dbmgr setloglevel Description The setloglevel command sets the detail level of log messages. The command requires that you provide the User name, Log level, and Log By Session information. The Log Level is defined with increasing levels of tracing from: USR, ADM, to SUP. The Log By Session determines whether each session is logged separately or in a 'common' log. The log level selected will remain in effect until it is reset to a new log level. Parameters UserName Specifies the user for which the logging level will be set. The set of users available are: PV_ADMIN PV_BACKUP PV_CHANNEL_XX PV_CHNL_MANAGER PV_CHNL_RECOMP PV_COLL PV_GUI PV_INSTALL PV_INVENTORY PV_LDR24_XX PV_LDR_XX PV_LOIS PV_METRIC PV_OPERATOR PV_REPORTMASTER PV_REPORT PV_RESMGR Tivoli Netcool Performance Manager dbmgr Reference Guide, Version

28 setloglevel (continuedl LogLevelName This can be any of: USR: User - Most users have this as their default log level. This is used for the minimal amount of logging. This level is appropriate for 'common' logging. ADM: Admin - This is the default log level for PV_ADMIN. This generates a higher level of logging than the USR level. SUP: Support - This is the highest log level and it produces the greatest amount of information, This should only be used when troubleshooting an issue. This level of logging should be performed with Log By Session set to (Y)es. LogBySession Note: This log level can exhaust the available disk space. Once troubleshooting has been completed you must reset the log level back to a lower level. This determines whether each session is logged separately or in a 'common' log. This can be set to Y or N, yes or no. Example Procedure : setloglevel argument value User name PV_ADMIN 2. Log Level SUP 3. Log By Session Y B. Back P. Previous N. Next E. Execute Choice : e procedure : setloglevel PV_ADMIN SUP Y Confirmation (y/n) : y 22 Tivoli Netcool Performance Manager dbmgr Reference Guide, Version 1.3.1

29 showdbpackageversions Function Database Versioning Synopsis dbmgr showdbpackageversions Description The showdbpackageversions command displays the revision of all database packages. This command does not take any parameters. Return Values If the command is successful, it returns 0 and lists all the revisions of the packages. If the command is unsuccessful, it returns 1 and a list of the revisions it could not obtain. Example dbmgr showdbpackageversions result : 1 Package name - Installation date - Version PVM_BACKUP.pks :00 - Revision: 30.9 PVM_BACKUP.pkb :17 - Revision: PVM_CHNL_MGR.pks :00 - Revision: PVM_CHNL_MGR.pkb :08 - Revision: PVM_CHNL_VIEW.pks :00 - Revision: 30.1 PVM_CHNL_VIEW.pkb :21 - Revision: Tivoli Netcool Performance Manager dbmgr Reference Guide, Version

30 showpurgeablepartitions Function Database Space Management Synopsis dbmgr showpurgeablepartitions ChannelNumber TableSetType Description The showpurgeablepartitions command lists all partitions from historic tables that could be purged in a specific channel for a specific table set. You use this command prior to manually purging metric data with the purgepartitions command to get the list of partitions that can be purged. Parameters ChannelNumber Integer that specifies the channel that the tablespace is to be added to. TableSetType Specifies the type of tablespace. Valid types are: NRAW, BASE, 1DRA, 1WRA, 1MRA, 1DGA, 1WGA, and 1MGA. Return Values If successful, the showpurgeablepartitions command returns 0. Example dbmgr showpurgeablepartitions 1 BASE result : 0 No purgeable partitions [pvuser@kafka:/export/home/pvuser] See Also purgepartitions Tivoli Netcool Performance Manager: Database Administration Guide 24 Tivoli Netcool Performance Manager dbmgr Reference Guide, Version 1.3.1

31 showtablespacefiles Function Database Space Management Synopsis dbmgr showtablespacefiles ChannelNumber TableSetType Description The showtablespacefiles command lists all the files belonging to a specific channel and set type. Parameters ChannelNumber Integer that specifies the channel that the tablespace is to be added to. TableSetType Specifies the type of tablespace. Valid types are: NRAW, BASE, 1DRA, 1WRA, 1MRA, 1DGA, 1WGA, and 1MGA. Return Values If successful, the command returns 0. Example result : 0 C01_NRAW_000_ File Name Min Size Cur Size /export/home0/oradata/pv42/pv42_c01_nraw_000_ _001.dbf 18 M 19 M C01_NRAW_000_ File Name Min Size Cur Size /export/home0/oradata/pv42/pv42_c01_nraw_000_ _001.dbf 128 K 144 K C01_NRAW_000_ Tivoli Netcool Performance Manager dbmgr Reference Guide, Version

32 versiondeletebysingleprovisocomp Function Database Versioning Synopsis dbmgr versiondeletebysingleprovisocomp Application ComponentName ComponentID Description The versiondeletebysingleprovisocomp command marks a component as deleted for a specific application. Important: This command should only be used at the direction of IBM Support. Parameters Application Specifies the application you want to report against. Supported values are: AP, DB, DC, DL, DM, DV, or TOOLS. ComponentName Name of the component you want to mark as deleted (for example, CME). ComponentId ID of the component (for example, 1.2) Note: For a component that does not have an ID, use the word Null. Return Values If successful, the command returns 0. If unsuccessful, the command returns 1 and the following message: Please make sure that the component you are attempting to delete is currently active. Check that the component exist and/or has been registered. See Also Tivoli Netcool Performance Manager Technical Note: Tools for Version Reporting 26 Tivoli Netcool Performance Manager dbmgr Reference Guide, Version 1.3.1

33 versiondeleteprovisoglobal Function Database Versioning Synopsis versiondeleteprovisoglobal DeleteType [ComponentToDelete] Description The versiondeleteprovisoglobal command marks all specified components as deleted. Important: This command should only be used at the direction of IBM Support. Parameters DeleteType Can be one of the following: A (All components for an application specified by ComponentToDelete) C (All eligible components) H (All components for a host specified by ComponentToDelete) ComponentToDelete One of the following: The hostname of the host to be deleted. The application to be deleted, specified by one the following: AP, DB, DC, DL, DM, DV, or TOOLS. Note: This parameter is ignored for a DeleteType of "All Eligible (C)omponents." Tivoli Netcool Performance Manager dbmgr Reference Guide, Version

34 versiondeleteprovisoglobal (continued) Return Values If successful, the command returns 0 and one the following message: All components for application DL have been marked as deleted. If unsuccessful, the command returns 1 and one of the following messages: Application is not valid. Action: Please check you entered a valid application (i.e. DL). Please make sure that the component you are attempting to delete is currently active. Check that the component exists and/or has been registered. See Also Tivoli Netcool Performance Manager Technical Note: Tools for Version Reporting 28 Tivoli Netcool Performance Manager dbmgr Reference Guide, Version 1.3.1

35 versionreregisterinstall Function Database Versioning Synopsis versionreregisterinstall Hostname Description The versionreregisterinstall command re-registers all components, that are part of the 'Install' applications (DB, AP), to a new host. These components don't register themselves during operation. Parameters Hostname Name of the host that will register the components. Return Values If successful, the command returns 0 and states that all applications have been re-registered. Tivoli Netcool Performance Manager dbmgr Reference Guide, Version

36 versionrptbyprovisoapp Function Database Versioning Synopsis dbmgr versionrptbyprovisoapp ReportType Application Description The versionrptbyprovisoapp command provides either a summary or detailed report on the version of a particular application. Parameters ReportType Specifies the type of summary report. Supported types are: E (Extended component information) V (Component summary with versions) Application Specifies the application you want to report against. Supported values are: AP, DB, DC, DL, DM, DV, or TOOLS. Return Values If successful, the command returns 0 and one of the following: The requested summary list. The following warning message: Application is not valid. To correct this problem, enter a valid application value. 30 Tivoli Netcool Performance Manager dbmgr Reference Guide, Version 1.3.1

37 versionrptbyprovisoapp (continued) Example dbmgr versionrptbyprovisoapp V DC result : 0 Application: DC Component Version Count AMGR R2E2 2 AMGRW R2E2 2 CME R2E2 2 CMGR R2E2 1 CMGRW R2E2 1 CNSW R2E2 1 DISC R2E2 1 DLDR R2E2 1 FTE R2E2 2 LDR R2E2 1 LOG R2E2 1 LOGW R2E2 1 See Also Tivoli Netcool Performance Manager Technical Note: Tools for Version Reporting Tivoli Netcool Performance Manager dbmgr Reference Guide, Version

38 versionrptbyprovisocomponent Function Database Versioning Synopsis versionrptbyprovisocomponent ReportType Application ComponentName ComponentID Description The versionrptbyprovisocomponent command creates a version report for a specified component that contains the following information: The version for a specific component. The detail records associated with a specific component. Parameters ReportType Specifies the type of summary report. Supported types are: D (Detail records) E (Extended component information) Application Specifies the application you want to report against. Supported values are: AP, DB, DC, DL, DM, DV, or TOOLS. ComponentName Name of the component you want to mark as deleted (for example, CME). ComponentId ID of the component (for example, 1.2) Note: For a component that does not have an ID, use the word Null. Return Values If successful, the command returns 0. If unsuccessful, the command returns 1 and the following message: Action: The information you entered does not match with an existing Tivoli Netcool Performance Manager component or the parameters entered are not compatible with each together. 32 Tivoli Netcool Performance Manager dbmgr Reference Guide, Version 1.3.1

39 versionrptbyprovisocomponent (continued) Example dbmgr versionrptbyprovisocomponent E DC CME result : 0 Application: DC Component: CME.1.1 Version Build Registration Date R2E2 Raoul :08:35 See Also Tivoli Netcool Performance Manager Technical Note: Tools for Version Reporting Tivoli Netcool Performance Manager dbmgr Reference Guide, Version

40 versionrptbyprovisohost Function Database Versioning Synopsis versionrptbyprovisohost ReportType Hostname Description The versionrptbyprovisohost command provides version information for Tivoli Netcool Performance Manager components on a specified host. Parameters ReportType Specifies the type of summary report. Supported types are: E (Extended component information) V (Component summary with versions) Hostname Name of the host against which you are running the report. Return Values If successful, the command returns 0 and the host information. 34 Tivoli Netcool Performance Manager dbmgr Reference Guide, Version 1.3.1

41 versionrptbyprovisohost (continued) Example dbmgr versionrptbyprovisohost V kafka result : 0 Host Name: KAFKA Application Component Version Coun t AP ALCATEL_5620_NM 4.3-B 1 AP BASE 4.3-B 1 AP CISCO_DEVICE 4.3-B 1 AP CISCO_WAN 4.3-B 1 AP FRAME 4.3-B 1 AP METRICS 4.3-B 1 AP MIB2 4.3-B 1 AP MIBS 4.3-B 1 AP THRESHOLDS 4.3-B 1 DB Database R2E1 1 DC AMGR R2E2 1 DC AMGRW R2E2 1 DC CMGR R2E2 1 DC CMGRW R2E2 1 DC CNSW R2E2 1 DC DISC R2E2 1 DC LOG R2E2 1 DC LOGW R2E2 1 DL SNMP R2E1 1 See Also Tivoli Netcool Performance Manager Technical Note: Tools for Version Reporting Tivoli Netcool Performance Manager dbmgr Reference Guide, Version

42 versionrptprovisosummary Function Database Versioning Synopsis dbmgr versionrptprovisosummary ReportType Description The versionrptprovisosummary command produces global summary reports for the system that contains the following information: Host And IP Summary - lists the host names in the system that currently have registered components. Component Summary - provides a complete component summary for the entire Tivoli Netcool Performance Manager system. Parameters ReportType Specifies the type of summary report. Supported types are: H (Active hosts summary) S (Global component summary) V (Global component summary with versions) Return Values If successful, the command returns Tivoli Netcool Performance Manager dbmgr Reference Guide, Version 1.3.1

43 versionrptprovisosummary (continued) Example dbmgr versionrptprovisosummary S result : 0 Application Component Count AP ALCATEL_5620_NM 1 AP BASE 1 AP CISCO_DEVICE 1 AP CISCO_WAN 1 AP FRAME 1 AP METRICS 1 AP MIB2 1 AP MIBS 1 AP THRESHOLDS 1 DB Database 1 DC AMGR 2 DC AMGRW 2 DC CME 2 DC CMGR 1 DC CMGRW 1 DC CNSW 1 DC DISC 1 DC DLDR 1 DC FTE 2 DC LDR 1 DC LOG 1 DC LOGW 1 DL BCOL 1 DL SNMP 1 DM PVM 1 DV DataView 1 DV extend Application Server 1 See Also Tivoli Netcool Performance Manager Technical Note: Tools for Version Reporting Tivoli Netcool Performance Manager dbmgr Reference Guide, Version

44 versionsupportleveldump Function Versioning Synopsis dbmgr versionsupportleveldump Description The versionsupportleveldump command writes all the version information into a file on the database server in the $ORACLE_BASE/admin/PV/udump directory. Note: This command is typically used at the request of IBM Support. This command does not take any parameters. Return Values If the command is successful, it returns 0. Example dbmgr versionsupportleveldump result : 0 The version information file is available on the DB server at the following location: /opt/oracle/admin/pv/udump/detailed_version_rpt_2005_05_03_11.log See Also Tivoli Netcool Performance Manager Technical Note: Tools for Version Reporting 38 Tivoli Netcool Performance Manager dbmgr Reference Guide, Version 1.3.1

45 NOTES Tivoli Netcool Performance Manager dbmgr Reference Guide, Version

46 40 Tivoli Netcool Performance Manager dbmgr Reference Guide, Version 1.3.1

47 Index A adjustdataloadstemptablespace 5 altertablespacereadonly 6 analyzemetadatatables 7, 9 D Database Backup altertablespacereadonly 6 generatefilescoldbackup 11 Database Space Management adjustdataloadstemptablespace 5 monitorfilesystem 15 monitortablespaces 16 purgepartitions 17 resizetablespacefile 19 showpurgeablepartitions 24 showtablespacefiles 25 Database Statistics analyzemetadatatables 7, 9 deleteoffhoursperiod 10 insertoffhoursperiod 13 selectoffhoursperiod 20, 21, 22 Database Versioning showdbpackageversions 23 versiondeletebysingleprovisocomp 26 versiondeleteprovisoglobal 27 versionrptbyprovisoapp 30 versionrptbyprovisocomponent 32 versionrptbyprovisohost 34 versionrptprovisosummary 36 versionsupportleveldump 38 DataMart copyright information for tools 49 dbmgr 2 deleteoffhoursperiod 10 M monitorfilesystem 15 monitortablespaces 16 P purgepartitions 17 R resizetablespacefile 19 S SCOTTY Stack copyright information 49 selectoffhoursperiod 20, 21, 22 showdbpackageversions 23 showpurgeablepartitions 24 showtablespacefiles 25 V versiondeletebysingleprovisocomp 26 versiondeleteprovisoglobal 27 versionrptbyprovisoapp 30 versionrptbyprovisocomponent 32 versionrptbyprovisohost 34 versionrptprovisosummary 36 versionsupportleveldump 38 X Xwpick copyright information 51 G generatefilescoldbackup 11 I insertoffhoursperiod 13 Tivoli Netcool Performance Manager dbmgr Reference Guide, Version

48 Index 42 Tivoli Netcool Performance Manager dbmgr Reference Guide, Version 1.3.1

49 Notices This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information about the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user s responsibility to evaluate and verify the operation of any non-ibm product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY U.S.A. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan Ltd , Shimotsuruma, Yamato-shi Kanagawa Japan. The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement might not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-ibm Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: Tivoli Netcool Performance Manager dbmgr Reference Guide, Version

50 IBM Corporation 2Z4A/ Burnet Road Austin, TX U.S.A. 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 material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on developmentlevel systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurement may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-ibm products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-ibm products. Questions on the capabilities of non-ibm products should be addressed to the suppliers of those products. All statements regarding IBM s future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. This information is for planning purposes only. The information herein is subject to change before the products described become available. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. COPYRIGHT LICENSE: This information contains sample application programs in source language, which illustrate programming techniques on various operating systems. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating system for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. You may copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of developing, using, marketing, or distributing application programs conforming to IBM's application programming interfaces. If you are viewing this information in softcopy form, the photographs and color illustrations might not appear. Trademarks IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International 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 and trademark information at Intel is a registered trademark of Intel Corporation or its subsidiaries in the United States, other countries, or both. Linux is a trademark of Linus Torvalds in the United States, other countries, or both. 44 Tivoli Netcool Performance Manager dbmgr Reference Guide, Version 1.3.1