cw-install

NAME

cw-install -- Tool to install the ClusterWareAI platform and perform initial basic configuration of a head node, and to update an existing head node installation.

Note

This command used to be scyld-install. The legacy scyld-* command is deprecated and will be removed in a future release.

USAGE

cw-install

[-h] [-v] [--config CONF_FILE] [--token TOKEN] [--dnf-repo REPO_FILE] [--yum-repo REPO_FILE] [-u | --update] [-l | --load DATABASE_FILE] [-s | --save DATABASE_FILE] [--without-files] [--iso PATH] [--os-iso PATH] [--clear] [--clear-all] [--no-tools] [--join HEAD_IP] [--skip-version-check] [--database-passwd PASSWD] [--non-interactive]

OPTIONAL ARGUMENTS

-h, --help

Print usage message and exit. Ignore trailing args, parse and ignore preceding args.

--config CONF_FILE

Specify a cluster configuration file to load and to initialize the DHCP server for private cluster network.

--token TOKEN

Specify a cluster serial number or other authentication to use in the Yum repository file.

--dnf-repo REPO_FILE

Provide a complete dnf repository file.

--yum-repo REPO_FILE

Provide a complete Yum repository file for the ClusterWareAI platform. Alias for --dnf-repo.

-u, --update

If the ClusterWareAI platform is already installed, then by default cw-install asks for a confirmation that the intention is to update software, not to perform a new install. This optional argument explicitly directs cw-install to update the ClusterWareAI installation.

DATABASE LOAD/SAVE OPTIONS

-l, --load DATABASE_FILE

Load the ClusterWareAI database with the specified DATABASE_FILE.

-s, --save DATABASE_FILE

Save the ClusterWareAI database to the specified DATABASE_FILE.

--without-files

Do NOT include the contents of images and boot files when loading or saving.

ADVANCED OPTIONS

--iso PATH

Install or update the ClusterWareAI platform using the named PATH, which is either the path of a ClusterWareAI ISO file or the URL of a remote ClusterWareAI ISO file.

--os-iso PATH

Create the DefaultImage and DefaultBoot using the named PATH, which is either the path of a base distribution ISO file or the URL of a remote base distribution ISO file.

--clear

THIS IS DEPRECATED - PLEASE USE --clear-all.

--clear-all

Clear the ClusterWareAI database, which DELETES ALL IMAGES AND BOOT CONFIGURATIONS! Remove all ClusterWareAI RPMs, except for clusterware-installer) and libcouchbase. Delete directories /opt/couchbase/, /opt/scyld/clusterware*/, and /var/log/clusterware/, and delete root's ~/.scyldcw/ and current admin's ~/.scyldcw/ (but not any other admin's ~/.scyldcw) for everything except logs, then optionally reinstall the ClusterWareAI platform.

--no-tools

Don't install the ClusterWareAI tools. The default is to install the tools.

--join EXISTING_HEAD_IP

Join this head node to the EXISTING_HEAD_IP IP address of an existing head node.

--skip-version-check

Use this installer and skip the online checking for a newer version.

--database-passwd PASSWD

Specify the database administrative password. Warning: influxdb2 requires a minimum of 8 characters.

--reconfigure

During an update, most steps that alter the head node OS will be skipped by default, but this option overrides and updates the base distribution.

--non-interactive

Execute the installer non-interactively, choosing default answers to the interactive questions in a way that most users would do. This is appropriate for using the installer in a script.

EXAMPLES

cw-install --clear

Clear the database, leaving it empty, and undo any existing ClusterWareAI installation.

cw-install --clear --config cluster-conf

Clear the database, leaving it empty, and undo any existing ClusterWareAI installation, then reset the database to the specified cluster-conf parameters.

RETURN VALUES

Upon successful completion, cw-install returns 0. On failure, an error message is printed to stderr and cw-install returns 1.