IBM PureData System for Analytics, Version 7.1

The nzOpenPmr command

Use the nzOpenPmr command to configure and manage the callhome service and the automatic notifications for issues that are detected on the IBM® PureData™ System for Analytics appliances.

Syntax

The nzOpenPmr command has the following syntax.

 nzOpenPmr { --configure | --enable | --disable | --remove |
             --on | --off | --status | --enable-debug |
             --disable-debug | --help }

 nzOpenPmr --generate [ "[ diskMon ], [ clusterSsc ], [ scsiDISKA ],
                      [ spuCore ], [ scsiPredDISKB ], [ hwVoltSPU ],
                      [ scsiPredDISKBDup ], [ hwAttnSPU ],
                      [ regenSPUDISKA ], [ sscOnline ] [ hwSPU ],
                      [ hwDISKB ]" ]

Inputs

The nzOpenPmr command takes the following inputs:

Table 1. The nzOpenPmr input options
Input	Description
--on	Enables the callhome service monitoring.
--off	Disables or stops the callhome service monitoring. Typically used only to stop the service before software upgrades or service events such as hardware replacement.
--configure	Adds the callhome event rules to the event manager for monitoring. Several of the event rules are added with an "off" status, and you must enable them using nzOpenPmr --enable to activate the rules.
--enable	Updates the callhome rules to enable them for monitoring and automatic notifications.
--disable	Updates the callhome rules to disable them, which means that those rules will not be triggered nor take any action when the associated problem occurs on the system.
--help	Displays detailed command usage. If you issue the nzOpenPmr command without any options, the command displays the syntax of the command options.
--remove	Deletes or drops the callhome-related event rules.
--status	Displays the status of the callhome service. enabled The callhome service is on and, if the event rules are configured and enabled, the service is actively monitoring for problem conditions. disabled The callhome service is off and no notifications will take place if the callhome-related events are triggered.
--generate `<problem-type>`	Generates one or more test event conditions for the callhome service. For the <problem-type> value, you can specify one of the following types. You could also specify several values in a comma-separated list enclosed with quotation marks. diskMon Generate three disk_monitorPredictive events. clusterSsc Generate Cluster Fail Over event from a sysStateChanged event. scsiDISKA Generate scsiDiskError for DISK 'A' spuCore Generate spuCore (will evaluate last core present, if any.) scsiPredDISKB Generate scsiPredictiveFailure for DISK 'B' hwVoltSPU Generate hwVoltageFault for SPU. scsiPredDISKBDup Generate scsiPredictiveFailure for DISK 'B' (duplicate of previous.) hwAttnSPU Generate hwNeedsAttention for SPU. regenSPUDISKA Generate regenFault for SPU with Disk 'A'. sscOnline Generate a sysStateChanged event. hwSPU Generate hwServiceRequested for SPU. hwDISKB Generate hwServiceRequested for DISK 'B'.
--enable-debug and --disable-debug	Controls whether XML debug output appears when you run the nzOpenPmr command. You enable the XML debug output when you are working with an IBM Support representative to identify problems with the callhome configuration or operations, and then disable debug output when the problem is corrected. In normal operations, do not enable the debug output format.

Description

You use the nzOpenPmr command to enable and disable the callhome service, configure and remove callhome-related event rules, and as the primary command for managing the automated notifications to IBM Support for problem conditions on the IBM Netezza® appliance. You can also generate event conditions for testing the callhome features and operations.

The nzOpenPmr command is installed in /nz/kit/bin/adm.

Usage

The following provides some of the command uses and sample syntax:

To enable the callhome service:
```
nzOpenPmr --on
```
To disable or stop the callhome service during service or upgrades:
```
nzOpenPmr --off
```
To generate some test SPU event conditions:
```
nzOpenPmr --generate "hwSpu,hwAttnSpu"
```