Configure Network Communication

Create a NAS server.

NOTE:  The NFSv3 protocol is enabled by default when creating a NAS server.

Format

Action qualifiers

Qualifier	Description
-name	Specifies the NAS server name. NOTE:  NAS server names can contain alphanumeric characters, a single dash, and a single underscore. Server names cannot contain spaces or begin or end with a dash. You can create NAS server names in four parts that are separated by periods (example: aa.bb.cc.dd). Names can contain up to 255 characters, but the first part of the name (before the first period) is limited to 15 characters.
-sp	Specifies the parent SP for the NAS server. Value is SPA or SPB.
-pool	Specifies the ID of the storage pool for the NAS server.
-poolName	Specifies the name of the storage pool for the NAS server.
-tenant	Specifies the tenant identifier. NOTE:   If a tenant is not specified, the NAS server is created in the default network namespace.
-mpSharingEnabled	Indicates whether multiprotocol sharing mode is enabled. Value is yes or no (default).
-unixDirectoryService	Directory Service used for querying identity information for Unix (such as UIDs, GIDs, net groups). Valid values are: nis ldap local none (default) localThenNis localThenLdap
-autoUserMappingEnabled	Indicates whether a Windows user who is not mapped to a known Unix/Linux username is allowed to access the NAS server's files Valid values are: yes— The system generates an internal UID for the Windows user and allows access to the NAS server's files through Windows. no (default)— The Windows authentication fails unless there is a default Unix username configured.
-defaultUnixUser	Default Unix user name or Unix ID that grants file access in the multiprotocol sharing mode. This user name or ID is used when the corresponding Unix/Linux user name or ID is not found by the mapping mechanism. The Unix ID format is @uid=xxxx,gid=yyyy@, where xxxx and yyyy are the decimal numerical values of the UID and the primary GID, respectively. When using this ID, the user does not need to be defined in the UDS.
-defaultWindowsUser	Default Windows user name that grants file access in the multiprotocol sharing mode. This user name is used when the corresponding Windows user name is not found by the mapping mechanism.
-replDest	Replication destination settings for the NAS server. When this option is set to yes, only mandatory parameters may be included. All other optional parameters will be inherited from the source NAS server. Valid values are: yes no (default)
-backupOnly	Indicates whether to create NAS server as backup only. The backup only NAS server cannot be a production site, which means both planned failover and unplanned failover are disallowed in a backup only NAS server associated replication session. Valid values: yes no
-enablePacketReflect	Indicates whether the reflection of outbound (reply) packets through the same interface that inbound (request) packets entered is enabled. Valid values are: yes (default) no

Example

The following command creates a NAS server with these settings:

• Name is NasServer_1.
• Associated with SP A.
• Associated with storage pool pool_0.
• IP Packet Reflect is enabled.
• The ID of the new NAS server is ID nas_1.

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = nas_1
Operation completed successfully.

                        

View details about configured NAS servers, including their name, ID, and whether they have enabled support for CIFS (SMB) file systems or NFS file systems. You can filter on the NAS server ID.

NOTE:   The show action command explains how to change the output format.

Format

Object qualifiers

Example

The following command displays all details for a list of all configured NAS servers:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection
 
