Dell EMC Unity™ Family

Version 4.3

Configuring Replication
H14974
REV 04
Copyright © 2016-2018 Dell Inc. or its subsidiaries. All rights reserved.

Published January 2018

Dell believes the information in this publication is accurate as of its publication date. The information is subject to change without notice.

THE INFORMATION IN THIS PUBLICATION IS PROVIDED “AS-IS.“ DELL MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND
WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. USE, COPYING, AND DISTRIBUTION OF ANY DELL SOFTWARE DESCRIBED
IN THIS PUBLICATION REQUIRES AN APPLICABLE SOFTWARE LICENSE.

Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries. Other trademarks may be the property of their respective owners.
Published in the USA.

Dell EMC
Hopkinton, Massachusetts 01748-9103
1-508-435-1000 In North America 1-866-464-7381
www.DellEMC.com

2 Unity Family 4.3 Configuring Replication

CONTENTS

Chapter 1 Overview 5
About this document.................................................................................... 6
Additional resources..................................................................................... 6
About replication.......................................................................................... 7
Using replication for disaster recovery........................................................ 12
Using replication for planned downtime...................................................... 13
Failback a replication session...................................................................... 14

Chapter 2 Replication workflow 15

Configure replication...................................................................................16
Configure local replication..............................................................16
Configure asynchronous replication............................................... 16
Configure synchronous replication................................................. 17
Related concepts........................................................................................ 18
Replication interfaces.....................................................................18
About replication connections........................................................ 18
About replication sessions.............................................................. 19
About replication support for thin storage resources with data
reduction....................................................................................... 20

Chapter 3 Considerations for synchronous replication 23

Synchronization states............................................................................... 24
Fibre Channel configuration for synchronous replication............................ 25

Chapter 4 Configure replication using Unisphere 27

Configure protection and mobility interfaces..............................................28
Configure replication connections.............................................................. 29
Create a replication session........................................................................ 29
Manage replication sessions........................................................................31
Configure an override network address for file replication .........................34

Chapter 5 Configure replication using the CLI 37

Manage network interfaces........................................................................ 38
Create interfaces...........................................................................39
View interfaces..............................................................................40
Change interface settings..............................................................42
Delete interfaces........................................................................... 43
Manage remote storage systems................................................................43
Create remote system configurations............................................45
View settings for remote storage systems.....................................46
Verify settings for remote storage systems................................... 47
Change settings for remote storage systems.................................47
Delete remote system configurations............................................ 48
Manage replication sessions....................................................................... 49
Create replication sessions............................................................ 56
View replication sessions................................................................61
Change replication session settings............................................... 62

Unity Family 4.3 Configuring Replication 3

CONTENTS

Pause replication sessions............................................................. 66

Resume replication sessions.......................................................... 67
Manually synchronize replication sessions..................................... 68
Delete replication sessions.............................................................69
Fail over replication sessions......................................................... 69
Fail back replication sessions.......................................................... 71
Associated CLI commands.......................................................................... 72
The show action command............................................................ 72
Manage Ethernet ports.................................................................. 74
Manage FC ports........................................................................... 77
Manage link aggregations.............................................................. 79

Appendix A Use case for CLI 85

Replication configuration use case............................................................. 86
Configure local replication............................................................. 86
Configure asynchronous replication...............................................86
Configure synchronous replication.................................................87
Create a replication interface........................................................ 88
Create a replication connection..................................................... 90
Create a replication session for block storage................................ 91
Create a replication session for file storage....................................91
View replication sessions............................................................... 93

4 Unity Family 4.3 Configuring Replication

CHAPTER 1
Overview

This chapter addresses the following topics:

l About this document............................................................................................6

l Additional resources.............................................................................................6
l About replication.................................................................................................. 7
l Using replication for disaster recovery................................................................12
l Using replication for planned downtime.............................................................. 13
l Failback a replication session.............................................................................. 14

Overview 5
Overview

About this document

This document provides information you can use to configure and manage replication
on your Unity storage system. Along with relevant concepts and instructions to
configure replication using the Unisphere GUI, this document also include information
on the CLI commands associated with configuring replication.

Note

For more information on other Unisphere features or CLI commands, refer to the
Unisphere online help and CLI User Guide.

Additional resources
As part of an improvement effort, revisions of the software and hardware are
periodically released. Therefore, some functions described in this document might not
be supported by all versions of the software or hardware currently in use. The product
release notes provide the most up-to-date information on product features. Contact
your technical support professional if a product does not function properly or does not
function as described in this document.
Where to get help
Support, product, and licensing information can be obtained as follows:
Product information
For product and feature documentation or release notes, go to Unity Technical
Documentation at: www.emc.com/en-us/documentation/unity-family.htm.
Troubleshooting
For information about products, software updates, licensing, and service, go to Online
Support (registration required) at: https://Support.EMC.com. After logging in, locate
the appropriate Support by Product page.
Technical support
For technical support and service requests, go to Online Support at: https://
Support.EMC.com. After logging in, locate Create a service request. To open a
service request, you must have a valid support agreement. Contact your Sales
Representative for details about obtaining a valid support agreement or to answer any
questions about your account.
Special notice conventions used in this document

DANGER

Indicates a hazardous situation which, if not avoided, will result in death or

serious injury.

WARNING

Indicates a hazardous situation which, if not avoided, could result in death or

serious injury.

6 Unity Family 4.3 Configuring Replication

 Overview

CAUTION

Indicates a hazardous situation which, if not avoided, could result in minor or

moderate injury.

NOTICE

Addresses practices not related to personal injury.

Note

Presents information that is important, but not hazard-related.

About replication
Data replication is one of the many data protection methodologies that enable your
data center to avoid disruptions in business operations. It is a process in which storage
data is duplicated to a remote or local system. It provides an enhanced level of
redundancy in case the main storage backup system fails. It minimizes the downtime-
associated costs of a system failure and simplifies the recovery process from a natural
disaster or human error.
The system supports asynchronous replication of all storage resources, including file
systems, NAS servers, LUNs, LUN groups, VMware VMFS datastores, VMware NFS
datastores, and thin clones. The system supports synchronous replication of the
following storage resources: LUNs, LUN groups, VMware VMFS datastores, VMware
NFS datastores, and thin clones. The asynchronous replication feature leverages the
Unified Snapshots technology to produce a read-only, point-in-time copy of source
storage data and periodically updates the copy to keep it consistent with the source
data. It leverages crash consistent replicas to provide remote data protection of
storage resources. The synchronous replication feature leverages the MirrorView/
Synchronous technology to mirror data in real time between local and remote storage
resources.

Note

In general, Unity OE versions 4.0, 4.1, 4.2, and 4.3 support replication interoperability.
However, the exception to this occurs when the source system is configured with
features that are not compatible with an earlier Unity OE version that is running on the
destination side of the replication session. For example:
l Inline compression is only supported for block objects with OE versions 4.1 or later,
while file objects are supported with OE versions 4.2 or later.
l Block objects support asynchronous and synchronous replication with all Unity OE
versions, while file supports only asynchronous replication with OE versions 4.0,
4.1, and 4.2 or later.
l Block and file objects support asynchronous replication of user snapshots with OE
versions 4.2 or later.

Replication modes
Replication can operate in the following modes:

About replication 7
Overview

l Asynchronous – (Applies to block and file storage.) Use this mode when you want
the data between the source and destination storage resources synchronized
automatically at a specific interval, based on the Recovery Point Objective (RPO).
l Synchronous – (Applies to block storage only.) Use this mode when you want the
data between the source and destination storage resources to always remain in
sync.
l Manual – (Applies to block and file storage.) Use this mode when you want to
manually synchronize changes in the source storage resource to the destination
storage resource. When you choose this mode, ensure that you periodically
synchronize the session to avoid excessive pool space consumption.
Recovery Point Objective
Recovery Point Objective (RPO) is an industry accepted term that indicates the
acceptable amount of data, measured in units of time, that may be lost in a failure.
When you set up an asynchronous replication session, you can configure automatic
synchronization based on the RPO. You can specify an RPO from a minimum of 5
minutes up to a maximum of 1440 minutes (24 hours). The default RPO is set at 60
minutes (1 hour) interval. In the case of synchronous replication, RPO is set to 0. You
can use the Unisphere CLI or Unisphere Management REST API to specify a more
granular RPO.

Note

Although a smaller time interval provides more protection and lesser space
consumption, it also has a higher performance impact, and results in more network
traffic. A higher RPO value may result in more space consumption. This may affect the
snapshot schedules and space thresholds.

Source and destination storage resources

In Unisphere, for all replicated storage resources except for thin clones, once
replication is configured, the destination storage resource is automatically created. In
CLI, you must manually create the destination storage resource and then create the
replication session between the source and destination storage resources.
You can convert a thin LUN to a non-thin (thick) LUN, or a thick LUN to a thin LUN
with a LUN move operation. To enable data reduction on a thin LUN requires an All-
Flash pool on the destination system. For thick file systems, the replication process
matches the destination storage resource to the source. In this case, thin and data
reduction cannot be selected for file systems. For thin file systems, the following rules
apply for replication:
l If the source file system is thin, then the destination file system is also thin.
l If the source file system is thin and either the source or destination system does
not support data reduction, then the destination file system is also thin.
l If both the source and destination systems support data reduction, then the
source or destination can have data reduction enabled or not.
l However, if you change the source file system data reduction attribute, the
change is not replicated to the destination system (retains the original setting).
The following rules apply to file asynchronous replication:
l The type of NAS server is set by the user during server creation.
l Users can change the type of a NAS server when there are no replication sessions
on any of the file systems using that NAS server.
l In destination mode, only the local configuration is enabled and all attributes in the
local configuration are active.

8 Unity Family 4.3 Configuring Replication

 Overview

l Override configuration specifies a set of attributes which is enabled when the NAS
server is changed from destination mode to normal mode. The override
configuration of a NAS server is not replicated as part of NAS server replication.
l Local configuration (also known as back up) specifies a set of attributes that are
related to enabling back up or local test through NFS or NDMP protocols. The
local configuration of a NAS server is not replicated as part of NAS server
replication.
The following table classifies the Global, Override, and Local attributes for NAS server.
Yes means the attribute exists in the configuration, and No means the attribute does
not exist in the configuration.

Table 1 Classification of configuration attributes for NAS server

Attribute Global Override Local

Configuration Configuration Configuration
Production IP interface Yes Yes No

Backup IP interface No No Yes

DNS Yes Yes Yes

NIS Yes Yes Yes

CIFS server (name, domain Yes No No

name, NetBIOS name, LDAP
org string)

NFS export Yes No No

NFS export for Local No No Yes

snapshots

CAVA Yes No No

NDMP user/password No No Yes

ASA user/password Yes No No

The following table lists file system level mount options that are also saved into the
NAS server configuration, and all of these are Global configuration:

Table 2 File system level mount options saved into NAS server configuration

UEMCLI Option RESTful Option Mount Option

-cifsNotifyOnWrite isCIFSNotifyOnWriteEnabled FS_PROPERTY_NOTIFYONWRITE_SY
NC

- cifsNotifyOnChangeDirDepth FS_PROPERTY_TRIGGERLEVEL
cifsNotifyDirDepth

- isCIFSNotifyOnAccessEnable FS_PROPERTY_NOTIFYONACCESS_S
cifsNotifyOnAcces d YNC
s

-cifsOpLocks isCIFSOpLocksEnabled FS_PROPERTY_NOOPLOCK

-cifsSyncWrites isCIFSSyncWritesEnabled FS_PROPERTY_NP_CIFSSYNCWRITE

-accessPolicy accessPolicy FS_PROPERTY_NP_ACCESSPOLICY

About replication 9
Overview

Table 2 File system level mount options saved into NAS server configuration (continued)

UEMCLI Option RESTful Option Mount Option

- folderRenamePolicy FS_PROPERTY_NP_RENAMEPOLICY
folderRenamePolic
y

-lockingPolicy lockingPolicy FS_PROPERTY_NP_LOCKINGPOLICY

-eventProtocols fileEventSettings FS_PROPERTY_NP_CEPPPOLICY

