stop_db
Stops a database or sandbox.
Stops a database or sandbox.
Syntax
vcluster stop_db options
Required options
{ -c | --config }
string
- The path to the config file. If a configuration file is present in the default location (automatically generated by
create_db
), you do not need to specify this option.Default:
/opt/vertica/config/vertica_cluster.yaml
Options
--cert-file
string
- The absolute path to the certificate file. If you specify this option, you must also specify
--key-file
. You should only use--cert-file
and--key-file
if you have configured the Node Management Agent (NMA) to use custom certificates.
--drain-seconds
int
- [Eon only] The time to wait, in seconds, for user connections to close on their own. When the time expires, user connections are automatically closed and the database is shut down. If set to
0
, VCluster closes all user connections immediately. If the value is negative, VCluster waits indefinitely until all user connections close.Default:
60
--eon-mode
- [Eon only] Indicates that the database is an Eon Mode database.
{ -h | --help }
- Prints help text.
--ipv6
- Whether the hosts use IPv6 addresses. Hostnames resolve to IPv4 by default.
--key-file
string
- Path to the key file. If you specify this option, you must also specify
--cert-file
. You should only use--cert-file
and--key-file
if you have configured the Node Management Agent (NMA) to use custom certificates.
{ -l | --log-path }
string
- The absolute path for debug logs.
Default:
/opt/vertica/log/vcluster.log
--main-cluster-only
- Stops the database without stopping any sandboxed subclusters.
{ -p | --password }
string
- The database password.
--password-file
string
- The absolute path to a file containing the database password.
If you pass a dash(-) (that is, `--password-file -`), the password is read from STDIN.
Important
Your database password cannot include single quotes.
--read-password-from-prompt
- Prompts the user to enter the password.
--sandbox
string
- Name of the sandbox to stop.
--verbose
- Shows the details of VCluster run in the console.
Examples
To stop the database with password authentication:
$ vcluster stop_db --password my_password \
--config /opt/vertica/config/vertica_cluster.yaml