Transferring Diagnostic Logs from an Appliance

Diagnostic files and debug logs are sometimes required to determine the root cause of operational issues. To access the compressed files and move them to a another location (such as your computer or a remote server), you can use third-party file transfer applications, such as Filezilla or WinSCP, or command-line utilities such as SCP or FTP. A file transfer user account is required to transfer files from the Solace CLI.

Creating a File Transfer User Account

To create a new file transfer user account, enter the following commands in the Solace CLI:

solace> enable solace# configure solace(configure)# create username <name> password <password> file-transfer

For more information about creating or editing file transfer user accounts, see Configuring File Transfer User Accounts

Transferring Diagnostic Files Using a Third-Party Application

To transfer files from the appliance to your computer, perform the following steps:

  1. On the Solace CLI, create a File Transfer User Account. For more information, see Configuring File Transfer User Accounts.
  2. If you have not already done so, create the log file by using the gather-diagnostics command. For more information, see Gathering Appliance Diagnostics.
  3. In your third-party file transfer application, connect to the event broker using port 22.
  4. Log in with the username and password you configured for your file transfer user account.
  5. Navigate to the logs directory and transfer the file to your computer.

Copying Diagnostic Files Using the Copy Command

To copy files from the appliance to a remote server using SCP or SFTP, enter the following commands in the Solace CLI:

solace> enable
solace# copy /logs/<log-file> [scp|sftp]://<username>@<ip-addr>/<directory>/

Where:

<log-file> is the name of the diagnostic file that you want to transfer.

<username> is the username for the remote server or computer.

<ip-addr> is the IP address of the remote server or computer. Port 22 must be available for the remote server or computer.

<directory> is the directory where the file you want to copy is located.

For example, to use the SCP to transfer the files, you can use the following copy command: 

copy /logs/gather-diagnostics.tgz scp://filetransferuser@192.168.1.100/tmp