Replication

Replication facilitates replication of projects and shares between Oracle ZFS Storage Appliance systems.

Note:

Replication is a licensed feature for certain models of Oracle ZFS Storage Appliance, and the replication RESTful API manages that feature. The service is available from the following URI: https://hostname:215/api/storage/v{1|2}/replication. For license details, refer to the Oracle Software License Agreement (SLA) and Entitlement for Hardware Systems with Integrated Software Options, and the Licensing Information User Manual for the software release.

The Replication RESTful API manages the following resources:

• Replication Service – The service that manages replication tasks.

• Replication Target – An Oracle ZFS Storage Appliance peer that receives and stores data replicated from another appliance peer (the source). This term also refers to a configuration object on the Oracle ZFS Storage Appliance system that enables it to replicate to another appliance.

• Replication Action – A configuration object on a source Oracle ZFS Storage Appliance system specifying a project or share, a target appliance, and policy options (including how often to send updates, whether to encrypt data on the wire, and so on).

• Replication Package – The target-side analog of an action; the configuration object on the target Oracle ZFS Storage Appliance that manages the data replicated as part of a particular action from a particular source. Each action on a source appliance is associated with exactly one package on a target appliance and vice versa. Loss of either object requires creating a new action/package pair (and a full replication update).

The API supplies replication operations for replication actions and replication packages. The service API is used to manage the replication service and replication sources and targets.

Table 13-14 Replication Service Commands

Request	Append to Path /api/service/v{1|2}/services	Description
GET	/replication	Get replication service state properties
PUT	/replication/enable	Enable the replication service
PUT	/replication/disable	Disable the replication service

List Replication Service Properties

Gets the state of the replication service.

Example Request:

GET /api/service/v2/services/replication HTTP/1.1
Host: zfs-storage.example.com:215
Accept: application/json

Example Result:

HTTP/1.1 200 OK

{
    "service": {
        "href": "/api/service/v2/services/replication",
        "<status>": "online",
        "enable_start_finish_alerts": true
    }
}

Modify Replication Service Properties

The replication service state can be modified like any other service. See the Service RESTful API for more information.

Depending on the number of projects that are replicating and the frequency of the replication schedule, the number of start and finish alerts for scheduled updates can obscure other important alerts. To disable start and finish alerts for scheduled updates, set the enable_start_finish_alerts property to false:

PUT /api/service/v2/services/replication
Host: zfs-storage.example.com:215
Content-Type: application/json

{ 
    "enable_start_finish_alerts":false 
}