Purpose	Use the at command to schedule a CLI command or script to run at a later time.
Mode	cfg
Security Role(s)	crypto-officer
Syntax	at start [every interval] do action [report report-prefix]   is the high-level syntax for this command.
	start is the scheduled start time. This cannot be in the past unless you specify the optional date (below) and use every interval to run the job regularly. It breaks down into the following format: [date mm/dd/yyyy] HH:MM[:00] mm/dd/yyyy (optional) specifies a date (for example, 01/07/2005 for January 7, 2005). HH:MM[:00] is the hours and minutes on a 24-hour clock (for example, 04:00 means 4AM). The only possible value for seconds is 00.
	every interval (optional) creates a regular interval at which the CLI jobs run. This breaks down into one of two formats: every count {minutes | hours | days | weeks | months} count (1-4,294,967,295) is the number of minutes, hours, days, etc. between CLI runs. For example, every 10 minutes or every 6 months. minutes | ... months is a required choice. every {sunday | monday | tuesday | ... | saturday} creates a weekly interval that runs on the given day of the week.
	do action is required. The action is either a CLI command or a directive to run a script: do cli-command | do run cli-script cli-command (1-255 characters) is a valid CLI command. Surround this with quotation marks if it contains any spaces. For example, do show cifs-service user-sessions all. cli-script (1-255 characters) identifies a script of CLI commands in the scripts directory. Use the show scripts command for a full listing of available scripts.
	report report-prefix (optional, 1-255 characters) creates a report for the scheduled job. The report is named as follows: report-prefix_yyyymmddHHMM.rpt, where report-prefix is chosen here, yyyy is the year of the scheduled run, mm is the month, dd is the day, HH is the hour, and MM is the minute. Each run of the CLI job generates a report (if you specify an interval with the every option), so the date makes it possible to differentiate multiple reports for the same job.
Default(s)	every interval - none; the CLI command or script runs only once. report report-prefix - none; the at command does not generate a report (though the command itself may generate one).
Guidelines	The CLI displays the scheduled execution time after you enter this command. Use show at to view all pending CLI jobs. You can remove a job from the schedule with the clear at command. To run a script immediately, you can use the run command. To download a CLI-script file from an FTP, SCP, or TFTP site, use the copy command. You can use expect monitor to repeat any show command until a certain string appears in its output.
Samples	bstnA(cfg)# at 01:06 every 5 minutes do "show sessions" report adminSessions   The scheduled execution time for AT job ID '1' is: 8/26/10 1:06 AM   runs the show sessions command every 5 minutes. Each run generates a report with the prefix, adminSessions. See Figure 7.1 for a sample report.   bstnA(cfg)# at 10:30:00 do expect show firewall timeout 30   The scheduled execution time for AT job ID '2' is: 12/6/05 10:30 AM.   runs the expect show firewall command at 10:30 in the morning, once only. bstnA(cfg)# at date 05/05/2011 03:45:00 every 1 days do "active-directory update forest medarch.org proxy-user acoProxy2"   The scheduled execution time for AT job ID '3' is: 5/5/11 3:45 AM.   runs the active-directory update forest command at 3:45 AM, daily.
Related Commands	show at clear at copy ftp, copy scp, copy {nfs|cifs}, and copy tftp show scripts

Purpose	Every time someone uses the at command, one CLI job is added to the command schedule. Use the clear at command to remove one CLI job from this schedule, or to remove all of them.
Mode	priv-exec
Security Role(s)	crypto-officer
Syntax	clear at [job-id]   job-id (optional, 1-2,147,483,647) identifies a specific CLI job to clear. If you omit this, the command clears all CLI jobs. Use the show at command for a list of all scheduled CLI jobs, with their job IDs.
Default(s)	clear all scheduled CLI jobs if no job-id is used.
Guidelines	If you clear all scheduled jobs, the CLI prompts for confirmation. Enter yes to proceed. Use the at command to schedule a CLI command (or script) to run in the future, once or periodically. Use show at to view all pending CLI jobs.
Samples	bstnA# clear at Remove all 2 jobs from the command scheduler? [yes/no] yes bstnA# clears all scheduled CLI jobs.   bstnA# clear at 3 removes one scheduled CLI job, with job ID 3.
Related Commands	at show at

Purpose	Use the copy ftp command to transfer a file (such as a software-release file or a log file) to or from the ARX via FTP.
Mode	priv-exec
Security Role(s)	network-technician, network-engineer, storage-engineer, or crypto-officer (A backup-operator can copy reports.)
Syntax: Download to the Switch	copy ftp://[user[:password]@]server/source-file dir file   ftp://[user[:password]@]server/source-file (1-1024 characters) is the URL for the source file: user[:password]@ (optional) are the credentials for FTP access. If you omit them, they default to the credentials set by the ip ftp-user command. If you omit the password, the CLI prompts for one. server is the IP address or hostname for the FTP server. source-file is the source-file path. Lead with an extra slash (/) if the path is absolute (for example, ftp://10.1.1.5//var/rels/aco4665.rel). Use only one slash if the path is local to the home directory for user (for example, ftp://10.1.1.5/basic_ns.scr). This conforms with the specification for FTP URLs in RFC 1738. You cannot use wildcards (such as *). dir is the destination directory. Choose one of the following: configs, scripts, license, or releases. file (1-1024 characters) is the name you choose for the copy.
Syntax: Upload	copy directory file ftp://[user:password@]server/dest-path [format {text|report|csv|xml}]   directory is one of the following: logs, stats-logs, cores, configs, replicated-configs, reports, diag-info, software, scripts, capture, or license. file (1-1024 characters) identifies the source file from the above directory. You can use wildcards (such as *) to select multiple files. ftp://[user:password@]server/dest-path (1-1024 characters) is the URL for the destination directory or file (see above). format {text|report|csv|xml} (optional) applies to the reports directory only. This chooses the output format for the external copy of the report. The xml option converts the report to XML format, csv converts the report to a Comma-Separated-Value format (useful for spreadsheets), and the text and report options leave the reports in plain-text format.
Default(s)	user:password from the URL - the default set by ip ftp-user.
Guidelines	If you enter a user name without a password, the CLI prompts for the password before continuing. Enter the password for the user you included in the URL. Use copy scp to upload or download over a secure connection, using SCP. The copy tftp command uses TFTP (Trivial FTP) as a transport. To send out a file as an E-mail attachment, use copy smtp. The copy {nfs|cifs} command transfers files between the maintenance directories on the ARX and its client-accessible volumes. For a download to the local disks, you can use show directories directory-name to verify that the copy was successful. To move a file from the local disk to an FTP server, thereby removing it from the local disk, you can use the move ... ftp command. To manage local files, use delete and/or rename. To view ASCII files, use show directory file-name, tail, and/or grep.
Guidelines: Reformatting Reports to XML or CSV	For copies from the reports directory, you can reformat the copy to XML or CSV (comma-separated value) format. Use a .xml or .csv extension for the destination-file-name, and the copy assumes the chosen format. A .txt or .rpt extension leaves the destination file in plain-text format.
Guidelines: Wildcards	You can use several wildcard characters to select multiple source-file names for an upload: * matches any string, including an empty string. ? matches any single character. This is also a special meta character in the CLI, so you must quote the file-path string to use it; for example, copy logs traplog.? ftp ... would fail, but copy logs traplog.? ftp ... would succeed. [] surrounds a class of characters (for example, [abcz]), and matches any one of the characters inside the square brackets (a, b, c, or z). [a-z] matches any single character from the range a through z (all lower-case).
Samples	bstnA# copy ftp://jpublic@arxftp.f5.com/rel6.0.rel releases rel6.0.rel Password: jpassword downloads a release file, rel6.0.rel, from the FTP server at arxftp.f5.com.   bstnA# copy logs syslog ftp://noc.phredco.com/syslog-switch10 uploads the syslog to the FTP server at noc.phredco.com. This example uses the default username and password, set by ip ftp-user.
Related Commands	ip ftp-user copy scp copy tftp copy smtp copy {nfs|cifs} move ... ftp delete rename grep tail show directories

