geode-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject [03/50] [abbrv] incubator-geode git commit: GEODE-2105 Remove docs about log collection utility
Date Tue, 15 Nov 2016 21:21:41 GMT
GEODE-2105 Remove docs about log collection utility

The log collection utility is not part of the release,
so remove the documentation.  The content removed by
this commit has been placed on the feature/GEODE-79 branch.


Branch: refs/heads/feature/GEODE-288
Commit: ddc4819b01470825997b8504c0971d04ddfab2f3
Parents: 8c383ee
Author: Karen Miller <>
Authored: Mon Nov 14 14:52:20 2016 -0800
Committer: Karen Miller <>
Committed: Mon Nov 14 14:52:20 2016 -0800

 .../source/subnavs/geode-subnav.erb             |  3 -
 .../logging/  | 71 --------------------
 geode-docs/managing/logging/ |  4 --
 3 files changed, 78 deletions(-)
diff --git a/geode-book/master_middleman/source/subnavs/geode-subnav.erb b/geode-book/master_middleman/source/subnavs/geode-subnav.erb
index 959fdf3..2983460 100644
--- a/geode-book/master_middleman/source/subnavs/geode-subnav.erb
+++ b/geode-book/master_middleman/source/subnavs/geode-subnav.erb
@@ -792,9 +792,6 @@ limitations under the License.
                                 <a href="/docs/guide/managing/logging/configuring_log4j2.html">Advanced
Users—Configuring Log4j 2 for Geode</a>
-                            <li>
-                                <a href="/docs/guide/managing/logging/log_collection_utility.html">Log
Collection Utility</a>
-                            </li>
                     <li class="has_submenu">
diff --git a/geode-docs/managing/logging/ b/geode-docs/managing/logging/
deleted file mode 100644
index e83634f..0000000
--- a/geode-docs/managing/logging/
+++ /dev/null
@@ -1,71 +0,0 @@
-title:  Log Collection Utility
-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
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-See the License for the specific language governing permissions and
-limitations under the License.
-To aid in the troubleshooting of Apache Geode issues, you can use the provided log collection
utility to gather and upload log files and other troubleshooting artifacts. This tool is only
supported on Linux machines.
-This utility is used to gather log files and other troubleshooting artifacts from a Geode
-The tool goes through and collects all files ending with `.log`, `.err`, .`cfg`, `.gfs`,
`.stack`, `.xml`, `.properties,` and `.txt` from the working directories of running Geode
processes. It also obtains thread dumps for each Geode process but will not collect heap dumps.
-The collection utility copies all log and artifact files to its host machine and then compresses
all the files. You should ensure that the machine running the utility has sufficient disk
space to hold all the collected log and artifact files from the cluster.
-In default mode, the tool requires that a Geode process is running on each machine where
the tool is gathering logs and artifact files. If you would like to collect log and artifact
files from a machine or machines where Geode processes are not running, use *Static Copy Mode*
by specifying the `-m` option and providing a file that lists log and artifact file locations.
-The utility is provided in `$GEMFIRE/tools/LogCollectionUtility`.
-## Usage
-``` pre
-java -jar gfe-logcollect.jar -c <company> -o <output dir> [OPTIONS]
-Required arguments:
-        -c company name to append to output filename
-        -o output directory to store all collected log files
-Optional arguments:
-        -a comma separated list of hosts with no spaces. EG. host1,host2,host3 (defaults
to localhost)
-        -u username to use to connect via ssh (defaults to current user)
-        -i identity file to use for PKI based ssh (defaults to ~/.ssh/id_[dsa|rsa]
-        -p prompt for a password to use for ssh connections
-        -t ticket number to append to created zip file
-        -d don't clean up collected log files after the zip has been created
-        -s send the zip file to Pivotal support
-        -f ftp server to upload collected logs to.  Defaults to
-        -v print version of this utility
-        -h print this help information
-Static Copy Mode
-        -m <file> Use a file with log locations instead of scanning for logs.
-           Entries should be in the format hostname:/log/location
-## Known Limitations
-The following are known limitations with the tool:
-1.  Only supports Linux hosts.
-2.  Requires SSH access between machines.
-3.  Requires that the username be the same for each host that this app scans. For example,
you can't specify user@host1, anotherUser@host2, etc.
-4.  Requires that SSH access is available across all hosts using either the same password
or the same public key.
-5.  In order to get stacks using jstack, this process must be ran as the same user who owns
the Geode process.
-6.  Requires 'jps' (typically in $JAVA\_HOME/bin) to be in the user's PATH on each machine.
diff --git a/geode-docs/managing/logging/ b/geode-docs/managing/logging/
index db4de7e..c4fbaf6 100644
--- a/geode-docs/managing/logging/
+++ b/geode-docs/managing/logging/
@@ -41,8 +41,4 @@ Comprehensive logging messages help you confirm system configuration and
debug p
     Basic Geode logging configuration is configured via the file. This
topic is intended for advanced users who need increased control over logging due to integration
with third-party libraries.
--   **[Log Collection Utility](../../managing/logging/log_collection_utility.html)**
-    To aid in the troubleshooting of Apache Geode issues, you can use the provided log collection
utility to gather and upload log files and other troubleshooting artifacts. This tool is only
supported on Linux machines.

View raw message