You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@trafodion.apache.org by db...@apache.org on 2016/05/05 23:39:43 UTC
[12/22] incubator-trafodion git commit: Prepared documents for TLP
and centralized shared information.
http://git-wip-us.apache.org/repos/asf/incubator-trafodion/blob/21d6d8d3/docs/provisioning_guide/src/asciidoc/_chapters/prepare.adoc
----------------------------------------------------------------------
diff --git a/docs/provisioning_guide/src/asciidoc/_chapters/prepare.adoc b/docs/provisioning_guide/src/asciidoc/_chapters/prepare.adoc
index 2df5383..b9f63c4 100644
--- a/docs/provisioning_guide/src/asciidoc/_chapters/prepare.adoc
+++ b/docs/provisioning_guide/src/asciidoc/_chapters/prepare.adoc
@@ -20,12 +20,12 @@
* under the License.
*
* @@@ END COPYRIGHT @@@
- */
+*/
////
[[prepare]]
= Prepare
-You need to prepare your Hadoop environment before installing Trafodion.
+You need to prepare your Hadoop environment before installing {project-name}.
1. <<prepare-install-optional-workstation-software,Install Optional Workstation Software>>
2. <<configure-installation-user-id,Configure Installation User ID>>
@@ -40,7 +40,7 @@ You need to prepare your Hadoop environment before installing Trafodion.
== Install Optional Workstation Software
If you are using a Windows workstation, then the following optional software helps installation process.
-We recommended that you pre-install the software before continuing with the Trafodion installation:
+We recommended that you pre-install the software before continuing with the {project-name} installation:
* putty and puttygen (download from http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html[PuTTY web site])
* VNC client (download from http://www.realvnc.com[RealVNC web site])
@@ -50,10 +50,10 @@ We recommended that you pre-install the software before continuing with the Traf
[[configure-installation-user-id]]
== Configure Installation User ID
-Trafodion installation requires a user ID with these attributes:
+{project-name} installation requires a user ID with these attributes:
* `sudo` access per the requirements documented in <<requirements-linux-installation-user,Linux Installation User>>.
-* passwordless ssh to all nodes on the cluster where Trafodion will be installed.
+* passwordless ssh to all nodes on the cluster where {project-name} will be installed.
NOTE: You may need to request permission from your cluster-management team to obtain this type of access.
@@ -91,15 +91,15 @@ ensure that the `requiretty` option is NOT being used.
== Verify OS Requirements and Recommendations
Please ensure that the <<requirements-os-requirements-and-recommendations,OS Requirements and Recommendations>>
-are met for each node in the cluster where you intend to install Trafodion.
+are met for each node in the cluster where you intend to install {project-name}.
<<<
[[prepare-configure-ldap-identity-store]]
== Configure LDAP Identity Store
-If you plan to enable security in Trafodion, then you need to have an LDAP identity store available to perform authentication.
-The Trafodion Installer prompts you to set up an authentication configuration file that points to an LDAP server (or servers),
-which enables security (that is, authentication and authorization) in the Trafodion database.
+If you plan to enable security in {project-name}, then you need to have an LDAP identity store available to perform authentication.
+The {project-name} Installer prompts you to set up an authentication configuration file that points to an LDAP server (or servers),
+which enables security (that is, authentication and authorization) in the {project-name} database.
If you wish to manually set up the authentication configuration file and enable security, then refer to the section on
<<enable-security,Enable Security>>.
@@ -107,7 +107,7 @@ If you wish to manually set up the authentication configuration file and enable
[[prepare-gather-configuration-information]]
== Gather Configuration Information
-You need to gather/decide information about your environment to aid installation Trafodion, both for the Trafodion Installer
+You need to gather/decide information about your environment to aid installation {project-name}, both for the {project-name} Installer
and for recipe-based provisioning. (Listed in alphabetical order to make it easier to find information when referenced in the install and upgrade instructions.)
[cols="25%l,25%,15%l,35%",options="header"]
@@ -116,27 +116,27 @@ and for recipe-based provisioning. (Listed in alphabetical order to make it easi
| ADMIN | Administrator user name for Apache Ambari or Cloudera Manager. | admin | A user that can change configuration and restart services via the
distribution manager's REST API.
| BACKUP_DCS_NODES | List of nodes where to start the backup DCS Master components. | None | Blank separated FQDN list. Not needed if $ENABLE_HA = N.
-| CLOUD_CONFIG | Whether you're installing Trafodion on a cloud environment. | N | N = bare-metal or VM installation.
-| CLOUD_TYPE | What type of cloud environment you're installing Trafodion on. | None | { AWS \| OpenStack \| Other }. Not applicable for bare-metal or VM installation.
+| CLOUD_CONFIG | Whether you're installing {project-name} on a cloud environment. | N | N = bare-metal or VM installation.
+| CLOUD_TYPE | What type of cloud environment you're installing {project-name} on. | None | { AWS \| OpenStack \| Other }. Not applicable for bare-metal or VM installation.
| CLUSTER_NAME | The name of the Hadoop Cluster. | None | From Apache Ambari or Cloudera Manager.
-| DCS_BUILD | Tar file containing the DCS component. | None | Not needed if using a Trafodion package installation tar file.
+| DCS_BUILD | Tar file containing the DCS component. | None | Not needed if using a {project-name} package installation tar file.
| DCS_PRIMARY_MASTER_NODE | The node where the primary DCS should run. | None | The DCS Master handles JDBC and ODBC connection requests.
| DCS_SERVER_PARM | Number of concurrent client sessions per node. | 16 | This number specifies the concurrent sessions per node to be supported. Each session could require up to 1GB of physical memory. The number can be changed post-installation. For more information,
-refer to the http://trafodion.apache.org/docs/client_install/index.html[Trafodion Client Installation Guide].
+refer to the {docs-url}/client_install/index.html[{project-name} Client Installation Guide].
| ENABLE_HA | Whether to run DCS in high-availability (HA) mode. | N | You need the floating IP address, the interface, and the backup nodes for DCS Master if enabling this feature.
| EPEL_RPM | Location of EPEL RPM. | None | Specify if you don't have access to the Internet.
-Downloaded automatically by the Trafodion Installer.
+Downloaded automatically by the {project-name} Installer.
| FLOATING_IP | IP address if running DCS in HA mode. | None | Not needed if $ENABLE_HA = N. An FQDN name or IP address.
-| HADOOP_TYPE | The type of Hadoop distribution you're installing Trafodion on. | None | Lowercase. cloudera or hadoop.
+| HADOOP_TYPE | The type of Hadoop distribution you're installing {project-name} on. | None | Lowercase. cloudera or hadoop.
| HBASE_GROUP | Linux group name for the HBASE administrative user. | hbase | Required in order to provide access to select HDFS directories to this user ID.
| HBASE_USER | Linux user name for the HBASE administrative user. | hbase | Required in order to provide access to select HDFS directories to this user ID.
-| HDFS_USER | Linux user name for the HDFS administrative user. | hdfs | The Trafodion Installer uses `sudo su` to make HDFS
+| HDFS_USER | Linux user name for the HDFS administrative user. | hdfs | The {project-name} Installer uses `sudo su` to make HDFS
configuration changes under this user.
| HOME_DIR | Root directory under which the `trafodion` home directory should be created. | /home | *Example* +
+
If the home directory of the `trafodion` user is
`/opt/home/trafodion`, then specify the root directory as `/opt/home`.
-| INIT_TRAFODION | Whether to automatically initialize the Trafodion database. | N | Does not apply to Recipe-Based Provisioning. Applies if $START=Y only.
+| INIT_TRAFODION | Whether to automatically initialize the {project-name} database. | N | Does not apply to Recipe-Based Provisioning. Applies if $START=Y only.
| INTERFACE | Interface type used for $FLOATING_IP. | None | Not needed if $ENABLE_HA = N.
| JAVA_HOME | Location of Java 1.7.0_65 or higher (JDK). | $JAVA_HOME setting | Fully qualified path of the JDK. For example:
`/usr/java/jdk1.7.0_67-cloudera`
@@ -148,27 +148,27 @@ If the home directory of the `trafodion` user is
| LDAP_PORT^2^ | Port used to communicate with LDAP Identity Store. | None | Examples: 389 for no encryption or TLS, 636 for SSL.
| LDAP_SECURITY^2^ | Whether to enable simple LDAP authentication. | N | If Y, then you need to provide LDAP_HOSTS.
| LDAP_USER^2^ | LDAP Search user name. | None | If required. If so, must provide LDAP_PASSWORD, too.
-| LOCAL_WORKDIR | The directory where the Trafodion Installer is located. | None | Full path, no environmental variables.
+| LOCAL_WORKDIR | The directory where the {project-name} Installer is located. | None | Full path, no environmental variables.
| MANAGEMENT_ENABLED | Whether your installation uses separate management nodes. | N | Y if using separate management nodes for Apache Ambari or Cloudera Manager.
| MANAGEMENT_NODES | The FQDN names of management nodes, if any. | None | Provide a blank-separated list of node names.
-| NODE_LIST | The FQDN names of the nodes where Trafodion will be installed. | None | Provide a blank-separated list of node names. The Trafodion
+| NODE_LIST | The FQDN names of the nodes where {project-name} will be installed. | None | Provide a blank-separated list of node names. The {project-name}
Provisioning ID must have passwordless and `sudo` access to these nodes.
| PASSWORD | Administrator password for Apache Ambari or Cloudera Manager. | admin | A user that can change configuration and restart services via the
distribution manager's REST API.
-| REST_BUILD | Tar file containing the REST component. | None | Not needed if using a Trafodion package installation tar file.
-| SQ_ROOT | Target directory for the Trafodion software. | $HOME_DIR/trafodion | Trafodion is installed in this directory on all nodes in `$NODE_LIST`.
-| START | Whether to start Trafodion after install/upgrade. | N | Does not apply to Recipe-Based Provisioning.
-| SUSE_LINUX | Whether your installing Trafodion on SUSE Linux. | false | Auto-detected by the Trafodion Installer.
-| TRAF_PACKAGE | The location of the Trafodion installation package tar file or core installation tar file. | None | The package file contains the Trafodion server,
-DCS, and REST software while the core installation file contains the Trafodion server software only. If you're using a core installation file, then you need to
-record the location of the DCS and REST installation tar files, too. Normally, you perform Trafodion provisioning using a Trafodion package installation tar file.
-| TRAF_USER | The Trafodion runtime user ID. | trafodion | Must be `trafodion` in this release.
+| REST_BUILD | Tar file containing the REST component. | None | Not needed if using a {project-name} package installation tar file.
+| SQ_ROOT | Target directory for the {project-name} software. | $HOME_DIR/trafodion | {project-name} is installed in this directory on all nodes in `$NODE_LIST`.
+| START | Whether to start {project-name} after install/upgrade. | N | Does not apply to Recipe-Based Provisioning.
+| SUSE_LINUX | Whether your installing {project-name} on SUSE Linux. | false | Auto-detected by the {project-name} Installer.
+| TRAF_PACKAGE | The location of the {project-name} installation package tar file or core installation tar file. | None | The package file contains the {project-name} server,
+DCS, and REST software while the core installation file contains the {project-name} server software only. If you're using a core installation file, then you need to
+record the location of the DCS and REST installation tar files, too. Normally, you perform {project-name} provisioning using a {project-name} package installation tar file.
+| TRAF_USER | The {project-name} runtime user ID. | trafodion | Must be `trafodion` in this release.
| TRAF_USER_PASSWORD | The password used for the `trafodion:trafodion` user ID. | traf123 | Must be 6-8 characters long.
| URL | FQDN and port for the Distribution Manager's REST API. | None | Include `http://` or `https://` as applicable. Specify in the form:
`<IP-address>:<port>` or `<node name>:<port>` Example: `https://susevm-1.yourcompany.local:8080`
|===
-1. The ID matches the environmental variables used in the Trafodion Installation configuration file. Refer to <<install-trafodion-installer,Trafodion Installer>>
+1. The ID matches the environmental variables used in the {project-name} Installation configuration file. Refer to <<install-trafodion-installer,{project-name} Installer>>
for more information.
2. Refer to <<enable-security,Enable Security>> for more information about these security settings.
@@ -182,11 +182,11 @@ for more information.
This step is required if you're:
-* Installing Trafodion on SUSE.
+* Installing {project-name} on SUSE.
* Using Recipe-Based Provisioning.
* Can't download the required software packages using the Internet.
-If none of these situations exist, then we highly recommend that you use the Trafodion Installer.
+If none of these situations exist, then we highly recommend that you use the {project-name} Installer.
You perform this step as a user with `root` or `sudo` access.
@@ -201,7 +201,7 @@ You perform this step as a user with `root` or `sudo` access.
This step is required regardless of the <<introduction-provisioning-options,Provisioning Options>> used.
-1. Download the log4c++ RPM from the Trafodion http://trafodion.incubator.apache.org/download.html[Download] page.
+1. Download the log4c++ RPM from the {project-name} {download-url}[Download] page.
2. Copy and Install the log4c++ RPM on All Nodes
+
@@ -231,16 +231,16 @@ log4cxx-0.10.0-13.el6.x86_64
```
[[prepare-download-trafodion-binaries]]
-== Download Trafodion Binaries
+== Download {project-name} Binaries
-You download the Trafodion binaries from the Trafodion http://trafodion.apache.org/download.html[Download] page.
+You download the {project-name} binaries from the {project-name} {download-url}[Download] page.
Download the following packages:
-* Trafodion Installer (if planning to use the Trafodion Installer)
-* Trafodion Server
+* {project-name} Installer (if planning to use the {project-name} Installer)
+* {project-name} Server
-NOTE: You can download and install the Trafodion Clients once you've installed and activated Trafodion. Refer to the
-http://trafodion.apache.org/docs/client_install/index.html[Trafodion Client Install Guide] for instructions.
+NOTE: You can download and install the {project-name} Clients once you've installed and activated {project-name}. Refer to the
+{docs-url}/client_install/index.html[{project-name} Client Install Guide] for instructions.
*Example*
@@ -249,7 +249,7 @@ http://apache.cs.utah.edu/incubator/celix/celix-1.0.0.incubating/celix-1.0.0.inc
```
$ mkdir $HOME/trafodion-download
$ cd $HOME/trafodion-download
-$ Download the Trafodion Installer binaries
+$ Download the {project-name} Installer binaries
$ wget http://apache.cs.utah.edu/incubator/trafodion/trafodion-1.3.0.incubating/apache-trafodion-installer-1.3.0-incubating-bin.tar.gz
Resolving http://apache.cs.utah.edu... 192.168.1.56
Connecting to http://apache.cs.utah.edu|192.168.1.56|:80... connected.
@@ -265,7 +265,7 @@ Saving to: "apache-trafodion-installer-1.3.0-incubating-bin.tar.gz"
<<<
```
-$ # Download the Trafodion Server binaries
+$ # Download the {project-name} Server binaries
$ wget http://apache.cs.utah.edu/incubator/trafodion/trafodion-1.3.0.incubating/apache-trafodion-1.3.0-incubating-bin.tar.gz
Resolving http://apache.cs.utah.edu... 192.168.1.56
Connecting to http://apache.cs.utah.edu|192.168.1.56|:80... connected.
@@ -287,12 +287,12 @@ $
[[prepare-preparation-for-recipe-based-provisioning]]
== Preparation for Recipe-Based Provisioning
-NOTE: This step should be skipped if you plan to use the Trafodion Installer
+NOTE: This step should be skipped if you plan to use the {project-name} Installer
[[prepare-modify-os-settings]]
=== Modify OS Settings
-Ensure that the `/etc/security/limits.d/trafodion.conf` on each node contains the limits settings required by Trafodion.
+Ensure that the `/etc/security/limits.d/trafodion.conf` on each node contains the limits settings required by {project-name}.
Refer to <<requirements-operating-system-changes,Operating System Changes>> for the required settings.
[[prepare-modify-zookeeper-configuration]]
http://git-wip-us.apache.org/repos/asf/incubator-trafodion/blob/21d6d8d3/docs/provisioning_guide/src/asciidoc/_chapters/requirements.adoc
----------------------------------------------------------------------
diff --git a/docs/provisioning_guide/src/asciidoc/_chapters/requirements.adoc b/docs/provisioning_guide/src/asciidoc/_chapters/requirements.adoc
index dd35865..9e6eed8 100644
--- a/docs/provisioning_guide/src/asciidoc/_chapters/requirements.adoc
+++ b/docs/provisioning_guide/src/asciidoc/_chapters/requirements.adoc
@@ -20,15 +20,15 @@
* under the License.
*
* @@@ END COPYRIGHT @@@
- */
+*/
////
[[requirements]]
= Requirements
-Trafodion requires an x86 version of Linux.
+{project-name} requires an x86 version of Linux.
-The current release of Trafodion has been tested with:
+The current release of {project-name} has been tested with:
* 64-bit Red Hat Enterprise Linux (RHEL) or CentOS 6.5, 6.6, and 6.7
* SUSE SLES 11.3
@@ -36,12 +36,12 @@ The current release of Trafodion has been tested with:
* Cloudera CDH 5.3
* Hortonworks HDP 2.2
-Other OS releases may work, too. The Trafodion project is currently working on better support for non-distribution version of Hadoop.
+Other OS releases may work, too. The {project-name} project is currently working on better support for non-distribution version of Hadoop.
[[requirements-general-cluster-and-os-requirements-and-recommendations]]
== General Cluster and OS Requirements and Recommendations
-64-bit x86 instruction set running a Linux distribution is required. Further, Trafodion assumes an environment
+64-bit x86 instruction set running a Linux distribution is required. Further, {project-name} assumes an environment
based on the requirements of the tested Hadoop distributions/services.
[[requirements-cluster-requirements-and-recommendations]]
@@ -49,15 +49,15 @@ based on the requirements of the tested Hadoop distributions/services.
[[requirements-single-node-cluster]]
==== Single-Node Cluster
-It is possible to run Trafodion on a single-node sandbox environment. Typically, any sandbox running a Hadoop distribution
+It is possible to run {project-name} on a single-node sandbox environment. Typically, any sandbox running a Hadoop distribution
can be used. A typical single-node configuration uses 4-8 cores with 16 GB of memory, and 20 GB free disk space.
[[requirements-multi-node-cluster]]
==== Multi-Node Cluster
-For multi-node end-user clusters, your typical HBase environment should suffice for Trafodion.
+For multi-node end-user clusters, your typical HBase environment should suffice for {project-name}.
Typically, memory configuration range between 64-128 GB per node with minimum requirement of 16 GB.
The cluster size can span from 1 to _n_ nodes; a minimum of two nodes is recommended.
-A minimum of two cores is required regardless of whether you're deploying Trafodion on a bare-metal or virtual environment.
+A minimum of two cores is required regardless of whether you're deploying {project-name} on a bare-metal or virtual environment.
<<<
Recommended configurations:
@@ -82,7 +82,7 @@ Recommended configurations:
[[requirements-os-requirements-and-recommendations]]
=== OS Requirements and Recommendations
-Please verify these requirements on each node you will install Trafodion on:
+Please verify these requirements on each node you will install {project-name} on:
[cols="20%a,40%a,40%a",options="header"]
|===
@@ -99,14 +99,14 @@ Please verify these requirements on each node you will install Trafodion on:
• `/etc/resolv.conf` is configured to use a name server. |
• `host -T <FQDN>` (responds if using a DNS server, times out otherwise) +
• Simply ssh among nodes using `ssh <FQDN>`.
-| Port Availability | The Linux Kernel Firewall (`iptables`) has either been disabled or <<ip-ports,ports required by Trafodion>> have been opened. |
+| Port Availability | The Linux Kernel Firewall (`iptables`) has either been disabled or <<ip-ports,ports required by {project-name}>> have been opened. |
• `lsmod \| grep ip_tables` checks whether `iptables` is loaded. If not, no further checking is needed. +
• `sudo iptables -nL \| grep <port>` checks the configuration of a port. An empty response indicates no rule for the port, which often means
the port is *not* open.
-| passwordless ssh | The user name used to provision Trafodion must have passwordless ssh access to all nodes. | ssh to the nodes, ensure that no password prompt appears.
-| sudo privileges | The user name used to provision Trafodion must sudo access to a number of root functions . | `sudo echo "test"` on each node.
+| passwordless ssh | The user name used to provision {project-name} must have passwordless ssh access to all nodes. | ssh to the nodes, ensure that no password prompt appears.
+| sudo privileges | The user name used to provision {project-name} must sudo access to a number of root functions . | `sudo echo "test"` on each node.
| bash | Available for shell-script execution. | `bash --version`
-| java | Available to run the Trafodion software. Same version as HBase is using. | `java --version`
+| java | Available to run the {project-name} software. Same version as HBase is using. | `java --version`
| perl | Available for script execution. | `perl --version`
| python | Available for script execution. | `python --version`
| yum | Available for installs, updates, and removal of software packages. | `yum --version`
@@ -121,16 +121,16 @@ the port is *not* open.
[[requirements-ip-ports]]
=== IP Ports
-The following table lists the default ports used by the different Trafodion components plus the configuration file and configuration attribute associated with each port setting.
+The following table lists the default ports used by the different {project-name} components plus the configuration file and configuration attribute associated with each port setting.
[cols="10%h,20%l,20%l,10%,5%,10%,25%",options="header"]
|===
| Default Port | Configuration File | Configuration Entry | Required | Range | Protocol | Comment
-| 4200 | rest-site.xml | trafodion.rest.port | Yes | 1 | REST | Trafodion REST Server.
-| 4201 | rest-site.xml | trafodion.rest.https.port | Yes | 1 | HTTPS | Trafodion REST Server (HTTPS).
-| 23400 | dcs-site.xml | dcs.master.port | Yes | _n_ | binary | Start of Trafodion DCS port range. (37800 for Trafodion 1.1)
-| 24400 | dcs-site.xml | dcs.master.info.port | Yes | 1 | HTTP | DCS master web GUI. (40010 for Trafodion 1.1)
-| 24410 | dcs-site.xml | dcs.server.info.port | Yes | _n_ | HTTP | Start of range for DCS server web GUIs. (40020 for Trafodion 1.1)
+| 4200 | rest-site.xml | trafodion.rest.port | Yes | 1 | REST | {project-name} REST Server.
+| 4201 | rest-site.xml | trafodion.rest.https.port | Yes | 1 | HTTPS | {project-name} REST Server (HTTPS).
+| 23400 | dcs-site.xml | dcs.master.port | Yes | _n_ | binary | Start of {project-name} DCS port range. (37800 for {project-name} 1.1)
+| 24400 | dcs-site.xml | dcs.master.info.port | Yes | 1 | HTTP | DCS master web GUI. (40010 for {project-name} 1.1)
+| 24410 | dcs-site.xml | dcs.server.info.port | Yes | _n_ | HTTP | Start of range for DCS server web GUIs. (40020 for {project-name} 1.1)
| 50030 | mapred-site.xml | mapred.job.tracker.http.address | No | 1 | HTTP | MapReduce Job Tracker web GUI.
| 50070 | hdfs-site.xml | dfs.http.address | No | 1 | HTTP | HDFS Name Node web GUI.
| 50075 | hdfs-site.xml | dfs.datanode.http.address | No | 1 | HTTP | HDFS Data Node web GUI.
@@ -139,7 +139,7 @@ The following table lists the default ports used by the different Trafodion comp
| 60030 | hbase-site.xml | hbase.regionserver.info.port | No | 1 | HTTP | HBase Region Server web GUI.
|===
-There are two port ranges used by Trafodion.
+There are two port ranges used by {project-name}.
* 23400 is a range, to allow multiple mxosrvr processes on each node. Allow a range of a few ports,
enough to cover all the servers per node that are listed in the "servers" file in the DCS configuration directory.
@@ -151,7 +151,7 @@ On top of the ports identified above, you also need the ports required by your H
* http://docs.hortonworks.com/HDPDocuments/HDP2/HDP-2.3.0-Win/bk_HDP_Install_Win/content/ref-79239257-778e-42a9-9059-d982d0c08885.1.html[_Hortonworks Ports_]
Although not all the ports will be used on every node of the cluster, you need to open most of them for all the nodes in the cluster that
-have Trafodion, HBase, or HDFS servers on them.
+have {project-name}, HBase, or HDFS servers on them.
[[requirements-prerequisite-software]]
== Prerequisite Software
@@ -159,8 +159,8 @@ have Trafodion, HBase, or HDFS servers on them.
[[requirements-hadoop-software]]
=== Hadoop Software
-Trafodion runs as an add-on service on Hadoop distributions. The following Hadoop services and their dependencies must be installed and running
-on the cluster where you intend to install Trafodion:
+{project-name} runs as an add-on service on Hadoop distributions. The following Hadoop services and their dependencies must be installed and running
+on the cluster where you intend to install {project-name}:
* Hadoop Distributed File System (HDFS)
* YARN with MapReduce version 2
@@ -169,7 +169,7 @@ on the cluster where you intend to install Trafodion:
* Hive
* Apache Ambari (Hortonworks) or Cloudera Manager (Cloudera) with associated embedded databases.
-The following distributions have been tested with Trafodion.^1^
+The following distributions have been tested with {project-name}.^1^
[cols="25%,15%,10%,50%",options="header"]
|===
@@ -179,22 +179,22 @@ http://www.cloudera.com/downloads/manager/5-3-0.html[CDH 5.3 Installation]^2^
| Hortonworks Data Platform (HDP) | 2.2 | 0.98 | http://hortonworks.com/products/releases/hdp-2-2/#install[HDP 2.2 Installation]
|===
-1. Future releases of Trafodion will move away from distribution-specific integration. Instead, Trafodion will be tested with
+1. Future releases of {project-name} will move away from distribution-specific integration. Instead, {project-name} will be tested with
specific version of the Hadoop, HDFS, HBase, and other services/products only.
2. When possible, install using *parcels* to simply the installation process.
-NOTE: Trafodion does not yet support installation on a non-distribution version of Hadoop; that is,
+NOTE: {project-name} does not yet support installation on a non-distribution version of Hadoop; that is,
Hadoop downloaded from the Apache web site. This restriction will be lifted in a later release of
-Trafodion.
+{project-name}.
[[requirements-software-packages]]
=== Software Packages
In addition to the software packages required to run different Hadoop services listed above (for example, `Java`),
-Trafodion requires supplementary software to be installed on the cluster before it is installed. These are Linux
+{project-name} requires supplementary software to be installed on the cluster before it is installed. These are Linux
tools that are not typically packaged as part of the core Linux distribution.
-NOTE: For RedHat/CentOS, the Trafodion Installer automatically attempts get a subset of these packages over the Internet.
+NOTE: For RedHat/CentOS, the {project-name} Installer automatically attempts get a subset of these packages over the Internet.
If the cluster's access to the Internet is disabled, then you need to manually download the packages and make them available
for installation. You need to build and install `log4c++` manually.
@@ -203,9 +203,9 @@ for installation. You need to build and install `log4c++` manually.
| Package | Usage | Installation
| EPEL | Add-on packages to completed the Linux distribution. | Download
http://download.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch[Fedora RPM]
-| pdsh | Parallelize shell commands during install and Trafodion runtime utilities. | yum install pdsh
+| pdsh | Parallelize shell commands during install and {project-name} runtime utilities. | yum install pdsh
| log4cxx | Message logging. | Manual process^1^
-| sqlite | Internal configuration information managed by the Trafodion Foundation component. | yum install sqlite
+| sqlite | Internal configuration information managed by the {project-name} Foundation component. | yum install sqlite
| expect | Not used? | yum install expect
| perl-DBD-SQLite | Allows Perl scripts to connect to SQLite. | yum install perl-DBD-SQLite
| perl-Params-Validate | Validates method/function parameters in Perl scripts. | yum install perl-Params-Validate
@@ -223,37 +223,37 @@ http://download.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch[Fedo
1. `log4c++` was recently withdrawn from public repositories. Therefore, you will need to build the `log4c++` RPM
on your system and then install the RPM using the procedure described in <<log4cplusplus_installation,log4c++ Installation>>.
-2. Software package required to build `log4c++`. Not required otherwise. These packages are *not* installed by the Trafodion Installer in this release.
+2. Software package required to build `log4c++`. Not required otherwise. These packages are *not* installed by the {project-name} Installer in this release.
-The Trafodion Installer requires Internet access to install the required software packages.
+The {project-name} Installer requires Internet access to install the required software packages.
[[requirements-trafodion-user-ids-and-their-privileges]]
-== Trafodion User IDs and Their Privileges
+== {project-name} User IDs and Their Privileges
[[requirements-trafodion-runtime-user]]
-=== Trafodion Runtime User
+=== {project-name} Runtime User
The `trafodion:trafodion` user ID is created as part of the installation process. The default password is: `traf123`.
-Trafodion requires that either HDFS ACL support or Kerberos is enabled. The Trafodion Installer will enable HDFS ACL support.
+{project-name} requires that either HDFS ACL support or Kerberos is enabled. The {project-name} Installer will enable HDFS ACL support.
Kerberos-based security settings are outside the scope of this guide. Please refer to the security information in
https://hbase.apache.org/book.html#security[Apache HBase(TM) Reference Guide] for information about how to set up
HBase security with Kerberos.
-Also, Trafodion requires `sudo` access to `ip` and `arping` so that floating or elastic IP addresses can be moved from one node to
+Also, {project-name} requires `sudo` access to `ip` and `arping` so that floating or elastic IP addresses can be moved from one node to
another in case of node failures.
-NOTE: Do *not* create the `trafodion:trafodion` user ID in advance. The Trafodion Installer uses the presence of this user ID to determine
+NOTE: Do *not* create the `trafodion:trafodion` user ID in advance. The {project-name} Installer uses the presence of this user ID to determine
whether you're doing an installation or upgrade.
[[requirements-trafodion-provisioning-user]]
-=== Trafodion Provisioning User
+=== {project-name} Provisioning User
-Typically, the Trafodion Installer is used for Trafodion installations. It requires access to the user IDs documented below.
+Typically, the {project-name} Installer is used for {project-name} installations. It requires access to the user IDs documented below.
[[requirements-linux-installation-user]]
==== Linux Installation User
-The user ID that performs the Trafodion installation steps. Typically, this User ID runs the Trafodion Installer.
+The user ID that performs the {project-name} installation steps. Typically, this User ID runs the {project-name} Installer.
*Requirements*:
@@ -265,7 +265,7 @@ The user ID that performs the Trafodion installation steps. Typically, this User
** Download and install software packages.
** Modify `/etc/sudoers.d` (allow the `trafodion` user to modify floating IP: `ip` and `arping`).
** Create the `trafodion` user ID and group.
-** Install Trafodion software into the HBase environment.
+** Install {project-name} software into the HBase environment.
** Run Java version command on each node in the cluster.
** Run Hadoop version command on each node in the cluster.
** Run HBase version command on each node in the cluster.
@@ -278,12 +278,12 @@ The user ID that performs the Trafodion installation steps. Typically, this User
*** Modify kernel limits.
*** Reserve IP ports.
-^1^ `sudo` is *required* in the current release of Trafodion. This restriction may be relaxed in later releases.
+^1^ `sudo` is *required* in the current release of {project-name}. This restriction may be relaxed in later releases.
Alternative mechanisms for privileged access (such as running as `root` or `sudo` alternative commands) are not supported.
[[requirements-distribution-manager-user]]
==== Distribution Manager User
-A user ID that can change the configuration using Apache Ambari or Cloudera Manager. The Trafodion Installer makes REST
+A user ID that can change the configuration using Apache Ambari or Cloudera Manager. The {project-name} Installer makes REST
request to perform configuration and control functions to the distribution manager using this user ID.
*Requirements*:
@@ -294,7 +294,7 @@ request to perform configuration and control functions to the distribution manag
[[requirements-hdfs-administrator-user]]
==== HDFS Administrator User
The HDFS super user. Required to create directories and change security settings, as needed.
-The Trafodion Installer uses `su` to run commands under this user ID.
+The {project-name} Installer uses `su` to run commands under this user ID.
*Requirements*:
@@ -313,9 +313,9 @@ The HBase super user. Required to change directory ownership in HDFS.
[[requirements-required-configuration-changes]]
== Required Configuration Changes
-Trafodion requires changes to a number of different areas of your system configuration: operating system, HDFS, and HBase.
+{project-name} requires changes to a number of different areas of your system configuration: operating system, HDFS, and HBase.
-NOTE: These changes are performed by the Trafodion Installer, if used.
+NOTE: These changes are performed by the {project-name} Installer, if used.
[[requirements-operating-system-changes]]
=== Operating System Changes
@@ -323,7 +323,7 @@ NOTE: These changes are performed by the Trafodion Installer, if used.
`/etc/security/limits.d/trafodion.conf` on each node in the cluster must contain the following settings:
```
-# Trafodion settings
+# {project-name} settings
trafodion soft core unlimited
trafodion hard core unlimited
trafodion soft memlock unlimited
@@ -343,12 +343,12 @@ trafodion hard nofile 65535
NOTE: These changes require a restart of ZooKeeper on all nodes in the cluster.
-Trafodion requires the following changes to `zoo.cfg`:
+{project-name} requires the following changes to `zoo.cfg`:
[cols="30%l,40%l,30%a",options="header"]
|===
| Setting | New Value | Purpose
-| maxClientCnxns | 0 | Tell ZooKeeper to impose no limit to the number of connections to enable better Trafodion concurrency.
+| maxClientCnxns | 0 | Tell ZooKeeper to impose no limit to the number of connections to enable better {project-name} concurrency.
|===
[[requirements-hdfs-changes]]
@@ -356,7 +356,7 @@ Trafodion requires the following changes to `zoo.cfg`:
NOTE: These changes require a restart of HDFS on all nodes in the cluster.
-Trafodion requires the following changes to the HDFS environment:
+{project-name} requires the following changes to the HDFS environment:
[cols="60%a,40%a",options="header"]
|===
@@ -364,8 +364,8 @@ Trafodion requires the following changes to the HDFS environment:
| • Create `/hbase-staging` directory. +
• Change owner to HBase Administrator. |
| • Create `/bulkload` directory. +
- • Change owner to `trafodion`. | Used to stage data when processing the Trafodion
-http://trafodion.apache.org/docs/sql_reference/index.html#load_statement[LOAD INTO table]
+ • Change owner to `trafodion`. | Used to stage data when processing the {project-name}
+{docs-url}/sql_reference/index.html#load_statement[LOAD INTO table]
statement and as a temporary directory to create links to actual HFile for snapshot scanning.
| • Create `/lobs` directory. +
• Change owner to `trafodion`. |
@@ -391,16 +391,16 @@ The following changes are required in `hdfs-site.xml`:
NOTE: These changes require a restart of ZooKeeper and HBase on all nodes in the cluster.
-Trafodion requires that the following changes to the HBase environment:
+{project-name} requires that the following changes to the HBase environment:
[cols="25%a,40%a,35%a",options="header"]
|===
| Action | Affected Directories | Purpose
-| Install/replace Trafodion's version of `hbase-trx` | • `/usr/lib/hbase/lib/` +
+| Install/replace {project-name}'s version of `hbase-trx` | • `/usr/lib/hbase/lib/` +
• `/usr/share/cmf/lib/plugins/` (Cloudera) +
• `/usr/hdp/current/hbase-regionserver/lib/` (Hortonworks) |
-Trafodion transaction management relies on an enhanced version of `hbase-trx`.
-| Install/Replace Trafodion utility jar file. | • `/usr/lib/hbase/lib/` +
+{project-name} transaction management relies on an enhanced version of `hbase-trx`.
+| Install/Replace {project-name} utility jar file. | • `/usr/lib/hbase/lib/` +
• `/usr/share/cmf/lib/plugins/` (Cloudera) +
• `/usr/hdp/current/hbase-regionserver/lib` (Hortonworks) |
TODO: Add purpose here.
@@ -424,10 +424,10 @@ hbase.coprocessor.
transactional.TrxRegionEndpoint,
org.apache.hadoop.
hbase.coprocessor.
-AggregateImplementation | Install Trafodion coprocessor classes.
+AggregateImplementation | Install {project-name} coprocessor classes.
| hbase.hregion.impl | org.apache.hadoop.
hbase.regionserver.
-transactional.TransactionalRegion | Trafodion needs to be able to read the Write Ahead Log from a coprocessor using the getScanner method. This method
+transactional.TransactionalRegion | {project-name} needs to be able to read the Write Ahead Log from a coprocessor using the getScanner method. This method
is protected in standard HBase. This change overloads the getScanner method to be public thereby allowing coprocessor code to use it.
| hbase.regionserver.
region.split.policy | org.apache.hadoop.
@@ -435,7 +435,7 @@ hbase.regionserver.
ConstantSizeRegionSplitPolicy | Tell HBase to use the ConstantSizeRegionSplitPolicy for region splitting.
This setting causes region splitting to occur only when the maximum file size is reached.
| hbase.snapshot.
-enabled | true | Enable the HBase Snapshot feature. Used for Trafodion backup and restore.
+enabled | true | Enable the HBase Snapshot feature. Used for {project-name} backup and restore.
| hbase.bulkload.
staging.dir | hbase-staging | Use `/hbase-staging` as the bulk load staging directory.
| hbase.regionserver.region.
@@ -460,7 +460,7 @@ java.heapsize^1^ | 1073741824 (1GB) | Java Heap Size for the HDFS Secondary Name
== Recommended Configuration Changes
The following configuration changes are recommended but not required.
-NOTE: The Trafodion Installer does *not* make these changes.
+NOTE: The {project-name} Installer does *not* make these changes.
[[requirements-recommended-security-changes]]
=== Recommended Security Changes
@@ -499,7 +499,7 @@ from this setting. The underlying issue is the length of the execution of the co
+
NOTE: HBase uses the smaller of `hbase.rpc.timeout` and `hbase.client.scanner.timeout.period` to calculate the scanner timeout.
| hbase.snapshot.master.timeoutMillis and hbase.snapshot.region.timeout | 10 minutes | HBase's default setting is 60000 milliseconds.
-If you experience timeout issues with HBase snapshots when you use the Trafodion Bulk Loader or other statements,
+If you experience timeout issues with HBase snapshots when you use the {project-name} Bulk Loader or other statements,
you can set the value for these two HBase properties to 10 minutes (600,000 milliseconds).
| hbase.hregion.max.filesize | 107374182400 bytes | HBase's default setting is 10737418240 (10 GB). We have increased the setting to
107374182400 (100 GB), which reduces the number of HStoreFiles per table and appears to reduce disruptions to active transactions from
http://git-wip-us.apache.org/repos/asf/incubator-trafodion/blob/21d6d8d3/docs/provisioning_guide/src/asciidoc/_chapters/script_install.adoc
----------------------------------------------------------------------
diff --git a/docs/provisioning_guide/src/asciidoc/_chapters/script_install.adoc b/docs/provisioning_guide/src/asciidoc/_chapters/script_install.adoc
index cde5718..44afd49 100644
--- a/docs/provisioning_guide/src/asciidoc/_chapters/script_install.adoc
+++ b/docs/provisioning_guide/src/asciidoc/_chapters/script_install.adoc
@@ -20,26 +20,26 @@
* under the License.
*
* @@@ END COPYRIGHT @@@
- */
+*/
////
[[install]]
= Install
-This chapter describes how to use the Trafodion Installer to install Trafodion. You use the Trafodion Provisioning ID
-to run the Trafodion Installer.
+This chapter describes how to use the {project-name} Installer to install {project-name}. You use the {project-name} Provisioning ID
+to run the {project-name} Installer.
-NOTE: You *must* install log4c++ on all nodes in the cluster prior to running the Trafodion Installer. Refer
+NOTE: Prior to version 2.0.0, you *must* install log4c++ on all nodes in the cluster prior to running the {project-name} Installer. Refer
to <<prepare-build-and-install-log4cplusplus,Build and Install log4c++>> for instructions.
[[install-unpack-installer]]
== Unpack Installer
-You should already have downloaded the Trafodion Binaries per the instructions in the
-<<prepare-download-trafodion-binaries,Download Trafodion Binaries>> in the <<prepare,Prepare>>
+You should already have downloaded the {project-name} Binaries per the instructions in the
+<<prepare-download-trafodion-binaries,Download {project-name} Binaries>> in the <<prepare,Prepare>>
chapter. If not, please do so now.
-The first step in the installation process is to unpack the Trafodion Installer tar file.
+The first step in the installation process is to unpack the {project-name} Installer tar file.
*Example*
@@ -59,20 +59,20 @@ $
[[install-automated-install]]
== Automated Install
-The `--config_file` option runs the Trafodion in Automated Setup mode. Refer to <<introduction-trafodion-installer,Trafodion Installer>>
+The `--config_file` option runs the {project-name} in Automated Setup mode. Refer to <<introduction-trafodion-installer,{project-name} Installer>>
in the <<introduction,Introduction>> chapter for instructions of how you edit your configuration file.
Edit your config file using the information you collected in the <<prepare-gather-configuration-information,Gather Configuration Information>>
step in the <<prepare,Prepare>> chapter.
-The following example shows an automated install of Trafodion on a two-node Hortonworks Hadoop cluster.
+The following example shows an automated install of {project-name} on a two-node Hortonworks Hadoop cluster.
-NOTE: By default, the Trafodion Installer invokes `sqlci` so that you can enter the `initialize trafodion;` command.
+NOTE: By default, the {project-name} Installer invokes `sqlci` so that you can enter the `initialize trafodion;` command.
This is shown in the example below.
*Example*
-1. Run the Trafodion Installer in Automated Setup mode.
+1. Run the {project-name} Installer in Automated Setup mode.
+
```
$ cd $HOME/trafodion-installer/installer
@@ -87,7 +87,7 @@ $ ./trafodion_install --config_file my
***INFO: Working directory: /usr/lib/trafodion
************************************
- Trafodion Configuration File Check
+ {project-name} Configuration File Check
************************************
@@ -103,14 +103,14 @@ $ ./trafodion_install --config_file my
***INFO: Testing sudo access on trafodion-1
***INFO: Testing sudo access on trafodion-2
***DEBUG: trafodionFullName=trafodion_server-1.3.0.tgz
-***INFO: Trafodion version = 1.3.0
+***INFO: {project-name} version = 1.3.0
***DEBUG: HBase's java_exec=/usr/jdk64/jdk1.7.0_67/bin/java
******************************
TRAFODION SETUP
******************************
-***INFO: Starting Trafodion environment setup (2016-02-16-21-12-31)
+***INFO: Starting {project-name} environment setup (2016-02-16-21-12-31)
=== 2016-02-16-21-12-31 ===
# @@@ START COPYRIGHT @@@
#
@@ -142,7 +142,7 @@ BY TYPING "ACCEPT" YOU AGREE TO THE TERMS OF THIS AGREEMENT: ***INFO: testing su
trafodion-1
trafodion-2
***INFO: Total number of nodes = 2
-***INFO: Starting Trafodion Package Setup (2016-02-16-21-12-35)
+***INFO: Starting {project-name} Package Setup (2016-02-16-21-12-35)
***INFO: Installing required packages
***INFO: Log file located in /var/log/trafodion
***INFO: ... EPEL rpm
@@ -155,7 +155,7 @@ trafodion-2
.
.
***INFO: trafodion user added successfully
-***INFO: Trafodion environment setup completed
+***INFO: {project-name} environment setup completed
***INFO: creating sqconfig file
***INFO: Reserving DCS ports
@@ -194,7 +194,7 @@ You can monitor the SQ shell log file : /home/trafodion/apache-trafodion-1.3.0-i
Startup time 0 hour(s) 1 minute(s) 9 second(s)
-Apache Trafodion Conversational Interface 1.3.0
+Apache {project-name} Conversational Interface 1.3.0
Copyright (c) 2015 Apache Software Foundation
>> initialize trafodion;
--- SQL operation complete.
@@ -211,7 +211,7 @@ End of MXCI Session
$
```
-2. Switch to the Trafodion Runtime User and check the status of Trafodion.
+2. Switch to the {project-name} Runtime User and check the status of {project-name}.
+
*Example*
+
@@ -233,24 +233,24 @@ MXOSRVR 8 8
$
```
-Trafodion is now running on your Hadoop cluster. Please refer to the <<activate,Activate>> chapter for
-basic instructions on how to verify the Trafodion management and how to perform basic management
+{project-name} is now running on your Hadoop cluster. Please refer to the <<activate,Activate>> chapter for
+basic instructions on how to verify the {project-name} management and how to perform basic management
operations.
[[install-guided-install]]
== Guided Install
-The Trafodion Installer prompts you for the information you collected in the
+The {project-name} Installer prompts you for the information you collected in the
<<prepare-gather-configuration-information, Gather Configuration Information>> step in the <<prepare,Prepare>> chapter.
-The following example shows a guided install of Trafodion on a two-node Cloudera Hadoop cluster.
+The following example shows a guided install of {project-name} on a two-node Cloudera Hadoop cluster.
-NOTE: By default, the Trafodion Installer invokes `sqlci` so that you can enter the `initialize trafodion;` command.
+NOTE: By default, the {project-name} Installer invokes `sqlci` so that you can enter the `initialize trafodion;` command.
This is shown in the example below.
*Example*
-1. Run the Trafodion Installer in guided mode.
+1. Run the {project-name} Installer in guided mode.
+
```
$ cd $HOME/trafodion-installer/installer
@@ -266,14 +266,14 @@ $ ./trafodion_install
***INFO: Working directory: /usr/lib/trafodion
*******************************
- Trafodion Configuration Setup
+ {project-name} Configuration Setup
*******************************
***INFO: Please press [Enter] to select defaults.
Enter trafodion password, default is [traf123]: traf123
Enter list of nodes (blank separated), default []: trafodion-1 trafodion-2
-Enter Trafodion userid's home directory prefix, default is [/home]: /home
+Enter {project-name} userid's home directory prefix, default is [/home]: /home
Specify full path to EPEL RPM (including .rpm), default is None:
***INFO: Will attempt to download RPM if EPEL is not installed on all nodes.
Specify location of Java 1.7.0_65 or higher (JDK), default is []: /usr/java/jdk1.7.0_67-cloudera
@@ -288,10 +288,10 @@ Enter directory to install trafodion to, default is [/home/trafodion/apache-traf
Total number of client connections per node, default [16]: 8
Enable simple LDAP security (Y/N), default is N: N
***INFO: Configuration file: /etc/trafodion/trafodion_config
-***INFO: Trafodion configuration setup complete
+***INFO: {project-name} configuration setup complete
************************************
- Trafodion Configuration File Check
+ {project-name} Configuration File Check
************************************
@@ -310,14 +310,14 @@ Are you sure you want to continue connecting (yes/no)? yes
***INFO: Testing sudo access on trafodion-1
***INFO: Testing sudo access on trafodion-2
***DEBUG: trafodionFullName=trafodion_server-1.3.0.tgz
-***INFO: Trafodion version = 1.3.0
+***INFO: {project-name} version = 1.3.0
***DEBUG: HBase's java_exec=/usr/java/jdk1.7.0_67-cloudera/bin/java
******************************
TRAFODION SETUP
******************************
-***INFO: Starting Trafodion environment setup (2016-02-15-07-09-58)
+***INFO: Starting {project-name} environment setup (2016-02-15-07-09-58)
=== 2016-02-15-07-09-58 ===
# @@@ START COPYRIGHT @@@
#
@@ -344,7 +344,7 @@ BY TYPING "ACCEPT" YOU AGREE TO THE TERMS OF THIS AGREEMENT:ACCEPT
trafodion-1
trafodion-2
***INFO: Total number of nodes = 2
-***INFO: Starting Trafodion Package Setup (2016-02-15-07-11-09)
+***INFO: Starting {project-name} Package Setup (2016-02-15-07-11-09)
***INFO: Installing required packages
***INFO: Log file located in /var/log/trafodion
***INFO: ... pdsh on node trafodion-1
@@ -357,8 +357,8 @@ trafodion-2
.
.
***INFO: modifying limits in /usr/lib/trafodion/trafodion.conf on all nodes
-***INFO: create Trafodion userid "trafodion"
-***INFO: Trafodion userid's (trafodion) home directory: /home/trafodion
+***INFO: create {project-name} userid "trafodion"
+***INFO: {project-name} userid's (trafodion) home directory: /home/trafodion
***INFO: testing sudo access
Generating public/private rsa key pair.
Created directory '/home/trafodion/.ssh'.
@@ -384,7 +384,7 @@ The key's randomart image is:
trafodion-1
trafodion-2
***INFO: trafodion user added successfully
-***INFO: Trafodion environment setup completed
+***INFO: {project-name} environment setup completed
***INFO: creating sqconfig file
***INFO: Reserving DCS ports
@@ -407,7 +407,7 @@ trafodion-2
***INFO: waiting for HDFS to exit safemode
Safe mode is OFF
***INFO: Setting HDFS ACLs for snapshot scan support
-***INFO: Trafodion Mods ran successfully.
+***INFO: {project-name} Mods ran successfully.
******************************
TRAFODION START
@@ -442,7 +442,7 @@ Creating folders for storing certificates
***INFO: copying /home/trafodion/sqcert directory to all nodes
***INFO: copying install to all nodes
-***INFO: starting Trafodion instance
+***INFO: starting {project-name} instance
Checking orphan processes.
Removing old mpijob* files from /home/trafodion/apache-trafodion-1.3.0-incubating-bin/tmp
@@ -468,7 +468,7 @@ You can monitor the SQ shell log file : /home/trafodion/apache-trafodion-1.3.0-i
Startup time 0 hour(s) 1 minute(s) 9 second(s)
-Apache Trafodion Conversational Interface 1.3.0
+Apache {project-name} Conversational Interface 1.3.0
Copyright (c) 2015 Apache Software Foundation
>> initialize trafodion;
--- SQL operation complete.
@@ -485,7 +485,7 @@ End of MXCI Session
$
```
-2. Switch to the Trafodion Runtime User and check the status of Trafodion.
+2. Switch to the {project-name} Runtime User and check the status of {project-name}.
+
```
$ sudo su - trafodion
@@ -505,7 +505,7 @@ MXOSRVR 8 8
$
```
-Trafodion is now running on your Hadoop cluster. Please refer to the <<activate,Activate>> chapter for
-basic instructions on how to verify the Trafodion management and how to perform basic management
+{project-name} is now running on your Hadoop cluster. Please refer to the <<activate,Activate>> chapter for
+basic instructions on how to verify the {project-name} management and how to perform basic management
operations.
http://git-wip-us.apache.org/repos/asf/incubator-trafodion/blob/21d6d8d3/docs/provisioning_guide/src/asciidoc/_chapters/script_remove.adoc
----------------------------------------------------------------------
diff --git a/docs/provisioning_guide/src/asciidoc/_chapters/script_remove.adoc b/docs/provisioning_guide/src/asciidoc/_chapters/script_remove.adoc
index 275592d..0491f3a 100644
--- a/docs/provisioning_guide/src/asciidoc/_chapters/script_remove.adoc
+++ b/docs/provisioning_guide/src/asciidoc/_chapters/script_remove.adoc
@@ -20,19 +20,19 @@
* under the License.
*
* @@@ END COPYRIGHT @@@
- */
+*/
////
[[remove]]
= Remove
-You use the Trafodion Provisioning User for these instructions.
+You use the {project-name} Provisioning User for these instructions.
-NOTE: You do not need to use the `trafodion_uninstaller` script if upgrading Trafodion. Instead, use the `trafodion_install` script,
-which automatically upgrades the version of Trafodion. Please refer to the <<install,Install>> chapter for further instructions.
+NOTE: You do not need to use the `trafodion_uninstaller` script if upgrading {project-name}. Instead, use the `trafodion_install` script,
+which automatically upgrades the version of {project-name}. Please refer to the <<install,Install>> chapter for further instructions.
-Run the commands from the first node of the cluster. Do not run them from a machine that is not part of the Trafodion cluster.
+Run the commands from the first node of the cluster. Do not run them from a machine that is not part of the {project-name} cluster.
-== Stop Trafodion
+== Stop {project-name}
Do the following:
@@ -86,17 +86,17 @@ Mon Feb 15 07:49:26 UTC 2016
== Run `trafodion_uninstaller`
-The `trafodion_uninstaller` completely removes Trafodion.
+The `trafodion_uninstaller` completely removes {project-name}.
*Example*
```
[admin@trafodion-1 ~]$ cd $HOME/trafodion-installer/installer
[admin@trafodion-1 installer]$ ./trafodion_uninstaller
-Do you want to uninstall Trafodion (Everything will be removed)? (Y/N) y
+Do you want to uninstall {project-name} (Everything will be removed)? (Y/N) y
***INFO: testing sudo access
***INFO: NOTE, rpms that were installed will not be removed.
-***INFO: stopping Trafodion instance
+***INFO: stopping {project-name} instance
SQ environment is not up.
Going to execute ckillall
@@ -109,10 +109,10 @@ pdsh@trafodion-1: trafodion-1: ssh exited with exit code 1
pdsh@trafodion-1: trafodion-2: ssh exited with exit code 1
pdsh@trafodion-1: trafodion-1: ssh exited with exit code 1
pdsh@trafodion-1: trafodion-2: ssh exited with exit code 1
-***INFO remove the Trafodion userid and group
+***INFO remove the {project-name} userid and group
***INFO: removing all files from /home/trafodion/apache-trafodion-1.3.0-incubating-bin
***INFO: removing all files from /usr/lib/trafodion and /var/log/trafodion
***INFO: removing all files from /etc/trafodion
-***INFO: Trafodion uninstall complete.
+***INFO: {project-name} uninstall complete.
[admin@trafodion-1 installer]$
```
http://git-wip-us.apache.org/repos/asf/incubator-trafodion/blob/21d6d8d3/docs/provisioning_guide/src/asciidoc/_chapters/script_upgrade.adoc
----------------------------------------------------------------------
diff --git a/docs/provisioning_guide/src/asciidoc/_chapters/script_upgrade.adoc b/docs/provisioning_guide/src/asciidoc/_chapters/script_upgrade.adoc
index 0d27a08..a79fa51 100644
--- a/docs/provisioning_guide/src/asciidoc/_chapters/script_upgrade.adoc
+++ b/docs/provisioning_guide/src/asciidoc/_chapters/script_upgrade.adoc
@@ -20,35 +20,35 @@
* under the License.
*
* @@@ END COPYRIGHT @@@
- */
+*/
////
[[upgrade]]
= Upgrade
-This chapter describes how to use the Trafodion Installer to upgrade Trafodion. You use the Trafodion Provisioning ID
-to run the Trafodion Installer.
+This chapter describes how to use the {project-name} Installer to upgrade {project-name}. You use the {project-name} Provisioning ID
+to run the {project-name} Installer.
[[upgraded-download-updated-trafodion-binaries]]
-== Download Updated Trafodion Binaries
+== Download Updated {project-name} Binaries
-You perform this step as the Trafodion Provisioning User.
+You perform this step as the {project-name} Provisioning User.
-You download the updated Trafodion binaries from the Trafodion http://trafodion.apache.org/download.html[Download] page.
+You download the updated {project-name} binaries from the {project-name} {download-url}[Download] page.
Download the following packages:
-* Trafodion Installer (if planning to use the Trafodion Installer)
-* Trafodion Server
+* {project-name} Installer (if planning to use the {project-name} Installer)
+* {project-name} Server
-Refer to <<prepare-download-trafodion-binaries, Download Trafodion Binaries>> in the <<prepare,Prepare>> chapter for examples.
+Refer to <<prepare-download-trafodion-binaries, Download {project-name} Binaries>> in the <<prepare,Prepare>> chapter for examples.
[[upgrade-unpack-installer]]
== Unpack Installer
-You perform this step as the Trafodion Provisioning User.
+You perform this step as the {project-name} Provisioning User.
-You unpack the updated Trafodion Installer into a new directory.
+You unpack the updated {project-name} Installer into a new directory.
*Example*
@@ -66,8 +66,8 @@ $
```
[[upgrade-stop-tradodion]]
-== Stop Trafodion
-You perform this step as the Trafodion Runtime User.
+== Stop {project-name}
+You perform this step as the {project-name} Runtime User.
*Example*
@@ -85,7 +85,7 @@ stopped $zlobsrv1
Shutting down (normal) the SQ environment!
Wed Feb 17 05:12:40 UTC 2016
Processing cluster.conf on local host trafodion-1
-[$Z000KAE] Shell/shell Version 1.0.1 Apache_Trafodion Release 1.3.0 (Build release [1.3.0-0-g5af956f_Bld2], date 20160112_1927)
+[$Z000KAE] Shell/shell Version 1.0.1 Apache_{project-name} Release 1.3.0 (Build release [1.3.0-0-g5af956f_Bld2], date 20160112_1927)
ps
```
@@ -132,9 +132,9 @@ $
[[upgrade-automated-upgrade]]
== Automated Upgrade
-You perform this step as the Trafodion Provisioning User.
+You perform this step as the {project-name} Provisioning User.
-The `--config_file` option runs the Trafodion in Automated Setup mode. Refer to <<introduction-trafodion-installer,Trafodion Installer>>
+The `--config_file` option runs the {project-name} in Automated Setup mode. Refer to <<introduction-trafodion-installer,{project-name} Installer>>
in the <<introduction,Introduction>> chapter for instructions of how you edit your configuration file.
At a minimum, you need to change the following settings:
@@ -163,15 +163,15 @@ export TRAF_PACKAGE="/home/centos/trafodion-download/apache-trafodion-2.0.0-incu
export SQ_ROOT="/home/trafodion/apache-trafodion-2.0.0-incubating-bin"
```
-The following example shows an upgrade of Trafodion on a two-node Hortonworks Hadoop cluster using
+The following example shows an upgrade of {project-name} on a two-node Hortonworks Hadoop cluster using
Automated Setup mode.
-NOTE: The Trafodion Installer performs the same configuration changes as it does for an installation,
+NOTE: The {project-name} Installer performs the same configuration changes as it does for an installation,
including restarting Hadoop services.
*Example*
-1. Run the updated Trafodion Installer using the modified my_config_2.0 file.
+1. Run the updated {project-name} Installer using the modified my_config_2.0 file.
+
```
$ cd $HOME/trafodion-installer-2.0/installer
@@ -191,9 +191,9 @@ $ ./trafodion_install --config_file $HOME/trafodion-configuration/my_config_2.0
***INFO: Testing ssh on trafodion-2
***INFO: Testing sudo access on trafodion-1
***INFO: Testing sudo access on trafodion-2
-***INFO: Trafodion scanner will not be run.
+***INFO: {project-name} scanner will not be run.
***DEBUG: trafodionFullName=trafodion_server-2.0.0.tgz
-***INFO: Trafodion version = 2.0.0
+***INFO: {project-name} version = 2.0.0
***DEBUG: HBase's java_exec=/usr/jdk64/jdk1.7.0_67/bin/java
******************************
@@ -201,7 +201,7 @@ $ ./trafodion_install --config_file $HOME/trafodion-configuration/my_config_2.0
******************************
***INFO: Installing required RPM packages
-***INFO: Starting Trafodion Package Setup (2016-02-17-05-33-29)
+***INFO: Starting {project-name} Package Setup (2016-02-17-05-33-29)
***INFO: Installing required packages
***INFO: Log file located in /var/log/trafodion
***INFO: ... pdsh on node trafodion-1
@@ -223,7 +223,7 @@ You can monitor the SQ shell log file : /home/trafodion/apache-trafodion-2.0.0-i
Startup time 0 hour(s) 1 minute(s) 9 second(s)
-Apache Trafodion Conversational Interface 1.3.0
+Apache {project-name} Conversational Interface 1.3.0
Copyright (c) 2015 Apache Software Foundation
>>Metadata Upgrade: started
@@ -248,7 +248,7 @@ End of MXCI Session
$
```
-2. Switch to the Trafodion Runtime User and check the status of Trafodion.
+2. Switch to the {project-name} Runtime User and check the status of {project-name}.
+
```
$ sudo su - trafodion
@@ -268,17 +268,17 @@ MXOSRVR 8 8
$
```
-Trafodion is now running on your Hadoop cluster. Please refer to the <<activate,Activate>> chapter for
-basic instructions on how to verify the Trafodion management and how to perform basic management
+{project-name} is now running on your Hadoop cluster. Please refer to the <<activate,Activate>> chapter for
+basic instructions on how to verify the {project-name} management and how to perform basic management
operations.
<<<
[[upgrade-guided-upgrade]]
== Guided Upgrade
-You perform this step as the Trafodion Provisioning User.
+You perform this step as the {project-name} Provisioning User.
-As in the case with an installation, the Trafodion Installer prompts you for the information you collected in the
+As in the case with an installation, the {project-name} Installer prompts you for the information you collected in the
<<prepare-gather-configuration-information, Gather Configuration Information>> step in the <<prepare,Prepare>> chapter.
Some of the prompts are populated with the current values.
@@ -287,11 +287,11 @@ export TRAF_PACKAGE="/home/centos/trafodion-download/apache-trafodion-1.3.0-incu
export SQ_ROOT="/home/trafodion/apache-trafodion-1.3.0-incubating-bin"
-The following example shows a guided upgrade of Trafodion on a two-node Cloudera Hadoop cluster.
+The following example shows a guided upgrade of {project-name} on a two-node Cloudera Hadoop cluster.
*Example*
-1. Run the updated Trafodion Installer in Guided Setup mode to perform the upgrade. Change information
+1. Run the updated {project-name} Installer in Guided Setup mode to perform the upgrade. Change information
at prompts as applicable.
+
```
@@ -307,7 +307,7 @@ $ ./trafodion_install
***INFO: Working directory: /usr/lib/trafodion
*******************************
- Trafodion Configuration Setup
+ {project-name} Configuration Setup
*******************************
***INFO: Please press [Enter] to select defaults.
@@ -323,14 +323,14 @@ Enter HDFS username, default is [hdfs]:
Enter HBase username, default is [hbase]:
Enter HBase group, default is [hbase]:
Enter directory to install trafodion to, default is [/home/trafodion/apache-trafodion-1.3.0-incubating-bin]: /home/centos/apache-trafodion-2.0.0-incubating-bin
-Start Trafodion after install (Y/N), default is Y:
+Start {project-name} after install (Y/N), default is Y:
Total number of client connections per node, default [16]: 8
Enable simple LDAP security (Y/N), default is N:
***INFO: Configuration file: /etc/trafodion/trafodion_config
-***INFO: Trafodion configuration setup complete
+***INFO: {project-name} configuration setup complete
************************************
- Trafodion Configuration File Check
+ {project-name} Configuration File Check
************************************
@@ -348,9 +348,9 @@ Enable simple LDAP security (Y/N), default is N:
***INFO: Checking cloudera Version
***INFO: nameOfVersion=cdh5.3.0
***INFO: HADOOP_PATH=/usr/lib/hbase/lib
-***INFO: Trafodion scanner will not be run.
+***INFO: {project-name} scanner will not be run.
***DEBUG: trafodionFullName=trafodion_server-1.3.0.tgz
-***INFO: Trafodion version = 1.3.0
+***INFO: {project-name} version = 1.3.0
***DEBUG: HBase's java_exec=/usr/java/jdk1.7.0_67-cloudera/bin/java
******************************
@@ -358,7 +358,7 @@ Enable simple LDAP security (Y/N), default is N:
******************************
***INFO: Installing required RPM packages
-***INFO: Starting Trafodion Package Setup (2016-02-17-08-16-11)
+***INFO: Starting {project-name} Package Setup (2016-02-17-08-16-11)
***INFO: Installing required packages
***INFO: Log file located in /var/log/trafodion
***INFO: ... pdsh on node trafodion-1
@@ -400,7 +400,7 @@ You can monitor the SQ shell log file : /home/trafodion/apache-trafodion-2.0.0-i
Startup time 0 hour(s) 1 minute(s) 9 second(s)
-Apache Trafodion Conversational Interface 1.3.0
+Apache {project-name} Conversational Interface 1.3.0
Copyright (c) 2015 Apache Software Foundation
>>
@@ -415,7 +415,7 @@ End of MXCI Session
$
```
-2. Switch to the Trafodion Runtime User and check the status of Trafodion.
+2. Switch to the {project-name} Runtime User and check the status of {project-name}.
+
```
$ sudo su - trafodion
@@ -435,8 +435,8 @@ MXOSRVR 8 8
$
```
-Trafodion is now running on your Hadoop cluster. Please refer to the <<activate,Activate>> chapter for
-basic instructions on how to verify the Trafodion management and how to perform basic management
+{project-name} is now running on your Hadoop cluster. Please refer to the <<activate,Activate>> chapter for
+basic instructions on how to verify the {project-name} management and how to perform basic management
operations.
http://git-wip-us.apache.org/repos/asf/incubator-trafodion/blob/21d6d8d3/docs/provisioning_guide/src/asciidoc/index.adoc
----------------------------------------------------------------------
diff --git a/docs/provisioning_guide/src/asciidoc/index.adoc b/docs/provisioning_guide/src/asciidoc/index.adoc
index 0cf21ce..0e87035 100644
--- a/docs/provisioning_guide/src/asciidoc/index.adoc
+++ b/docs/provisioning_guide/src/asciidoc/index.adoc
@@ -32,7 +32,8 @@
:experimental:
:source-language: text
:revnumber: {project-version}
-:title-logo-image: ../../../shared/trafodion-logo.jpg
+:title-logo-image: {project-logo}
+:project-name: {project-name}
:images: ../images
:leveloffset: 1
@@ -41,22 +42,9 @@
// processing of files found in directories starting with an _. This
// prevents each chapter being built as its own book.
-**License Statement**
-
-Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file
-distributed with this work for additional information regarding copyright ownership. The ASF licenses this file
-to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
-the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an
-"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
-specific language governing permissions and limitations under the License.
-
-[cols="2",options="header"]
-|===
-| Version | Date
-| 1.3.0 | January, 2016
-|===
+include::../../shared/license.txt[]
+<<<
+include::../../shared/revisions.txt[]
include::asciidoc/_chapters/about.adoc[]
include::asciidoc/_chapters/introduction.adoc[]
http://git-wip-us.apache.org/repos/asf/incubator-trafodion/blob/21d6d8d3/docs/shared/acknowledgements.txt
----------------------------------------------------------------------
diff --git a/docs/shared/acknowledgements.txt b/docs/shared/acknowledgements.txt
new file mode 100644
index 0000000..c395596
--- /dev/null
+++ b/docs/shared/acknowledgements.txt
@@ -0,0 +1,38 @@
+*Acknowledgements*
+
+Microsoft�, Windows�, Windows NT�, Windows� XP, and Windows Vista� are
+U.S. registered trademarks of Microsoft Corporation. Intel� and Intel�
+Itanium� are trademarks of Intel Corporation in the U.S. and other
+countries. Java� is a registered trademark of Oracle and/or its
+affiliates. Motif, OSF/1, UNIX�, X/Open�, and the X device is a
+trademark of X/Open Company Ltd. in the UK and other countries.
+
+OSF, OSF/1, OSF/Motif, Motif, and Open Software Foundation are trademarks of
+the Open Software Foundation in the U.S. and other countries.
+� 1990, 1991, 1992, 1993 Open Software Foundation, Inc.
+
+The OSF documentation and the OSF software to which it relates are derived in
+part from materials supplied by the following: � 1987, 1988, 1989
+Carnegie-Mellon University. � 1989, 1990, 1991 Digital Equipment
+Corporation. � 1985, 1988, 1989, 1990 Encore Computer Corporation. � 1988 Free
+Software Foundation, Inc. � 1987, 1988, 1989, 1990, 1991 Hewlett-Packard
+Company. � 1985, 1987, 1988, 1989, 1990, 1991, 1992 International
+Business Machines Corporation. � 1988, 1989 Massachusetts Institute of
+Technology. � 1988, 1989, 1990 Mentat Inc. � 1988 Microsoft Corporation.
+� 1987, 1988, 1989, 1990, 1991,
+1992 SecureWare, Inc. � 1990, 1991 Siemens Nixdorf Informations systeme
+AG. � 1986, 1989, 1996, 1997 Sun Microsystems, Inc. � 1989, 1990, 1991
+Transarc Corporation.
+
+OSF software and documentation are based in part
+on the Fourth Berkeley Software Distribution under license from The
+Regents of the University of California. OSF acknowledges the following
+individuals and institutions for their role in its development: Kenneth
+C.R.C. Arnold, Gregory S. Couch, Conrad C. Huang, Ed James, Symmetric
+Computer Systems, Robert Elz. � 1980, 1981, 1982, 1983, 1985, 1986,
+1987, 1988, 1989 Regents of the University of California. OSF MAKES NO
+WARRANTY OF ANY KIND WITH REGARD TO THE OSF MATERIAL PROVIDED HEREIN,
+INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS FOR A PARTICULAR PURPOSE. OSF shall not be liable for errors
+contained herein or for incidental consequential damages in connection
+with the furnishing, performance, or use of this material.
http://git-wip-us.apache.org/repos/asf/incubator-trafodion/blob/21d6d8d3/docs/shared/revisions.txt
----------------------------------------------------------------------
diff --git a/docs/shared/revisions.txt b/docs/shared/revisions.txt
new file mode 100644
index 0000000..2408fd1
--- /dev/null
+++ b/docs/shared/revisions.txt
@@ -0,0 +1,32 @@
+////
+* @@@ START COPYRIGHT @@@
+*
+* Licensed to the Apache Software Foundation (ASF) under one
+* or more contributor license agreements. See the NOTICE file
+* distributed with this work for additional information
+* regarding copyright ownership. The ASF licenses this file
+* to you under the Apache License, Version 2.0 (the
+* "License"); you may not use this file except in compliance
+* with the License. You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing,
+* software distributed under the License is distributed on an
+* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+* KIND, either express or implied. See the License for the
+* specific language governing permissions and limitations
+* under the License.
+*
+* @@@ END COPYRIGHT @@@
+////
+
+*Revision History*
+
+[cols="2",options="header"]
+|===
+| Version | Date
+| 2.0.0 | To be announced.
+| 1.3.0 | January, 2016
+|===
+
http://git-wip-us.apache.org/repos/asf/incubator-trafodion/blob/21d6d8d3/docs/spj_guide/src/asciidoc/_chapters/about.adoc
----------------------------------------------------------------------
diff --git a/docs/spj_guide/src/asciidoc/_chapters/about.adoc b/docs/spj_guide/src/asciidoc/_chapters/about.adoc
index fa484cd..de8bb56 100644
--- a/docs/spj_guide/src/asciidoc/_chapters/about.adoc
+++ b/docs/spj_guide/src/asciidoc/_chapters/about.adoc
@@ -20,7 +20,7 @@
* under the License.
*
* @@@ END COPYRIGHT @@@
- */
+*/
////
= About This Document
http://git-wip-us.apache.org/repos/asf/incubator-trafodion/blob/21d6d8d3/docs/spj_guide/src/asciidoc/_chapters/create_spjs.adoc
----------------------------------------------------------------------
diff --git a/docs/spj_guide/src/asciidoc/_chapters/create_spjs.adoc b/docs/spj_guide/src/asciidoc/_chapters/create_spjs.adoc
index 7eb409c..370877b 100644
--- a/docs/spj_guide/src/asciidoc/_chapters/create_spjs.adoc
+++ b/docs/spj_guide/src/asciidoc/_chapters/create_spjs.adoc
@@ -1,23 +1,23 @@
////
/**
- *@@@ START COPYRIGHT @@@
- * Licensed to the Apache Software Foundation (ASF) under one
- * or more contributor license agreements. See the NOTICE file
- * distributed with this work for additional information
- * regarding copyright ownership. The ASF licenses this file
- * to you under the Apache License, Version 2.0 (the
- * "License"); you may not use this file except in compliance
- * with the License. You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- * @@@ END COPYRIGHT @@@
- */
+*@@@ START COPYRIGHT @@@
+* Licensed to the Apache Software Foundation (ASF) under one
+* or more contributor license agreements. See the NOTICE file
+* distributed with this work for additional information
+* regarding copyright ownership. The ASF licenses this file
+* to you under the Apache License, Version 2.0 (the
+* "License"); you may not use this file except in compliance
+* with the License. You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+* @@@ END COPYRIGHT @@@
+*/
////
[[create-spjs]]
http://git-wip-us.apache.org/repos/asf/incubator-trafodion/blob/21d6d8d3/docs/spj_guide/src/asciidoc/_chapters/deploy_spjs.adoc
----------------------------------------------------------------------
diff --git a/docs/spj_guide/src/asciidoc/_chapters/deploy_spjs.adoc b/docs/spj_guide/src/asciidoc/_chapters/deploy_spjs.adoc
index 1f7ad25..7f55713 100644
--- a/docs/spj_guide/src/asciidoc/_chapters/deploy_spjs.adoc
+++ b/docs/spj_guide/src/asciidoc/_chapters/deploy_spjs.adoc
@@ -1,23 +1,23 @@
////
/**
*@@@ START COPYRIGHT @@@
- * Licensed to the Apache Software Foundation (ASF) under one
- * or more contributor license agreements. See the NOTICE file
- * distributed with this work for additional information
- * regarding copyright ownership. The ASF licenses this file
- * to you under the Apache License, Version 2.0 (the
- * "License"); you may not use this file except in compliance
- * with the License. You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- * @@@ END COPYRIGHT @@@
- */
+* Licensed to the Apache Software Foundation (ASF) under one
+* or more contributor license agreements. See the NOTICE file
+* distributed with this work for additional information
+* regarding copyright ownership. The ASF licenses this file
+* to you under the Apache License, Version 2.0 (the
+* "License"); you may not use this file except in compliance
+* with the License. You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+* @@@ END COPYRIGHT @@@
+*/
////
[[deploy-spj-jar-files]]
http://git-wip-us.apache.org/repos/asf/incubator-trafodion/blob/21d6d8d3/docs/spj_guide/src/asciidoc/_chapters/develop_spjs.adoc
----------------------------------------------------------------------
diff --git a/docs/spj_guide/src/asciidoc/_chapters/develop_spjs.adoc b/docs/spj_guide/src/asciidoc/_chapters/develop_spjs.adoc
index acd0248..1cf0da8 100644
--- a/docs/spj_guide/src/asciidoc/_chapters/develop_spjs.adoc
+++ b/docs/spj_guide/src/asciidoc/_chapters/develop_spjs.adoc
@@ -1,23 +1,23 @@
////
/**
- *@@@ START COPYRIGHT @@@
- * Licensed to the Apache Software Foundation (ASF) under one
- * or more contributor license agreements. See the NOTICE file
- * distributed with this work for additional information
- * regarding copyright ownership. The ASF licenses this file
- * to you under the Apache License, Version 2.0 (the
- * "License"); you may not use this file except in compliance
- * with the License. You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- * @@@ END COPYRIGHT @@@
- */
+*@@@ START COPYRIGHT @@@
+* Licensed to the Apache Software Foundation (ASF) under one
+* or more contributor license agreements. See the NOTICE file
+* distributed with this work for additional information
+* regarding copyright ownership. The ASF licenses this file
+* to you under the Apache License, Version 2.0 (the
+* "License"); you may not use this file except in compliance
+* with the License. You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+* @@@ END COPYRIGHT @@@
+*/
////
[[develop-spj-methods]]
http://git-wip-us.apache.org/repos/asf/incubator-trafodion/blob/21d6d8d3/docs/spj_guide/src/asciidoc/_chapters/execute_spjs.adoc
----------------------------------------------------------------------
diff --git a/docs/spj_guide/src/asciidoc/_chapters/execute_spjs.adoc b/docs/spj_guide/src/asciidoc/_chapters/execute_spjs.adoc
index 5100227..81c341d 100644
--- a/docs/spj_guide/src/asciidoc/_chapters/execute_spjs.adoc
+++ b/docs/spj_guide/src/asciidoc/_chapters/execute_spjs.adoc
@@ -1,23 +1,23 @@
////
/**
- *@@@ START COPYRIGHT @@@
- * Licensed to the Apache Software Foundation (ASF) under one
- * or more contributor license agreements. See the NOTICE file
- * distributed with this work for additional information
- * regarding copyright ownership. The ASF licenses this file
- * to you under the Apache License, Version 2.0 (the
- * "License"); you may not use this file except in compliance
- * with the License. You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
+*@@@ START COPYRIGHT @@@
+* Licensed to the Apache Software Foundation (ASF) under one
+* or more contributor license agreements. See the NOTICE file
+* distributed with this work for additional information
+* regarding copyright ownership. The ASF licenses this file
+* to you under the Apache License, Version 2.0 (the
+* "License"); you may not use this file except in compliance
+* with the License. You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- * @@@ END COPYRIGHT @@@
- */
+* See the License for the specific language governing permissions and
+* limitations under the License.
+* @@@ END COPYRIGHT @@@
+*/
////
[[execute-spjs]]
http://git-wip-us.apache.org/repos/asf/incubator-trafodion/blob/21d6d8d3/docs/spj_guide/src/asciidoc/_chapters/get_started.adoc
----------------------------------------------------------------------
diff --git a/docs/spj_guide/src/asciidoc/_chapters/get_started.adoc b/docs/spj_guide/src/asciidoc/_chapters/get_started.adoc
index eeb4756..18c9af2 100644
--- a/docs/spj_guide/src/asciidoc/_chapters/get_started.adoc
+++ b/docs/spj_guide/src/asciidoc/_chapters/get_started.adoc
@@ -1,23 +1,23 @@
////
/**
- *@@@ START COPYRIGHT @@@
- * Licensed to the Apache Software Foundation (ASF) under one
- * or more contributor license agreements. See the NOTICE file
- * distributed with this work for additional information
- * regarding copyright ownership. The ASF licenses this file
- * to you under the Apache License, Version 2.0 (the
- * "License"); you may not use this file except in compliance
- * with the License. You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- * @@@ END COPYRIGHT @@@
- */
+*@@@ START COPYRIGHT @@@
+* Licensed to the Apache Software Foundation (ASF) under one
+* or more contributor license agreements. See the NOTICE file
+* distributed with this work for additional information
+* regarding copyright ownership. The ASF licenses this file
+* to you under the Apache License, Version 2.0 (the
+* "License"); you may not use this file except in compliance
+* with the License. You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+* @@@ END COPYRIGHT @@@
+*/
////
[[get-started]]