PowerScaleOneFS 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 <commands>]
  [--include]
  [--incremental]
  [--full]
  [--list-known-commands | -l]
  [-f <filename>]
  [-n <node-lnns>]
  [--local-only]
  [--skip-node-check]
  [-s]
  [-1]
  [-a]
  [-x <exclude-command>]
  [-I]
  [-L]
  [-T <temp-dir>]
  [-t <tarfile>]
  [--tardir <tardir>]
  [--symlinkdir <symlinkdir>]
  [--varlog-recent]
  [--varlog-all]
  [--nologs]
  [--group <group-name>]
  [--no-dumps]
  [--dumps]
  [--no-net-transport]
  [--net-transport]
  [--no-cores]
  [--cores]
  [--no-iceage-reports]
  [--iceage-reports]
  [--debug]
  [--verbose]
  [--no-console-logging]
  [--log-to <location>]
  [--timeout]
  [--parallelism]
  [--processes]
  [--no-status]
  [--gather-begin]
  [--gather-past]
  [--noconfig]
  [--save-only]
  [--save]
  [--reference]
  [--noupload]
  [--upload]
  [--re-upload <filename>]
  [--verify-upload]
  [--clean-cores]
  [--clean-dumps]
  [--clean-reports]
  [--clean-all]
  [--clean-none]
  [--clean-only]
  [--http-insecure]
  [--nohttp]
  [--http-host <http-host>]
  [--http-port <http-port>]
  [--http-path <http-path>]
  [--http-proxy <http-host>]
  [--http-proxy-port <http-port>]
  [--ftp]
  [--noftp]
  [--set-ftp-password]
  [--ftp-insecure]
  [--ftp-user <ftp-user>]
  [--ftp-pass <ftp-password>]
  [--ftp-host <ftp-host>]
  [--ftp-path <ftp-dir>]
  [--ftp-ssl-cert <ftp-ssl-cert>]
  [--ftp-port <ftp-port>] 
  [--ftp-proxy <ftp-host>]
  [--ftp-proxy-port <ftp-proxy-port>]
  [--ftp-mode <ftp-mode>]
  [--esrs]
  [--noesrs]
  [--supportassist]
  [--nosupportassist]

Gather Bundle Options

--help | -h

Shows help details.

--version | -v | -V <version>

Shows version info.

--user | -u <user>

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

--password | -p <password>

Uses <password>. A -p or --password argument must be paired with a user argument

--i COMMANDS_TO_RUN [COMMANDS_TO_RUN..] | --include COMMANDS_TO_RUN [COMMANDS_TO_RUN..]

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. By default most utilities are not added. The all value will increase the gather size.

To include the Technical Support Report (TSR), specify --include=tsr_logs (requires elevated Support privileges).

--incremental

Gathers only those logs that changed since last log upload.

--full

Gathers logs regardless of last upload.

--list-known-commands | -l

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

--filse_to_gather | -f <filename>

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

--nodes | -n <node LNNs>

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 [GATHER_SCRIPT...] | --gather_script GATHER_SCRIPT [GATHER_SCRIPT...]

Runs <gather_script> on every node. This happens during the gather process and the result is stored at the root of each node directory in the gather.

-1 LOCAL_GATHER_EXPRESSION [LOCAL_GATHER_EXPRESSION...] | --local_gather_expression LOCAL_GATHER_EXPRESSION [LOCAL_GATHER_EXPRESSION...]

Runs <local_gather_expression> on the local node. This is run during the gather process. The results are stored in the /local directory of a gather. A valid gather expression is any shell command.

-a | --results-analyze-script<results_analyze_script>

Runs <results_analyze_script> on the results of a gather.

-x EXCLUDE_COMMAND | --exclude_command EXCLUDE_COMMAND

Excludes the specified command from being gathered by isi_gather_info. For a list of commands names, use -x, or run -l.

-I | --save_to_ifs

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

-L | --save_to_local

Save all results to local storage /var/crash/support/.This option is mutually exclusive with the -T option.

-T | --temp <temp-dir>

Saves all results to <temp-dir> instead of the default directory. This option is mutually exclusive with the -L option.

-t | --tarfile <tarfile>

Saves all results to the specified <tarfile> rather than to the default tar file name (IsilonLogs-<node_name>-<date>-<time>.tgz).

--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.

--varlog-all

