Skip to main content
Migration Notice
We're migrating documentation from the old portal into this one. Some things may look a little different or out of place in the meantime — we know, and we're working to get it right. If something's unclear or doesn't look right, let us know.
Version: 2.15.0

CLI Guide for Disaster Recovery for Dell

Introduction​

alt text

This page consolidates the igls CLI commands referenced across the Disaster Recovery documentation into a single reference, organized by task. Each command links back to the full procedure on its source page — use this page to find the right command quickly, and the linked page for the complete context and prerequisites around it.

Appliance Health and Diagnostics​

igls admin health

Displays the overall health status of the Eyeglass appliance. See Appliance Check.

igls admin version

Displays Eyeglass component versions (UI, REST, and SCA services).

The appliance ID is also displayed directly in the 2.15.0 GUI, in Inventory → License Management, with a Copy Appliance ID button next to it.

igls admin appid

Displays the appliance ID over SSH, as an alternative to the GUI.

igls appliance report

Diagnostic log-parsing tool for dark or secure sites where on-site log analysis is required before contacting support — summarizes API errors, SSH errors, configuration sync analysis, and failover analysis. See Appliance Check — Generate a Diagnostic Report.

igls adv reloaddiskspacemonitorrules

Reloads the support-backup disk monitor alarm threshold after editing its configuration file. See Appliance Check.

Backup and Restore​

igls app restore /full_path_to_your_file.extension/

Restores an Eyeglass appliance from a backup archive. See Backup and Restore.

igls app restore /srv/www/htdocs/archive

Accepts a directory path instead of a specific file — scans all backup files present, identifies the most recent one, and prompts for confirmation before proceeding. See Advanced Restore and Rediscover Operations.

igls app pull-config

Migrates configuration to a new appliance, referenced as part of pre-upgrade backup best practice. See Upgrade Guide.

igls appliance rediscover

Rebuilds the Eyeglass database without requiring a backup archive. Use only when directed by Superna Support. See Advanced Restore and Rediscover Operations.

Configuration Replication​

igls admin schedules set --id Replication --enabled false
igls admin schedules set --id Replication --enabled true

Disables and re-enables the Configuration Replication job — for example, as a workaround around failover for the SMB Data Integrity deny-permission corner case. See Technical Advisories and Configuration Replication.

igls admin ignoreunresolvablehosts

Used when a client-list hostname on an export cannot be resolved or removed. See Configuration Replication.

Failover Configuration​

igls adv failovermode set --parallel=true
igls adv failovermode set --parallel=false

Enables or disables multi-threaded, parallel step execution across all failover jobs. See Parallel Failover Configuration.

igls adv failovertimeout

Displays or sets the per-step failover task timeout. See Considerations Before Using DR Rehearsal Mode.

igls adv runbookrobot set --createExport=false

Disables automatic export creation/update by Runbook Robot — use only when directed by Superna Support. See Runbook Robot — Advanced Settings.

SPN Failover Delay​

Adjusts the delay between the delete and create steps of an SPN failover, to give a domain controller time to replicate the delete before the create is attempted.

igls adv spndelay

Displays the current setting.

igls adv spndelay set --seconds=<seconds>

Sets the delay, in seconds, between the delete and create SPN operations during failover — for example, igls adv spndelay set --seconds=10.

note

This command exists for environments where domain controller replication is slow enough to cause SPN failover issues. Later Eyeglass releases pin SPN failover commands to a single node and domain controller, which removes the need to tune this delay in most environments.

Readiness and Validation​

igls admin schedules set --id SyncMonitorTask --enabled true
igls admin schedules

Enables the SyncIQ Monitor Task and displays current schedule status. See Failover Validations Reference.

igls admin schedules set --id Readiness --enabled true

Enables the Zone Readiness task (disabled by default) — required for Runbook Robot. The same igls admin schedules set pattern (substituting the job ID) changes the schedule of any job. See Runbook Robot — Advanced DR Configuration.

igls adv readinessvalidation set --dualdelegation=false
igls adv readinessvalidation set --spnsdelegation=false

Disables DNS delegation validation and SPN test validation, respectively, during readiness checks. See Failover Validations Reference.

Two-Factor Authentication​

igls auth 2fa --command status

Displays the current 2FA configuration.

igls auth 2fa --command enable
igls auth 2fa --command disable

Enables or disables 2FA globally across the system.

igls auth 2fa --command enforce
igls auth 2fa --command no-enforce

Requires or relaxes 2FA enrollment for all eligible users.

igls auth 2fa --command enroll --user <username> --mail <userEmail>

Enrolls a user for 2FA from the command line.

See Two-Factor Authentication for the full enrollment workflow, login flow, audit logging, and troubleshooting.

Storage Tier and Quota Management​

Storage Tier and Quota Template Commands​

These commands manage the tier and template objects used by Advanced Quota Replication to group and apply quota templates by tier:

igls csm tier help

Lists tiers that group quota templates together (list is the default action). add --id=<value> creates a new tier; delete --id=<value> removes one.

igls csm template help

Templates define a quota (hard, soft, or accounting) and an AD group, and are assigned to a tier — the tier must exist before a template can be assigned to it. list [--tier=<value>] [--name=<value>] lists templates and their tier; add creates a new quota template with flags for --tier, --name, --hard/--hardunit, --soft/--softunit, and --softgrace/--softgraceunit.

See Also​