浏览代码

HPCC-14329 DOCS:Update Install Docs Sect ID Attributes

FIX HPCC-14329 DOCS:Update Install Docs Sect ID Attributes
Update Sect ID=Attributes where needed to harmonize with current doc. style
Including Installing and Running HPCC and the Data Tutorial Docs.

Signed-off-by: G Panagiotatos <greg.panagiotatos@lexisnexis.com>
G Panagiotatos 9 年之前
父节点
当前提交
ebda9cb676

+ 1 - 1
docs/HPCCDataTutorial/DataTutorial.xml

@@ -68,7 +68,7 @@
     </mediaobject>
     </mediaobject>
   </bookinfo>
   </bookinfo>
 
 
-  <chapter>
+  <chapter id="DataTutorialIntroduction">
     <title>Introduction</title>
     <title>Introduction</title>
 
 
     <sect1 id="Introduction_Case-Study-and-Tutorial" role="nobrk">
     <sect1 id="Introduction_Case-Study-and-Tutorial" role="nobrk">

+ 4 - 4
docs/Installing_and_RunningTheHPCCPlatform/Inst-Mods/Hardware.xml

@@ -199,10 +199,10 @@
           </mediaobject>
           </mediaobject>
         </figure></para>
         </figure></para>
 
 
-      <sect2>
+      <sect2 id="LoadBalancerRequirements">
         <title>Load Balancer Requirements</title>
         <title>Load Balancer Requirements</title>
 
 
-        <sect3>
+        <sect3 id="LoadBalancer_MinimumRequirements">
           <title>Minimum requirements</title>
           <title>Minimum requirements</title>
 
 
           <para><itemizedlist spacing="compact">
           <para><itemizedlist spacing="compact">
@@ -220,7 +220,7 @@
             </itemizedlist></para>
             </itemizedlist></para>
         </sect3>
         </sect3>
 
 
-        <sect3>
+        <sect3 id="LoadBalancer_StandardRequirements">
           <title>Standard requirements</title>
           <title>Standard requirements</title>
 
 
           <para><itemizedlist spacing="compact">
           <para><itemizedlist spacing="compact">
@@ -239,7 +239,7 @@
             </itemizedlist></para>
             </itemizedlist></para>
         </sect3>
         </sect3>
 
 
-        <sect3 role="brk">
+        <sect3 id="LoadBalancer_RecommendedCapabilities" role="brk">
           <title>Recommended capabilities</title>
           <title>Recommended capabilities</title>
 
 
           <para><itemizedlist spacing="compact">
           <para><itemizedlist spacing="compact">

+ 2 - 2
docs/Installing_and_RunningTheHPCCPlatform/Inst-Mods/UnityLauncher.xml

@@ -22,7 +22,7 @@
       </varlistentry>
       </varlistentry>
     </variablelist></para>
     </variablelist></para>
 
 
-  <sect2>
+  <sect2 id="UnityLauncher_AddIcon">
     <title><emphasis role="bold">To add the icon:</emphasis></title>
     <title><emphasis role="bold">To add the icon:</emphasis></title>
 
 
     <orderedlist numeration="arabic">
     <orderedlist numeration="arabic">
@@ -74,7 +74,7 @@
     </variablelist>
     </variablelist>
   </sect2>
   </sect2>
 
 
-  <sect2>
+  <sect2 id="UnityLauncher_UseIcon">
     <title><emphasis role="bold">To use the icon:</emphasis></title>
     <title><emphasis role="bold">To use the icon:</emphasis></title>
 
 
     <orderedlist numeration="arabic">
     <orderedlist numeration="arabic">

+ 35 - 35
docs/Installing_and_RunningTheHPCCPlatform/Inst-Mods/UserSecurityMaint.xml

@@ -187,7 +187,7 @@
         </orderedlist></para>
         </orderedlist></para>
     </sect3>
     </sect3>
 
 
-    <sect3 role="brk">
+    <sect3 id="UsingSecurity_SettingAndModifyingUserPermissions" role="brk">
       <title>Setting and modifying user permissions</title>
       <title>Setting and modifying user permissions</title>
 
 
       <para>Access to ECL Watch and its features is controlled using a login
       <para>Access to ECL Watch and its features is controlled using a login
@@ -238,7 +238,7 @@
       <para>All current users are identified in the list by their Username and
       <para>All current users are identified in the list by their Username and
       Full Name.</para>
       Full Name.</para>
 
 
-      <sect4>
+      <sect4 id="UsingSecurity_AddANewUser">
         <title>To add a new user to the list of authenticated users:</title>
         <title>To add a new user to the list of authenticated users:</title>
 
 
         <para>To add a new user you must have Administrator level access.
         <para>To add a new user you must have Administrator level access.
@@ -293,7 +293,7 @@
         details and set permissions as required.</para>
         details and set permissions as required.</para>
       </sect4>
       </sect4>
 
 