A user can set these properties through Unisphere and the CLI. If an asynchronous
replication session is created on the file system, these properties will be replicated
through the NAS server's replication session to the destination and can be seen on the
destination NAS server after the configuration view is refreshed.

Table 3 File system properties not related to mount options

UEMCLI Option RESTful Option Description

-id id Not replicated, the source and
destination can be different.

-name name Destination must be the same as the

source. Unisphere creates the
destination file system with the same
value as the source.

-desc description Not replicated, the source and

destination can be different.

-size size Replicated.

-thin isThinEnabled Destination must be the same as the

source. Unisphere creates the
destination file system with the same
value as the source.

-compression isCompressionEnabled Not replicated, in Unisphere the system

shows the source value as default for
destination. It can be changed.

-type supportedProtocols Destination must be the same as the

source. Unisphere creates the
destination file system with the same
value as the source.

-fstvpPolicy fastVPParameters Not replicated, in Unisphere the system

shows the source value as default for
destination, but it can be changed.

-poolFullPolicy poolFullPolicy Not replicated, the source and

destination can be different.

For properties that are not replicated when a failover occurs, ensure that you modify
the attributes of the associated destination storage resource to match the attributes
of the source storage resource.

10 Unity Family 4.3 Configuring Replication

 Overview

When a thin clone is replicated, the destination resource is automatically created with
the same attributes as the source thin clone, except that the destination resource is a
full copy, rather than a thin clone.
Snapshots
Block and file objects support asynchronous replication of user snapshots at OE
version 4.2 and later. Also, asynchronous replication supports the replication of
existing user snapshots during the initial replication session configuration.
Asynchronous replication supports the replication of read-only user snapshots to
either a local or a remote site along with the resource data. Both scheduled snapshots
and user created snapshots can be replicated. Snapshots are supported for all
resources that support asynchronous replication (that is, file system, LUN, LUN
group, VMware VMFS, and VMware VMNFS).

Note

User snapshots do not apply to the NAS server resource type.

Asynchronous replication of scheduled snapshots can be enabled during session

creation, or enabled or disabled at any time in the lifetime of the replication session.
User snapshots can be replicated with a remote retention policy that is different than
that of the source.
To support snapshot replication, both the source and destination systems must be
running Unity OE version 4.2 or later. Snapshot replication can be enabled on an
existing Unity OE version 4.0.x- or OE version 4.1.x-based session after both the
production and the remote systems have been upgraded to Unity OE version 4.2 or
later. Only read-only snapshots are eligible for replication, and they can only be
replicated to the disaster recovery site where the replication destination storage
resource is located. Any snapshots that are writable, such as attached block
snapshots or file snapshots with shares or exports, are not replicated.
Snapshots that exist prior to replication session creation can be selected for
replication during replication session creation. Snapshots that are older than the last
sync (RPO) time can be manually selected for replication and included in the next
RPO sync.
A user snapshot can have one of the following replication state attributes:
l Not marked for replication (No) - snapshot is not marked for replication
l Pending sync (Pending) - snapshot is marked for replication but is awaiting
transfer
l Replicated (Yes) - snapshot has successfully transferred to the disaster recovery
resource
l Failed to replicate (Failed) - snapshot failed to replicate
File-based replication session actions
On Unity systems running OE version 4.2, the following asynchronous replication
actions affect both the NAS server and its associated file systems when run at the
NAS server level:
l Failover
l Failover-with-sync
l Failback
l Pause
l Resume

About replication 11
Overview

Each of these actions triggers a group operation towards the NAS server replication
session and its associated file system replication sessions. A NAS server replication as
a group is available for local and remote asynchronous replication.

NOTICE

Do not perform a group operation at both sides of a replication session at the same
time. This action is not prohibited by the storage system, however, a group operation
performed at the same time at both sides of a replication session can cause the group
replication session to enter an unhealthy state. Also, failover-with-sync is not a
transparent operation. During the failover-with-sync process, hosts' write/read
requests may be rejected.

A group asynchronous replication session operation on a NAS server supports up to

500 file system replication sessions in such a way that those sessions look like one
replicated unit. If group operations are conducted on a group session whose file
system replication session numbers exceeds 500, the group replication session may
enter an unhealthy state, along with some file system replication sessions.

Note

Although a group asynchronous replication session looks like one operation, each file
system is replicated individually. If any of the individual file system replication sessions
fail, you can resolve the issue and then select the individual file system to replicate.

Those same asynchronous replication actions towards a file system remain at the file
system level. Those actions are still individual operations toward file system replication
sessions.
The following asynchronous replication actions affect only the NAS server when run at
the NAS server level or are still individual operations toward file system replication
sessions:
l Create
l Sync
l Delete
l Modify

Using replication for disaster recovery

In a disaster recovery scenario, the primary (source) system is unavailable due to a
natural or human-caused disaster. Data access is still available because a replication
session was configured between the primary and destination systems, and the
destination system contains a full copy, or replica, of the production data. The replica
is up-to-date in accordance with the last time the destination synchronized with the
source, as specified by the automatic synchronization recovery point objective (RPO)
setting. By issuing a session failover on the destination system, you make the
destination system the new production system, using the replica of the primary
system’s data that resides on the destination system. Using replicas for disaster
recovery minimizes potential data loss. The amount of potential data loss is affected
by the RPO that is configured when setting up the replication session. In synchronous
replication configuration, where the RPO is set to 0, the amount of potential data loss
will be minimal.
The failover operation always restores the destination resource to the replication
common base snapshot. If failing over to the common base is not sufficient and

12 Unity Family 4.3 Configuring Replication

 Overview

replicated user snapshots exist, the destination resource should be manually restored
to any of the replicated user snapshots.
Once the session is failed over to the destination system, the destination storage
resource becomes read-write. At this point, ensure that the storage resource has the
correct access permissions to the host and share. When originally establishing a
replication session between the primary and destination systems, create the right host
access on the destination system ahead of time to reduce downtime in an event of a
disaster.
To resume operations on the source, fail back the replication session.
File-based replication consideration
Switch over the NAS server replication session using the Failover option. This action
triggers a group operation towards the NAS server replication session and its
associated file system replication sessions.
The NAS server replication session should be in one of the following states in order for
it to be failed over to the destination system:
l Idle
l Auto Sync Configured
l Lost Communication
l Unrecoverable Error
If the NAS server replication session is in one of the following states, it cannot be
failed over to the destination system:
l Paused
l Error states other than Lost Communication or Unrecoverable Error
To resume operations on the source, fail back the NAS replication session.

Using replication for planned downtime

Unlike a disaster, in which the primary (source) system is lost due to an unforeseen
event, planned downtime is a situation for which you plan and take the source system
offline for maintenance or testing purposes on the destination system. Prior to the
planned downtime, both the source and destination are running with an active
replication session. When you want to take the source offline in this scenario, the
destination system is used as the production system for the duration of the
maintenance period. Once maintenance or testing completes, return production to the
original source system. Planned downtime does not involve data loss.
To initiate a planned downtime, use the Failover with sync option on the source
system. 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 session remains active for synchronous replication, and paused for
asynchronous replication, while the source becomes Read-Only and the destination
becomes Read-Write. The destination storage resource can be used for providing
access to the host.
Performing a failover with sync operation results in replication copying all the data,
including any snapshots that have been created or marked for copy since the last sync
occurred, to the destination site. Once the copy is finished, the destination is an exact
replica of the source site and the roles are switched similar to the failover operation.
To restore operations on the source, fail back the replication session.

Using replication for planned downtime 13

Overview

File-based replication consideration

The NAS server replication session should be in one of the following states in order for
it to be failed over with sync to the destination system:
l Idle
l Auto Sync Configured
If the NAS server replication session is in one of the following states, it cannot be
failed over with sync to the destination system:
l Paused
l Error states
To minimize disruption during a planned downtime window, ensure that the NAS
server and associated file system replication sessions are manually synchronized first
and then failed over. Follow these steps:
1. Synchronize the NAS server replication session using the Sync option.
2. Synchronize the replication sessions for each of the file systems associated with
the NAS server using the Sync option. This ensures that the destination file
systems have the latest data and minimal data will need to be transferred when
the replication sessions switch over.
3. Inform file system users and quiesce I/O operations from hosts and applications
using the file systems in the NAS server.
4. Switch over the NAS server replication session using the Failover with sync
option. This action triggers a group operation towards the NAS server replication
session and its associated file system replication sessions.
5. Once all replication sessions have successfully failed over, resume I/O operations
with the relevant applications and hosts.

Note

Any I/O attempted when the failover is occurring may result in read/write errors
or stale file handle exceptions.

Failback a replication session

To resume operations on a source system, the associated replication session needs to
be failed back. To fail back a replication session, use the Failback option on the
original destination system. Failback synchronizes the original source with the changes
made on the original destination after failover, including any snapshots that have been
created since the failover operation occurred. It then restores the source as the
production system and restarts the replication session in the original direction.
File-based replication consideration
To resume operations on a source system, the associated NAS server replication
session needs to be failed back. To fail back a NAS server replication session, use the
Failback option on the original destination system. This action triggers a group
operation towards the NAS server replication session and its associated file system
replication sessions.

14 Unity Family 4.3 Configuring Replication

CHAPTER 2
Replication workflow

This chapter addresses the following topics:

l Configure replication.......................................................................................... 16
l Related concepts................................................................................................18

Replication workflow 15
Replication workflow

Configure replication
Replication can occur locally or between a local storage system and a remote storage
system. Use the native Replication feature in Unisphere to configure replication for
block or file storage resources. The system supports asynchronous replication of all
storage resources, including file systems, NAS servers, LUNs, LUN groups, VMware
VMFS datastores, VMware NFS datastores, and thin clones. The system supports
synchronous replication of the following storage resources: LUNs, LUN groups,
VMware VMFS datastores, and thin clones.

Note

You can also configure synchronous and asynchronous replication for LUNs and
VMware VMFS datastores using the RecoverPoint appliance-based solution.

Configure local replication

Replication interfaces and connections do not apply to local replication. When using
the CLI or the REST API, once you create the identical source and destination storage
resources or NAS servers on the storage system, you can proceed to configure a
replication session. When using Unisphere, you only need to create the source storage
resources or NAS servers on the storage system. Unisphere does not allow you to
create a session with an existing destination. A DR_ is concatenated onto the resource
name for local destinations to ensure that the source and destination names on the
same system are unique (that is, LUN names need to be unique).
Note the following:
l For a disaster recovery scenario, it is recommended that the destination storage
resource and NAS server are configured on a storage pool other than the pool
used for the source storage resource and NAS server.
l For a migration scenario, which means migrating the source storage resource and
NAS server to a destination storage resource and NAS server on the same pool,
use the CLI to configure local replication. The Unisphere GUI does not allow local
replication between storage resources and NAS servers on the same pool.
l When you configure local replication for a tenant, create a pool for the tenant on
the destination system that matches the corresponding pool on the source system
(if one exists). Then add the tenant to the destination system, using the same
UUID and VLANs as the tenant on the source system.

Configure asynchronous replication

Before you begin
If you are configuring asynchronous replication for a tenant, create a pool for the
tenant on the destination system that matches the corresponding pool on the source
system (if one exists). Then add the tenant to the destination system, using the same
UUID and VLANs as the tenant on the source
Procedure
1. Configure the replication interfaces on each SP of the source and destination
systems.
2. Configure a replication connection using the Asynchronous connection mode.
3. For file storage, create a replication session for the NAS server associated with
the file storage.

16 Unity Family 4.3 Configuring Replication

 Replication workflow

Note

Storage resources included in a NAS server automatically get replicated when a

replication session is first configured for the NAS server. The replication session
for the storage resources will inherit the same attributes as the associated
replication session of the associated NAS server. For the storage resources you
do not want participating in replication, you can choose to remove the
associated replication sessions manually.

4. Create a remote replication session for the storage resource.

Note

You only need to configure replication interfaces and connections for the first
replication session between two systems. The same connection can be used
again for subsequent replication sessions between the same systems.

Configure synchronous replication

Note

Synchronous replication is only supported for block storage.

