Github user dyozie commented on a diff in the pull request:
https://github.com/apache/incubator-hawq-docs/pull/59#discussion_r87913443
--- Diff: bestpractices/operating_hawq_bestpractices.html.md.erb ---
@@ -4,6 +4,16 @@ title: Best Practices for Operating HAWQ
This topic provides best practices for operating HAWQ, including
recommendations for stopping, starting and monitoring HAWQ.
+## <a id="best_practice_config"></a>Best Practices for Configuring HAWQ
Parameters
+
+The HAWQ configuration guc/parameters are located in
`$GPHOME/etc/hawq-site.xml`. This configuration file resides on all HAWQ
instances and can be modified either by the Ambari interface or the command
line.
+
+If you install and manage HAWQ using Ambari, use the Ambari interface for
all configuration changes. Do not use command line utilities such as `hawq
config` to set or change HAWQ configuration properties for Ambari-managed
clusters. Configuration changes to `hawq-site.xml` made outside the Ambari
interface will be overwritten when you restart or reconfigure HAWQ using Ambari.
+
+If you make changes using the command line interface, use a consistent
`hawq-site.xml` file to configure your entire cluster.
--- End diff --
Change this sentence to start: "If you manage your cluster using
command-line tools instead of Ambari, then use a consistent ..."
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastruct...@apache.org or file a JIRA ticket
with INFRA.
---
