1. Manuals
  2. Brands
  3. NEC Manuals
  4. Software
  5. Storage Manager
  6. Reference

NEC Storage Manager Reference

Data replication command
Hide thumbs Also See for Storage Manager:
Table of Contents

Advertisement

Quick Links

See also: User Manual
NEC Storage Manager
Data Replication
Command Reference

Advertisement

Table of Contents
loading

Related Manuals for NEC Storage Manager

Summary of Contents for NEC Storage Manager

  • Page 1 NEC Storage Manager Data Replication Command Reference...
  • Page 2 © NEC Corporation 2001-2003 No part of the contents of this book may be reproduced or transmitted in any form without permission of NEC Corporation. The contents of this book may be modified without notice in the future.
  • Page 3 Subsystems (hereinafter may be referred to as disk array), and software, which is responsible for the management and operation. The data replication function increases operation efficiency using replication volumes. Refer to the “NEC Storage Manager Manual Guide” (IS901) for the overview of NEC Storage Manager and the related manuals.
  • Page 4 Solaris is a registered trademark of Sun Microsystems, Inc. in the United States. Linux is a trademark or registered trademark of Mr. Linus Torvalds in the United States and other countries. AIX is a trademark of IBM Corporation. Other product names and company names, etc. are registered trademarks or trademarks of the associated companies.

  • Page 5: Table Of Contents

    Contents Chapter 1 Overview ................................1 Command List................................1 Volume Types ................................3 Replication Operation File............................4 Database Operation File.............................. 7 Chapter 2 Command Reference............................11 Volume List Creation/Display ..........................11 2.1.1 iSMvollist (Windows)............................11 2.1.2 iSMvollist (UNIX) ............................15 Replication Operations..............................

  • Page 6: Chapter 1 Overview

    The following is a list of data replication related commands described in this document. The description of “UNIX” that appears in this document indicates all the UNIX systems, such as HP UX version, Solaris version, etc., which the NEC Storage ReplicationControl supports. Table 1 1 Command List...
  • Page 7 (1) Commands from No.1 to No.15 can be used after the NEC Storage ReplicationControl has been installed. (2) Commands from No.16 to No.17 can be used after the NEC Storage ReplicationControl SQL Option has been installed. (3) On the Windows system, those commands can be operated only by a user who belongs to the Administrators group.

  • Page 8: Volume Types

    LVM volume group or a VxVM disk group. (6) To operate together with the replication management (controlling the issuance of I/O to disk arrays via the NEC Storage Manager), an applicable volume type is a logical disk name only.

  • Page 9: Replication Operation File

    Chapter 1 Overview To perform batch setting of paired volumes by a data replication command with the -file option, use the replication operation file. The replication operation file is described below. [ FILE LOCATION AND NAME ] Can be freely specified. [ DESCRIPTION ] The replication operation file is used to perform batch setting of multiple pairs by using a data replication command.
  • Page 10 Chapter 1 Overview...
  • Page 11 Chapter 1 Overview Specifying a volume (MV, RV) Specify the name of the target volume that has an attribute specified as a volume type. The maximum number of characters is as follows: Table 1-4 Specifying a Volume Maximum number of Target volume characters Logical disk name...
  • Page 12 Chapter 1 Overview The following is an example of a description of the replication operation file: An example for the Windows system #Type:MV Type:RV ld:dev000 ld:dev001 drv:E drv:F ld:dev006 drv:G drv:H ld:dev007 # Parallel configuration ld:dev002 ld:dev003 ld:dev002 ld:dev004 # MV:RV=1:1 ld:dev005 An example for the UNIX system #Type:MV...

  • Page 13: Database Operation File

    [ FILE LOCATION AND NAME ] Can be freely specified. [ DESCRIPTION ] The database operation file is used to perform batch setting of multiple databases by using a NEC Storage ReplicationControl SQL Option command. [ SYNOPSYS ] This file is described in the following synopsis: db:db_name [ Option_Type:[value] ] [...]...
  • Page 14 Chapter 1 Overview Specifying an option type (Option_Type) and a preset value (value) The following character strings can be specified as an option type. Table 1-5 Specifying an Option Type and Preset Value Option type Description Specify a user ID for connecting to the Microsoft SQL Server 2000. Specifies a password for the user ID for connecting to the Microsoft SQL pass Server 2000.
  • Page 15 Chapter 1 Overview not have a preset value. This option and the uid and pass options cannot be simultaneously specified. Specify a computer name and an instance name in the following server:instance_name format when connecting to a named instance. computer_name\instance_name If this option is omitted, a connection is made to the predetermined instance.
  • Page 16 Chapter 1 Overview Rules Start description from the first column of the line. A line break shall be a partition of records. Up to 1,024 single-byte characters can be described per record. Information of one database can be described per record. The same option type cannot be specified twice per record.

  • Page 17: Chapter 2 Command Reference

    Chapter 2 Command Reference Chapter 2 Command Reference [ NAME ] iSMvollist - Creates and displays the table of logical disks and related information. [ SYNOPSIS ] iSMvollist -cr iSMvollist -a iSMvollist -al ld_number iSMvollist -ae ld_name iSMvollist -ad [drive | path] iSMvollist -ap disk_number iSMvollist -ah HBT [LUN] iSMvollist -av volume_name...
  • Page 18 Chapter 2 Command Reference OPTIONS The iSMvollist command recognizes the following options and arguments. Scans the devices connected to the host, and creates or updates the volume information of the target devices. When disk arrays are added or deleted, and when logical disks are bound or unbound, you must perform this command to re-create the Volume List.
  • Page 19 Chapter 2 Command Reference -de disk_array [ld_name] Displays the relations for the disk arrays specified by disk_array, sorted by the logical disk name as the key. If ld_name is specified, it displays the relations only for the specified logical disk name. -dd disk_array [drive | path] Displays the relations for the disk arrays specified by disk_array, sorted by the drive letters or path name as the key.
  • Page 20 Chapter 2 Command Reference Description of messages: Logical disk number Logical disk name LD Name Volume Absolute Address Type of operating system OS Type Host adapter number, bus number, target ID LUN (Logical unit number) Physical disk number Disk No. Disk array name Disk Array Mount point volume name...
  • Page 21 Chapter 2 Command Reference [ NAME ] iSMvollist - Creates and displays the list of logical disks and related information. [ SYNOPSIS ] iSMvollist -d iSMvollist -vs Disk Array Name [Special File] iSMvollist -vl Disk Array Name [LDN] iSMvollist -ve Disk Array Name [LD Name] iSMvollist -l [Special File | LD Name] iSMvollist -r iSMvollist -help...
  • Page 22 Chapter 2 Command Reference -ve Disk Array Name [LD Name] Displays the relations for the disk arrays specified by Disk Array Name, sorted by the logical disk name as the key. If LD Name is specified, the relation only for the specified logical disk name is displayed.
  • Page 23 Chapter 2 Command Reference Unavailable: ‘B’ is displayed [ USAGE ] This command creates the volume list. # iSMvollist -r iSMvollist: Info: iSM11700: Please wait a minute. iSMvollist: Info: iSM11100: Command has completed successfully. This command displays volume list information by specifying the special file. # iSMvollist -l /dev/rdsk/c1t2d0 LD NAME TYPE...
  • Page 24 Chapter 2 Command Reference [ NAME ] iSMrc_replicate - Starts copy from MV to RV. [ SYNOPSIS ] iSMrc_replicate -mv volume -mvflg mv_flg [-rv volume -rvflg rv_flg] [-cprange copy_range] [-cpmode copy_mode] [-rvacc rv_access] [-wait [second] | -nowait] iSMrc_replicate -file file_name [-cprange copy_range] [-cpmode copy_mode] [-rvacc rv_access] [-wait [second] | -nowait] iSMrc_replicate...
  • Page 25 Chapter 2 Command Reference -rvflg rv_flg Specify the volume type specified in -rv. This argument must be specified if -rv is specified. For information about the volume and volume types, refer to 1.2 “Volume Types”. -cprange copy_range Specify the range of copy from MV to RV. In copy_range, one of the following can be specified.
  • Page 26 Chapter 2 Command Reference -file file_name To specify multiple pairs, describe the pairs of MV/RV in file_name. The copy operation instruction is specified in the argument. If multiple pairs are specified, a copy request is issued to the pairs simultaneously, and the operation instruction is reflected to all the pairs.

  • Page 27: Ismrc_Replicate

    Chapter 2 Command Reference RV:disk_number ld_name type volume name path MV/RV physical disk number, logical disk name, OS type, mount point volume name, and drive letters or path name mounted to the folder of the NTFS volume accessed by users Replicating..
  • Page 28 Chapter 2 Command Reference On the UNIX system When the command terminates normally with the -wait specification, the following information is displayed. (Individual specification) # iSMrc_replicate -mv special_file_name -mvflg sfn -rv special_file_name -rvflg sfn -wait 2 Replicate Start YYYY/MM/DD hh:mm:ss MV:special_file_name LD Name type...
  • Page 29 Chapter 2 Command Reference iSMrc_replicate: Error : iSM13663 : The processing of waiting has terminated because "separate diff" or "copy diff" does not decrease in the specified time. (30 sec) Replicate Abnormal End YYYY/MM/DD hh:mm:ss MV:special_file_name LD Name type RV:special_file_name LD Name type Description of messages:...
  • Page 30 Chapter 2 Command Reference The command is executed with the monitoring time interval set to 2 seconds with -wait specification. (Batch specification) C:\>iSMrc_replicate -file volume_file -wait 2 Replicate Start 2001/01/28 17:33:17 MV:1 dev001 \\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\ RV:2 dev101 Replicate Start 2001/01/28 17:33:17 MV:3 dev002 \\?\Volume{70facee0-58a7-11d5-ad3e-806d6172696f}\...
  • Page 31 Chapter 2 Command Reference On the UNIX system The command is executed with the monitoring time interval of two seconds by the -wait specification. (Individual specification) # iSMrc_replicate -mv /dev/rdsk/c0t1d0 -mvflg sfn -rv /dev/rdsk/c0t2d0 -rvflg sfn -wait 2 Replicate Start 2000/10/10 09:11:23 MV:/dev/rdsk/c0t1d0 disk001...
  • Page 32 Chapter 2 Command Reference MV:/dev/rdsk/c0t1d1 disk101 RV:/dev/rdsk/c0t2d1 disk102 The end messages are displayed in the order Replicate commands terminate. The command is executed by specifying a volume group that consists of two logical volumes, /dev/rdsk/c1t1d0 and /dev/rdsk/c1t1d1, for an MV (Individual specification) # iSMrc_replicate -mv /dev/vg100 -mvflg vg -rv /dev/rdsk/c2t0d1 /dev/rdsk/c2t0d2 -rvflg sfn -wait 2...
  • Page 33 Chapter 2 Command Reference The following notes apply to the case when joint operation with the replication management is not performed (the I/O issuance to disk arrays is directly controlled via FC). The target MV is registered in the Volume List. Specifying volume of a dynamic disk is not allowed.

  • Page 34: Ismrc_Separate

    Chapter 2 Command Reference [ NAME ] iSMrc_separate - Separates RV from MV. [ SYNOPSIS ] iSMrc_separate -mv volume -mvflg mv_flg [-rv volume -rvflg rv_flg] [-rvacc rv_access] [-rvuse rv_use | -force force_arg] [-wait [second] | -nowait] iSMrc_separate -file file_name [-rvacc rv_access] [-rvuse rv_use | -force force_arg] [-wait [second] | -nowait] iSMrc_separate...

  • Page 35: Chapter 3 Operation Settings

    Chapter 2 Command Reference Specify the access restrictions for RV. -rvacc rv_access In rv_access, one of the following can be specified. Read Only is allowed for RV. Read/write are allowed for RV. If this argument is omitted, the operation is the same as the operation when rw is specified.

  • Page 36: Replication Operation Option Setting File

    Chapter 2 Command Reference -wait [second ] | -nowait Specify whether to wait for completion of Separate. If -wait is specified, it waits until difference reflection of MV/RV is complete. It also monitors process state in a certain time interval. The monitoring time interval is 5 seconds.
  • Page 37 Chapter 2 Command Reference [ DISPLAYED INFORMATION ] On the Windows system Information when the command terminates normally with -wait specification is displayed. (Individual specification) C:\>iSMrc_separate -mv ld_name -mvflg ld -rv ld_name -rvflg ld -wait 2 Separate Start YYYY/MM/DD hh:mm:ss MV:disk_number ld_name type...

  • Page 38: Ismrc_Separate

    Chapter 2 Command Reference When -wait has been specified, the copy difference remains unchanged for the period of time (30 seconds) set in RPL_ENDWATCHDEV of the replication operation option setting file, and the operation terminated abnormally, the following information is displayed: (Individual specification) C:\>iSMrc_separate -mv ld_name -mvflg ld -rv ld_name -rvflg ld -wait 2 Separate Start...
  • Page 39 Chapter 2 Command Reference MV:special_file_name LD Name type RV:special_file_name LD Name type Description of messages: Separate Start YYYY/MM/DD hh:mm:ss Separate start message and start time MV:special_file_name LD Name type RV:special_file_name LD Name type MV/RV’s special file name, logical disk name, OS type Separating..
  • Page 40 Chapter 2 Command Reference Description of messages: The following is displayed as an error message. iSMrc_separate: Error : iSM13663 : The processing of waiting has terminated because "separate diff" or "copy diff" does not decrease in the specified time. (30 sec) [ USAGE ] On the Windows system The command is executed with the monitoring time interval of 2 seconds with -wait...
  • Page 41 Chapter 2 Command Reference RV:4 dev102 Separate Start 2001/01/28 17:56:17 MV:5 dev003 \\?\Volume{71facee0-58a7-11d5-ad3e-806d6172696f}\ RV:6 dev103 Separating..Separate Normal End 2001/01/28 17:56:20 MV:1 dev001 \\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\ RV:2 dev101 Separate Normal End 2001/01/28 17:56:21 MV:3 dev002 \\?\Volume{70facee0-58a7-11d5-ad3e-806d6172696f}\ RV:4 dev102 Separate Normal End 2001/01/28 17:56:23 MV:5 dev003 \\?\Volume{71facee0-58a7-11d5-ad3e-806d6172696f}\...
  • Page 42 Chapter 2 Command Reference Separating..Separate Normal End 2000/10/10 09:11:24 MV:/dev/rdsk/c0t1d0 disk001 RV:/dev/rdsk/c0t2d0 disk002 (Batch specification) # iSMrc_separate -file volume_file -wait 2 Separate Start 2000/10/10 09:11:23 MV:/dev/rdsk/c0t1d0 disk001 RV:/dev/rdsk/c0t2d0 disk002 Separate Start 2000/10/10 09:11:23 MV:/dev/rdsk/c0t1d1 disk101 RV:/dev/rdsk/c0t2d1 disk102 Separate Start 2000/10/10 09:11:23 MV:/dev/rdsk/c0t1d2 disk201...
  • Page 43 Chapter 2 Command Reference [ NOTES ] The target MV is recognized by Replication Control as the Replication target disk. The target MV and RV are paired. The activity state of the target pair is not Restore Execution. The copy control state of the target pair is the Foreground Copy state. * To separate pairs in the Background Copy state, you must perform Resume Copy and change them to the Foreground Copy state.
  • Page 44 Chapter 2 Command Reference [ NAME ] iSMrc_restore - Starts copy from RV to MV. [ SYNOPSIS ] iSMrc_restore -mv volume -mvflg mv_flg [-rv volume -rvflg rv_flg] [-cprange copy_range] [-cpmode copy_mode] [-rvacc rv_access] [-wait [second] | -nowait] [-mode operation_mode ] iSMrc_restore -file file_name [-cprange copy_range] [-cpmode copy_mode]...
  • Page 45 Chapter 2 Command Reference -rv volume Specify volume of RV. For information about the volume and volume types, refer to 1.2 “Volume Types”. Specify the volume type specified in -rv. -rvflg rv_flg This argument must be specified if -rv is specified. For information about the volume and volume types, refer to 1.2 “Volume Types”.
  • Page 46 Chapter 2 Command Reference -wait [second] | -nowait Specify whether to wait for completion of Restore. If -wait is specified, it waits until difference reflection of MV/RV is complete. It also monitors process state in a certain time interval. The monitoring time interval is 5 seconds. If a value is specified in second, the monitoring time interval of the disk array becomes the specified value.
  • Page 47 Chapter 2 Command Reference -file file_name To specify multiple pairs, describe the pairs of MV/RV in file_name. The copy operation instruction is specified in the argument. If multiple pairs are specified, a copy request is issued to the pairs simultaneously, and the operation instruction is reflected to all the pairs.
  • Page 48 Chapter 2 Command Reference [ DISPLAYED INFORMATION ] On the Windows system Information when the command terminates normally with -wait specification is displayed. (Individual specification) C:\>iSMrc_restore -mv ld_name -mvflg ld -rv ld_name -rvflg ld -wait 2 iSMrc_restore: Info: iSM13224: MV is restored. Volume Name: volume name MountPoint drive letter or mount point Umount Start...

  • Page 49: Ismrc_Restore

    Chapter 2 Command Reference RV:disk_number ld_name type volume name path MV/RV physical disk number, logical disk name, OS type, mount point volume name, and drive letters or path name mounted to the folder of the NTFS volume accessed by users Mount Start YYYY/MM/DD hh:mm:ss Message indicating the start of mounting MV, and start time...
  • Page 50 Chapter 2 Command Reference RV:disk_number ld_name type volume name path C:\> Description of messages: The following is displayed as an error message. iSMrc_restore: Error: iSM13663: The processing of waiting has terminated because “separate diff” or “copy diff” does not decrease in the specified time. (30 sec) On the UNIX system When the command terminates normally with the -wait specification, the following information is displayed.
  • Page 51 Chapter 2 Command Reference When -wait has been specified, and the copy difference remains unchanged for the period of time (30 seconds) set in RPL_ENDWATCHDEV of the environment variable, and the operation terminated abnormally, the following information is displayed. (Individual specification) # iSMrc_restore -mv special_file_name -mvflg sfn -rv special_file_name -rvflg sfn -wait 2 Restore Start...
  • Page 52 Chapter 2 Command Reference [ USAGE ] On the Windows system The command is executed with the monitoring time interval of 2 seconds with -wait specification. (Individual specification) C:\>iSMrc_restore -mv dev001 -mvflg ld -rv dev002 -rvflg ld -wait 2 iSMrc_restore: Info: iSM13224: MV is restored.
  • Page 53 Chapter 2 Command Reference The command is executed with the monitoring time interval of 2 seconds with -wait specification. (Batch specification) C:\>iSMrc_restore -file volume_file -wait 2 iSMrc_restore: Info: iSM13224: MV is restored. Volume Name: \\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\ MountPoint: E:\ Umount Start 2001/01/28 17:55:16 Umount Normal End 2001/01/28 17:55:17 Restore Start...
  • Page 54 Chapter 2 Command Reference The end messages are displayed in the order Restore commands terminate.
  • Page 55 Chapter 2 Command Reference On the UNIX system The command is executed with the monitoring time interval of two seconds by the -wait specification. (Individual specification) # iSMrc_restore -mv /dev/rdsk/c0t1d0 -mvflg sfn -rv /dev/rdsk/c0t2d0 -rvflg sfn -wait 2 Restore Start 2000/10/10 09:11:23 MV:/dev/rdsk/c0t1d0 disk001...
  • Page 56 Chapter 2 Command Reference Restore Normal End 2000/10/10 09:16:35 MV:/dev/rdsk/c0t1d1 disk101 RV:/dev/rdsk/c0t2d1 disk102 The end messages are displayed in the order Restore commands terminate. The command is executed by specifying a volume group that consists of two logical volumes, /dev/rdsk/c1t1d0 and /dev/rdsk/c1t1d1, for an MV. (Individual specification) # iSMrc_restore -mv /dev/vg100 -mvflg vg -rv /dev/rdsk/c2t0d1 /dev/rdsk/c2t0d2 -rvflg sfn -wait 2...
  • Page 57 Chapter 2 Command Reference MV and RV must be unmounted from the host. The following notes apply to the case when joint operation with the replication management is not performed (the I/O issuance to disk arrays is directly controlled via FC). The target MV is registered in the Volume List.

  • Page 58: Ismrc_Change

    Chapter 2 Command Reference [ NAME ] iSMrc_change - Changes the copy control state of MV/RV. [ SYNOPSIS ] iSMrc_change {-suspend | -resume | -sync | -semi | -bg} -mv volume -mvflg mv_flg [-rv volume -rvflg rv_flg] iSMrc_change -file file_name {-suspend | -resume | -sync | -semi | -bg} iSMrc_change -? iSMrc_change -help...
  • Page 59 Chapter 2 Command Reference -mvflg mv_flg Specify the volume type specified in -mv. This argument must be specified with -mv. For information about the volume and volume types, refer to 1.2 “Volume Types”. Specify volume of RV. -rv volume For information about the volume and volume types, refer to 1.2 “Volume Types”.
  • Page 60 Chapter 2 Command Reference [ DISPLAYED INFORMATION ] On the Windows system Information when the command terminates normally with -suspend specification is displayed. (Individual specification) C:\>iSMrc_change -suspend -mv ld_name -mvflg ld -rv ld_name -rvflg ld Change Start YYYY/MM/DD hh:mm:ss MV:disk_number ld_name type volume name...
  • Page 61 Chapter 2 Command Reference Change Start YYYY/MM/DD hh:mm:ss MV:special_file_name LD Name type RV:special_file_name LD Name type Change Normal End YYYY/MM/DD hh:mm:ss MV:special_file_name LD Name type RV:special_file_name LD Name type Description of messages: Change Start YYYY/MM/DD hh:mm:ss Change Copy Control State start message and start time MV:special_file_name LD Name type...
  • Page 62 Chapter 2 Command Reference The -suspend command resumes the suspended copy control state in the Sync copy mode. (Individual specification) C:\>iSMrc_change -sync -mv dev001 -mvflg ld -rv dev101 -rvflg ld Change Start 2001/01/28 18:14:44 MV:1 dev001 \\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\ RV:2 dev101 Change Normal End 2001/01/28 18:14:44 MV:1 dev001...
  • Page 63 Chapter 2 Command Reference This command resumes the Copy Control State suspended by the -suspend command in the synchronous copy mode. (Individual specification) # iSMrc_change -sync -mv /dev/rdsk/c0t1d0 -mvflg sfn -rv /dev/rdsk/c0t2d0 -rvflg sfn Change Start 2000/10/10 09:11:30 MV:/dev/rdsk/c0t1d0 disk001 RV:/dev/rdsk/c0t2d0 disk002 Change Normal End...
  • Page 64 Chapter 2 Command Reference [ RETURN VALUE ] 0: Operation for all the paired volumes terminated normally. 1: Operation for all the paired volumes terminated abnormally. 2: Operation for some paired volumes terminated abnormally. 3: The command terminated abnormally because all or some of the paired volumes were already in Replicate State.

  • Page 65: Ismrc_Wait

    Chapter 2 Command Reference [ NAME ] iSMrc_wait - Waits for Sync State (rpl/sync), Sync State (rst/sync), and Separated State. [ SYNOPSIS ] iSMrc_wait -cond condition -mv volume -mvflg mv_flg [-rv volume -rvflg rv_flg] [-interval interval_time ] [-limit limit_time ] iSMrc_wait -cond condition -rv volume -rvflg rv_flg [-interval interval_time ] [-limit limit_time ]...
  • Page 66 Chapter 2 Command Reference -rv volume Specify a volume of RV. For information about the volume and volume types, refer to 1.2 “Volume Types”. Specify the type of the volume specified for -rv. -rvflg rv_flg This argument must be specified if -rv is specified. For information about the volume and volume types, refer to 1.2 “Volume Types”.
  • Page 67 Chapter 2 Command Reference -file file_name To specify more than a pair of volumes, specify the volume names for file_name. For the description format of file_name, refer to 1.3 “Replication Operation File”. If multiple pairs of volumes are specified and an error occurs in a pair of volumes, the system does not discontinue operation.
  • Page 68 Chapter 2 Command Reference MV/RV physical disk number, logical disk name, OS type, mount point volume name, and drive letter of the drive mounted in the folder of the NTFS volume accessed by the user The following information is displayed when the command is executed to wait for a pair of volumes in Restore Execution to enter the Sync State: C:\>...
  • Page 69 Chapter 2 Command Reference The following information is displayed when the command is executed to wait for a pair of volumes in Separate Execution to enter the Separated State: C:\> iSMrc_wait -mv ld_name -mvflg ld -rv ld_name -rvflg ld -cond sep Waiting..
  • Page 70 Chapter 2 Command Reference If 3,600 seconds is set as a wait time limit and Separate is not completed in 3,600 seconds, the wait command displays the following error message and information, and terminates abnormally: C:\> iSMrc_wait -mv ld_name -mvflg ld -rv ld_name -rvflg ld -cond sep -limit 3600 Waiting..
  • Page 71 Chapter 2 Command Reference On the UNIX system When the command is executed to wait for a pair of volumes currently in Replicate execution to enter the Sync State, the following information is displayed. # iSMrc_wait -cond sync -mv ld_name -mvflg ld -rv ld_name -rvflg Waiting..
  • Page 72 Chapter 2 Command Reference Restore end message and end time MV:special_file_name LD Name type RV:special_file_name LD Name type MV/RV’s special file name, logical disk name, OS type When the command is executed to wait for a pair of volumes currently in Separate execution to enter the Separated State, the following information is displayed: # iSMrc_wait -cond sep -mv ld_name -mvflg ld -rv ld_name -rvflg Waiting..
  • Page 73 Chapter 2 Command Reference Description of messages: The following is displayed as an error message. iSMrc_wait: Error : iSM13658 : Wait command has terminated because it has reached the time limit which is specified by the limit option. (3600 sec) Waiting..
  • Page 74 Chapter 2 Command Reference Separate Normal End 2000/10/10 09:11:24 MV:/dev/rdsk/c0t1d0 disk001 RV:/dev/rdsk/c0t2d0 disk002 [ NOTES ] • The MV and RV to be operated must be recognized as replication target disks by Replication Control. • The MV and RV to be operated must be set as a pair. The following notes apply to the case when joint operation with the replication management is not performed (the I/O issuance to disk arrays is directly controlled via FC).

  • Page 75: Ismrc_Query

    Chapter 2 Command Reference [ NAME ] iSMrc_query - Displays the replication state. [ SYNOPSIS ] iSMrc_query -mv volume -mvflg mv_flg [-rv volume -rvflg rv_flg] iSMrc_query -rv volume -rvflg rv_flg iSMrc_query -file file_name iSMrc_query iSMrc_query -help [ DESCRIPTION ] The iSMrc_query command displays the state value of the specified paired volumes. OPTIONS The iSMrc_query command recognizes the following options and arguments.
  • Page 76 Chapter 2 Command Reference To specify multiple pairs, describe the pairs of MV/RV in -file file_name file_name. The copy operation instruction is specified in the argument. If multiple pairs are specified, a copy request is issued to the pairs simultaneously, and the operation instruction is reflected to all the pairs.
  • Page 77 Chapter 2 Command Reference Description of messages: MV: Disk No. MV physical disk number Logical disk name LD Name OS type Type Mount point volume name Volume Name Drive name mounted to the folder of the NTFS volume accessed Path by users RV physical disk number RV: Disk No.
  • Page 78 Chapter 2 Command Reference is displayed. The <State> shows “Replicate”, “Restore”, “Separate”, “Fault” (for fault), or “Forced Separate” (for Forced Separate). When “Fault” or “Forced Separate” is displayed, the End Time does not appear. Separate Diff Indicates the amount of copy difference in the Separate state in kilobyte. Copy Diff Indicates the amount of copy difference in the Replicate or Restore state in kilobyte.
  • Page 79 Chapter 2 Command Reference Description of messages: MV: Special File, LD Name, Type Displays the MV’s special file name, logical disk name, and OS type. RV: Special File, LD Name, Type Displays the RV’s special file name, logical disk name, and OS type. Activity State Indicates the activity state.
  • Page 80 Chapter 2 Command Reference Separate Diff Indicates the amount of copy difference in the Separate state in kilobytes. Copy Diff Indicates the amount of copy difference in the Replicate or Restore state in kilobytes. RV Access Indicates the access restriction for RV. Read/Write Permit (Read and Write are allowed) ReadOnly (Only Read is allowed) NotReady (Access is not available)
  • Page 81 Chapter 2 Command Reference On the UNIX system The command displays information regarding the pair state of MV /dev/rdsk/c1t2d0. # iSMrc_query -mv /dev/rdsk/c1t2d0 -mvflg sfn MV: Special File /dev/rdsk/c1t2d0 LD Name disk001 Type RV: Special File /dev/rdsk/c1t2d1 LD Name disk002 Type Activity State separate...
  • Page 82 Chapter 2 Command Reference [ RETURN VALUE ] 0: Operation for all the paired volumes terminated normally. 1: Operation for all the paired volumes terminated abnormally. 2: Operation for some paired volumes terminated abnormally. [ ERRORS ] This command terminates abnormally in the following cases. A parameter is invalid.

  • Page 83: Ismrc_Sense

    Chapter 2 Command Reference [ NAME ] iSMrc_sense - Displays the specific volume name. [ SYNOPSIS ] iSMrc_sense -vol volume -volflg vol_flg iSMrc_sense -file file_name iSMrc_sense -? iSMrc_sense –help [ DESCRIPTION ] The iSMrc_sense command displays the state value of the specified volume. OPTIONS The iSMrc_sense command recognizes the following options and arguments.

  • Page 84: Logical Disk

    Chapter 2 Command Reference [ DISPLAYED INFORMATION ] On the Windows system C:\>iSMrc_sense -vol ld-name -volflg dskn Disk No. disk_number LD Name ld_name Type type Volume Name volume_name Path path C:\> Description of messages: Physical disk number Disk No. Logical disk name LD NAME Volume Absolute Address OS type...
  • Page 85 Chapter 2 Command Reference [ USAGE ] On the Windows system The command displays volume name information. C:\>iSMrc_sense -vol rpl302_7 -volflg ld Disk No. LD Name rpl302_7 30000000000000020302 Type Volume Name \\?\Volume{69facee0-58a7-11d5-ad3e-806d6172696f}\ Path C:\> On the UNIX system Volume name information is displayed. # iSMrc_sense -vol /dev/rdsk/c5t2d0 -volflg sfn Special file LD NAME...

  • Page 86: Ismrc_Flush

    Chapter 2 Command Reference [ NAME ] iSMrc_flush - Flushes the file system buffer. [ SYNOPSIS ] iSMrc_flush -drv drive: iSMrc_flush -mvol volume_name iSMrc_flush -mdir path_name iSMrc_flush -? [ DESCRIPTION ] The iSMrc_flush command requests flushing the unwritten buffer data of specified drive/mount point volume/NTFS folder onto disk.
  • Page 87 Chapter 2 Command Reference [ DISPLAYED INFORMATION ] C:\>iSMrc_flush -drv drive-name Flush Start YYYY/MM/DD hh:mm:ss disk_number ld_name type volume name path Flush Normal End YYYY/MM/DD hh:mm:ss disk_number ld_name type volume name path C:\> Description of message: Flush Start YYYY/MM/DD hh:mm:ss File system flush unmount starting message and Start Time disk_number ld_name...
  • Page 88 Chapter 2 Command Reference [ NOTES ] The operation target volume must have been registered in the Volume List. The operation target volume must be available for Read/Write. Specifying volume of a dynamic disk is not allowed. The drive of the specified name must be mounted. This command flushes only the Windows file system.

  • Page 89: Ismrc_Mount

    Chapter 2 Command Reference [ NAME ] iSMrc_mount - Mounts volumes. [ SYNOPSIS ] iSMrc_mount -drv drive: iSMrc_mount -mvol volume_name iSMrc_mount -mdir path_name iSMrc_mount -? [ DESCRIPTION ] The iSMrc_mount command mounts the specified drive, mount point volume, or NTFS folder to the Windows system.
  • Page 90 Chapter 2 Command Reference Description of message: Mount Start YYYY/MM/DD hh:mm:ss Physical disk mount starting message and Start Time disk_number ld_name type volume name path Physical disk number, logical disk name, OS type, mount point volume name, and drive letters accessed by users or path name of the NTFS folder. Mount Normal End YYYY/MM/DD hh:mm:ss Physical disk mount end message and end time...

  • Page 91: Ismrc_Umount

    Chapter 2 Command Reference [ NAME ] iSMrc_umount - Unmounts volumes. [ SYNOPSIS ] iSMrc_umount -drv drive: [-force] iSMrc_umount -mvol volume_name [-force] iSMrc_umount -mdir path_name [-force] iSMrc_umount -? [ DESCRIPTION ] The iSMrc_umount command unmounts the specified drive, mount point volume, or NTFS folder from the Windows file system.
  • Page 92 Chapter 2 Command Reference Description of message: Umount Start YYYY/MM/DD hh:mm:ss Physical disk (drive) unmount starting message and Start Time disk_number ld_name type volume name path Physical disk number, logical disk name, OS type, mount point volume name, and drive letters accessed by users or path name of the NTFS folder.
  • Page 93 Chapter 2 Command Reference [ RETURN VALUE ] 0: Normal termination 1: Abnormal termination [ ERRORS ] This command terminates abnormally in the following cases. A parameter is invalid. If the system function (Win32API) fails. Other program is referring to or updating the volume concerned. Executing the CHKDSK command with the /F /X specification enables reference and update by other programs to be forcibly cancelled.
  • Page 94 Chapter 2 Command Reference [ NAME ] iSMrc_signature - Operations regarding disk signature. [ SYNOPSIS ] iSMrc_signature {-read | -set | -del | -init | -list} {-dskn disk_number | -all} iSMrc_signature {-export | -import} file_name {-dskn disk_number | -all} iSMrc_signature -? [ DESCRIPTION ] The iSMrc_signature command performs save, restoration, deletion, initialization, and display of disk signature.
  • Page 95 Chapter 2 Command Reference -init Initializes the signature on the physical disk. If -all is specified, signature information of all disks is initialized. If disk_number is specified, only the signatures of the target physical disks are initialized. Displays the list of disk signatures saved by -read, -list signatures on the physical disk, and signatures saved in the disk array.
  • Page 96 Chapter 2 Command Reference [ NOTES ] The value of the disk signature reported by means of the iSMrc_signature command may seem to be different from the value of the disk signature reported by means of Windows or other disk management tools because the byte order is handled differently. Therefore, pay special attention when using the value of the disk signature displayed or saved by the iSMrc_signature command for another disk management tool.
  • Page 97 Chapter 2 Command Reference [ NAME ] iSMrc_scan - Device scan. [ SYNOPSIS ] iSMrc_scan iSMrc_scan -? [ DESCRIPTION ] The iSMrc_scan command scans devices and let the system recognize the available devices. OPTIONS The iSMrc_scan command recognizes the following option: Displays the usage of this command.
  • Page 98 Chapter 2 Command Reference [ NAME ] iSMrc_ldlist - Displays logical disks and related information. [ SYNOPSIS ] iSMrc_ldlist -a iSMrc_ldlist -d iSMrc_ldlist -de disk_name [ld_name] iSMrc_ldlist -cr iSMrc_ldlist -? iSMrc_ldlist –help [ DESCRIPTION ] The iSMrc_ldlist command displays logical disks and related information. OPTIONS The iSMrc_ldlist command recognizes the following options and arguments.
  • Page 99 This option can be used only when the replication management (controlling the issuance of I/O to disk arrays via the NEC Storage Manager) is simultaneously conducted. For the setting of the I/O issuance control, refer to Chapter 3 “Operation Settings”.
  • Page 100 Chapter 2 Command Reference Description of messages: Data is being received. Receiving..During the joint operation with the replication management, this message is displayed until the data reception is completed. The display of this message can be suppressed by setting an option. For details of the option setting, refer to 3.1 “Replication Operation Option Setting File”...
  • Page 101 Chapter 2 Command Reference On the UNIX system # iSMrc_ldlist –d Receiving… -------------------------------------------------------------- Disk Array Name Management -------------------------------------------------------------- disk_array_name management Description of messages: Data is being received. Receiving..During the joint operation with the replication management, this message is displayed until the data reception is completed.
  • Page 102 Chapter 2 Command Reference [ USAGE ] This commands displays the list of disk arrays. On the Windows system C:\> iSMrc_ldlist –a Receiving..-------------------------------------------------------------------------------------------------------- [Disk Array Name](Management) OS Type LD Name Attribute Capacity -------------------------------------------------------------------------------------------------------- [NECStorage4100](direct) 0000h 00000004C0010550000 1.0 MB 0001h lx_rpl01 2.0 GB 0002h...
  • Page 103 Chapter 2 Command Reference [ ERRORS ] This command terminates abnormally in the following cases. A parameter is invalid. The instruction fails due to a disk array error.
  • Page 104 Chapter 2 Command Reference [ NAME ] iSMrc_pair - Pair setting, unpair or forced unpair. [ SYNOPSIS ] iSMrc_pair -pair -mv volume -mvflg mv_flg -rv volume -rvflg rv_flg iSMrc_pair -unpair -mv volume -mvflg mv_flg [-rv volume -rvflg rv_flg ] [-force force_arg] iSMrc_pair { -pair | -unpair [-force force_arg] } -file file_name iSMrc_pair...
  • Page 105 Chapter 2 Command Reference -mvflg mv_flg Specify the volume type specified in -mv. This argument must be specified together with -mv. For information about the volume and volume types, refer to 1.2 “Volume Types”. The pair setting and canceling operation is performed on a single logical volume basis. Therefore, neither an LVM volume group nor a VxVM disk group can be specified as volume.
  • Page 106 Chapter 2 Command Reference [ DISPLAYED INFORMATION ] The pair setting operation is performed. On the Windows system C:\> iSMrc_pair -pair -mv ld-name -mvflg ld -rv ld-name -rvflg ld iSM13247: Command has completed successfully. (code = proc-0d03-0004-0000) C:\> On the UNIX system # iSMrc_pair -pair -mv ld-name -mvflg ld -rv ld-name -rvflg ld iSM13247: Command has completed successfully.
  • Page 107 Chapter 2 Command Reference The volume list is not being created. The iSM special file is not being created (the UNIX system HP-UX version only). [ RETURN VALUE ] 0: Operation for all the paired volumes terminated normally. 1: Operation for all the paired volumes terminated abnormally. 2: Operation for any of the paired volumes terminated abnormally.
  • Page 108 Chapter 2 Command Reference [ NAME ] iSMsql_snapshotbkup - Creates metadata for the Microsoft SQL Server 2000 database, flushes the file system buffer, and then separates the RV. [ SYNOPSIS ] iSMsql_snapshotbkup -db dbname -metafile metafile_name [{ -mv volume -mvflg mv_flg [-rv volume -rvflg rv_flg] | -file file_name }] [-rvuse rv_use] [-rvacc rv_access] [{-wait [second] | -nowait}][-nocheck]...
  • Page 109 Chapter 2 Command Reference -dbfile dbfile_name To simultaneously perform Snapshot Backup on multiple databases, describe the database names and the option specification for each database in dbfile_name. When multiple databases are specified, Snapshot Backup is simultaneously performed on all of the databases.
  • Page 110 Chapter 2 Command Reference refer to 1.2 “Volume Types”. Specify the volume of RV. -rv volume For information about the volume and volume types, refer to 1.2 “Volume Types”. When there is only one pair of MV and RV, this option can be omitted.
  • Page 111 Chapter 2 Command Reference -rvacc rv_access Specify the access restriction for RV. One of the following can be specified in rv_access. Only reference can be performed for Reference and update can be performed for RV. If this argument is omitted, the operation is the same as the operation when rw is specified.
  • Page 112 Chapter 2 Command Reference -pass [password] Specify a password for connecting to the Microsoft SQL Server 2000. This argument must be specified when -uid is specified. When the password is omitted, the system recognizes that there is no password. Enter a user ID and a password from the input screen -input when connecting to the Microsoft SQL Server 2000.
  • Page 113 Chapter 2 Command Reference [ DISPLAYED INFORMATION ] When the command is executed to wait for reflecting the difference from the MV to the RV, the following information is displayed: C:\> iSMsql_snapshotbkup -db snap -metafile metafilename -wait SnapshotBackup Start YYYY/MM/DD hh:mm:ss DataBase db_name MV:physical-disk-no...
  • Page 114 Chapter 2 Command Reference Flush Normal End YYYY/MM/DD hh:mm:ss Flush end message and end date Separate Start YYYY/MM/DD hh:mm:ss Separate start message and start date Separating..Message that appears during execution of Separate Separate Normal End YYYY/MM/DD hh:mm:ss Separate end message and end date SnapshotBackup Normal End YYYY/MM/DD hh:mm:ss Snapshot Backup end message and end date...
  • Page 115 Chapter 2 Command Reference [ NAME ] iSMsql_snapshotrst - After unmounting the MV, this command performs Restore from the RV to the MV and then recovers the Microsoft SQL Server 2000 database. [ SYNOPSIS ] iSMsql_snapshotrst -db dbname -metafile metafile_name [{ -mv volume -mvflg mv_flg [-rv volume -rvflg rv_flg] | -file file_name }] [-cprange copy_range] [-cpmode copy_mode]...
  • Page 116 Chapter 2 Command Reference When multiple databases are specified, Snapshot Restore is simultaneously performed on all of the databases. For information about the dbfile_name description format, refer to 1.4 “Database Operation File”. When multiple databases are specified, if an error occurs in any of the databases, the process is canceled.
  • Page 117 Chapter 2 Command Reference -rvflg rv_flg Specify the volume type specified in -rv. This argument must be specified together with -rv. For information about the volume and volume types, refer to 1.2 “Volume Types”. To specify multiple pairs, describe pairs of MVs and -file file_name RVs in file_name.
  • Page 118 Chapter 2 Command Reference reflecting the update to the RV. After Restore has been completed, the RV is automatically separated and the mode switches to the Separated state. default Uses the setting stored in the replication operation option setting file. For details of the setting, refer to 3.1 “Replication Operation Option Setting File”.
  • Page 119 Chapter 2 Command Reference -pass [password] Specify a password for connecting to the Microsoft SQL Server 2000. This argument must be specified when -uid is specified. When the password is omitted, the system recognizes that there is no password. Enter a user ID and a password from the input screen -input when connecting to the Microsoft SQL Server 2000.
  • Page 120 Chapter 2 Command Reference -rvflg, -cprange, -cpmode, -rvacc, -wait, -nowait, and -mode parameters. When -norestore is specified, this command -move os_file_name[,...n] executes Restore by using a physical file that has a different path from the backed up physical file. As a file name specified in os_file_name, specify the database’s data file and log file in the full path by separating them by a comma.
  • Page 121 Chapter 2 Command Reference Path RV:physical-disk-no ld_name type Volume_name Path MV’ and RV’s physical disk number, logical disk name, OS type Mount point volume name Drive letters or path name of the NTFS folder Restore Start YYYY/MM/DD hh:mm:ss Restore start message and start date Restoring..
  • Page 122 Chapter 2 Command Reference [ RETURN VALUE ] 0: Normal termination 1: Abnormal termination [ ERRORS ] This command terminates abnormally in the following cases. A parameter is invalid. The instruction fails due to a disk array error. The instruction to the Microsoft SQL Server 2000 fails.
  • Page 123 Chapter 3 Operation Settings Chapter 3 Operation Settings On the Windows system, various operations can be specified for data replication commands by using the replication operation option setting file. The replication operation option setting file is described below. [ FILE LOCATION AND NAME ] %SystemRoot%\iSMrpl.ini [ DESCRIPTION ] [TRACELOG] section...
  • Page 124 Chapter 3 Operation Settings (kilo bytes) is specified, log files of up to 200 kilobytes (default) each are created. The system checks the size of the log file at the start of executing each command, and if the size is beyond the preset value, the system changes the value. Accordingly, the file size may not be quite the same as the specified value.
  • Page 125 Chapter 3 Operation Settings If the RPL_WATCHDEV is not specified, the default is 5 seconds. Wait Process Termination Time RPL_ENDWATCHDEV=second If the -wait option of iSMrc_replicate, iSMrc_separate, iSMrc_restore, iSMsql_snapshotbkup, and iSMsql_snapshotrst commands are specified, there may be no change in difference copy operation for a specified time. You can determine when to terminate the wait process in this case.
  • Page 126 Chapter 3 Operation Settings Enables the command for all OS types (default). RPLPLATFORM=WN Enables the command only for the Windows volumes. RPLPLATFORM=A2 Enables the command only for the ACOS-2 volumes. [RETRY] section Specifies operations regarding retry performed when the execution of the iSMrc_mount command fails.
  • Page 127 This is the default value when the IOPATH parameter is not specified. IOPATH=MANAGER Connects to the NEC Storage Manager (replication management) currently in operation on the same server and allows the NEC Storage Manager issue the replication operation I/O to the disk array. Connection port number Specify a socket port number for connecting to the NEC Storage Manager (replication management).
  • Page 128 The socket port number to be specified must be the same as the socket port number on the NEC Storage Manager (replication management) side. For information about setting a socket port number on the NEC Storage Manager (replication management) side, refer to the “NEC Storage Manager User’s Manual”.

  • Page 129: Environment Variables

    Chapter 3 Operation Settings The UNIX system uses environment variables to specify various operations that are specified for data replication commands. The environment variables are described below. The man command environment variable (LANG) Specify an environment variable compatible with a language and characters to be used. Operation trace environment variables RPLLOG In “Number of Days”, specify the expiration date for the log data stored in the operation...
  • Page 130 Chapter 3 Operation Settings The system checks the size of the log file at the start of executing each command, and if the size is beyond the preset value, the system changes the value. Accordingly, the file size may not be quite the same as the specified value. This setting is valid when the RPLLOG environment variable is not specified and the value of the RPLLOGFILENUM environment variable is greater than one.
  • Page 131 After Separate execution, the RV is immediately available while the difference between the MV and RV contents is being reflected into the RV. To use this function, you need to purchase “NEC Storage DynamicDataReplication Ver2” and release the license lock of the product.
  • Page 132 NEC Storage Manager issue the replication operation I/O to the disk array. RPL_IOPORT_MANAGER Specify a socket port number for connecting to the NEC Storage Manager (replication management). This setting is valid when MANAGER is specified as the RPL_IOPATH environment variable.

  • Page 133: Index

    Index iSMvollist (Windows)........... 11 command list..............1 connection port number ..........121 LANG ................. 123 copy control state change..........1 ld ................. 3, 4 log file size..............117 logical disk information display........1 logical disk name ............ 3, 4, 5 LVM................3 database operation file .............7 -dbfile................7 dg .................3, 4 disk group name............3, 4, 5...
  • Page 134 Index retry operation..............120 syslog message............124 RPL_ENDWATCHDEV ........119, 124 RPL_IOPATH .............126 RPL_IOPORT_MANAGER ........126 RPL_RECV_MSG..........122, 126 RPL_RST_MODE ............125 UMOUNTRTCOUNT ..........120 RPL_SEP_RVUSE ............125 UMOUNTRTTIME ............ 120 RPL_WAITMSG ..........119, 125 unmount ................1 RPL_WATCHDEV ..........118, 124 RPLLOG..............117, 123 RPLLOGFILEMAXSIZE........117, 123 RPLLOGFILENUM ..........117, 123 RPLPLATFORM............119 vg.................

Table of Contents