Veritas NetBackup™ Appliance Decommissioning and Reconfiguration Guide

Last Published:
Product(s): Appliances (4.1)
Platform: NetBackup Appliance OS

About NetBackup Appliance LUN reconfiguration using the DMPDR tool

To reduce the complexity of the multi-step dynamic LUN reconfiguration process, you can use the DMPDR tool which is available by logging in to the maintenance mode of an appliance. DMP refers to Dyanmic Multi-Pathing and DR refers to Dynamic Reconfiguration. The following command launches the tool:

# /usr/lib/vxvm/voladm.d/bin/dmpdr -o refresh

The DMPDR tool includes a non-interactive interface to help with the complex LUN reconfiguration process. The tool attempts to automate and perform the correct sequence of events on the host, which reduces the chance of human error without the need for manual intervention.

For example, the tool performs the following tasks:

  • Performs the correct sequence of events on the appliance to detect any removed and newly added LUNs.

  • Updates the underlying OS device handles for the DMP managed devices and refreshes the VxVM and DMP structures.

  • Creates a log file under /var/adm/vx/ for each LUN reconfiguration event.

The DMPDR tool works in connection only with Veritas DMP (Dynamic Multi-Pathing). Third-party multi-pathing drivers (such as MPxIO and EMC PowerPath) are not supported and will not work with the interface.

Reconfiguring LUNs connected to an appliance server with the DMPDR tool

Separate DMPDR tool sessions are required when you physically add or remove LUNs. You cannot run the tool to reconfigure both added and removed LUNs in the same session, as it may cause problems with the various layers in the I/O stack.

The following procedure describes how to reconfigure LUNs after removing or adding LUNs at the storage array back-end.

To reconfigure LUNs with the DMPDR tool

  1. Remove the intended LUNs from the storage array back-end.
  2. Log in to the appliance as an administrator, then run the following command to log in to the maintenance mode:

    Main > Support > Maintenance

  3. Run the DMPDR with the following command:

    # /usr/lib/vxvm/voladm.d/bin/dmpdr -o refresh

    Note:

    The SCSI Peripheral Qualifier/Device Type (PQ) attribute reports a nonzero value for LUNs that have been removed intentionally from the storage array back-end. For example:

    # /etc/vx/diag.d/vxscsiinq -d /dev/vx/dmp/emc0_00aa | head -3

    Inquiry for /dev/vx/dmp/emc0_00aa, evpd 0x0, page code 0x0 Peripheral Qualifier/Device Type : 3f

    The DMPDR tool deletes only the stale OS device handles that report a nonzero value for the Peripheral Qualifier/Device Type (PQ) attribute.

    The command output provides details of the entire process. When the process has completed successfully, you can continue to the next step to add and reconfigure new LUNs.

  4. Add the intended LUNs to the storage array back-end.
  5. Run the DMPDR with the following command:

    # /usr/lib/vxvm/voladm.d/bin/dmpdr -o refresh

  6. When the process has completed successfully, exit from the maintenance mode.