Remote support scripts

After you enable remote support through ESRS, Isilon Technical Support personnel can request logs with scripts that gather cluster data and then upload the data.

The remote support scripts that are based on the isi diagnostics gather start and isi diagnostics netlogger tools are located in the /ifs/data/Isilon_Support/ directory on each node.

Note Image

The isi diagnostics gather, and isi diagnostics netlogger commands replace the isi_gather_info command.

Additionally, If ESRS is enabled then isi_phone_home, a tool that focuses on cluster and node-specific data, is enabled. This tool is pre-set to send information about a cluster to Isilon Technical Support on a weekly basis. You can disable or enable isi_phone_home from the OneFS command-line interface.

The following tables list the data-gathering activities that remote support scripts perform. At the request of an Isilon Technical Support representative, these scripts can be run automatically to collect information about the configuration settings and operations of a cluster. Information is sent to ESRS over the secure ESRS connection, so that it is available for Isilon Technical Support personnel to analyze. The remote support scripts do not affect cluster services or data availability.

Table 1. Commands and subcommands for isi diagnostics gather
Command
Description
isi diagnostics gather start
Begins the collection, and uploads all recent cluster log information.
isi diagnostics gather stop
Stops the collection of cluster information.
isi diagnostics gather status
Provides the cluster status.
isi diagnostics gather view
View the information.
isi diagnostics gather settings modify --clear ftp host
Clear the value of the FTP host for which to upload.
isi diagnostics gather settings modify --clear ftp pass
Clear the value for FTP users password.
isi diagnostics gather settings modify --clear ftp path
Clear the value for path on FTP server for the upload.
isi diagnostics gather settings modify --clear ftp proxy
Clear the value for proxy server for FTP.
isi diagnostics gather settings modify --clear ftp proxy port
Clear the value for port for proxy server for FTP.
isi diagnostics gather settings modify --clear ftp ftp user
Clear the value for FTP user.
isi diagnostics gather settings modify --clear http host
Clear the value for HTTP host to which it uploads.
isi diagnostics gather settings modify --clear htttp path
Clear the value for path for the upload.
isi diagnostics gather settings modify --clear htttp proxy
Clear the value for proxy to use for HTTP upload.
isi diagnostics gather settings modify --clear htttp proxy port
Clear the value for proxy port to use for HTTP Upload.
isi diagnostics gather settings modify --esrs
Use ESRS for gather upload.
isi diagnostics gather settings modify --ftp-host
Use the FTP host to which it uploads.
isi diagnostics gather settings modify --ftp-pass
The FTP users password.
isi diagnostics gather settings modify --ftp-path
The path on FTP server for the upload.
isi diagnostics gather settings modify --ftp-proxy
Proxy server for FTP.
isi diagnostics gather settings modify --ftp-proxy-port
The port for proxy server for FTP.
isi diagnostics gather settings modify --ftp-upload
Whether to use FTP upload on completed gather.
isi diagnostics gather settings modify --ftp-user
The FTP user.
isi diagnostics gather settings modify --ftp-gather-mode
Type of gather: incremental, or full.
isi diagnostics gather settings modify --help
Display help for this command.
isi diagnostics gather settings modify --http-host
The HTTP host to upload to.
isi diagnostics gather settings modify --http-path
The path for the upload.
isi diagnostics gather settings modify --http-proxy
The proxy to use for HTTP upload.
isi diagnostics gather settings modify --http-proxy-port
The proxy port to use for HTTP Upload.
isi diagnostics gather settings modify --http-upload
Whether to use HTTP upload on completed gather.
isi diagnostics gather settings modify --upload
Enable gather upload.
Table 2. Commands and subcommands for isi diagnostics netlogger
Command
Description
isi diagnostics netlogger start
Starts the netlogger process.
isi diagnostics netlogger stop
Stops the netlogger process.
isi diagnostics netlogger status
Provides the netlogger status.
isi diagnostics netlogger view
View the netlogger capture files.
isi diagnostics netlogger settings modify --clients
Client IP address or addresses for which to filter.
isi diagnostics netlogger settings modify --count
The number of capture files to keep after they reach the duration limit. Defaults to the last 3 files.
isi diagnostics netlogger settings modify --duration
How long to run the capture before rotating the capture file. The default is10 minutes.
isi diagnostics netlogger settings modify --help
Displays help for this command.
isi diagnostics netlogger settings modify --interfaces
Specify the network interfaces on which to capture.
isi diagnostics netlogger settings modify --nodelist
List of nodes on which to run capture.
isi diagnostics netlogger settings modify --ports
TCP or UDP port or ports for which to filter.
isi diagnostics netlogger settings modify --protocols
Protocols to filter: TCP, UDP, IP, ARP.
isi diagnostics netlogger settings modify --snaplength
Specify how much of the packet to display. The default is 320 bytes, a 0 value shows all of the packet.
Table 3. Cluster information scripts
Action
Description
Clean watch folder
Clears the contents of /var/crash.
Get application data
Collects and uploads information about OneFS application programs.
Generate dashboard file daily
Generates daily dashboard information.
Generate dashboard file sequence
Generates dashboard information in the sequence that it occurred.
Get ABR data (as built record)
Collects as-built information about hardware.
Get ATA control and GMirror status
Collects system output and invokes a script when it receives an event that corresponds to a predetermined eventid.
Get cluster data
Collects and uploads information about overall cluster configuration and operations.
Get cluster events
Gets the output of existing critical events and uploads the information.
Get cluster status
Collects and uploads cluster status details.
Get contact info
Extracts contact information and uploads a text file that contains it.
Get contents (var/crash)
Uploads the contents of /var/crash.
Get job status
Collects and uploads details on a job that is being monitored.
Get domain data
Collects and uploads information about the cluster’s Active Directory Services (ADS) domain membership.
Get file system data
Collects and uploads information about the state and health of the OneFS /ifs/ file system.
Get IB data
Collects and uploads information about the configuration and operation of the InfiniBand back-end network.
Get logs data
Collects and uploads only the most recent cluster log information.
Get messages
Collects and uploads active /var/log/messages files.
Get network data
Collects and uploads information about cluster-wide and node-specific network configuration settings and operations.
Get NFS clients
Runs a command to check if nodes are being used as NFS clients.
Get node data
Collects and uploads node-specific configuration, status, and operational information.
Get protocol data
Collects and uploads network status information and configuration settings for the NFS, SMB, HDFS, FTP, and HTTP protocols.
Get Pcap client stats
Collects and uploads client statistics.
Get readonly status
Warns if the chassis is open and uploads a text file of the event information.
Get usage data
Collects and uploads current and historical information about node performance and resource usage.