Purpose	Use the copy {nfs|cifs} command to transfer a file (such as a software-release file or a log file) between the ARX and one of its managed volumes.
Mode	priv-exec
Security Role(s)	network-technician, network-engineer, storage-engineer, or crypto-officer (A backup-operator can copy reports.)
Syntax: From Volume to Switch	copy {nfs|cifs} namespace vol-path source-file directory file   nfs | cifs is a required choice. This chooses the protocol for the file transfer. namespace (1-30 characters) identifies the namespace that holds the file. vol (1-1024 characters) is the name of the volume that holds the source file. source-file-path (1-1024 characters) is path to the source file, starting at the root of the above volume. You can use wildcards (such as *, ?, or [a-z]) to select multiple files; see the Guidelines: Wildcards below. directory is the destination directory. Choose one of the following: configs, scripts, license, or releases. file (1-255 characters) is the name you choose for the copy. If you copy a file into the releases directory, its extension must be .rel (for example, lastestRelease.rel).
Syntax: From Switch to Volume	copy directory file {nfs|cifs} namespace vol [dest-file-path] [format {text|report|csv|xml}]   directory is one of the following: logs, stats-logs, cores, configs, replicated-configs, reports, diag-info, software, scripts, capture, or license. file (1-1024 characters) identifies the source file from the above directory. As above, you can use wildcards (such as *) to specify multiple files. nfs | cifs is a required choice. This chooses the protocol for the file transfer. namespace (1-30 characters) identifies the namespace to hold the copy. vol (1-1024 characters) is the volume to hold the copy. dest-file-path (optional, 1-1024 characters) is the path to the destination file, starting at the volume root. If you omit this, the destination file appears in the volume root, and has the same name as the source file. format {text|report|csv|xml} (optional) applies to the reports directory only. This chooses the output format for the external copy of the report. The xml option converts the report to XML format, csv converts the report to a Comma-Separated-Value format (useful for spreadsheets), and the text and report options leave the reports in plain-text format.
Default(s)	None
Guidelines	This command is useful on a site that prohibits FTP access to the datacenter, or otherwise restricts network connections between the ARX and the Internet. You can go to a host in the client network to access the Internet, download a desired file to an ARX volume, and then use this copy command to copy the file into an ARX directory. For example, you could use this method to download a new release file from https://downloads.f5.com/esd/productlines.jsp and then copy it to the releases directory. The CLI chooses a user identity based on the transfer protocol. For NFS, the CLI uses root as its identity. For CIFS, the CLI uses the proxy-user (gbl-ns) for the chosen namespace. These identities typically ensure that there are no permissions problems during the copy operation. There are several alternative options for the copy command that access the network directly. The copy ftp command copies files over an FTP connection to or from a remote server. Use copy scp to upload or download over a secure connection, using SCP. The copy tftp command uses TFTP (Trivial FTP) as a transport. To send out a file as an E-mail attachment, use copy smtp. For a download to the local disks, you can use show directories directory-name to verify that the copy was successful. To move a file from the local disks to a ARX volume, thereby deleting it from the local disk, you can use the move ... {nfs|cifs} command. To manage local files, use delete and/or rename. To view ASCII files, use show directory file-name, tail, and/or grep.
Guidelines: Wildcards	You can use several wildcard characters to select multiple file names: * matches any string, including an empty string. ? matches any single character. This is also a special meta character in the CLI, so you must quote the file-path string to use it; for example, copy logs traplog.? cifs insur /claims would fail, but copy logs traplog.? cifs insur /claims would succeed. [] surrounds a class of characters (for example, [abcz]), and matches any one of the characters inside the square brackets (a, b, c, or z). [a-z] matches any single character from the range a through z (all lower-case).
Samples	bstnA# copy cifs medarcv /rcrds/maint/ 11658.rel releases latest.rel copies a release file, 11658.rel, from a directory in the medarcv~/rcrds volume. After the copy is complete, this command sequence could go on to load this release (with boot system and reload).   bstnA# copy logs syslog* nfs wwmed /acct/.admin/ copies all syslog files from the local logs directory to a hidden directory in wwmed~/acct, an NFS volume.
Related Commands	ip ftp-user copy scp copy tftp copy smtp move ... {nfs|cifs} delete rename grep tail show directories

Purpose	Use the copy ron command to securely copy a configuration or script file to another ARX on the current Resilient-Overlay Network (RON).
Mode	priv-exec
Security Role(s)	network-technician, network-engineer, storage-engineer, or crypto-officer
Syntax: Download to the Current Switch	copy ron source-arx source-directory source-file directory file   source-arx (1-30 characters) is the hostname of the remote ARX. Use the show ron command for a list of all ARX systems on the current RON. source-directory is the source directory on the remote ARX. Choose configs or scripts. source-file (1-1024 characters) is the name of the remote file. directory is the destination directory on the local ARX. You can choose configs or scripts. file (1-1024 characters) is the name you choose for the local copy.
Syntax: Upload to a Remote Switch	copy directory file ron dest-arx dest-directory [dest-file]   directory is configs or scripts. file (1-1024 characters) identifies the source file from the above directory. You can use wildcards (such as *, ?, or [a-z]) to select multiple files; see the Guidelines: Wildcards below. dest-arx (1-30 characters) is the hostname of the remote ARX. Use the show ron command for a list of all ARX systems on the current RON. dest-directory is the destination directory on the remote ARX. Choose configs or scripts. dest-file (optional, 1-1024 characters) is the name of the remote file. The CLI ignores this if you used wildcards to select multiple files.
Default(s)	None
Guidelines	This copy operation uses the ip ron-user credentials at the remote switch, or the current user credentials if no such RON user is defined. If the administrative account is not defined at the remote switch, or if it is defined with a different password, the copy operation fails. The file transfer is encrypted and sent with the Secure Copy (SCP) protocol. There are several other copy commands for copying files to or from other servers, or for copying to or from a client-accessible volume on the current switch. Use copy ftp or copy tftp to upload or download using FTP or TFTP. To copy a file to or from an SCP server in your network, use copy scp. To send out a file as an E-mail attachment, use copy smtp. The copy {nfs|cifs} command transfers files between the maintenance directories on the ARX and its client-accessible volumes. After a download to the local disks, you can use show directories directory-name to verify that the copy was successful. To manage local files, use delete and/or rename. To view ASCII files, use show directory file-name, tail, and/or grep.
Guidelines: Wildcards	You can use several wildcard characters to select multiple source-file names for an upload: * matches any string, including an empty string. ? matches any single character. This is also a special meta character in the CLI, so you must quote the file-path string to use it; for example, copy scripts homeDir.? ron ... would fail, but copy scripts homeDir.? ron ... would succeed. [] surrounds a class of characters (for example, [abcz]), and matches any one of the characters inside the square brackets (a, b, c, or z). [a-z] matches any single character from the range a through z (all lower-case).
Samples	bstnA# copy ron prtlndA scripts setupUsrShr.scr scripts setup.scr downloads a script, setupUsrShr.scrl, from a remote ARX named prtlndA.   provA# copy configs test.rcfg ron newptA configs test2.rcfg sends a replicated-config file to a remote ARX named newptA.
Related Commands	ip ron-user copy ftp copy tftp copy scp copy smtp copy {nfs|cifs} delete rename grep tail show directories

Purpose	Use the copy scp command to securely copy a file (such as a software-release file or a log file) to or from the ARX over SCP.
Mode	priv-exec
Security Role(s)	network-technician, network-engineer, storage-engineer, or crypto-officer (A backup-operator can copy reports.)
Syntax: Download to the Switch	copy scp://[user@]server:source-file directory file [accept-host-key]   scp://[user@]server:source-file (1-1024 characters) is the URL for the source file: user@ (optional if someone created an ip scp-user) is the username to present to the other end of the SCP connection. This user must be valid at the remote host. If you omit this and an ip scp-user is defined, it defaults to the username set by that command. server: is the IP address or hostname for the SCP host. End with a colon (:). source-file is the source-file path. Lead with a slash (/) if the path is absolute (for example, scp://root@10.1.1.5:/var/rels/aco4665.rel). Use no slash if the path is local to the home directory for user (for example, scp://root@10.1.1.5:basic_ns.scr). directory is the destination directory. Choose one of the following: configs, scripts, license, or releases. file (1-1024 characters) is the name you choose for the local copy. accept-host-key (optional) indicates that if the other end of the connection has an unknown SSH host key (that is, if it is new, or if its key has changed since the last time the host was contacted), the ARX should accept the new host key and continue with the download. Otherwise, the ARX stops the download if the host presents an unknown key.
Syntax: Upload	copy directory file scp://[user@]server:dest-path [accept-host-key] [format {text|report|csv|xml}]   directory is one of the following: logs, stats-logs, cores, configs, replicated-configs, reports, diag-info, software, scripts, capture, or license. file (1-1024 characters) identifies the source file from the above directory. You can use wildcards (such as *, ?, or [a-z]) to select multiple files; see the Guidelines: Wildcards below. scp://[user@]server:dest-path (1-1024 characters) is the URL for the destination. accept-host-key (optional) means to accept an unknown SSH host key from the remote host, if it presents one. format {text|report|csv|xml} (optional) applies to the reports directory only. This chooses the output format for the external copy of the report. The xml option converts the report to XML format, csv converts the report to a Comma-Separated-Value format (useful for spreadsheets), and the text and report options leave the reports in plain-text format.
Default(s)	None
Guidelines	If you enter a user name without a password, the CLI prompts you for a password after you issue this command. Enter the password for the user in the URL. The file is transferred over SCP, which uses a secure, encrypted connection to the remote host. Every host identifies itself with an encrypted SSH key. Whenever the ARX transfers a file using SCP, it exchanges keys with the remote host. If the remote-host key is different from one received previously, the host may not be the one you intended; an attacker may be posing as the intended host. For this reason, the ARX does not download or upload to a host with an unknown key unless you raise the accept-host-key flag. Note that the first contact with any server will require this flag to succeed. The ARX deletes all SSH host keys on reboot, so all remote hosts are again unknown when the switch comes back up. Use copy ftp or copy tftp to upload or download using FTP or TFTP. To send out a file as an E-mail attachment, use copy smtp. The copy {nfs|cifs} command transfers files between the maintenance directories on the ARX and its client-accessible volumes. After a download to the local disks, you can use show directories directory-name to verify that the copy was successful. To move a file from the local disk to an SCP server, thereby removing it from the local disk, you can use the move ... scp command. To manage local files, use delete and/or move. To view ASCII files, use show directory file-name, tail, and/or grep.
Guidelines: Wildcards	You can use several wildcard characters to select multiple source-file names for an upload: * matches any string, including an empty string. ? matches any single character. This is also a special meta character in the CLI, so you must quote the file-path string to use it; for example, copy logs syslog.? scp ... would fail, but copy logs syslog.? scp ... would succeed. [] surrounds a class of characters (for example, [abcz]), and matches any one of the characters inside the square brackets (a, b, c, or z). [a-z] matches any single character from the range a through z (all lower-case).
Samples	bstnA# copy scp://jpublic@myserver:rel2.0.rel releases r2.0.rel Password: password-for-jpublic downloads a release file, rel2.0.rel, from jpublics home directory at the host named myserver.   bstnA# copy logs syslog scp://noc:/var/logs/acolog10 accept-host-key uploads the syslog to a host named noc, using a default username and password. If the host key has changed for noc (or this is the first SCP to or from noc), the switch accepts the key and continues the upload.
Related Commands	ip scp-user copy ftp copy tftp copy smtp copy {nfs|cifs} move ... scp delete move grep tail show directories

