Raccolta e caricamento dei bundle di supporto

I bundle di supporto sono file di dati diagnostici raccolti da Compute Cloud@Customer Isolated, utilizzati per valutare e risolvere i problemi.

I bundle di supporto devono essere creati utilizzando un comando CLI del servizio locale o dall'interfaccia utente Web del servizio e caricati manualmente nel Supporto Oracle. Vengono caricati in modo sicuro e contengono i dati minimi richiesti: identità di sistema (non indirizzi IP), sintomi di problemi e informazioni diagnostiche come log e stato. È possibile creare un bundle per uso personale. La creazione di un bundle di supporto è un modo conveniente per raccogliere i dati correlati.

Configurazione di un sistema esterno per le operazioni dei bundle di supporto

Per raccogliere i bundle di supporto da Compute Cloud@Customer Isolated, è necessario impostare un sistema esterno con i certificati appropriati per l'autenticazione e l'autorizzazione.

  1. Assicurarsi che il computer in uso sia in grado di connettersi all'IP virtuale del cluster di gestione nella rete del data center.

  2. Con un account utente appartenente al gruppo di autorizzazioni C3IsolatedGroup, eseguire il login all'interfaccia CLI del servizio e visualizzare il certificato e la chiave necessari per le operazioni di servizio.

    PCA-ADMIN> getServiceabilityServerCerts
    Data:
    Certificate =
    -----BEGIN CERTIFICATE-----
    <certificate>
    -----END CERTIFICATE-----
    Private Key =
    -----BEGIN RSA PRIVATE KEY-----
    <key>
    -----END RSA PRIVATE KEY-----
    
    Support Bundle Endpoint = https://backup-provider.mysystem.example.com/support_bundles/
    Backup Endpoint = https://backup-provider.mysystem.example.com/backups/
  3. Copiare il certificato e la chiave, incluse le righe BEGIN e END, per separare i file di testo e denominarli serviceabilityServerCert.pem e serviceabilityServerKey.pem.

  4. Visualizza la catena CA del silo esterno.

    • Utilizzo di un browser Web: https://iaas.mysystem.example.com/cachain

      Se viene visualizzato un avviso, accettarlo.

    • Utilizzando la riga di comando Unix:
      $ curl -k https://iaas.mysystem.example.com/cachain
    • Utilizzo del prompt dei comandi di Windows (non PowerShell):

      C:\Users\User01>curl -k https://iaas.mysystem.example.com/cachain
  5. Copiare l'intero output in un file di testo e denominarlo ca-chain.cert.pem.

Generazione di un bundle di supporto

Supporta modalità e parametri bundle

Quando si genera un bundle di supporto, selezionare sempre il tipo di bundle Manuale. Per il parametro SR, immettere un identificativo breve e significativo o un numero di richiesta di servizio (SR) se disponibile.

Sono supportate le seguenti modalità bundle di supporto:

  • Nativo: in modalità nativa i log vengono raccolti da un determinato tipo di componente. Selezionare il tipo desiderato:

    • Cisco Bundle: i log vengono raccolti da tutti gli switch Cisco

    • Snapshot di ILOM: dati diagnostici raccolti da tutti gli ILOM

    • Report SOS: i dati diagnostici vengono raccolti da tutti i nodi di gestione e calcolo

    • Bundle ZFS: i log sono raccolti da entrambi i controller ZFS Storage Appliance

  • Valutazione: in modalità triage, viene eseguita una query su Prometheus platform_health_check per lo stato HEALTHY e NOT_HEALTHY. Se viene trovato NOT_HEALTHY, utilizzare la modalità della slice del tempo per ottenere maggiori dettagli.

  • Timeslice: in modalità slice dell'ora, i dati vengono raccolti specificando gli indicatori orari di inizio e fine.

  • Combo: la modalità combinata è una combinazione di un bundle di triage e un bundle di slice temporali.

Utilizzo dell'interfaccia utente Web del servizio
  1. Nel menu principale, selezionare Manutenzione, quindi selezionare Bundle ASR.

    Viene visualizzata la pagina Bundle ASR.

  2. Nell'angolo in alto a destra, selezionare Avvia bundle ASR. Viene visualizzata la finestra Avvia bundle ASR.

  3. Immettere tutti i parametri del bundle richiesti.

    1. Immettere un ID bundle nel campo RS e selezionare il tipo di bundle Manuale.

    2. Selezionare una modalità bundle di supporto: Combo, Nativo, Timeslice o Triage.

    3. Inserire i parametri aggiuntivi per la modalità selezionata, se applicabile.

    4. Selezionare Avvia bundle ASR per avviare la generazione del bundle di supporto.

  4. La tabella Bundle ASR mostra quando un bundle è completato. Tenere presente la posizione in cui viene memorizzato il bundle di supporto, poiché è qui che è necessario recuperare il file per il caricamento al Supporto Oracle.

