Loader

System Logging

The tolt system logging line item is used for requesting an archive of the current log.

 

Tolt system logging collect-logs action 

Action 

Value 

Comment 

Collect-logs 

 

Action to collect all the log files, and create a tgz file of them and make available to users. 

Filename 

<string> 

The filename to give the log file.  Do not include an extension, it will be added by the log collection. 

Remote-url 

<string> 

If using sftp to push logs to a remote site, specify the sftp url in a format acceptable to curl. 

 

         Username 

<string> 

The username to use when authenticating to an sftp server for log push. 

        Password 

<string> 

The password to use when authenticating to an sftp server for log push. 

 

  • Command Path – tolt>system>logging>
  • Module – tolt
  • Container – system
  • Action – logging
  • Types – 
    • collect-logs – Action to collect all the log files, and create a tgz file of them and make them available to users.
    • filename – The filename to give the log file.  Do not include an extension, it will be added by the log collection
      • string

    • remote-url – If using sftp to push logs to a remote site, specify the sftp url in a format acceptable to curl.
      •  string

    • username – The username to use when authenticating to an sftp server for log push. 
      •  string

    • password – The password to use when authenticating to an sftp server for log push..
      •  string

System Logging Action Local File Example 

The following example will show how to create an archive of the logs in a local sftp directory on the BOLT. 

  1. From the MDS1-ESUA# command line, input tolt system logging collect-logs filename test1 and press Enter
  2. Output similar to the following is displayed:
     
    MDS1-ESUA# tolt system logging collect-logs filename test1 <enter> 
    action-success true
    MDS1-ESUA# _ 
    

System Logging Action Remote sftp Example 

The following example will show how to perform a remote push of the logs to an sftp server.  Note that typically an explicit file path is required and the URL needs to terminate with a slash.   

  1. From the MDS1-ESUA# command line, input tolt system logging collect-logs filename test1 remote-url sftp://172.28.152.30/home_dir/lbob/ username test-user password ************, and press Enter
  2. Output similar to the following is displayed:
     
    MDS1-ESUA# tolt system logging collect-logs filename test remote-url sftp://172.28.152.30/home_dir/usern/ 
    username test-user password ************ <enter> 
    action-success true
    MDS1-ESUA# _ 
    
FEEDBACK: Are you happy with this material?