Collecting log packages for IBM Storage Fusion HCI System

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 guidance on the log package, see Log package.
    Note: If a service is not enabled, the user interface does not display the service component in log collection.
    Nodes
    This option collects logs for the nodes in the IBM Storage Fusion HCI System 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 Storage Fusion HCI System 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 Storage Fusion HCI System appliance to the data center network, and problems related to Metro Sync DR recovery.
    Attention: Network switches log collection package does not include the spine switches logs.
    Storage
    This option collects logs related to the physical storage configuration of the IBM Storage Fusion HCI System 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 Storage Fusion HCI System. This log package includes information on:
    • The health of the components that make up the IBM Storage Fusion HCI System appliance.
    • The health of IBM Storage Fusion services such as the Global data platform and Backup & restore
    • The health of the IBM Storage Fusion HCI System operator
    • The OpenShift® configuration of bare metal hosts, machine sets, machines, and nodes.
    Backup & restore (Legacy)
    This option collects logs related to the Backup & 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, problems experienced when creating backup policies or assigning policies to applications, and problems with the overall health of the Data Protection service.
    Administration
    This option collects logs related to OpenShift, administration, and audit logging.
    Backup and restore
    This option collects logs related to the Backup & restore service. These logs are used to troubleshoot issues that are related to setup, backup and restore. These logs contain mainly the ibm-backup-restore namespace resources.
    Note: For Hub and Spoke operations, collect logs on both the Hub and Spoke clusters.
    Data Cataloging

    This option collects the logs related to the Data Cataloging service. These logs are used to troubleshoot issues that are related to Data Cataloging. These logs contain mainly the ibm-data-cataloging namespace resources.

  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 may take several minutes and the amount of time may vary based on the type of logs collected. You can view the progress of the log package creation in the table 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 (legacy): spp
    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 generated in the process.
    Created
    The date and time of the creation of the log package.
    Expires
    The expiry date and time of the log set.
    Note: The collected logs package are auto-deleted after 24 hours.
  5. After a log package is successfully added to the log list, you can upload it to IBM directly by using the Call Home feature, download it to your local machine, or delete it.
    Upload the collected log package to IBM Support
    If Call Home is enabled, you can use the IBM Storage Fusion HCI System user interface to automatically upload logs to a ticket. For steps to enable call home, see Enabling IBM Call Home for IBM Storage Fusion HCI System.
    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 once 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 Download.
      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 have 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 wish 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 allows you to upload the log package via 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.