You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@trafodion.apache.org by su...@apache.org on 2017/02/23 16:54:52 UTC
[1/3] incubator-trafodion git commit: [TRAFODION-2481] Improve ambari
section of provisioning guide
Repository: incubator-trafodion
Updated Branches:
refs/heads/release2.1 b5e73002b -> 3e0d531ab
[TRAFODION-2481] Improve ambari section of provisioning guide
Add small screen caps to better illustrate ambari integration.
Fix a couple of typos in project-name macros, thanks to Anuradha's review.
Fix a bug in the ambari integration code, found by exercising steps in
the doc.
Project: http://git-wip-us.apache.org/repos/asf/incubator-trafodion/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-trafodion/commit/1ce7665e
Tree: http://git-wip-us.apache.org/repos/asf/incubator-trafodion/tree/1ce7665e
Diff: http://git-wip-us.apache.org/repos/asf/incubator-trafodion/diff/1ce7665e
Branch: refs/heads/release2.1
Commit: 1ce7665ed41e8ceb01efa8761f1d76d06d4c487c
Parents: 965f659
Author: Steve Varnau <sv...@apache.org>
Authored: Tue Feb 21 23:07:54 2017 +0000
Committer: Steve Varnau <sv...@apache.org>
Committed: Tue Feb 21 23:07:54 2017 +0000
----------------------------------------------------------------------
.../src/asciidoc/_chapters/ambari_install.adoc | 29 +++++++++++++++----
.../src/asciidoc/_chapters/prepare.adoc | 2 +-
.../src/asciidoc/_chapters/quickstart.adoc | 2 +-
docs/provisioning_guide/src/images/amb1.PNG | Bin 0 -> 46318 bytes
docs/provisioning_guide/src/images/amb2.PNG | Bin 0 -> 12063 bytes
docs/provisioning_guide/src/images/amb3.PNG | Bin 0 -> 13764 bytes
docs/provisioning_guide/src/images/amb4.PNG | Bin 0 -> 44413 bytes
install/ambari-installer/mpack.json | 2 +-
8 files changed, 26 insertions(+), 9 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-trafodion/blob/1ce7665e/docs/provisioning_guide/src/asciidoc/_chapters/ambari_install.adoc
----------------------------------------------------------------------
diff --git a/docs/provisioning_guide/src/asciidoc/_chapters/ambari_install.adoc b/docs/provisioning_guide/src/asciidoc/_chapters/ambari_install.adoc
index c247124..303fedd 100644
--- a/docs/provisioning_guide/src/asciidoc/_chapters/ambari_install.adoc
+++ b/docs/provisioning_guide/src/asciidoc/_chapters/ambari_install.adoc
@@ -34,6 +34,8 @@ This method of installation uses RPM packages rather than tar files. There are t
You can either set up a local yum repository (requires a web server) or install the RPMs
manually on each node.
+image:{images}/amb4.PNG[width=400,height=400,alt="Ambari Service"]
+
== Local Repository
On your web server host, be sure the *createrepo* package is installed.
@@ -76,17 +78,32 @@ Unlike the command-line installer, Trafodion can be provisioned at time of creat
=== Initial Cluster Creation
If you are creating a new cluster and you have the Trafodion server RPM hosted on a local yum repository, then
-create the cluster as normal, and select Trafodion on the service selection screen.
-When Ambari prompts for the repository URLs, be sure to update the Trafodion URL
-to the URL for your local repository.
+create the cluster as normal, and select a stack version that includs the Trafodion service.
+
+image:{images}/amb1.PNG[width=600,height=400,alt="Ambari Service"]
+
+When selecting HDP stack version, Ambari prompts for the repository URLs, be *sure to update the Trafodion URL
+to the URL for your local repository*.
-If you plan to install the server RPM manually, do not select the Trafodion service. First, create a cluster
-without Trafodion service and follow instructions for an existing cluster.
+image:{images}/amb2.PNG[width=600,height=120,alt="Ambari Service"]
+
+If you plan to install the server RPM manually, set the Trafodion URL to some other valid repository, otherwise the
+the invalid URL will cause errors later.
+Any valid repo URL will do. You may copy the HDP URL and paste it into the Trafodion URL.
+In this case, do not select the Trafodion service on the "Choose Services" step. First, create a cluster
+without the Trafodion service and follow instructions below for an existing cluster.
=== Existing Cluster
If you are not using a local yum repository, manually copy the apache-trafodion_server RPM to each data node and
install it using yum install.
-Using Ambari, select the cluster and then choose "Add a Service" and select Trafodion.
+Using Ambari, select the cluster and then from the Actions menu choose "Add Service" and select Trafodion.
+
+image:{images}/amb3.PNG[width=300,height=300,alt="Ambari Service"]
+
+You may get a configuration warning regarding a hbase-site setting. In this case, follow the warning message
+instructions to go to the HBase advanced configuration, hbase-site section and use the button to revert to
+the recommended value for "hbase.coprocessor.region.classes".
+Several services will need to be restarted before the Trafodion service can be started.
http://git-wip-us.apache.org/repos/asf/incubator-trafodion/blob/1ce7665e/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 6bb0f11..c14e79c 100644
--- a/docs/provisioning_guide/src/asciidoc/_chapters/prepare.adoc
+++ b/docs/provisioning_guide/src/asciidoc/_chapters/prepare.adoc
@@ -181,7 +181,7 @@ distribution manager's REST API.
| START | Whether to start {project-name} after install/upgrade. | N |
| SUSE_LINUX | Whether your installing {project-name} on SUSE Linux. | false | Auto-detected by the {project-name} Installer.
| TRAF_KEYTAB^2^ | Name to use when specifying {project-name} keytab | based on distribution | Required if Kerberos is enabled.
-| TRAF_KEYTAB_DIR^2^ | Location of {project_name} keytab | based on distribution | Required if Kerberos is enabled.
+| TRAF_KEYTAB_DIR^2^ | Location of {project-name} keytab | based on distribution | Required if Kerberos is enabled.
| 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.
http://git-wip-us.apache.org/repos/asf/incubator-trafodion/blob/1ce7665e/docs/provisioning_guide/src/asciidoc/_chapters/quickstart.adoc
----------------------------------------------------------------------
diff --git a/docs/provisioning_guide/src/asciidoc/_chapters/quickstart.adoc b/docs/provisioning_guide/src/asciidoc/_chapters/quickstart.adoc
index 8d00d90..8abb145 100644
--- a/docs/provisioning_guide/src/asciidoc/_chapters/quickstart.adoc
+++ b/docs/provisioning_guide/src/asciidoc/_chapters/quickstart.adoc
@@ -136,7 +136,7 @@ The Java location is: `/usr/jdk64/jdk1.7.0_67`
<<<
=== Data Nodes
-{projet-name} is installed on all data nodes in your Hadoop cluster. You need to record the fully-qualified domain name node for each node.
+{project-name} is installed on all data nodes in your Hadoop cluster. You need to record the fully-qualified domain name node for each node.
For example, refer to `/etc/hosts`.
*Example*
http://git-wip-us.apache.org/repos/asf/incubator-trafodion/blob/1ce7665e/docs/provisioning_guide/src/images/amb1.PNG
----------------------------------------------------------------------
diff --git a/docs/provisioning_guide/src/images/amb1.PNG b/docs/provisioning_guide/src/images/amb1.PNG
new file mode 100644
index 0000000..6c791fc
Binary files /dev/null and b/docs/provisioning_guide/src/images/amb1.PNG differ
http://git-wip-us.apache.org/repos/asf/incubator-trafodion/blob/1ce7665e/docs/provisioning_guide/src/images/amb2.PNG
----------------------------------------------------------------------
diff --git a/docs/provisioning_guide/src/images/amb2.PNG b/docs/provisioning_guide/src/images/amb2.PNG
new file mode 100644
index 0000000..e417f6f
Binary files /dev/null and b/docs/provisioning_guide/src/images/amb2.PNG differ
http://git-wip-us.apache.org/repos/asf/incubator-trafodion/blob/1ce7665e/docs/provisioning_guide/src/images/amb3.PNG
----------------------------------------------------------------------
diff --git a/docs/provisioning_guide/src/images/amb3.PNG b/docs/provisioning_guide/src/images/amb3.PNG
new file mode 100644
index 0000000..caaaa8b
Binary files /dev/null and b/docs/provisioning_guide/src/images/amb3.PNG differ
http://git-wip-us.apache.org/repos/asf/incubator-trafodion/blob/1ce7665e/docs/provisioning_guide/src/images/amb4.PNG
----------------------------------------------------------------------
diff --git a/docs/provisioning_guide/src/images/amb4.PNG b/docs/provisioning_guide/src/images/amb4.PNG
new file mode 100644
index 0000000..845a319
Binary files /dev/null and b/docs/provisioning_guide/src/images/amb4.PNG differ
http://git-wip-us.apache.org/repos/asf/incubator-trafodion/blob/1ce7665e/install/ambari-installer/mpack.json
----------------------------------------------------------------------
diff --git a/install/ambari-installer/mpack.json b/install/ambari-installer/mpack.json
index 284c94d..5b4b601 100644
--- a/install/ambari-installer/mpack.json
+++ b/install/ambari-installer/mpack.json
@@ -27,7 +27,7 @@
"service_versions_map": [
{
"service_name" : "TRAFODION",
- "service_version" : "2.1",
+ "service_version" : "MPACK_VERSION",
"applicable_stacks" : [
{
"stack_name" : "HDP", "stack_version" : "2.3"
[2/3] incubator-trafodion git commit: [TRAFODION-2481] Add section on
initializing meta-data via Ambari
Posted by su...@apache.org.
[TRAFODION-2481] Add section on initializing meta-data via Ambari
Project: http://git-wip-us.apache.org/repos/asf/incubator-trafodion/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-trafodion/commit/34715ee8
Tree: http://git-wip-us.apache.org/repos/asf/incubator-trafodion/tree/34715ee8
Diff: http://git-wip-us.apache.org/repos/asf/incubator-trafodion/diff/34715ee8
Branch: refs/heads/release2.1
Commit: 34715ee8b249ed64ab58f3cac67896617ac91c0f
Parents: 1ce7665
Author: Steve Varnau <sv...@apache.org>
Authored: Wed Feb 22 16:19:06 2017 +0000
Committer: Steve Varnau <sv...@apache.org>
Committed: Wed Feb 22 16:19:06 2017 +0000
----------------------------------------------------------------------
.../src/asciidoc/_chapters/ambari_install.adoc | 46 +++++++++++--------
docs/provisioning_guide/src/images/amb5.PNG | Bin 0 -> 10552 bytes
2 files changed, 27 insertions(+), 19 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-trafodion/blob/34715ee8/docs/provisioning_guide/src/asciidoc/_chapters/ambari_install.adoc
----------------------------------------------------------------------
diff --git a/docs/provisioning_guide/src/asciidoc/_chapters/ambari_install.adoc b/docs/provisioning_guide/src/asciidoc/_chapters/ambari_install.adoc
index 303fedd..f8b9296 100644
--- a/docs/provisioning_guide/src/asciidoc/_chapters/ambari_install.adoc
+++ b/docs/provisioning_guide/src/asciidoc/_chapters/ambari_install.adoc
@@ -29,12 +29,12 @@
This method of installation uses RPM packages rather than tar files. There are two packages:
* traf_ambari - Ambari management pack (plug-in) that is installed on the Ambari Server node
-* apache-trafodion_server - Trafodion package that is installed on every data node
+* apache-trafodion_server - {project-name} package that is installed on every data node
You can either set up a local yum repository (requires a web server) or install the RPMs
manually on each node.
-image:{images}/amb4.PNG[width=400,height=400,alt="Ambari Service"]
+image:{images}/amb4.PNG[width=400,height=400,alt="Ambari Services"]
== Local Repository
@@ -45,9 +45,9 @@ Copy the two RPM files into a directory served to the web and run the createrepo
The command must be used to update repo meta-data any time new RPMs are added or replaced.
-Note the Trafodion repository URL for later use.
+Note the {project-name} repository URL for later use.
-== Install Ambari Management Pack for Trafodion
+== Install Ambari Management Pack for {project-name}
On your Ambari server host:
@@ -56,7 +56,7 @@ For example: http://docs.hortonworks.com/HDPDocuments/Ambari-2.4.2.0/bk_ambari-i
. Add a yum repo file with the URL of your local repository, or copy the traf_ambari RPM locally.
-. Install the Trafodion Ambari management pack RPM. Ambari server will be installed as a dependency, if not already installed.
+. Install the {project-name} Ambari management pack RPM. Ambari server will be installed as a dependency, if not already installed.
$ sudo yum install traf_ambari
@@ -71,39 +71,47 @@ For example: http://docs.hortonworks.com/HDPDocuments/Ambari-2.4.2.0/bk_ambari-i
...
$ sudo ambari-server start
-== Install Trafodion
+== Install {project-name}
-Unlike the command-line installer, Trafodion can be provisioned at time of creating a new cluster.
+Unlike the command-line installer, {project-name} can be provisioned at time of creating a new cluster.
=== Initial Cluster Creation
-If you are creating a new cluster and you have the Trafodion server RPM hosted on a local yum repository, then
-create the cluster as normal, and select a stack version that includs the Trafodion service.
+If you are creating a new cluster and you have the {project-name} server RPM hosted on a local yum repository, then
+create the cluster as normal, and select a stack version that includs the {project-name} service.
-image:{images}/amb1.PNG[width=600,height=400,alt="Ambari Service"]
+image:{images}/amb1.PNG[width=600,height=400,alt="Ambari Stack Versions"]
-When selecting HDP stack version, Ambari prompts for the repository URLs, be *sure to update the Trafodion URL
+When selecting HDP stack version, Ambari prompts for the repository URLs, be *sure to update the {project-name} URL
to the URL for your local repository*.
-image:{images}/amb2.PNG[width=600,height=120,alt="Ambari Service"]
+image:{images}/amb2.PNG[width=600,height=120,alt="Repo URL"]
-If you plan to install the server RPM manually, set the Trafodion URL to some other valid repository, otherwise the
+If you plan to install the server RPM manually, set the {project-name} URL to some other valid repository, otherwise the
the invalid URL will cause errors later.
-Any valid repo URL will do. You may copy the HDP URL and paste it into the Trafodion URL.
-In this case, do not select the Trafodion service on the "Choose Services" step. First, create a cluster
-without the Trafodion service and follow instructions below for an existing cluster.
+Any valid repo URL will do. You may copy the HDP URL and paste it into the {project-name} URL.
+In this case, do not select the {project-name} service on the "Choose Services" step. First, create a cluster
+without the {project-name} service and follow instructions below for an existing cluster.
=== Existing Cluster
If you are not using a local yum repository, manually copy the apache-trafodion_server RPM to each data node and
install it using yum install.
-Using Ambari, select the cluster and then from the Actions menu choose "Add Service" and select Trafodion.
+Using Ambari, select the cluster and then from the Actions menu choose "Add Service" and select {project-name}.
-image:{images}/amb3.PNG[width=300,height=300,alt="Ambari Service"]
+image:{images}/amb3.PNG[width=300,height=300,alt="Add Service"]
You may get a configuration warning regarding a hbase-site setting. In this case, follow the warning message
instructions to go to the HBase advanced configuration, hbase-site section and use the button to revert to
the recommended value for "hbase.coprocessor.region.classes".
-Several services will need to be restarted before the Trafodion service can be started.
+Several services will need to be restarted before the {project-name} service can be started.
+
+== Initialize Meta-Data
+
+After {project-name} is installed and started, it must be initialized before use. Select the {project-name} service
+and then from the Service Actions menu choose "Initialize" and confirm the action.
+
+image:{images}/amb5.PNG[width=300,height=250,alt="Initialize"]
+
http://git-wip-us.apache.org/repos/asf/incubator-trafodion/blob/34715ee8/docs/provisioning_guide/src/images/amb5.PNG
----------------------------------------------------------------------
diff --git a/docs/provisioning_guide/src/images/amb5.PNG b/docs/provisioning_guide/src/images/amb5.PNG
new file mode 100644
index 0000000..e995285
Binary files /dev/null and b/docs/provisioning_guide/src/images/amb5.PNG differ
[3/3] incubator-trafodion git commit: Merge [TRAFODION-2481] PR-974
Improve ambari section of provisioning guide
Posted by su...@apache.org.
Merge [TRAFODION-2481] PR-974 Improve ambari section of provisioning guide
Project: http://git-wip-us.apache.org/repos/asf/incubator-trafodion/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-trafodion/commit/3e0d531a
Tree: http://git-wip-us.apache.org/repos/asf/incubator-trafodion/tree/3e0d531a
Diff: http://git-wip-us.apache.org/repos/asf/incubator-trafodion/diff/3e0d531a
Branch: refs/heads/release2.1
Commit: 3e0d531abce2361e855e0376aba3bb6ae4eaa04a
Parents: b5e7300 34715ee
Author: Suresh Subbiah <su...@apache.org>
Authored: Thu Feb 23 16:54:19 2017 +0000
Committer: Suresh Subbiah <su...@apache.org>
Committed: Thu Feb 23 16:54:19 2017 +0000
----------------------------------------------------------------------
.../src/asciidoc/_chapters/ambari_install.adoc | 51 ++++++++++++++-----
.../src/asciidoc/_chapters/prepare.adoc | 2 +-
.../src/asciidoc/_chapters/quickstart.adoc | 2 +-
docs/provisioning_guide/src/images/amb1.PNG | Bin 0 -> 46318 bytes
docs/provisioning_guide/src/images/amb2.PNG | Bin 0 -> 12063 bytes
docs/provisioning_guide/src/images/amb3.PNG | Bin 0 -> 13764 bytes
docs/provisioning_guide/src/images/amb4.PNG | Bin 0 -> 44413 bytes
docs/provisioning_guide/src/images/amb5.PNG | Bin 0 -> 10552 bytes
install/ambari-installer/mpack.json | 2 +-
9 files changed, 41 insertions(+), 16 deletions(-)
----------------------------------------------------------------------