Collects information for the first-failure data capture of SAN File System problems, from either a client machine or the storage engine.
>>-obdc--+------------+--+-----------------+--------------------> +--c---------+ '- --cleanallobdc-' '- --confirm-' >--+----------------+--+-----------------+--+--------------+----> +--h-------------+ | (1) | '- --noarchive-' +- --home=-------+ '---noprompt------' '-home_directory-' >--+---------------+--+---------+--+------------------+---------> '- --nocompress-' +---name=-+ +--o---------------+ '-value---' +- --output=-------+ '-output_directory-' >--+----------+--+-----------+--+---------------------+---------> +--q-------+ '- --stdout-' +--t------------------+ '- --quiet-' +- --temp=------------+ '-temporary_directory-' >--+------------+--+-----------+--+------------+--+---------+---> +---timeout=-+ '- --totals-' +--v---------+ '- --help-' '-value------' '- --verbose-' >--+------------+--+------------------+------------------------>< '- --version-' | .--------------. | | V .-basic----. | | '---+-config---+-+-' +-crash----+ +-full-----+ +-hardware-+ +-images---+ +-info-----+ +-internal-+ +-logs-----+ +-os-------+ '-perf-----'
This is the default collection option if no command-line options are specified.
The obdc command gathers data for diagnosing errors or failures associated with metadata servers and clients. This command is intended primarily for first-failure data-capture capabilities useful for investigating problems upon their initial occurrence, without requiring problem recreation or subsequent tracing.
This command must be invoked natively on the metadata server or client machine from which you want to collect information. For a metadata server, this command can be invoked using the SAN File System console or the administrative command-line interface (CLI). The CLI command is named collectdiag. For a metadata server or client, the command can be invoked from a command shell (on UNIX®) or a command prompt (on Windows®). The SAN File System console provides true one-button running of the command against a specified metadata server, but it always issues the command with the default parameters for all parameters. Invoke the command using one of the alternate methods if you need to specify non-default parameters.
Privileges
The obdc command relies upon a number of SAN File System and operating system commands that require certain administrative privileges. To run the command, you must be logged in as root on a UNIX platform or Administrator on a Windows platform.
Collected data
The obdc command collects data for metadata servers, administrative servers, and clients of a SAN File System configuration, regardless of platform. The command relies both on SAN File System administrative commands and on operating-system commands to obtain much of the data it collects. It creates a GZIP-compressed tar file (by default) in the time-stamped output directory to record the results of the administrative and operating system commands that it invokes. In the event that the process from which data is requested is unavailable (for example, if the metadata server is unavailable or unresponsive), the command records a suitable message and continues without collecting data from the unavailable process. This command also assembles various configuration, log, trace, and core files in the output directory.
The obdc command collects information related to both hardware and software. The specific information gathered depends on the platform, the SAN File System configuration of the machine, and the parameters specified. In general, this command collects more data for metadata servers than for clients, due to the greater function and complexity of the metadata server configuration.
Within these general categories, the command gathers essential component information (for example, name, version, and configuration), current status, logged messages, trace and diagnostic output, core files, and performance statistics and metrics, among other things. Not all types of information pertain to all hardware and software components about which information is collected.
/usr/tank/client/bin/obdc basic images
Parent topic: Service commands and utilities