Purpose	Use the copy smtp command to send a maintenance file (such as a software-release file or a log file) as an E-mail attachment. This syntax only supports uploads from the switch.
Mode	priv-exec
Security Role(s)	network-technician, network-engineer, storage-engineer, or crypto-officer (A backup-operator can copy reports, but no other type of file.)
Syntax	copy directory file smtp://[e-mail-address/]destination-file [format {text|report|csv|xml}]   directory is one of the following: logs, stats-logs, cores, configs, replicated-configs, reports, diag-info, software, scripts, capture, or license. file (1-1024 characters) identifies the source file from the above directory, such as a log file or a report. You can use wildcards (such as *, ?, or [a-z]) to select multiple files; see the Guidelines: Wildcards below. Each matching file results in a separate E-mail message. smtp://[e-mail-address/]destination-file (1-1024 characters) is an E-mail destination for the file: smtp:// is required. This declares that the destination is an E-mail address. e-mail-address (optional) is the recipient of the E-mail in username@host format (for example, jsmith@myco.com). If you omit this, the CLI uses the default address set by the cfg-smtp to command. destination-file is the name of the copy. If you used wildcards to select multiple files, this is the prefix for each copy. Each copy is sent as an attachment to the outbound E-mail message. format {text|report|csv|xml} (optional) applies to the reports directory only. This chooses the output format for the external copy of the report. The xml option converts the report to XML format, csv converts the report to a Comma-Separated-Value format (useful for spreadsheets), and the text and report options leave the reports in plain-text format.
Default(s)	the destination E-mail address defaults to the one set by the to command
Guidelines	DNS lookups must be configured for SMTP to function (see the documentation for ip name-server). Use copy ftp, copy tftp, or copy scp to upload or download using FTP, TFTP, or SCP. The copy {nfs|cifs} command transfers files between the maintenance directories on the ARX and its client-accessible volumes. To manage local files, use delete and/or move. To view ASCII files, use show directory file-name, tail, and/or grep.
Guidelines: Wildcards	You can use several wildcard characters to select multiple source-file names for an upload: * matches any string, including an empty string. ? matches any single character. This is also a special meta character in the CLI, so you must quote the file-path string to use it; for example, copy logs syslog.? smtp ... would fail, but copy logs syslog.? smtp ... would succeed. [] surrounds a class of characters (for example, [abcz]), and matches any one of the characters inside the square brackets (a, b, c, or z). [a-z] matches any single character from the range a through z (all lower-case).
Samples	bstnA# copy logs syslog smtp://juser@wwmed.com/syslog sends a copy of the syslog to juser@wwmed.com. The ARX sends the syslog as an attachment to a brief E-mail message.   bstnA# copy reports metadata_only.17.rpt smtp://juser@wwmed.com/mdo.csv sends a copy of a report to the same E-mail recipient. This command reformats the attachment into CSV before sending it (note the .csv extension on the destination file name).
Related Commands	copy ftp copy tftp copy scp copy {nfs|cifs} delete move grep tail show directories

Purpose	Use the copy tftp command to transfer a file (such as a software-release file or a log file) to or from the ARX via TFTP.
Mode	priv-exec
Security Role(s)	network-technician, network-engineer, storage-engineer, or crypto-officer (A backup-operator can upload reports to a remote host.)
Syntax: Download to the ARX	copy tftp://server/source-file directory file   tftp://server/source-file (1-1024 characters) is the URL for the source file: server is the IP address or hostname for the TFTP server. source-file is the source-file path. Lead with an extra slash (/) if the path is absolute (for example, tftp://10.1.1.5//var/rels/aco4665.rel). Use only one slash if the path is local to the tftpboot directory. This conforms with the specification for FTP URLs in RFC 1738. directory is the destination directory. Choose one of the following: configs, scripts, license, or releases. file (1-255 characters) is the name you choose for the copy.
Syntax: Upload	copy directory file tftp://server/dest-file [format {text|report|csv|xml}]   directory is one of the following: logs, stats-logs, cores, configs, replicated-configs, reports, diag-info, software, scripts, capture, or license. file (1-1024 characters) identifies the source file from the above directory. You can use wildcards (such as *, ?, or [a-z]) to select multiple files; see the Guidelines: Wildcards below. tftp://server/dest-file (1-1024 characters) is the URL for the destination file (see above). format {text|report|csv|xml} (optional) applies to the reports directory only. This chooses the output format for the external copy of the report. The xml option converts the report to XML format, csv converts the report to a Comma-Separated-Value format (useful for spreadsheets), and the text and report options leave the reports in plain-text format.
Default(s)	None
Guidelines	Use copy scp to upload or download over a secure connection, using SCP. Use copy ftp to upload or download using FTP. To send out a file as an E-mail attachment, use copy smtp. The copy {nfs|cifs} command transfers files between the maintenance directories on the ARX and its client-accessible volumes. After a copy to the local disks, you can use show directories directory-name to verify that the copy was successful. To move a file from the local disk to a TFTP server, thereby removing it from the local disk, you can use the move ... tftp command. To manage local files, use delete and/or rename. To view ASCII files, use show directory file-name, tail, and/or grep.
Guidelines: Wildcards	You can use several wildcard characters to select multiple source-file names for an upload: * matches any string, including an empty string. ? matches any single character. This is also a special meta character in the CLI, so you must quote the file-path string to use it; for example, copy capture nas?.cap tftp ... would fail, but copy logs nas?.cap tftp ... would succeed. [] surrounds a class of characters (for example, [abcz]), and matches any one of the characters inside the square brackets (a, b, c, or z). [a-z] matches any single character from the range a through z (all lower-case).
Sample	bstnA# copy tftp://tftp.f5.com/rel6.0.rel releases r6.0.rel downloads a release file, rel6.0.rel, from the TFTP server at tftp.f5.com.
Related Commands	copy ftp copy scp copy smtp copy {nfs|cifs} move ... tftp delete rename grep tail show directories

Purpose	The ARX contains directories for software-release files, log files, core files, report files, diagnostic information, and other maintenance files. Use the delete command to delete all files from a specified directory or to delete a specified file.
Mode	priv-exec
Security Role(s)	network-technician, network-engineer, storage-engineer, or crypto-officer
Syntax	delete {releases | logs | cores | reports | diag-info | scripts | capture} [file-name] delete {configs | license} file-name   releases | ... | capture identifies the directory. This is a required choice. file-name (1-1024 characters) identifies a file to delete from the above directory. This is optional for any directory except configs or license; if you omit it for one of the other directories, the command deletes all files in the chosen directory. You can also use wildcards for those directories (such as *, ?, or [a-z]); see the Guidelines: Wildcards below. Some files in the configs and license directories are required for system operation and/or reboot recovery, so you cannot delete all files (or use wildcards) in those directories. You must specify a file to delete.
Default(s)	None
Guidelines	The CLI prompts for confirmation before deleting any files; enter yes to delete the file(s). You cannot delete the running-release, armed-release, or backup-release file. You also cannot delete the active.license file in the license directory; removing the active license disables all storage services, so it is not recommended. (You can use clear active-license if you have been advised to remove the active license.) Do not delete core files unless advised to do so by F5 personnel; these files contain valuable data for diagnosing software problems. The show directories command displays a listing of all directories on the ARX. Use the grep, rename, copy, and delete commands to maintain these files.
Guidelines: Wildcards	You can use several wildcard characters to select multiple file names: * matches any string, including an empty string. ? matches any single character. This is also a special meta character in the CLI, so you must quote the file-path string to use it; for example, delete logs traplog.? would fail, but delete logs traplog.? would succeed. [] surrounds a class of characters (for example, [abcz]), and matches any one of the characters inside the square brackets (a, b, c, or z). [a-z] matches any single character from the range a through z (all lower-case).
Samples	bstnA# delete logs syslog5.log Delete file 'syslog5.log' in directory 'logs'? [yes/no] yes deletes the file named syslog5.log from the logs directory.   bstnA# delete logs syslog* Delete file 'syslog' in directory 'logs'? [yes/no/all] yes Delete file 'syslog.1' in directory 'logs'? [yes/no/all] all bstnA# deletes all syslog files from the logs directory.   bstnA# delete cores Delete all core files in directory 'cores'? [yes/no] yes deletes all files in the cores directory.
Related Commands	copy ftp copy scp copy tftp copy {nfs|cifs} grep rename show directories

Purpose	The ARX contains directories for software-release files, log files, core files, and other maintenance files. Use the grep command to filter one of these files, displaying the lines that match a pattern or text string.
Mode	(any)
Security Role(s)	crypto-officer, storage-engineer, network-engineer, network-technician, or operator
Syntax: One File	grep filter {releases | logs | stats-logs | cores | configs | replicated-configs | reports | software | scripts | capture | license} file-name [ ignore ignore ] [ tail lines ]   searches through one file. filter (1-255 characters) is the pattern or text string to search for in the file. See the Guidelines: Regular Expression below for the syntax. The grep displays all lines containing this pattern. releases | ... | license selects the directory. This is a required choice. file-name (1-1024 characters) identifies the file to read. ignore (optional) filters out text, and ignore (1-1024 characters) specifies a text string to ignore. tail (optional) displays the end of the file, and lines (1-1024) specifies how many lines to show at the end of the file.
Syntax: Directory	grep filter {releases | logs | stats-logs | cores | configs | replicated-configs | reports | software | scripts | capture | license} [ ignore ignore ] [ tail lines ]   searches through all files in a directory. filter (1-255 characters) is the pattern or text string to search for in the directory. See the Guidelines: Regular Expression below for the syntax. The grep displays all lines from all files containing this pattern. releases | ... | license selects the directory. This is a required choice. ignore (optional) filters out text, and ignore (1-1024 characters) specifies a text string to ignore. tail (optional) displays the end of the file, and lines (1-1024) specifies the number of lines to show.
Default(s)	None
Guidelines: Regular Expression	The regular expression syntax follows greps basic regular-expression syntax: . matches any single character. .* matches any string, including the null string. [...] matches any one of the enclosed characters. [a-z] matches any character in the sorted range, a through z. \ matches the next character, even if it has special meaning (for example, \. matches a period instead of any character). [^...] matches any character that is not enclosed.
Guidelines: Available Files	The show directories command displays maintenance directories of the hard disks on the ARX. These are the directories and files you can search with the grep command. Use the move, copy, and delete commands to maintain these files.
Samples	bstnA# grep :POLICY logs syslog searches for the string :POLICY in the syslog. Sample output appears in Figure 7.2 on page 7-24.   bstnA# grep :POLICY logs syslog ignore init is the same search, but without any lines containing init. Sample output appears in Figure 7.3 on page 7-24.   bstnA# grep :POLICY.*\.\.\. logs syslog ignore init searches for the same strings followed by an ellipses (...). Note the use of \. Sample output appears in Figure 7.4 on page 7-24.   bstnA# grep :POLICY.*\.\.\. logs syslog ignore init tail 5 is the same as the above example, but shows only the last 5 lines. Sample output appears in Figure 7.5 on page 7-24.   prtlndA# grep prtlndA.*CLI_COMMAND.*show namespace.*wwmed logs Searches for certain CLI commands in the logs directory. All log files are searched. Sample output appears in Figure 7.6 on page 7-25.
Related Commands	copy ftp copy scp copy tftp copy {nfs|cifs} copy smtp delete move move ... ftp move ... {nfs|cifs} move ... scp move ... tftp show directories

