Using the FFDC script

The first failure data capture (FFDC) script collects diagnostic and log information about events and conditions in your IBM Spectrum® Discover environment. Use the FFDC script to obtain diagnostic and log information or to collect data that can be used by IBM® service personnel to analyze problems in your environment.

The FFDC script must be run as the root user on the IBM Spectrum Discover master node.

The FFDC script creates an archived output file within the current working directory. The output file uses the following format: mo-ffdc-datestamp.tar.xz. For example, the output might look like this: mo-ffdc-20180430074006548.tar.xz.

Note: The FFDC script redacts user account and IP address information.

Using the FFDC script on Red Hat OpenShift

To use the FFDC script on Red Hat® OpenShift®, issue the following commands:
mkdir isd-files
cd isd-files
curl -s -O https://raw.githubusercontent.com/IBM/ibm-spectrum-discover-resources/2.0.5.2/ffdc.sh
chmod 777 ffdc.sh
./ffdc.sh all

FFDC script options

The FFDC script includes the following options. You can use only one option with the script.

To display a list of options for the script, use the ffdc command without an option: # ./ffdc

all
The all is the standard option that must be used when you are reporting a failure situation to IBM Service. Use this option, unless asked to do otherwise by IBM service personnel.
logs
The logs option archives some of the log directories, which are located under /var/log, from all nodes in the IBM Spectrum Discover cluster, including the DB2® Warehouse logs.
namespaces
The namespaces option collects information about all namespaces in Kubernetes. The information that is collected includes description of all the pods within the namespace, logs for all containers within the pods, and a log of events within the namespace. Use this option to collect audit log entries.
services
The services option collects service information for a number of services, including Docker, Kafka, and NFS, from all nodes in the IBM Spectrum Discover cluster.
system
The system option captures operating system statistics about details such as free disk space, the time since last restart, memory usage, and network ports.
versions
The versions option captures the version information for the operating system,
  • Docker
  • Cloudant®
  • Kafka
  • Kubernetes
ConfigMap
The "ConfigMap" collects all the ConfigMaps that are used to create the IBM Spectrum Discover deployment.