metacvt (1M)
Table of Contents

NAME

metacvt - convert from one release of DiskSuite to the next release

SYNOPSIS

DiskSuite CDROM_mount_point /scripts/metacvt [ -D ] \
-d new_DiskSuite_packages_path [ -f ] [ -i ] [ -u ] [ -v ]

AVAILABILITY

This program is available on the DiskSuite CDROM in the directory scripts.

DESCRIPTION

The metacvt utility script ensures a safe conversion from an installed release of Online:DiskSuite (2.0.1 and 3.0) to the DiskSuite 4.1 release. metacvt creates another script, /tmp/S94SUNWmd.cvt, that actually performs the conversion when executed by the user.

The metacvt utility will:

1) Check that the DiskSuite packages are installed correctly;

2) Check that the user is upgrading;

3) Check that all Solaris file systems (root (/), /usr, /var, /opt, and swap) are not mounted on a mirror or trans metadevice;

4) Check that all hot spares are in the ``available'' state;

5) Check that all metadevices are in the ``Okay'' state;

6) Create an md.tab file that contains a description of the DiskSuite metadevices, hot spares, and state database replicas, where all the mirrors have been made one-way mirrors;

7) Create a temporary /etc/vfstab file that does not reference any metadevices;

8) Generate a script, S94SUNWmd.cvt, that will perform the conversion.

OPTIONS

- D
Enables debugging in the generated script, S94SUNWmd.cvt, and if specified a second time, in both metacvt and the generated script.

-d path
Informs the utility where the new DiskSuite packages to be installed are located. Use this parameter when not using -u or -i.

-f
Specifies that logging devices in ``Detached'' or ``Detaching'' states are considered non-problems. For logging devices in the ``Detached'' state, metacvt displays a warning to make sure that the user understands the consequences of not having the log attached when metacvt runs.

-i
Causes metacvt to produce a script that can be used to save (before the underlying Solaris operating system is reinstalled) and then restore a DiskSuite configuration after a reinstall of the underlying Solaris operating system has completed.

-u
Causes metacvt to produce a script that can be used to save (before the underlying Solaris operating system is upgraded) and then restore a DiskSuite configuration after an upgrade of the underlying Solaris operating system has completed.

-v
Prints the generated script to the screen.

EXAMPLES

This example assumes that you have Volume Management running.

# /cdrom/cdrom0/scripts/metacvt -d /cdrom/cdrom0

This is an example without Volume Management running. First, the CD-ROM has been mounted. It specifies the disksuite_4_1 directory as both the CD-ROM mount point and the location on the CD-ROM of the DiskSuite packages.

# /cdrom/disksuite_4_1/scripts/metacvt -d /cdrom/disksuite_4_1

SEE ALSO

S94SUNWmd.cvt(1M), metaclear(1M), metadb(1M), metadetach(1M), metainit(1M), metaroot(1M), metastat(1M), metattach(1M), md.tab(4), md.conf(4), vfstab(4)

Solstice DiskSuite User's Guide, Solstice DiskSuite Reference