Purpose	When you use the copy or move command to transport files to/from an FTP site, you enter a username and password for the FTP server. Use the ip ftp-user command to set a default username and password. Use the no form of this command to revert to the anonymous default.
Mode	cfg
Security Role(s)	network-engineer or crypto-officer
Syntax	ip ftp-user name no ip ftp-user   name (1-32 characters) is the FTP username.
Default(s)	name - anonymous password - upgrade-hostname, where you can set the hostname with the hostname command.
Guidelines	The CLI prompts twice for a password. See the sample below. This command makes the copy ftp and move ... ftp commands easier to use; you can omit the username and password from each of these commands, defaulting to this one.
Sample	bstnA(cfg)# ip ftp-user jsmith Password: jpasswd Validate Password: jpasswd bstnA(cfg)# ... provides a username and password, jsmith and jpasswd, for transferring files to/from an FTP server.
Related Commands	copy ftp move ... ftp

Purpose	When you use the copy ron command to copy a file onto another ARX, you require an administrative username and password for the remote peer. Use the ip ron-user command to set a default username and password. Use the no form of this command to revert to using the current administrative account as the default.
Mode	cfg
Security Role(s)	network-engineer or crypto-officer
Syntax	ip ron-user name no ip ron-user   name (1-32 characters) is a valid administrative user at a remote ARX.
Default(s)	If this is not set, the copy ron command uses the username and password of the current administrative account.
Guidelines	The CLI prompts twice for a password. See the sample below.
Sample	bstnA(cfg)# ip ron-user jsmith Password: jpasswd Validate Password: jpasswd bstnA(cfg)# ... provides a username and password, jsmith and jpasswd, for sending file copies to a remote ARX.
Related Commands	copy ron

Purpose	When you use the copy or move command to transfer files to/from an SCP server, you enter a username and password for the SCP server. Use the ip scp-user command to set a default username and password for these operations. Use the no form of this command to remove the default.
Mode	cfg
Security Role(s)	network-engineer or crypto-officer
Syntax	ip scp-user name no ip scp-user   name (1-32 characters) is a Unix username that is valid on the remote SCP server(s).
Default(s)	None.
Guidelines	The CLI prompts twice for a password. See the sample below. This command makes the copy scp and move ... scp commands easier to use; you can omit the username and password from each command, defaulting to this one.
Sample	bstnA(cfg)# ip scp-user jsmith Password: jpasswd Validate Password: jpasswd bstnA(cfg)# ... provides a username and password, jsmith and jpasswd, for copying to/from an SCP server.
Related Commands	copy scp move ... scp

Purpose	The ARX contains directories for software release files, log files, report files, and other maintenance files. Use the move command to change the name of a file in one of these directories.
Mode	priv-exec
Security Role(s)	network-technician, network-engineer, storage-engineer, or crypto-officer
Syntax	move {logs | cores | configs | replicated-configs | diag-info | software | reports | scripts | capture | license} src-file-name dest-file-name   logs | ... | license identifies the directory. This is required. logs selects a log file. Use the show logs command for a full list of all available log files. cores selects a core-dump file generated by a failing process. The show cores command lists all such files that currently exist, if any. configs selects a configuration file, such as those generated by copy running-config and copy global-config. Use show configs to list them. replicated-configs selects a replicated-configuration file, from a remote ARX cluster. You can use these files for a disaster-recovery operation. Use show replicated-configs to list them. diag-info selects a diagnostics file generated by collect or collect logs. Use show diag-info to see if any are available. software selects a software-related file or a software-user manual. The show software command lists all of them. reports selects a report file. scripts selects a script file. Use show scripts to see all available scripts. capture selects a packet-capture file created by the capture session command. The show capture command lists all packet-capture files currently on the ARX. license selects a license file. The show license command lists all license-related files currently on the ARX. src-file-name (1-1024 characters) is the original file name, the file to rename. dest-file-name (1-1024 characters) is the new name you choose for the file.
Default(s)	None
Guidelines	The show directories command displays all files and directories on the ARX hard disks. You can also move files to an external servers. The move ... ftp command uploads over FTP, then deletes the source file after a successful copy operation. Use move ... scp to use a secure connection, SCP. The move ... tftp command uses TFTP (Trivial FTP) as a transport. The move ... {nfs|cifs} command transfers files from the maintenance directories on the ARX to its client-accessible volumes. Use the grep, copy, and delete commands to maintain these files.
Sample	bstnA# move diag-info ns_wwmed.tgz wwmed_11_12.tgz renames a diagnostics file.
Related Commands	move ... ftp move ... scp move ... tftp move ... {nfs|cifs} copy ftp copy scp copy tftp copy smtp copy {nfs|cifs} grep delete show directories

Purpose	Use the move ... ftp command to transfer a file (such as a core-dump file) off of the ARX via FTP. This command deletes the file after it is successfully copied, or leaves the file at the source location if the copy operation fails.
Mode	priv-exec
Security Role(s)	network-technician, network-engineer, storage-engineer, or crypto-officer (A backup-operator can move reports.)
Syntax	move directory file ftp://[user:password@]server/dest-file [format {text|report|csv|xml}]   directory is one of the following: logs, cores, configs, replicated-configs, reports, diag-info, software, scripts, capture, or license. file (1-1024 characters) identifies the source file from the above directory. ftp://[user:password@]server/dest-file (1-1024 characters) is the URL for the destination file: user[:password]@ (optional) are the credentials for FTP access. If you omit them, they default to the credentials set by the ip ftp-user command. If you omit the password, the CLI prompts for one. server is the IP address or hostname for the FTP server. dest-file is the new path that you want for the file. Lead with an extra slash (/) if the path is absolute (for example, ftp://10.1.1.5//var/caps/arx0107.cap). Use only one slash if the path is local to the home directory for user (for example, ftp://10.1.1.5/gffstnA.tgz). This conforms with the specification for FTP URLs in RFC 1738. format {text|report|csv|xml} (optional) applies to the reports directory only. This chooses the output format for the report. The xml option converts the report to XML format, csv converts the report to a Comma-Separated-Value format (useful for spreadsheets), and the text and report options leave the reports in plain-text format.
Default(s)	user:password from the URL - the default set by ip ftp-user.
Guidelines	If you enter a user name without a password, the CLI prompts for the password before continuing. Enter the password for the user you included in the URL. To copy a file over FTP instead of moving it, you can use the copy ftp command. You can also move (or copy) files using several additional protocols. Use move ... scp or copy scp to use an SCP connection for the move or copy operation. The move ... tftp and copy tftp commands use TFTP (Trivial FTP) as a transport. To send out a file as an E-mail attachment, use copy smtp. The move ... {nfs|cifs} and copy {nfs|cifs} commands transfer files between the maintenance directories on the ARX and its client-accessible volumes. To rename a file in its current ARX directory, you can use the move command. The move commands only upload to an external server. The equivalent copy commands can also download. For example, the copy ftp command FTP-copies a file to or from the ARX. To manage local files, use delete and/or move. To view ASCII files, use show directory file-name, tail, and/or grep.
Guidelines: Reformatting Reports to XML or CSV	For move operations out of the reports directory, you can reformat the file to XML or CSV (comma-separated value) format. Use a .xml or .csv extension for the destination-file-name, and the move operation converts the file to the chosen format. A .txt or .rpt extension leaves the file in plain-text format.
Sample	bstnA# move capture fsrvr.cap ftp://noc.phredco.com/bstnA_fsrvr.cap moves a packet-capture file off of the ARX and onto the FTP server at noc.phredco.com. This example uses the default username and password, set by ip ftp-user.
Related Commands	ip ftp-user move move ... scp move ... tftp move ... {nfs|cifs} copy ftp copy scp copy tftp copy smtp copy {nfs|cifs} delete grep tail show directories

Purpose	Use the move ... {nfs|cifs} command to transfer a file (such as a software-release file or a log file) from the ARX to one of its volumes. This command deletes the file after it is successfully copied to the volume, or leaves the file at the source location if the copy operation fails.
Mode	priv-exec
Security Role(s)	network-technician, network-engineer, storage-engineer, or crypto-officer (A backup-operator can move reports.)
Syntax	move directory file {nfs|cifs} namespace vol [dest-file-path] [format {text|report|csv|xml}]   directory is one of the following: logs, cores, configs, replicated-configs, reports, diag-info, software, scripts, capture, or license. file (1-1024 characters) identifies the source file from the above directory. You can use wildcards (such as *, ?, or [a-z]) to select multiple files; see the Guidelines: Wildcards below. nfs | cifs is a required choice. This chooses the protocol for the file transfer. namespace (1-30 characters) identifies the namespace to use as a destination. vol (1-1024 characters) is the volume where the file will go. dest-file-path (optional, 1-1024 characters) is the destination path for the file, starting at the volume root. If you omit this, the file goes to the volume root and keeps its original name. format {text|report|csv|xml} (optional) applies to the reports directory only. This chooses the output format for the report. The xml option converts the report to XML format, csv converts the report to a Comma-Separated-Value format (useful for spreadsheets), and the text and report options leave the reports in plain-text format.
Default(s)	None
Guidelines	The CLI chooses a user identity to establish its read/write privileges in the ARX volume. It chooses its identity based on the transfer protocol. For NFS, the CLI uses root as its identity. For CIFS, the CLI uses the proxy-user (gbl-ns) for the chosen namespace. These identities typically ensure that there are no permissions problems during the copy operation. To copy a file to a volume instead of moving it, you can use the copy {nfs|cifs} command. You can also move (or copy) files using several additional protocols.Use move ... scp or copy scp to use an SCP connection for the move or copy operation. The move ... tftp and copy tftp commands use TFTP (Trivial FTP) as a transport. To send out a file as an E-mail attachment, use copy smtp. The move ... ftp and copy ftp commands use FTP to send files to an external server. To rename a file in its current ARX directory, you can use the move command. The move commands only upload to an external server. The equivalent copy commands can also download. For example, the copy {nfs|cifs} command copies a file to or from an ARX volume. To manage local files, use delete and/or move. To view ASCII files, use show directory file-name, tail, and/or grep.
Guidelines: Wildcards	You can use several wildcard characters to select multiple file names: * matches any string, including an empty string. ? matches any single character. This is also a special meta character in the CLI, so you must quote the file-path string to use it; for example, move diag-info collNum?.tgz cifs medarcv /rcrds would fail, but move diag-info collNum?.tgz cifs medarcv /rcrds would succeed. [] surrounds a class of characters (for example, [abcz]), and matches any one of the characters inside the square brackets (a, b, c, or z). [a-z] matches any single character from the range a through z (all lower-case).
Sample	bstnA# move cores core-* nfs wwmed /acct/.admin/ moves all core-dump files from the local cores directory to a hidden directory in wwmed~/acct, an NFS volume.
Related Commands	move move ... ftp move ... scp move ... tftp copy ftp copy scp copy tftp copy smtp copy {nfs|cifs} delete rename grep tail show directories

