helios_service_status - check the status of services running in a Helios collective
helios_service_status [--service=<service name>] [--hostname=<hostname>] [--epoch-time] # list status of all service instances running on current host helios_service_status # list status of all service instances running on host wrkhost1 helios_service_status --hostname=wrkhost1 # list status of all service instances running on all hosts in the collective helios_service_status --hostname=* # list status of all instances of MyService # -H is shortcut for --hostname helios_service_status --service=MyService -H=* # list information on the MyService instance running on wrkhost1 # report the start and last check in times in epoch seconds helios_service_status -s MyService -H wrkhost1 --epoch-time
The helios_service_status command reports status information on services running in a Helios collective. You can use this command for general administration purposes or to build monitoring scripts for services.
The helios_service_status command currently reports 6 key pieces of information:
name of the service.
the version of the service, if one is set.
the hostname of the host on which the service is running.
The process id of the service daemon.
the start time of the service daemon.
the last time the service daemon "checked in" to the collective. How often this happens is controlled by the "registration_interval" configuration parameter. The default is 60 sec, which should be fine for most purposes.
This command basically reports the same type of information as the Helios::Panoptes Collective Admin view, but having it available at the command line adds convenience and enhances the Helios system's scriptability.
Andrew Johnson, <lajandy at cpan dot org>
Copyright (C) 2013-4 by Logical Helion, LLC.
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.0 or, at your option, any later version of Perl 5 you may have available.
This software comes with no warranty of any kind.
To install Helios, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Helios
CPAN shell
perl -MCPAN -e shell install Helios
For more information on module installation, please visit the detailed CPAN module installation guide.