-      <sect4>
+      <sect4 id="UsingSecurity_ModifyUsersDetails">
         <title>To modify a user's details:</title>
         <title>To modify a user's details:</title>
 
 
         <para>Click on the<emphasis role="bold"> Operations</emphasis> icon,
         <para>Click on the<emphasis role="bold"> Operations</emphasis> icon,
@@ -345,7 +345,7 @@
         </orderedlist>
         </orderedlist>
       </sect4>
       </sect4>
 
 
-      <sect4>
+      <sect4 id="UsingSecurity_AddAUserToAGroup">
         <title>To add a user to a group:</title>
         <title>To add a user to a group:</title>
 
 
         <para>Click on the <emphasis role="bold">Operations</emphasis> icon,
         <para>Click on the <emphasis role="bold">Operations</emphasis> icon,
@@ -403,7 +403,7 @@
         </orderedlist>
         </orderedlist>
       </sect4>
       </sect4>
 
 
-      <sect4>
+      <sect4 id="UsingSecurity_PromoteUsertoAdministrator">
         <title>To promote a user to an Administrator</title>
         <title>To promote a user to an Administrator</title>
 
 
         <para>To modify a users credentials you must have Administrator level
         <para>To modify a users credentials you must have Administrator level
@@ -475,7 +475,7 @@
         </orderedlist>
         </orderedlist>
       </sect4>
       </sect4>
 
 
-      <sect4>
+      <sect4 id="UsingSecurity_DeleteUserFromGroup">
         <title>To delete a user from a group:</title>
         <title>To delete a user from a group:</title>
 
 
         <para>To delete a user you must have Administrator level
         <para>To delete a user you must have Administrator level
@@ -530,7 +530,7 @@
           </orderedlist></para>
           </orderedlist></para>
       </sect4>
       </sect4>
 
 
-      <sect4>
+      <sect4 id="UsingSecurity_ChangeUsersPassword">
         <title>To change a user's password:</title>
         <title>To change a user's password:</title>
 
 
         <para>Click on the<emphasis role="bold"> Operations</emphasis> icon,
         <para>Click on the<emphasis role="bold"> Operations</emphasis> icon,
@@ -583,7 +583,7 @@
         </orderedlist>
         </orderedlist>
       </sect4>
       </sect4>
 
 
-      <sect4>
+      <sect4 id="UsingSecurity_DeleteUserFromListofAuthenticatedUsers">
         <title>To delete a user from the list of authenticated users:</title>
         <title>To delete a user from the list of authenticated users:</title>
 
 
         <para>Click on the<emphasis role="bold"> Operations</emphasis> icon,
         <para>Click on the<emphasis role="bold"> Operations</emphasis> icon,
@@ -616,7 +616,7 @@
       </sect4>
       </sect4>
     </sect3>
     </sect3>
 
 
-    <sect3>
+    <sect3 id="UsingSecurity_SettingPermissionsForIndividualUser">
       <title>Setting permissions for an individual user</title>
       <title>Setting permissions for an individual user</title>
 
 
       <para>There may be occasions when you need to modify the permissions for
       <para>There may be occasions when you need to modify the permissions for
@@ -719,7 +719,7 @@
       </sect4>
       </sect4>
     </sect3>
     </sect3>
 
 
-    <sect3>
+    <sect3 id="UsingSecurity_SettingUpModifyingGroupPermissions">
       <title>Setting and modifying group permissions</title>
       <title>Setting and modifying group permissions</title>
 
 
       <para>Setting up groups ensures that all users with the same permission
       <para>Setting up groups ensures that all users with the same permission
@@ -748,7 +748,7 @@
           </listitem>
           </listitem>
         </itemizedlist></para>
         </itemizedlist></para>
 
 
-      <sect4>
+      <sect4 id="UsingSecurity_AddingEditingGroups">
         <title>Adding and editing groups</title>
         <title>Adding and editing groups</title>
 
 
         <para>When adding or changing the permissions for a group, all members
         <para>When adding or changing the permissions for a group, all members
@@ -764,7 +764,7 @@
         Click on the <emphasis role="bold">Groups</emphasis> tab.</para>
         Click on the <emphasis role="bold">Groups</emphasis> tab.</para>
       </sect4>
       </sect4>
 
 
-      <sect4>
+      <sect4 id="UsingSecurity_ToAddNewGroup">
         <title>To add a new group:</title>
         <title>To add a new group:</title>
 
 
         <para>Click on the <emphasis role="bold">Operations</emphasis> icon,
         <para>Click on the <emphasis role="bold">Operations</emphasis> icon,
@@ -804,7 +804,7 @@
           </orderedlist></para>
           </orderedlist></para>
       </sect4>
       </sect4>
 
 
-      <sect4>
+      <sect4 id="UsingSecurity_ToDeleteGroup">
         <title>To delete a group:</title>
         <title>To delete a group:</title>
 
 
         <para>Click on the <emphasis role="bold">Operations</emphasis> icon,
         <para>Click on the <emphasis role="bold">Operations</emphasis> icon,
