[
https://issues.apache.org/jira/browse/HAWQ-1480?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16180025#comment-16180025
]
ASF GitHub Bot commented on HAWQ-1480:
--------------------------------------
Github user janebeckman commented on a diff in the pull request:
https://github.com/apache/incubator-hawq-docs/pull/123#discussion_r140936073
--- Diff: markdown/admin/packcore.html.md.erb ---
@@ -0,0 +1,51 @@
+---
+title: HAWQ packcore 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
+ 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.
+-->
+
+## <a id="core_file_definition"></a>Core file
+
+Core file is a disk file that records the image of a process' memory in
case the process crashes or terminates abruptly. This image can be later used
to debug the state of process at the time when it was terminated. This
information can be very useful to debug the cause failure.
+
+## <a id="packcore_definition"></a>Packcore
+
+Packcore utility helps in packing a core file with its context –
executable, application and system shared libraries from the current
environment. This information can be later unpacked on a different system and
can be used for debugging. Packcore takes a core file, extracts the name of the
binary which generated the core and executes `ldd` (List Dynamic Dependencies)
to get the required information into a single tar archive.
+
+### <a id="using_packcore"></a>Using packcore
+
+The packcore utility is located under `${GPHOME}/sbin`. Following are the
options for packing a core file:
--- End diff --
Run one of the following commands to pack a core file:
> Packing a core file in hawq
> ---------------------------
>
> Key: HAWQ-1480
> URL: https://issues.apache.org/jira/browse/HAWQ-1480
> Project: Apache HAWQ
> Issue Type: Improvement
> Components: Command Line Tools
> Reporter: Shubham Sharma
> Assignee: Radar Lei
> Fix For: 2.3.0.0-incubating
>
>
> Currently there is no way to packing a core file with its context –
> executable, application and system shared libraries in hawq. This information
> can be later unpacked on another system and helps in debugging. It is a
> useful feature to quickly gather all the data needed from a crash/core
> generated on the system to analyze it later.
> Another open source project, greenplum, uses a script
> [https://github.com/greenplum-db/gpdb/blob/master/gpMgmt/sbin/packcore] to
> collect this information. Tested this script against Hawq's installation and
> it collects the required information needed for debug.
> Can this be merged into Hawq, if yes, I can submit a pull request and test it.
--
This message was sent by Atlassian JIRA
(v6.4.14#64029)