Procedure
1. Identify the Synchronous Replication Fibre Channel (FC) ports on each system.
To determine the FC port used for synchronous replication, in the CLI console,
run the command /remote/sys show -detail. Port information, similar to
the following example, will appear in the output:

Synchronous FC ports = spb_fc4, spa_fc4

For more information, see the Unisphere CLI User Guide.

2. Zone the Synchronous Replication FC ports between the systems.

If the source and destination systems are co-located, instead of zoning, you can
choose to use direct-connected FC cables between the SPs.
3. Configure the replication interfaces on each SP of the source and destination
systems based on the connection mode you want:
l For synchronous replication support (Synchronous connection mode), use
the Synchronous Replication Management Ports on each SP of both the
systems.
l For asynchronous and synchronous replication support (Both connection
mode), in addition to the replication interfaces for Synchronous Replication
Management Ports, configure additional interfaces using the Ethernet Ports
on each SP of the source and destination systems.
4. Configure the replication connection between source and destination systems
from the source system only.
l For synchronous replication support, specify the Synchronous connection
mode.

Configure synchronous replication 17

Replication workflow

lFor asynchronous and synchronous replication support, specify the Both

connection mode.
5. Create the synchronous replication session.

Note

You only need to configure replication interfaces and connections for the first
replication session between two systems. The same connection can be used
again for subsequent replication sessions between the same systems.

Related concepts
Replication interfaces
Each SP must include at least one replication interface configured on it. Each
replication interface on the SP of the source system should be able to communicate to
the replication interface on the SP of the destination system. To establish this, you
must set up a switched network for remote replication. You can configure a replication
interface with an IPv4 or IPv6 address.
Replication is supported between like type IP addresses. For example, you can set up a
replication connection between a replication interface configured with IPv4 address on
the source system and a replication interface configured with IPv4 address on the
remote system.
Configuration for asynchronous replication
When you create replication interfaces for asynchronous replication, use any of the
available Ethernet ports to configure an IP address on each SP. These IP addresses
are then used for asynchronous replication between the remote systems.
Configuration for synchronous replication
When you create replication interfaces for synchronous replication, you must use the
Ethernet Port titled 'Sync Replication Management Port' to configure an IP address
on each SP. This port is specifically used for management of the synchronous
replication session, leveraging the same physical interface as the storage system's
Unisphere management port, whereas the Fibre Channel (FC) ports are used for
replicating data between systems. Before creating replication interfaces and
connections for synchronous replication, ensure that you complete FC zoning and
configuration.

Note

You can choose to configure Asynchronous, Synchronous, or both connection modes

for block storage resources. If you choose to configure both connection modes,
ensure that you configure an additional Ethernet Port IP interface on each SP of the
source and destination systems.

About replication connections

Replication requires a configured connection between the source system and
destination system. This connection is called a replication connection. Replication
connections use replication interfaces on each SP from the local system and pairs
them up with the replication interfaces on each SP in the remote system.
For synchronous replication, a Fibre Channel (FC) connection is required for the data
communication, and an IP interface for the management communication. Only one FC

18 Unity Family 4.3 Configuring Replication

 Replication workflow

port can be configured and used for synchronous replication. Once an FC port is
assigned, it will continue to act as the synchronous replication port and can never be
changed. To determine the FC port used for synchronous replication, in the CLI
console, run the command /remote/sys show -detail. Port information, similar
to the following example, will appear in the output:

Synchronous FC ports = spb_fc4, spa_fc4

For more information, see the Unisphere CLI User Guide.

Note

Before creating a replication interface or connection for synchronous replication, it is

recommended that you configure the FC zoning.

Connection modes
The following connection modes are supported:
l Asynchronous – Supports asynchronous replication of file and block storage
resources. It uses the Ethernet Port IP interfaces configured on Storage
Processor A (SP A) and Storage Processor B (SP B) on the source and destination
systems.
l Synchronous – Supports synchronous replication of block storage resources only.
It uses the Sync Replication Management Port with IP addresses configured on SP
A and SP B on the source and destination systems.
l Both – Supports synchronous replication of block storage resources using the
Sync Replication Management Port and asynchronous replication of block storage
resources. Ensure that you set up the additional Ethernet Port IP interfaces on SP
A and SP B on the source and destination systems.

About replication sessions

A replication session leverages a configured replication connection and associated
interfaces to establish an end-to-end path for replicating data between the source and
destination storage resources. Once a replication session is established, the system
creates two replication system snapshots on the source storage resource and two
replication system snapshots on the destination storage resources. These snapshots
are only used for asynchronous replication. The snapshots are used to keep point-in-
time copies of data and maintain a common base between the source and destination
storage resources. The snapshots are refreshed based on the replication mode:
l For automatic synchronization, the snapshots are refreshed based on the
Recovery Point Objective (RPO) you specified. You can adjust the RPO interval
based on the amount of protection you want. You can specify an RPO from a
minimum of 5 minutes up to a maximum of 1440 minutes (24 hours).
l For manual synchronization, it is recommended that you sync the replication
periodically.

Note

The snapshots consume protection space based on the snapshots feature. Although
the internal snapshots may appear listed in the Snapshots tab of a storage resource
(source or destination), you cannot manage or modify them. The snapshots also do
not participate in automatic delete operations.

The following steps provide a high level overview of how the replication session works:

About replication sessions 19

Replication workflow

1. When the session and the internal snapshots are created, an initial synchronization
occurs where all the data from the first snapshot of the source storage resource is
replicated to the destination storage resource.

Note

For automatic synchronization, initial synchronization is enabled by default. For

manual synchronization, there is no initial synchronization. An option is available to
replicate existing snapshots on the storage resource as part of the initial
synchronization. This option is only available when creating a replication session. In
this case, replication transfers the snapshots in the order in which they were
created on the source to the destination site. If you opt not to synchronize existing
snapshots as part of the initial synchronization, the replication copies only the
source data from the internal system snapshot.

The system supports up to 16 concurrent initial synchronization operations per SP.

2. Once data is replicated to the destination storage resource, the first snapshot on
the destination storage resource is refreshed.
The first snapshot on both systems then becomes your common base at that point
in time. In event of a disaster, the common base is used to restore data from the
last time it was synchronized.
3. When the session is synchronized next, manually or automatically (based on the
RPO), the second internal snapshot on the source system gets refreshed.

Note

If a replication session is created with auto synchronization, any snapshots created

or marked for replication since the previous RPO are replicated upon RPO expiry
to the destination site. In case of a session configured with manual
synchronization, any snapshots created or marked for replication since the last
synchronization occurred are replicated whenever the session is manually
synchronized.

4. Once the snapshot is refreshed, data is replicated to the destination storage

resource.

Note

Only the differential data between the first and second snapshots gets copied
over.

5. The second snapshot on the destination storage resource is then refreshed.

6. Once this occurs, at that point-in-time, the second snapshots on both the systems
now become the common base.
These steps occur each time a synchronization occurs. When a disaster occurs,
replication uses the common base to go back to a good point in time copy of data. If
failing over to the common base is not sufficient and replicated user snapshots exist,
manually restore the destination resource to any of the replicated user snapshots.

About replication support for thin storage resources with data reduction
A thin destination LUN or LUN Group can be created with data reduction during
replication session creation when the following criteria is met:
l The source LUN or LUN group is thin.

20 Unity Family 4.3 Configuring Replication

 Replication workflow

l The OE version is 4.2 or later.

l The pool is All-Flash.
If the source LUN or LUN group meet this criteria, thin is selected by default for the
destination LUN or LUN group. You can choose to unselect it to create a thick
destination LUN or LUN group. If thin is not selected for the destination storage
resource, data reduction cannot be selected. Data reduction can only be selected
when thin can be and is selected for the destination storage resource.

Note

For file systems, replication matches the destination storage resource to the source.
The destination is converted to match with the source after the synchronization
operation (initial synchronization or manual synchronization). Therefore in this case,
thin and data reduction cannot be selected.

About replication support for thin storage resources with data reduction 21
Replication workflow

22 Unity Family 4.3 Configuring Replication

CHAPTER 3
Considerations for synchronous replication

This chapter addresses the following topics:

l Synchronization states.......................................................................................24
l Fibre Channel configuration for synchronous replication....................................25

Considerations for synchronous replication 23

Considerations for synchronous replication

Synchronization states
Replication sessions configured with synchronous replication (RPO set to zero) can
have the following synchronization states. Each of these describe the state of the
user data on the destination storage resource. They are useful for troubleshooting.
However, for replication session management, it is recommended to check the
operational status. For accurate information on the synchronization state of a
replication, refer to the synchronization state on the source system.

Note

The synchronization state on the destination system is not updated after a

synchronous replication session is fractured.

l Consistent – The data on the destination system is consistent from the host
perspective. The destination LUN is the latest or point in time copy of the source
LUN.
l In Sync – The data on the destination system is consistent from the host
perspective. The destination LUN is an exact copy of the source LUN.
l Syncing – The data on the destination system is getting updated from the source
system. The updates represent the pending changes on the source system. These
changes are not yet replicated to the destination system because of the following
reasons:
n A new replication session requires a full synchronization.
n Replication session requires a full synchronization after an unplanned failover
operation, when a failback or resume operation is performed.
n Replication session was previously in a Consistent or In Sync state. A
connection issue has created a backlog of changes on the source system. The
backlog will be updated to the destination system once the connection issue is
resolved.
n Replication session was paused resulting in a backlog of changes on the source
system. The backlog will be updated to the destination system once the
replication session is resumed.
l Out of Sync – The state of the data on the destination LUN cannot be determined
by the replication session. The update to the destination system may be
incomplete. This can occur for any of the following reasons:
n A connection issue disrupts a replication that is in a Syncing state.
n The replication session is paused on the source system.
n The replication session was deleted locally on the destination system.
l Inconsistent – The state is reported only when replication is failed over. It
appears when the synchronization state of the session was not In Sync or
Consistent, prior to failover. In this case, it is recommended that you check for the
consistency of the destination storage resource.
Synchronization state transitions
The following table lists the synchronization state transitions for some of the
replication actions:

24 Unity Family 4.3 Configuring Replication

 Considerations for synchronous replication

Action Synchronization state transition

Initial synchronization Unknown > Out of Sync > Syncing > Consistent > In
Sync
Pause In Sync > Consistent or Syncing > Out of Sync
Resume Consistent or Out of Sync > Syncing > Consistent > In
Sync
Fail over Syncing > Inconsistent or Out of Sync > Inconsistent

Note

If the state was In Sync or Consistent before a failover

occurred, that state is retained.

Replication connection Syncing > Out of Sync or In Sync > Consistent (if there is
down I/O)

Fibre Channel configuration for synchronous replication

Every replication session is tied to a Storage Processor (SP) via a replication
interface. For synchronous replication, a Fibre Channel (FC) connection is used for
data communication, and an IP interface used for management commands. Before
creating a replication interface or connection, it is recommended that you configure
the FC zoning.

Note

When using Single Mode SFP (to support a long range connection), SM cables along
with an SM SFP connection on the switch are required as well as manually increasing
the credits on the switch. In the case of direct connection between storage systems,
both Synchronous Replication ports should use SM SFP along with SM cables. Refer
to the Unity Hardware Information Guide for more information about SM SFP.

Only one FC port can be configured and used for synchronous replication. Once an FC
port is assigned, it will continue to act as the synchronous replication port and can
never be changed. To determine the FC port used for synchronous replication, in the
CLI console, run the command /remote/sys show -detail. Port information,
similar to the following example, will appear in the output:

Synchronous FC ports = spb_fc4, spa_fc4

For more information, see the Unisphere CLI User Guide.

Note

RecoverPoint and the native Replication feature cannot simultaneously operate on the
same volume or Fibre Channel port of the storage system. Even if you do not
configure or use synchronous replication, do not configure the synchronous replication
port for RecoverPoint. There is no such restriction on the Ethernet ports for iSCSI.
You can configure RecoverPoint to use any available Ethernet port.

Fibre Channel configuration for synchronous replication 25

Considerations for synchronous replication