@@ -836,7 +836,7 @@
           </orderedlist></para>
           </orderedlist></para>
       </sect4>
       </sect4>
 
 
-      <sect4>
+      <sect4 id="UsingSecurity_ToAddNewMembersToGroup">
         <title>To add new members to a group:</title>
         <title>To add new members to a group:</title>
 
 
         <para>Click on the <emphasis role="bold">Operations</emphasis> icon,
         <para>Click on the <emphasis role="bold">Operations</emphasis> icon,
@@ -886,7 +886,7 @@
           </orderedlist></para>
           </orderedlist></para>
       </sect4>
       </sect4>
 
 
-      <sect4>
+      <sect4 id="UsingSecurity_ToDeleteMembersFromGroup">
         <title>To delete members from a group:</title>
         <title>To delete members from a group:</title>
 
 
         <para>Click on the <emphasis role="bold">Operations</emphasis> icon,
         <para>Click on the <emphasis role="bold">Operations</emphasis> icon,
@@ -937,7 +937,7 @@
       </sect4>
       </sect4>
     </sect3>
     </sect3>
 
 
-    <sect3>
+    <sect3 id="UsingSecurity_SettingPermissionsForGroup">
       <title>Setting permissions for a group</title>
       <title>Setting permissions for a group</title>
 
 
       <para>By default, all users are members of the <emphasis
       <para>By default, all users are members of the <emphasis
@@ -963,7 +963,7 @@
       access, and the user is in another group where file access is allowed,
       access, and the user is in another group where file access is allowed,
       that user will still not have file access.</para>
       that user will still not have file access.</para>
 
 
-      <sect4>
+      <sect4 id="UsingSecurity_ToSetPermissionsForGroup">
         <title>To set permissions for a group:</title>
         <title>To set permissions for a group:</title>
 
 
         <para>Click on the <emphasis role="bold">Operations</emphasis> icon,
         <para>Click on the <emphasis role="bold">Operations</emphasis> icon,
@@ -1086,7 +1086,7 @@
     </itemizedlist>
     </itemizedlist>
   </sect2>
   </sect2>
 
 
-  <sect2 id="Feature_Resourcesl" role="brk">
+  <sect2 id="Feature_Resources" role="brk">
     <title>Feature resources</title>
     <title>Feature resources</title>
 
 
     <para>There are three types of features for which you can set up access
     <para>There are three types of features for which you can set up access
@@ -1105,7 +1105,7 @@
     <para>ECL Watch feature permission settings that are not listed are not
     <para>ECL Watch feature permission settings that are not listed are not
     relevant and should not be used.</para>
     relevant and should not be used.</para>
 
 
-    <sect3>
+    <sect3 id="ModifyPermissionsFeatureResource">
       <title>Modify permissions for a feature resource:</title>
       <title>Modify permissions for a feature resource:</title>
 
 
       <para>To use the feature permissions, you must apply them to a user or
       <para>To use the feature permissions, you must apply them to a user or
@@ -1172,13 +1172,13 @@
       </orderedlist>
       </orderedlist>
     </sect3>
     </sect3>
 
 
-    <sect3>
+    <sect3 id="FeaturePermissions">
       <title>Feature Permissions</title>
       <title>Feature Permissions</title>
 
 
       <para>The following sections show the level of access required to be
       <para>The following sections show the level of access required to be
       able to use ECL Watch features:</para>
       able to use ECL Watch features:</para>
 
 
-      <sect4>
+      <sect4 id="FeaturePermissions_Login">
         <title>Login</title>
         <title>Login</title>
 
 
         <para>SMCAccess is required by all users to be able to successfully
         <para>SMCAccess is required by all users to be able to successfully
@@ -1213,7 +1213,7 @@
           </informaltable></para>
           </informaltable></para>
       </sect4>
       </sect4>
 
 
-      <sect4>
+      <sect4 id="FeaturePermissions_Cluster">
         <title>Clusters</title>
         <title>Clusters</title>
 
 
         <para>Users may be given access to the thor queue which can be
         <para>Users may be given access to the thor queue which can be
@@ -1265,7 +1265,7 @@
           </informaltable></para>
           </informaltable></para>
       </sect4>
       </sect4>
 
 
-      <sect4>
+      <sect4 id="FeaturePermissions_ECLWorkunits">
         <title>ECL Workunits</title>
         <title>ECL Workunits</title>
 
 
         <para>Workunits can also be viewed using this feature of ECL Watch.
         <para>Workunits can also be viewed using this feature of ECL Watch.
@@ -1341,7 +1341,7 @@
           </informaltable></para>
           </informaltable></para>
       </sect4>
       </sect4>
 
 
