Installer Stanza Commands
This topic provides the syntax and options for Installer Stanza commands.
Command Usage
To use Installer Stanza commands, you must log in as the
cluster administrator user that you configured while running the
mapr-setup.sh
script. For more information, see Managing Users and Groups.
check
Use the check
command to verify that the nodes specified in the Stanza
file are ready to be installed. For more information, see Verifying the Stanza File.
check [-h]
[--overrides [OVERRIDES [OVERRIDES …]]]
[--no_check_certificate][--url URL]
[--force][--verbose] --template TEMPLATE
export
export
command to discover a currently installed cluster
and generate a Stanza file that captures the configuration, the groups, and the hosts for
the cluster. You can then modify the Stanza file to install other clusters. For more
information, see Exporting a
Cluster Configuration.export
command does not contain the ssh_password
or
ssh_key_file
values. You need to add those values manually or provide
them on the command line by using an override.export [-h]
[--overrides [OVERRIDES [OVERRIDES ...]]]
[--no_check_certificate] [--url URL]
[--file FILE]
import
The import
command prepares the installer database using the template
generated by the probe
command. You must specify a template (YAML file) to
use the import command. For more information, see Using probe and import to Generate the Installer Database.
import [-h][--no_check_certificate][--url URL][--verbose]
--template TEMPLATE
install
You can use the install
command to perform a fresh install, an incremental
install, or an upgrade. For more information, see Installing or Upgrading Core Using an Installer Stanza.
install [-h]
[--overrides [OVERRIDES [OVERRIDES …]]]
[--no_check_certificate][--url URL]
[--force][--verbose] --template TEMPLATE
license
Use the license
command to add a license from a license file. For more
information, see Adding a License Using Stanzas.
license [-h]
[--no_check_certificate][--url URL]
--license LICENSE <license-file>
list
You can use the list
command to display information about the
configuration, services, groups, and hosts that are present in the Installer database. For more information, see Getting Information About Services and
Groups.
list [-h]
{config,groups,hosts,hosts_install_status,installed,services} ...
probe
The probe
command generates a template
file that can be used to create an installer database on a cluster that doesn’t have one.
A cluster must have an installer database in order for you to use Installer Stanzas on the cluster. If the installer database is not present,
you can use the probe
command followed by the import
command to generate one. For more information, see Using probe and import to Generate the Installer Database.
probe [-h]
[--no_check_certificate][--url URL]
[--force][--verbose] --template TEMPLATE
[--overrides [OVERRIDES [OVERRIDES …]][--verbose]]
reset
The reset
command uninstalls the metadata from the installer database. For
more information, see Resetting
the Installer Database.
reset [-h] [--overrides [OVERRIDES [OVERRIDES ...]]]
[--no_check_certificate] [--url URL]
[--force] [--verbose]
shutdown
The shutdown
command shuts down the cluster. For more information, see
Shutting Down a Cluster Using an Installer Stanza Command.
shutdown [-h] [--overrides [OVERRIDES [OVERRIDES ...]]]
[--no_check_certificate] [--url URL]
[--force] [--verbose]
uninstall
The uninstall
command removes Data Fabric
software. For more information, see Uninstalling Core Using an Installer Stanza.
uninstall [-h]
[--overrides [OVERRIDES [OVERRIDES ...]]]
[--no_check_certificate] [--url URL]
[--force] [--verbose]
Command Options
All of the following command options are optional except for the TEMPLATE
option:
Option | Description |
-h or --help |
Show this help message and exit. |
-o [OVERRIDES [OVERRIDES …]] or
--overrides [OVERRIDES [OVERRIDES
…]] x = y list of overrides or - for stdin |
Use the specification provided on the command line instead of the Stanza file
instructions. Overrides are typically used when you want to specify a host name, user
ID, password, or key file on the command line. NOTE
The
Use this command instead:
In the second command,
|
-n or --no_check_certificate |
Do not verify SSL certifications. |
-u URL or --url URL |
Installer URL (user:password@host:port) |
--file FILE |
The export file path. |
-f or --force |
Force action. This option eliminates user input and answers yes to all questions returned by the software. |
-v or --verbose |
Verbose output. |
-t TEMPLATE or --template TEMPLATE |
The specified Stanza template file (required for the install and
import commands). The template file can be a local file on the
installer node, or it can be a remotely accessible URL. |
Command Line Help
You can access online help at the command line using any of these commands:
Command | This command displays... |
./bin/mapr-installer-cli -h |
Top-level help for the installer |
./bin/mapr-installer-cli <cmd> -h where
<cmd> is one of the following:
|
Help for the specified command |