Check Node and Cluster Status
This section describes several ways you can check the status of PCE nodes and clusters.
Check Node Environment
Run this command to examine the main PCE configuration file runtime_env.yml and validate it for syntax and basic structure:
sudo -u ilo-pce illumio-pce-env check
Check PCE Node Status
Run this command to display the status of the PCE node:
sudo -u ilo-pce illumio-pce-ctl status
Node Status Codes:
0 - Stopped
1 - All required processes running
2 - Partial, not all required processes running
For example, when you run the following status command (with semicolon) and echo $?, you receive the following output:
sudo -u ilo-pce illumio-pce-ctl status; echo $? Checking Illumio Runtime RUNNING 0.29s 1
To see the PCE node status with standard Linux statuses, you have two options:
Run the status command with the --stdexit option to see the following node status:
0 - Running
1 - Running at runlevel 1
2 - Error
3 - Stopped
For example:
sudo -u ilo-pce illumio-pce-ctl status --stdexit
Run the PCE service script, which calls the illumio-pce-ctl command and provides standard Linux status codes.
For example:
$ service illumio-pce status
Note
Running the service script to retrieve status automatically returns the --stdexit status values. However, running the service illumio-pce ctl status command does not insert the --stdexit option.
Check Services on a PCE Node
Run the following command and the -v (verbose) option to display the status of individual services on a PCE node:
sudo -u ilo-pce illumio-pce-ctl status -v
Example output:
sudo -u ilo-pce illumio-pce-ctl status -v Checking Illumio Runtime csaefh iimntttttt RUNNING 0.75s
The colored string represents the status of the PCE services as described by the following table. Use the characters to determine whether services are in the steady state.
For more information about the services, enter status -s.
Character | Service |
|---|---|
a | Agent background worker |
c | PCE web console |
e | Event service |
f | Fluentd |
h | HAproxy |
i |
|
m | memcached |
n | nginx |
s | Console discovery |
t | Various “thin” services |
Check PCE Cluster Status
Run this command to display the PCE cluster status:
sudo -u ilo-pce illumio-pce-ctl cluster-status
For example:
sudo -u ilo-pc illumio-pce-ctl cluster-status Reading /var/illumio-pce-data/runtime_env.yml. SERVICES (runlevel: 5) NODES (Reachable: 4 of 4) ====================== =========================== agent_service 10.6.31.18 10.6.31.17 agent_traffic_redis_cache 10.6.31.20 10.6.31.19 agent_traffic_redis_server 10.6.31.20 agent_traffic_service 10.6.31.18 10.6.31.17 auditable_events_service 10.6.31.18 10.6.31.17 collector_service 10.6.31.18 10.6.31.18 10.6.31.17 10.6.31.17 database_service 10.6.31.20 database_slave_service 10.6.31.19 ev_service 10.6.31.18 10.6.31.17 executor_service 10.6.31.18 10.6.31.17 fileserver_service 10.6.31.20 fluentd_source_service 10.6.31.17 10.6.31.18 login_service 10.6.31.18 10.6.31.17 memcached 10.6.31.17 10.6.31.18 node_monitor 10.6.31.18 10.6.31.18 10.6.31.17 10.6.31.17 pg_listener_service 10.6.31.20 search_index_service 10.6.31.17 10.6.31.18 server_load_balancer 10.6.31.17 10.6.31.18 service_discovery_agent 10.6.31.31 service_discovery_server 10.6.31.19 10.6.31.20 10.6.31.32 set_server_redis_server 10.6.31.19 Cluster status: RUNNING
Check PCE Version
Run this command to display the version of the installed PCE software:
sudo -u ilo-pce illumio-pce-ctl version
Check PCE Cluster Members
Run this command to display the members of the PCE cluster:
sudo -u ilo-pce illumio-pce-ctl cluster-members