Transfer Snapshot Output to Remote Console Over SSH Connection

Language:

As of Oracle ILOM firmware version 4.0.2, system administrators can choose to use the SSH Snapshot feature to transfer all Snapshot data directly to the client console over an established SSH session, rather than the conventional method of transferring the Snapshot data to a destination server over a separate network protocol like the tftp, sftp, and so on. With the SSH Snapshot feature, a non-text version of the output data is typically archived to a specified file destination on the remote host client system. The initiation of the SSH Snapshot operation is limited to a scripted or automated retrieval process where the encrypted data transfer is passed along during the setup of the SSH session.

Before You Begin

The Admin(a) role is required to configure the Snapshot property in Oracle ILOM.

To initiate the creation of a Snapshot and have its contents (raw data) redirected to a file over an existing SSH session, follow this procedure:

On a remote host client system, open a command-line interface and type:
- \> ssh -l root [IP_or_hostname of Oracle ILOM SP] set -script /SP/diag/snapshot dump_uri=console > [destination_file_name].zip
  
  Note - The -script command, when used, eliminates all system prompts by answering Yes to all Snapshot related collection prompts.
  
  Note - The encryption (encrypt_output=) option is not supported since the SSH Snapshot data is encrypted over the established SSH channel.
Where:
- ssh -l root [IP_or_hostname of Oracle ILOM SP] is the ssh connection info used to initiate the ssh session from the remote client system
- set /SP/diag/snapshot dump_uri=console is the CLI command that is passed along to initiate the snapshot collection
- -script is an optional command that can be used to eliminate system prompts during the Snapshot operation. When this command is used, all system related prompts are answered Yes during the Snapshot operation.
- > is the character symbol used to redirect the output to the destination file name
- [destination_file_name].zip is the file name on the client that will store the resulting Snapshot data output. Note that the .zip file extension is required to match the data format.