Analyseprojekte verwalten

bobctl understand cli verwenden, um Z-Understand-Analyseprojekte zu verwalten und Quelldateien in den Workload zu kopieren.

Der Befehl bobctl understand cli stellt eine Kommandozeilenschnittstelle zur Verwaltung von Analyseprojekten bereit. Er führt Befehle direkt aus deiner lokalen Umgebung im Z-Understand-Pod aus.

./bobctl understand cli
FlagBeschreibung
-aStartet eine interaktive bash-Shell-Sitzung im Z-Understand-Pod.
<args>Argumente, die direkt an das cli-tunnel.sh-Skript im Z-Understand-Pod weitergegeben werden.

Häufige Beispiele:

./bobctl understand cli --list-projects               # Projekte auflisten
./bobctl understand cli -b MyProject                  # Projekt erstellen
./bobctl understand cli -c COBOL.ini MyProject        # Projekt aus einer Initialisierungsdatei erstellen
./bobctl understand cli -si -api-key <key> MyProject  # Semantischen Index generieren
./bobctl understand cli -doc -api-key <key> MyProject # Dokumentation generieren
./bobctl understand cli -a                            # Interaktive Shell öffnen

Projekt aus einer ini-Datei erstellen

Das Flag -c setzt voraus, dass die .ini-Datei bereits im Projektverzeichnis des Pods vorhanden ist. Ein Beispiel für eine .ini-Datei befindet sich im Unterverzeichnis samples.

Öffne eine interaktive Shell im Z-Understand-Pod:

oc exec -it <pod-name> -n <instance-namespace> -- bash

Kopiere die Beispiel-.ini-Datei in das Projektverzeichnis:

cp "/bobz-understand/storage/IBM Application Discovery Build Client CLI/config/projects/samples/new_proj_db2.ini" \
   "/bobz-understand/IBM Application Discovery Build Client CLI/config/projects/new_proj_db2.ini"
Hinweis:

Bei der Verwendung von Db2 als Projektdatenbank muss die .ini-Datei einen eindeutigen DBName-Wert angeben. Jedes Projekt benötigt seinen eigenen eindeutigen DBName. Wenn ein vorhandener Wert wiederverwendet wird, wird die Projekterstellung blockiert. Öffne die kopierte .ini-Datei und weise DBName einen eindeutigen Wert zu, bevor du fortfährst.

Hinweis:

Bei SQL-Server-Projekten ist der Parameter DBName in der .ini-Datei nicht erforderlich. Der Projektname wird automatisch als Datenbankname verwendet.

Beende die interaktive Shell:

exit

Erstelle das Projekt mithilfe der .ini-Datei:

./bobctl understand project create -c <path-to-ini>

Quelldateien in ein Projekt kopieren

Bevor du ein Projekt erstellst, kopiere die Anwendungsquelldateien in das entsprechende Projektverzeichnis. Jedes Projekt enthält quelldatei-spezifische Unterverzeichnisse, wie z. B.:

  • Cobol
  • JCL
  • PL1
  • Assembler

So überprüfst du die Projektstruktur und kopierst Quelldateien:

Öffne eine interaktive Shell im Z-Understand-Pod:

./bobctl understand cli -a

Pod-Namen abrufen:

oc get pods \
  -n <instance-namespace> \
  -l app=ibm-bobz-understand \
  -o name

Kopiere einzelne Dateien oder Verzeichnisse mit oc cp:

oc cp \
  /local/path/to/sources \
  <pod-name>:/bobz-understand/projects/<project-name>/<subfolder>/ \
  -n <instance-namespace>

Alternativ verwende oc rsync für wiederholte Synchronisierungen eines Verzeichnisses:

oc rsync \
  /local/path/to/sources/ \
  <pod-name>:/bobz-understand/projects/<project-name>/<subfolder>/ \
  -n <instance-namespace>
Wie ist dieses Thema?