Zoning configuration
Ensure that you complete the following:
l Configure the port as an F-port to avoid any potential issues, and remove other
types of ports from the list of allowed port types.
l For a synchronous replication connection, connect SPA port of the source system
to the SPA port of the destination system. Similarly, SPB port of the source
system to the SPB port of the destination system.
For example,
n OB_H1450 SPA Port 4 <--> OB_H1443 SPA Port 4
n OB_H1450 SPB Port 4 <--> OB_H1443 SPB Port 4
l The SPA and SPB ports on the same side (source or destination) must have the
identical port configuration. However, the configuration of ports on the source
system can be different from the port configuration on the destination system. For
example, SPA Port 4 <--> SPA I/O Module 0 Port 0 and SPB Port 4 <--> SPB I/O
Module 0 Port 0 are supported.
l It is recommended to have a separate FC port for FC host access. But, the
synchronous replication FC port can be shared with host access.
l Although setting the port speeds to Auto works, it is recommended that you set
the port speeds for the FC ports on both systems and the FC switch port.
High availability consideration
To ensure high availability, consider the following:
l If the FC connection for an SP is disrupted, set the SP ownership for the source
LUN to the other SP. SP ownership on the destination LUN automatically switches
to the corresponding SP on the destination system.
l If an SP on the destination system shuts down or is faulted (not in a normal state),
the system will automatically change the SP ownership on the destination LUN.
Ensure that you manually set the SP ownership for the source LUN to the other
SP.

26 Unity Family 4.3 Configuring Replication

CHAPTER 4
Configure replication using Unisphere

This chapter addresses the following topics:

l Configure protection and mobility interfaces..................................................... 28

l Configure replication connections......................................................................29
l Create a replication session............................................................................... 29
l Manage replication sessions............................................................................... 31
l Configure an override network address for file replication ................................ 34

Configure replication using Unisphere 27

Configure replication using Unisphere

Configure protection and mobility interfaces

Before you begin
Protection and mobility (import) interfaces can be shared between replication and
import. For import, only VDM imports require interfaces. Block imports do not require
interfaces.
Protection and mobility (import) interfaces are configured to support VDM imports
and must be created prior to creating an import connection. A mobility interface IP
address is assigned to SPA and SPB on the target Unity system. Once the mobility
interface is configured, you can create the import connection between the Unity
system and the VNX system. Mobility interfaces are not used for block import
sessions.
Ensure the following:
l The interface port is cabled and connected to a network switch.
l Both SPs are up and running.
Obtain the following information for each Storage Processor (SP):
l IP address associated with the interface (replication or import). Although you can
specify an IPv4 or IPv6-based address, ensure that you specify the same type of
address for both SPs.
l IP address mask or prefix length that identifies the associated subnet.
l Gateway IP address associated with the interface.
l If applicable, the VLAN ID (between 1 and 4095) you want to associate the
interface with.

Note

For the network to continue functioning properly, ensure that you set the VLAN ID
only when you have configured the network switch port to support VLAN tagging
of multiple VLAN IDs.

Procedure
1. Under Protection & Mobility, select Interfaces.
2. Perform one of the following actions:
l To create an interface, select the Add icon. On the Create Interface
window, specify the relevant information:
n For asynchronous replication or import, from the Ethernet Port list,
select an available Ethernet port.
n For synchronous replication, from the Ethernet Port list, select Sync
Replication Management Port.

Note

Do not use Sync Replication Management Port for asynchronous

replication or import interfaces.
l To modify an interface, select the interface, and then select the Edit icon.
On the Interface Properties window, specify the relevant information.
l To delete an interface, select the interface, and then select the Delete icon.

28 Unity Family 4.3 Configuring Replication

 Configure replication using Unisphere

NOTICE

Before you delete an interface, ensure that the interface is not being used
by any replication or import session.

Configure replication connections

Before you begin
Ensure that you have set up relevant replication interface pairs, one on each SP, on
the source and destination systems. Obtain the following information:
l For remote replication, the IP address and associated user authentication
credentials to connect to the remote system.
l For local replication, the password associated with your user account.
l The connection mode you want to use for the replication-Asynchronous,
Synchronous, or Both. File-based storage resources only support Asynchronous
connection mode.
Procedure
1. Under Protection & Mobility, select Replication > Connections.
2. Perform one of the following actions:
l To create a replication connection, Select the Add icon. On the Create
Replication Connection window, specify the relevant information.
l To modify a replication connection, select the replication connection, and
then select the Edit icon. On the Replication Connection Properties
window, specify the relevant information.
l If new replication interfaces were added, or existing replication interfaces
were deleted, the remote system connection may become outdated. Select
the relevant replication, and then select Verify and Update to update the
remote system connection to pick up the latest replication interface changes
on the local and remote systems.

Create a replication session

Before you begin
Ensure that you have first created relevant replication interfaces and connections, and
then determine the following:
l The replication mode you want. You can choose from the following options:
n Asynchronous
n Manual
n Synchronous

Note

The synchronous replication mode is available only for block-based storage

resources.
l The Recovery Point Objective (RPO) for the replication session.
l The system you want to assign as the replication destination system. This is based
on the replication connections configured on the storage system.

Configure replication connections 29

Configure replication using Unisphere

l The name, pool, storage provisioning, and tiering policy you want to use for the
destination storage resource. The system will automatically create a destination
storage resource as part of this process.

Note

You can convert a thin LUN to a non-thin (thick) LUN, or a thick LUN to a thin
LUN with a LUN move operation. To enable data reduction on a thin LUN requires
an All-Flash pool on the destination system. For thick file systems, the replication
process matches the destination storage resource to the source. In this case, thin
and data reduction cannot be selected for file systems. For thin file systems, the
following rules apply for replication:
n If the source file system is thin, then the destination file system is also thin.
n If the source file system is thin and either the source or destination system
does not support data reduction, then the destination file system is also thin.
n If both the source and destination systems support data reduction, then the
source or destination can have either data reduction enabled or no data
reduction enabled.
n However, if you change the source file system data reduction attribute, the
change is not replicated to the destination system (retains the original setting).

l Replicate scheduled snapshots to the destination and to use the same retention
policy or a different policy. Also, when a replication session is created some time
after the resource was created, determine whether to select the one-time option
to replicate all existing snapshots.

NOTICE

Snapshots that have been created and attached as well as read/write (share)
snapshots (as opposed to read-only checkpoint snapshots) are not eligible for
replication. Only unattached (read-only) snapshots are eligible for replication.

Procedure
1. Under Storage, select the storage resource, and then select Edit.

Note

For file storage, you must first configure replication on the NAS server.

2. On the Properties window, select the Replication tab.

3. Select Configure Replication.
4. In the Create a Session window, specify the relevant information.
Once you specify the necessary information for the destination storage
resource or NAS server, the system will automatically create the storage
resource or NAS server on the destination system.

30 Unity Family 4.3 Configuring Replication

 Configure replication using Unisphere

Note

On a NAS server that is protected by replication, you must create a replication

session for each file system on it. Otherwise, file system related configurations
like shares and exports may be lost after a NAS server replication session
failover.
l When you use Unisphere to create replication for a NAS server, the system
automatically creates a replication session for each file system on it.
l When you use Unisphere to create a new file system, Unisphere creates a
replication by default.

Manage replication sessions

A replication session establishes an end-to-end path for a replication operation
between a source and destination. The replication source and destination may be
remote or local, so the session establishes the path that the data follows as it moves
from source to destination.
If you want to set up a replication session, see Configure replication on page 16.
Procedure
1. Access the Replication Session Details screen in one of the following ways:
l If you know the name of the replication session, go to Protection &
Mobility > Replication > Sessions.
l If you know the name of the storage resource or NAS server associated with
the replication session, go to the Replication tab on the Properties window
of the relevant storage resource or NAS server.
2. Perform one of the following actions:

Manage replication sessions 31

Configure replication using Unisphere

Note

On Unity systems running OE version 4.2, the following asynchronous

replication actions affect both the NAS server and its associated file systems
when run at the NAS server level:
l Failover
l Failover-with-sync
l Failback
l Pause
l Resume
Those same asynchronous replication actions towards a file system remain at
the file system level. The following asynchronous replication actions affect only
the NAS server when run at the NAS server level or are still individual
operations toward file system replication sessions:
l Create
l Sync
l Delete
l Modify

Action Description
Modify a Select the Edit icon to modify the name and synchronization
session settings of the session.
Delete a session Select Delete. Deleting a replication session also deletes the
internal snapshots used by the session. If the connection
between the systems is healthy, the session on the
destination system gets automatically deleted when you
delete the session on the source system. You can individually
delete replication sessions at the source and destination
systems, however, this is not recommended unless the
connection is down.

Note

You cannot delete a replication when a synchronization is in

progress.

Pause and Select Pause or Resume. Pause stops a replication session

resume a without deleting the replication session. Resuming a session
session from the destination system after a failover or failover with
sync reverses the direction of the replication. Resume is not
available on the destination if the session is not failed over.
Changes on the destination system are copied back to the
source system at the next RPO interval after a connection is
restored.

32 Unity Family 4.3 Configuring Replication

 Configure replication using Unisphere

Action Description

Note

Pausing a replication session while a snapshot is being

copied results in stopping the transfer. The destination
resource is rolled back to the common base snapshot so that
the destination is brought to a consistent state. Resuming a
paused session restarts the previously stopped transfer.
Replication restores the destination resource to the common
base snapshot first, then restarts the snapshot copy by
copying the differences between the common base
snapshot and the snapshot to be transferred.

Manually Select Sync. Changes since the last sync are replicated to
synchronize a the destination system.
session
Fail over a Select Failover. In response to an unplanned emergency
session in an scenario in which the source has become unavailable,
unplanned failover should switch the status of the source and
emergency destination storage resources. After the failover operation,
the destination object's status becomes read/write,
however, the source and destination do not switch roles until
a resume operation is run.

Note

In this type of failover, any active data transfers are

terminated, 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 object from read/write to
read-only.

Fail over a Select Failover with Sync. The destination synchronizes

session in with the source storage resource, the replication session is
preparation for stopped, and the status of the storage resources are
a planned switched. After the failover operation, the destination
downtime object's status becomes read/write and the source object's
status becomes read-only.

Note

To perform this type of failover, both the source and

destination objects of the session must be available.

Fail back a Select Failback. A failback operation switches the status of

session the storage resources following a failover operation. Once
the destination synchronizes with the source again, the
source storage resource's status returns to read/write and
the destination storage resource's status returns to read-
only.

Manage replication sessions 33

Configure replication using Unisphere

Action Description

Note

You can perform this action from the destination system

only. Both the source and destination storage resources
must be available to perform a successful failback operation.

Note

Any modifications to the attributes of the source storage resource are not
automatically synchronized over to the destination storage resource. When a
failover occurs, ensure that you modify the attributes of the associated
destination storage resource to match the attributes of the source storage
resource.

Configure an override network address for file replication

If you have file replication configured with a destination site on a different physical
network, to ensure minimal downtime during a failover, ensure that you modify the
destination NAS server properties to include an override address for the network
interface.

Note

You may still need to manually fail over individual file systems associated with the NAS
server.

If you have configured the source NAS server with LACP or FSN, or both, you must do
one of the following:
l Configure the destination system with the same LACP or FSN configuration. When
the LACP/FSN environment is mirrored on the destination system exactly, no
further action is required and the destination NAS server will automatically select
the LACP/FSN device as part of its configuration.
l Include an override address for the network interface after first creating the
replication session.

NOTICE

After the replication session has been created and the source NAS server is using an
LACP/FSN configuration, you must do the following:
1. Manually edit the Network settings in the Properties of the NAS server on the
destination system.
2. Select Override address and an interface to use. If you do not do this, a DU after a
failover from the source system to the destination system will occur.

To configure an override address on the destination NAS server:

Procedure
1. Under Storage, select File > NAS Servers.

34 Unity Family 4.3 Configuring Replication

 Configure replication using Unisphere

2. On the Network tab, select the network interface, and click Edit.
3. On the Edit NAS Server Network Interface screen, select the Override
address checkbox, and specify relevant address information.

Configure an override network address for file replication 35

Configure replication using Unisphere

36 Unity Family 4.3 Configuring Replication

