PowerScale OneFS 9.3.0.0 CLI Command Reference

Multiple instances of -i, -f, -s, -S, and -1 are allowed.

gather_expr and analysis_expr can be quoted.

The default temporary directory is /ifs/data/Isilon_Support/ (change with -L or -T).

Syntax

isi_gather_info 
  [-h]
  [-v]
  [-u <user>]
  [-p <password>]
  [-i]
  [--incremental]
  [-l]
  [-f <filename>]
  [-n <nodes>]
  [--local-only]
  [--skip-node-check]
  [-s gather-script]
  [-S gather-expr]
  [-1 gather-expr]
  [-a analysis-script]
  [-A analysis-expr]
  [-t <tarfile>]
  [-x exclude_tool]
  [-I]
  [-L]
  [-T <temp-dir>]
  [--tardir <dir>]
  [--symlinkdir <dir>]
  [--varlog_recent]
  [--varlog_all]
  [--nologs]
  [--group <name>]
  [--clean-cores]
  [--clean-all]
  [--no-dumps]
  [--dumps]
  [--no-cores]
  [--cores]
  [--upgrade-archive]
  [--debug]
  [--verbose]
  [--noconfig]
  [--save-only]
  [--save]
  [--upload]
  [--noupload]
  [--re-upload <filename>]
  [--verify-upload]
  [--http]
  [--nohttp]
  [--http-host <host>]
  [--http-path <dir>]
  [--http-proxy <host>]
  [--http-proxy-port <port>]
  [--ftp]
  [--noftp]
  [--ftp-user <user>]
  [--ftp-pass <password>]
  [--ftp-host <host>]
  [--ftp-path <dir>]
  [--ftp-port <alt-port>] 
  [--ftp-proxy <host>]
  [--ftp-proxy-port <port>]
  [--ftp-mode <mode>]
  [--esrs]
  [--email]
  [--noemail]
  [--email-addresses]
  [--email-from]
  [--email-subject]
  [--email-body]
  [--skip-size-check]

Options

-h

Prints this message and exits.

-v

Prints version info and exits.

-u <user>

Specifies the login as <user> instead of as the default root user.

-p <password>

Uses <password>.

-i

Includes only the listed utility. See also the -l option for a list of utilities to include. The special value all may be used to include every known utility.

--incremental

Gathers only those logs that changed since last log upload.

-l

Lists utilities and groups that can be included. See -i and --group.

-f <filename>

Gathers <filename> from each node. The value must be an absolute path.

-n <nodes>

Gathers information from only the specified nodes. Nodes must be a list or range of LNNs, for example, 1,4-10,12,14. If no nodes are specified, the whole array is used. Note that nodes are automatically excluded if they are down.

--local-only

Gathers information only from only the local node. Run this option when gathering files from the /ifs filesystem.

--skip-node-check

Skips the check for node availability.

-s gather-script

Runs <gather-script> on every node.

-S gather-expr

Runs <gather-expr> on every node.

-1 gather-expr

Runs <gather-expr> on the local node.

-a analysis-script

Runs <analysis-script> on results.

-A analysis-expr

Runs <analysis-expr> on every node.

-t <tarfile>

Saves all results to the specified <tarfile> rather than to the default tar file.

-x exclude_tool

Excludes the specified tool or tools from being gathered from each node. Multiple tools can be listed as comma-separated values.

-I

Saves results to /ifs. This is the default setting.

-L

Save all results to local storage /var/crash/support/.

-T <temp-dir>

Saves all results to <temp-dir> instead of the default directory. -T overrides -L and -l.

--tardir <dir>

Places the final package directly into the specified directory.

--symlinkdir <dir>

Creates a symlink to the final package in the specified directory.

--varlog_recent

Gathers all logs in /var/log, with the exception of the compressed and rotated old logs. The default setting is all logs.

--varlog_all

Gathers all logs in /var/log, including compressed and rotated old logs. This is the default setting.

--nologs

Does not gather the required minimum number of logs.

--group <name>

Adds a specific group of utilities to the tar file.

--clean-cores

Deletes cores from /var/crash after successful compression of the package.

--clean-dumps

Deletes dumps from /var/crash after successful compression of the package.

--clean-all

Deletes cores and dumps from /var/crash after successful compression of the package.

--no-dumps

Does not gather hang dumps for the package.

--dumps

Adds cores to the package.

--no-cores

Does not gather cores for the package.

--cores

Adds dumps to the package.

--upgrade-archive

Adds the upgrade archive to the package.

--debug

Displays debugging messages.

--verbose

Displays more detailed information.

--noconfig

Uses built-in default values and bypasses the configuration file.

--save-only

Saves the CLI-specified configuration to file and exits.

--save

Saves the CLI-specified configuration to file and runs it.

--upload

Uploads logs to Isilon Technical Support automatically. This is the default setting.

--noupload

Specifies no automatic upload to Isilon Technical Support.

--re-upload <filename>

Re-uploads the specified <filename>.

--verify-upload

Creates a tar file, uploads to test connectivity, and verifies that the uploaded tar file is the same size as the local tar file. This process includes a complete log gather. To verify connectivity without performing a complete log gather, use the --nologs option.

--http

Attempts HTTP upload. This is the default setting.

--nohttp

Specifies no HTTP upload attempt.

--http-host <host>

Specifies an alternate HTTP site for upload.

--http-path <dir>

Specifies an alternate HTTP upload directory.

--http-proxy <host>

Specifies the proxy server to use.

--http-proxy-port <port>

Specifies the proxy port to use.

--ftp

Attempts FTP upload. This setting is the default value.

--noftp

Specifies no FTP upload attempt.

--ftp-user <user>

Specifies an alternate user for FTP (default: anonymous).

--ftp-pass <password>

Specifies an alternate password for FTP.

--ftp-host <host>

Specifies an alternate FTP site for upload.

--ftp-path DIR

Specifies an alternate FTP upload directory.

--ftp-port <alt-port>

Specifies an alternate FTP port for upload.

--ftp-proxy <host>

Specifies the proxy server to use.

--ftp-proxy-port <port>

Specifies the proxy port to use.

--ftp-mode <mode>

Specifies the mode of FTP file transfer. The following values are valid: both, active, passive. The default value is both.

--esrs

Attempts ESRS upload.

--email

Attempts SMTP upload. If set, SMTP is tried first.

--noemail

Specifies no SMTP upload attempt. This is the default value.

--email-addresses

Specifies email addresses as comma-separated strings.

--email-from

Specifies the sender's email address.

--email-subject

Specifies an alternative email subject.

--email-body

Specifies alternative email text shown on head of body.

--skip-size-check

Does not check the size of the gathered file.