-      <sect4>
+      <sect4 id="FeaturePermissions_Topology">
         <title>Topology</title>
         <title>Topology</title>
 
 
         <para>This section shows details about the clusters and other HPCC
         <para>This section shows details about the clusters and other HPCC
@@ -1419,7 +1419,7 @@
           </informaltable></para>
           </informaltable></para>
       </sect4>
       </sect4>
 
 
-      <sect4>
+      <sect4 id="FeaturePermissions_DFUWorkunits">
         <title>DFU Workunits</title>
         <title>DFU Workunits</title>
 
 
         <para>A user must have permission to view DFU Workunits and requires
         <para>A user must have permission to view DFU Workunits and requires
@@ -1463,7 +1463,7 @@
           </informaltable></para>
           </informaltable></para>
       </sect4>
       </sect4>
 
 
-      <sect4>
+      <sect4 id="FeaturePermissions_DFUFiles">
         <title>DFU Files</title>
         <title>DFU Files</title>
 
 
         <para>Users need permission to see files on the dropzone and also to
         <para>Users need permission to see files on the dropzone and also to
@@ -1632,7 +1632,7 @@
         </informaltable>
         </informaltable>
       </sect4>
       </sect4>
 
 
-      <sect4>
+      <sect4 id="FeaturePermissions_RoxieQueries">
         <title>Roxie Queries</title>
         <title>Roxie Queries</title>
 
 
         <para>Additional permission is required to view roxie queries in ECL
         <para>Additional permission is required to view roxie queries in ECL
@@ -1667,7 +1667,7 @@
           </informaltable></para>
           </informaltable></para>
       </sect4>
       </sect4>
 
 
-      <sect4>
+      <sect4 id="FeaturePermissions_UserPermissions">
         <title>Users/Permissions</title>
         <title>Users/Permissions</title>
 
 
         <para>To be able to view the <emphasis
         <para>To be able to view the <emphasis
@@ -1679,7 +1679,7 @@
     </sect3>
     </sect3>
   </sect2>
   </sect2>
 
 
-  <sect2>
+  <sect2 id="FeaturePermissions_FileAccessControl">
     <title><emphasis role="bold">File Access Control</emphasis></title>
     <title><emphasis role="bold">File Access Control</emphasis></title>
 
 
     <para>The HPCC’s LDAP <emphasis role="bold">Dali Server</emphasis>
     <para>The HPCC’s LDAP <emphasis role="bold">Dali Server</emphasis>
@@ -1803,7 +1803,7 @@
       </listitem>
       </listitem>
     </orderedlist>
     </orderedlist>
 
 
-    <sect3>
+    <sect3 id="AddingFileScopes_SettingScopePermissions">
       <title>Setting permissions for file scopes</title>
       <title>Setting permissions for file scopes</title>
 
 
       <para>You must apply permissions for file scopes to users or group(s).
       <para>You must apply permissions for file scopes to users or group(s).
@@ -1872,7 +1872,7 @@
       </orderedlist>
       </orderedlist>
     </sect3>
     </sect3>
 
 
-    <sect3>
+    <sect3 id="Security_FileScopeFeatures">
       <title>File scope features</title>
       <title>File scope features</title>
 
 
       <para>Below the List of File Scopes, there are buttons that allow you
       <para>Below the List of File Scopes, there are buttons that allow you
@@ -1933,7 +1933,7 @@
     </sect3>
     </sect3>
   </sect2>
   </sect2>
 
 
-  <sect2>
+  <sect2 id="Security_WorkunitAccessControl">
     <title>Workunit Access Control</title>
     <title>Workunit Access Control</title>
 
 
     <para>There are 2 aspects of workunit (WU) security:</para>
     <para>There are 2 aspects of workunit (WU) security:</para>
@@ -1978,7 +1978,7 @@
 
 
     <para><programlisting>#workunit(‘scope’,’MyScopeValue’);</programlisting></para>
     <para><programlisting>#workunit(‘scope’,’MyScopeValue’);</programlisting></para>
 
 
-    <sect3>
+    <sect3 id="Securing_Workunit_Scopes">
       <title>Securing workunit scopes</title>
       <title>Securing workunit scopes</title>
 
 
       <para>ESP (on startup) automatically creates an LDAP OU called <emphasis
       <para>ESP (on startup) automatically creates an LDAP OU called <emphasis
@@ -1997,7 +1997,7 @@
       .</emphasis></para>
       .</emphasis></para>
     </sect3>
     </sect3>
 
 
-    <sect3>
+    <sect3 id="Workunits_Feature_Permissions">
       <title>Workunits feature permissions</title>
       <title>Workunits feature permissions</title>
 
 
       <para>Using the <emphasis role="bold">Workunit Scopes</emphasis> feature
       <para>Using the <emphasis role="bold">Workunit Scopes</emphasis> feature
@@ -2088,7 +2088,7 @@
       </listitem>
       </listitem>
     </orderedlist>
     </orderedlist>
 
 
