Collecting log packages for IBM Spectrum Fusion HCI

You can create your log package by using one or more component logs.

Procedure

  1. From the title bar, click the help icon and select Support logs.
  2. In the Support logs page, click Collect logs.
    The Collect logs slide out pane gets displayed.
  3. In the Collect logs slide out pane, select one or more components to create the log package. The components that are selected to be included in the log package. The log package contains the folders, namespaces, and relevant files. For more information about log package, see Log package.
    Nodes
    This option collects logs for the nodes in the IBM Spectrum Fusion HCI appliance. These logs are used to troubleshoot issues that are related to node health.
    For example, issues like offline nodes and issues with firmware upgrade.
    Network switches
    This option collects logs for the IBM Spectrum Fusion HCI appliance network. The logs that are collected in this package include information on the switches, Vlans, and links that make up the appliance network. These logs are used to troubleshoot network issues.
    For example, issues like network outages, degraded performance, connecting the IBM Spectrum Fusion HCI appliance to the data center network, and problems related to Metro Sync DR recovery.
    Storage
    This option collects logs related to the physical storage configuration of the IBM Spectrum Fusion HCI appliance, and the Global data platform. These logs are used to troubleshoot storage issues.
    For example, issues like loss of storage access, problems with CSI provisioning, problems related to Metro Sync DR, problems with the overall health of the Global data platform.
    System health check
    This option collects logs that provide an overall assessment of the health of IBM Spectrum Fusion HCI. This log package includes information on:
    • The health of the components that make up the IBM Spectrum Fusion HCI appliance.
    • The health of IBM Spectrum Fusion services such as the Global data platform and Backup and restore
    • The health of the IBM Spectrum Fusion HCI operator
    • The OpenShift® configuration of bare metal hosts, machine sets, machines, and nodes.
    Backup and restore
    This option collects logs related to the Backup and restore service. These logs are used to troubleshoot issues that are related to backup and restore.
    For example, issues like failed backups, failed application restores, disconnected backup locations. And the problems that experienced when you create backup policies or assigning policies to applications, and problems with the overall health of the Data Protection service.
    Note: If Data protection service is not enabled, then the user interface does not show Backup and restore component in log collection.
    Administration
    This option collects logs related to OpenShift, administration, and audit logging.
  4. Click Collect.
    The created log package gets added to the log list with status as Collecting. After the collection is complete, the status changes to Success.

    The log package creation might take several minutes and the amount of time might vary based on the type of logs collected. You can view the progress of the log package creation in the table that is shown on the Logs page.

    The Support logs page lists all created log packages with the following details:
    Name
    The name of the log package.
    Note: The name of the log package consists of two parts: component name and time stamp. If you collect log package for the nodes, for example, the file name must be cn-20220324124442. The name of the log package change for every component.
    • Storage: sc
    • System heath check: sh
    • Administration: ad
    • Network: nw
    • Backup and restore: br
    Components
    It contains details of which component logs comprise the log package.
    Status
    The values of the status field are Collecting, Success, and Partial.
    Note: The Partial status means that some of the requested logs are collected successfully, but there are error messages that are generated in the process.
    Created
    The date and time of the creation of the log package.
    Expired
    The expiry date and time of the log set.
    Note: The collected logs packages are auto-deleted after 24 hours.
  5. You can upload the log package to IBM directly by using the Call Home feature, download it to your local machine, or delete it after it is successfully added to the log list.
    Upload the collected log package to IBM Support
    If Call Home is enabled, you can use the IBM Spectrum Fusion HCI user interface to automatically upload logs to a ticket. For steps to enable call home, see Enabling IBM Call Home for IBM Spectrum Fusion HCI.
    1. Click the ellipsis menu of the log record and click Upload log package to IBM via Call Home.
      The Upload log package window gets displayed. The collected logs get uploaded so that the IBM Support team can use for diagnosis.
    2. In the Upload log package window, choose whether you want to create a new support case or attach to an existing case.
    3. If it is an existing case, then enter the Ticket number.
      Note: A log collection package can be uploaded only one time to any ticket through this user interface page.
    4. Click Upload log.
    Download collected log package
    1. Click the ellipsis menu of the log record and click Upload.
      The Downloading log package window gets displayed indicating that the download is in progress.
    Delete a log package
    1. Click the ellipsis menu of the log record and click Delete.
    2. In the Confirm delete log package window, click Delete.
    If you not enabled Call Home, then download the log package and upload it to an IBM site. In the table of log packages, click the ellipsis menu for the log package that you want to upload and select the Download action. It triggers the download of the log package file in your web browser. The user interface provides three methods of uploading logs to IBM.
    FTP transfer
    This option is the fastest approach to upload logs to IBM. It uses FTP to upload logs to the IBM Enhanced Customer Data Repository (ECUREP) site.
    Browser upload
    The browser upload option gives you an option to upload the log package through your web browser. This option is limited to files that are smaller than 200 MiB.
    Blue Diamond
    HIPPA customers designated as Blue Diamond need to upload logs to the IBM Blue Diamond site.

What to do next

  1. After a log package is successfully completed, you can check the folders, namespaces, and relevant files of the log package to read and troubleshoot. See Log package.