NEC Storage Manager Service manual

NEC Storage Manager
Data Replication
Command Reference

© 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.

Preface
This manual explains how to use various types of commands for a data replication function.
The data replication function consists of a replication volume creation function, which is provided in Disk Array
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.
Remarks 1. This manual explains functions implemented by the following program products:
•NEC Storage Manager and NEC Storage BaseProduct
•NEC Storage ReplicationControl
•NEC Storage ReplicationControl SQL Option
•NEC Storage DynamicDataReplication
•NEC Storage RemoteDataReplication
2. This manual is applicable to the program products of the following versions:
•NEC Storage Manager Ver2.1
•NEC Storage BaseProduct Ver2.1
•NEC Storage ReplicationControl Ver2.1
•NEC Storage ReplicationControl SQL Option Ver2.1
3. The term “iSM” in this text refers to all the NEC Storage Manager program products.
4. The term “Microsoft SQL Server 2000” in this text refers to either Microsoft SQL Server 2000 Enterprise
Edition or the Microsoft SQL Server 2000 Standard Edition.
5. The term “data replication functions” differs from the “replication functions” provided by Microsoft SQL
Server 2000.
6. The term “MSCS” in this text refers to the Microsoft Cluster Server.
7. Trademarks and registered trademarks
•Microsoft®, Windows®, and Windows NT® are registered trademarks or trademarks of Microsoft
Corporation in the United States and other countries.
•HP-UX is a registered trademark of Hewlett-Packard, Co. in the United States.
•UNIX is a registered trademark of The Open Group in the United States and other countries.
•VERITAS, VxVM, VxFS, NetBackup, VERITAS Volume Manager, VERITAS File System, and
VERITAS NetBackup are registered trademarks or trademarks of VERITAS Software Corporation in the
United States and other countries.
•Legato NetWorker is a registered trademark of Legato Systems, Inc. in the United States.
•Sun is a registered trademark of Sun Microsystems, Inc. in the United States and other countries.

•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.
The First Edition in March 2003

i
Contents
Chapter 1 Overview............................................................................................................................................................1
1.1 Command List............................................................................................................................................................. 1
1.2 Volume Types............................................................................................................................................................. 3
1.3 Replication Operation File.......................................................................................................................................... 4
1.4 Database Operation File.............................................................................................................................................. 7
Chapter 2 Command Reference....................................................................................................................................... 11
2.1 Volume List Creation/Display.................................................................................................................................. 11
2.1.1 iSMvollist (Windows)....................................................................................................................................... 11
2.1.2 iSMvollist (UNIX)............................................................................................................................................ 15
2.2 Replication Operations.............................................................................................................................................. 18
2.2.1 iSMrc_replicate................................................................................................................................................. 18
2.2.2 iSMrc_separate.................................................................................................................................................. 28
2.2.3 iSMrc_restore.................................................................................................................................................... 38
2.2.4 iSMrc_change ................................................................................................................................................... 52
2.2.5 iSMrc_wait........................................................................................................................................................ 59
2.2.6 iSMrc_query...................................................................................................................................................... 69
2.2.7 iSMrc_sense...................................................................................................................................................... 77
2.3 Disk Operations ........................................................................................................................................................ 80
2.3.1 iSMrc_flush....................................................................................................................................................... 80
2.3.2 iSMrc_mount .................................................................................................................................................... 83
2.3.3 iSMrc_umount .................................................................................................................................................. 85
2.3.4 iSMrc_signature................................................................................................................................................ 88
2.3.5 iSMrc_scan........................................................................................................................................................ 91
2.4 Pair Operations ......................................................................................................................................................... 92
2.4.1 iSMrc_ldlist....................................................................................................................................................... 92
2.4.2 iSMrc_pair ........................................................................................................................................................ 98
2.5 Operations Linked with Database........................................................................................................................... 102
2.5.1 iSMsql_snapshotbkup..................................................................................................................................... 102
2.5.2 iSMsql_snapshotrst......................................................................................................................................... 109
Chapter 3 Operation Settings......................................................................................................................................... 117
3.1 Replication Operation Option Setting File ............................................................................................................. 117
3.2 Environment Variables ........................................................................................................................................... 123
Index .........................................................................................................................................................................127

