[
https://issues.apache.org/jira/browse/HAWQ-1209?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15802929#comment-15802929
]
ASF GitHub Bot commented on HAWQ-1209:
--------------------------------------
Github user dyozie commented on a diff in the pull request:
https://github.com/apache/incubator-hawq-docs/pull/80#discussion_r94877959
--- Diff: admin/RunningHAWQ.html.md.erb ---
@@ -2,21 +2,36 @@
title: Running a HAWQ Cluster
---
-This section provides information for system administrators and database
superusers responsible for administering a HAWQ system.
-
-This guide provides information and instructions for configuring,
maintaining and using a HAWQ system. This guide is intended for system and
database administrators responsible for managing a HAWQ system.
-
-This guide assumes knowledge of Linux/UNIX system administration, database
management systems, database administration, and structured query language
\(SQL\). Because HAWQ is based on PostgreSQL 8.2.15, this guide assumes some
familiarity with PostgreSQL. This guide calls out similarities between HAWQ and
PostgreSQL features throughout. It contains the topics:
-
-* <a class="subnav" href="./ambari-admin.html">Managing HAWQ Using
Ambari</a>
-* <a class="subnav" href="./startstop.html">Starting and Stopping HAWQ</a>
-* <a class="subnav" href="./ClusterExpansion.html">Expanding a Cluster</a>
-* <a class="subnav" href="./ClusterShrink.html">Removing a Node</a>
-* <a class="subnav"
href="./BackingUpandRestoringHAWQDatabases.html">Backing Up and Restoring
HAWQ</a>
-* <a class="subnav" href="./HighAvailability.html">High Availability in
HAWQ</a>
-* <a class="subnav" href="./MasterMirroring.html">Master Mirroring</a>
-* <a class="subnav"
href="./HAWQFilespacesandHighAvailabilityEnabledHDFS.html">HAWQ Filespaces and
High Availability Enabled HDFS</a>
-* <a class="subnav" href="./FaultTolerance.html">Understanding the Fault
Tolerance Service</a>
-* <a class="subnav" href="./RecommendedMonitoringTasks.html">Recommended
Monitoring and Maintenance Tasks</a>
-* <a class="subnav" href="./maintain.html">Routine System Maintenance
Tasks</a>
-* <a class="subnav" href="./monitor.html">Monitoring a HAWQ System</a>
+Your HAWQ deployment environment is a collection of systems, processes,
and data, and the users that operate on these systems, processes, and data.
This section provides information for system administrators and database
superusers responsible for administering a HAWQ deployment.
+
+You should have some knowledge of Linux/UNIX system administration,
database management systems, database administration, and structured query
language \(SQL\) to administer a HAWQ cluster. Because HAWQ is based on
PostgreSQL 8.2.15, you should also have some familiarity with PostgreSQL. The
HAWQ documentation calls out similarities between HAWQ and PostgreSQL features
throughout.
+
+## <a id="hawq_users"></a>HAWQ Users
+
+HAWQ supports users with both administrative and operating privileges. The
HAWQ administrator may choose to manage the HAWQ cluster using either Ambari or
the command line. [Managing HAWQ Using Ambari](../admin/ambari-admin.html)
provides Ambari-specific HAWQ cluster administration procedures. [Starting and
Stopping HAWQ](startstop.html), [Expanding a Cluster](ClusterExpansion.html),
and [Removing a Node](ClusterShrink.html) describe specific
command-line-managed HAWQ cluster administration procedures. Other topics in
this guide are applicable to both Ambari- and command-line-managed HAWQ
clusters.
+
+The default HAWQ admininstrator user is named `gpadmin`. The HAWQ admin
may choose to assign administrative and/or operating HAWQ privileges to
additional users. Refer to [Configuring Client
Authentication](../clientaccess/client_auth.html) and [Managing Roles and
Privileges](../clientaccess/roles_privs.html) for additional information on
HAWQ user configuration.
+
+## <a id="hawq_systems"></a>HAWQ Deployment Systems
+
+A typical HAWQ deployment will include single HDFS and HAWQ master and
standby nodes and multiple HAWQ segment and HDFS data nodes. The HAWQ cluster
may also include systems running PXF and other Hadoop services. Refer to [HAWQ
Architecture](../overview/HAWQArchitecture.html) and [Select HAWQ Host
Machines](../install/select-hosts.html) for information about the different
systems in a HAWQ deployment and how they are configured.
+
+
+## <a id="hawq_env_databases"></a>HAWQ Databases
+
+[Creating and Managing Databases](../ddl/ddl-database.html) and [Creating
and Managing Tables](../ddl/ddl-table.html) identify specific HAWQ database and
table creation and access information.
+
--- End diff --
Change "identify specific HAWQ database and ..." to "describe HAWQ
extensions database and table creation commands." or something similar.
> docs - create an overview page for HAWQ
> ---------------------------------------
>
> Key: HAWQ-1209
> URL: https://issues.apache.org/jira/browse/HAWQ-1209
> Project: Apache HAWQ
> Issue Type: Improvement
> Components: Documentation
> Reporter: Lisa Owen
> Assignee: David Yozie
> Priority: Minor
>
> create a "landing" topic that ties together the components in the HAWQ
> operating environment and the relevant documentation contents/sections.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