Purpose	Use the move ... scp command to securely copy a file (such as a software-release file or a log file) to or from the ARX over SCP. This command deletes the file after it is successfully transferred, or leaves the file at the source location if the copy operation fails.
Mode	priv-exec
Security Role(s)	network-technician, network-engineer, storage-engineer, or crypto-officer (A backup-operator can move reports.)
Syntax	move directory file scp://[user@]server:dest-file [accept-host-key] [format {text|report|csv|xml}]   directory is one of the following: logs, cores, configs, replicated-configs, reports, diag-info, software, scripts, capture, or license. file (1-1024 characters) identifies the file to move out of the above directory. scp://[user@]server:dest-file (1-1024 characters) is the URL for the files destination: user@ (optional if someone created an ip scp-user) is the username to present to the other end of the SCP connection. This user must be valid at the remote host. If you omit this and an ip scp-user is defined, it defaults to the username set by that command. server: is the IP address or hostname for the SCP host. End with a colon (:). dest-file is the desired path for the file at the remote host. Lead with a slash (/) if the path is absolute (for example, scp://root@10.1.1.5:/var/arxDiags/6_5.tgz). Use no slash if the path is local to the home directory for user (for example, scp://root@10.1.1.5:6_5.tgz). accept-host-key (optional) means to accept an unknown SSH host key from the remote host, if it presents one. format {text|report|csv|xml} (optional) applies to the reports directory only. This chooses the output format for the report. The xml option converts the report to XML format, csv converts the report to a Comma-Separated-Value format (useful for spreadsheets), and the text and report options leave the reports in plain-text format.
Default(s)	None
Guidelines	If you enter a username in this command, the CLI prompts you for a password. Enter the password for the user in the URL. The file is transferred over SCP, which uses a secure, encrypted connection to the remote host. Every host identifies itself with an encrypted SSH key. Whenever the ARX transfers a file using SCP, it exchanges keys with the remote host. If the remote-host key is different from one received previously, the host may not be the one you intended; an attacker may be posing as the intended host. For this reason, the ARX does not download or upload to a host with an unknown key unless you raise the accept-host-key flag. Note that the first contact with any server will require this flag to succeed. The ARX deletes all SSH host keys on reboot, so all remote hosts are again unknown when the switch comes back up.
Guidelines: Additional Commands for Moving and Copying Files	To copy a file over SCP instead of moving it, you can use the copy scp command. You can also move (or copy) files using several additional protocols. The move ... tftp and copy tftp commands use TFTP (Trivial FTP) as a transport. To send out a file as an E-mail attachment, use copy smtp. The move ... ftp and copy ftp commands use FTP to send files to an external server. Use move ... {nfs|cifs} or copy {nfs|cifs} to move or copy a file to a volume on the current ARX. To rename a file in its current ARX directory, you can use the move command. The move commands only upload to an external server. The equivalent copy commands can also download. For example, the copy scp command copies a file to or from an external server. To manage local files, use delete and/or move. To view ASCII files, use show directory file-name, tail, and/or grep.
Sample	bstnA# move capture ntap.cap scp://root@noc:/var/logs/arx2ntap.cap accept-host-key Password: root-password uploads a packet-capture file to a host named noc. If the host key has changed for noc (or this is the first SCP to or from noc), the switch accepts the key and continues the upload. (For details on creating a packet-capture file, see the documentation for the capture session command.)
Related Commands	ip scp-user move move ... ftp move ... tftp move ... {nfs|cifs} copy scp copy ftp copy tftp copy smtp copy {nfs|cifs} delete grep tail show directories

Purpose	Use the move ... tftp command to transfer a file (such as a packet-capture file) off of the ARX via Trivial FTP (TFTP). This command deletes the file after it is successfully transferred, or leaves the file at the source location if the copy operation fails.
Mode	priv-exec
Security Role(s)	network-technician, network-engineer, storage-engineer, or crypto-officer (A backup-operator can upload reports to a remote host.)
Syntax	move directory file tftp://server/dest-file [format {text|report|csv|xml}]   directory is one of the following: logs, cores, configs, replicated-configs, reports, diag-info, software, scripts, capture, or license. file (1-1024 characters) identifies the source file from the above directory. tftp://server/dest-file (1-1024 characters) is the URL for the destination file: server is the IP address or hostname for the TFTP server. dest-file is the new path for the file. Lead with an extra slash (/) if the path is absolute (for example, tftp://10.1.1.5//var/diags/arxCllct.tgz). Use only one slash if the path is local to the tftpboot directory. This conforms with the specification for FTP URLs in RFC 1738. format {text|report|csv|xml} (optional) applies to the reports directory only. This chooses the output format for the report. The xml option converts the report to XML format, csv converts the report to a Comma-Separated-Value format (useful for spreadsheets), and the text and report options leave the report in plain-text format.
Default(s)	None
Guidelines	To copy a file over TFTP instead of moving it, you can use the copy tftp command. You can also move (or copy) files using several additional protocols. The move ... scp and copy scp commands use SCP (Secure CoPy) as a transport. To send out a file as an E-mail attachment, use copy smtp. The move ... ftp and copy ftp commands use FTP to send files to an external server. Use move ... {nfs|cifs} or copy {nfs|cifs} to move or copy a file to a volume on the current ARX. To rename a file in its current ARX directory, you can use the move command. The move commands only upload to an external server. The equivalent copy commands can also download. For example, the copy tftp command copies a file to or from an external server. To manage local files, use delete and/or move. To view ASCII files, use show directory file-name, tail, and/or grep.
Sample	bstnA# move capture 11_12.cap tftp://tftp.f5.com/11_12_arx.cap sends a packet-capture file, 11_12.cap, to the TFTP server at tftp.f5.com. (For details on creating a packet-capture file, see the documentation for the capture session command.)
Related Commands	move move ... ftp move ... scp move ... {nfs|cifs} copy ftp copy tftp copy scp copy smtp copy {nfs|cifs} delete grep tail show directories

Purpose	This command is useful in writing/running scripts when you want to pause the CLI temporarily.
Mode	(any)
Security Role(s)	operator
Syntax	pause [seconds]   seconds (optional; 0-3600) is the number of seconds to pause the CLI operation. If you omit this argument, the <Enter> key stops the pause.
Default(s)	0 (indefinite pause, until you press <Enter>)
Guidelines	You can use this command with terminal clear, which is also useful in writing scripts. For example, you could write a script that lets you view share status during a managed-volume import:   terminal clear show share status pause 60 terminal clear show share status pause 60 terminal clear show share status pause 60 terminal clear show share status pause 60 terminal clear show share status
Samples	bstnA# pause 300 pauses the CLI for 300 seconds (five minutes).   bstnA# pause Press <enter> to continue. pauses the CLI until you press <Enter>.
Related Commands	run terminal clear

Purpose	Use this command to enter a text-string comment into the syslog.
Mode	(any)
Security Role(s)	operator
Syntax	remark {critical | error | warning | notice | info | debug} comment-string   critical | error | warning | notice | info | debug is a required choice. This sets the severity of the message. comment-string (1-255 characters) is the message text. Insert quotation marks around the string if it contains any spaces.
Default(s)	None
Guidelines	Use show logging levels to verify the log-level settings for each component. From any mode, use show logs syslog or grep pattern logs syslog to view the log messages in the syslog file. See the manual, ARX Log Catalog, for a full list of log messages.
Sample	bstnA# remark critical J. Random bringing down NFS enters a critical message into the syslog.
Related Commands	show logging levels pause grep

Purpose	The ARX contains directories for software release files, log files, report files, and other maintenance files. Use the rename command to change the name of a file in one of these directories.
Mode	priv-exec
Security Role(s)	network-technician, network-engineer, storage-engineer, or crypto-officer
Syntax	rename {releases | logs | cores | reports | scripts | capture | license} src-file-name dest-file-name   releases | ... | license identifies the directory. This is required. logs selects a log file. cores selects a core dump file. reports selects a report file. scripts selects a script file. capture selects a packet-capture file created by the capture session command. license selects a license file. src-file-name (1-1024 characters) is the original file name, the file to rename. dest-file-name (1-1024 characters) is the new name you choose for the file.
Default(s)	None
Guidelines	The CLI prompts for confirmation before renaming a file; enter yes to proceed with the rename operation. The show directories command displays all files and directories on the ARX hard disks. Use the grep, copy, rename, and delete commands to maintain these files.
Sample	bstnA# rename releases rel8.rel fallback.rel   Rename file 'rel8.rel' in directory 'releases' to 'fallback.rel'? [yes/no] yes renames a release file.
Related Commands	grep copy ftp copy scp copy tftp copy {nfs|cifs} delete show directories

