Edit for active voice
Project: http://git-wip-us.apache.org/repos/asf/incubator-hawq-docs/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-hawq-docs/commit/1987be93 Tree: http://git-wip-us.apache.org/repos/asf/incubator-hawq-docs/tree/1987be93 Diff: http://git-wip-us.apache.org/repos/asf/incubator-hawq-docs/diff/1987be93 Branch: refs/heads/develop Commit: 1987be9344def38df696efc3f77543288263532e Parents: ae5332c Author: Jane Beckman <[email protected]> Authored: Wed Oct 19 11:37:42 2016 -0700 Committer: Jane Beckman <[email protected]> Committed: Wed Oct 19 11:37:42 2016 -0700 ---------------------------------------------------------------------- reference/cli/admin_utilities/hawqinit.html.md.erb | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-hawq-docs/blob/1987be93/reference/cli/admin_utilities/hawqinit.html.md.erb ---------------------------------------------------------------------- diff --git a/reference/cli/admin_utilities/hawqinit.html.md.erb b/reference/cli/admin_utilities/hawqinit.html.md.erb index e3a7951..c9a7109 100644 --- a/reference/cli/admin_utilities/hawqinit.html.md.erb +++ b/reference/cli/admin_utilities/hawqinit.html.md.erb @@ -4,9 +4,9 @@ title: hawq init The `hawq init cluster` command initializes a HAWQ system and starts it. -The master or segment nodes can be individually initialized by using `hawq init master` and `hawq init segment` commands, respectively. Format options can also be specified at this time. The `hawq init standby` command initializes a standby master host for a HAWQ system. +The master or segment nodes can be individually initialized by using the `hawq init master` and `hawq init segment` commands, respectively. Specify any format options at this time. The `hawq init standby` command initializes a standby master host for a HAWQ system. -The `hawq init <object> --standby-host` option allows defining the host for a standby at initialization. +Use the `hawq init <object> --standby-host` option to define the host for a standby at initialization. ## <a id="topic1__section2"></a>Synopsis @@ -38,11 +38,11 @@ where: ## <a id="topic1__section3"></a>Description -The `hawq init <object>` utility will create a HAWQ instance using configuration parameters defined in `$GPHOME/etc/hawq-site.xml`. Before running this utility, make sure that you have installed the HAWQ software on all the hosts in the array. +The `hawq init <object>` utility creates a HAWQ instance using configuration parameters defined in `$GPHOME/etc/hawq-site.xml`. Before running this utility, verify that you have installed the HAWQ software on all the hosts in the array. -In a HAWQ DBMS, each database instance (the master and all segments) must be initialized across all of the hosts in the system in such a way that they can all work together as a unified DBMS. The `hawq init cluster` utility takes care of initializing the HAWQ master and each segment instance, and configuring the system as a whole. When hawq init cluster is run, the cluster comes online automatically without needing to explicitly start it. A single node cluster can be started without any user-defined changes to the default `hawq-site.xml` file. Use the template-hawq-site.xml file to specify the configuration for larger clusters. +In a HAWQ DBMS, each database instance (the master and all segments) must be initialized across all of the hosts in the system in a way that allows them all to work together as a unified DBMS. The `hawq init cluster` utility initializes the HAWQ master and each segment instance, and configures the system as a whole. When `hawq init cluster` is run, the cluster comes online automatically without needing to explicitly start it. You can start a single node cluster without any user-defined changes to the default `hawq-site.xml` file. For larger clusers, use the template-hawq-site.xml file to specify the configuration. -To use the template for initializing a new cluster configuration, replace the items contained within the % markers, for example in: `value%master.host%value`, `%master.host%` would be replaced with the master host name. After modification, rename the file to the name of the default configuration file: `hawq-site.xml`. +To use the template for initializing a new cluster configuration, replace the items contained within the % markers. For example: `value%master.host%value`, `%master.host%` would be replaced with the master host name. After modification, rename the file to the name of the default configuration file: `hawq-site.xml`. - Before initializing HAWQ, set the `$GPHOME` environment variable to point to the location of your HAWQ installation on the master host and exchange SSH keys between all host addresses in the array, using `hawq ssh-exkeys`. @@ -63,7 +63,7 @@ This utility performs the following tasks: - Configures the HAWQ system and checks for errors. - Starts the HAWQ system. -The `hawq init standby` utility can be run on the currently active *primary* master host or on the standby node. +The `hawq init standby` utility can be run on either the currently active *primary* master host or on the standby node. `hawq init standby` performs the following steps: @@ -74,7 +74,7 @@ The `hawq init standby` utility can be run on the currently active *primary* mas A backup, standby master host serves as a 'warm standby' in the event of the primary master host becoming non-operational. The standby master is kept up to date by transaction log replication processes (the `walsender` and `walreceiver`), which run on the primary master and standby master hosts and keep the data between the primary and standby master hosts synchronized. To add a standby master to the system, use the command `hawq init standby`, for example `hawq init standby host09`. You can configure the standby hostname at initialization without needing to run hawq config by defining it using the --standby-host option. To create the standby above, you would specify `hawq init standby --standby-host=host09` or `hawq init cluster --standby-host=host09`. -If the primary master fails, the log replication process is shut down, and the standby master can be activated in its place by using the `hawq activate standby` utility. Upon activation of the standby master, the replicated logs are used to reconstruct the state of the master host at the time of the last successfully committed transaction. +If the primary master fails, the log replication process is shut down, and you can activate the standby master in its place by using the `hawq activate standby` utility. Upon activation of the standby master, the replicated logs are used to reconstruct the state of the master host at the time of the last successfully committed transaction. ## Objects
