Help on Data Protection > SyncIQ > Policies

The following information and controls appear on Data Protection > SyncIQ > Policies.

SyncIQ Policies
This table lists SyncIQ policies.
Select a bulk action
This menu lists actions that can be applied to all policies simultaneously. If you select an action, that action will be applied to each policy whose check box has been selected.
Delete Selection
Deletes all selected policies.
Enable Selection
Enables all selected policies.
Disable Selection
Disable all selected policies.
Policy Name
Displays the name of a policy.
State
Displays whether the policy is enabled or disabled.
Last Known Good
Displays when the last successful job created according to the policy ran.
Schedule
Displays when the next job is scheduled to run. A value of Manual indicates that the job can be run only manually. A value of When source is modified indicates that the job will be run whenever changes are made to the source directory.
Source Directory
Displays the path of the source directory on the source cluster that the policy replicates data from.
Target Host : Directory
Displays the IP address or fully qualified domain name of the target cluster and the full path of the target directory that data is replicated to.
Action
Displays actions that can be performed for an individual policy.
View/Edit
Opens a dialog box that allows you to view and edit policy settings.
Edit Policy
Edits policy settings.
Close
Closes the dialog box.
More
Displays additional actions that can be performed for an individual policy.
Disable Policy
Disables the policy.
Start Job
Runs a replication job for the policy.
Assess Sync
Runs an assessment job for the policy.
Resync-prep
Runs a resync-prep job for the policy.
Resolve
If SyncIQ disables a replication policy due to a replication error, and you fix the issue that caused the error, you can resolve the replication policy. Resolving a replication policy enables you to run the policy again. If you cannot resolve the issue that caused the error, you can reset the replication policy.
Reset Sync State
Resets the policy.

If a replication job encounters an error that you cannot resolve, you can reset the corresponding replication policy. Resetting a policy causes OneFS to perform a full or differential replication the next time the policy is run. Resetting a replication policy deletes the latest snapshot generated for the policy on the source cluster.

Delete Policy
Deletes the policy.
Create a SyncIQ Policy
Opens a dialog box that allows you to create a policy.
Policy Name
Specifies the name of the policy.
Description
Describes the policy. For example, the description might explain the purpose or function of the policy.
Enable this policy
Determines whether the policy is enabled.
Action
Determines the how the policy replicates data. All policies copy files from the source directory to the target directory and update files in the target directory to match files on the source directory. The action determines how deleting a file on the source directory affects the target.
Copy
Configures the policy so that if you delete a file in the source directory, the policy will not delete that file from the target directory when the policy is run.
Synchronize
Configures the policy so that if you delete a file in the source directory, the policy will delete that file from the target directory when the policy is run. This ensures that an exact replica of the source directory is maintained on the target cluster.
Run Job
Determines when the policy will run jobs.
Only manually
Configures the policy to run jobs only when manually specified by a user.
On a schedule
Configures the policy to run jobs automatically according to a schedule.
Daily
Specifies schedule in terms of days.
Run policy every <integer> <day>
Runs jobs only after the specified number of days have passed. For example, if you scheduled jobs to run every two days, the policy would run jobs every other day.
Weekly
Specifies schedule in terms of weeks.
Run policy every <integer> week(s)
Runs jobs only after the specified number of weeks have passed. For example, if you scheduled jobs to run every two weeks, the policy would run jobs every other week.
Monday
Runs the policy on Mondays of the given weeks.
Tuesday
Runs the policy on Tuesdays of the given weeks.
Wednesday
Runs the policy on Wednesdays of the given weeks.
Thursday
Runs the policy on Thursdays of the given weeks.
Friday
Runs the policy on Fridays of the given weeks.
Saturday
Runs the policy on Saturdays of the given weeks.
Sunday
Runs the policy on Sundays of the given weeks.
Monthly
Specifies schedule in terms of months.
Run policy every <integer> month(s)
Runs jobs only after the specified number of months have passed. For example, if you scheduled jobs to run every two months, the policy would run jobs every other month.
Select policy day by
Determines whether you can specify which days the policy is run by a day of the week or a specific date.
Run policy on the <variable> <weekday>
Runs the policy only on the specified day of the week.
Run policy on the <variable> {Day | Weekday}
Runs the policy only on the specified day of the month. For example, you can configure a policy to run on the first day of each month or on the third weekday of each month.
Yearly
Specifies schedule in terms of years.
Run policy every <month>
Runs the policy only on a day in the specified month.
Select policy day by
Determines whether you can specify which days the policy is run by a day of the week or a specific date.
Run policy on the <variable> <weekday> of <month>
Runs the policy only on the specified day of the month.
Run one policy per specified day
Runs the policy once on each specified day.
Run policy at
Runs the job at the specified time.
Run multiple policies per specified day
Runs a job multiple times on the specified days.
Run policy every <integer> <time>
Runs a job after the specified amount of time has passed.
Beginning at
Specifies the first time to run a job on a given specified day.
Ending at
Prevents jobs from being run after the specified time on a given day.
Only run if source directory contents are modified
Causes the policy not to be run if the contents of the source directory have not been modified since the last time the policy has been run.
Do no send RPO alerts
Does not create OneFS events if a specified Recovery Point Objective (RPO) is exceeded.
Send RPO alerts after...
Creates a OneFS event if the specified RPO is exceeded. For example, assume you set an RPO of 5 hours; a job starts at 1:00 PM and completes at 3:00 PM; a second job starts at 3:30 PM; if the second job does not complete by 6:00 PM, SyncIQ will create a OneFS event. The events have an event ID of 400040020.
Note Image

