Skip to main content

Illumio Core 24.5 Administration Guide

Cluster Nodes and Command-Line Operations

The PCE control interface commands are restricted to the type of node they can be executed on. For example, the command to set a cluster's runlevel can be run on any core or data node. Database-specific commands must only be run on specific data nodes. The following tables list the command-line operations you can perform and the specific nodes the commands must be run on.

PCE Control Commands

The following table shows commands you can use to control various aspects of PCE behavior. Some of the commands affect a single node and others affect the entire PCE cluster. The commands have the following general syntax:

sudo -u ilo-pce illumio-pce-ctl sub-command --option

Sub-Command

Description

Run on Node

Single-node commands

start

start --runlevel n

Start PCE software on a single node.

Start PCE software at a specified runlevel on a single node.

Any

stop

Stop PCE software on a single node.

Any

restart

Restart the PCE software on a single node.

Any

status

Show status of the PCE software on a single node.

Any

check-env

Check the runtime_env.yml file on a single node.

Any

service-discovery-status

Get status of service-discovery services on a single node.

Any

check-consul-status

Get status of the consul service on a single node.

Any

Cluster-wide commands

set-runlevel

Set the software runlevel for the PCE software on all nodes.

Any

get-runlevel

Get the runlevel of the PCE software on all nodes.

Any

cluster-status

Get the status of the PCE software across the cluster.

Any

cluster-stop

Shut down the cluster.

An

cluster-restart

Restart the cluster.

Any

cluster-leave

Force the current node or the node defined by the IP address to be removed from the cluster.

Any

cluster-members

Show all cluster members.

Any

Database Commands

The following table shows commands you can use to control various aspects of PCE database behavior. The commands have the following general syntax:

sudo -u ilo-pce illumio-pce-db-management sub-command --option

Sub-Command

Description

Run on Node

setup

Begin initial setup of the PCE database.

Any

migrate

Migrate the database to the latest schema.

Any

dump

Dump the database to a file.

Data node where agent_traffic_redis_server service is running.

restore

Restore the database from a file.

Any data node

create-domain

Create the first organization and user in the system.

Any data node

show-master

Show which node is the primary database.

Any

show-replication-info

Show replication lag between the replica and primary databases.

Any