SLIDER-809 Write up a brief README on what _should_ work for tomcat.
Project: http://git-wip-us.apache.org/repos/asf/incubator-slider/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-slider/commit/940c9a8a Tree: http://git-wip-us.apache.org/repos/asf/incubator-slider/tree/940c9a8a Diff: http://git-wip-us.apache.org/repos/asf/incubator-slider/diff/940c9a8a Branch: refs/heads/feature/SLIDER-809-tomcat-app-package Commit: 940c9a8ad9fc212611a9324c38db4d1d9bc5888f Parents: 6d76102 Author: Josh Elser <[email protected]> Authored: Mon Apr 27 00:15:18 2015 -0400 Committer: Josh Elser <[email protected]> Committed: Mon Apr 27 00:15:18 2015 -0400 ---------------------------------------------------------------------- app-packages/tomcat/README.md | 53 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 53 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-slider/blob/940c9a8a/app-packages/tomcat/README.md ---------------------------------------------------------------------- diff --git a/app-packages/tomcat/README.md b/app-packages/tomcat/README.md new file mode 100644 index 0000000..0121bce --- /dev/null +++ b/app-packages/tomcat/README.md @@ -0,0 +1,53 @@ +<!--- + 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. +--> + +# Apache Tomcat + +Basic instructions on using the Apache Tomcat app-package. + +## Installation + +The Tomcat application package is distributed as a zip archive. +Use the `slider install` command to install it into HDFS for use. +You must also provide an identifying name (such as "tomcat"). + +`slider install-package --name tomcat --package path/to/slider-tomcat-app-package-0.72.0-incubating-SNAPSHOT.zip` + +## Configuration + +Copy appConfig-default.json and resources-default.json. By default, these files +will create one instance of Tomcat using a dynamic port provided by +Slider. + +In the copied appConfig.json, make sure you set `application.def` and +`java_home`. Feel free to adjust the memory usage as well. + + +## Create a Slider cluster + +Use the appConfig.json and resources.json file to create a Slider cluster now. +The name of the cluster is user defined and must be unique: this example uses "tomcat1" + +`slider create tomcat1 --template path/to/appConfig.json --resources path/to/resources.json` + +## Verify + +Check the Slider Application Master page on the Hadoop YARN status page. You should see +the application running and without failures. + +Until the QuickLinks/exports is resolved for this app package, the port must be determined manually +using a tool such as `netstat` and the pid of the Tomcat process. Sorry.