CHAPTER 5
Configure replication using the CLI

This chapter addresses the following topics:

l Manage network interfaces................................................................................38

l Manage remote storage systems....................................................................... 43
l Manage replication sessions...............................................................................49
l Associated CLI commands..................................................................................72

Configure replication using the CLI 37

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:
l iSCSI interfaces for controlling access to iSCSI storage. You assign the interface
to an iSCSI node.
l 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 4 Interface attributes

Attribute Description
ID ID of the interface.

Type Interface type. Value is one of the following:

l iscsi — Interface for iSCSI storage.
l 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.

Note

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.

38 Unity Family 4.3 Configuring Replication

 Configure replication using the CLI

Table 4 Interface attributes (continued)

Attribute Description
Health state A numerical value indicating the health of the
system. Value is one of the following:
l Unknown (0)
l OK (5)
l OK BUT (7)
l Degraded/Warning (10)
l Minor failure (15)
l Major failure (20)

Health details Additional health information.

Create interfaces
Create an interface.
Format
/net/if create [ -async ] [-vlanId <value>] -type { iscsi |
replication} -port <value> -addr <value> [-netmask <value>] [-
gateway <value>]
Action qualifier

Qualifier Description
-async Run the creation operation in asynchronous mode.
-type Specify the interface type. Value is one of the following:
l iscsi — Interface for iSCSI storage.
l replication — Interface for replication-related data or
management traffic.

-port Specify the ID of the SP port or link aggregation that will use the
interface.

Note

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

Create interfaces 39
Configure replication using the CLI

Qualifier Description

Note

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 Specify 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 Specify the subnet mask for the interface.

Note

This qualifier is not required if the prefix length is specified in the -addr
attribute.

-gateway Specify the gateway for the interface.

Note

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.

Note

The show action command on page 72 explains how to change the output format.

Format
/net/if [ {-id <value> | -port <value> | -type <value>} ] show
Object qualifier

Qualifier Description
-id Type the ID of an interface.

40 Unity Family 4.3 Configuring Replication

 Configure replication using the CLI

Qualifier Description
-port Type the port the interface is associated with.
-type Specify the type of the interface. Valid values are:
l iscsi
l replication

Example
The following command displays the details of all interfaces on the system.
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/if show -detail

Storage system address: 10.0.0.1

Storage system port: 443
HTTPS connection

1: ID = if_0
Type = file
NAS server = nas_0
Preferred = yes
Port = eth0_spa
VLAN ID = 0
IP address = 3ffe:80c0:22c:4e:a:0:2:7f/64
Subnet mask =
Gateway = fe80::20a8bff:fe5a:967c
IPv4 mode =
IPv4 address =
IPv4 subnet mask =
IPv4 gateway =
IPv6 mode = static
IPv6 address = 3ffe:80c0:22c:4e:a:0:2:7f/64
IPv6 link-local address =
IPv6 gateway = fe80::20a8bff:fe5a:967c
SP = SPA

2: ID = if_1
Type = file
NAS server = nas_1
Preferred = yes
Port = eth1_spb
VLAN ID = 1
IP address = 10.1.1.2
Subnet mask = 255.255.255.0
Gateway = 100.100.1.254
IPv4 mode = static
IPv4 address = 10.1.1.2
IPv4 subnet mask = 255.255.255.0
IPv4 gateway = 100.100.1.254
IPv6 mode =
IPv6 address =
IPv6 link-local address =
IPv6 gateway =
SP = SPA

3: ID = if_2
Type = replication
NAS server =
Preferred = no
Port = eth1_spb
VLAN ID =
IP address = 10.100.05.50
Subnet mask = 255.255.248.0
Gateway = 10.100.72.1
IPv4 mode = static

View interfaces 41
Configure replication using the CLI

IPv4 address = 10.103.75.56

IPv4 subnet mask = 255.255.248.0
IPv4 gateway = 10.103.72.1
IPv6 mode =
IPv6 address =
IPv6 gateway =
SP = spb

Change interface settings

Change the settings for an interface.
Format
/net/if -id <value> set [-vlanId <value>] [-addr <value>] [-
netmask <value>] [-gateway <value>]
Object qualifier

Qualifier Description
-id Type the ID of the interface to change.

Action qualifier

Qualifier Description
-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.

Note

If no VLAN ID is specified, which is the default, packets do not have

VLAN tags. The Unisphere online help provides more details on VLANs.

-addr Specify the IP address for the interface.

Note

The prefix length should be appended to the IPv6 address. The IPv4
netmask may be specified in address attribute after the slash.

-netmask Specify the IPv4 subnet mask for the interface.

-gateway Specify the gateway for the interface.

Note

The gateway is optional for both IPv4 and IPv6. This qualifier configures
the default gateway for the specified port’s SP.

Example
The following command changes the gateway address for interface IF_1:

42 Unity Family 4.3 Configuring Replication

 Configure replication using the CLI

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456!/net/if –id IF_1 set

-gateway 2001:db8:0:170:a:0:2:70

Storage system address: 10.0.0.1

Storage system port: 443
HTTPS connection

ID = IF_1
Operation completed successfully.

Delete interfaces
Delete an interface.

NOTICE

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 5 Remote system attributes

Attribute Description
ID ID of the remote system.

Model Model number of the remote system.

Delete interfaces 43
Configure replication using the CLI

Table 5 Remote system attributes (continued)

Attribute Description
Serial number Serial number of the remote system.

Address Network name or management IP address of the remote system.

Alternate An alternative management IP address of the remote system.

management
address

Health state Health state of the storage resource. The health state code appears in
parentheses. Value is one of the following:
l OK (5)—Resource is operating normally.
l Degraded/Warning (10)—Working, but one or more of the
following may have occurred:
n One or more of its storage pools are degraded.
n Its replication session is degraded.
n Its replication session has faulted.
n It has almost reached full capacity. Increase the primary
storage size, or create additional resources to store your data,
to avoid data loss.
l Minor failure (15)—One or both of the following may have
occurred:
n One or more of its storage pools have failed.
n The associated iSCSI node has failed.
l Major (20)—One or both of the following may have occurred:
n Resource is unavailable.
n One or more of the associated storage pools have failed.
l Critical failure (25)—One or more of the following may
have occurred:
n One or more of its storage pools are unavailable.
n Resource is unavailable.
n Resource has reached full capacity. Increase the primary
storage size, or create additional resources to store your data,
to avoid data loss.
l Non-recoverable error (30)—One or both of the
following may have occurred:
n Resource is unavailable.
n One or more of the associated storage pools are unavailable.

Health details Additional health information.

Source user name For storage systems that are the source in a replication session, the
username that is used to access the system.

Source user For storage systems that are the source in a replication session, the
password user password that is used to access the system.

44 Unity Family 4.3 Configuring Replication

 Configure replication using the CLI

Table 5 Remote system attributes (continued)

Attribute Description
Local interfaces The list of local interface identifiers used to create the
interconnection between the two systems.

Remote The list of remote interface identifiers used to create the

interfaces interconnection between two systems.

Destination user For storage systems that are the destination in a replication session,
name the username that is used to access the system.

Destination user For storage systems that are the destination in a replication session,
password the user password that is used to access the system.

Connection type The type of connection with the remote system. Valid values are:
l sync
l async
l both

Synchronous FC The fibre channel ports enabled for synchronous replication.

ports
Note

For a local system (RS_0), this field will appear empty only when
there are no FC ports. For remote systems, this will be empty when
the connection type is asynchronous.

Create remote system configurations

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

Note

For a source VNX system with two control stations, the home directory of the
sysadmin user, which is used in configuring the import connection, must exist on the
primary control station of the VNX.

Format
/remote/sys create -addr <value> [-type VNX] -srcUsername
<value> {-srcPassword <value> | -srcPasswordSecure} -
dstUsername <value> {-dstPassword <value> | -dstPasswordSecure}
[-connectionType {sync | async | both}]
Action qualifiers

Qualifier Description
-addr Specify the network name or IP address of the remote
system.
-type Specify the remote system type. Valid values are:
l VNX

-srcUsername For systems that are the source in a replication, type the
username that is used to access the system.

Create remote system configurations 45

Configure replication using the CLI

Qualifier Description
-srcPassword For systems that are the source in a replication, 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 or VNX in an import session, specify the username
that is used to access the system.
-dstPassword For systems that are the destination in a replication
session or VNX in an import session, specify 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:
l Network address is 10.64.75.10.
l Includes access credentials for when the system is the source or destination.
The configure remote system receives the ID RS_65536:
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /remote/sys create –
addr 10.64.75.10 –type VNX -dstUsername admin1 -dstPassword
Password789!

Storage system address: 10.0.0.1

Storage system port: 443
HTTPS connection

ID = RS_65536
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.

Note

The show action command on page 72 explains how to change the output format.

Format
/remote/sys [-id <value>] show

46 Unity Family 4.3 Configuring Replication

 Configure replication using the CLI

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
Alternate Management Address =
Model = Unity 300
Serial number = FCNC987654321
Connection type = async
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.

Verify settings for remote storage systems 47

Configure replication using the CLI

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.

Note

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

48 Unity Family 4.3 Configuring Replication

 Configure replication using the CLI

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:
l Downtime associated cost of a system failure is minimized.
l 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.
It is important to note that when replicating from a Unity system running OE 4.1.x to a
Unity system running OE 4.0.x, you cannot have new 4.1.x features enabled on the
source.

Note

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 6 Replication session attributes

Attribute Description
ID ID of the session.

Name Name of the replication session.

Session type Storage type of the session. Valid values are:

l lun
l block
l file

Manage replication sessions 49

Configure replication using the CLI

Table 6 Replication session attributes (continued)

Attribute Description

l nas server

Synchronization Type of synchronization. Valid values are:

type
l auto—Data is replicated automatically in order to maintain the
desired Recovery Point Objective (RPO).
l manual—Data will only be replicated when manually initiated.
l sync—Data is synchronously replicated with RPO=0.

Note

For asynchronous replication, the potential for data loss increases as

the RPO 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.

Resource type Type of storage resource to which the replication session is applied.
Valid values are:
l LUN
l LUN group
l File System
l VMware VMFS
l VMware NFS
l NAS Server

Sync State Additional state of the replication session, specific to the replication
mode.
l For asynchronous replication, valid values are:
n idle— No active syncing.
n manual— User initiated syncing.
n auto syncing— System initiated syncing.
l For synchronous replication, valid values are:
n unknown—Unknown sync state.
n out of sync—Destination is out of sync with the source.
n in sync—Destination is an exact copy of the source.
n consistent—Destination is a point in time copy of the
source.
n syncing—System initiated syncing.

50 Unity Family 4.3 Configuring Replication

 Configure replication using the CLI

Table 6 Replication session attributes (continued)

Attribute Description

n inconsistent—Destination is not a point in time copy of

the source.

Health state Health state of the session. Valid values are:

l Unknown—Session health cannot be determined.
l OK—Session is operating normally.
l Degraded/Warning—An error has caused one or more of the
following:
n Session has been paused.
n 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.
n Session is syncing.
l Minor failure—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.
l Critical failure— Session has encountered an error that
has halted the session.

Note

If the replication session is in an error state, in addition to resolving the

issue (for example, destination pool out of space), try pausing, and
then resuming the replication session. If the problem persists, delete
and then create the replication session again.

Health details Additional health information.

Operational Operational status of the session. The operational status code appears
status in parentheses.
l Unknown (0x0)
l Non Recoverable Error (0x7)
l Lost Communication (0xd)
l Failed Over with Sync (0x8400)
l Failed Over (0x8401)
l Manual Syncing (0x8402)
l Paused (0x8403)
l Idle (0x8404)
l Auto Sync Configured (0x8405)

Manage replication sessions 51

Configure replication using the CLI

Table 6 Replication session attributes (continued)

Attribute Description

l Destination Extend Failed Not Syncing (0x840B)

l Destination Extend In Progress (0x840C)
l Active (0x840D)
l Lost Sync Communication (0x840E)
l Syncing (0x8411)

