RANGER-794: ranger-perf tool: fix README.txt and location of the logfile used in unit test - commit id 5f79eec5097b0d7688159ccc579ae1117273686f
Signed-off-by: Madhan Neethiraj <[email protected]> Project: http://git-wip-us.apache.org/repos/asf/incubator-ranger/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-ranger/commit/e72cb201 Tree: http://git-wip-us.apache.org/repos/asf/incubator-ranger/tree/e72cb201 Diff: http://git-wip-us.apache.org/repos/asf/incubator-ranger/diff/e72cb201 Branch: refs/heads/ranger-0.5 Commit: e72cb201db7d7f8cefb6cb30cfacc161c5629dd1 Parents: 927b0b5 Author: Abhay Kulkarni <[email protected]> Authored: Mon Dec 21 18:41:32 2015 -0800 Committer: Madhan Neethiraj <[email protected]> Committed: Sun Mar 20 10:34:24 2016 -0700 ---------------------------------------------------------------------- ranger-tools/scripts/README.txt | 8 ++++---- ranger-tools/src/test/resources/log4j.properties | 2 +- 2 files changed, 5 insertions(+), 5 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-ranger/blob/e72cb201/ranger-tools/scripts/README.txt ---------------------------------------------------------------------- diff --git a/ranger-tools/scripts/README.txt b/ranger-tools/scripts/README.txt index 282a306..dda6fd1 100644 --- a/ranger-tools/scripts/README.txt +++ b/ranger-tools/scripts/README.txt @@ -13,7 +13,7 @@ # See the License for the specific language governing permissions and # limitations under the License. -This file describes how to build, unpackage and run the performance testing tool. +This file describes how to build, setup, configure and run the performance testing tool. 1. Build Apache Ranger using the following command. % mvn clean compile package assembly:assembly @@ -42,7 +42,7 @@ This file describes how to build, unpackage and run the performance testing tool 4. % cd ranger-0.5.0-ranger-tools -5. Setup configuration +5. Configure the policies and requests to use in the test run Following sample data files are packaged with the perf-tool: service-policies - testdata/test_servicepolicies_hive.json @@ -53,12 +53,12 @@ This file describes how to build, unpackage and run the performance testing tool Update conf/log4j.properties to specify the filename where perf run results will be written to. Property to update is 'ranger.perf.logger'. -5. Run the tool with the command, +6. Run the tool with the following command % ./ranger-perftester.sh -s <service-policies-file> -r <requests-file> -p <profiled-modules-file> -c <number-of-concurrent-clients> -n <number-of-times-requests-file-to-be-run> Example: % ./ranger-perftester.sh -s testdata/test_servicepolicies_hive.json -r testdata/test_requests_hive.json -p testdata/test_modules.txt -c 2 -n 1 -6. At the end of the run, the performance-statistics are printed in the log file in conf/log4j.properties file. +7. At the end of the run, the performance-statistics are printed on the console and in the log specified file in conf/log4j.properties file. http://git-wip-us.apache.org/repos/asf/incubator-ranger/blob/e72cb201/ranger-tools/src/test/resources/log4j.properties ---------------------------------------------------------------------- diff --git a/ranger-tools/src/test/resources/log4j.properties b/ranger-tools/src/test/resources/log4j.properties index a9a8881..abf617e 100644 --- a/ranger-tools/src/test/resources/log4j.properties +++ b/ranger-tools/src/test/resources/log4j.properties @@ -38,7 +38,7 @@ log4j.appender.console.layout.ConversionPattern=%d{ISO8601} %-5p [%t] %c{2}: %L # ranger.perf log level # ranger.perf.logger=DEBUG,PERF -ranger.perf.log.file=/tmp/ranger-perf-test.log +ranger.perf.log.file=${java.io.tmpdir}/ranger-perf-test.log log4j.logger.ranger.perf=${ranger.perf.logger} log4j.additivity.ranger.perf=false
