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

Appliance Check

Introduction​

Periodically checking the health of the Eyeglass appliance itself helps confirm that DR-related automation (configuration replication, readiness validation, Runbook Robot, and failover) continues to run reliably. This section covers the built-in tools available to verify appliance health and to collect diagnostic information.

Check Overall Appliance Health​

Run the following command over SSH to the Eyeglass appliance to display the overall health status:

igls admin health

Example output:

{
  "success": true
}

Check Appliance and Component Versions​

To display the Eyeglass component versions (UI, REST, and SCA services):

igls admin version

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. To display it over SSH instead:

igls admin appid

Check Manage Services​

  1. Log in to the Eyeglass Web UI.
  2. Open Health Check → Manage Services.
  3. Confirm that all containers/services listed under the Health section are shown as GREEN and OK.
  4. If any service shows an error or warning state, open Health Check → Manage Services to review the affected component before opening a support case.

Check Disk Space Usage​

Eyeglass monitors disk space used by support and restore backups and raises an alarm when a configured threshold is exceeded.

  • Default alarm threshold: 800 MB.

  • To increase the threshold, edit the configuration file:

    /opt/superna/sca/conf/DiskSpaceMonitorConfig.xml

  • After editing the file, reload the new threshold with:

    igls adv reloaddiskspacemonitorrules
tip

If you receive a disk space alarm, old backup files can be removed from /srv/www/htdocs/archive.

Generate a Diagnostic Report​

The igls appliance report command is a diagnostic log-parsing tool intended for dark or secure sites where on-site log analysis is required before contacting support. The report summarizes API errors, SSH errors, configuration sync analysis, and failover analysis (including each attempt and its success or failure).

  1. Run the command:

    igls appliance report

  2. Wait for the report to complete.

  3. View the report at:

    https://<eyeglass IP address>/report/
note

If a support case requires restoring appliance data or configuration, see Backup and Restore.

See Also​

Cluster Check

Verify that a managed PowerScale cluster remains reachable and free of configuration replication or readiness errors.

See More

Backup and Restore

Create a restore backup and apply it to a clean appliance to carry over configuration, cluster connections, and failover setup.

See More