This option is valid only if RPO alerts have been globally enabled through SyncIQ settings.

Whenever the source is modified
Causes a job to be run every time that the source directory is modified.
Change-Triggered Sync Job Delay
Specifies the amount of time after the source directory is modified that SyncIQ waits before starting a replication job.
Whenever a snapshot of the source directory is taken
Causes a job to be run every time that a snapshot is taken of the source directory.
Run job if snapshot name matches the following pattern
Specifies the naming pattern for snapshots to be synced. If a snapshot is taken of the source directory, and the snapshot name matches the specified naming pattern, SyncIQ will replicate the snapshot to the target cluster.

The default value is "*", which causes all snapshots of the source directory to be replicated.

Sync existing snapshots before policy creation time
Determines whether the policy replicates snapshots taken before the policy was created. If selected, SyncIQ will replicate all existing snapshots of the source directory that match the naming pattern.
Source Root Directory
The full path of the source directory. Data is replicated from the source directory to the target directory.
Included Directories
Determines which directories are included in replication. If one or more directories are specified by this setting, any directories that are not specified are not replicated.
Excluded Directories
Determines which directories are excluded from replication. Any directories specified by this setting are not replicated.
File Matching Criteria
Determines which files are excluded from replication. Any files that do not meet the specified criteria are not replicated.
IF Condition
Lists a group of conditions that are evaluated together. If a file meets all of the conditions in the group, the file is replicated to the target cluster.
Select Filter Type
Specifies what type of value you want to filter files by.
Select Operator
Specifies whether the Filter Type must match or must not match.
Enter Value
Specifies the value to filter.
Select Type
Filters either files or directories.
Enter Date
Specifies a date to filter by.
Delete this block
Removes the condition from the group of conditions.
Add an "And" condition
Adds a condition to the group of conditions.
Add an "Or" condition
Adds an additional group of conditions that can be met as an alternative to the previously specified group of conditions. If a file meets all of the conditions in a group, the file is replicated to the target cluster.
OR Condition
Lists a group of conditions that are evaluated together. If a file meets all of the conditions in the group, the file is replicated to the target cluster.
Restrict Source Nodes
Determines whether the policy can run on all nodes on the source cluster or run only on specific nodes.
Run the policy on all nodes in this cluster
Runs the policy on all nodes in the cluster.
Run the policy only on nodes in the specified subnet and pool
Runs policies on the nodes in the specified subnet and pool.
Subnet and Pool
Runs the policy only on the specified subnet and pool.
Target Host
The IP address or fully qualified domain name of the target cluster.
Target Directory
The full path of the target directory. Data is replicated to the target directory from the source directory.
Connect only to the nodes within the target cluster SmartConnect Zone
If the Target Host is specified as a SmartConnect Zone, connects the policy only to nodes within that SmartConnect Zone.
Capture snapshots on the target cluster
Determines whether archival snapshots are generated on the target cluster.
Snapshot Alias Name
Specifies an alias for the latest archival snapshot taken on the target cluster.
Snapshot Naming Pattern
Specifies how archival snapshots are named on the target cluster.
Snapshots do not expire
Causes snapshots created by the policy on the target cluster to be retained indefinitely.
Snapshots expire after...
Specifies how long archival snapshots are retained on the target cluster before they are automatically deleted by the system.
Log Level
Specifies the amount of information that is recorded for replication jobs. More verbose options include all information from less verbose options. The following list describes the log levels from least to most verbose:
  • Fatal
  • Error
  • Notice
  • Info
  • Copy
  • Debug
  • Trace

Replication logs are typically used for debugging purposes. If necessary, you can log in to a node through the command-line interface and view the contents of the /var/log/isi_migrate.log file on the node.

Note Image

Notice is the recommended log level.

Priority
Determines the priority level of a policy. If jobs are queued to be run because the maximum number of jobs are already running, policies with higher priority will be run before jobs with lower priorities. For example, assume that five jobs are currently running. A job with a priority of 0 is the created and queued to run; next, a job with a priority of 1 is created an queued to run. The job with a priority of 1 will be run next, even though the job with a lower priority has been queued for a longer period of time.
Validate File Integrity
Determines whether OneFS performs a checksum on each file data packet that is affected by a replication job. If a checksum value does not match, OneFS retransmits the affected file data packet.
Prepare policy for accelerated failback performance
Causes SyncIQ to perform failback configuration tasks the next time that a job is run, rather than waiting to perform those tasks during the failback process. Performing these tasks ahead of time will increase the speed of failback operations.
Keep Reports For
Specifies how long replication reports are kept before they are automatically deleted by OneFS.
Do not record when a synchronization deletes files or directories
Does not record when a replication job deletes files or directories on the target cluster.
Record when a synchronization deletes files or directories
Records when a replication job deletes files or directories on the target cluster.
Deep Copy for CloudPools
Determines how the policy replicates CloudPools smartlinks. If set to Deny, SyncIQ replicates all CloudPools smartlinks to the target cluster as smartlinks; if the target cluster does not support the smartlinks, the job will fail. If set to Force, SyncIQ replicates all smartlinks to the target cluster as regular files. If set to Allow, SyncIQ will attempt to replicate smartlinks to the target cluster as smartlinks; if the target cluster does not support the smartlinks, SyncIQ will replicate the smartlinks as regular files.
Create Policy
Creates a policy according to the specified settings.
Cancel
Cancels policy creation.