Starts a HAWQ system.
hawq start <object> [-l| --logdir <logfile_directory>] [-q| --quiet] [-v|--verbose] [-m|--masteronly] [-t|--timeout <timeout_seconds>] [-R | --restrict] [-U | --special-mode maintenance] [--ignore-bad-hosts cluster | allsegments]
hawq start -? | -h | --help hawq start --version
hawq start utility is used to start the HAWQ server processes. When you start a HAWQ system, you are actually starting several
postgres database server listener processes at once (the master and all of the segment instances). The
hawq start utility handles the startup of the individual instances. Each instance is started in parallel.
The object in the command specifies what entity should be started: e.g. a cluster, a segment, the master node, standby node, or all segments in the cluster.
The first time an administrator runs
hawq start cluster, the utility creates a static hosts cache file named
$GPHOME/etc/slaves to store the segment host names. Subsequently, the utility uses this list of hosts to start the system more efficiently. The utility will create a new hosts cache file at each startup.
hawq start master command starts only the HAWQ master, without segment or standby nodes. These can be started later, using
hawq start segment and/or
hawq start standby.
Note: Typically you should always use
hawq start cluster or
hawq restart cluster to start the cluster. If you do end up using
hawq start standby|master|segment to start nodes individually, make sure you always start the standby before the active master. Otherwise, the standby can become unsynchronized with the active master.
Before you can start a HAWQ system, you must have initialized the system or node by using
hawq init <object> first.
$ PGOPTIONS='-c gp_role=utility' psql
postgresdatabase listener process, for example), it may take longer to start up due to the database recovery and validation process. If not specified, the default timeout is 60 seconds.
gp_maintenance_connparameter is set.
Start a HAWQ system:
$ hawq start cluster
Start a HAWQ master in maintenance mode:
$ hawq start master -m
Start a HAWQ system in restricted mode (only allow superuser connections):
$ hawq start cluster -R
Start the HAWQ master instance only and connect in utility mode:
$ hawq start master -m PGOPTIONS='-c gp_session_role=utility' psql