Casi d'uso della migrazione con usecase-migration l'utilità

I casi d'uso creati nelle versioni precedenti devono essere migrati verso i casi d'uso di " v2 ". Questa migrazione garantisce la compatibilità con le funzionalità più recenti.

Per eseguire questa migrazione, utilizza l'utilità usecase-migration da riga di comando.

Fatti rapidi

Servizi o piani di servizio richiesti
IBM watsonx.governance
Autorizzazioni richieste
Ruolo di amministratore per watsonx.governance
Altri requisiti
Se utilizzi i cataloghi, devi migrarli negli inventari prima di migrare i casi d'uso. Per ulteriori informazioni, consultare la sezione "Migrazione delle risorse agli inventari"
Lo strumento supporta le piattaforme Linux ( arm64 e and64 ) e Mac (chip Intel e chip Apple).
Limitazioni
Si prega di tenere conto delle seguenti restrizioni:
  • Assegnare un unico utente amministratore incaricato di eseguire la migrazione dell'account.
  • Mentre la migrazione è in corso, non eseguire altre operazioni sull'account
  • Mentre la migrazione è in corso, l'interfaccia utente dei casi d'uso dell'IA non sarà disponibile.

Panoramica delle funzionalità

Utilizza questo strumento per trasferire i casi d'uso da V1 a V2.

Un caso d'uso di " V1 " è qualsiasi caso d'uso creato prima di IBM Software Hub 5.2.0.

Lo strumento esegue la migrazione di tutti i casi d'uso di V1 presenti nel tuo account.

Una volta migrato un caso d'uso, l'utente indicato come "Ultima modifica" per le risorse monitorate nel caso d'uso potrebbe cambiare in "Sistema".

Come utilizzare lo strumento

Lo strumento di migrazione è un'utilità da riga di comando.

Assicurati che solo un utente utilizzi lo strumento per il tuo account.

Esegui prima lo strumento in dry-run modalità di anteprima per visualizzare un'anteprima della migrazione.

È possibile eseguire lo strumento più volte. Lo strumento riprende da dove avevi interrotto.

Preparazione all'esecuzione dello strumento di migrazione

  1. Scarica lo strumento.
    1. Scarica il file di licenza. Pacchetto file di licenza
    2. Scarica il pacchetto di strumenti utilizzando uno dei seguenti link:
  2. Decomprimi il usecase-migration file.
  3. Assicurati di disporre dei diritti di lettura e scrittura sui usecase-migration file.
  4. Consenti al sistema l'accesso all'applicazione.
Nota: se hai scaricato lo strumento di migrazione da un sito esterno, il tuo sistema potrebbe bloccarlo. Vai su "Impostazioni di sistema" e consenti l'installazione di app da fonti esterne.

Successivamente, esegui lo strumento di migrazione in dry-run modalità.

Eseguire lo strumento di migrazione in dry-run modalità

Esegui lo strumento di migrazione in dry-run modalità [...], per verificare che sia possibile procedere con la migrazione. Lo strumento restituisce il numero di casi d'uso che verranno migrati.

./usecase-migration --server="<server-url>" -e="cpd" -u=<username> -p=<password> --dry-run=true -a="<account_id>"

Per effettuare l'autenticazione, è possibile utilizzare una delle seguenti opzioni:

  • -u=<username> -k=<apikey>
  • -u=<username> -p=<password>

Se l'opzione TLS non è abilitata, includere il -v=true parametro

Migrazione di tutti i casi d'uso in un account

Utilizza il seguente comando per migrare tutti i casi d'uso all'interno di un unico account.

./usecase-migration --server="<server-url>" -e="cpd" -u=<username> -p=<password> -a="<account_id>"

Per effettuare l'autenticazione, è possibile utilizzare una delle seguenti opzioni:

  • -u=<username> -k=<apikey>
  • -u=<username> -p=<password>

Se l'opzione TLS non è abilitata, includere il -v=true parametro

Migrazione di un singolo caso d'uso

Utilizza il seguente comando per migrare un singolo caso d'uso.

./usecase-migration --server="<server-url>" -e="cpd" -u=<username> -p=<password> -a="<account_id>" --usecase-id="<use-case-id>" --inventory <inventory_id>

Per effettuare l'autenticazione, è possibile utilizzare una delle seguenti opzioni:

  • -u=<username> -k=<apikey>
  • -u=<username> -p=<password>

Se l'opzione TLS non è abilitata, includere il -v=true parametro

Rieseguire lo strumento

È possibile rieseguire lo strumento di migrazione. Ad esempio, esegui questo comando per riprendere la migrazione se il processo è stato interrotto. Lo strumento riprende la migrazione dal punto in cui si era interrotta durante l'ultima esecuzione.

Per riprendere, aggiungi il --skip-validation parametro al comando.

Ad esempio:

./usecase-migration --server="<server-url>" -e="cpd" -u=<username> -p=<password> -a="<account_id>" --skip-validation

Per effettuare l'autenticazione, è possibile utilizzare una delle seguenti opzioni:

  • -u=<username> -k=<apikey>
  • -u=<username> -p=<password>

Se l'opzione TLS non è abilitata, includere il -v=true parametro

Riferimenti agli strumenti

Sintassi

./usecase-migration --server="<server-url>" -e="cpd" <authentication> <parameters>

Per effettuare l'autenticazione, è possibile utilizzare una delle seguenti opzioni:

  • -u=<username> -k=<apikey>
  • -u=<username> -p=<password>

Parametri

Per visualizzare tutti i parametri, eseguire il seguente comando:

./usecase-migration --help