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

mark a cluster as active/inactive, for maintenance or during incidents

./axual.sh cluster set active false

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>]

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

cluster

Use ./axual.sh cluster to get or set a cluster status.

Usage:

./axual.sh cluster [set|get] [active] [true|false]