Monitoring and Troubleshooting Grids

June 14, 2016

Public Health England

London, England

Jason M. Coposky


Interim Executive Director

The Zone vs. The Grid

Zone Introspection - izonereport

Configuration management for iRODS -
    An iCommand which executes a new API call across all servers within a Zone

  • maintain snapshots of Zone state over time
  • a remote debugging tool
  • allow for validation of Zone integrity
  • can be used to dynamically deploy a Zone in cloud infrastructure

A Zone Report

Creates validated JSON document which includes:

  • iRODS version information
  • Host system information
  • Sanitized JSON configuration files
  • Configuration files from /etc/irods - base64 encoded
  • Listing of installed plugins


Schemas can be found at

Using izonereport

Run only as a 'rodsadmin' user with output to stdout:

izonereport > report.txt

Investigate with 'less' or your favorite editor


Note: Review JSON configuration

The iRODS Control Plane

A control channel which speaks directly to the iRODS Server -- allows for grid-wide operations

  • graceful shutdown                                                              
  • pause & resume
  • grid status information


Accessed via a separate client command: irods-grid


Check out the March 2015 iRODS Development Update:

The irods-grid command

irods-grid --help

usage: 'irods-grid action [option] target'

action: ( required ) status, pause, resume, shutdown

option: --force-after=seconds or --wait-forever

target: ( required ) --all, or --hosts=", , ..."

irods-grid status

irods-grid status --all

Returns a status of the server (or servers) requested in a validated json document which includes:

  • Agent PIDs and their age
  • XMessage server PID
  • Rule Engine server PID
  • iRODS Server PID
  • Hostname of the server
  • Server status

irods-grid pause and resume

irods-grid pause --all

Pause - suspend all incoming connections while allowing existing connections to complete

Resume - allow incoming connections from new clients

irods-grid resume --all

irods-grid shutdown

irods-grid shutdown --all

Option --force-after=seconds -
    kill any existing connections after N seconds
Option --wait-forever -
    do not kill existing connections, allowing them to finish

irods-grid shutdown --force-after=5 --all
irods-grid shutdown --wait-forever --all

Gracefully shutdown an iRODS server or servers  allowing existing client connections to complete


Please Note:

Public Health England - Monitoring and Troubleshooting

By jason coposky

Public Health England - Monitoring and Troubleshooting

  • 1,469
Loading comments...

More from jason coposky