-    <sect3>
+    <sect3 id="UsingSecurity_SetScopePermissions">
       <title>Set permissions to the scope.</title>
       <title>Set permissions to the scope.</title>
 
 
       <para>You apply the workunit scopes to a group. If you want to apply the
       <para>You apply the workunit scopes to a group. If you want to apply the

+ 11 - 11
docs/Installing_and_RunningTheHPCCPlatform/Inst-Mods/hpcc_ldap.xml

@@ -47,14 +47,14 @@
     </tgroup>
     </tgroup>
   </informaltable>
   </informaltable>
 
 
-  <sect2>
+  <sect2 id="Using_htpasswd_Authentication">
     <title>Using htpasswd authentication</title>
     <title>Using htpasswd authentication</title>
 
 
     <para>htpasswd provides basic password authentication to the entire
     <para>htpasswd provides basic password authentication to the entire
     system. This section contains the information to install and implement
     system. This section contains the information to install and implement
     htpasswd authentication.</para>
     htpasswd authentication.</para>
 
 
-    <sect3>
+    <sect3 id="htpasswd_ConnectToConfigMgr">
       <title>Connect to Configuration Manager</title>
       <title>Connect to Configuration Manager</title>
 
 
       <para>In order to change the configuration for HPCC components, connect
       <para>In order to change the configuration for HPCC components, connect
@@ -118,7 +118,7 @@
       </orderedlist>
       </orderedlist>
     </sect3>
     </sect3>
 
 
-    <sect3>
+    <sect3 id="Enabling_htpasswd_AUthentication">
       <title>Enabling htpasswd authentication in HPCC</title>
       <title>Enabling htpasswd authentication in HPCC</title>
 
 
       <orderedlist continuation="continues">
       <orderedlist continuation="continues">
@@ -180,7 +180,7 @@
       </orderedlist>
       </orderedlist>
     </sect3>
     </sect3>
 
 
-    <sect3>
+    <sect3 id="htpasswd_UserAdminWhtpasswd">
       <title>User administration with htpasswd</title>
       <title>User administration with htpasswd</title>
 
 
       <para>Users and passwords are kept in the htpasswd file. The htpasswd
       <para>Users and passwords are kept in the htpasswd file. The htpasswd
@@ -205,7 +205,7 @@
     </sect3>
     </sect3>
   </sect2>
   </sect2>
 
 
-  <sect2 role="brk">
+  <sect2 id="Using_LDAP_Authentication" role="brk">
     <title>Using LDAP Authentication</title>
     <title>Using LDAP Authentication</title>
 
 
     <para>This section contains the information to install and implement LDAP
     <para>This section contains the information to install and implement LDAP
@@ -217,7 +217,7 @@
 
 
     <!--***Note: (9/2014) Adding Documentation for initLdap.*** -->
     <!--***Note: (9/2014) Adding Documentation for initLdap.*** -->
 
 
-    <sect3>
+    <sect3 id="UsingLDAP_ConnectToConfigMgr">
       <title>Connect to Configuration Manager</title>
       <title>Connect to Configuration Manager</title>
 
 
       <para>In order to change the configuration for HPCC components, connect
       <para>In order to change the configuration for HPCC components, connect
@@ -265,7 +265,7 @@
     </sect3>
     </sect3>
   </sect2>
   </sect2>
 
 
-  <sect2>
+  <sect2 id="UsingLDAP_ModifyingConfiguration">
     <title>Modifying the configuration</title>
     <title>Modifying the configuration</title>
 
 
     <para>Follow the steps below to modify your configuration.</para>
     <para>Follow the steps below to modify your configuration.</para>
@@ -346,7 +346,7 @@
     </orderedlist>
     </orderedlist>
   </sect2>
   </sect2>
 
 
-  <sect2>
+  <sect2 id="UsingLDAP_Adding_ldapServer_component">
     <title>Adding the ldapServer component</title>
     <title>Adding the ldapServer component</title>
 
 
     <para>After the LDAP Server node has been added to the Hardware
     <para>After the LDAP Server node has been added to the Hardware
@@ -599,7 +599,7 @@
       </informaltable></para>
       </informaltable></para>
   </sect2>
   </sect2>
 
 
-  <sect2>
+  <sect2 id="UsingLDAP_Installing_Default_AdminUser">
     <title>Installing the Default Admin user</title>
     <title>Installing the Default Admin user</title>
 
 
     <para>After enabling your configuration for LDAP security, you must copy
     <para>After enabling your configuration for LDAP security, you must copy
@@ -610,7 +610,7 @@
     the <emphasis role="bold">initldap</emphasis> utility that initializes the
     the <emphasis role="bold">initldap</emphasis> utility that initializes the
     security components and the default users.</para>
     security components and the default users.</para>
 
 
-    <sect3>
+    <sect3 id="UsingLDAP_theInitldapUtility">
       <title>The initldap Utility</title>
       <title>The initldap Utility</title>
 
 
       <para>The initldap utility creates the HPCC Administrator's user account
       <para>The initldap utility creates the HPCC Administrator's user account
