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

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


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

 NAME    [Toc]    [Back]
      vxdctl - control the volume configuration daemon

 SYNOPSIS    [Toc]    [Back]
      vxdctl [ -c ] mode

      vxdctl [ -k ] stop

      vxdctl add disk accessname [ attr[=value] ]...

      vxdctl cacheenable

      vxdctl cachedisable

      vxdctl cacheflush

      vxdctl disable

      vxdctl enable

      vxdctl hostid hostid

      vxdctl init [ hostid ]

      vxdctl initdmp

      vxdctl license [init]

      vxdctl list

      vxdctl mode

      vxdctl protocolrange

      vxdctl protocolversion

      vxdctl rm disk accessname...

      vxdctl support

      vxdctl upgrade

 DESCRIPTION    [Toc]    [Back]
      The vxdctl utility manages aspects of the state of the volume
      configuration daemon, vxconfigd, and also manages aspects of
      configuration for bootstrapping the rootdg disk group.

      The volboot file forms a key element in managing the state of
      vxconfigd and bootstrapping the rootdg disk group.  This file contains
      a host ID that VERITAS Volume Manager (VxVM) uses to establish
      ownership of physical disks.  The host ID is used to ensure that two

                                    - 1 -       Formatted:  January 24, 2005

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

      or more hosts do not interfere with each other when accessing disks on
      a shared SCSI bus or Storage Area Network (SAN).  VxVM also uses host
      IDs to generate unique ID strings for stamping disks and disk groups.

      Note: The purpose of the cluster environment is to allow hosts that
      can access disks on a shared bus to do so in a coordinated way.  In
      this environment, the host ID is not used to prevent shared access;
      however, it is used for other internal functions.

      The volboot file also contains a list of disks to scan in search of
      the rootdg disk group. Unless at least one disk in this list is both
      readable and is part of the rootdg disk group, VxVM cannot start up

      vxconfigd operates in one of the following modes: enabled, disabled or

      The enabled state is the normal operating state.  Most configuration
      operations are allowed in this state.  Entering the enabled state
      imports all disk groups, and begins the management of device nodes
      stored in the /dev/vx/dsk and /dev/vx/rdsk directories.

      In the disabled state, vxconfigd does not retain configuration
      information for the imported disk groups, and does not maintain the
      volume device directories.  Most operations are disallowed in this
      state.  Certain failures, most commonly the loss of all disks or
      configuration copies in the rootdg disk group, cause vxconfigd to
      enter the disabled state automatically.

      The booted state is entered as part of normal system startup, prior to
      checking the root file system with fsck. Entering the booted mode
      imports the rootdg disk group, and then waits for a request to enter
      the enabled mode.  The volume device node directories are not
      maintained in booted mode, because it may not be possible to write to
      the root file system.

      The action performed by vxdctl depends upon the specified keyword

 KEYWORDS    [Toc]    [Back]
      add disk  Adds one of more disks specified by their disk access names
                to the list of disks in the volboot file.  (A disk access
                name identifies the physical address of the disk.) For
                example, to add disk 0 at SCSI target 1 on SCSI controller
                2, enter:

                     vxdctl add disk c2t1d0

                                    - 2 -       Formatted:  January 24, 2005

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

                This adds the disk c2t1d0.  If there is a disk access record
                in the rootdg configuration for the named disk,
                configuration parameters are taken from that record.
                Otherwise, it may be necessary to specify some attributes to
                vxdctl add disk.

                Requests that caching of device opens are enabled in the
                VxVM kernel module.

                At the VxVM configuration discovery time a disk device may
                be opened and closed multiple times. Depending on the disk
                array(s) being used, multiple opens of the same device could
                delay the startup time of the vxconfigd significantly. To
                minimize the delay in multiple opens, the first open of the
                device is cached and used for subsequent opens.

                When the machine is booting, the caching is automatically
                enabled to speed up the boot process. Once the machine has
                been booted, the caching is disabled via the VxVM startup

                If caching is enabled and the vxconfigd has been started and
                you do not plan to restart the vxconfigd or re-enable the
                VxVM configuration, then the device caching should be
                disabled by using the cachedisable.

                Request that caching of device opens are disabled and the
                currently cached devices are flushed from the VxVM kernel

                Request that any cached device open entries in the VxVM
                kernel module are flushed.

      disable   Requests that vxconfigd enter disabled mode.  This may be
                necessary to perform some maintenance operations.  This does
                not disable any configuration state loaded into the kernel.
                It only prevents further configuration changes to loaded
                disk groups until vxconfigd is re-enabled.

      enable    Requests that vxconfigd enter enabled mode, import all disk
                groups, and rebuild the volume device node directories.
                This operation can be used even if vxconfigd is already in
                enabled mode.  The primary purpose for using this operation
                when in enabled mode is to rebuild the volume device nodes.
                This operation causes vxconfigd to scan for any disks that
                were newly added since vxconfigd was last started.  In this
                manner, disks can be dynamically configured to the system
                and then recognized by VxVM.  If the multipathing support is

                                    - 3 -       Formatted:  January 24, 2005

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

                available, this option also causes vxconfigd to rebuild the
                DMP internal database to reflect the new state of the system
                after addition of the disk devices.  The new disk devices
                detected by vxconfigd are added in the DMP database with
                their associated subpaths and parent DMP device.

      hostid    Changes the host ID in the volboot file, and on all disks in
                disk groups currently imported on this machine.  It may be
                desirable to change the VxVM host ID for your machine if you
                change the network node name of your machine.

                If some disks are inaccessible at the time of a hostid
                operation, it may be necessary to use the vxdisk clearimport
                operation to clear out the old host ID on those disks when
                they become reaccessible.  Otherwise, you may not be able to
                re-add those disks to their disk groups.

                Note: Be careful when using this command.  If the system
                crashes before the hostid operation completes, some disk
                groups may not reimport automatically.

      init      Reinitializes the volboot file with a new host ID, an empty
                list of disks, and with the highest supported cluster
                protocol version.  If a hostid operand is specified, this
                string is used; otherwise, a default host ID is used.  The
                default host ID is normally taken as the network node name
                for the host (see uname(1M)).  On systems with a hardwaredefined
 system ID, the default host ID might be derived from
                this hardware ID.

      initdmp   Creates user level nodes for all DMP devices that the kernel
                has detected.  This removes all existing DMP nodes in the
                /dev/vx/[r]dmp directory, and creates fresh nodes for the
                DMP devices that have been detected.

      license [init]
                Without any arguments, the vxdctl license command prints the
                list of features which are currently available based on
                known licensing information.

                Note: If only a Base VxVM license is installed, the vxdctl
                license command displays "DMP (single path enabled)".  If
                either the Full VxVM license or an automatically generated
                license (such as that for the PHOTON array) is installed,
                the command displays "DMP (multipath enabled)".

                With the init argument specified, the vxdctl license init
                command requests that vxconfigd re-read any persistently
                stored license information.  If licenses have expired, this
                can make some features unavailable.  If new licenses were
                added, but are not yet recognized by vxconfigd, this command

                                    - 4 -       Formatted:  January 24, 2005

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

                forces vxconfigd to rescan the licenses, and to make the new
                licenses available.

      list      Lists the contents of the volboot file including the host
                ID, some sequence numbers, the cluster protocol version and
                a list of disks and disk attributes.

      mode      Prints the current operating mode of vxconfigd.  The output
                format is:

                     mode: operating_mode

                where operating_mode is one of enabled, disabled, booted, or

                If the -c flag is specified and vxconfigd is in the enabled
                mode, the clustered state of vxconfigd is displayed.  The
                output format is:

                     mode: enabled: clustered_state

                where clustered_state is one of cluster inactive, cluster
                active - role not set, cluster active - MASTER, cluster
                active - SLAVE.  This information is only available if the
                VxVM cluster feature is enabled.

                Print the cluster protocol range supported by the node.  The
                output format is:

                     minprotoversion: minimum protocol version, \
                     maxprotoversion: maximum protocol version

                Prints the current cluster protocol version of the node.
                The output format is:

                     cluster running at protocol protocolversion

                The protocolversion is a value in the range listed by vxdctl
                protocolrange.  This information is only available if the
                VxVM cluster feature is enabled.

      rm disk   Removes one or more disks from the volboot file.  Disks are
                specified based on the name used in the corresponding vxdctl
                add disk operation.

                                    - 5 -       Formatted:  January 24, 2005

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

      support   Displays information about the versions of VxVM objects and
                components that are supported by the configuration daemon
                that is currently running.  Versions are printed as colonseparated
 name/value pairs:

                vxconfigd_vrsn        Version of vxconfigd that is currently

                dg_minimum            Lowest disk group version supported by

                dg_maximum            Highest disk group version supported
                                      by vxconfigd.

                kernel                Highest kernel version supported by

                protocol_minimum      Lowest cluster protocol version
                                      supported by the node.

                protocol_maximum      Highest cluster protocol version
                                      supported by the node.

                protocol_current      Cluster protocol version currently
                                      running on the node.

                The protocol version information is only meaningful for the
                VxVM cluster feature.

      stop      Requests that vxconfigd exit.  This may be necessary to
                reset VxVM, such as when the -r reset option is specified to
                vxconfigd.  This command does not disable any configuration
                state that is loaded into the kernel.  It only affects the
                ability to make configuration changes until vxconfigd is
                restarted.  If the -k option is used, vxconfigd is stopped
                by sending it a SIGKILL signal. The command pauses for up to
                one second to verify that vxconfigd has exited. It returns
                an error if vxconfigd has not exited after one second's
                delay has elapsed.

      upgrade   Requests that the cluster be upgraded to the highest cluster
                protocol possible. This is only available if the VxVM
                cluster feature is enabled.

 FILES    [Toc]    [Back]

 SEE ALSO    [Toc]    [Back]
      fsck(1M), signal(5), uname(1M), vxconfigd(1M), vxdg(1M), vxdisk(1M),
      vxdmp(7), vxintro(1M), vxlicinst(1), vxlicrep(1)

                                    - 6 -       Formatted:  January 24, 2005
[ Back ]
 Similar pages
Name OS Title
vxconfigd HP-UX VERITAS Volume Manager configuration daemon
voldctl Tru64 Controls the Logical Storage Manager volume configuration daemon
vxiod HP-UX VERITAS Volume Manager I/O daemon process control device
gated.control Tru64 Gate daemon configuration file (control statements)
vxvmboot HP-UX prepare VERITAS Volume Manager volume as a root, boot, primary swap or dump volume
vxconfig HP-UX VERITAS Volume Manager configuration device
vxnotify HP-UX display VERITAS Volume Manager configuration events
vxprint HP-UX display records from the VERITAS Volume Manager configuration
vxmake HP-UX create VERITAS Volume Manager configuration records
vximportdg HP-UX import a disk group into the VERITAS Volume Manager configuration
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service