Source status Status of the source storage resource in the session. Valid values are:
l Unknown—Source status is unknown.
l OK—Source is operating normally.
l Paused—Replication session for the source is currently paused.
l Fatal replication issue—Source has experienced a
critical error and the replication session has stopped. Delete the
replication session and re-create it.
l 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.
l 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 is shown as Restricted Replication
Access = Yes. To resume operations on the source site, the
replication session needs to be failed back.
l Switched over—The replication session has switched over to
the source site. In a switched over state, the source object is
read/write. When communication is reestablished between the
source and destination, the destination is shown as Restricted
Replication Access = Yes. To resume operations on the destination
site, the replication session needs to be failed over.

Destination Status of the destination storage resource in the session. Valid values
status are:
l Unknown—Status of the destination resource is unknown.
l OK—Destination resource is operating normally.
l Paused—Replication session for destination resource is currently
paused.
l Fatal replication issue—Destination has experienced a
critical error and the replication session has stopped. Delete the
replication session and re-create it.
l 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

52 Unity Family 4.3 Configuring Replication

 Configure replication using the CLI

Table 6 Replication session attributes (continued)

Attribute Description

systems. A change in the network configuration on either side

could also interrupt communication.
l 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 is shown as Restricted Replication
Access = Yes. To resume operations on the source site, the
replication session needs to be failed back.
l Switched over—The replication session has switched over to
the source site. In a switchover state, the source object is read/
write. When communication is reestablished between the source
and destination, the destination is shown as Restricted Replication
Access = Yes. To resume operations on the destination site, the
replication session needs to be failed over.

Network status Status of the network connection. Valid values are:

l Unknown—Network status is currently unknown. If you continue
to see this value, check the network connections.
l OK—Network connection is operating normally.
l 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 (lost IP) between
the systems. A change in the network configuration on either side
could also interrupt communication.
l Lost Sync Communication—Fiber Channel communication
with the synchronous replication remote system has been lost. It is
likely that the Fiber Channel connection has encountered issues.

Destination Type of destination used in the session. Valid values are:

type
l 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.
l 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 For remote sessions, the ID of the remote system on which the data is
system replicated.

Local role The local system role. Valid values are:

l Unknown—Status of the local system is unknown.
l Source—Resource on the local system is replicated to the
remote system.
l Destination—Resource on the local system is the replication
destination of the resource on the remote system.

Manage replication sessions 53

Configure replication using the CLI

Table 6 Replication session attributes (continued)

Attribute Description

l Loopback—Resources participating in the replication session are

located on the same storage system.
l 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.

Source SP A ID of the interface on the SPA of the source system for the
interface replication.

Source SP B ID of the interface on the SPB of the source system for the
interface replication.

Destination ID of the storage resource on which the data is replicated.

resource

Destination SP ID of the interface on the SPA of the destination system for the
A interface replication.

Destination SP ID of the interface on the SPB of the destination system for the
B interface replication.

Time of last Date and time of the last replication synchronization.

sync

Sync status Percentage of the replication synchronization that has completed and
the amount of time remaining.

Note

For synchronous replication, the percentage is reported when the

replication is in the Syncing state.

Sync transfer Data transfer rate during a replication synchronization. For multi-LUN
rate applications there is a comma-separated list of values.

Sync transfer Status of synchronization (percentage and time remaining). For multi-
size remaining LUN applications there is a comma-separated list of values.

Previous Previous transfer rate for the replication session.

transfer rate

Average Average transfer rate for the replication session.

transfer rate

Element pairs For consistency group and VMware VMFS datastore replications, the
LUN element pairs within the replication.

Hourly snapshot Amount of time to keep replicated hourly snapshots on the destination.
keep for Output can be:
l Blank when scheduled snapshots are not replicated.
l <value><qualifier>—When a retention duration is specified,
where:

54 Unity Family 4.3 Configuring Replication

 Configure replication using the CLI

Table 6 Replication session attributes (continued)

Attribute Description

n value—An integer value. If the qualifier is h (hours), the valid

range is from 1 to 8760. If the qualifier is d (days), the valid
range is from 1 to 365.
n qualifier—A value qualifier. The valid values are:
– h (hours)
– d (days)
l Forever—When -keepFor value is not specified and allow auto-
delete is requested
l Same as source—Keep the destination retention policy the same
as the source retention policy

Hourly snapshot Whether or not the destination pool's auto-delete policy allows
allow auto- replicated hourly snapshots on the destination to be deleted. Output
delete can be:
l Blank when scheduled snapshots are not replicated.
l Same as source—Keep the destination retention policy the same
as the source retention policy
l yes—When -allowAutoDelete is set
l no—When -keepFor is set

Daily snapshot Amount of time to keep replicated daily snapshots on the destination.
keep for Output can be:
l Blank when scheduled snapshots are not replicated.
l value—An integer value. If the qualifier is h (hours), the valid
range is from 1 to 8760. If the qualifier is d (days), the valid range
is from 1 to 365.
l qualifier—A value qualifier. The valid values are:
n h (hours)
n d (days)
l Same as source—Keep the destination retention policy the same
as the source retention policy

Daily snapshot Whether or not the destination pool's auto-delete policy allows the
allow auto- replicated daily snapshots on the destination to be deleted. Output can
delete be:
l Blank when scheduled snapshots are not replicated.
l Same as source—Keep the destination retention policy the same
as the source retention policy
l yes—When -allowAutoDelete is set
l no—When -keepFor is set

Manage replication sessions 55

Configure replication using the CLI

Create replication sessions

Create a replication session.

NOTICE

Snapshots that have been created and attached as well as read/write (share)
snapshots (as opposed to read-only checkpoint snapshots) are not eligible for
replication. Only unattached (read-only) snapshots are eligible for replication. For
asynchronous replication, you can replicate existing snapshots and snapshots created
from snapshot schedules. For synchronous block replication, you cannot replicate
snapshots.

Note

On a NAS server protected by replication, you must create a replication session for
each file system on it. Otherwise, file system related configurations like shares and
exports may be lost after a NAS server replication session failover.

Prerequisites
Before creating a replication session, complete the following configuration tasks:
l Create the storage resource that provides the replication source.
l For local replication, create a replication destination on a local system.
l 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 [-async] -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>]}[-
replicateHourlySnaps {yes [{-keepSameAsSource | -keepFor
<value> | -allowAutoDelete}] | no}] [-replicateDailySnaps {yes
[{-keepSameAsSource | -keepFor <value> | -allowAutoDelete}] |
no}] [-replicateExistingSnaps]
Action qualifiers

Qualifier Description
-async Run an action in asynchronous mode.
-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.

56 Unity Family 4.3 Configuring Replication

 Configure replication using the CLI

Qualifier Description

Note

This qualifier is used for asynchronous 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.

Note

This qualifier is used for asynchronous 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:

l 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.
l 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 on page 46 explains how to view
the IDs of the remote system configuration on the
local system.
-dstRes Type the ID of the destination storage resource.

Note

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:
l uemcli /stor/prov/sf/res -remSys
<value> show
l uemcli /stor/prov/iscsi/res -remSys
<value> show
l uemcli /stor/prov/vmware/nfs -
remSys <value> show

Create replication sessions 57

Configure replication using the CLI

Qualifier Description
-dstSPAInterface Type the ID of the interface on the SPA of the
destination system for the replication.

Note

This qualifier is used for asynchronous 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.

Note

This qualifier is used for asynchronous 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:
l auto—Data is replicated automatically in order
to maintain the desired Recovery Point
Objective (RPO).
l manual—Data will only be replicated when
manually initiated.

Note
This qualifier is used for asynchronous replications
only.
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:
l yes
l no

Note

This qualifier is used for asynchronous replications

only.

58 Unity Family 4.3 Configuring Replication

 Configure replication using the CLI

Qualifier Description
-rpo Type the time interval for when the synchronization
will run. Use the following format:
<HH>[:MM]
where:
l HH—Type the number of hours. Range is 00-24
hours (1 day).
l MM—Type the number of minutes, in 5 minute
increments. Range is 05 to 55.
For synchronous replication, specify the value 0.
Once set, the value cannot be reset from zero to
non-zero or from non-zero to zero.
-replicateHourlySnaps Specify whether or not to mark hourly scheduled
snapshots for replication. Valid values are:
l yes
l no

Note

This qualifier is used for asynchronous replications

only.

-replicateDailySnaps Specify whether or not to mark daily scheduled

snapshots for replication. Valid values are:
l yes
l no

Note

This qualifier is used for asynchronous replications

only.

-keepSameAsSource Indicates whether or not to use the same retention

policy (expiration time and auto-delete) of the
source for the destination. This option propagates
changes made to the source retention policy to the
destination retention policy (from that point
forward for newly created scheduled snapshots, old
snapshots are left as is). No values are allowed.
This option is enabled by default if -keepFor or -
allowAutoDelete are not set.

Note

This qualifier is used for asynchronous replications

only.

-keepFor Specifies the retention time after which the

snapshot is deleted on the destination. The interval
can be defined in days or hours. Use the following
format:

Create replication sessions 59

Configure replication using the CLI

Qualifier Description
<value><qualifier>
where:
l value—An integer value. If the qualifier is h
(hours), the valid range is from 1 to 61194. If the
qualifier is d (days), the valid range is from 1 to
2549.
l qualifier—A value qualifier. The valid values are:
n h (hours)
n d (days)

Note

This qualifier is used for asynchronous replications

only.

-allowAutoDelete Specify whether auto delete is allowed on the

replicated copy of this snapshot or snapshot set.
Valid values:
l yes
l no

Note

This qualifier is used for asynchronous replications

only.

-replicateExistingSnaps Specify whether or not to replicate snapshots

already existing on the source resource. This is a
one-time option available during session creation
that will replicate snapshots existing on the source
at that moment in time. All eligible snapshots are
replicated and have the source retention policy
applied for the destination retention policy. For a
snapshot to be eligible for this option, it must meet
these 3 criteria:
l The snapshot is created by either the user or a
snapshot schedule.
l The snapshot is read-only (file resource
snapshot must be a checkpoint snapshot; block
resource snapshot must not be attached).
l The snapshot is not currently undergoing
deletion.

Note

This qualifier is used for asynchronous replications

only.

60 Unity Family 4.3 Configuring Replication

 Configure replication using the CLI

Example
The following command creates a replication session with these settings:
l Source storage resource is file system RS_1.
l Destination system type is remote.
l Remote destination system is RS_2.
l Remote storage resource is file system LUN_2.
l Synchronization type is automatic.
l 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.

Note

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

Format
/prot/rep/session [{-id <value> | -name <value> | -res
<value>}] show
Object qualifiers

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 1
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

View replication sessions 61

Configure replication using the CLI

Session type = nas server

Synchronization type = auto
Resource type = NAS Server
Destination type = remote

Example 2
The following command displays all replication sessions on the system and their
details:
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /prot/rep/session
show -detail

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
RPO =
Resource type = LUN
Sync State = idle
Health state = OK (5)
Health details = "This replication session
is operating normally. No action is required."
Operational status = Idle (0x8404)
Source status = OK
Destination status = OK
Network status = OK
Destination type = local
Destination system = local
Local role = Local
Source resource = sv_1
Source SP-A interface = N/A
Source SP-B interface = N/A
Destination resource = sv_2
Destination SP-A interface = N/A
Destination SP-B interface = N/A
Time of last sync = N/A
Sync status =
Sync transfer rate = N/A
Sync transfer size remaining = 0
Previous transfer rate = N/A
Average transfer rate = N/A
Element pairs = N/A
Hourly snapshot keep for = 3h
Hourly snapshot allow auto-delete = no
Daily snapshot keep for = same as source
Daily snapshot allow auto-delete = same as source

Change replication session settings

Change the settings for a replication session.
Format
/prot/rep/session {–id <value> | -name <value>} set [-async] [-
newName <value>] [-srcSPAInterface <value>] [-dstSPAInterface
<value>] [-srcSPBInterface <value>] [-dstSPBInterface <value>]
[-syncType {manual | auto -rpo <value>}] [-replicateHourlySnaps
{yes [{-keepSameAsSource | -keepFor <value> | -

62 Unity Family 4.3 Configuring Replication

 Configure replication using the CLI

allowAutoDelete}] | no}] [-replicateDailySnaps {yes [{-

keepSameAsSource | -keepFor <value> | -allowAutoDelete}] | no}]
Object qualifiers

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
-async Run an action in asynchronous mode.
-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.

