You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@hawq.apache.org by yo...@apache.org on 2016/10/31 22:13:23 UTC

[13/50] incubator-hawq-docs git commit: Edit for active voice

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/tutorial-proto
Commit: 1987be9344def38df696efc3f77543288263532e
Parents: ae5332c
Author: Jane Beckman <jb...@pivotal.io>
Authored: Wed Oct 19 11:37:42 2016 -0700
Committer: Jane Beckman <jb...@pivotal.io>
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