tank lsdisklabel

Displays the SAN File System product (disk) label for a specified device.

Read syntax diagramSkip visual syntax diagram
>>-tank--lsdisklabel-- –device--device_path--------------------><

Parameters

–device device_path
Specifies the device path of a valid master volume from which to read a product label. The specified device path can include the path of the raw device as an argument, that is, rvpathn where n is the vpath letter. If the device path is not specified, the command might return inaccurate information.

Prerequisites

This task must be performed only by trained service technicians.

The cluster must be offline.

Description

This command is run from the shell prompt. It is not run inside of a sfscli session.

This command is used in disaster recovery situations, when you attach new hardware to an existing cluster, or while troubleshooting the system.

This command is located in the /usr/tank/server/bin directory.

If you display the product label from the master volume, this command displays this information:
  • Label identifier 1. This is always SDISK for all SAN File System devices. This should match the label identifier 2. It is used as an integrity check to detect valid or corrupted product labels.
  • Label number.
  • Disk type. Valid values are:
    M
    Master volume label
    S
    System volume label
    U
    User volume
  • Global disk identifier. This is the ID of volume that is used and understood by the metadata servers and clients.
  • Label date. This is the date when the volume was added.
  • Owner identifier. This is the ID of the cluster that owns the volume.
  • Installation identifier. This is the unique installation ID for the shared storage that is initialized during installation and changes only upon reinstallation.
  • Disk epoch identifier.
  • Product identifier.
  • Label identifier 2. This is always SDISK for all SAN File System devices. This should match the label identifier 1. It is used as an integrity check to detect valid or corrupted product labels.
If you display the product label from a local Tank.Bootstrap file, this command displays this information:
  • Disk type.
  • Global disk identifier.
  • Owner identifier.
  • Installation identifier.
  • Disk epoch identifier.
Tip: The owner ID, installation ID, and disk epoch ID for a given volume is the same as the owner ID, installation ID, and disk epoch ID contained in the Tank.Bootstrap file on all engines in the cluster that own that volume. An engine can be zoned in such a way that it sees devices from another cluster, but each cluster uses the product label information in the Tank.Bootstrap file to know which devices it owns.

Example

Displays the product label for the system master volume The following example displays the product label for the system master volume contained on device /dev/rvpatha (a is the vpath letter):
/usr/tank/server/bin/tank lsdisklabel –device /dev/rvpatha
---------------------------------------------------------
Product Label on Device /dev/rvpatha:
---------------------------------------------------------

Label ID 1                  : SDISK
Label Number                : 0001
Disk Type                   : M
Global Disk ID              : 73EFA22D6A2355F1
Label Date                  : Jun 25, 2003 4:35:24 AM
Owner ID                    : 00000000000004D2
Installation ID             : 73EFA22D6A2355F1
Disk Epoch                  : 0000000000000000
Product ID                  : STORAGETANK
Label ID 2                  : SDISK
---------------------------------------------------------
Displays the information in Tank.Bootstrap The following example displays the product label information found in the local Tank.Bootstrap file:
/usr/tank/server/bin/tank lsdisklabel
---------------------------------------------------------
Tank.Bootstrap information
---------------------------------------------------------

Disk Type                   : U
Global Disk ID              : 73F02ABDBE27B00B
Owner ID                    : 00000000000004D2
Installation ID             : 73F02ABDBE27B00B
Disk Epoch                  : 0000000000000000
---------------------------------------------------------

Parent topic: Service commands and utilities

Terms of use | Feedback
(C) Copyright IBM Corporation 2003, 2004. All Rights Reserved.