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

  man pages->HP-UX 11i man pages -> vxupgrade (1m)              


 vxupgrade(1M)                                                 vxupgrade(1M)

 NAME    [Toc]    [Back]
      vxupgrade - upgrade the disk layout of a VxFS file system

 SYNOPSIS    [Toc]    [Back]
      vxupgrade [-n new_version] [-r rawdev] mount_point

 DESCRIPTION    [Toc]    [Back]
      vxupgrade prints the current disk layout version number for a VxFS
      file system or upgrades the file system to a new disk layout.
      vxupgrade operates on file systems mounted for read/write access:
      mount_point must be a mounted VxFS file system.  Only a privileged
      user can query or upgrade a VxFS file system.

      When invoked with the -n option, vxupgrade upgrades the disk layout to
      the specified version.  When invoked without the -n option, vxupgrade
      prints the disk layout version number of the file system.

      To perform an upgrade, vxupgrade freezes the file system, allocates
      and initializes the new structures, frees the space used by the old
      structures, and then thaws the file system.  This process should not
      keep the file system frozen for more than a few seconds.

      vxupgrade employs a lock file (lost+found/.fsadm) on the file system
      to ensure that only one instance of vxupgrade is running at any time.
      vxupgrade and fsadm cannot run simultaneously, so the lock file also
      ensures that vxupgrade does not run while a file system reorganization
      is in progress.  When vxupgrade is invoked for an upgrade, it opens
      the lock file in the root of the file system specified by mount_point.
      If the lock file doesn't exist, it is created.  The fcntl(2) system
      call is used to obtain a write lock on the file.  If the write lock
      fails, vxupgrade fails, assuming that another vxupgrade or an fsadm is

    Options    [Toc]    [Back]
      vxupgrade recognizes the following options:

           -n new_version      Upgrade disk layout to new_version.
                               new_version can be 3, 4, or 5.

           -r rawdev           Use the pathname rawdev as the raw device.
                               This option can be used when vxupgrade cannot
                               determine which raw device corresponds to the
                               mount_point (when /etc/mnttab is corrupted,
                               for example).

    Operands    [Toc]    [Back]
      vxupgrade recognizes the following operand:

           mount_point    A mounted VxFS file system.

 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003

 vxupgrade(1M)                                                 vxupgrade(1M)

    Free Space Requirement    [Toc]    [Back]
      vxupgrade requires free space on the file system to perform the
      upgrade; the upgrade may fail if there is not enough free space.  It
      is difficult to determine the exact amount of space required to
      upgrade a VxFS file system, however, you can estimate the maximum
      space required.

      To upgrade a disk layout Version 2 file system with n * 1024 inodes
      (allocated only) and m * 32768 blocks to disk layout Version 3, the
      worst-case minimum value is at least n * 2432 bytes + m * 8220 bytes +
      115 kilobytes, in extents of 8 kilobytes or larger.  Free extents of
      larger than 8 kilobytes may be required, so this is only a lower bound
      on the worst-case minimum required.  Since this is the worst-case
      minimum, it may be possible to upgrade with less free space available.
      After an upgrade to a new disk layout is completed, all of this free
      space, plus some additional free space, will be reclaimed.

      You cannot upgrade a Version 2 disk layout to Version 4 directly.  You
      must first upgrade from Version 2 to a Version 3 disk layout, and then
      upgrade to Version 4.  The upgrade may fail due to a lack of space at
      each step.

    Notes    [Toc]    [Back]
      Once a file system has been upgraded to Version 3, it is no longer
      mountable on HP-UX 10.01 and 10.10.

      Once a file system has been upgraded to Version 4, it is no longer
      mountable on:

           +    HP-UX 10.x

           +    HP-UX 11.0 without JFS 3.3 from Application CD

      Version 4 file systems are mountable on:

           +    HP-UX 11.0 with JFS 3.3 from Application CD

           +    HP-UX 11.1x

      You cannot upgrade the root (/) or /usr file systems to Version 4 on
      an 11.0 system running JFS 3.3 from the Application CD.  Additionally,
      we do not advise upgrading the /var or /opt file systems to Version 4
      on an 11.0 system.  These core file systems are crucial for system
      recovery.  The HP-UX 11.0 kernel and emergency recovery media were
      built with an older version of JFS that does not recognize the Version
      4 disk layout.  If these file systems were upgraded to Version 4, your
      system would fail to boot with the 11.0 kernel as delivered or the
      emergency recovery media.  You can, however, upgrade these core file
      systems to Version 4 on an HP-UX 11.1x system.

 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003

 vxupgrade(1M)                                                 vxupgrade(1M)

      Disk layout versions cannot be downgraded, for example, you cannot
      change a file system from disk layout version 4 to disk layout version

      A file system cannot be upgraded from a Version 3 disk layout to a
      Version 4 disk layout if its intent log size is less than 256

      After upgrading from a Version 2 disk layout, run fsadm -c mount-point
      to convert the inode format to allow growth beyond a two-gigabyte

 RETURN VALUE    [Toc]    [Back]
      vxupgrade returns the following values:

            0   Successful completion.
            1   Upgrade failed due to lack of disk space.
            2   Some other error occurred.
           32   Specified mount_point is not a VxFS file system.

 FILES    [Toc]    [Back]
      mount_point/lost+found/.fsadm Lock file

      mount_point/quotas            External quotas file

 SEE ALSO    [Toc]    [Back]
      fsadm_vxfs(1M), mkfs_vxfs(1M), quotaon(1M), vxfsconvert(1M), fcntl(2),
      fs_vxfs(4), vxfsio(7).

 Hewlett-Packard Company            - 3 -   HP-UX 11i Version 2: August 2003
[ Back ]
 Similar pages
Name OS Title
vxfsconvert HP-UX convert a file system to a vxfs file system or upgrade a VxFS disk layout version.
vxfs_ra_per_disk HP-UX amount of VxFS file system read-ahead per disk, in KB.
df_vxfs HP-UX report number of free disk blocks on a VxFS file system
efs IRIX layout of the Extent File System
fscat HP-UX cat a VxFS file system
fscat_vxfs HP-UX cat a VxFS file system
ff_vxfs HP-UX fast find: list file names and statistics for a VxFS file system
newfs_vxfs HP-UX create a new VxFS file system
mkfs_vxfs HP-UX construct a VxFS file system
vxumount HP-UX unmount a VxFS file system
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service