@@ -642,7 +642,7 @@ Proceed?  y/n
 </programlisting></para>
 </programlisting></para>
     </sect3>
     </sect3>
 
 
-    <sect3>
+    <sect3 id="UsingLDAP_Using_addScopesTool">
       <title>Using the addScopes tool</title>
       <title>Using the addScopes tool</title>
 
 
       <para>When a new ESP user account is created, a private
       <para>When a new ESP user account is created, a private

+ 9 - 9
docs/Installing_and_RunningTheHPCCPlatform/Inst-Mods/ssl-esp.xml

@@ -39,7 +39,7 @@
   encrypted and secure. The Public and Private Keys use 1024-bit RSA
   encrypted and secure. The Public and Private Keys use 1024-bit RSA
   encryption.</para>
   encryption.</para>
 
 
-  <sect2>
+  <sect2 id="ConfigureESP_GenerateRSAPrivateKey">
     <title><emphasis role="bold">Generate an RSA Private
     <title><emphasis role="bold">Generate an RSA Private
     Key</emphasis></title>
     Key</emphasis></title>
 
 
@@ -61,7 +61,7 @@
     enter it into the Configuration Manager later.</emphasis></para>
     enter it into the Configuration Manager later.</emphasis></para>
   </sect2>
   </sect2>
 
 
-  <sect2 role="brk">
+  <sect2 id="ConfigureESP_GenerateCSReq" role="brk">
     <title><emphasis role="bold">Generate a CSR (Certificate Signing
     <title><emphasis role="bold">Generate a CSR (Certificate Signing
     Request)</emphasis></title>
     Request)</emphasis></title>
 
 
@@ -140,7 +140,7 @@
       </informaltable></para>
       </informaltable></para>
   </sect2>
   </sect2>
 
 
-  <sect2>
+  <sect2 id="ConfigureESP_GenerateSelf-Signed_Certificate">
     <title><emphasis role="bold">Generate a Self-Signed
     <title><emphasis role="bold">Generate a Self-Signed
     Certificate</emphasis></title>
     Certificate</emphasis></title>
 
 
@@ -153,7 +153,7 @@
     your CSR.</para>
     your CSR.</para>
   </sect2>
   </sect2>
 
 
-  <sect2>
+  <sect2 id="ConfigureESP_InstallPrivateKeyandCertificate">
     <title><emphasis role="bold">Installing the Private Key and Certificate to
     <title><emphasis role="bold">Installing the Private Key and Certificate to
     your ESP Server</emphasis></title>
     your ESP Server</emphasis></title>
 
 
@@ -169,11 +169,11 @@ sudo cp server.key /var/lib/HPCCSystems/myesp/privatekey.cer
 </programlisting>
 </programlisting>
   </sect2>
   </sect2>
 
 
-  <sect2 role="brk">
+  <sect2 id="ConfigureHTTPSonESPServer" role="brk">
     <title><emphasis role="bold">Configure HTTPS on your ESP
     <title><emphasis role="bold">Configure HTTPS on your ESP
     Server</emphasis></title>
     Server</emphasis></title>
 
 
-    <sect3>
+    <sect3 id="Start_ConfigMgrAdvancedMode">
       <title><emphasis role="bold">Start Configuration Manager in Advanced
       <title><emphasis role="bold">Start Configuration Manager in Advanced
       Mode</emphasis></title>
       Mode</emphasis></title>
 
 
@@ -227,7 +227,7 @@ sudo cp server.key /var/lib/HPCCSystems/myesp/privatekey.cer
       </orderedlist>
       </orderedlist>
     </sect3>
     </sect3>
 
 
-    <sect3 role="brk">
+    <sect3 id="Configure_ESP_forHTTPS" role="brk">
       <title><emphasis role="bold">Configure ESP</emphasis></title>
       <title><emphasis role="bold">Configure ESP</emphasis></title>
 
 
       <orderedlist numeration="arabic">
       <orderedlist numeration="arabic">
@@ -264,7 +264,7 @@ sudo cp server.key /var/lib/HPCCSystems/myesp/privatekey.cer
       </orderedlist>
       </orderedlist>
     </sect3>
     </sect3>
 
 
-    <sect3>
+    <sect3 id="ConfigureOneorMoreSSLEnabledServiceBindings">
       <title><emphasis role="bold">Configure one or more SSL-Enabled Service
       <title><emphasis role="bold">Configure one or more SSL-Enabled Service
       Bindings</emphasis></title>
       Bindings</emphasis></title>
 
 
@@ -323,7 +323,7 @@ sudo cp server.key /var/lib/HPCCSystems/myesp/privatekey.cer
     </sect3>
     </sect3>
   </sect2>
   </sect2>
 
 