1:    ID                                          = nas_1
      Name                                        = MyVDM1
      NetBIOS name                                =
      SP                                          = spa
      Storage pool                                = pool_1
      Tenant                                      =
      Interface                                   =
      NFS enabled                                 = yes
      NFSv4 enabled                               = no
      CIFS enabled                                = no
      Workgroup                                   =
      Windows domain                              =
      Multiprotocol sharing enabled               = no
      Unix directory service                      = none
      Auto user mapping enabled                   =
      Default Unix username                       =
      Default Windows username                    =
      Extended Unix credentials enabled           = no
      Credentials cache retention                 = 15m
      Username translation                        =
      Packet Reflect enabled                      = yes
      Health state                                = OK (5)
      Health details                              = "The component is operating normally. No action is required."
      Replication type                            = none
      Synchronous replication type                = none
      Replication destination                     = no
      Backup only                                 = no
      Migration destination                       = no
      Preferred production interfaces overridden  =
      Preferred production IPv4 interface         = auto
      Preferred production IPv6 interface         = auto
      Preferred backup and DR test IPv4 interface = auto
      Preferred backup and DR test IPv6 interface = auto
      Source preferred production IPv4 interface  =
      Source preferred production IPv6 interface  =
      File space used                             = 8945901568 (8.3G) 
      Compression space saved                     = 0
      Compression percent                         = 0%
      Compression ratio                           = 1:1
      Data Reduction space saved                  = 0
      Data Reduction percent                      = 0%
      Data Reduction ratio                        = 1:1
                        

Modify an existing NAS server.

Format

Object qualifiers

Action qualifiers

Qualifier	Description
-name	Shared folder server name.
-sp	Owner SP. Valid values are: spa spb
-mpSharingEnabled	Indicates whether multiprotocol sharing mode is enabled. Valid values are: yes no NOTE:  You cannot disable multiprotocol file sharing for a NAS server once a file system is created on that NAS server.
-unixDirectoryService	Directory Service used for querying identity information for Unix (such as UIDs, GIDs, net groups). Valid values are: nis ldap
-defaultAccessDisabled	Disables file access when no user mapping mechanism is found.
-autoUserMappingEnabled	Indicates whether a Windows user who is not mapped to a known Unix/Linux username is allowed to access the NAS server's files Valid values are: yes. The system generates an internal UID for the Windows user and allows access to the NAS server's files through Windows. no (default). The Windows authentication fails unless there is a default Unix username configured.
-defaultUnixUser	Default Unix user name or Unix ID that grants file access in the multiprotocol sharing mode. This user name or ID is used when the corresponding Unix/Linux user name or ID is not found by the mapping mechanism. The Unix ID format is @uid=xxxx,gid=yyyy@, where xxxx and yyyy are the decimal numerical values of the UID and the primary GID, respectively. When using this ID, the user does not need to be defined in the UDS.
-defaultWindowsUser	Default Windows user name that grants file access in the multiprotocol sharing mode. This user name is used when the corresponding Windows user -defaultWindowsUser name is not found by the mapping mechanism.
-enablePacketReflect	Indicates whether the reflection of outbound (reply) packets through the same interface that inbound (request) packets entered is enabled. Valid values are: yes no
-replDest	Replication destination settings for the NAS server. Valid values are: yes no
-backupOnly	Indicates whether the NAS server is used as backup. Only a replication destination NAS server can be set as backup only. This attribute reflects that the NAS server cannot be the production site. This means both planned failover and unplanned failover are disallowed in the backup only NAS server associated replication session. Valid values are: yes no
-preferredProductionOverride	Override the replicated production interfaces "preferred interface" settings. Valid values are: yes no
-preferredProductionIPv4	Production IPv4 preferred interface settings. The interface must be IPv4 and belong to this server. Valid values are: <interface ID> auto
-preferredProductionIPv6	Production IPv6 preferred interface settings. The interface must be IPv6 and belong to this server. Valid values are: <interface ID> auto
-preferredBackupIPv4	Backup and DR test IPv4 preferred interface settings. The interface must be IPv4 and belong to this server. Valid values are: <interface ID> auto
-preferredBackupIPv6	Backup and DR test IPv6 preferred interface settings. The interface must be IPv6 and belong to this server. Valid values are: <interface ID> auto

Example 1

The following command updates NAS server nas_1 with these settings:

• Enables multiprotocol sharing.
• Uses LDAP as the Unix Directory Service.

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = nas_1
Operation completed successfully.
                        

Example 2

The following command changes the replication settings for NAS server nas_1.

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = nas_1
Operation completed successfully.
                        

