The nzspupart command

Use the nzspupart command to display information about the SPU partitions on a system, inr_sysadm_nzspupart_cmdhttps://ibmid.acrolinx.cloud/cluding status information and the disks that support the partition.

Description

The nzspupart command has the following description.

Privileges required: You must specify a database user account that has Manage Hardware privilege.
Common tasks: Use the nzspupart command to display information about the SPU partitions of a Netezza Performance Server system, or to perform a partition regeneration when th partition is degraded. You can use the command to obtain status about the partitions and the space that is used within them, whether regenerations are in progress, or if there are issues that require your attention.

Related Commands: Use with other system commands, such as the nzhw and nzds commands.

Syntax

The nzspupart command has the following syntax:

nzspupart [-h|-rev] [-hc] subcmd [subcmd options]

Inputs

The nzspupart command takes the following inputs:

Table 1. The nzspupart input options
Input	Description
nzspupart show [options]	Displays information about the specified partitions. If you do not specify any options, the command displays a list of all partition and their ID, type, status, size, percent that is used, and supporting disks. You can specify one or more options to show specific output.
nzspupart regen [options] [-force]	Starts regeneration for SPU partitions. Starting from version 11.0.3.0, the `nzspupart` command is enabled to `regen` only specified data partitions. If you do not specify any options, the command searches for degraded partitions and starts regeneration processes to the available spare disks. Optionally, you can use the options -spu spuId, -part partId, and -dest diskHwId to specify source and target information for a specific regeneration. Include the -force option to start the regen without prompting you for a confirmation.
nzspupart listTypes	Displays a list of the valid hardware types that you can input for the nzspupart show -type `spuPartitionType` command.
nzspupart remove [options]	Starts the removal of a primary or mirror copy.
nzspupart exchangeRoles [options]	Exchanges primary and mirror partition roles.

The nzspupart show options

The nzspupart show command supports the following options.

Tip: You can skip specifying the show keyword for the nzspupart show command. For example, you can use nzspupart -detail instead of nzspupart show -detail.

Table 2. The nzspupart show options
Option	Description
-detail	Displays detailed information about partitions.
-partrole	Displays information about partition roles.
-issues	Displays information about partitions that have issues.
-type `spuPartitionType`	Displays information about partitions of a specific type.

Examples

To display information about data partitions, run:
```
nzspupart -type Data
```
To display information about NzLocal partitions, run:
```
nzspupart -type NzLocal
```

The nzspupart regen options

The nzspupart regen command supports the following options.

Table 3. The nzspupart regen options
Option	Description
-spu`hw-id`	Specifies the SPU.
-part`part-id`	Specifies the partition.
-Dest`disk-hw-id`	Specifies the destination.
-dsid`dataslice-id`	Specifies the data slice.
-replaceMirror	Replaces a mirror partition.
-replacePrimary	Replaces a primary partition.

Examples

To regen a specific degraded spu partition, run:

nzspupart regen -spu hw-id -part part-id -Dest disk-hw-id

Example:

nzspupart regen -spu 1006 -part 13 -Dest 1023

To regen a specific degraded data slice, run:

nzspupart regen -dsid dataslice-id -Dest disk-hw-id

Example:

nzspupart regen -dsid 7 -Dest 1023

To replace a mirror partition from a specific SPU partition, run:

nzspupart regen -spu hw-id -part part-id -replaceMirror -Dest disk-hw-id

Example:

nzspupart regen -spu 1006 -part 11 -replaceMirror -Dest 1021

To replace a primary partition from a specific SPU partition, run:

nzspupart regen -spu hw-id -part part-id -replacePrimary -Dest disk-hw-id

Example:

nzspupart regen -spu 1006 -part 12 -replacePrimary -Dest 1022

Note: Make sure destination (-dest) storage devices have a spare partition.

The nzspupart remove options

The nzspupart remove command supports the following options.

Table 4. The nzspupart remove options
Option	Description
-spu`hw-id`	Specifies the SPU.
-part`part-id`	Specifies the partition.
-dsid`dataslice-id`	Specifies the data slice.
-mirror	Removes a mirror partition from a specific SPU partition.
-primary	Removes a primary partition from a specific SPU partition. Mirror partition becomes the primary partition after you run this command.

Examples

To remove a mirror partition from a specific SPU partition, run:

nzspupart remove -spu 1006 -part 11 -mirror

```
nzspupart remove -dsid 13 -mirror 
```

To remove a primary partition from a specific SPU partition, run:

nzspupart remove -spu 1006 -part 11 -primary

```
nzspupart remove -dsid 13 -primary
```

The nzspupart exchangeRoles options

The nzspupart exchangeRoles command supports the following options.

Table 5. The nzspupart exchangeRoles options
Option	Description
-spu `<hw-id>`	Specifies the SPU.
-part`part-id`	Specifies the partition.
-dsid`dataslice-id`	Specifies the dataslice.

Examples

nzspupart exchangeRoles -spu 1006 -part 13

```
nzspupart exchangeRoles -dsid 7
```