Administration Guides
Manage Eyeglass Jobs


The Jobs Feature is used to keep track of Eyeglass tasks.  Two Job views are provided :

  • Job Definitions: Use the Job Definition view to see details for and manage Eyeglass configuration replications Jobs.
  • Running Jobs: Use the Running Jobs view to see the statue of active tasks.

View Job Definition and Status

Job Definitions Window :

Job Name : It displays name as was defined during job creation.

This column displays a + symbol along with it which when expanded provides more details about the job such as :

Enabled/Disabled : The Job can be enabled or disabled from the Jobs window itself. When it is disabled, this field displays “USERDISABLED” State, If it is enabled, it displays “ENABLED” . For Auto Type Jobs, If the Policy is disabled from OneFS, it displays “POLICY DISABLED”.

Job Type : It display two Job types : “AUTO” and “MANUAL”.

  • Auto: For Jobs automatically detected by Eyeglass when a policy is created in OneFS and the Job is scheduled from there.
  • Manual: For Jobs that were manually created from the Jobs window.

Source : It displays PowerScale cluster name configured as Source for a replication Job.

Source Path:  The source path is used to provide a point in the file system for Eyeglass to autodetect shares, exports, and quotas, to discover and include in the job.  A job can be edited, using Edit Configuration(s) to remove a detected configuration that you don’t want included in the job.

Destination: It displays PowerScale cluster name configured as Destination for replication Job.

Last Success: This field displays date when the job was last successfully run. If the Job was never run successfully, this field is empty.

Last Run Date:  It displays the date when the job was last run regardless of its last state was failed or success.

State: It displays the current state of Job.

  • “OK” if the Last Run date and Last Success date matches.
  • “ERROR” if the Last Run date and Last Success date doesn’t match.
  • "SYNC IQ RUNNING" if the associated SyncIQ Job is in running state

Edit Configuration

To view the list of associated shares/exports/nfs alias/quotas for an Eyeglass Job, select Jobs.


To see the shares/exports/nfs alias associated with your Eyeglass configuration replication Job, select the checkbox for your Job and then select the Select a bulk action button.  The Edit Configuration(s) option will take you to the Jobs - Edit Configuration(s) View window where you can expand the tree to see which shares and exports and nfs alias are associated with your job.


To delete manually created jobs and the jobs that are not currently running.


Able to enable/disable all type of jobs except Eyeglass Failover:Runbook Robot (AUTOMATIC) (TYPE = RUNBOOK).

Note: If disabled no actions will be taken on the policy and it will not be eligible for failover.

Enable/Disable Skip Configuration

Set this mode to skip syncing any configuration data on this policy but allow the policy to be eligible for failover. This mode would be used when 2 different sets of hosts will be used at production and DR site for NFS exports and the client lists will be different.  This allows configuration to be managed manually on these policies.

Newly Detected SyncIQ policies Job Type Unconfigured 

New in 2.5.6 and later releases, this allows an Unconfigured Job type to be set to Auto, AutoDFS, or AutoSkipConfig and then enabled for production use. All new policies detected will appear as unconfigured and require administrator to take action to enter production use.

An alarm will be raised when a new syncIQ policy is detected indicating that an action is required to set the DR job type for this new policy.  This will generate an alarm every 5 minutes until the job type has been configured.   If the policy is not in production, then set the job type and then set to user disabled.

How to set job type for unconfigured jobs

  1. Login to Eyeglass
  2. Open the Jobs icon
  3. Select the unconfigured policy
  4. Select bulk actions menu Set Type
  5. Set the type
  6. NOTE: Once the job type is set, it will not be possible to set back to unconfigured status.

Enable/Disable Microsoft DFS

To enable/disable DFS mode for Configuration Replication: Share, Export, Alias replication type of jobs. Please refer to Microsoft DFS Mode Failover Guide.

Run Now Action next to Job Name

New in 2.5.6 and later releases a run now icon next to jobs that are in a runnable state. This simplifies running configuration jobs or failover readiness jobs.

Run Now Menu Item Bulk Actions

Able to run Eyeglass Configuration Replication Jobs on demand.

  1. Open the Jobs window.
  2. Select an Eyeglass Configuration Replication Job.
  3. Select a Job.
  4. Select a bulk action.

  1. Elect Run Now.  This will initiate the Eyeglass Configuration Replication task which will run all Eyeglass Configuration Replication Jobs.

  1. You can check the progress of the Configuration Replication Job in the Running Jobs view of the Jobs window.

Running Jobs

This category displays the currently Running Jobs and its details such as :

Job Name : displays the name of Job

State : displays the state of Job : Finished or Running

Started : displays time when it was Started

Finished : displays time when it was Finished.

To view a Job in progress select Running Jobs from the Jobs window.  In the bottom Job Details pane you will see the steps associated with the Job and the status for each step.


Performance Acceleration for Configuration Jobs

  1. Requirements
    1. 2.5.9 or later
  2. Configuration sync Audit job disable option to increase performance of config jobs. This is good for customers with large numbers of SMB, NFS configurations to speed up the job processing time. The audit feature does not need to run on each job and could be enabled ​
    1. login to eyeglass 
    2. sudo -s 
    3. nano /opt/superna/sca/data/system.xml
      1. Under the <process> tag add this new tag
      2. <audit>false</audit>
      3. control+x
      4. systemctl restart sca
      5. done.

Troubleshooting Eyeglass Job

When a problem occurs, for a Job in progress the Running Jobs view will indicate at which step a problem occurred with a link to the information available for the error.

For a completed Job, the Eyeglass system alarm related to the failed Job may contain the extra information you need to troubleshoot the problem

What are the Eyeglass System Alarms?

Refer to Eyeglass PowerScale Alarm codes for the list of system alarms.

Renaming SyncIQ Policy & Eyeglass Jobs

When a SyncIQ Policy is renamed, Eyeglass considers it to be a new SyncIQ Policy and therefore the following happens:

  1. Eyeglass Job(s) related to the original SyncIQ Policy Name are deleted.
  2. Eyeglass Job(s) for the new SyncIQ Policy Name are created but will be set to Unconfigured state (2.5.6 or later release) and will need to be set to auto or autodfs and enabled.

As a new Job, the Eyeglass Configuration Replication Jobs will have a state depending on the Eyeglass appliance default “Initialstate” configuration (see section igls adv initialstate in this Admin Guide).  By default the Jobs will be disabled.  Any other customizations to the Job such as DFS Mode must also be re-applied.  For a SyncIQ Job that has been renamed, follow these steps in Eyeglass:

  1. Login to the Eyeglass web page.
  2. Open the Jobs window.
  3. For any Jobs that were in DFS Mode previously, re-set to DFS Mode.
  4. For any Jobs where sync of a share or export, and had been customized to be skipped, from the Jobs page, use Edit Configuration to deselect those objects from the Job.

In addition to the Job setup, RPO Reporting for the original SyncIQ Policy name will not be linked to RPO reporting for the new SyncIQ Policy name.

© Superna Inc