Example 3

The following command changes the storage processor to SPB for NAS server nas_1.

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

WARNING: Modifying the NAS server's SP disrupts any running NDMP jobs, and may also result in data unavailability for some client configurations other than NFS (v3, v4, and v4.1) and SMB3+CA. The NDMP jobs must be restarted after the SP modification is completed. 
Are you sure you want to modify the default SP? 
yes / no:yes

ID = nas_1
Operation completed successfully.
                        

NOTE:   When the SP is being modified, the NAS server health attribute is updated to INFO, and the health details attribute is updated to Transitioning to other Storage Processor. When the SP modification completes, the NAS server health and health details are reverted back to the previous values. A change to the SP cannot be performed on a NAS Server that is part of an active VDM File Import operation. The Import operation must be completed before the SP can be changed. Otherwise, the following error occurs: Failed: Cannot complete the operation because the resource is under import. (Error Code:0x900012a). A change to the SP cannot be performed on a NAS Server that is part of an active replication session. Pause the replication session, perform the SP change, and then resume the replication session. Otherwise, the following error occurs: Cannot modify the NAS server's Storage Processor when there are non-paused replication sessions on the NAS server or its file systems. (Error Code:0x6720665).

Delete a NAS server.

Prerequisites

Before you can delete a NAS server, you must first delete all storage resources associated with it.

NOTICE:  Deleting a NAS server removes everything configured on the NAS server, but does not delete the storage resources that use it. You cannot delete a NAS server while it has any associated storage resources. After the storage resources are deleted, the files and folders inside them cannot be restored from snapshots. Back up the data from the storage resources before deleting them from the system.

Format

Object qualifiers

Action qualifiers

Qualifier	Description
-cifsDomUser	Domain username. NOTE:  If the NAS server still has SMB (CIFS) servers joined to it, specify the SMB domain user to unjoin from AD before deleting the NAS server.
-cifsDomPwd	Domain user password. NOTE:  Specify the user password when you want to unjoin the CIFS server from the AD domain before deleting it.
-cifsDomPwdSecure	Domain user password in secure mode. This prompts the user to input the password.
-skipUnjoin	Does not unjoin the SMB server from the AD domain before deleting it.

Example

The following command deletes NAS server nas_1:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.


                        

A multiprotocol environment requires the following types of user mappings:

• A Windows user name that maps to a corresponding Unix user name
• A Unix user name that maps to a corresponding Windows user name which uses NFS to access a file system configured with a Windows access policy
• A Unix user name that is not mapped to a corresponding Windows user name which uses NFS to access a file system configured with a Unix or native access policy.

This command uses information from LDAP, NIS, or local files to parse all file systems associated with the NAS server and to update the SID/UID mapping in all nodes.

Format

Object qualifiers

Action qualifiers

Qualifier	Description
-async	Perform the operation asynchronously.
-userMapping	For all CIFS (SMB) file systems on the NAS server, update the UID/GID and generate a user mapping report. A new UID/GID will be obtained from a Unix Directory Service for the user name of the object owner. The user name will be resolved from Active Directory by the Windows SID. NOTE:  Quota management and correct multiprotocol file access require correct mappings between SIDs and UIDs/GIDs at the NAS server level. Because this operation can take a significant amount of time for large file systems, it is recommended to use the -async qualifier.
-dryRun	Generate a user mapping report for downloading. Once users access a file or folder on the NAS server from the SMB protocol, their SID to UID/GID mapping is stored in an internal mapping database. This operation parses the mapping database, and for each mapped user, queries the existing Unix Directory Service and Active Directory Domain Controller to report any inconsistencies between the UID/GID in the Unix Directory Service and the UID/GID stored in the database. It is recommended that you generate and review the user mapping report right before enabling multiprotocol. This enables you to ensure that your Unix Directory Service can return a UID/GID for every user whose mapping is inconsistent. Otherwise, after multiprotocol is enabled, users with inconsistent mappings may not be able to access files, because their permissions cannot be determined. Also, access to objects created by these users from SMB/CIFS cannot be granted, because the owners cannot be mapped to Unix. When the UID/GID mapping for all NAS server file systems are updated, the mapping report is re-generated automatically. NOTE:  Once a user successfully accesses any file or folder on the NAS server from Windows, the UID/GID in the mapping database for this user is updated. The UID/GID is also updated if the user is accessing a file from Unix for a file system with a Windows access policy.
-confView	Force an immediate refresh of the NAS server configuration snapshot. When the NAS server is acting as replication destination of synchronous replication session, its configuration snapshot is updated every 15 minutes by default.