-  <sect2 role="brk">
+  <sect2 id="DistributeEnvironmentConfigFileToAllNodes" role="brk">
     <title><emphasis role="bold">Distribute the environment configuration file
     <title><emphasis role="bold">Distribute the environment configuration file
     to all nodes, Restart, and Certify</emphasis></title>
     to all nodes, Restart, and Certify</emphasis></title>
 
 

+ 19 - 19
docs/Installing_and_RunningTheHPCCPlatform/Installing_and_RunningTheHPCCPlatform.xml

@@ -173,7 +173,7 @@
         </listitem>
         </listitem>
       </orderedlist>
       </orderedlist>
 
 
-      <sect2>
+      <sect2 id="Installing_NowWhat">
         <title>Now What?</title>
         <title>Now What?</title>
 
 
         <para>Now that you have HPCC started and running, what do you want to
         <para>Now that you have HPCC started and running, what do you want to
@@ -403,7 +403,7 @@
           </footnote> code using either ECL IDE, the command line ECL
           </footnote> code using either ECL IDE, the command line ECL
         compiler, or the ECL Command line tool.</para>
         compiler, or the ECL Command line tool.</para>
 
 
-        <sect3>
+        <sect3 id="InstallTheECLIDEandClientTools">
           <title>Install the ECL IDE and HPCC Client Tools</title>
           <title>Install the ECL IDE and HPCC Client Tools</title>
 
 
           <para><orderedlist>
           <para><orderedlist>
@@ -477,7 +477,7 @@
             </orderedlist></para>
             </orderedlist></para>
         </sect3>
         </sect3>
 
 
-        <sect3 role="brk">
+        <sect3 id="RunningABasicECLProgram" role="brk">
           <title>Running a basic ECL program</title>
           <title>Running a basic ECL program</title>
 
 
           <para>Now that the package is installed on your Linux node and ECL
           <para>Now that the package is installed on your Linux node and ECL
@@ -538,7 +538,7 @@
           </orderedlist>
           </orderedlist>
         </sect3>
         </sect3>
 
 
-        <sect3>
+        <sect3 id="RunningRemotelyUsingECLCmdLine">
           <title>Running remotely using ECL Command Line</title>
           <title>Running remotely using ECL Command Line</title>
 
 
           <para>The <emphasis role="bold">ECL Command Line Interface (CLI)
           <para>The <emphasis role="bold">ECL Command Line Interface (CLI)
@@ -587,7 +587,7 @@
           listed in your environment's topology section.</para>
           listed in your environment's topology section.</para>
         </sect3>
         </sect3>
 
 
-        <sect3 role="brk">
+        <sect3 id="RunningABasicECLProgramFromtheIDE" role="brk">
           <title>Running a basic ECL program from the ECL IDE</title>
           <title>Running a basic ECL program from the ECL IDE</title>
 
 
           <para><orderedlist>
           <para><orderedlist>
@@ -1179,7 +1179,7 @@ sudo cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/environment.
 
 
         <para>The following commands can be used:</para>
         <para>The following commands can be used:</para>
 
 
-        <sect3>
+        <sect3 id="StartStop_ToStartSystem">
           <title>To start the system:</title>
           <title>To start the system:</title>
 
 
           <para><emphasis role="bold">Centos/Red
           <para><emphasis role="bold">Centos/Red
@@ -1194,7 +1194,7 @@ sudo cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/environment.
           <programlisting>sudo /etc/init.d/hpcc-init start</programlisting>
           <programlisting>sudo /etc/init.d/hpcc-init start</programlisting>
         </sect3>
         </sect3>
 
 
-        <sect3>
+        <sect3 id="StartStop_StopTheSystem">
           <title>To stop the system:</title>
           <title>To stop the system:</title>
 
 
           <para><emphasis role="bold">Centos/Red
           <para><emphasis role="bold">Centos/Red
@@ -1231,7 +1231,7 @@ sudo cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/environment.
             </informaltable></para>
             </informaltable></para>
         </sect3>
         </sect3>
 
 
-        <sect3>
+        <sect3 id="StartStop_SingleComponents">
           <title>Start or Stop Single Components</title>
           <title>Start or Stop Single Components</title>
 
 
           <para>To start or stop a single component, you can use the -c flag
           <para>To start or stop a single component, you can use the -c flag
@@ -1327,14 +1327,14 @@ sudo cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/environment.
                 xmlns:xi="http://www.w3.org/2001/XInclude" />
                 xmlns:xi="http://www.w3.org/2001/XInclude" />
   </chapter>
   </chapter>
 
 
-  <chapter>
+  <chapter id="Installing_MoreECLExamples">
     <title>More Examples</title>
     <title>More Examples</title>
 
 
     <para>This section contains additional ECL examples you can use on your
     <para>This section contains additional ECL examples you can use on your
     HPCC cluster. You can run these on a single-node system or a larger
     HPCC cluster. You can run these on a single-node system or a larger
     multi-node cluster.</para>
     multi-node cluster.</para>
 
 
