• Configure replication using the CLI

    PDF

    Configure replication using the CLI

    Manage network interfaces

    Create interfaces to enable and control access between the system, the network, and configured hosts. Specify the IP address for the interface as well as the IP addresses for the subnet mask and gateway.

    You can create the following types of interfaces:

    • iSCSI interfaces for controlling access to iSCSI storage. You assign the interface to an iSCSI node.
    • Replication interfaces for replication-related data or management traffic.

    The system configures each interface on a pair of symmetrical SP ports. The interface can be moved between SPs. You have the option of indicating which SP the interface will use, either a physical port or a link aggregation port. You also have the option of specifying a virtual LAN (VLAN) ID, for communicating with VLAN networks.

    Each interface is identified by an ID.

    The following table lists the interface attributes with a description of each.

    Table 1. Interface attributes
    Attribute
    Description
    ID
    ID of the interface.
    Type
    Interface type. Value is one of the following:
    • iscsi — Interface for iSCSI storage.
    • replication — Interface for replication-related data or management traffic.
    Port
    ID of the physical port or link aggregation on an SP on which the interface is running. The ID includes the port name and SP name.
    VLAN ID
    Virtual local area network (VLAN) ID for the interface. The interface uses the ID to accept packets that have VLAN tags. The value range is 1-4095.
    If no VLAN ID is specified, which is the default, packets do not have VLAN tags. The Unisphere online help provides more details about VLANs.
    IP address
    IPv4 or IPv6 address.
    Subnet mask
    IPv4 subnet mask.
    Gateway
    IPv4 or IPv6 gateway.
    MAC address
    MAC address of the interface.
    SP
    SP that uses the interface.
    Health state
    A numerical value indicating the health of the system. Value is one of the following:
    • Unknown (0)
    • OK (5)
    • OK BUT (7)
    • Degraded/Warning (10)
    • Minor failure (15)
    • Major failure (20)
    Health details
    Additional health information.

    Create interfaces

    Create an interface.

    Format
    /net/if create [-vlanId <value>] -type { -server <value> | iscsi} -port <value> | mgmt | replication} -origin {dynamic | static -addr <value>] [-netmask <value>] [-gateway <value>]
    Action qualifier
    Qualifier
    Description
    -type
    Type the interface type. Value is one of the following:
    • iscsi — Interface for iSCSI storage.
    • replication — Interface for replication-related data or management traffic.
    -port
    Type the ID of the SP port or link aggregation that will use the interface. Manage Ethernet ports explains how to view the port IDs.
    For systems with two SPs, a file interface is created on a pair of symmetric Ethernet ports rather than on a single specified port. Its current port is defined by NAS server SP and may differ from the specified port. For example, if the user specifies port spa_eth2, but the NAS server is on SP B, the interface is created on port spb_eth2.
    -vlanId
    Type the virtual LAN (VLAN) ID for the interface. The interface uses the ID to accept packets that have VLAN tags. The value range is 1–4095.
    If no VLAN ID is specified, which is the default, packets do not have VLAN tags. The Unisphere online help provides more details about VLANs.
    -addr
    Type the IP address for the interface. The prefix length should be appended to the IPv6 address and, if omitted, will default to 64. For IPv4 addresses, the default length is 24. The IPv4 netmask may be specified in address attribute after slash.
    -netmask
    Type the subnet mask for the interface.
    This qualifier is not required if the prefix length is specified in the -addr attribute.
    -gateway
    Type the gateway for the interface.
    This qualifier configures the default gateway for the specified port’s SP.
    Example

    The following command creates a replication interface. The interface receives the ID IF_1:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/if create -type replication -port eth1_spb -addr 10.0.0.1 -netmask 255.255.255.0 -gateway 10.0.0.1
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    ID = IF_1
    Operation completed successfully.
                            

    View interfaces

    View a list of interfaces on the system. You can filter on the interface ID.

    The show action command explains how to change the output format.
    Format
    /net/if [ {-id <value> | -port <value> | -server <value> | -type <value>} ] show
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of an interface.
    -port
    Type the port the interface is associated with.
    -type
    Specify the type of the interface. Valid values are:
    • iscsi
    • replication
    Example

    The following command displays all interfaces on the system:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/if show
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    1:     ID                      = if_0
           Type                    = iscsi
           Port                    = eth0_spa
           VLAN ID                 = 0
           IP address              = 3ffe:80c0:22c:4e:a:0:2:7f/64
           Subnet mask             = 
           Gateway                 = fe80::20a8bff:fe5a:967c
           SP                      = spa
    
    2:     ID                      = if_1
           Type                    = replication
           Port                    = eth1_spa
           VLAN ID                 = 1
           IP address              = 192.168.1.2
           Subnet mask             = 255.255.255.0
           Gateway                 = 192.168.1.254
           SP                      = spa
    
    3:     ID                      = if_2
           Type                    = replication
           Port                    = eth1_spb
           VLAN ID                 =
           IP address              = 10.103.75.56
           Subnet mask             = 255.255.248.0
           Gateway                 = 10.103.72.1
           SP                      = spb
    
    
                            

    Delete interfaces

    Delete an interface.

    Deleting an interface can break the connection between systems that use it, such as configured hosts.
    Format
    /net/if –id <value> delete
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the interface to delete.
    Example

    The following command deletes interface IF_1:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/if –id IF_1 delete
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
                            

    Manage remote storage systems

    Configure remote storage systems that connect to the system to which you are logged in. The system uses the configuration to access and communicate with the remote system. For example, to use remote replication, create a configuration that specifies the remote system to use as the destination for the replication session.

    Each remote system configuration is identified by an ID.

    The following table lists the attributes for remote storage systems:

    Table 2. Remote system attributes
    Attribute
    Description
    ID
    ID of the remote system configuration.
    Name
    Name of the remote system.
    Management Address
    Network name or management IP address of the remote system.
    Source user name
    For systems that are the source in a replication session, the username that is used to access the system.
    Source user password
    For systems that are the source in a replication session, the user password that is used to access the system.
    Destination user name
    For systems that are the destination in a replication session, the username that is used to access the system.
    Destination user password
    For systems that are the destination in a replication session, the user password that is used to access the system.
    Connection type
    Indicates the type of replication connection. Valid values are synchronous, asynchronous, or both.

    Create remote system configurations

    Configures a remote system configuration for the local system to access.

    Format
    /remote/sys create -addr <value> -srcUsername <value> { -srcPassword <value> | -srcPasswordSecure } -dstUsername <value> { -dstPassword <value> | -dstPasswordSecure } [ -connectionType { sync | async | both } ]
    Action qualifiers
    Qualifier
    Description
    -addr
    Type the network name or IP address of the remote system.
    -srcUsername
    For systems that are the source in a replication session, type the username that is used to access the system.
    -srcPassword
    For systems that are the source in a replication session, type the user password that is used to access the system.
    -srcPasswordSecure
    Specify the password in secure mode. Once you run the command with this qualifier, you will be asked to type the password separately.
    -dstUsername
    For systems that are the destination in a replication session, type the username that is used to access the system.
    -dstPassword
    For systems that are the destination in a replication session, type the user password that is used to access the system.
    -dstPasswordSecure
    Specify the password in secure mode. Once you run the command with this qualifier, you will be asked to type the password separately.
    -connectionType
    Specify this qualifier to indicate the type of replication connection. Valid values are async, sync, or both.
    Example

    The following command creates a remote system configuration with these settings:

    • Network address is 10.64.75.10.
    • Includes access credentials for when the system is the source or destination.

    The configure remote system receives the ID RS_1:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /remote/sys create –addr 10.64.75.10 –srcUsername admin1 -srcPassword Password456! –dstUsername admin2 –dstPassword Password986! -connectionType sync
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    ID = RS_1
    Operation completed successfully.
                            

    View settings for remote storage systems

    View the configuration for a remote system on the local system. You can filter on the configuration ID of the remote system.

    The show action command explains how to change the output format.
    Format
    /remote/sys [-id <value>] show
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of a remote system configuration.
    Example

    The following command lists all configurations for remote storage systems:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /remote/sys show -detail
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    1:     ID                   = RS_1
           Address              = 10.2.3.1
           Model                = Unity 300
           Serial number        = FCNC987654321
           Connection type      = async
           Source interfaces    = N/A
           Local interfaces     = N/A
           Remote interfaces    = N/A
           Operational status   = OK (0x2)
           Health state         = OK (5)
           Health details       = "Communication with the replication host is established. No action is required."
           Synchronous FC ports = spb_fc4, spa_fc4
    
    
                            

    Verify settings for remote storage systems

    Verify the configuration settings for a remote system to ensure that the source storage resource can connect to the remote storage resource.

    Format
    /remote/sys –id <value> verify
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of a remote system configuration to verify the settings.
    Example

    The following command verifies remote system configuration RS_1:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /remote/sys –id RS_1 verify
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
                            

    Change settings for remote storage systems

    Changes the configuration settings for a remote system.

    Format
    /remote/sys -id <value> set [ -addr <value> ] [ -dstUsername <value> { -dstPassword <value> | -dstPasswordSecure } ] [ -connectionType {sync | async | both}]
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the remote system configuration to change.
    Action qualifiers
    Qualifier
    Description
    -addr
    Type the network name or management IP address of the remote system.
    -dstUsername
    Type the username that is used to access the remote system.
    -dstPassword
    Type the user password that is used to access the remote system.
    -dstPasswordSecure
    Specify the password in secure mode - the user will be prompted to input the password.
    -connectionType
    Specify this qualifier to indicate the type of replication connection. Valid values are async, sync, or both.
    Example

    The following command changes the name, IP address, and access credentials for remote system configuration RS_1:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /remote/sys –id RS_1 set –addr “10.64.74.2” -dstUsername Local/joe -dstPassword Password456!
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    ID = RS_1
    
    Operation completed successfully.
                            

    Delete remote system configurations

    Deletes the configuration for a remote system.

    Before deleting a remote system configuration, ensure that all I/O operations on the system, such as active replication sessions, have completed to avoid data loss.
    Format
    /remote/sys –id <value> delete
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the remote system configuration to delete.
    Example

    The following command deletes remote system configuration RS_1:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /remote/sys –id RS_1 delete
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
                            

    Manage replication sessions

    Storage replication is a process in which storage data is duplicated either locally or to a remote network device. Replication produces a read-only, point-in-time copy of source storage data and periodically updates the copy, keeping it consistent with the source data. Storage replication provides an enhanced level of redundancy in case the main storage backup system fails. As a result:

    • Downtime associated cost of a system failure is minimized.
    • Recovery process from a natural or human-caused disaster is facilitated.

    Each replication session is identified by an ID. The Unisphere online help provides more details about storage replication.

    At any given point in time, only one command is supported on a replication session. Before running a new command, ensure that you wait for the existing action on the replication session to complete.

    The following table lists the attributes for replication sessions:

    Table 3. Replication session attributes
    Attribute
    Description
    ID
    ID of the session.
    Name
    Name of the replication session.
    Remote session ID
    Identified session in case of replication with the system.
    Synchronization
    Type of synchronization. Valid values are:
    • auto — Data is replicated automatically in order to maintain the desired Recovery Point Objective (RPO).
    • manual — Data will only be replicated when manually initiated.
    As the RPO increases, the potential for data loss also increases, as well as the amount of required protection space. Lowering the RPO will reduce the amount of potential data loss, but will also increase network traffic and may negatively impact performance. The default RPO is one hour.
    RPO
    Recovery Point Objective (RPO) interval for automatic synchronization. For synchronous replication, the RPO is set to 0 automatically.
    Session type
    Storage type of the session. Valid values are:
    • block
    • file
    • nas server
    Resource type
    Type of storage resource to which the replication session is applied.
    State
    State of the replication session. Valid values are:
    • in sync
    • syncing
    • consistent
    • out of sync
    Sync state
    Additional state of the replication, specific to the replication mode.
    • For asynchronous replication, valid values are:
      • unknown
      • idle
      • manual
      • syncing
      • auto syncing
    • For synchronous replication, valid values are:
      • out of sync
      • in sync
      • consistent
      • syncing
      • inconsistent
    Health state
    Health state of the session. Valid values are:
    • OK — Session is operating normally.
    • Degraded/Warning — Session is currently paused.
    • Minor failure — An error has caused one or more of the following:
      • Session has stopped. You can try to resume a stopped replication session.
      • Session has failed over, likely due to the source storage resource becoming unavailable. The destination storage resource is now in a read/write state. Review the state of the source and check your network connections for any problems. Once the source is back online, you can fail back the session to return it to normal operation.
      • Communication with the replication host has been lost. It is likely that the system is either powered down or there is a network connectivity issue between the systems. A change in the network configuration on either side could also interrupt communication.
    If the replication session is in an error state, the session will not be recoverable. You will need to delete the session and create a new replication session.
    Health details
    Additional health information.
    Operational status
    Operational status of the session. The operational status code appears in parentheses.
    Network status
    Status of the network connection. Valid values are:
    • Unknown — Network status is currently unknown. If you continue to see this value, check the network connections.
    • OK — Network connection is operating normally.
    • Lost Communication — Communication with the replication host has been lost. It is likely that the system is either powered down or there is a network connectivity issue between the systems. A change in the network configuration on either side could also interrupt communication.
    Source status
    Status of the source storage resource in the session. Valid values are:
    • Unknown — Source status is unknown.
    • OK - Source is operating normally.
    • Paused — Replication session for the source is currently paused.
    • Fatal replication issue — Source has experienced a critical error and the replication session has stopped. Delete the replication session and re-create it.
    • Lost communication — Communication with the replication host has been lost. It is likely that the system is either powered down or there is a network connectivity issue between the systems. A change in the network configuration on either side could also interrupt communication.
    • Failed over — The replication session has failed over to the destination site. In a failover state, the destination object is read/write. When communication is reestablished between the source and destination, the source becomes read-only. To resume operations on the source site, the replication session needs to be failed back.
    Destination status
    Status of the destination storage resource in the session. Valid values are:
    • Unknown — Status of the destination resource is unknown.
    • OK — Destination resource is operating normally.
    • Paused — Replication session for destination resource is currently paused.
    • Fatal replication issue — Destination has experienced a critical error and the replication session has stopped. Delete the replication session and re-create it.
    • Lost communication — Communication with the replication host has been lost. It is likely that the system is either powered down or there is a network connectivity issue between the systems. A change in the network configuration on either side could also interrupt communication.
    • Failed over — The replication session has failed over to the destination site. In a failover state, the destination object is read/write. When communication is reestablished between the source and destination, the source becomes read-only. To resume operations on the source site, the replication session needs to be failed back.
    Local role
    The local system role. Valid values are:
    • Unknown — Status of the local system is unknown.
    • Source — Resource on the local system is replicated to the remote system.
    • Destination — Resource on the local system is the replication destination of the resource on the remote system.
    • Loopback — Resources participating in the replication session are located on the same storage system.
    • Local — Resources participating in the replication session are located on the different storage processors of the local system.
    Source resource
    ID of the storage resource that is the source of the session. The source can be local or remote.
    Destination type
    Type of destination used in the session. Valid values are:
    • local — Maintain a full copy of the storage resource on the local system. This has advantages over snapshots in that a full copy, not just a copy of changes, is retained.
    • remote — Maintain a full copy of the storage resource on a remote system by transferring the data over the network. Remote replication is often used to ensure that a copy is available at a remote site in case of catastrophic data loss, for example, due to natural disaster at the local site.
    Destination system
    For remote sessions, the ID of the remote system on which the data is replicated.
    Destination resource
    ID of the storage resource on which the data is replicated.
    Time of last sync
    Date and time of the last replication synchronization.
    Sync status
    Percentage of the replication synchronization that has completed and the amount of time remaining.
    For synchronous replication, the percentage is reported when the replication is in the Syncing state.
    Sync transfer size remaining
    Status of synchronization (percentage and time remaining). For multi-LUN applications there is a comma-separated list of values.
    Sync transfer rate
    Data transfer rate during a replication synchronization. For multi-LUN applications there is a comma-separated list of values.
    Source SP A interface
    ID of the interface on the SPA of the source system for the replication.
    Source SP B interface
    ID of the interface on the SPB of the source system for the replication.
    Destination SP A interface
    ID of the interface on the SPA of the destination system for the replication.
    Destination SP B interface
    ID of the interface on the SPB of the destination system for the replication.
    Previous transfer rate
    Previous transfer rate for the replication session.
    Average transfer rate
    Average transfer rate for the replication session.
    Element pairs
    For consistency group and VMware VMFS datastore replications, the LUN element pairs within the replication.

    Create replication sessions

    Create a replication session.

    Prerequisites

    Before creating a replication session, complete the following configuration tasks:

    • Create the storage resource that provides the replication source.
    • For local replication, create a replication destination on a local system.
    • For remote replication, create a replication connection to a remote system, and create a replication destination on that remote system.
    Format
    /prot/rep/session create -srcRes <value> [-srcSPAInterface <value>] [-srcSPBInterface <value>] –dstType {local|remote –dstSys <value>} -dstRes <value> [-dstSPAInterface <value>] [-dstSPBInterface <value>] [-name <value>][-elementPairs <value> ] [-syncType {manual [–autoInitiate {yes|no}]|[auto –rpo <value>]]
    Action qualifiers
    Qualifier
    Description
    -srcRes
    Type the ID of the storage resource to use as the source.
    -srcSPAInterface
    Type the ID of the interface on the SPA of the source system for the replication.
    This qualifier is used for replications on remote systems only. If the qualifier is not specified, the system identifies the interface automatically.
    -srcSPBInterface
    Type the ID of the interface on the SPB of the source system for the replication.
    This qualifier is used for replications on remote systems only. If the qualifier is not specified, the system identifies the interface automatically.
    -dstType
    Specify the type of destination. Valid values are:
    • local - Maintain a full copy of the storage resource on the local system. This has advantages over snapshots in that a full copy, not just a copy of changes, is retained.
    • remote - Maintain a full copy of the storage resource on a remote system by transferring the data over the network.
    Remote replication is often used to ensure that a copy is available at a remote site in case of catastrophic data loss, for example, due to natural disaster at the local site.
    -dstSys
    For remote replication, type the ID of the destination system. View settings for remote storage systems explains how to view the IDs of the remote system configuration on the local system.
    -dstRes
    Type the ID of the destination storage resource.
    To get the proper ID in the case of remote replication, you should use a command that list resources on a local machine with the -remSys qualifier. For example:
    • uemcli /stor/prov/sf/res -remSys <value> show
    • uemcli /stor/prov/iscsi/res -remSys <value> show
    • uemcli /stor/prov/vmware/nfs -remSys <value> show
    -dstSPAInterface
    Type the ID of the interface on the SPA of the destination system for the replication.
    This qualifier is used for replications on remote systems only. If the qualifier is not specified, the system identifies the interface automatically.
    -dstSPBInterface
    Type the ID of the interface on the SPB of the destination system for the replication.
    This qualifier is used for replications on remote systems only. If the qualifier is not specified, the system identifies the interface automatically.
    -syncType
    Specify how the source and destination will synchronize. Valid values are:
    • auto — Data is replicated automatically in order to maintain the desired Recovery Point Objective (RPO).
    • manual — Data will only be replicated when manually initiated.
    As the RPO increases, the potential for data loss also increases, as well as the amount of required protection space. Lowering the RPO will reduce the amount of potential data loss, but will also increase network traffic and may negatively impact performance. The default RPO is one hour.
    -autoInitiate
    Specify whether the system will perform the first replication synchronization automatically. Valid values are:
    • yes
    • no
    -rpo
    Type the time interval for when the synchronization will run. Use the following format:
                                        <HH>[:MM]
                                      
    Where:
    • HH — Type the number of hours. Range is 00-24 hours (1 day).
    • MM — Type the number of minutes, in 5 minute increments. Range is 05 to 55.
    For synchronous replication, specify the value 0.
    Example

    The following command creates a replication session with these settings:

    • Source storage resource is file system RS_1.
    • Destination system type is remote.
    • Remote destination system is RS_2.
    • Remote storage resource is file system LUN_2.
    • Synchronization type is automatic.
    • RPO is 2 hours and 30 minutes.
    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /prot/rep/session create -name REP1 -srcRes RS_1 –dstType remote -dstSys RS_2 –dstRes LUN_2 –syncType auto –rpo 02h30m
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    ID = 81604378625_FCNCH097274B3A_0000_81604378627_FCNCH097274B37_0000
    Operation completed successfully.
                            

    View replication sessions

    View details about replication sessions. You can filter on the session ID.

    The show action command explains how to change the output format.
    Format
    /prot/rep/session [{-id <value>| -name <value>| -res <value>}] show
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the replication session.
    -name
    Type the name of the replication session.
    -res
    Type the ID of a local storage resource on the system to view the sessions associated with it.
    Example

    The following command displays all replication sessions on the system:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /prot/rep/session show
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    1:    ID                   = 42949672967_FNM00134400082_0000_42949672967_FNM00131800278_0000
          Name                 = REP1
          Session type         = nas server 
          Synchronization type = auto 
          Resource type        = NAS Server 
          Destination type     = remote 
    
                            

    Change replication session settings

    Change the settings for a replication session.

    Format
    /prot/rep/session {–id <value> | -name <value>} set [-paused {yes|no [ -forceFullCopy ]}] [ -newName <value> ] [ -srcSPAInterface <value> ] [ -dstSPAInterface <value> ] [ -srcSPBInterface <value> ] [ -dstSPBInterface <value> ] [ -syncType { manual | auto -rpo <value>}]
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the replication session to change.
    -name
    Type the name of the replication session to change.
    Action qualifiers
    Qualifier
    Description
    -paused
    For automatic synchronization, specify to pause the session. Valid values are:
    • yes
    • no
    -newName
    Type the new name of the replication session.
    -srcSPAInterface
    Type the ID of the interface on the SPA of the source system for the replication.
    This qualifier is used for replications on remote systems only. If the qualifier is not specified, the system identifies the interface automatically.
    -srcSPBInterface
    Type the ID of the interface on the SPB of the source system for the replication.
    This qualifier is used for replications on remote systems only. If the qualifier is not specified, the system identifies the interface automatically.
    -dstSPAInterface
    Type the ID of the interface on the SPA of the destination system for the replication.
    This qualifier is used for replications on remote systems only. If the qualifier is not specified, the system identifies the interface automatically.
    -dstSPBInterface
    Type the ID of the interface on the SPB of the destination system for the replication.
    This qualifier is used for replications on remote systems only. If the qualifier is not specified, the system identifies the interface automatically.
    -syncType
    Specify how the source and destination will synchronize. Valid values are:
    • auto — Data is replicated automatically in order to maintain the desired Recovery Point Objective (RPO).
    • manual — Data will only be replicated when manually initiated.
    As the RPO increases, the potential for data loss also increases, as well as the amount of required protection space. Lowering the RPO will reduce the amount of potential data loss, but will also increase network traffic and may negatively impact performance. The default RPO is one hour.
    -rpo
    For automatic synchronization, type the time interval for when the synchronization will run. Use the following format:
                                        <HH>[:MM]
                                      
    Where:
    • HH — Type the number of hours. Range is 00-24 hours (1 day).
    • MM — Type the number of minutes, in 5 minute increments. Range is 05 to 55.
    For synchronous replication, specify the value 0.
    Example

    The following command changes the source interface and destination interface for replication session 81604378625_FCNCH097274B3A_0000_81604378627_FCNCH097274B37_0000:

    uemcli /prot/rep/session –id 81604378625_FCNCH097274B3A_0000_81604378627_FCNCH097274B37_0000 set –srcSPAInterface if_1 –srcSPBInterface if_2 –dstSPAInterface if_3 –dstSPBInterface if_4
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    ID = 81604378625_FCNCH097274B3A_0000_81604378627_FCNCH097274B37_0000
    Operation completed successfully.
                            

    Delete replication sessions

    Delete a replication session. The deletion process automatically synchronizes the source storage resource with the destination storage resource, makes both read/write, and then deletes the session. You can then connect a host to either storage resource. Deleting the session from the source system automatically removes the destination and source replication sessions. This ensures that you do not have to manually delete the associated storage resources or NAS servers from the destination system.

    Once you delete a replication session, data from the source storage resource will no longer be replicated on the destination, leaving the data unprotected.
    Format
    /prot/rep/session {–id <value> | -name <value>} delete
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the replication session to delete.
    -name
    Type the name of the replication session to delete.
    Example

    The following command deletes replication session 81604378625_FCNCH097274B3A_0000_81604378627_FCNCH097274B37_0000:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /prot/rep/session –id 81604378625_FCNCH097274B3A_0000_81604378627_FCNCH097274B37_0000 delete
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
                            

    Fail over replication sessions

    Run this command on the destination system to perform a failover of a replication session, with possible data loss, in response to an emergency scenario in which the source becomes unavailable.

    After the failover, the destination system is read/write. To reestablish communication between the source and destination, fail back the session that has failed over. Fail back replication sessions explains how to fail back a replication session that has failed over.

    Failover operations terminate the transfer of data if there is a transfer in progress, causing a potential loss of data. If the source site is still available when you perform a failover, the system attempts to change the source storage resource from read/write to read-only.
    Initiate a planned downtime

    To initiate a planned downtime, run this command on the source system by specifying the -sync option with the value yes. When you fail over a replication session from the source system, the destination system is fully synchronized with the source to ensure that there is no data loss. The destination storage resource can be used for providing access to the host.

    Format
    /prot/rep/session { -id <value> | -name <value> } failover [-sync {yes | no}]
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the replication session to fail over.
    -name
    Type the name of the replication session to fail over.
    Action qualifier
    Qualifier
    Description
    -sync
    Specifies whether a synchronization needs to be performed before failing over the replication session. Valid values are:
    • yes
    • no
    You cannot use the value yes when initiating a failover from the destination system.
    Example

    The following command performs a fail over of replication session 81604378625_FCNCH097274B3A_0000_81604378627_FCNCH097274B37_0000:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /prot/rep/session –id 81604378625_FCNCH097274B3A_0000_81604378627_FCNCH097274B37_0000 failover
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
                            

    Fail back replication sessions

    Fail back a replication session that has failed over. A failback results in the following:

    • Synchronizes the destination and source storage resources.
    • Makes the destination storage resource read-only.
    • Makes the source storage resource read/write.

    When the failback operation is complete, the replication session will resume and you may connect your hosts to the source storage resource.

    Ensure that hosts do not write to the destination storage resource, which will become read-only.
    Format
    /prot/rep/session {–id <value> | -name <value>} failback [-forceFullCopy]
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the replication session to fail back.
    -name
    Type the name of the replication session to fail back.
    Action qualifier
    Qualifier
    Description
    -forceFullCopy
    Specifies to force a full synchronization before the failback operation occurs.
    You may lose the common base on the source storage resource as a result of the event that caused the original failover. If there is no longer a common base for the source storage resource, a full synchronization is required. For such cases, ensure that you specify this qualifier.
    Example

    The following command performs a fail back of replication session 81604378625_FCNCH097274B3A_0000_81604378627_FCNCH097274B37_0000:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /prot/rep/session –id 81604378625_FCNCH097274B3A_0000_81604378627_FCNCH097274B37_0000 failback
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    Operation completed successfully.
                            

    The show action command

    The show action command displays a list of objects that exist on the system and the attributes of those objects. You can specify an object qualifier to view the attributes for a single object. The show action command provides qualifiers for changing the display of the output, including the format and the attributes to include. The available output formats are name-value pair (NVP), table, and comma-separated values (CSV).

    Format
    uemcli [<switches>] <object> [<object qualifier>] show [{-detail | -brief | -filter <value>] [-output {nvp | table [-wrap] | csv}]
    Action qualifier
    Qualifier
    Description
    -output|-o
    Specify the output format. Value is one of the following:
    • nvp — The name-value pair (NVP) format displays output as name=value. Name-value pair format provides an example of the NVP format.
    • table — The table format displays output as a table, with column headers and rows. By default, values that are too long to fit in a column are cut off. Add -wrap after the table qualifier, separated by a space, so that the values wrap. Table format provides an example of the table format.
    • csv — The comma-separated values (CSV) format is similar to the table format, but the names and values are separated by commas. Comma-separated values format provides an example of the CSV format.
    -detail
    Display all attributes.
    -brief
    Display only the basic attributes (default).
    -filter
    Comma-separated list of attributes which are included into the command output.
    Name-value pair format
                          1:     ID                 = la0_SPA
           SP                 = SPA
           Ports              = eth0_SPA,eth1_SPA
           Health state       = OK (5)
    
    2:     ID                 = la0_SPB
           SP                 = SPB
           Ports              = eth0_SPB,eth1_SPB
           Health state       = OK (5)
    
                        
    Table format
                          ID      | SP  | Ports             | Health state
    --------+-----+-------------------+--------------
    la0_SPA | SPA | eth0_SPA,eth1_SPA | OK (5)
    la0_SPB | SPB | eth0_SPB,eth1_SPB | OK (5)
                        
    Comma-separated values format
                          ID,SP,Ports,Health state
    la0_SPA,SPA,”eth0_SPA,eth1_SPA”,OK (5)
    la0_SPB,SPB,”eth0_SPB,eth1_SPB”,OK (5)
                        
    Example

    The following command modifies the set of attributes in the show action output. For example, if you add -filter "ID,ID,ID,ID" to the command, in the output you will see four lines with the "ID" attribute for each listed instance:

                          1:  ID = la_0
        ID = la_0
        ID = la_0
        ID = la_0
                        
    uemcli /net/nas/server show -filter “ID, SP, Health state, ID, Name”
    Filter format
                          Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    1:     ID           = nas_1
           SP           = SPA
           Health state = OK (5)
           ID           = nas_1
           Name         = Mynas1
    
    2:     ID           = nas_2
           SP           = SPA
           Health state = OK (5)
           ID           = nas_2
           Name         = Mynas2
                        

    Manage Ethernet ports

    View and change the settings for the network ports on each SP.

    The following table describes the port attributes.

    Table 4. Network port attributes
    Attribute
    Description
    ID
    ID of the port.
    Name
    Name of the port.
    SP
    Name of the SP on which the port resides. Value is SPA or SPB.
    Protocols
    Types of protocols the port supports. Value is one of the following:
    • mgmt — Management interface.
    • file — Network interface for Windows (SMB) and Linux/UNIX (NFS) storage.
    • iscsi — iSCSI interface for iSCSI storage.
    Manage network interfaces explains how to configure network interfaces on the system.
    MTU size
    Maximum transmission unit (MTU) packet size (in bytes) that the port can transmit. Default is 1500 bytes per packet.
    Requested MTU size
    MTU size set by the user.
    Available MTU size
    List of available MTU sizes.
    Speed
    Current link speed of the port.
    Requested speed
    Link speed set by the user.
    Available speeds
    List of available speed values.
    Health state
    Health state of the port. The health state code appears in parentheses. Value is one of the following:
    • Unknown (0) — Status is unknown.
    • OK (5) — Port is operating normally.
    • OK BUT (7) — Lost communication, but the port is not in use.
    • Minor failure (15) — Lost communication. Check the network connection and connected cables.
    • Major failure (20) — Port has failed. Replace the SP that contains the port.
    Health details
    Additional health information. See Appendix A, Reference, for health information details.
    Aggregated port ID
    If the port is in a link aggregation, the ID of the link aggregation appears. Manage link aggregations explains how to configure link aggregations on the SP ports.
    Connector type
    Physical connector type. Valid values are:
    • unknown
    • RJ45
    • LC
    • MiniSAS_HD
    MAC address
    Unique identifier assigned to a network device for communications on a network segment.
    SFP supported speeds
    List of supported speed values of the inserted Small Form-factor Pluggable.
    SFP supported protocols
    List of supported protocols of the inserted Small Form-factor Pluggable. Valid values are:
    • unknown
    • FibreChannel
    • Ethernet
    • SAS

    View Ethernet port settings

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

    The show action command explains how to change the output format.
    Format
    /net/port/eth [-id <value>] show
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the port.
    Example
    uemcli /net/port/eth show
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    1:     ID                 = spa_mgmt
           Name               = mgmt
           SP                 = spa
           Protocols          = mgmt
           MTU size           = 1500
           Speed              = 100 Mbps
           Health state       = OK (5)
           Aggregated port ID = None
           MAC address        = 00:50:56:9D:25:B8
    
    2:     ID                 = spa_eth0
           Name               = eth0
           SP                 = spa
           Protocols          = file, iscsi
           MTU size           = 1500
           Speed              = 10 Gbps
           Health state       = OK (5)
           Aggregated port ID = la0_SPA
           MAC address        = 00:50:56:9D:3C:70
    
    3:     ID                 = spa_eth1
           Name               = eth1
           SP                 = spa
           Protocols          = file, iscsi
           MTU size           = 9000
           Speed              = 1 Gbps
           Health state       = OK (5)
           Aggregated port ID = la0_SPA
           MAC address        = 00:50:56:9D:3A:34
    
    4:     ID                 = spa_iom_0_eth0
           Name               = eth2
           SP                 = spa
           Protocols          = file, iscsi
           MTU Size           = 9000
           Speed              = 1 Gbps
           Health state       = OK (5)
           Aggregated port ID = None
           MAC address        = 00:50:56:9D:4E:20
                            

    Change Ethernet port settings

    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
    /net/port/eth -id <value> set [-mtuSize <value>] [-speed <value>]
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the network port.
    Action qualifier
    Qualifier
    Description
    -mtuSize
    Type the maximum transmission unit packet size (in bytes) for the port.
    -speed
    Type the port speed.
    Example

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

    uemcli /net/port/eth –id spa_eth0 set –mtuSize 9000
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    ID = spa_eth0
    ID = spb_eth0
    Operation completed successfully.
                            

    Manage FC ports

    View and change the settings for the FC ports on each SP.

    The following table describes the port attributes.

    Table 5. FC port attributes
    Attribute
    Description
    ID
    ID of the port.
    Name
    Name of the port.
    SP
    Name of the SP on which the port resides.
    WWN
    World Wide Name (WWN) of the port.
    Speed
    Current link speed of the port.
    Requested speed
    Link speed set by the user.
    Available speed
    List of available speed values.
    Health state
    Health state of the port. The health state code appears in parentheses. Value is one of the following:
    • Unknown (0) — Status is unknown.
    • OK (5) — Port is operating normally.
    • OK BUT (7) — Lost communication, but the port is not in use.
    • Minor failure (15) — Lost communication. Check the network connection and connected cables.
    • Major failure (20) — Port has failed. Replace the SP that contains the port.
    Health details
    Additional health information. See Appendix A, Reference, for health information details.
    Connector type
    Physical connector type. Valid values are:
    • unknown
    • RJ45
    • LC
    • MiniSAS_HD
    SFP supported speeds
    List of supported speed values of the inserted Small Form-factor Pluggable.
    SFP supported protocols
    List of supported protocols of the inserted Small Form-factor Pluggable. Valid values are:
    • unknown
    • FibreChannel
    • Ethernet
    • SAS

    View FC port settings

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

    Format
    /net/port/fc [-id <value>] show
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the port.
    Example
    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/port/fc show -detail
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    1:     ID                      = spa_fc1
           Name                    = fc1
           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        = auto, 1 Gbps, 2 Gbps, 4 Gbps
           Health state            = OK (5)
           Health details          = "The port is operating normally."
           SFP supported speeds    = 10 Gbps
           SFP supported protocols = Ethernet
                            

    Change port settings

    Change the speed for an FC port.

    Format
    /net/port/fc -id <value> set -speed <value>
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the FC port.
    Action qualifier
    Qualifier
    Description
    -speed
    Type the port speed.
    Example

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

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/port/fc –id spa_fc1 set –speed 1Gbps
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    ID = spa_fc1
    Operation completed successfully.
                            

    Manage link aggregations

    Link aggregation lets you link physical ports (for example, port 0 and port 1) on a SP to a single logical port and therefore lets you use up to four Ethernet ports on the SP. If your system has two SPs, and you link two physical ports, the same ports on both SPs are linked for redundancy. For example, if you link port 0 and port 1, the system creates a link aggregation for these ports on SP A and a link aggregation on SP B.

    Each link aggregation is identified by an ID.

    The cabling on SP A must be identical to the cabling on SP B, or you cannot configure link aggregation.

    Link aggregation has the following advantages:

    • Increases overall throughput since two physical ports are linked into one logical port.
    • Provides basic load balancing across linked ports since the network traffic is distributed across multiple physical ports.
    • Provides redundant ports so that if one port in a linked pair fails, the system does not lose connectivity.
    With link aggregation, both linked ports must be connected to the same switch and the switch must be configured to use link aggregation that uses the Link Aggregation Control Protocol (LACP). The documentation that came with your switch should provide more information on using LACP.

    The Unisphere online help provides more details on cabling the SPs to the disk-array enclosures (DAEs).

    The following table describes the attributes for link aggregation.

    Table 6. Link aggregation attributes
    Attribute
    Description
    ID
    ID of the link aggregation. The ID is a combination of the link ID and the SP that contains the linked ports.
    Ports
    IDs of the linked physical ports. The port names include the name of the SP that contains the ports.
    SP
    Name of the SP on which the ports are linked. Valid values are:
    • SPA
    • SPB
    MTU size
    Maximum transmission unit (MTU) packet size (in bytes) for the linked ports. Default is 1500 bytes per packet.
    Requested MTU size
    MTU size requested by the user.
    Available MTU size
    List of available MTU sizes.
    Health state
    Health state of the link aggregation. The health state code appears in parentheses. Value is one of the following:
    • Unknown (0) — Status is unknown.
    • OK (5) — Working correctly.
    • OK BUT (7) — Lost connection, but the link aggregation is not in use.
    • Degraded/Warning (10) — Working and performing all functions, but the performance may not be optimum.
    • Minor failure (15) — Working and performing all functions, but overall performance is degraded. This condition has a minor impact on the system and should be remedied at some point, but does not need to be fixed immediately.
    • Major failure (20) — Failing and some or all functions may be degraded or not working. This condition has a significant impact on the system and should be remedied immediately.
    • Critical failure (25) — Failed and recovery may not be possible. This condition has resulted in data loss and should be remedied immediately.
    • Non-recoverable error (30) — Completely failed and cannot be recovered.
    Health details
    Additional health information.

    View link aggregations

    View details about link aggregations. You can filter on the link aggregation ID.

    If your system has two SPs, details about the link aggregation configured on each SP appear.
    Format
    /net/la [-id <value>] show
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the link aggregation.
    Example

    The following command shows the link aggregations on the system, in this case, for both SPA and SPB:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/la show
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    1: ID           = la0_SPA
       SP           = SPA
       Ports        = eth0_SPA,eth1_SPA
       Health state = OK (5)
           
    2: ID           = la0_SPB
       SP           = SPB
       Ports        = eth0_SPB,eth1_SPB
       Health state = OK (5)
                            

    Create link aggregations

    Create a link aggregation by linking two physical ports on an SP to create a logical port.

    If your system has two SPs, the specified ports are automatically linked on both SPs for redundancy.
    Format
    /net/la create –ports <value> [-mtuSize <value>]
    Action qualifier
    Qualifier
    Description
    -ports
    Type the IDs of the physical ports to link on the SP. Separate the IDs with a comma. For example, to link ports 0 and 1 on SPA, type: eth0_SPA,eth1_SPA.
    -mtuSize
    Type the MTU size (in bytes) for the linked ports. Default value is 1500.
    If you want to support jumbo frames, type 9000.
    Example

    The following command links port 0 and port 1 on SPA with the default MTU size. The system has two SPs, so port 0 and port 1 on SPB are also linked, which results in two link aggregation IDs:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/la create -ports “eth0_SPA,eth1_SPA”
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    ID = la0_SPA
    ID = la0_SPB
    Operation completed successfully.
                            

    Change link aggregations

    Change the settings of a link aggregation.

    If your system has two SPs, the specified link aggregation is updated on both SPs.
    Format
    /net/la -id <value> set [-ports <value>] [-mtuSize <value>]
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the link aggregation to change.
    Action qualifier
    Qualifier
    Description
    -ports
    Type the IDs of the physical ports to link on the SP. Separate the IDs with a comma. For example, to link ports 0 and 1 on SPA, type: eth0_SPA,eth1_SPA
    -mtuSize
    Type the MTU size (in bytes) for the linked ports. Default is 1500 bytes per packet.
    If you want to support jumbo frames, type 9000.
    Example

    The following command changes the MTU size for link aggregation la0_SPA to 9000 bytes. The system has two SPs, so MTU size is updated for both link aggregation IDs:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/la –id la0_SPA set –mtuSize 9000
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    ID = la0_SPA
    ID = la0_SPB
    Operation completed successfully.
                            

    Delete link aggregations

    Delete a link aggregation.

    If your system has two SPs, the specified bond is deleted from both SPs.
    Format
    /net/la [-id <value>] delete
    Object qualifier
    Qualifier
    Description
    -id
    Type the ID of the link aggregation to delete.
    Example

    The following command deletes link aggregation la0_SPA. The system has two SPs, so link aggregation la0_SPB is also deleted:

    uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/la –id la0_SPA delete
                              Storage system address: 10.0.0.1
    Storage system port: 443
    HTTPS connection
    
    ID = la0_SPA
    ID = la0_SPB
    Operation completed successfully.