Example 1

The following command generates a user mapping report for NAS server nas_1.

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Job ID = 76
Job created successfully.
                        

Example 2

The following command forces an immediate refresh of NAS server nas_1 snapshot.

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = nas_1
Operation completed successfully.
                        

View details about configured VLANs. You can filter on the ID of the VLAN.

Format

Action qualifiers

Example

The following command displays information for VLANs that are in use starting from 100:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:     VLAN      = 101
       Tenant    = tenant_1
       Interface = if_1,if_3
 
2:     VLAN      = 105
       Tenant    =
       Interface = if_5

                        

Create a tenant.

Format

Action qualifiers

Qualifier	Description
-name	Specify the tenant name.
-uuid	Specify the Universally Unique Identifier of a tenant.
-vlan	Specify the comma-separated list of VLAN IDs that the tenant can use. NOTE:  Valid values are 1 to 4095; however, each specific VLAN ID can be assigned to a tenant if: It is not assigned to any other tenant. No existing network interfaces are tagged with the VLAN ID.

Example

The following command creates a tenant with these settings:

• Tenant name is Tenant A.
• UUID is b67cedd7-2369-40c5-afc9-9e8753b88dee.

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = tenant_1
Operation completed successfully.

                        

View details about configured tenants. You can filter on the ID of the tenant.

Format

Object qualifier

Example

The following command displays tenant information:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:     ID     = tenant_1
       Name   = Tenant A
       UUID   = b67cedd7-2369-40c5-afc9-9e8753b88dee
       VLAN   = 102,103,104

                        

Change the settings for a tenant.

Format

Object qualifier

Action qualifiers

Qualifier	Description
-name	Specify the new name of the tenant.
-vlan	Specify the comma-separated list of VLAN IDs. NOTE:   Valid values for VLAN IDs are 1 to 4095. The new set of VLAN IDs is compared against VLAN IDs already assigned to this tenant. Mismatches are interpreted as if respective IDs were passed to -addVlan or -removeVlan qualifiers. For example, if VLANs 101,102, and103 are assigned to tenant X, the command: tenant -id X set -Vlan 101,102,104 is equivalent to: tenant –id X set –removeVlan 103 tenant –id X set –addVlan 104
-addVlan	Specify the VLAN ID to be assigned to the tenant. NOTE:   Valid values for VLAN IDs are 1 to 4095; however, each specific VLAN ID can be assigned to a tenant if: It is not assigned to any other tenant. No existing network interfaces are tagged with the VLAN ID.
-removeVlan	Specify the VLAN ID to be removed from the tenant. NOTE:   The VLAN ID can be removed only if it is not in use by any interface of any NAS server within this tenant.

Example

The following command changes the tenant settings for the list of VLAN IDs:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.
                        

Deletes an existing tenant. When you delete an existing tenant, the VLANs associated with that tenant become available for use with other tenants.

Format

Object qualifiers

Example

The following command deletes a tenant.

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = tenant_1
Operation completed successfully.
                        

Create a CIFS (SMB) server.

NOTE:  Only one CIFS server per NAS server can be created.

Format

Action qualifiers

Example

The following command creates a CIFS server.

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = CIFS_0
Operation completed successfully.
                        