Note

This qualifier is used for asynchronous 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.

Note

This qualifier is used for asynchronous 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.

Note

This qualifier is used for asynchronous 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.

Note

This qualifier is used for asynchronous 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:

Change replication session settings 63

Configure replication using the CLI

Qualifier Description

l auto—Data is replicated automatically in order to

maintain the desired Recovery Point Objective
(RPO).
l manual—Data will only be replicated when
manually initiated.

Note
This qualifier is used for asynchronous replications
only.
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:
l HH—Type the number of hours. Range is 00-24
hours (1 day).
l MM—Type the number of minutes, in 5 minute
increments. Range is 05 to 55.

Note

For synchronous replication, specify the value 0. The

value cannot be reset from zero to non-zero or from
non-zero to zero.

- Specify whether or not to mark hourly scheduled

replicateHourlySnaps snapshots for replication. Valid values are:
l yes
l no

Note

This qualifier is used for asynchronous replications

only.

-replicateDailySnaps Specify whether or not to mark daily scheduled

snapshots for replication. Valid values are:
l yes
l no

64 Unity Family 4.3 Configuring Replication

 Configure replication using the CLI

Qualifier Description

Note

This qualifier is used for asynchronous replications

only.

-keepSameAsSource Specify whether or not to use the same retention

policy (expiration time and auto-delete) of the source
for the destination. This option propagates changes
made to the source retention policy to the destination
retention policy (from that point forward for newly
created scheduled snapshots, old snapshots are left
as is). No values are allowed.

Note

This qualifier is used for asynchronous replications

only.

-keepFor Specify the retention time after which the snapshot is

deleted on the destination. The interval can be
defined in days or hours. Use the following format:
<value><qualifier>
where:
l value—An integer value. If the qualifier is h
(hours), the valid range is from 1 to 61194. If the
qualifier is d (days), the valid range is from 1 to
2549.
l qualifier—A value qualifier. The valid values are:
n h (hours)
n d (days)

Note

This qualifier is used for asynchronous replications

only.

-allowAutoDelete
Note

Only valid when -replicateHourlySnaps yes or -

replicateDailySnaps yes.

Specify whether auto delete is allowed on the

replicated copy of this snapshot or snapshot set. Valid
values are:
l yes
l no

Change replication session settings 65

Configure replication using the CLI

Qualifier Description

Note

This qualifier is used for asynchronous replications

only.

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.

Pause replication sessions

Pause a replication session.
Format
/prot/rep/session {-id <value> | -name <value>} pause [-async]
Object qualifiers

Qualifier Description
-id Type the ID of the replication session to be paused.
-name Type the name of the replication session to be paused.

Action qualifiers

Qualifier Description
-async Run an action in asynchronous mode.

Example
The following command pauses replication session
81604378625_FCNCH097274B3A_0000_81604378627_FCNCH097274B37_0000:
uemcli /prot/rep/session –id
81604378625_FCNCH097274B3A_0000_81604378627_FCNCH097274B37_0000 pause

Storage system address: 10.0.0.1

Storage system port: 443
HTTPS connection

66 Unity Family 4.3 Configuring Replication

 Configure replication using the CLI

Operation completed successfully.

Resume replication sessions

Resumes an existing replication session.
Format
/prot/rep/session {–id <value> | -name <value>} resume [-async]
[-forceFullCopy] [-srcSPAInterface <value>] [-dstSPAInterface
<value>] [-srcSPBInterface value>] [-dstSPBInterface <value>]
Object qualifiers

Qualifier Description
-id Type the ID of the replication session to be resumed.
-name Type the name of the replication session to be resumed.

Action qualifiers

Qualifier Description
-async Run an action in asynchronous mode.
-forceFullCopy Specifies to force a full synchronization during the resume
operation.
-srcSPAInterface Type the ID of the interface on the SPA of the source system
for the replication.

Note

This qualifier is used for asynchronous 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.

Note

This qualifier is used for asynchronous 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.

Note

This qualifier is used for asynchronous replications on remote

systems only. If the qualifier is not specified, the system
identifies the interface automatically.

Resume replication sessions 67

Configure replication using the CLI

Qualifier Description
-dstSPBInterface Type the ID of the interface on the SPB of the destination
system for the replication.

Note

This qualifier is used for asynchronous replications on remote

systems only. If the qualifier is not specified, the system
identifies the interface automatically.

Example
The following command resumes replication session
81604378625_FCNCH097274B3A_0000_81604378627_FCNCH097274B37_0000:
uemcli /prot/rep/session –id
81604378625_FCNCH097274B3A_0000_81604378627_FCNCH097274B37_0000 resume

Storage system address: 10.0.0.1

Storage system port: 443
HTTPS connection

ID = 81604378625_FCNCH097274B3A_0000_81604378627_FCNCH097274B37_0000
Operation completed successfully.

Manually synchronize replication sessions

Manually synchronize a replication session.
Format
/prot/rep/session{–id <value> | -name <value>} sync [-async]
Object qualifiers

Qualifier Description
-id Type the ID of the replication session to synchronize.
-name Type the name of the replication session to synchronize.

Action qualifiers

Qualifier Description
-async Run an action in asynchronous mode.

Example
The following command initiates a manual resynchronization of replication session
REPS_1:
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /prot/rep/session –
id REPS_1 sync

Storage system address: 10.0.0.1

Storage system port: 443
HTTPS connection

68 Unity Family 4.3 Configuring Replication

 Configure replication using the CLI

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.

Note

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 [-async]
Object qualifiers

Qualifier Description
-id Type the ID of the replication session to delete.
-name Type the name of the replication session to delete.

Action qualifiers

Qualifier Description
-async Run an action in asynchronous mode.

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

Delete replication sessions 69

Configure replication using the CLI

back replication sessions on page 71 explains how to fail back a replication session
that has failed over.

Note

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 [-
async] [-sync {yes | no}] [-force]
Object qualifiers

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 qualifiers

Qualifier Description
-async Run an action in asynchronous mode.
-sync For an asynchronous replication session, specifies whether a
synchronization needs to be performed before failing over the replication
session. For a synchronous replication session, specifies whether to keep
synchronization on the reversed direction after failing over the session.
Valid values are:
l yes—For a planned failover. Can only be issued from the source
system. Where –sync is not specified, this is the default value for a
local replication session or session where role=source.
l no—For an unplanned failover. Can only be issued from the destination
system. Where –sync is not specified, this is the default value for a
remote replication session or session where role=destination.

Note

If the Network status=OK, the source system is probably OK. The

command issued from the destination system without this option will
fail. It is recommended to rerun the command using the yes option
from the source system. However, in that case, the command issued
from the destination system using the no option is still allowed.

70 Unity Family 4.3 Configuring Replication

 Configure replication using the CLI

Qualifier Description
-force Specifies whether to skip a pre-check operation on file systems of a NAS
server when a replication failover operation is issued from the source NAS
server. No values are allowed.

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:
l Synchronizes the destination and source storage resources.
l Makes the destination storage resource read-only.
l 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.

Note

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 [-
async] [-forceFullCopy]
Object qualifiers

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 qualifiers

Qualifier Description
-async Run an action in asynchronous mode.
-forceFullCopy Specifies to force a full synchronization before the failback
operation occurs.

Fail back replication sessions 71

Configure replication using the CLI

Qualifier Description

Note

l 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.
l This qualifier is used for asynchronous replications only.

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.

Associated CLI commands

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:
l nvp — The name-value pair (NVP) format displays output as
name=value. Name-value pair format on page 73 provides an
example of the NVP format.
l table — The table format displays output as a table, with
column headers and rows. By default, values that are too long to

72 Unity Family 4.3 Configuring Replication

 Configure replication using the CLI

Qualifier Description

fit in a column are cut off. Add -wrap after the table qualifier,
separated by a space, so that the values wrap. Table format on
page 73 provides an example of the table format.
l 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 on page 73 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”

The show action command 73

Configure replication using the CLI

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 7 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:
l mgmt — Management interface.
l file — Network interface for Windows (SMB) and Linux/UNIX
(NFS) storage.
l iscsi — iSCSI interface for iSCSI storage.
Manage network interfaces on page 38 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 MTU size set by the user.

size

Available MTU List of available MTU sizes.

size

Speed Current link speed of the port.

Requested speed Link speed set by the user.

Available List of available speed values.

speeds

Health state Health state of the port. The health state code appears in parentheses.
Value is one of the following:

74 Unity Family 4.3 Configuring Replication

 Configure replication using the CLI

Table 7 Network port attributes (continued)

Attribute Description

l Unknown (0) — Status is unknown.

l OK (5) — Port is operating normally.
l OK BUT (7) — Lost communication, but the port is not in use.
l Minor failure (15) — Lost communication. Check the
network connection and connected cables.
l 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 If the port is in a link aggregation, the ID of the link aggregation
ID appears. Manage link aggregations on page 79 explains how to
configure link aggregations on the SP ports.

Connector type Physical connector type. Valid values are:

l unknown
l RJ45
l LC
l MiniSAS_HD
l CopperPigtail
l NoSeparableConnector

MAC address Unique identifier assigned to a network device for communications on a

network segment.

SFP supported List of supported speed values of the inserted Small Form-factor
speeds Pluggable.

SFP supported List of supported protocols of the inserted Small Form-factor

protocols Pluggable. Valid values are:
l unknown
l FibreChannel
l Ethernet
l SAS

View Ethernet port settings

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

Note

The show action command on page 72 explains how to change the output format.

Format
/net/port/eth [-id <value>] show

Manage Ethernet ports 75

Configure replication using the CLI

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

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
/net/port/eth -id <value> set [-mtuSize <value>] [-speed
<value>]

76 Unity Family 4.3 Configuring Replication

 Configure replication using the CLI

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 8 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:
l Unknown (0) — Status is unknown.
l OK (5) — Port is operating normally.
l OK BUT (7) — Lost communication, but the port is not in
use.

Manage FC ports 77
Configure replication using the CLI

Table 8 FC port attributes (continued)

Attribute Description

l Minor failure (15) — Lost communication. Check the

network connection and connected cables.
l 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:

l unknown
l RJ45
l LC
l MiniSAS_HD
l CopperPigtail
l NoSeparableConnector

SFP supported List of supported speed values of the inserted Small Form-factor
speeds Pluggable.

SFP supported List of supported protocols of the inserted Small Form-factor

protocols Pluggable. Valid values are:
l unknown
l FibreChannel
l Ethernet
l SAS

Replication Type of replication capability. Valid values are:

capability
l Sync replication
l RecoverPoint

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.

78 Unity Family 4.3 Configuring Replication

 Configure replication using the CLI

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_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 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

Manage link aggregations 79

Configure replication using the CLI

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.

Note

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:

l Increases overall throughput since two physical ports are linked into one logical
port.
l Provides basic load balancing across linked ports since the network traffic is
distributed across multiple physical ports.
l Provides redundant ports so that if one port in a linked pair fails, the system does
not lose connectivity.

Note

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 9 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:
l SPA
l SPB

MTU size Maximum transmission unit (MTU) packet

size (in bytes) for the linked ports. Default is
1500 bytes per packet.

Linux device name Linux network device name.

FSN port ID ID of the FSN port to which the link

aggregation belongs, if it is part of an FSN.

Available MTU size List of available MTU sizes.

80 Unity Family 4.3 Configuring Replication

 Configure replication using the CLI

Table 9 Link aggregation attributes (continued)

Attribute Description
Health state Health state of the link aggregation. The
health state code appears in parentheses.
Value is one of the following:
l Unknown (0) — Status is unknown.
l OK (5) — Working correctly.
l OK BUT (7) — Lost connection, but
the link aggregation is not in use.
l Degraded/Warning (10) — Working
and performing all functions, but the
performance may not be optimum.
l 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.
l 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.
l Critical failure (25) — Failed
and recovery may not be possible. This
condition has resulted in data loss and
should be remedied immediately.
l 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.

