B.3 dstutil

Use the Dynamic Storage Technology Utility (dstutil) command for managing and configuring basic DST operations. For Linux, make sure you are logged in as the root user or equivalent in the terminal console.

NOTE: Service operations for dstutil are not supported on CIS volumes.

B.3.1 Command Operations

Parameters	Description
dstutil -c	Create a DST shadow volume pair.
dstutil -u	Unbind the volume from NCP. NOTE:This command is not supported for cluster volume.
dstutil -b	Bind the volume with NCP. NOTE:This command is not supported for cluster volume.
dstutil -r	Remove the DST shadow volume pair.
dstutil -M	Move all files from secondary to primary volume.
dstutil -m	Move all files from primary to secondary volume.
dstutil -L	Display the progress of file movement from secondary to primary volume.
dstutil -l	Display the progress of file movement from primary to secondary volume.
dstutil -R	Replicate the metadata from source to target volume.
dstutil -v	Display the program version information.
dstutil -h	Display the help screen.

B.3.2 Command Options

Options	Description
-s, --secondary-volume	Enter the name of secondary volume.
-t, --target-volume	Enter the name of target volume.
-U, --username	Enter username. If you do not provide a username, the system will prompt you to enter a username.
-P, --password	Enter password. If you do not provide a password, the system will prompt you to enter a password.

B.3.3 Examples for Local Volumes

dstutil -c VOL1 -s VOL2

This command creates DST shadow volume pair where VOL1 is the primary volume and VOL2 is the secondary volume.

dstutil -u VOL

This command unbinds NSS volume VOL from NCP.

dstutil -r VOL1

This command removes DST shadow pair VOL1.

dstutil -b VOL

This command binds an NSS volume VOL to NCP.

dstutil -M VOL1

This command moves all files from secondary volume VOL2 to primary volume VOL1.

dstutil -m VOL1

This command moves all files from primary volume VOL1 to secondary volume VOL2.

dstutil -L VOL1

This command allows you to view the progress of file moving from secondary volume VOL2 to primary volume VOL1

dstutil -l VOL1

This command allows you to view the progress of data moving from primary volume VOL1 to secondary volume VOL2.

dstutil -R VOL1 -t VOL2 -U username -P password

This command replicates the directory structure and metadata between source VOL1 and target volume VOL2.

Note: This command does not work for existing DST shadow volume pairs.

B.3.4 Examples for Cluster Volumes

dstutil -c CVOL1 -s CVOL2

This command creates DST shadow volume pair where CVOL1 is the primary volume and CVOL2 is the secondary volume.