The following command displays CIFS (SMB) server settings.

Format

Object qualifiers

Example

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:     ID             = CIFS_0
       NAS server     = nas_0
       Name           = CIFSserver1
       Description    = CIFS description
       NetBIOS name   = CIFSserv
       Windows domain = domain.one.com


                        

Modify an existing CIFS (SMB) server.

If moving a CIFS server from one domain to another, include the following options:

• [-domain <value>]
• [-newUsername <value> {-newPasswd <value> | -newPasswdSecure}]

Note that you must specify the username and password of the domain to which the CIFS server was previously joined in order to perform the unjoin. You must also specify the user name and password of the new domain to which it will be joined.

Format

Object qualifiers

Action qualifiers

Example

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = CIFS_0
Operation completed successfully.


                        

Delete an existing CIFS (SMB) server.

NOTE:  When you delete an existing CIFS server or convert it to a stand-alone configuration, you must specify the current credentials (username and password) to properly unjoin it from the domain and remove the computer account from Active Directory. You can use the -skipUnjoin option to delete the CIFS server without removing the computer account from AD. (This will require the administrator to manually remove the account from AD.) The -skipUnjoin option can also be used when AD is not operational or cannot be reached. If you ran this command without the username and password, you will not be able to join the CIFS server with the same name back again. To join the same CIFS server back to the domain, you will then need to first change its name.

Format

Object qualifiers

Action qualifiers

Qualifier	Description
-username	Specifies the domain username. Not required for stand-alone CIFS servers. NOTE:  Specify the username when you want to unjoin the CIFS server from the AD domain before deleting it.
-passwd	Specifies the domain user password. Not required for stand-alone CIFS servers. NOTE:  Specify the user password when you want to unjoin the CIFS server from the AD domain before deleting it.
-passwdSecure	Specifies the password in secure mode. This prompts the user to input the password.
-skipUnjoin	Does not unjoin the CIFS server from the AD domain before deleting it.

Example

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = CIFS_0
Operation completed successfully.

                        

Create an NFS server.

NOTE:  Only one NFS server per NAS server can be created.

Format

Action qualifiers

Example

The following command creates an NFS server on NAS server nas_1 with ID nfs_1 that supports NFSv4 and NFS secure.

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = nfs_1
Operation completed successfully.


                        

The following command displays NFS server settings.

Format

Object qualifiers

Example

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:     ID                                = nfs_1
       NAS server                        = nas_1
       Hostname                          = SATURN
       NFSv3 enabled                     = yes
       NFSv4 enabled                     = yes
       Secure NFS enabled                = yes
       Kerberos KDC type                 = Windows
       Service principal name            = nfs/SATURN.domain.lab.emc.com, nfs/SATURN
       Extended Unix credentials enabled = no
       Credentials cache retention       = 15 

                        

Modify an existing NFS server.

Format

Object qualifier

Action qualifiers

Example

The following command changes the credit cache retention period for NFS server nfs_1.

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = nfs_1
Operation completed successfully.

                        

Delete an existing NFS server. The NFS server cannot be deleted if it has any associated resources, such as NFS shares, on the NAS server.

Format

Object qualifier

Action qualifiers

Example

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.
                        

View details about CAVA settings.

Format

Object qualifier

Example

The following command displays the CAVA settings:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection


1:     NAS server  = nas_0
       Enabled     = yes

2:     NAS server  = nas_1
       Enabled     = no
                        

Modify the CAVA settings.

Format

Object qualifier

Action qualifier

Qualifier	Description
-enabled	Specify whether CAVA is enabled. Valid values are: yes no NOTE:  Before you can enable CAVA, you must first upload a CAVA configuration file to the NAS server. See View the switches for details on how to upload the configuration file.

Example

The following command enables CAVA:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.
                        

View details about CEPA configuration settings.

Format

Object qualifier

Example