Chapter 1 Overview
1
Chapter 1 Overview
1
1
1.
.
.1
1
1 C
C
Co
o
om
m
mm
m
ma
a
an
n
nd
d
d L
L
Li
i
is
s
st
t
t
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
Target system
No. Command name Operation Description Windows UNIX
1 iSMvollist Volume list
creation/display
Displays logical disk (disk array
side) information and associated
system−dependent information
(server side).

2 iSMrc_replicate Replication Starts copy (Replicate) from MV
to RV. 
3 iSMrc_separate Separation Separates MV from RV in the
copy state (Replicate or Restore). 
4 iSMrc_restore Restoration Starts copy (Restore) from RV to
MV. 
5 iSMrc_change Copy Control State
Change Change Copy Control State for reflecting updates in MV to RV. 
6 iSMrc_wait Waiting for state Waits for Sync State (rpl/sync), Sync State (rst/sync), and
Separated State.

7 iSMrc_query Paired volume state
display Displays the state of the paired volume. 
8 iSMrc_sense Volume list display Displays volume information. 
9 iSMrc_ldlist Logical disk
information display Obtains and displays logical disk list information. 
10 iSMrc_pair Pairing/unpairing Sets and cancels the paired
volume. 
11 iSMrc_flush File system buffer
flush Flushes the file system cache buffer. −
12 iSMrc_mount Volume mount Mounts the volume (file system). −
13 iSMrc_umount Volume unmount Unmounts the volume (file
system). −