Purpose	This command enables you to run a CLI script.
Mode	priv-exec
Security Role(s)	network-technician, network-engineer, storage-engineer, or crypto-officer
Syntax	run {scripts | configs} script-name   scripts | configs selects the directory that holds the script. Use show scripts or show configs for file listings in these directories. script-name (1-1024 characters) identifies the CLI script file to run. Use show scripts to display the scripts directory contents.
Default(s)	None
Guidelines	Use this command to run a CLI script. You can only run a script that is in the scripts or configs directory. The script is comprised of CLI commands, one per line. Comments start with a semi-colon (;). To download a CLI-script file from an FTP, SCP, TFTP or other network service, use the copy command. If you want to run the script periodically, on a schedule, use the at ... do run command. There are several CLI commands (such as attach) that do not get committed until you exit the mode with either exit or end. The best practice is to use the end command at the end of any script; you can use this command from any mode under cfg or gbl mode. If you auto-generate a script (for example, with show running-config or show global-config), you must edit the script before you run it on an earlier release of ARX software. Command syntax may have changed as well as the best practices for command order. Consult the documentation from the earlier release (available from the GUI) and change the scripts commands as needed before you use this command to run it.
Sample	bstnA# run scripts testdemo1.scr runs the script, testdemo.scr.
Related Commands	copy ftp copy scp copy tftp copy {nfs|cifs} show scripts show configs show software show directories

Purpose	Use the show at command to display all scheduled CLI commands and/or scripts.
Mode	(any)
Security Role(s)	crypto-officer, storage-engineer, network-engineer, network-technician, or operator
Syntax	show at
Guidelines	Use the at command to schedule a CLI job to run in the future. This command displays two rows per scheduled CLI job. Each pair of rows contains the following columns: Job is a numeric ID for the scheduled job. This is assigned by the CLI when the user issues the at command. You can use this ID with clear at to clear the job. NextTime is the date and time for the next scheduled job run. This is in the following format: mm/dd/yyyy.HH:MM. Interval is the time between runs, if there is one. This is the every interval part of the at command. Command is the exact CLI command (or script) that is invoked at each run. Report is the prefix for the report generated at each run, if there is one. Each report is named as follows: report-prefix_yyyymmddHHMM.rpt. The part after the underscore is the date and time of the run. Use show reports to view the reports, if there are any.
Sample	bstnA# show at shows all scheduled commands and scripts. See Figure 7.7 for sample output.
Related Commands	at clear at

Purpose	The capture directory stores all files created by capturing IP traffic. Use this command to display the contents of the capture directory and/or the contents of a specified capture file.
Mode	(any)
Security Role(s)	crypto-officer, storage-engineer, network-engineer, network-technician, or operator
Syntax	show capture [file-name [summary [cifs|non-cifs]]]   file-name (optional, 1-1024 characters) is the name of the file to display. If you omit this, the CLI shows a list of all files in the directory. summary (optional) reduces the output to a group of summary tables, like those shown with Tshark -z. cifs | non-cifs (optional) is a filter on the summary output. If you choose cifs, the summary only counts packets related to CIFS traffic. These are packets to or from UDP/88, TCP/88, UDP/137, UDP/138, TCP/139, and/or TCP/445. The non-cifs option summarizes all packets except the ones to or from those ports.
Guidelines	You can capture IP traffic into a file with the capture session command. This command shows a list of all captured files or shows the contents of one of them. The contents of the capture file are similar to the output of TShark, a commonly available network-packet analyzer. The TShark program is built on the same Packet Capture (PCap) library as WireShark, a similar program with a graphical interface. The capture summary is similar to the output of Tshark -z. This shows a table of UDP conversations and TCP conversations, followed by RTT statistics for NFSv2, NFSv3, and SMB (or CIFS). The TCP and UDP tables have one row per pairing of IP addresses. The NFS tables do not appear if you use the cifs option, and the SMB tables do not appear if you enter the non-cifs option. Use the show directories command to show the contents of all directories on the ARX. To maintain this directory, use the copy, move, grep, and delete commands. While a capture session is underway, the ARX writes to its output file each time it captures IP packets. If the capture session writes to multiple files, it creates them all with a time stamp in each of their names. Use show capture sessions for a list of capture sessions that are currently underway.
Samples	bstnA> show capture     capture cifsVol.cap 06/29 01:55 220 kB clientCap.cap 06/29 01:45 15 MB fsrvr.cap 06/29 02:12 224 kB nasTraffic.cap 06/29 01:55 212 kB ntaps_00001_20110629060427.cap 06/29 02:04 24 B proxyTraffic_01620_20110629055529.cap 06/29 01:55 150 kB proxyTraffic_01621_20110629055531.cap 06/29 01:55 94 kB lists the directory contents.   bstnA> show capture nasTraffic_00001_20060328081103.cap Shows the contents of a capture file. See Figure 7.8 for sample output.   bstnA> show capture nasTraffic.cap summary Summarizes the contents of a capture file. See Figure 7.9 on page 7-46 for sample output.
Related Commands	capture session show capture sessions copy ftp, copy scp, copy {nfs|cifs}, copy tftp, and copy smtp move, move ... ftp, move ... scp, move ... {nfs|cifs}, move ... tftp, and move ... scp delete show directories

Purpose	Use this command to display the configs directory, which contains the switchs configuration files. You can also use this command to read one file from the directory.
Mode	(any)
Security Role(s)	crypto-officer, storage-engineer, network-engineer, network-technician, or operator
Syntax	show configs [file-name]   file-name (optional, 1-1024 characters) is the name of the file to display. If you omit this, the CLI shows a list of the directorys files.
Guidelines	Use the show directories command to show the contents of all directories on the ARX. To maintain this directory, use the copy, move, grep, and delete commands. The following files commonly appear in the configs directory: acopia.keystore is the SSH key for HTTPS connections to the GUI. This is the GUIs security certificate that is discussed in a pop-up when you first connect to the GUI. This file is in binary format, so you cannot read it. If you delete this file and restart the GUI (using gui restart), the ARX generates a new, self-signed, security certificate. omDbVersion.info contains the last understood database version. During a software upgrade, the ARX uses this file to determine if it requires a change in the database schema. boot-config contains the configuration parameters for setting up the administrative account created in the initial-boot script. This is a text file that can be run as a CLI script. The ARX runs this after it boots if (and only if) the startup-config is missing.
	startup-config is binary file with all configuration parameters on the ARX. The ARX uses this after it boots to recreate its entire configuration. It ignores the boot-config file if this file is present. You cannot view this file directly, though you can use copy startup-config, copy running-config, or copy global-config to copy the startup-config (or its components, the running-config and global-config) to a CLI script.
Sample	bstnA# show configs     configs wwmed.keystore 06/16 10:33 1.3 kB active.license 06/29 01:08 9.3 kB arx.dossier 04/11 22:54 3.0 kB arx.regkey 06/29 01:08 34 B boot-config 06/29 01:15 1.5 kB eeprom.dat 06/29 00:17 119 B fbstat.out 06/29 02:05 41 kB nlmd_ports.conf 06/29 00:19 52 B NSM_WR.cfg 06/23 13:53 10 kB oem-menu-log.txt 06/29 00:13 3.1 kB omDbVersion.info 06/29 00:16 281 B post_login.conf 06/29 01:14 40 B startup-config 06/29 02:05 7.5 MB
Related Commands	copy ftp copy scp copy tftp copy smtp copy {nfs|cifs} copy ron move move ... ftp move ... scp move ... tftp move ... {nfs|cifs} delete show directories

Purpose	A core file contains system-memory dumps from a software failure; this information is very useful in diagnosing software problems. All core files reside in the cores directory. Use the show cores command to display this directory or information from a core file.
Mode	(any)
Security Role(s)	crypto-officer, storage-engineer, network-engineer, network-technician, or operator
Syntax	show cores show cores file-name { backtrace | syslog | list | message | cmdinfo}   file-name (optional, 1-1024 characters) is the name of the core file to view. backtrace | syslog | list | message | cmdinfo is a required choice. backtrace displays information from the current program stack. See Figure 7.10 on page 7-51 for a sample backtrace. syslog displays contextual lines from the syslog file (many lines before and 20 lines after the core-dump event). list shows what types of information/files you can extract from the core file. You can use one of these items with show cores file-name list-item syntax, described below. message displays the syslog-file message that announced the core dump. Use the time stamp in this message to focus on the time of the software failure. cmdinfo displays the CLI output for the specified file/argument.
Guidelines	Use the copy command to copy the file off to an FTP server, an SCP host, a TFTP server, an E-mail recipient, or a namespace. The move command can send the file to one of those destinations and delete the original. Use move (with a local destination) to rename it, or delete to remove it.
Samples	stoweA# show cores     cores core-0001.dmp 06/29 03:50 332 kB core-0002.dmp 06/29 03:51 335 kB   shows two core-dump files.   bstnA> show cores core-0012.dmp backtrace shows the backtrace in another core-dump file. See Figure 7.10.
Related Commands	copy ftp copy scp copy tftp copy smtp copy {nfs|cifs} move move ... ftp move ... scp move ... tftp move ... {nfs|cifs} delete show directories

Purpose	Use this command to display the contents of the diag-info directory.
Mode	(any)
Security Role(s)	crypto-officer, storage-engineer, network-engineer, network-technician, or operator
Syntax	show diag-info
Guidelines	If someone issues a collect command with a local file as the target, a large diagnostics file is written to the diag-info directory. Use this command to prove that the file was created. Use the copy command to copy the file off to an FTP server, an SCP host, a TFTP server, an E-mail recipient, or a namespace. The move command can send the file to one of those destinations and delete the original. Use move (with a local destination) to rename it, or delete to remove it. To conserve disk space, the system only stores one diag-info file at a time.
Sample	bstnA> show diag-info   diag-info juser-ns-wwmed.tgz 06/29 08:17 6.3M
Related Commands	collect copy ftp copy scp copy tftp copy smtp copy {nfs|cifs} move move ... ftp move ... scp move ... tftp move ... {nfs|cifs} delete show directories