Uso dell'interfaccia CLI del servizio
  1. Creare un bundle di supporto utilizzando il comando asrInitiateBundle.

    Sintassi (inserita su una singola riga):

    PCA-ADMIN> asrInitiateBundle bundleType=MANUAL sr=<bundle_id>
    mode=TRIAGE|NATIVE|TIMESLICE|COMBO
    [native mode] nativeType=ILOM_SNAPSHOT|ZFS_BUNDLE|CISCO_BUNDLE|SOSREPORT
    [time slice mode] startTime="yyyy-MM-dd'T'HH:mm:ss" endTime="yyyy-MM-dd'T'HH:mm:ss"

    Esempi:

    PCA-ADMIN> asrInitiateBundle bundleType=MANUAL sr=ComboBundle01 mode=COMBO
    PCA-ADMIN> asrInitiateBundle bundleType=MANUAL sr=TimeSlice01 mode=TIMESLICE startTime="2025-10-03T12:00:00" endTime="2025-10-03T13:00:00"
    PCA-ADMIN> asrInitiateBundle bundleType=MANUAL sr=CiscoBundle01 mode=NATIVE nativeType=CISCO_BUNDLE
    Data:
      status = SUCCESS
      message = Bundle id - 3
  2. Elenca i bundle di supporto generati nel sistema.

    PCA-ADMIN> asrGetBundles
    Data:
      id   bundleType   uuid                                   state      time
      --   ----------   ----                                   -----      ----
      1    manual       abdb93be-2e42-4cc7-8e75-7951c8063bce   Complete   2025-10-01T12:07:45
      2    manual       fbcdf127-03f1-4182-8c87-bfdc5f4e8fec   Failed     2025-10-01T12:27:49
      3    manual       18180828-21c1-49d2-8f2d-1508a16f4084   Complete   2025-10-02T08:05:30
      4    manual       bbadf3c5-3243-47e8-b154-00287bd12532   Running    2025-10-03T16:18:37
  3. Visualizza i dettagli del bundle di supporto necessario.

    PCA-ADMIN> asrGetBundle bundleId=3
    Data:
      Type = ASRBundle
      bundleId = 3
      bundleType = manual
      location = /support_bundles/CiscoBundle01_cisco-bundle_20251002T080531030/CiscoBundle01_cisco-bundle_20251002T080531030.tar.gz
      uuid = 18180828-21c1-49d2-8f2d-1508a16f4084
      sr = CiscoBundle01
      mode = native
      args = -sr CiscoBundle01 -t cisco-bundle
      state = Complete
      time = 2025-10-02T08:05:30

Caricamento di un bundle di supporto

  1. Assicurarsi di disporre del percorso corretto per il bundle di supporto necessario. È il parametro location visualizzato quando il bundle di supporto è stato completato correttamente.

  2. Eseguire il login al sistema esterno configurato per la raccolta dei bundle di supporto. Questi file sono necessari:

    • serviceabilityServerCert.pem (il certificato server per le operazioni del bundle di supporto)

    • serviceabilityServerKey.pem (la chiave privata per le operazioni del bundle di supporto)

    • ca-chain.cert.pem (catena CA)

  3. Copiare il bundle di supporto dall'endpoint del cluster di gestione.

    Sintassi (inserita su una singola riga):

    curl –O --cacert <path-to-ca-chain>
    --key <path-to-private-key> --cert <path-to-server-cert>
    <bundle_endpoint>/<bundle_location>

    Ad esempio:

    curl –O --cacert ca-chain.cert.pem --key serviceabilityServerKey.pem --cert serviceabilityServerCert.pem \
    https://backup-provider.mysystem.example.com/support_bundles/CiscoBundle01_cisco-bundle_20251002T080531030/CiscoBundle01_cisco-bundle_20251002T080531030.tar.gz
  4. Eseguire il login a My Oracle Support con il nome utente e la password My Oracle Support.

  5. Creare un nuovo servizio o aprirne uno esistente.

  6. Caricare il bundle di supporto come allegato alla richiesta di servizio.

  7. Se la dimensione del file è superiore a 2 GB, utilizzare curl per il caricamento mediante FTPS o HTTPS.

    $ curl -T <path_to_file> -u <MOS_user_ID> ftps://transport.oracle.com/issue/<SR_number>/
    $ curl -T <path_to_file> -u <MOS_user_ID> https://transport.oracle.com/upload/issue/<SR_number>/