Axual Deploy reference

Introduction

Usage: ./axual.sh [OPTIONS] COMMAND [ARG…​]

Options

Option

Description

Example

-v

Verbose. Log all underlying docker commands and shell functions

./axual.sh -v start

Commands

Command

Description

Example

start

start all cluster and instance level components that should be running on this node.

./axual.sh start

stop

stop all cluster and instance level components which are running on this machine.

./axual.sh stop

restart

restart all cluster and instance level components which are running on this machine.

./axual.sh restart

clean

clean data, containers or images used in an Axual Platform deployment

./axual.sh clean all

cluster

send the change status command to all instances of the cluster, and getting current status of all instances of the current cluster

./axual.sh cluster [set/get] [status] [metadata/data/offset/app] [on/off]

instance

send the change status command to specified instance of the cluster, and getting current status of specified instance of the current cluster

./axual.sh instance <instance-name> [set/get] [status] [metadata/data/offset/app] [on/off]

status

NON-FUNCTIONAL

N/A

check

NON-FUNCTIONAL

N/A

pull

NON-FUNCTIONAL

N/A

file

Essentially the same as docker cp

N/A

start, restart and stop

Use ./axual.sh [start|restart|stop] to start, restart or stop (a selection of) instance or cluster level components. This is always relative to the node this command is ran on.

Usage:

./axual.sh [start|restart|stop] [instance|cluster] [<instance-or-cluster-name> <servicename>]

cluster

Use ./axual.sh cluster to get or set status of all the instances in the cluster.

Usage:

./axual.sh cluster [set|get] [status] [metadata|data|offset|app] [on|off]

instance

Use ./axual.sh instance <instance-name> to get or set a specified instance status.

Usage:

./axual.sh instance <instance-name> [set|get] [status] [metadata|data|offset|app] [on|off]

Instance Status of the Cluster

  1. INACTIVE: Not participating actively in the instance.

  2. READY_FOR_METADATA: Cluster is active and ready to apply topics if necessary.

  3. READY_FOR_DATA: All metadata on the cluster is up to date and the cluster is ready to receive data from other clusters through Distributor.

  4. READY_FOR_OFFSETS: Cluster is now ready to receive any unsynchronized consumer offsets.

  5. READY_FOR_APPLICATIONS: The cluster is fully synched with other clusters in the same instance and is ready to serve client applications.

InstanceStateTransitions

To activate, set status in following flow: metadata → data → offset → app.

To deactivate, set status in following flow: app → offset → data → metadata

Examples

when referring to an instance, always use the full instance name, including <tenant>, e.g. for tenant company, instance ota, the full instance name would be company-ota

./axual.sh start instance

Start instance level components of all instances

./axual.sh stop instance company-ota

Start all instance level components of tenant company, instance ota

./axual.sh restart instance company-ota discovery-api

Start discovery-api, an instance level component of instance company-ota

./axual.sh start cluster

Start cluster level components that are designated to run on this node (see nodes.sh)

./axual.sh restart cluster broker

Restart cluster level component broker

./axual.sh stop cluster cluster-api

Stop cluster level component cluster-api

./axual.sh instance company-ota get status

Get the current status of company-ota instance