*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> vxunreloc (1m)              
Title
Content
Arch
Section
 

Contents


 vxunreloc(1M)                    VxVM 3.5                     vxunreloc(1M)
                                 1 Jun 2002



 NAME    [Toc]    [Back]
      vxunreloc - move a hot-relocated subdisk back to its original disk

 SYNOPSIS    [Toc]    [Back]
      /etc/vx/bin/vxunreloc [-f] [-g diskgroup] [-n dm_name] [-t tasktag]
      dm_name

 DESCRIPTION    [Toc]    [Back]
      The VERITAS Volume Manager (VxVM) hot-relocation feature can detect an
      I/O failure in a subdisk, relocate the subdisk, and recover the plex
      associated with the subdisk.  vxunreloc lets you reverse the process
      and move the hot-relocated subdisks back onto a disk that was replaced
      after a disk failure.

      dm_name specifies the disk where the hot-relocated subdisks originally
      resided.  The -n option moves the subdisks to a different disk from
      where VxVM originally relocated them.  For example, when disk03 fails,
      all the subdisks residing on it are hot-relocated to other disks.
      After the disk is repaired, it is added back to the disk group using a
      different name, for example, disk05.  If you wanted to move all the
      hot-relocated subdisks back to the repaired disk, you would enter:

           /etc/vx/bin/vxunreloc -n disk05 disk03


      When vxunreloc moves the hot-relocated subdisks, it moves them to
      their original offsets.  However, if there was a subdisk that occupied
      part or all of the area on the destination disk, vxunreloc prints an
      error message and exits.  In this situation, you can use the -f option
      to unrelocate the subdisks to a specified disk, but not to their
      original offsets.

 OPTIONS    [Toc]    [Back]
      -f        Unrelocates a subdisk to a different offset if unrelocating
                to the original offset is not possible.

      -g diskgroup
                Unrelocates a subdisk from the specified disk group.

      -n dm_name
                Specifies a new disk name to relocate to a disk with a
                different name.

      -t tasktag
                Specifies a tag to pass to the underlying utility.

 SUBDISK RECORD FIELDS    [Toc]    [Back]
      orig_dmname
                When a subdisk is hot-relocated, its original disk media
                name is stored in the orig_dmname field.  When you run the
                vxunreloc command to move the subdisk back to the original



                                    - 1 -       Formatted:  January 24, 2005






 vxunreloc(1M)                    VxVM 3.5                     vxunreloc(1M)
                                 1 Jun 2002



                disk (or to a new disk), this field is cleared.  Before you
                run the vxunreloc command, you can do a search on this field
                to determine the subdisks that originated from a failed
                disk.  For example, the following command lists all the
                subdisks that were hot-relocated from disk01 in the disk
                group rootdg. Note that you must prefix the field name with
                "sd_" for the command to work.


                  vxprint -g rootdg -se 'sd_orig_dmname="disk01"'




      orig_dmoffset
                When a subdisk is hot-relocated, its offset into the
                original disk is stored in the orig_dmoffset field.  When
                you run vxunreloc to move the subdisk to the original disk,
                or to a new disk, this field is zeroed.  The following
                command lists a hot-relocated subdisk which originally
                resided at disk10 at offset 1000.  Again note that you must
                prefix the field names with "sd_" for the command to work.


                  vxprint -g dg01 -se 'sd_orig_dmname="disk10"   \
                  && sd_orig_dmoffset=1000'


 EXIT CODES    [Toc]    [Back]
      If the operation fails, vxunreloc exits with a non-zero status.  A
      non-zero exit code is not a complete indicator of the problems
      encountered, but rather denotes the first condition that prevented
      further execution of the utility.

      See vxintro(1M) for a list of standard exit codes.

 SEE ALSO    [Toc]    [Back]
      vxassist(1M), vxintro(1M), vxmake(1M), vxprint(1M), vxrelocd(1M),
      vxsd(1M), vxsparecheck(1M)


                                    - 2 -       Formatted:  January 24, 2005
[ Back ]
      
      
 Similar pages
Name OS Title
unvis OpenBSD revert a visual representation of data back to original form
unvis FreeBSD revert a visual representation of data back to original form
volassist Tru64 Create, mirror, back up, grow, shrink, move, add logs to, and support online backup of LSM volumes
vgrestore HP-UX restore a VxVM disk group back to an LVM volume group
patch FreeBSD apply a diff file to an original
patch IRIX apply a diff file to an original
patch Linux apply a diff file to an original
patch OpenBSD apply a diff file to an original
FindBin IRIX Locate directory of original perl script
patch HP-UX a program for applying a diff file to an original
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service