symmaskdb

Allows the administrator to back up, restore, initialize, and show the contents of the device masking VCMDB. Also provides limited conversion and attribute options.

SYNOPSIS symmaskdb -h symmaskdb -sid <SymmID> | -file <FileName> [-v] list database [-dir all [-p all] | -dir <#>

[-p <#|all>]][-wwn <wwn> | -awwn <awwn> |

-iscsi <iscsi> | -aiscsi <aiscsi>] symmaskdb -sid <SymmID> | -file <FileName> list devs [-wwn <wwn> | -awwn <awwn> |

-iscsi <iscsi> | -aiscsi <aiscsi>] symmaskdb -sid <SymmID> list assignment [-v] -devs <<SymDevStart>:<SymDevEnd> |

<SymDevName> | <<SymDevName>,<SymDevName>...>> list no_assignment [-dir all [-p all] |

-dir <#> [-p <#|all>]] list capacity -host <HostName> symmaskdb -sid <SymmID> [-noprompt] -file <FileName> restore [-skip_authentication]

[-vcmdb_type <4 | 5>] backup

Chapter 1: SYMCLI Commands

symmaskdb 451

Chapter 1: SYMCLI Commands symmaskdb -sid <SymmID> -file <FileName> init [-vcmdb_type <3 | 4 | 5>] symmaskdb -sid <SymmID> [-noprompt] convert [-vcmdb_type <4 | 5> -file <FileName>] set no_direct_io |direct_io remove -meta_member

DESCRIPTION

The symmaskdb command provides the following options:

- Lists the device masking VCMDB.

- Lists the devices assigned to an HBA in the device masking VCMDB.

- Lists which HBAs have been assigned to the given devices.

- Lists which devices mapped to a given director and port have not yet been assigned.

- Lists the capacity of devices assigned to a particular host.

- Restores the device masking database from a backup file stored on the host.

- Backs up the device masking database to a user-named file on the host.

- Initializes the device masking database and also

452 EMC Solutions Enabler CLICommand Reference

requires a user-named file on the host for an initial backup.

- Converts a Type 3 or Type 4 database to a Type 4 or

Type 5. Type 4 databases require a database device of at least 48 cylinders, and Type 5 requires at least

96 cylinders.

- Blocks direct I/O writes to the database area.

- Removes metamembers from the device masking database, while keeping the metaheads in place.

ARGUMENTS backup         Specifies a backup of the database to be copied to a given file.

convert        Converts the database from a Type 3 to a Type 4 or Type 5 database or converts the database from a Type 4 to a Type 5 database.

init           Initializes the database.

list           Lists various records in the database.

remove         Removes the metamember devices.

restore        Restores the database from a given file.

set            Allows setting of the [no_]direct_io attribute.

KEYWORDS assignment     Names the HBAs that are assigned in the device masking VCMDB.

Chapter 1: SYMCLI Commands

symmaskdb 453

Chapter 1: SYMCLI Commands capacity       Specifies the size of the device.

database       Lists records within the device masking

VCMDB.

devs           Lists devices assigned by records in the device masking VCMDB.

direct_io      Directly reads and writes from the host to the VCMDB device.

no_assignment  Lists devices that are mapped, but not yet assigned, in the device masking VCMDB.

no_direct_io   Blocks direct reads and writes from the host to the VCMDB device.

OPTIONS

-aiscsi        Specifies a user-given name, or alias iSCSI name.

-awwn          Specifies a user-given name, or alias WWN.     

-devs          Specifies a set of Symmetrix device ranges and/or individual Symmetrix devices.

-dir           Applies a director number designation.

-file          Applies a backup file to the specified action.

-h             Provides brief, online help information.

-host          Specifies the host name.

454 EMC Solutions Enabler CLICommand Reference

-iscsi         Specifies the iSCSI name.

-meta_members  Specifies the metamembers, other than the metaheads.

-noprompt      Requests that no prompts are returned after the command is entered. The default is to prompt the user for confirmation.

-p             Applies a port number designation.

-sid           Specifies the unique Symmetrix ID.

-skip_authentication 

Skips over the authentication information in a backup file and does not restore it.

-v             Provides a more detailed, verbose listing.

-vcmdb_type    Specifies the type of database. Possible values are:

Value    Description

----- -----------------

3      24 cylinders, allowing up to 32 fibre or iscsi connections per port.

4      48 cylinders, allowing up to 64 fibre connections or

128 iscsi connections per port.

5      96 cylinders, allowing up to 64 fibre connections or 128 iSCSI connections per port.

-wwn           Applies a World Wide Name (WWN).

Chapter 1: SYMCLI Commands

symmaskdb 455

Chapter 1: SYMCLI Commands

PARAMETERS

#              A specific director or port number.

aiscsi         A user-given name in two parts, separated by a slash (/).

all            All fibre directors or ports.

awwn           A user-given name, in two parts separated by a slash (/).

FileName       The name of the device masking backup file.

HostName       The host name.

iscsi          The iSCSI name.

SymDevEnd   The end of a range of logical devices.

SymDevName     A Symmetrix device to be added or removed.

SymDevStart    The start of a range of logical devices.

SymmID         The 12-digit ID of the Symmetrix array.

wwn            The system-generated World Wide Name.

456 EMC Solutions Enabler CLICommand Reference