This will update cluster scripts for Primary resource
      
      We have modified the cluster resource scripts of POOL1_SERVER by borrowing from the resource
      scripts of POOL2_SERVER.

      Before Modification Load Script for resource POOL1_SERVER:
      #!/bin/bash
      . /opt/novell/ncs/lib/ncsfuncs
      exit_on_error nss /poolact=POOL1
      exit_on_error ncpcon mount CVOL1=254
      exit_on_error add_secondary_ipaddress 10.10.10.41
      exit_on_error ncpcon bind --ncpservername=cluster-POOL1-SERVER --ipaddress=10.10.10.41
      exit_on_error novcifs --add '--vserver=".cn=cluster-POOL1-SERVER.o=opentext.t=OT-TREE."' --ip-addr=10.10.10.41
      exit 0

      After Modification Load Script for resource POOL1_SERVER:
      #!/bin/bash
      . /opt/novell/ncs/lib/ncsfuncs
      exit_on_error nss /poolact=POOL2
      exit_on_error nss /poolact=POOL1
      exit_on_error ncpcon mount CVOL1=254,shadowvolume=CVOL2
      exit_on_error add_secondary_ipaddress 10.10.10.42
      exit_on_error ncpcon bind --ncpservername=cluster-POOL2-SERVER --ipaddress=10.10.10.42
      exit_on_error novcifs --add '--vserver=".cn=cluster-POOL2-SERVER.o=opentext.t=OT-TREE."' --ip-addr=10.10.10.42
      exit_on_error add_secondary_ipaddress 10.10.10.41
      exit_on_error ncpcon bind --ncpservername=cluster-POOL1-SERVER --ipaddress=10.10.10.41
      exit_on_error novcifs --add '--vserver=".cn=cluster-POOL1-SERVER.o=opentext.t=OT-TREE."' --ip-addr=10.10.10.41
      exit 0

      Before Modification Unload Script for resource POOL1_SERVER:
      #!/bin/bash
      . /opt/novell/ncs/lib/ncsfuncs
      ignore_error novcifs --remove '--vserver=".cn=cluster-POOL1-SERVER.o=opentext.t=OT-TREE."' --ip-addr=10.10.10.41
      ignore_error ncpcon unbind --ncpservername=cluster-POOL1-SERVER --ipaddress=10.10.10.41
      ignore_error del_secondary_ipaddress 10.10.10.41
      ignore_error nss /pooldeact=POOL1
      exit 0

      After Modification Unload Script for resource POOL1_SERVER:
      #!/bin/bash
      . /opt/novell/ncs/lib/ncsfuncs
      ignore_error novcifs --remove '--vserver=".cn=cluster-POOL1-SERVER.o=opentext.t=OT-TREE."' --ip-addr=10.10.10.41
      ignore_error ncpcon unbind --ncpservername=cluster-POOL1-SERVER --ipaddress=10.10.10.41
      ignore_error del_secondary_ipaddress 10.10.10.41
      ignore_error novcifs --remove '--vserver=".cn=cluster-POOL2-SERVER.o=opentext.t=OT-TREE."' --ip-addr=10.10.10.42
      ignore_error ncpcon unbind --ncpservername=cluster-POOL2-SERVER --ipaddress=10.10.10.42
      ignore_error del_secondary_ipaddress 10.10.10.42
      ignore_error nss /pooldeact=POOL1
      ignore_error nss /pooldeact=POOL2
      exit 0

      Before Modification Monitor Script for resource POOL1_SERVER:
      #!/bin/bash
      . /opt/novell/ncs/lib/ncsfuncs
      exit_on_error status_fs /dev/pool/POOL1 /opt/novell/nss/mnt/.pools/POOL1 nsspool
      exit_on_error status_secondary_ipaddress 10.10.10.41
      exit_on_error rcnovell-cifs monitor
      exit 0

      After Modification Monitor Script for resource POOL1_SERVER:
      #!/bin/bash
      . /opt/novell/ncs/lib/ncsfuncs
      exit_on_error status_fs /dev/pool/POOL1 /opt/novell/nss/mnt/.pools/POOL1 nsspool
      exit_on_error status_fs /dev/pool/POOL2 /opt/novell/nss/mnt/.pools/POOL2 nsspool
      exit_on_error status_secondary_ipaddress 10.10.10.42
      exit_on_error status_secondary_ipaddress 10.10.10.41
      exit_on_error rcnovell-cifs monitor
      exit 0

      Modify the scripts at /var/opt/novell/nss/._NSSDataMigration/modifiedResourceScripts to include
      any other commands from the corresponding scripts of POOL2_SERVER.

      Enter "continue" to proceed after reviewing/modifying the script(s)
      or enter "discard" to discard the changes and abort the operation:continue
      Successfully created the DST shadow volume with C32 as primary volume and C64 as secondary volume.

dstutil -r CVOL1