Gathers all logs in /var/log, including compressed and rotated old logs. This is the default options and will only change if --varlog-recent is used.

--nologs

Does not gather the default logs.

--group <group>

Only gathers the component groups specified by the group field.

--no-dumps

Does not gather hang dumps for the package.

--dumps

Gathers hang dumps for the package. These can be very large and are included by default.

--no-net-transport

Does not add net_transport failures to the package.

--net-transport

Gathers net_transport failures in the package. These are included by default.

--no-cores

Does not gather core files for the package. Default is to collect core files.

--cores

Adds core files to the package. These can be very large and are included by default.

--no-iceage-reports

Does not gather IceAge reports to the package. The default is to collect IceAge reports.

--iceage-reports

Gathers IceAge reports to the package. IceAge reports can be large and are included by default.

--clean-cores

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

--debug

Displays debugging messages in the log files.

--verbose

Displays more detailed information.

--no-console-logging

Does not write logging information to the package.

--log-to<dir>

Directory to write log files to.

--timeout TIMEOUT TIMEOUT

Should be in the form of: (< > indicates a field, and a pipe (|) indicates a value) <COMMAND_NAME | 'all'> <TIMEOUT | 'none'> COMMAND_NAME should be the name of the command you wish to change the timeout for. The option all will change the timeout values for all commands. TIMEOUT should be an integer value for the new desired timeout value, in seconds. If set to none or 0, there will be no timeouts for those commands. This flag can be specified more than once.

--parallelism{1,0}

Indicates which model of parallelism to use. The only supported options are: SERIAL, which runs the commands in serial, regardless of what the --processes flag indicates, and SUBPROCESS, which runs commands in parallel as indicated by the fork.

--processes<integer>

Indicates how many simultaneous gather commands should be run on a given node. Integer cannot be larger than 3000.

--no-status

Disables the status screen.

--gather-begin

Sets the starting time of files to be gathered using the datetime format. The accepted datetime format should be in the form of 'YYYY-MM-DD [HH:MM]' where time is optional. For example: '2023-06-16' or '2023-06-16 01:36'. This will gather all files that have been modified since that date and time.

--gather-past

Enter a number followed by a letter to gather files modified within this time range. For example, 1h for files modified in the last hour. Other supported times include 'd' for days and 'w' for weeks.

--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.

--reference REFERENCE

Saves the reference file and runs it.

--noupload

Do not automatically upload logs to Dell Technologies Technical Support.

--upload

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

--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.

--clean-cores

Deletes core files from /var/crash after running gather and successful compression of the package.

--clean-dumps

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

--clean-reports

Deletes reports from /var/crash after running gather and successful compression of the package.

--clean-all

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

--clean-none

Does not clean up any files after successful compression of the package.

--clean-only

Cleans gather artifacts and then exits. Works with --clean-cores, --clean-dumps, and --clean-all.

--http-insecure

Attempts insecure HTTP upload.

--nohttp

Specifies no HTTP upload attempt. This is the default setting.

--http-host <http-host>

Specifies an alternate HTTP site for upload.

--http-port <http-port>

Specifies an alternate HTTP port for upload. Default is port 80.

--http-path <http-path>

Specifies an alternate HTTP upload directory.

--http-proxy <http-proxy>

Specifies the HTTP proxy server to use.

--http-proxy-port <http-proxy-port>

Specifies the HTTP proxy port to use.

--ftp

Attempts FTP upload. This setting is the default value.

--noftp

Specifies no FTP upload attempt.

--set-ftp-password

Specifies an alternate password for FTP (interactive).

--ftp-insecure

Specifies plain text for FTP upload.

--ftp-user <ftp-user>

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

--ftp-pass <ftp-password>

Specifies an alternate password for FTP.

--ftp-host <ftp-host>

Specifies an alternate FTP site for upload.

--ftp-path <ftp-dir>

Specifies an alternate FTP upload directory.

--ftp-ssl-cert <ftp-ssl-cert>

Specifies an SSL certificate for FTP upload attempt.

--ftp-port <ftp-port>

Specifies an alternate FTP port for upload.

--ftp-proxy <ftp-proxy>

Specifies the FTP proxy server to use.

--ftp-proxy-port <ftp-proxy-port>

Specifies the FTP 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 (default).

--noesrs

Does not attempt ESRS upload.

--supportassist

Attempts SupportAssist upload. This is the default.

--nosupportassist

Does not attempt a SupportAssist upload.