Purpose	The ARX contains directories on its hard disks where you can store release files, configuration scripts, and other switch-maintenance files. Use the show directories command to display all directories or enter show directory-name to display the contents for one directory only.
Mode	(any)
Security Role(s)	crypto-officer, storage-engineer, network-engineer, network-technician, or operator
Syntax	show directories show {releases | license | logs | stats-logs | cores | configs | reports | diag-info | auto-diagnostic | software | scripts }   directories shows all directories and their contents releases | logs | ... | scripts focuses on one directory.
Guidelines	The show directories command displays the maintenance files on the ARXs local hard disks. To maintain these directories, use the copy, move, grep, and delete commands.
Samples	bstnA> show directories shows all directories and their contents. See the sample output in Figure 7.11, below.   bstnA> show releases shows the contents of the releases directory.
Related Commands	copy ftp copy scp copy tftp copy {nfs|cifs} copy smtp move move ... ftp move ... scp move ... tftp move ... {nfs|cifs} delete grep

Purpose	Use this command to display the contents of the license directory and/or the contents of a specified license file. A license file specifies the features and capacity that are licensed for use on this ARX.
Mode	(any)
Security Role(s)	crypto-officer, storage-engineer, network-engineer, network-technician, or operator
Syntax	show license [file-name]   file-name (optional, 1-1024 characters) is the name of the file to display. If you omit this, the command displays the list of the directorys files.
Guidelines	Issue the command to view the directory contents. Then issue the command with a file name to view the contents of the given license file. The documentation for show active-license describes the detailed output for a license file. If the directory listing does not include  an active.license file, no license is active for the current ARX. You can use the license activate command to automatically activate a license, but only if the ARX is connected to the Internet. For an ARX that is off of the Internet, you can manually activate the license. Start with the license create license-dossier command for manual activation.
Samples	stkbrgA# show license shows all license files on the switch. For sample output, see Figure 7.12 on page 7-58.   stkbrgA# show license active.license shows the currently-active license file. For sample output, see Figure 7.13 on page 7-58.
Related Commands	show active-license license activate license create license-dossier copy ftp copy scp copy tftp copy {nfs|cifs} copy smtp move move ... ftp move ... scp move ... tftp move ... {nfs|cifs} delete show directories

Purpose	Use this command to display the contents of the logs directory and/or the contents of a specified log file.
Mode	(any)
Security Role(s)	crypto-officer, storage-engineer, network-engineer, network-technician, or operator
Syntax	show logs [file-name]   file-name (optional, 1-1024 characters) is the name of the file to display. If you omit this, the command displays the list of the directorys files.
Guidelines	Issue the command to view the directory contents. Then issue the command with a file name to view the file contents. The syslog file is arguably the most-important file in the logs directory. It shows detailed logs from most of the switch software. You can use the logging level command to change the volume of messages from each software subsystem. Namespaces, volumes, and shares are denoted in the syslog by their internal, numeric IDs: use the show id-mappings command to translate these IDs into names used in the CLI.
Sample	bstnA# show logs     logs error.log 06/29 02:03 185 kB fastpath 06/29 01:55 33 kB ha-reboot-history.log 06/29 00:13 322 B syslog 06/29 02:05 5.2 MB traplog 06/29 02:04 594 kB
Related Commands	copy ftp copy scp copy tftp copy {nfs|cifs} copy smtp move move ... ftp move ... scp move ... tftp move ... {nfs|cifs} delete show directories

Purpose	A software release for the ARX is packaged in a release file. All release files are stored in the releases directory. Use this command to display the contents of the releases directory and/or the version of a specified release file.
Mode	(any)
Security Role(s)	crypto-officer, storage-engineer, network-engineer, network-technician, or operator
Syntax	show releases [file-name] [verbose]   file-name (optional, 1-1024 characters) is the name of the file to display. If you omit this, the command displays the list of the directorys files. verbose (optional) runs a checksum test on the integrity of the downloaded release file.
Guidelines	Issue the command without any options for a list of release files on the ARX. Then issue the command with a file name to view the specific release file. The directory output shows one row for each release file. The table has five columns: Flags appear in the first column to indicate how the release file is used: B is a flag for the Backup release, if any. This is the software release that was running prior to the current release. F5 personnel can roll the switch back to this release if needed. R is the flag for the currently-Running release. A flags the Armed release. This is the software to be loaded on the next reboot. Use boot system to arm the switch with a new release file. Use reload to reboot and put the new release file into service. The release-file name is in the next column. The date and time, in the third column, is the time the file was copied to the switch. The size of the file is in the fourth column. The next column, usually blank, says incomplete between the time that the file is downloaded and the switch has performed an integrity check. The switch does not use the release file until this check is complete. It should complete at the end of the download, automatically; a poorly-timed switch reload may prevent the check. In this case, replace the file. The version of the release appears in the final column. The version appears in Vrelease.build format, where build is a specific build in the given release. For example, V5.02.000.12574 would appear for build 12574 of release 5.02.000. If you issue the command with a file name, the output shows the version number, the date the release was built, and the username that ran the build. If you use the verbose option, the results of a checksum test appear. If this shows that the checksum failed, retry the copy of the release file.
Samples	provA# show releases shows all releases on the switch. For sample output, see Figure 7.14, below.   provA# show releases test1.rel Version 5.02.000.12568 (May 14 2010 20:19:21) [nbuilds] shows one release file.   provA# show releases test1.rel verbose Version 5.02.000.12568 (May 14 2010 20:19:21) [nbuilds] Checksum: Passed show that the release files checksum passed.
Related Commands	copy ftp copy scp copy tftp copy {nfs|cifs} copy smtp move move ... ftp move ... scp move ... tftp move ... {nfs|cifs} delete show directories

Purpose	Use this command to display the replicated-configs directory, which contains configuration files from a remote ARX. You can use these files to recreate the remote configuration in case of a disaster at the remote site. You can use this command to list all of the replicated-configuration files on the current ARX, or to read one configuration file from the directory.
Mode	(any)
Security Role(s)	crypto-officer, storage-engineer, network-engineer, network-technician, or operator
Syntax	show replicated-configs [file-name]   file-name (optional, 1-1024 characters) is the name of the file to display. If you omit this, the CLI shows a list of the directorys files.
Guidelines	Use the show directories command to show the contents of all directories on the ARX. To maintain this directory, use the copy, move, grep, and delete commands. This holds global-configuration files from remote ARX clusters. You can create a config-replication rule to regularly copy a global-config file from one cluster to another. The files contents are an ordered list of CLI commands required to recreate the remote clusters global configuration; they are the same as the output for show global-config.
Samples	newptA# show replicated-configs     configs-replication provSvcs.rcfg 04/02 03:08 12 kB testrun2.rcfg 04/02 03:08 12 kB   lists all replicated-config files on the newptA chassis.   newptA# show replicated-configs provSvcs.rcfg   shows the above files contents. For sample output, see Figure 7.15 on page 7-63.
Related Commands	config-replication show global-config copy ftp copy scp copy tftp copy smtp copy {nfs|cifs} copy ron move move ... ftp move ... scp move ... tftp move ... {nfs|cifs} delete show directories

Purpose	Use this command to display the contents of the reports directory and/or the contents of a specified file in the directory.
Mode	(any)
Security Role(s)	operator or backup operator (any)
Syntax	show reports show reports report-name show reports type report-type show reports type report-type report-name   If you omit both options, the command displays the full list of the directorys files. report-name (optional, 1-1024 characters) is the name of the report to display. report-type (optional, 1-12 characters) specifies the type of report to list. Enter show reports type ? for a full list of report types.
Guidelines	Issue the command (perhaps with a type specification) to view the directory contents. Then issue the command with a file name to view the file contents. When you use the command to list reports, the output is a table with one line per report. Each line shows a summary status for the job that generated the report. To see the one-line status for a particular report, use show reports status. Some reports run over a long period of time. To wait for a report to finish (perhaps in a CLI script), you can use wait-for report.
Samples	bstnA# show reports lists all reports. See Figure 7.16 on page 7-65 for sample output.   bstnA> show reports inconsistencies.12.rpt shows one report. See Figure 7.17 on page 7-68.   bstnA> show reports type Imp shows all import reports. See Figure 7.18 on page 7-69.
Related Commands	copy ftp copy scp copy tftp copy {nfs|cifs} copy smtp move move ... ftp move ... scp move ... tftp move ... {nfs|cifs} delete show directories show reports status wait-for report

Purpose	Use this command to show a one-line summary of a given report.
Mode	(any)
Security Role(s)	operator (any except backup operator)
Syntax	show reports status report-name   report-name (optional, 1-1024 characters) is the name of the report to summarize.
Guidelines	Use this command to get a one-line status for the job that created the report. The line is the same as the one shown by show reports. The line shows a summary status for the job that generated the report, with the following fields: report-name.rpt last-mod-time size type status report-name identifies the report. For time-sensitive reports, this name contains a date stamp for when the report was created, either manually or on a schedule. The report is created when an administrator invokes a report-generating command or when a rules schedule fires. last-mod-time is the time of the reports most-recent change. size is the amount of internal-disk space that the report uses. You can use copy ftp and similar commands to copy reports off the ARX, and delete reports report-name to clear a report from the disk. type indicates the process that created the report. This column uses the same abbreviations used for the type report-type option, above. status shows the current or final state of the operation (typically DONE or FAILED) followed by a summary of the results. The summary shows a number of objects processed (such as files and directories) and the elapsed time for the report run. The elapsed time is the time since the report was created, which may be longer than the actual time the process ran; view the report contents to find actual processing times.
Sample	bstnA# show reports status status import.2.bills.6.rpt shows the status for an import report. See Figure 7.19 for sample output.
Related Commands	show reports

