Collecting logs manually

Edit online

Selected logs can be manually collected and uploaded to either an IBM Log Server or another configured server: an HTTP Server or an SFTP server.

Procedure

  1. On the Settings tab, navigate to Support > Logs > Collect Logs Manually.
  2. Enter the Log Destination server and the Filter Criteria:
    Table 1. Backup Server options
    Option Actions
    IBM Log Server
    • If the IBM Log Server is configured, the host name is displayed. Enter:
      1. Case number
    • If the IBM Log Server is not configured, enter the IBM Log Server details:
      1. Host name
      2. Transfer ID
      3. Password
      4. Case number

      All fields must be entered. The Manager validates the IBM Log Server credentials before the selected devices start collecting logs.
    Log Destination An option displays:
    • Not Set

      Configure destination. A link is displayed to the Log configuration page to configure destination

    • SFTP Server

      Host name is displayed. Enter an optional case number to be used as a directory name for the collected log files (spaces are trimmed).

    • HTTP Server

      Host name is displayed. Enter an optional case number to be used as a directory name for the collected log files (spaces are trimmed).
    Table 2. Criteria options
    Option Actions
    Filter

    Indicate the time period (From/To). By default, it is one week. Smaller time periods limit the log file size that is transferred from each device to the SFTP or HTTP server.

    Categories specify the type of log files to collect and further limit the log file size. Contact IBM® Customer Support for log file details.

    Note: Select the wanted logs to minimize excess network traffic. Log files can be large. Selecting a smaller time range limits the file size and speedup the operation. TheIBM Cloud Object Storage Manager™ queues the requests and process five devices at a time.
    Devices Select the devices to run the dump-log command on.
  3. Click Collect Logs to start log collection or Cancel to exit.
    While the log collection is in progress, the Log Collection Status displays.

    When a log collection is in progress in the Manager, if the Collect action is clicked again, an information box displays at the top of the page, which allows the log collection to be canceled. Click the Can be terminated link to start a cancel log collection request. The request prevents any pending log collection processes from running, sends a cancel request to the log collection process on each device that is in progress, and closes the log collection execution thread in the Manager. When the log collection process on each device receives the cancel request, a best-effort attempt is made to prevent the log collection from sending the logs to the destination.

  4. Click View to view the Log Collection Status.