The following example displays the CEPA settings.

                          Storage system address: 10.1.2.100
Storage system port: 443
HTTPS connection

1:     NAS server                = nas_1
       Enabled                   = yes    
       Pre-event failure policy  = ignore
       Post-event failure policy = ignore
       HTTP port                 = 12228
       HTTP enabled              = yes
       Username                  = user1
       Heartbeat                 = 10s
       Timeout                   = 1000ms
       Health state              = OK (5)
       Health details            = The Events Publishing Service is operating normally.
                        

Modify the Events Publishing configuration. When you create a NAS server, an Events Publishing configuration object is automatically created with default values.

Format

Object qualifier

Action qualifiers

Qualifier	Description
-enabled	Identifies whether Events Publishing is enabled on the NAS Server. Valid values are: yes no (default)
-preEventPolicy	Identifies the policy applied when a pre-event notification fails. Valid values are: ignore (default) - indicates that when a pre-event notification fails, it is acknowledged as being successful. deny - indicates that when a pre-event notification fails, it is acknowledged with a 'denied' answer.
-postEventPolicy	Identifies the policy applied when a post-event notification fails. The policy is also applied to post-error events. Valid values are: ignore (default) - continue and tolerate lost events. accumulate - continue and use a persistence file as a circular event buffer for lost events. guarantee - continue and use a persistence file as a circular event buffer for lost events until the buffer is filled, and then deny access to file systems where Events Publishing is enabled. deny - on CEPA connectivity failure, deny access to file systems where Events Publishing is enabled.
-httpPort	HTTP port number used for connectivity to the CEPA server. The default value is 12228. The HTTP protocol is used to connect to CEPA servers. It is not protected by a username or password.
-httpEnabled	Specifies whether connecting to CEPA servers by using the HTTP protocol is enabled. When enabled, a connection by using HTTP is tried first. If HTTP is either disabled or the connection fails, then connection through the MS-RPC protocol is tried if all CEPA servers are defined by a fully-qualified domain name (FQDN). The SMB account of the NAS server in the Active Directory domain is used to make the connection by using MS-RPC. Valid values are (case insensitive): yes (default) no
-username	Name of a Windows user who is allowed to connect to CEPA servers. NOTE:  To ensure that a secure connection (by using the Microsoft RPC protocol) is used, you must disable HTTP by setting -httpEnabled=no.
-passwd	Password of the Windows user defined by the username.
-passwdSecure	Specifies the password in secure mode. The user is prompted to specify the password.
-heartbeat	Time interval between scanning CEPA servers (in seconds) to detect their online or offline status. The default is 10 seconds. The range is from 1 through 120 seconds.
-timeout	Time in ms to determine whether a CEPA server is offline. The default is 1,000 ms. The range is from 50 ms through 5,000 ms.

Example

The following command enables Events Publishing and sets the post-event policy to accumulate.

                          Storage system address: 10.1.2.100
Storage system port: 443
HTTPS connection

Operation completed successfully.
                        

Create a CEPA pool.

Format

Action qualifiers

Example

The following command creates a CEPA pool and a list of post events for which to be notified.

                          Storage system address: 10.1.2.100
Storage system port: 443
HTTPS connection

ID = cepa_pool_1
Operation completed successfully.
                        

View details about a CEPA pool.

Format

Object qualifier

Example

The following command displays information about a CEPA pool.

                          Storage system address: 10.1.2.100
Storage system port: 443
HTTPS connection

1:     ID                 = cepa_pool_1
       NAS server         = nas_1
       Name               = MyCepaPool
       Addresses          = 10.1.2.2
       Pre-events         = 
       Post-events        = CreateFile, DeleteFile
       Post-error events  =
                        

Modify settings for an existing Events Publishing pool.

Format

Object qualifier

Action qualifiers

Example

The following command changes the name for a CEPA pool.

                          Storage system address: 10.1.2.100
Storage system port: 443
HTTPS connection

