SYNOPSIS
sdxroot -M -c class -d disk[,disk,...]
sdxroot -R -c class -d disk[,disk,...]
DESCRIPTION
Use sdxroot to complete or cancel mirroring definition of system disks including root file systems through a UFS boot environment. The "sdxroot" command can be executed with superuser access privileges only.
System disk means the physical disk on which the running Solaris is installed. Specifically, it means the entire disk that includes a slice currently running as any one of the following file systems (or a swap area).
/, /usr, /var, or swap
PRIMARY OPTIONS
You can use one of the following options.
Make
Checks that one or more system disks specified by disk are ready for mirroring (registered with a class and connected to a group) and creates remaining mirroring definitions (such as updates of files /etc/vfstab and /etc/system). After returning from this command, reboot the system immediately. After the system is rebooted, system disk mirroring will commence.
Specify a disk that includes a slice currently running as /(root), /usr, and /var or a swap area for disk. Among /(root), /usr, and /var, and swap areas, although it is not required to specify disks with swap areas only, be sure to specify disks with /(root), /usr, and /var. Additionally, the disk specified by disk must be ready for mirroring (registered with a class and connected to a group).
When synchronization copying is being performed in groups to which the system disks are connected, the sdxroot command results in an error. In this situation, cancel the synchronization copying using the sdxcopy -C command, or execute this command after the synchronization copying is completed.
Remove
Checks that one or more system disks specified by disk are ready for mirroring cancellation (disks are disconnected from the system disk's groups and only one system disk is connected to each group) and creates remaining mirroring cancellation definitions (such as update of the /etc/vfstab, /etc/system file). After returning from this command, reboot the system immediately. After the system is rebooted, system disk mirroring will be cancelled.
To totally cancel system disk management with GDS, after the system is rebooted, it is necessary to delete system disk related volumes, groups, disks, and classes.
Specify a disk that includes a slice currently running as /(root), /usr, and /var, or a swap area for disk. The disk specified by disk must be ready for mirroring cancellation (disks are disconnected from the system disk's groups and only one system disk is connected to each group).
SUB OPTIONS
Sub options are as follows:
class indicates the class name to which disk belongs.
disk indicates a target disk. When connecting multiple disks, the disk names should be combined using commas (,).
RETURNED VALUE
Upon successful completion, a value of 0 is returned.
Otherwise, a non-zero value is returned.
USAGE EXAMPLES
Assuming the disk on which /(root), /usr, and /var are installed and the disk allocated as a swap area are different, examples of the procedures for system disk mirroring and system disk mirroring cancellation through a UFS boot environment are given below.
Procedure for system disk mirroring through a UFS boot environment
Stop the running application programs.
In order to ensure mirroring definition, all the running application programs must be stopped. For the mirroring definition to be in effect, the system must be rebooted after going through this procedure.
When higher safety is required, create system disk backups.
Register the system disks with the root class.
In this example, the installation disk of /(root), /usr, and /var is "c0t0d0," and the disk allocated as a swap area is "c0t0d1."
# sdxdisk -M -c System -a type=root -d c0t0d0=Root1:keep, c1t0d0=Root2:undef,c0t0d1=Swap1:keep,c1t0d1=Swap2:undef |
Connect the system disks to a group.
# sdxdisk -C -c System -g Group1 -d Root1,Root2 -v 0=root:on,1=usr:on,3=var:on,4=home:on,5=opt:on # sdxdisk -C -c System -g Group2 -d Swap1,Swap2 -v 0=swap:on |
Information
When System Disks Have Unopen Physical Slices
After returning from the sdxdisk -C command, volumes created for unopen physical slices are started, and synchronization copying is performed. In this event, cancel the synchronization copying using the sdxcopy -C command, or after the synchronization copying is completed move to step 4. Physical slices on which file systems are mounted and those accessed as raw devices are considered to be open. Physical slices may not be opened if they are not shown with the mount(1M) command and if process IDs are not shown with the fuser(1M) command.
heck that mirroring definition is completed.
# sdxroot -M -c System -d Root1,Swap1 |
Reboot the system.
# shutdown -y -g0 -i6 |
Check that mirroring is in effect.
Using the mount command and the sdxinfo command, make sure that the system disks have been mirrored properly.
Procedure for system disk mirroring cancellation through a UFS boot environment
Stop the running application programs.
In order to ensure mirroring cancellation, all the running application programs must be stopped. For the mirroring cancellation to be in effect, the system must be rebooted after going through this procedure.
When higher safety is required, create system disk backups.
Disconnect disks other than those used as system disks after this cancellation from the groups.
# sdxdisk -D -c System -g Group1 -d Root2 # sdxdisk -D -c System -g Group2 -d Swap2 |
Check that mirroring cancellation is completed.
# sdxroot -R -c System -d Root1,Swap1 |
Reboot the system.
# shutdown -y -g0 -i6 |
Check that the mirroring has been cancelled.
Using the mount command and the sdxinfo command, make sure that the system disk mirroring has been cancelled properly.
Cancel system disk management.
# sdxvolume -F -c System -v root # sdxvolume -F -c System -v usr # sdxvolume -F -c System -v var # sdxvolume -F -c System -v home # sdxvolume -F -c System -v opt # sdxvolume -F -c System -v swap # sdxvolume -R -c System -v root # sdxvolume -R -c System -v usr # sdxvolume -R -c System -v var # sdxvolume -R -c System -v home # sdxvolume -R -c System -v opt # sdxvolume -R -c System -v swap # sdxgroup -R -c System -g Group1 # sdxgroup -R -c System -g Group2 # sdxdisk -R -c System -d Root1 # sdxdisk -R -c System -d Root2 # sdxdisk -R -c System -d Swap1 # sdxdisk -R -c System -d Swap2 |