This command removes DST shadow pair CVOL1.

      We have modified the cluster resource scripts of POOL1_SERVER.
      
      Before Modification Load Script for resource POOL1_SERVER:
      #!/bin/bash
      . /opt/novell/ncs/lib/ncsfuncs
      exit_on_error nss /poolact=POOL2
      exit_on_error nss /poolact=POOL1
      exit_on_error ncpcon mount CVOL1=254,shadowvolume=CVOL2
      exit_on_error add_secondary_ipaddress 10.10.10.42
      exit_on_error ncpcon bind --ncpservername=cluster-POOL2-SERVER --ipaddress=10.10.10.42
      exit_on_error novcifs --add '--vserver=".cn=cluster-POOL2-SERVER.o=opentext.t=OT-TREE."' --ip-addr=10.10.10.42
      exit_on_error add_secondary_ipaddress 10.10.10.41
      exit_on_error ncpcon bind --ncpservername=cluster-POOL1-SERVER --ipaddress=10.10.10.41
      exit_on_error novcifs --add '--vserver=".cn=cluster-POOL1-SERVER.o=opentext.t=OT-TREE."' --ip-addr=10.10.10.41
      exit 0

      After Modification Load Script for resource POOL1_SERVER:
      #!/bin/bash
      . /opt/novell/ncs/lib/ncsfuncs
      exit_on_error nss /poolact=POOL1
      exit_on_error ncpcon mount CVOL1=254
      exit_on_error add_secondary_ipaddress 10.10.10.41
      exit_on_error ncpcon bind --ncpservername=cluster-POOL1-SERVER --ipaddress=10.10.10.41
      exit_on_error novcifs --add '--vserver=".cn=cluster-POOL1-SERVER.o=opentext.t=OT-TREE."' --ip-addr=10.10.10.41
      exit 0

      Before Modification Unload Script for resource POOL1_SERVER:
      #!/bin/bash
      . /opt/novell/ncs/lib/ncsfuncs
      ignore_error novcifs --remove '--vserver=".cn=cluster-POOL1-SERVER.o=opentext.t=OT-TREE."' --ip-addr=10.10.10.41
      ignore_error ncpcon unbind --ncpservername=cluster-POOL1-SERVER --ipaddress=10.10.10.41
      ignore_error del_secondary_ipaddress 10.10.10.41
      ignore_error novcifs --remove '--vserver=".cn=cluster-POOL2-SERVER.o=opentext.t=OT-TREE."' --ip-addr=10.10.10.42
      ignore_error ncpcon unbind --ncpservername=cluster-POOL2-SERVER --ipaddress=10.10.10.42
      ignore_error del_secondary_ipaddress 10.10.10.42
      ignore_error nss /pooldeact=POOL1
      ignore_error nss /pooldeact=POOL2
      exit 0

      After Modification Unload Script for resource POOL1_SERVER:
      #!/bin/bash
      . /opt/novell/ncs/lib/ncsfuncs
      ignore_error novcifs --remove '--vserver=".cn=cluster-POOL1-SERVER.o=opentext.t=OT-TREE."' --ip-addr=10.10.10.41
      ignore_error ncpcon unbind --ncpservername=cluster-POOL1-SERVER --ipaddress=10.10.10.41
      ignore_error del_secondary_ipaddress 10.10.10.41
      ignore_error nss /pooldeact=POOL1
      exit 0

      Before Modification Monitor Script for resource POOL1_SERVER:
      #!/bin/bash
      . /opt/novell/ncs/lib/ncsfuncs
      exit_on_error status_fs /dev/pool/POOL1 /opt/novell/nss/mnt/.pools/POOL1 nsspool
      exit_on_error status_fs /dev/pool/POOL2 /opt/novell/nss/mnt/.pools/POOL2 nsspool
      exit_on_error status_secondary_ipaddress 10.10.10.42
      exit_on_error status_secondary_ipaddress 10.10.10.41
      exit_on_error ncpcon volume CVOL1
      exit_on_error rcnovell-cifs monitor
      exit 0

      After Modification Monitor Script for resource POOL1_SERVER:
      #!/bin/bash
      . /opt/novell/ncs/lib/ncsfuncs
      exit_on_error status_fs /dev/pool/POOL1 /opt/novell/nss/mnt/.pools/POOL1 nsspool
      exit_on_error status_secondary_ipaddress 10.10.10.41
      exit_on_error ncpcon volume CVOL1
      exit_on_error rcnovell-cifs monitor
      exit 0

      Modify the scripts at /var/opt/novell/nss/._NSSDataMigration/modifiedResourceScripts to remove
      any other commands.

      Enter "continue" to proceed after reviewing/modifying the script(s)
      or enter "discard" to discard the changes and abort the operation:continue
      Successfully removed the shadow volume "CVOL1"