Note

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.

Manage link aggregations 81

Configure replication using the CLI

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 = spa_la_2
SP = spa
Ports = spa_eth2, spa_iom_0_eth0
FSN port ID = spa_fsn_0_1
MTU size = 1500
Available MTU sizes = 1500, 9000
Health state = OK (5)
Health details = "The component is operating normally.
No action is required."
Operational status =

2: ID = spa_la_0_2
SP = spa
Ports = spa_iom_0_eth2, spa_iom_0_eth3
FSN port ID = None
MTU size = 1500
Available MTU sizes = 1500, 9000
Health state = OK (5)
Health details = "The component is operating normally.
No action is required."
Operational status =

Create link aggregations

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

Note

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.

Note

If you want to support jumbo frames, type 9000.

82 Unity Family 4.3 Configuring Replication

 Configure replication using the CLI

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.

Note

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.

Note

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

Manage link aggregations 83

Configure replication using the CLI

HTTPS connection

ID = la0_SPA
ID = la0_SPB
Operation completed successfully.

Delete link aggregations

Delete a link aggregation.

Note

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.

84 Unity Family 4.3 Configuring Replication

APPENDIX A
Use case for CLI

This appendix addresses the following topics:

l Replication configuration use case..................................................................... 86

Use case for CLI 85

Use case for CLI

Replication configuration use case

This section describes the use cases for configuring replication for block or file
storage resources.
Before you begin
Before you proceed with configuring replication, ensure that you complete the
following:
l Create identical storage resources on the source and destination systems.
l Configure replication interfaces for each SP on the source and destination
systems.
l On the destination system, the relevant storage resources and NAS servers are
individually created with the -replDest attribute set to yes.
l For file replication, ensure the following:
n Start with creating identical NAS servers on both the systems, and then create
identical file systems.
n Configure the NAS server on the destination system with a name other than
the NAS server name on the source system.
n Configure file systems on the destination system with the same name as the
file systems on the source system.

Configure local replication

Replication interfaces and connections do not apply to local replication. When using
the CLI or the REST API, once you create the identical source and destination storage
resources or NAS servers on the storage system, you can proceed to configure a
replication session. When using Unisphere, you only need to create the source storage
resources or NAS servers on the storage system. Unisphere does not allow you to
create a session with an existing destination. A DR_ is concatenated onto the resource
name for local destinations to ensure that the source and destination names on the
same system are unique (that is, LUN names need to be unique).
Note the following:
l For a disaster recovery scenario, it is recommended that the destination storage
resource and NAS server are configured on a storage pool other than the pool
used for the source storage resource and NAS server.
l For a migration scenario, which means migrating the source storage resource and
NAS server to a destination storage resource and NAS server on the same pool,
use the CLI to configure local replication. The Unisphere GUI does not allow local
replication between storage resources and NAS servers on the same pool.
l When you configure local replication for a tenant, create a pool for the tenant on
the destination system that matches the corresponding pool on the source system
(if one exists). Then add the tenant to the destination system, using the same
UUID and VLANs as the tenant on the source system.

Configure asynchronous replication

Before you begin
If you are configuring asynchronous replication for a tenant, create a pool for the
tenant on the destination system that matches the corresponding pool on the source

86 Unity Family 4.3 Configuring Replication

 Use case for CLI

system (if one exists). Then add the tenant to the destination system, using the same
UUID and VLANs as the tenant on the source
Procedure
1. Configure the replication interfaces on each SP of the source and destination
systems.
2. Configure a replication connection using the Asynchronous connection mode.
3. For file storage, create a replication session for the NAS server associated with
the file storage.

Note

Storage resources included in a NAS server automatically get replicated when a

replication session is first configured for the NAS server. The replication session
for the storage resources will inherit the same attributes as the associated
replication session of the associated NAS server. For the storage resources you
do not want participating in replication, you can choose to remove the
associated replication sessions manually.

4. Create a remote replication session for the storage resource.

Note

You only need to configure replication interfaces and connections for the first
replication session between two systems. The same connection can be used
again for subsequent replication sessions between the same systems.

Configure synchronous replication

Note

Synchronous replication is only supported for block storage.

Procedure
1. Identify the Synchronous Replication Fibre Channel (FC) ports on each system.
To determine the FC port used for synchronous replication, in the CLI console,
run the command /remote/sys show -detail. Port information, similar to
the following example, will appear in the output:

Synchronous FC ports = spb_fc4, spa_fc4

For more information, see the Unisphere CLI User Guide.

2. Zone the Synchronous Replication FC ports between the systems.

If the source and destination systems are co-located, instead of zoning, you can
choose to use direct-connected FC cables between the SPs.
3. Configure the replication interfaces on each SP of the source and destination
systems based on the connection mode you want:
l For synchronous replication support (Synchronous connection mode), use
the Synchronous Replication Management Ports on each SP of both the
systems.

Configure synchronous replication 87

Use case for CLI

l For asynchronous and synchronous replication support (Both connection

mode), in addition to the replication interfaces for Synchronous Replication
Management Ports, configure additional interfaces using the Ethernet Ports
on each SP of the source and destination systems.
4. Configure the replication connection between source and destination systems
from the source system only.
l For synchronous replication support, specify the Synchronous connection
mode.
l For asynchronous and synchronous replication support, specify the Both
connection mode.
5. Create the synchronous replication session.

Note

You only need to configure replication interfaces and connections for the first
replication session between two systems. The same connection can be used
again for subsequent replication sessions between the same systems.

Create a replication interface

Before you begin
Protection and mobility (import) interfaces can be shared between replication and
import. For import, only VDM imports require interfaces. Block imports do not require
interfaces.
Protection and mobility (import) interfaces are configured to support VDM imports
and must be created prior to creating an import connection. A mobility interface IP
address is assigned to SPA and SPB on the target Unity system. Once the mobility
interface is configured, you can create the import connection between the Unity
system and the VNX system. Mobility interfaces are not used for block import
sessions.
Ensure the following:
l The interface port is cabled and connected to a network switch.
l Both SPs are up and running.
Obtain the following information for each Storage Processor (SP):
l IP address associated with the interface (replication or import). Although you can
specify an IPv4 or IPv6-based address, ensure that you specify the same type of
address for both SPs.
l IP address mask or prefix length that identifies the associated subnet.
l Gateway IP address associated with the interface.
l If applicable, the VLAN ID (between 1 and 4095) you want to associate the
interface with.

Note

For the network to continue functioning properly, ensure that you set the VLAN ID
only when you have configured the network switch port to support VLAN tagging
of multiple VLAN IDs.

Ensure that you create replication interfaces on each SP.

88 Unity Family 4.3 Configuring Replication

 Use case for CLI

Procedure
1. Run the following command to create the interface on SP A:
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/if create
-type replication -port eth1_spa -addr 10.0.1.1 -netmask
255.255.255.0 -gateway 10.0.1.0

Storage system address: 10.0.0.1

Storage system port: 443
HTTPS connection

ID = IF_1
Operation completed successfully.

2. Run the following command to create the interface on SP B:

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /net/if create
-type replication -port eth1_spb -addr 10.0.1.2 -netmask
255.255.255.0 -gateway 10.0.1.0

Storage system address: 10.0.0.1

Storage system port: 443
HTTPS connection

ID = IF_2
Operation completed successfully.

View interfaces
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 = 10.0.1.1
Subnet mask = 255.255.255.0
Gateway = 10.0.1.0
SP = spa

3: ID = IF_2
Type = replication
Port = eth1_spb
VLAN ID =
IP address = 10.0.1.2
Subnet mask = 255.255.248.0
Gateway = 10.0.1.0

Create a replication interface 89

Use case for CLI

SP = spb

Create a replication connection

Before you begin
Ensure that you have set up relevant replication interface pairs, one on each SP, on
the source and destination systems. Obtain the following information:
l For remote replication, the IP address and associated user authentication
credentials to connect to the remote system.
l For local replication, the password associated with your user account.
l The connection mode you want to use for the replication-Asynchronous,
Synchronous, or Both. File-based storage resources only support Asynchronous
connection mode.
Consider that you want to create an asynchronous replication connection to the
remote system with the IP address 10.1.1.1.
Procedure
l Run the following command:
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /remote/sys
create –addr 10.1.1.1 –srcUsername admin1 -srcPassword Password456!
–dstUsername admin2 –dstPassword Password986! -connectionType async

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

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
Name = MyTargetSystem
Address = 10.1.1.1
Model = Unity 300
Serial number = FCNCH01234567A90
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."

90 Unity Family 4.3 Configuring Replication

 Use case for CLI

Synchronous FC ports = spb_fc4, spa_fc4

Create a replication session for block storage

Before you begin
Complete the following:
l For remote replication:
n Identify the remote system that will act as the replication destination.
n Create relevant replication interfaces, replication connection, and a storage
resource on the remote system that will act as the destination.
l For local replication, create a storage resource that will act as the destination.
l Determine the replication synchronization mode you want. You can specify
asynchronous (async), synchronous (sync), or manual synchronization (manual).

Note

The synchronous replication mode is available only for block-based storage

resource.
l For asynchronous replication, determine the Recovery Point Objective (RPO) for
the replication session.
Procedure
l Run the following command to create a synchronous replication session between
the LUN "LUN_1" on the source system and the LUN "LUN_2" located on the
remote system "RS_2":
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /prot/rep/session
create -name REP1 -srcRes LUN_1 –dstType remote -dstSys RS_2 –
dstRes LUN_2 –syncType auto –rpo 0

Storage system address: 10.0.0.1

Storage system port: 443
HTTPS connection

ID =
81604378625_FCNCH097274B3A_0000_81604378627_FCNCH097274B37_0000
Operation completed successfully.

Create a replication session for file storage

Before you begin
Complete the following:
l For remote replication:
n Identify the remote system that will act as the replication destination.
n Create relevant replication interfaces, replication connection, and a storage
resource on the remote system that will act as the destination. The storage
resource on the destination system must have the same size
l For local replication, create a storage resource that will act as the destination.

Create a replication session for block storage 91

Use case for CLI

l For file replication, create a replication session on the NAS server associated with
the file storage.
l Determine the replication synchronization mode you want. You can specify
asynchronous (async), synchronous (sync), or manual synchronization (manual).

Note

The synchronous replication mode is available only for block-based storage

resource.
l For asynchronous replication, determine the Recovery Point Objective (RPO) for
the replication session.
Configure an asynchronous replication session between the NAS servers associated
with the file storage, with an RPO set to 2 hours 30 minutes and automatic
synchronization. On the source system, the file system "FS_1" is associated with NAS
server "NAS_1". And, the file system "FS_2" is associated with NAS server "NAS_2"
on the remote system.
Procedure
1. Run the following command to create an asynchronous replication session
between the NAS servers:
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /prot/rep/
session create -name REP2 -srcRes FS_1 –dstType remote -dstSys
RS_2 –dstRes FS_2

Storage system address: 10.0.0.1

Storage system port: 443
HTTPS connection

ID =
81604378635_FCNCH097274B3A_0000_81604378637_FCNCH097274B37_000
0
Operation completed successfully.

2. Run the following command to create an asynchronous replication session

between the file system "FS_1" on the source system and the file system
"FS_2" located on the remote system "RS_2", with an RPO set to 2 hours 30
minutes and automatic synchronization:
uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /prot/rep/
session create -name REP2 -srcRes FS_1 –dstType remote -dstSys
RS_2 –dstRes FS_2 –syncType auto –rpo 02h30m

Storage system address: 10.0.0.1

Storage system port: 443
HTTPS connection

ID =
81604378635_FCNCH097274B3A_0000_81604378637_FCNCH097274B37_000
0
Operation completed successfully.

92 Unity Family 4.3 Configuring Replication

 Use case for CLI

View replication sessions

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 =
81604378635_FCNCH097274B3A_0000_81604378637_FCNCH097274B37_0000
Name = REP2
Session type = nas server
Synchronization type = auto
Resource type = NAS Server
Destination type = remote

View replication sessions 93

Use case for CLI

94 Unity Family 4.3 Configuring Replication