-    <sect1 role="nobrk">
+    <sect1 id="ECLExample_Anagram1" role="nobrk">
       <title>ECL Example: Anagram1</title>
       <title>ECL Example: Anagram1</title>
 
 
       <para>This example takes a STRING and produces every possible anagram
       <para>This example takes a STRING and produces every possible anagram
@@ -1419,7 +1419,7 @@ OUTPUT(L);</programlisting></para>
       <?hard-pagebreak ?>
       <?hard-pagebreak ?>
     </sect1>
     </sect1>
 
 
-    <sect1>
+    <sect1 id="ECLRoxieExample_Anagram2">
       <title>Roxie Example: Anagram2</title>
       <title>Roxie Example: Anagram2</title>
 
 
       <para>In this example, we will download an open source data file of
       <para>In this example, we will download an open source data file of
@@ -1429,7 +1429,7 @@ OUTPUT(L);</programlisting></para>
       file. Using an index and a keyed join would be more efficient, but this
       file. Using an index and a keyed join would be more efficient, but this
       serves as a simple example.</para>
       serves as a simple example.</para>
 
 
-      <sect2>
+      <sect2 id="RoxieExample_DownloadWordList">
         <title>Download the word list</title>
         <title>Download the word list</title>
 
 
         <para>We will download the word list from <ulink
         <para>We will download the word list from <ulink
@@ -1666,7 +1666,7 @@ OUTPUT(L);</programlisting></para>
         </orderedlist>
         </orderedlist>
       </sect2>
       </sect2>
 
 
-      <sect2>
+      <sect2 id="RunTheQueryOnThor">
         <title>Run the query on Thor</title>
         <title>Run the query on Thor</title>
 
 
         <para><orderedlist>
         <para><orderedlist>
@@ -1747,7 +1747,7 @@ OUTPUT(ValidWords)
           </orderedlist></para>
           </orderedlist></para>
       </sect2>
       </sect2>
 
 
-      <sect2>
+      <sect2 id="RoxieExample_CompileAndPublishtheQuery">
         <title>Compile and Publish the query to Roxie</title>
         <title>Compile and Publish the query to Roxie</title>
 
 
         <para><orderedlist>
         <para><orderedlist>
@@ -2019,7 +2019,7 @@ OUTPUT(ValidWords)
     </sect1>
     </sect1>
   </chapter>
   </chapter>
 
 
-  <chapter>
+  <chapter id="ExampleECL_NextSteps">
     <title>Next Steps</title>
     <title>Next Steps</title>
 
 
     <para>Available from the menu in the ECL IDE there are several documents
     <para>Available from the menu in the ECL IDE there are several documents
@@ -2129,7 +2129,7 @@ OUTPUT(ValidWords)
           </tgroup>
           </tgroup>
         </informaltable></para>
         </informaltable></para>
 
 
-      <sect2>
+      <sect2 id="ExampleScripts_install-cluster.sh">
         <title>install-cluster.sh</title>
         <title>install-cluster.sh</title>
 
 
         <para><emphasis
         <para><emphasis
@@ -2254,7 +2254,7 @@ OUTPUT(ValidWords)
         <para>(where <emphasis>n.n.nnnn</emphasis> is the build number)</para>
         <para>(where <emphasis>n.n.nnnn</emphasis> is the build number)</para>
       </sect2>
       </sect2>
 
 
-      <sect2 role="brk">
+      <sect2 id="ExampleScripts_deploy-java-files.sh" role="brk">
         <title>deploy-java-files.sh</title>
         <title>deploy-java-files.sh</title>
 
 
         <para><emphasis
         <para><emphasis
@@ -2382,7 +2382,7 @@ OUTPUT(ValidWords)
         <para><programlisting>./deploy-java-files.sh -H /home/hpcc/hosts.txt -s /home/hpcc/java/* -t /home/hpcc/java/ </programlisting></para>
         <para><programlisting>./deploy-java-files.sh -H /home/hpcc/hosts.txt -s /home/hpcc/java/* -t /home/hpcc/java/ </programlisting></para>
       </sect2>
       </sect2>
 
 
-      <sect2 role="brk">
+      <sect2 id="ExampleScripts_hpcc-push.sh" role="brk">
         <title>hpcc-push.sh</title>
         <title>hpcc-push.sh</title>
 
 
         <para><emphasis
         <para><emphasis
@@ -2444,7 +2444,7 @@ OUTPUT(ValidWords)
 </programlisting></para>
 </programlisting></para>
       </sect2>
       </sect2>
 
 
-      <sect2 role="brk">
+      <sect2 id="ExampleScripts_hpcc-run.sh" role="brk">
         <title>hpcc-run.sh</title>
         <title>hpcc-run.sh</title>
 
 
         <para><emphasis role="bold">hpcc-run.sh
         <para><emphasis role="bold">hpcc-run.sh