SYNOPSIS
sdxconfig Backup -c class[-o outfile] [-e update]
sdxconfig Convert -e remove[,update] -c class -d disk,... [-i infile] [-o outfile]
sdxconfig Convert -e remove[,update] -c class -g group,... [-i infile] [-o outfile]
sdxconfig Convert -e rename[,update] -c class=classname [-i infile] [-o outfile]
sdxconfig Convert -e replace[,update] -c class -d disk=device[,disk=device,...] [-i infile] [-o outfile]
sdxconfig Convert -e replace[,update] -c class
-p device=newdevice[,device=newdevice,...]
[-i infile] [-o outfile]sdxconfig Remove -c class[-e keepid]sdxconfig Restore -c class -i infile [-e chkps|mklabel,skipsync]
DESCRIPTION
Use sdxconfig to perform object configuration operations for classes specified by class (excluding shadow classes). The sdxconfig command can be executed with superuser access privileges only.
This command must be executed in multi-user mode.
PRIMARY OPTIONS
You have a choice of the following options.
Outputs the object configuration of a local class or a shared class specified by class to a file specified by outfile (standard output by default) in configuration table format. Specify the class name targeted for configuration table creation for class.
If class includes switch groups, proxy objects, DISABLE disks, or TEMP slices, creation of the class configuration table fails.
Converts the configuration table of a class specified by class according to sub option specifications. Specify the class name contained in the configuration table for class.
Removes the object configuration of a local class specified by class from the system. All objects (volumes, groups and disks) within the class are removed. Specify the target local class name for class.
Even if the class object configuration is removed using this option, contents (data) of the removed volumes are not lost. By restoring the object configuration with the Restore option, the volume configuration and contents can be restored.
If class includes proxy objects, ACTIVE volumes, or TEMP or COPY slices, deletion of the class fails.
Restores the object configuration of a class specified by class according to the configuration table declared in a configuration file specified by infile. Specify the class name contained in the configuration table for class.
Even if the class object configuration is restored with this option, volume areas on the physical disks registered with the class are not initialized. After the object configuration is deleted with the Remove option, by restoring the object configuration using this option, the volume configuration and contents can be restored.
Do not execute the command if there is a closed class or a disk in SWAP status in the cluster domain.
However, if the configuration table contains mirror volumes with the mirroring multiplicity of two or higher, after returning from the sdxconfig command, synchronization copying of the mirror volumes is performed automatically (excepting when using -e skipsync). In this event, destination slices are overwritten with data of source slices automatically selected, and data previously saved on the destination slices will be lost.
The class specified by class will be restored as a local class on the current node. To restore the class as a shared class, after this command execution it is necessary to change the type attribute and scope attribute of the class using the sdxattr -C command. Also, to restore the shared class registered in the cluster application, after this command execution it is necessary to reboot the node where this command was executed.
If the class specified by class already exists, this command results in an error. Additionally, if the physical disk size contained in the configuration table and the actual physical disk size do not match, restoration of the class object configuration fails.
For a cluster system, it is necessary to register the physical disk contained in the configuration table with the resource database of the cluster system before executing this option.
Note
The device number (the minor number) of the restored volume, and the owner and the access permission of a device special file of the volume cannot be restored to the same value as the time of executing the Backup option. It will be the same value as the case where a new volume is created with the sdxvolume -M command. The device number, the owner and the access permission can be checked with the following command:
# ls -l /dev/sfdsk/class_name/dsk/volume_name |
If the device number at the time of executing the Backup option is set to the application which uses the restored volume, you need to modify the application configuration.
For restoration of the ownership and access permission of the device special file, change the settings by using the chown(1) command or the chmod(1) command.
The settings of the I/O Response Time Assurance Function are not restored. If setting the I/O Response Time Assurance Function, set it by executing the sdxattr command after executing the Restore option.
Configurations that include concatenation groups or stripe groups cannot be restored. Remove concatenation groups and stripe groups from the configuration table with the sdxconfig Convert command.
SUB OPTIONS
Sub options are as follows.
class indicates the target class name.
Changes the class name in the configuration table from class to classname.
Removes disk,... from the configuration table. Specify the disk name of an undefined disk, a spare disk, a single disk, or a disk directly connected to a mirror group to be removed for disk.
If disk is a single disk, volumes and slices within the disk are also removed. If disk is the only disk connected to a mirror group, volumes and slices in the mirror group and the mirror group itself are also removed.
This option can be used along with the -g option.
If disk is connected to a concatenation group or a stripe group in the configuration table, removing the disk fails.
Changes the physical disk of a disk specified by disk to device in the configuration table. device can also indicate a physical disk not connected to the domain.
Specify a disk name for disk and a physical disk name for device. It is necessary to separate disk and device with an equal sign (=). To change multiple physical disks, specify sets of these specifiers in comma-delimited format.
The physical disk names can be specified in one of the following formats.
sdX (for normal hard disks) mpathX (for mpath devices of DM-MP) emcpowerX (for emcpower disks) vdX (for virtual disks on a KVM guest)
X indicates the device identifier.
This option cannot be used along with the -p option.
Checks consistency of disk identification information (class and disk names) stored in the private slices of physical disks to be registered with class and the configuration table contained in the configuration file specified by infile.
Restoration of class does not take place if any of the following conditions is not satisfied.
All physical disks contained in the configuration table have the private slices.
The sizes of the private slices match between all physical disks contained in the configuration table.
The class names stored in the private slices match between all physical disks contained in the configuration table.
For all physical disks contained in the configuration table, the disk names stored in the private slices match the disk names assigned to the physical disks in the configuration table.
If a class name class is stored in the private slices of physical disks which are not contained in the configuration table, do not specify this option.
This option cannot be used along with the -e mklabel option.
Information
The following are examples of when the -e chkps option is required or not required when executing the sdxconfig Restore command.
The -e chkps option is required
When specifying the -e keepid option in the sdxconfig Remove command
When the data is copied per LUN from the migration source storage to the migration destination storage
The -e chkps option is not required
When not specifying the -e keepid option in the sdxconfig Remove command
When executing the sdxconfig Restore command for a disk where only volume areas on the physical disks are copied
Deletes object configuration information of class while retaining the private slices and disk identification information stored in the private slices of all disks registered with class.
By using this option, when class is restored using physical disks that were removed from the class or that were copied with the copy functions of disk units, configuration consistency can be checked with the -e chkps option of the sdxconfig Restore command.
Note
If the object configuration of class is deleted with this option, physical disks that were deleted from the class cannot be registered with a class with the sdxdisk -M command. Before registering those deleted physical disks with a class with the sdxdisk -M command, restore the object configuration using the Restore option once, and then execute the Remove option again without this option.
If the following two disk label types; a disk label type of a physical disk which will be registered with class, and a disk label type of a class which described in a configuration table of specified configuration file by infile, are different, change the physical disk label type to the disk label type of the class described in the configuration table.
When this option is used, it is not ensured for data in volume area on the physical disk registered with the class.
This option cannot be used along with the -e chkps option.
Removes disks or groups from the configuration table.
Renames the class of the configuration table.
Changes physical disks in the configuration table.
Leaves synchronization copying of mirror volumes created within class undone, assuming that equivalency of all mirror volumes contained in the configuration file specified by infile is ensured on user's hand. Even if slices are nonequivalent, their statuses will not be in INVALID.
Overwrites the file specified by outfile with the configuration table when the outfile is an existing file.
Removes group,... from the configuration table. All objects (volumes, slices, disks, lower level groups) within the group are deleted. Specify the deleted group name for group.
This option can be used along with the -d option.
When group is connected to a higher level group other than a mirror group in the configuration table, removing group fails.
Converts the configuration table or restores the object configuration of a class specified by class according to the configuration file specified by infile. Specify the path to a configuration file for infile, using the absolute path name or the relative path name from the current directory.
When using Convert, it is not required to specify this option. By default, a configuration table from standard input is converted.
Sends the created or converted configuration table to a configuration file specified by outfile. Specify the path to a configuration file for outfile, using the absolute path or the relative path from the current directory.
If the file specified by outfile already exists, this command results in an error (excepting when using -e update).
By default, the configuration table is output to standard output.
Changes the physical disk specified by device to another physical disk specified by newdevice in the configuration table. newdevice can also indicates a physical disk not connected to the domain.
Specify a physical disk name described in the configuration table for device and a new physical disk name for newdevice. It is necessary to separate device and newdevice with the equal sign (=). To change multiple physical disks to new disks, specify sets of these specifiers in comma-delimited format.
The physical disk names for device and newdevice can be specified in one of the following formats.
sdX (for normal hard disks) mpathX (for mpath devices of DM-MP) emcpowerX (for emcpower disks) vdX (for virtual disks on a KVM guest)
X indicates the device identifier.
This option cannot be used along with the -d option.
RETURNED VALUE
Upon successful completion, a value of 0 is returned.
Otherwise, a non-zero value is returned.