ID = cepa_pool_1
Operation completed successfully.
                        

Deletes a CEPA pool.

Before you begin

The Events Publishing service requires at least one CEPA pool. If you delete the last CEPA pool, the Events Publishing service becomes disabled.

Format

Object qualifiers

Example

The following command deletes a CEPA pool.

                          Storage system address: 10.1.2.100
Storage system port: 443
HTTPS connection

Operation completed successfully.
                        

Create VMware protocol endpoints servers for File VVols.

Format

Action qualifier

Example

The following example creates a protocol endpoint server on NAS server "nas_1" with the IP interface "if_1".

                          Storage system address: 10.0.0.1 
Storage system port: 443 
HTTPS connection 

ID = PES_0 
Operation completed successfully. 
                        

View VMware protocol endpoints servers for File VVols.

Format

Action qualifier

Example

The following example shows the details for all of the VMware protocol endpoint servers on the system.

                          Storage system address: 10.0.0.1 
Storage system port: 443 
HTTPS connection 

1:     ID                   = PES_0
       NAS server           = nas_1
       NAS server interface = if_1 
                        

Delete a VMware protocol endpoints server.

Format

Object qualifiers

Action qualifiers

Example

The following example deletes VMware NAS protocol endpoint server "PES_0".

                          Storage system address: 10.0.0.1 
Storage system port: 443 
HTTPS connection 

Operation completed successfully. 
                        

The following table lists the iSCSI reverse CHAP attributes.

Sets the reverse CHAP username and secret.

Format

Action qualifiers

Qualifier	Description
-username	The reverse CHAP user name.
-secret	Specifies the reverse CHAP secret (password). NOTE:  Restrictions: the CHAP secret is an ASCII string that is 12 to 16 characters. Hexadecimal secrets are 12 to 16 pairs of data (24 to 32 characters).
-secretSecure	Specifies the password in secure mode - the user will be prompted to input the password.
-secretFormat	The reverse CHAP input format. Value is one of the following: ascii - ASCII format hex - Hexadecimal format
-noChap	Remove the reverse CHAP credentials.

Example

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.

                        

View whether a reverse CHAP secret password has been configured for iSCSI nodes.

NOTE:   The show action command explains how to change the output format.

Format

Example

The following command shows the current reverse CHAP setting:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:       Username = ReverseChapUser

                        

Create an iSNS server record to specify an iSNS server for the system to use. When you create an iSNS server record, it will overwrite the existing record on the system.

Format

Action qualifiers

Example

The following command creates an iSNS server record for server IP address 10.5.2.128. The server record receives the ID iSNS_10.5.2.128:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = isns_0
Operation completed successfully.

                        

View details for configured iSNS server records.

NOTE:   The show action command explains how to change the output format.

Format

Example

The following command shows details for the iSNS server record:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = isns_0
Operation completed successfully.

                        

Delete an iSNS server record.

Format

Object qualifier

Example

The following command deletes the iSNS server record isns_0:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.

                        

Modify an existing iSNS server record.

Format

Object qualifier

Action qualifiers

Example

The following command modifies the iSNS server record:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = isns_0
Operation completed successfully.

                        

View details about the iSCSI configuration.

Format

Example

The following command shows details for the iSCSI configuration:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1: CHAP required = yes

                        

Modify the iSCSI configuration.

Format

Object qualifier

Example

The following command denies host access without CHAP authentication:

                          Storage system address:10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.

                        

View details about iSCSI nodes. You can filter on the iSCSI node ID.

NOTE:   The show action command explains how to change the output format.

Format

Object qualifier

Example

The following command lists all iSCSI nodes on the system:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:     ID           = ISCSIN_1
       Alias        = MyISCSIserver1
       IQN          = iqn.1992-05.com.emc:fcnch0821001340000-1         
       Health state = OK (5)
       SP           = SPA
       Port         = eth0_SPA
       Interfaces   = IF_1,IF_2