Purpose	Use this command to display the contents of the scripts directory and/or the contents of a specified script file.
Mode	(any)
Security Role(s)	crypto-officer, storage-engineer, network-engineer, network-technician, or operator
Syntax	show scripts [file-name]   file-name (optional, 1-1024 characters) is the name of the file to display. If you omit this, the command displays the list of the directorys files.
Guidelines	Issue the show scripts command to view the directory contents. Then issue the command with a file name to view the file contents.
Samples	bstnA# show scripts     scripts analyze-failover 06/20 20:00 95 B change-mfg-date.scr 06/20 20:00 631 B check-global.scr 06/20 20:00 1.9 kB check-hw.scr 06/20 20:00 1.8 kB check-run.scr 06/20 20:00 3.0 kB clean_reports 06/20 20:00 1.3 kB cli_script_testdir.scr 11/16/2010 0 B cli_script.scr 11/16/2010 0 B global 06/29 02:05 24 kB import_rate 06/20 20:00 16 kB jiltdump 06/20 20:00 2.1 kB logging.scr 07/10/2010 218 B monitor 06/20 20:00 1.3 kB nslookup 06/20 20:00 773 B power 06/20 20:00 1.6 kB run_cfg.scr 07/08/2010 10 kB running 06/29 02:05 12 kB schemadump.sql 06/08 14:34 696 B share_status 06/20 20:00 4.1 kB show 06/20 20:00 660 B show_chassis.scr 05/18 10:37 70 B start_conf 06/29 02:05 36 kB test-global-config_orig.scr 06/15 17:27 24 kB test-global-config.scr 06/15 17:38 24 kB test-running-config_orig.scr 06/15 17:27 10 kB test-running-config.scr 06/15 17:38 10 kB traceroute 06/20 20:00 922 B ttcp 06/20 20:00 2.1 kB
Related Commands	copy ftp copy scp copy tftp copy smtp copy {nfs|cifs} move move ... ftp move ... scp move ... tftp move ... {nfs|cifs} delete show directories

Purpose	Use this command to display the contents of the ARX software directory and/or the contents of a specified MIB file in that directory.
Mode	(any)
Security Role(s)	crypto-officer, storage-engineer, network-engineer, network-technician, or operator
Syntax	show software [file-name]   file-name (optional, 1-1024 characters) is the name of the file to display. If you omit this, the command displays the list of the directorys files.
Guidelines	The software directory contains MIBs, user documentation, and some useful scripts. Issue the show software command to view the directory contents. Then issue the command with a file name to view the file contents (this only works with the text-based files, such as MIBs and scripts). To view the documentation, use one of the copy commands (copy ftp, copy scp, copy {nfs|cifs}, copy tftp, or copy smtp) to upload it to an external machine. Then use a standard PDF reader or plugin. PDF readers are freely available on the Internet.
Sample	bstnA# show software shows the full contents of the software directory. See Figure 7.20 for sample output.
Related Commands	copy ftp copy scp copy tftp copy {nfs|cifs} copy smtp delete rename show directories

Purpose	The ARX has an internal stats-monitor process that monitors communication with external devices (such as filers and clients) and places statistical data about this communication in the stats-logs directory. Use this command to display the contents of the stats-logs directory or the contents of a specific stats-log file.
Mode	(any)
Security Role(s)	crypto-officer, storage-engineer, network-engineer, network-technician, or operator
Syntax	show stats-logs [file-name]   file-name (optional, 1-1024 characters) is the name of the file to display. If you omit this, the command displays the list of the directorys files.
Guidelines	Issue the command to view the directory contents. Then issue the command with a file name to view the file contents. The stats-logs are all in CSV format, so that you can copy them onto an external device and use Microsoft Excel (or a similar spreadsheet application) to view them as spreadsheets. You can use copy ftp, copy {nfs|cifs}, copy smtp, or similar copy commands to copy these files off of the ARX. If you select a stats-monitor sampling interval that is shorter than the default, the stats-monitor process writes to these .csv files more frequently. These .csv files are kept (together with all other log files) on a separate disk partition from configuration files and other important data. Each hour, the stats-monitor creates an hourly file with the first line of the new hour; this is a summary of the data in the raw file. The stats-monitor files are not permitted to consume more than 80% of the log partition. If the .csv files approach their size limit, the oldest raw-data files are removed and the hourly-summary files remain.
Guidelines: File Names	The stats-log files use the following naming convention: source_YYYYMMDD_hhmmss.{raw|hourly}.stats.csv where source is the source process or group of devices that generated the statistics. These are cifs-service (related to a cifs front-end service and its clients; these statistics are similar to the CIFS output from show statistics namespace ... summary), cifs-service-auth (CIFS-authentication statistics, also visible with show statistics cifs authentication), nfs-service (for an nfs service and its clients, similar to the NFS output from show statistics namespace ... summary), cifs-share or nfs-share (back-end shares behind an ARX volume, viewable with show statistics namespace ... summary on an individual share), metadata (used to locate files behind a managed volume, and stored on an external metadata share; you can also see these statistics with show statistics metadata),
Guidelines: File Names (Cont.)	metalog (volume-state information required for redundancy failovers; these statistics are also viewable with show statistics metalog), cifs-work-queue (internal data structures for managing CIFS tasks, also viewable with show statistics cifs work-queues), domain-controller (related to traffic between internal CIFS processes and external DCs; these statistics are similar to the output from show statistics domain-controller), and migration (related to place-rules and other policies that migrate files between back-end shares; these statistics are related to the output from show statistics migration). YYYYMMDD_hhmmss is the date and time the file was created. raw|hourly differentiates between a file with raw data and an hourly file with roll-up data. The stats-monitor process writes to each raw-data file as often as dictated by the sampling interval setting. It creates an hourly file for each source once per hour, with the first set of data for the next hour. If the sampling interval is less than one hour, the hourly files act as summaries of the raw-data files: they show the data samples at the beginning of the hour, but not the changes in those values during the hour.
Guidelines: File Format	The top line of any stats-log file has the following format: BEGIN source version=v timestamp=nnnnnnnnnn where source is the same as the source in the file name, defined above, v is a version number for the stats-monitor, and nnnnnnnnnn is the number of seconds since the first second of 1970, UTC. The second line shows the data types of each field in the files rows. The possible data types are TIMESTAMP identifies a time as the number of seconds since epoch, as above. KEY is a unique value that identifies the object being monitored (such as a volume-group ID). COUNTER is an integer to show a count. INTERVAL and TOTALTIME are time intervals, in microseconds (millionths of a second). TEXT The third row is the name of each field. The remaining rows contain data, arranged in columns below the names in the above row. STATS_RESET marks when a reboot, a clear statistics cifs work-queues, or a clear statistics filer occurred to clear some statistics. This has a ts (time-stamp) field, followed by some KEY fields to identify the object statistics that were cleared.
Samples	bstnA# show stats-logs   shows a list of all stats-log CSV files. See Figure 7.21 for sample output.   provA# show stats-logs metadata_20110705_041347.raw.stats.csv   shows a particular stats-log CSV file. See Figure 7.22 on page 7-78 for sample output.
Related Commands	stats-monitor -> sampling interval copy ftp copy scp copy tftp copy {nfs|cifs} copy smtp move move ... ftp move ... scp move ... tftp move ... {nfs|cifs} delete show directories

Purpose	Use the tail command to display the end of a file selected from a specified directory.
Mode	(any)
Security Role(s)	network-technician
Syntax	tail {releases | logs | stats-logs | cores | configs | replicated-configs | reports | software | scripts | capture | license} file-name [lines | follow] tail capture file-name [lines]   releases | ... | license identifies the directory. This is a required choice. file-name (1-1024 characters) identifies the file to display. This command shows the last 24 lines of the file. You can use the optional lines argument or follow flag to change the number of lines: lines (optional; 1-4096) is the number of lines at the end of the file to display. follow (optional) makes the CLI follow the file as it grows.
Guidelines	Use show directories to view a list of all files in all directories. Use show directory-name (for example, show logs or show capture) to list the files in one directory.
Samples	bstnA# tail logs syslog follow tails the syslog file as it grows. This displays all syslog messages in real time.   bstnA# tail logs syslog 100 displays the last 100 lines of the syslog file.   bstnA# tail scripts myscript.scr displays the last 24 lines of the myscript.scr script file.   bstnA# tail capture cifsVol.cap follow tails a packet-capture file, cifsVol.cap, as it grows. You can use the capture session command to start capturing packets and sending them to a file.
Related Commands	grep pause show directories show releases, show logs, show stats-logs, show cores, show configs, show replicated-configs, show reports, show software, show scripts, show capture, show license

Purpose	To stop a process from generating a report, use the truncate-report command. This truncates the report without otherwise affecting the process.
Mode	priv-exec
Security Role(s)	network-technician, network-engineer, storage-engineer, or crypto-officer
Syntax	truncate-report file-name   file-name (1-255 characters) identifies the report file to truncate. This must be a file in the reports directory; use show reports for a file listing.
Guidelines	This command prompts for confirmation before truncating the report; enter yes to continue. The nsck utility can generate several report types, one per nsck job. To stop the nsck utility from writing to the report, use this command. The utility continues processing after the report is truncated. This command is used the same way for any report, from any process.
Samples	bstnA# truncate-report last-modified.22.rpt Truncate report ''last-modified.22.rpt''? [yes/no] yes bstnA# truncates a report.
Related Commands	show reports

Purpose	Use the wait-for report command to wait until the ARX finishes writing a report.
Mode	(any)
Security Role(s)	network-technician, network-engineer, storage-engineer, or crypto-officer
Syntax	wait-for report report-name [timeout timeout]   report-name (1-255 characters) identifies the report. You can use the show reports command to list all of them. timeout (optional, 1-2096) is a timeout value, in seconds. This sets a time limit; if the report takes longer than this to complete, the wait-for operation quits.
Default(s)	timeout - 0 (zero, meaning that the wait-for command should wait indefinitely)
Guidelines	This command is useful in CLI scripts. Many commands create reports to show their progress (such as nsck ... report metadata-only), and some internal operations generate reports (such as the various reports produced as a by-product of a share enable (gbl-ns-vol-shr)). You can use this command to wait for any given process to finish writing a report. If you set a timeout and it expires before the report is finished, the command exits with a warning.
Sample	bstnA# wait-for report remService_medco_201005260714.rpt waits for the ARX to finish writing a remove-service report.
Related Commands	show reports