rename README.txt files README.md; lets us add formatting
Project: http://git-wip-us.apache.org/repos/asf/incubator-slider/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-slider/commit/3da97bde Tree: http://git-wip-us.apache.org/repos/asf/incubator-slider/tree/3da97bde Diff: http://git-wip-us.apache.org/repos/asf/incubator-slider/diff/3da97bde Branch: refs/heads/develop Commit: 3da97bde8b1b24c15451a10250d961374eadf95c Parents: fe35602 Author: Steve Loughran <ste...@apache.org> Authored: Thu Oct 16 11:36:42 2014 -0700 Committer: Steve Loughran <ste...@apache.org> Committed: Thu Oct 16 11:37:57 2014 -0700 ---------------------------------------------------------------------- app-packages/accumulo/README.md | 113 ++++++++++++++++++++++++++++++++++ app-packages/accumulo/README.txt | 106 ------------------------------- app-packages/hbase/README.md | 84 +++++++++++++++++++++++++ app-packages/hbase/README.txt | 73 ---------------------- 4 files changed, 197 insertions(+), 179 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-slider/blob/3da97bde/app-packages/accumulo/README.md ---------------------------------------------------------------------- diff --git a/app-packages/accumulo/README.md b/app-packages/accumulo/README.md new file mode 100644 index 0000000..537d769 --- /dev/null +++ b/app-packages/accumulo/README.md @@ -0,0 +1,113 @@ +<!--- + 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. +--> + +# How to create a Slider package for Accumulo? + + mvn clean package -DskipTests -Paccumulo-app-package-maven + +OR + + mvn clean package -DskipTests -Paccumulo-app-package -Dpkg.version=1.6.1 \ + -Dpkg.name=accumulo-1.6.1-bin.tar.gz -Dpkg.src=/local/path/to/tarball + +App package can be found in + + app-packages/accumulo/target/slider-accumulo-app-package-*.zip + + + +In the first case, the version number of the app package will match the +slider version, and in the second case it will match the `pkg.version` +(intended to be the accumulo version). + +Verify the content using + + zip -Tv slider-accumulo-app-package*.zip + +`appConfig-default.json` and `resources-default.json` are not required to be packaged. +These files are included as reference configuration for Slider apps and are suitable +for a one-node cluster. + +In the maven packaging case, the version of Accumulo used for the app package +can be adjusted by adding a flag such as + + -Daccumulo.version=1.5.1 + +**Note that the LICENSE.txt and NOTICE.txt that are bundled with the app +package are designed for Accumulo 1.6.0 only and may need to be modified to be +applicable for other versions of the app package. + +Note also that the sample `appConfig-default.json` provided only works with Accumulo 1.6. +For Accumulo 1.5 the instance.volumes property must be replaced with +instance.dfs.dir (and it cannot use the provided variable `${DEFAULT_DATA_DIR}` +which is an HDFS URI). + +A less descriptive file name can be specified with +`-Dapp.package.name=accumulo_160` which would create a file `accumulo_160.zip` + +# Building Native Libraries + +Accumulo works better with its native libraries, and these must be built +manually for Accumulo releases 1.6.0 and greater. They should be built on a +machine Accumulo will be deployed on, or an equivalent. The procedure below +illustrates the steps for extracting and rebuilding the Accumulo app package +with native libraries, in the case of Accumulo version 1.6.0. You will need a +C++ compiler/toolchain installed to build this library, and `JAVA_HOME` must be +set. + + unzip ${app.package.name}.zip package/files/accumulo*gz + cd package/files/ + gunzip accumulo-1.6.0-bin.tar.gz + tar xvf accumulo-1.6.0-bin.tar + accumulo-1.6.0/bin/build_native_library.sh + tar uvf accumulo-1.6.0-bin.tar accumulo-1.6.0 + rm -rf accumulo-1.6.0 + gzip accumulo-1.6.0-bin.tar + cd ../../ + zip ${app.package.name}.zip -r package + rm -rf package + +# Export Control + +This distribution includes cryptographic software. The country in which you +currently reside may have restrictions on the import, possession, use, and/or +re-export to another country, of encryption software. BEFORE using any +encryption software, please check your country's laws, regulations and +policies concerning the import, possession, or use, and re-export of encryption +software, to see if this is permitted. See [http://www.wassenaar.org/](http://www.wassenaar.org/) for more +information. + +The U.S. Government Department of Commerce, Bureau of Industry and Security +(BIS), has classified this software as Export Commodity Control Number (ECCN) +5D002.C.1, which includes information security software using or performing +cryptographic functions with asymmetric algorithms. The form and manner of this +Apache Software Foundation distribution makes it eligible for export under the +License Exception ENC Technology Software Unrestricted (TSU) exception (see the +BIS Export Administration Regulations, Section 740.13) for both object code and +source code. + +The following provides more details on the included cryptographic software: + +Apache Slider uses the built-in java cryptography libraries. See Oracle's +information regarding Java cryptographic export regulations for more details: +[http://www.oracle.com/us/products/export/export-regulations-345813.html](http://www.oracle.com/us/products/export/export-regulations-345813.html) + +Apache Slider uses the SSL libraries from the Jetty project distributed by the +Eclipse Foundation [http://eclipse.org/jetty](http://eclipse.org/jetty). + +See also the Apache Accumulo export control notice in the README: +[http://accumulo.apache.org/downloads](http://accumulo.apache.org/downloads) http://git-wip-us.apache.org/repos/asf/incubator-slider/blob/3da97bde/app-packages/accumulo/README.txt ---------------------------------------------------------------------- diff --git a/app-packages/accumulo/README.txt b/app-packages/accumulo/README.txt deleted file mode 100644 index 3a857ee..0000000 --- a/app-packages/accumulo/README.txt +++ /dev/null @@ -1,106 +0,0 @@ -<!--- - 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. ---> - -# How to create a Slider package for Accumulo? - - mvn clean package -DskipTests -Paccumulo-app-package-maven - OR - mvn clean package -DskipTests -Paccumulo-app-package -Dpkg.version=1.6.1 \ - -Dpkg.name=accumulo-1.6.1-bin.tar.gz -Dpkg.src=/local/path/to/tarball - -App package can be found in - app-packages/accumulo/target/slider-accumulo-app-package-*.zip - -In the first case, the version number of the app package will match the -slider version, and in the second case it will match the pkg.version -(intended to be the accumulo version). - -Verify the content using - zip -Tv slider-accumulo-app-package*.zip - -appConfig-default.json and resources-default.json are not required to be packaged. -These files are included as reference configuration for Slider apps and are suitable -for a one-node cluster. - -In the maven packaging case, the version of Accumulo used for the app package -can be adjusted by adding a flag such as - -Daccumulo.version=1.5.1 - -**Note that the LICENSE.txt and NOTICE.txt that are bundled with the app -package are designed for Accumulo 1.6.0 only and may need to be modified to be -applicable for other versions of the app package. - -Note also that the sample appConfig-default.json provided only works with Accumulo 1.6, -while for Accumulo 1.5 the instance.volumes property must be replaced with -instance.dfs.dir (and it cannot use the provided variable ${DEFAULT_DATA_DIR} -which is an HDFS URI). - -A less descriptive file name can be specified with --Dapp.package.name=accumulo_160 which would create a file accumulo_160.zip. - -# Building Native Libraries - -Accumulo works better with its native libraries, and these must be built -manually for Accumulo releases 1.6.0 and greater. They should be built on a -machine Accumulo will be deployed on, or an equivalent. The procedure below -illustrates the steps for extracting and rebuilding the Accumulo app package -with native libraries, in the case of Accumulo version 1.6.0. You will need a -C++ compiler/toolchain installed to build this library, and JAVA_HOME must be -set. - - unzip ${app.package.name}.zip package/files/accumulo*gz - cd package/files/ - gunzip accumulo-1.6.0-bin.tar.gz - tar xvf accumulo-1.6.0-bin.tar - accumulo-1.6.0/bin/build_native_library.sh - tar uvf accumulo-1.6.0-bin.tar accumulo-1.6.0 - rm -rf accumulo-1.6.0 - gzip accumulo-1.6.0-bin.tar - cd ../../ - zip ${app.package.name}.zip -r package - rm -rf package - -# Export Control - -This distribution includes cryptographic software. The country in which you -currently reside may have restrictions on the import, possession, use, and/or -re-export to another country, of encryption software. BEFORE using any -encryption software, please check your country's laws, regulations and -policies concerning the import, possession, or use, and re-export of encryption -software, to see if this is permitted. See <http://www.wassenaar.org/> for more -information. - -The U.S. Government Department of Commerce, Bureau of Industry and Security -(BIS), has classified this software as Export Commodity Control Number (ECCN) -5D002.C.1, which includes information security software using or performing -cryptographic functions with asymmetric algorithms. The form and manner of this -Apache Software Foundation distribution makes it eligible for export under the -License Exception ENC Technology Software Unrestricted (TSU) exception (see the -BIS Export Administration Regulations, Section 740.13) for both object code and -source code. - -The following provides more details on the included cryptographic software: - -Apache Slider uses the built-in java cryptography libraries. See Oracle's -information regarding Java cryptographic export regulations for more details: -http://www.oracle.com/us/products/export/export-regulations-345813.html - -Apache Slider uses the SSL libraries from the Jetty project distributed by the -Eclipse Foundation (http://eclipse.org/jetty). - -See also the Apache Accumulo export control notice in the README: -http://accumulo.apache.org/downloads http://git-wip-us.apache.org/repos/asf/incubator-slider/blob/3da97bde/app-packages/hbase/README.md ---------------------------------------------------------------------- diff --git a/app-packages/hbase/README.md b/app-packages/hbase/README.md new file mode 100644 index 0000000..2d52fc9 --- /dev/null +++ b/app-packages/hbase/README.md @@ -0,0 +1,84 @@ +<!--- + 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. +--> + +# Create Slider App Package for HBase + +appConfig-default.json and resources-default.json are not required to be packaged. +These files are included as reference configuration for Slider apps and are suitable +for a one-node cluster. + +OPTION-I: Use a downloaded tarball +OPTION-II: Use the tarball from the local repository + +## OPTION - I + +To create the app package you will need the HBase tarball and invoke mvn command +with appropriate parameters. + +Command: + + mvn clean package -Phbase-app-package -Dpkg.version=<version> + -Dpkg.name=<file name of app tarball> -Dpkg.src=<folder location where the pkg is available> + +Example: + + mvn clean package -Phbase-app-package -Dpkg.version=0.98.5-hadoop2 + -Dpkg.name=hbase-0.98.5-hadoop2-bin.tar.gz + -Dpkg.src=/Users/user1/Downloads/0.98.5-hadoop2 + +App package can be found in + app-packages/hbase/target/slider-hbase-app-package-${pkg.version}.zip + +## OPTION - II + +You need the HBase version available on local maven repo to create the Slider App Package for HBase. + +Download the tarball for HBase: + e.g. path to tarball `~/Downloads/hbase-0.98.3-hadoop2-bin.tar.gz` + +The version of HBase used for the app package can be adjusted by adding a +flag such as + + -Dhbase.version=0.98.3-hadoop2 + +Use the following command to install HBase tarball locally (under local workspace of HBase repo): + + mvn install:install-file -Dfile=<path-to-tarball> -DgroupId=org.apache.hbase -DartifactId=hbase -Dversion=0.98.3-hadoop2 -Dclassifier=bin -Dpackaging=tar.gz + +You may need to copy the hbase tarball to the following location if the above step doesn't publish the tarball: + + ~/.m2/repository/org/apache/hbase/hbase/0.98.3-hadoop2/ + +After HBase tarball is published locally in maven repository, you can use the following command: + + mvn clean package -DskipTests -Phbase-app-package + +App package can be found in + + app-packages/hbase/target/apache-slider-hbase-${hbase.version}-app-package-${slider.version}.zip + +If an HBase version older than 0.98.3 is desired, it must be installed in the local maven repo. + +A less descriptive file name can be specified with + + -Dapp.package.name=HBase_98dot3 which would create a file HBase_98dot3.zip. + +## Verifying the content + +Verify the content using + + zip -Tv apache-slider-hbase-*.zip http://git-wip-us.apache.org/repos/asf/incubator-slider/blob/3da97bde/app-packages/hbase/README.txt ---------------------------------------------------------------------- diff --git a/app-packages/hbase/README.txt b/app-packages/hbase/README.txt deleted file mode 100644 index 1d59730..0000000 --- a/app-packages/hbase/README.txt +++ /dev/null @@ -1,73 +0,0 @@ -<!--- - 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. ---> - -Create Slider App Package for HBase - -appConfig-default.json and resources-default.json are not required to be packaged. -These files are included as reference configuration for Slider apps and are suitable -for a one-node cluster. - -OPTION-I: Use a downloaded tarball -OPTION-II: Use the tarball from the local repository - -****** OPTION - I ** -To create the app package you will need the HBase tarball and invoke mvn command -with appropriate parameters. - -Command: -mvn clean package -Phbase-app-package -Dpkg.version=<version> - -Dpkg.name=<file name of app tarball> -Dpkg.src=<folder location where the pkg is available> - -Example: -mvn clean package -Phbase-app-package -Dpkg.version=0.98.5-hadoop2 - -Dpkg.name=hbase-0.98.5-hadoop2-bin.tar.gz - -Dpkg.src=/Users/user1/Downloads/0.98.5-hadoop2 - -App package can be found in - app-packages/hbase/target/slider-hbase-app-package-${pkg.version}.zip - -****** OPTION - II ** -You need the HBase version available on local maven repo to create the Slider App Package for HBase. - -Download the tarball for HBase: - e.g. path to tarball ~/Downloads/hbase-0.98.3-hadoop2-bin.tar.gz - -The version of HBase used for the app package can be adjusted by adding a -flag such as - -Dhbase.version=0.98.3-hadoop2 - -Use the following command to install HBase tarball locally (under local workspace of HBase repo): - mvn install:install-file -Dfile=<path-to-tarball> -DgroupId=org.apache.hbase -DartifactId=hbase -Dversion=0.98.3-hadoop2 -Dclassifier=bin -Dpackaging=tar.gz - -You may need to copy the hbase tarball to the following location if the above step doesn't publish the tarball: -~/.m2/repository/org/apache/hbase/hbase/0.98.3-hadoop2/ - -After HBase tarball is published locally in maven repository, you can use the following command: - mvn clean package -DskipTests -Phbase-app-package - -App package can be found in - app-packages/hbase/target/apache-slider-hbase-${hbase.version}-app-package-${slider.version}.zip - -If an HBase version older than 0.98.3 is desired, it must be installed in the local maven repo. - -A less descriptive file name can be specified with - -Dapp.package.name=HBase_98dot3 which would create a file HBase_98dot3.zip. - -****** Verifying the content ** - -Verify the content using - zip -Tv apache-slider-hbase-*.zip