2:     ID           = ISCSIN_2
       Name         = MyISCSIserver2
       IQN          = iqn.1992-05.com.emc:fcnch0821001340001-1          
       Health state = OK (5)
       SP           = SPA
       Port         = eth1_SPA
       Interfaces   = IF_3
                        

Change the network interface alias assigned to the node.

Format

Object qualifier

Action qualifier

Example

The following command assigns an alias to the ISCSIN_1 node:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = ISCSIN_1
Operation completed successfully.

                        

View details about the network ports. You can filter on the port ID.

NOTE:   The show action command explains how to change the output format.

Format

Object qualifier

Example

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:    ID                      = spa_eth2
      Name                    = SP A Ethernet Port 2
      SP                      = spa
      Protocols               = file, net, iscsi
      MTU size                = 4500
      Requested MTU size      = 4500
      Available MTU sizes     = 1280-9216
      Linux device name       = eth2
      Speed                   = 1 Gbps
      Requested speed         = auto
      Available speeds        = 1 Gbps, 10 Gbps, 100 Mbps, auto
      Health state            = OK (5)
      Health details          = "The port is operating normally."
      Aggregated port ID      = None
      FSN port ID             = None
      Connector type          = RJ45
      MAC address             = 00:60:16:7A:7F:CF
      SFP supported speeds    =
      SFP supported protocols =

2:    ID                      = spa_eth3
      Name                    = SP A Ethernet Port 3
      SP                      = spa
      Protocols               = file, net, iscsi
      MTU size                = 1500
      Requested MTU size      = 1500
      Available MTU sizes     = 1500, 9000
      Linux device name       = eth3
      Speed                   = 1 Gbps
      Requested speed         = auto
      Available speeds        = 1 Gbps, 10 Gbps, 100 Mbps, auto
      Health state            = OK (5)
      Health details          = "The port is operating normally."
      Aggregated port ID      = None
      FSN port ID             = None
      Connector type          = RJ45
      MAC address             = 00:60:16:7A:7F:CE
      SFP supported speeds    =
      SFP supported protocols =
                        

NOTE:  The new settings are applied to a pair of symmetrical ports on dual SP systems.

Change the maximum transmission unit size and port speed for an Ethernet port.

Format

Object qualifier

Action qualifier

Example

The following command sets the MTU size for Ethernet port 0 (eth0) on SP A to 9000 bytes:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = spa_eth0
ID = spb_eth0
Operation completed successfully.
                        

View details about the SAS ports. You can filter on the port ID.

NOTE:   The show action command explains how to change the output format.

Format

Object qualifier

Example

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:     ID           = spa_sas0
       Name         = SP A SAS Port 0
       SP           = spa
       Speed        = 
       Health state = OK_BUT (7)

2:     ID           = spa_sas1
       Name         = SP A SAS Port 1
       SP           = spa
       Speed        = 6 Gbps
       Health state = OK (5)
                        

View details about the FC ports. You can filter on the port ID.

Format

Object qualifier

Example

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:     ID                      = spa_fc4
       Name                    = SP A FC Port 4
       SP                      = spa
       WWN                     = 50:06:BD:01:60:05:8E:50:06:01:64:3D:E0:05:8E
       Speed                   = 1 Gbps
       Requested speed         = auto
       Available speeds        = 4 Gbps, 8 Gbps, 16 Gbps, auto
       Health state            = OK (5)
       Health details          = "The port is operating normally."
       SFP supported speeds    = 4 Gbps, 8 Gbps, 16 Gbps
       SFP supported protocols = FibreChannel
       Replication capability  = Sync replication
       SFP supported mode      = Multimode
                        

Change the speed for an FC port.

Format

Object qualifier

Action qualifier

Example

The following command sets the speed for FC port fc1 on SP A to 1 Gbps:

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

ID = spa_fc1
Operation completed successfully.