Chapter 1 Overview
2
14 iSMrc_signature Disk signature
operation Performs an operation on each disk signature. −
15 iSMrc_scan Disk scanning Scans for available disks. −
16 iSMsql_snapshotbkup Snapshot Backup Creates backups of the Microsoft
SQL Server 2000 database. −
17 iSMsql_snapshotrst Snapshot Restore Restores the Microsoft SQL
Server 2000 database from the
backup.
−
: Target −: Non-target
Notes:
(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.
(4) On the UNIX system, operation authority belongs to a super user immediately after the installation.
The volume list can be created only by the super user; other operations, however, can be performed by
anybody by changing the authority for the command and directory operations.
(5) To operate together with the replication management (controlling the issuance of I/O to disk arrays via
the NEC Storage Manager), joint operation is possible with regard to commands from No.2 to No.10.
Command No.1 and those from No.11 to No.17 are not targeted for the joint operation because those
commands directly operate the system’s volumes.

Chapter 1 Overview
3
1
1
1.
.
.2
2
2 V
V
Vo
o
ol
l
lu
u
um
m
me
e
e T
T
Ty
y
yp
p
pe
e
es
s
s
Types of volumes that are specified as operation targets by data replication commands are as follows:
Table 1-2 Volume Types
Target system
Type Description Identifier Windows UNIX
Logical disk name Specifies the logical disk name set on the disk
array side. ld 
Mount point volume
name Specifies the mount point volume name assigned by the system to the volume. mvol -
NTFS folder name Specifies the NTFS folder name (path name)
set for the volume. mdir -
Drive letter Specifies the drive letter set for the volume. drv -
Special file name Specifies the special file name assigned by the
system to the disk (logical disk). sfn - 
Volume group name Specifies the name of the LVM’s volume
group that includes the disk (logical disk). vg - 
Disk group name Specifies the name of the VxVM’s disk group
that includes the disk (logical disk). dg - 
Notes:
(1) The identifier is a character string that indicates the volume type and is used in the following cases:
When specifying a volume type by a replication operation command argument (-mvflg, -rvflg, or
-volflg)
When specifying a volume type by the pair specification (MV type or RV type) in the replication
operation file
(2) To use the volume group, the LVM environment is necessary.
(3) To use the disk group, the VxVM environment is necessary.
(4) On the UNIX system Solaris version, to specify a special file name (/dev/rdsk/c#t#d#s#), remove the
special file name’s slice (partition) number (s#).
(5) The pair setting and canceling operation (iSMrc_pair command) is performed on a single logical disk;
therefore, it is not possible to specify a 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.

Chapter 1 Overview
4
1
1
1.
.
.3
3
3 R
R
Re
e
ep
p
pl
l
li
i
ic
c
ca
a
at
t
ti
i
io
o
on
n
n O
O
Op
p
pe
e
er
r
ra
a
at
t
ti
i
io
o
on
n
n F
F
Fi
i
il
l
le
e
e
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.
[ SYNOPSIS ]
This file is described in the following synopsis:
MV_Type:MV RV_Type:RV
To describe the MV and RV, use a colon (:) to connect the volume type (MV_Type or RV_Type) with
the volume (MV or RV).
Specifying volume types (MV_Type, RV_Type)
The following values can be specified as a volume type by using either a numerical value or a
character string.
Table 1-3 Volume Types
Volume Types Target system
Target volume By number By characters Windows UNIX
Logical disk name 0 ld 
Special file name 1 sfn - 
Volume group name 2 vg - 
Drive letter 4 drv
-
Disk group name 5 dg - 
Mount point volume name 6 mvol
-
NTFS folder name 7 mdir
-

Chapter 1 Overview
5

Chapter 1 Overview
6
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
Target volume Maximum number of
characters
Logical disk name
Special file name
Volume group name
Drive letter
Disk group name
32 single-byte characters
Mount point volume name 52 single-byte characters
NTFS folder name 260 single-byte characters
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.
One pair can be described per record.
When there are one MV and one RV, description of the RV can be omitted.
Normally, when there are one MV and multiple RVs, description of the RVs cannot be omitted. It
can be omitted only when the iSMrc_query command or the iSMrc_wait command is used.
Use a blank space or a tab character to separate the description of the MV from the description of the
RV.
Text displayed from the sharp (#) character to the end of the record is recognized as a comment.
If there is an error in the file syntax, operations to all pairs described in the file become invalid.
When using the iSMrc_sense command, specify the volume type and the volume name for
MV_Type and MV, respectively. Descriptions of RV_Type and RV are ignored.
When describing a pair that combines a volume group or a disk group with a special file name (or
logical disk name), multiple volumes can be specified by describing multiple special file names (or
logical disk names) separated by a comma (,).
When specifying a pair that combines a volume group or a disk group with a special file name (or
logical disk name), the number of logical volumes that consist of the volume group or the disk group
must coincide with the number of special file names to be described.
If a character string, such as a NTFS folder name, includes a blank space (∆) or colon (:), enclose the
entire character string in double quotation marks (“).

Chapter 1 Overview
7
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 Type:RV
sfn:/dev/rdsk/c16t1d0 sfn:/dev/rdsk/c16t1d1
sfn:/dev/rdsk/c16t1d2 sfn:/dev/rdsk/c16t1d3
vg:/dev/vgvol ld: /dev/rdsk/c16t1d4,/dev/rdsk/c16t1d5
dg:dg_name
ld:dev001 ld:dev002
ld:dev003 sfn:/dev/rdsk/c23t2d0
# Parallel configuration
sfn:/dev/rdsk/c16t2d0 sfn:/dev/rdsk/c16t2d1
sfn:/dev/rdsk/c16t2d0 sfn:/dev/rdsk/c16t2d2
# MV:RV=1:1
sfn:/dev/rdsk/c22t3d0

Chapter 1 Overview
8
1
1
1.
.
.4
4
4 D
D
Da
a
at
t
ta
a
ab
b
ba
a
as
s
se
e
e O
O
Op
p
pe
e
er
r
ra
a
at
t
ti
i
io
o
on
n
n F
F
Fi
i
il
l
le
e
e
To perform batch setting of databases by a NEC Storage ReplicationControl SQL Option command with the
-dbfile option, use the database operation file.
The database operation file is described below.
[ 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] ] [...]
For description, use a colon (:) to connect “db” with a database name (db_name) and to connect an
option type (Option_Type) with the preset value (value).
Description of each option can be omitted or can be in arbitrary order.
Specifying a database name (db_name)
Specify a name of the database which is a Snapshot Backup or Snapshot Restore target.
If the database name includes any of the following eleven characters, an error occurs.
\ / : , ; * ? ” < > |

Chapter 1 Overview
9
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
uid Specify a user ID for connecting to the Microsoft SQL Server 2000.
pass Specifies a password for the user ID for connecting to the Microsoft SQL
Server 2000.
input Specifies for entering a user ID and a password from the input screen.
server Specify a computer name and an instance name for connecting to a named
instance.
remod Specify the mode during the database recovery.
Description of this option is effective only during Snapshot Restore execution,
and ignored during Snapshot Backup execution.
refile Specifies the standby database file. Description of this option is effective only during Snapshot Restore execution,
and ignored during Snapshot Backup execution.
move
When executing Restore by using a physical file that has a different path from
the backed up physical file, specify the data file path name and the log file path
name.
Description of this option is effective only during Snapshot Restore execution,
and ignored during Snapshot Backup execution.
Specify the following preset values for each option type:
uid:user_Id Specify a user ID for connecting to the Microsoft SQL Server 2000.
Specify the pass option together with this option.
If this option is omitted, the system uses a user name and a
password for the Windows login account.
This option and the input option cannot be simultaneously
specified.
pass:[password] Specify a password for connecting to the Microsoft SQL Server
2000. If the password is omitted, the system recognizes that
there is no password. Specify the uid option together with this
option.
This option and the input option cannot be simultaneously
specified.
input: Enters a user ID and a password from the input screen when
connecting to the Microsoft SQL Server 2000. This option does

Chapter 1 Overview
10
not have a preset value.
This option and the uid and pass options cannot be
simultaneously specified.
server:instance_name Specify a computer name and an instance name in the following
format when connecting to a named instance.
computer_name\instance_name
If this option is omitted, a connection is made to the predetermined
instance.
The computer name must be either a local computer name, or a
virtual computer name in the MSCS (Microsoft Cluster Server)
environment.
remod:{recovery | norecovery | standby}
Specify the mode during the database recovery.
recovery Executes a command and simultaneously
recovers the database.
norecovery Recovers the target database in the state so that
the transaction log is applicable.
standby Recovers the database as a standby database. A
standby database file is specified by the refile
option.
If this option is omitted, the operation is the same as the operation
when recovery is specified.
refile:restore_file Specify a standby database file.
This option can be specified only when standby is specified by
the remod option. If recovery or norecovery is specified,
or if the remod option is omitted, an error occurs.
move:os_file_name[,...] When executing Snapshot Restore by the -norestore option
and when executing Restore by using a physical file that has a
different path from the backed up physical file, specify the
database’s data file path name and log file path name. As a file
name specified by os_file_name, specify the database’s data
file and log file in the full path by separating them by a comma.

Chapter 1 Overview
11
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.
Description of the database name cannot be omitted.
The operation target database must be unique.
Use a blank space or a tab character to separate the descriptions of the database name or the option
type.
Text displayed from the sharp (#) character to the end of the record is recognized as a comment.
If there is an error in the file syntax, operations to all databases described in the file become invalid.
If a character string includes a blank space (∆), enclose the entire character string in double
quotation marks (“).
The following is an example of a description of the database operation file:
# db:db_name
db:db01
# db:db_name uid:user_id pass:password
# db:db_name uid:user_id pass:password server:instance_name
db:db01 uid:guest pass:guestpass
db:db02 uid:administrator pass:adminpass server:localmachine\user_inst
# db:db_name input:
db:db01 input:
# db:db_name remod:restore_mode
# db:db_name remod:restore_mode refile:restore_file
db:db01 remod:norecovery
db:db03 remod:standby
"refile:d:\db_folder\db03_standby.mdf"
# db:db_name move:os_file_name[,...n]
db:db01 move:”f:\db folder\db01_Data2.mdf,g:\db_folder\db01_Log2.ldf”

Chapter 2 Command Reference
12
Chapter 2 Command Reference
2
2
2.
.
.1
1
1 V
V
Vo
o
ol
l
lu
u
um
m
me
e
e L
L
Li
i
is
s
st
t
t C
C
Cr
r
re
e
ea
a
at
t
ti
i
io
o
on
n
n/
/
/D
D
Di
i
is
s
sp
p
pl
l
la
a
ay
y
y
2
2
2.
.
.1
1
1.
.
.1
1
1
i
i
iS
S
SM
M
Mv
v
vo
o
ol
l
ll
l
li
i
is
s
st
t
t
(
(
(W
W
Wi
i
in
n
nd
d
do
o
ow
w
ws
s
s)
)
)
[ 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
iSMvollist -d
iSMvollist -dl disk_array [ld_number]
iSMvollist -de disk_array [ld_name]
iSMvollist -dd disk_array [drive |path]
iSMvollist -dp disk_array [disk_number]
iSMvollist -dh disk_array [HBT [LUN]]
iSMvollist -?
[ DESCRIPTION ]
The iSMvollist command creates and displays the table of logical disks and related information.
The options which start with “a” display the relations of ld_number/ld_name/VAA/OS
Type/drive/path HBT/LUN/disk_number/disk_array for all the disk arrays in the Volume List.
The options which start with “d” display the relations of ld_number/drive/path
HBT/LUN/disk_number/ld_name/OS Type for the specified disk arrays.
The Volume List can be created and displayed only with the devices recognized by the system.
The volume list is necessary when joint operation with the replication management is not
performed (the I/O issuance to disk arrays is directly controlled via FC).

Chapter 2 Command Reference
13


OPTIONS
The iSMvollist command recognizes the following options and arguments.
-cr 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.
-a Displays the relations for all the disk arrays in the
Volume List.
-al ld_number Displays the relations only for the logical disks specified
by ld_number.
-ae ld_name Displays the relations only for the logical disks specified
by ld_name.
-ad [drive |path]Displays the relations only for the drive names specified
by drive or path.
-ap disk_number Displays the relations only for the physical disk names
specified by disk_number.
-ah HBT [LUN]Displays the relations only for the host numbers, bus
numbers, and target IDs specified by HBT. If LUN is
specified, it displays the relations only for the specified
HBT and LUN.
-av volume_name Displays the relations only for the mount point volume
name specified in volume_name.
-d Displays the list of the disk arrays in the Volume List as
well as the number of logical drives in each disk array.
-dl disk_array [ld_number]Displays the relations for the disk arrays specified by
disk_array, sorted by the logical disk number as the
key.
If ld_number is specified, it displays the relations only
for the specified logical disk.

Chapter 2 Command Reference
14
-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.
If drive or path is specified, it displays the
relations only for the specified logical drive.
-dp disk_array [disk_number]Displays the relations for the disk arrays specified
by disk_array, sorted by the physical disk
number as the key.
If disk_number is specified, it displays the
relations only for the specified physical disk.
-dh disk_array [HBT [LUN]] Displays the relations for the disk arrays specified
by disk_array, sorted by HBT and LUN as the
keys.
If HBT is specified, it displays the relations only for
the specified HBTs.
Furthermore, if LUN is specified, it displays the
relations only for the specified HBT and LUN.
-? Displays the usage of this command.
[ DISPLAYED INFORMATION ]
C:\>iSMvollist -a
LDN LD Name VAA OS Type
HBT LUN DiskNo. DiskArray
Volume Name
Path
ldn ld-name VAA type
hbt lun disk-no disk_array
volume-name
path
C:\>

Chapter 2 Command Reference
15
Description of messages:
LDN Logical disk number
LD Name Logical disk name
VAA Volume Absolute Address
OS Type Type of operating system
HBT Host adapter number, bus number, target ID
LUN LUN (Logical unit number)
Disk No. Physical disk number
Disk Array Disk array name
Volume Name Mount point volume name
Path Drive letters or path name of the NTFS folder
[ USAGE ]
The command creates the Volume List.
C:\>iSMvollist -cr
iSMvollist: Info: iSM11700: Please wait a minute.
iSMvollist: Info: iSM11701: Volume list is created successfully.
C:\>
The command displays the Volume List with the logical disk name specified.
C:\>iSMvollist -ae dev001
LDN LD Name VAA OS Type
HBT LUN DiskNo. DiskArray
Volume Name
Path
030ch dev001 3000000000000002030c WN
h4b0t35 000h disk2 NECStorage4100/1007
\\?\Volume{674de734-ee66-11d5-95d8-00004c792133}\
H:
C:\>
[ NOTES ]
•While updating or creating a Volume List, you cannot create, update, or display the Volume
List or execute replication operation commands.
[ 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.