App Launchpad wird als RPM- und DEB-Installationsdateien verteilt, um verschiedene Betriebssystemtypen zu unterstützen.

Der Name und das Format der Installationsdatei unterscheiden sich für die verschiedenen Betriebssystemtypen. Alle Dateinamen enthalten v.v.v, d. h. die Produktversion und nnnnnnnnn, die Build-Nummer. Beispiel: vmware-vcd-alp-2.1.1-36472856.x86_64.rpm
Betriebssystem Name und Format der Installationsdatei
CentOS Linux, Red Hat Enterprise Linux vmware-vcd-alp-v.v.v-nnnnnnnn.x86_64.rpm
Photon OS vmware-vcd-alp-v.v.v-nnnnnnnn.ph3.x86_64.rpm
Ubuntu, Debian vmware-vcd-alp-v.v.v-nnnnnnnn_amd64.deb

Voraussetzungen

  • Stellen Sie sicher, dass Ihre Zielumgebung die Bereitstellungsanforderungen von App Launchpad erfüllt. Weitere Informationen finden Sie unter Vor dem Start.
  • Stellen Sie sicher, dass Sie über die Anmeldedaten eines VMware Cloud Director-Systemadministratorkontos verfügen. Sie benötigen die Anmeldedaten eines Systemadministrators, um das App Launchpad Service-Konto zu erstellen.
  • Stellen Sie sicher, dass das Installationspaket in das /tmp-Verzeichnis der Zielmaschine hochgeladen wurde.

Prozedur

  1. Öffnen Sie eine SSH-Verbindung mit der virtuellen Linux-Maschine des Installationsziels, melden Sie sich an und verwenden Sie su, um Root-Zugriff zu erhalten.
  2. Installieren Sie das RPM- oder DEB-Paket, indem Sie den Installationsbefehl ausführen.

    Für RPM:

    rpm -ivh  vmware-vcd-alp-v.v.v-nnnnnnnn.el7.x86_64.rpm
    Wenn Java SE JDK 11 auf der Bereitstellungszielmaschine installiert ist, hängen Sie das Argument --nodeps an, um Probleme bei der Installation zu vermeiden. 
    rpm -ivh --nodeps vmware-vcd-alp-v.v.v-nnnnnnnn.el7.x86_64.rpm

    Für DEB:

    sudo apt-get install ./vmware-alp_$v.v.v-$nnnnnnnn_amd64.deb
  3. Konfigurieren Sie App Launchpad mit VMware Cloud Director.
    Um App Launchpad mit VMware Cloud Director zu konfigurieren, verwenden Sie das alp connect-Skript. Indem Sie dieses Skript verwenden, richten Sie eine Verbindung zwischen App Launchpad und VMware Cloud Director ein, definieren oder erstellen das App Launchpad Service-Konto und installieren das App Launchpad-Benutzerschnittstellen-Plug-In für VMware Cloud Director. Das alp connect-Skript konfiguriert auch App Launchpad mit Ihrem AMQP Broker.
    1. Konfigurieren Sie die Verbindung zwischen App Launchpad und VMware Cloud Director.
      Wenn Sie eine Verbindung mit VMware Cloud Director 10.2 oder höher herstellen, führen Sie den folgenden Befehl aus:

      Für CentOS Linux, Red Hat Enterprise Linux und Photon OS:

      alp connect --sa-user account-to-become-alp-service-account --sa-pass 'service-account-pass' --url Cloud-Director-URL --admin-user Cloud-Director-system-administrator@system --admin-pass 'Cloud-Director-system-administrator-pass' --mqtt

      Für Ubuntu und Debian:

      sudo alp connect --sa-user account-to-become-alp-service-account --sa-pass 'service-account-pass' --url Cloud-Director-URL --admin-user Cloud-Director-system-administrator@system --admin-pass 'Cloud-Director-system-administrator-pass' --mqtt

      Wenn Sie eine Verbindung mit einer Version von VMware Cloud Director herstellen, die älter ist als Version 10.2, führen Sie den folgenden Befehl aus:

      Für CentOS Linux, Red Hat Enterprise Linux und Photon OS: 
      alp connect --sa-user account-to-become-alp-service-account --sa-pass 'service-account-pass' --url Cloud-Director-URL --admin-user Cloud-Director-system-administrator@system --admin-pass 'Cloud-Director-system-administrator-pass' --amqp-exchange dedicated-exchange-name --amqp-user dedicated-amqp-user --amqp-pass 'dedicated-amqp-user-password' --amqp-queue dedicated-amqp-queue --amqp-routingkey dedicated-amqp-routing-key

      Für Ubuntu und Debian:

      sudo alp connect --sa-user account-to-become-alp-service-account --sa-pass 'service-account-pass' --url Cloud-Director-URL --admin-user Cloud-Director-system-administrator@system --admin-pass 'Cloud-Director-system-administrator-pass' --amqp-exchange dedicated-exchange-name --amqp-user dedicated-amqp-user --amqp-pass 'dedicated-amqp-user-password' --amqp-queue dedicated-amqp-queue --amqp-routingkey dedicated-amqp-routing-key
      In der folgenden Tabelle werden die Argumentwerte beschrieben, die Sie eingeben müssen.
      Argument Beschreibung
      --sa-user Der Benutzername des VMware Cloud Director-Benutzerkontos, das zum App-Launchpad-Service-Konto wird. Später, während der Erstkonfiguration der App Launchpad-Dienste, weist App Launchpad die App Launchpad Service-Rolle zu.

      Dieses Konto ist für App Launchpad reserviert und darf nicht mit dem --admin-user-Konto identisch sein.

      Geben Sie den Benutzernamen nur mit Kleinbuchstaben ein und fügen Sie das VMware Cloud Director-Organisationssuffix nicht hinzu.

      Wenn ein Benutzerkonto für den von Ihnen eingegebenen Benutzernamen in VMware Cloud Director nicht vorhanden ist, wird es vom alp connect-Skript erstellt.
      --sa-password Das Kennwort für das VMware Cloud Director-Benutzerkonto, das zum App-Launchpad-Service-Konto wird.
      --url Der öffentliche Endpoint von VMware Cloud Director.

      Achten Sie darauf, dass Sie am Ende der URL keinen Schrägstrich am Ende eingeben. Geben Sie z. B. https://cloud.example.com anstelle von https://cloud.example.com/ ein.

      --admin-user Der Benutzername eines VMware Cloud Director-Systemadministrators.
      --admin-pass Das Kennwort für das Benutzerkonto des VMware Cloud Director-Systemadministrators.
      --amqp-user Der Benutzername des dedizierten AMQP Broker-Benutzerkontos, das Sie für App Launchpad erstellt haben. Fügen Sie dem Benutzernamen das Organisationssuffix @system hinzu.
      --amqp-pass Das Kennwort für das dedizierte AMQP Broker-Benutzerkonto, das Sie für App Launchpad erstellt haben.
      --amqp-exchange Der Name des dedizierten Direct Exchange-Typs für AMQP-Broker, der für App Launchpad reserviert ist. Stellen Sie sicher, dass:
      • Sie einen direkten Typ von AMQP Exchange verwenden.
      • VMware Cloud Director und App Launchpad denselben virtuellen Host des AMQP Brokers-verwenden.
      --amqp-queue Wenn mehrere Instanzen von VMware Cloud Director einen einzelnen virtuellen Host mit RabbitMQ verwenden, geben Sie, um Ausfälle von App Launchpad zu verhindern, die dedizierte AMQP-Warteschlange für die aktuelle Instanz von App Launchpad an. Um sicherzugehen, dass die Anforderungen an die richtige Warteschlange weitergeleitet werden, verwenden Sie dieses Argument zusammen mit dem Argument --amqp-routingkey.

      Standardmäßig ist der Argumentwert alp. Wenn Sie also kein bestimmtes Routing von Anforderungen benötigen, können Sie dieses Argument überspringen.

      --amqp-routingkey Der Routing-Schlüssel für Ihre Anforderungen. Um sicherzustellen, dass die Anforderungen ordnungsgemäß weitergeleitet werden, verwenden Sie dieses Argument zusammen mit dem Argument --amqp-queue.

      Standardmäßig ist der Argumentwert alpkey. Wenn Sie also kein bestimmtes Routing von Anforderungen benötigen, können Sie dieses Argument überspringen.

      --mqtt Wenn Sie App Launchpad mit VMware Cloud Director 10.2 oder höher konfigurieren, können Sie das MQTT-Protokoll für die Kommunikation zwischen App Launchpad und VMware Cloud Director verwenden.

      Wenn Sie das MQTT-Protokoll verwenden, werden alle für App Launchpad erforderlichen Konfigurationsdetails automatisch aus VMware Cloud Director extrahiert.

      Wenn Sie das alp connect-Skript ausführen und sowohl das Argument --mqtt als auch das Argument --amqp-exchange bereitstellen, hat die MQTT-Konfiguration Vorrang. Wenn VMware Cloud Director so konfiguriert ist, dass MQTT verwendet wird, ignoriert App Launchpad die AMQP-Konfiguration.
      Für VMware Cloud Director 10.2 und höher: 
      alp connect --sa-user alpadmin --sa-pass 'Change!7' --url https://cloud.example.com --admin-user administrator@system --admin-pass 'Change!7' --mqtt
      sudo alp connect --sa-user alpadmin --sa-pass 'Change!7' --url https://cloud.example.com --admin-user administrator@system --admin-pass 'Change!7' --mqtt
      Für ältere Versionen von VMware Cloud Director als Version 10.2: 
      alp connect --sa-user alpadmin --sa-pass 'Change!7' --url https://cloud.example.com --admin-user administrator@system --admin-pass 'Change!7' --amqp-exchange alpext --amqp-user alp-user --amqp-pass 'Change!7'
      sudo alp connect --sa-user alpadmin --sa-pass 'Change!7' --url https://cloud.example.com --admin-user administrator@system --admin-pass 'Change!7' --amqp-exchange alpext --amqp-user alp-user --amqp-pass 'Change!7'
      Führen Sie den Befehl alp connect -h oder sudo alp connect -h aus, um Hilfe zum Skript anzuzeigen.
      Das System gibt Informationen über das VMware Cloud Director-Zertifikat und die Endbenutzerlizenzvereinbarung (EULA) für App Launchpad zurück.
    2. Akzeptieren Sie die EULA.
    3. Akzeptieren Sie das Zertifikat von VMware Cloud Director.
  4. Stellen Sie sicher, dass die Konfigurationen von VMware Cloud Director und dem AMQP Broker erfolgreich sind, indem Sie den Befehl alp show ausführen.
    Das System gibt alle Konfigurationsdetails für VMware Cloud Director und den AMQP Broker zurück.
  5. (Optional) Um das Kennwort für das Dienstkonto abzurufen, fügen Sie das --show-password-Argument an den Befehl alp show an.
  6. Starten Sie den App Launchpad-Dienst, indem Sie den Befehl systemctl start alp ausführen.
  7. Verifizieren Sie den Status des App Launchpad-Dienstes, indem Sie den Befehl systemctl status alp ausführen.
    Wenn das System keine Fehler zurückgibt, fahren Sie mit der Konfiguration von App Launchpad fort. Weitere Informationen unter Konfigurieren von App Launchpad. Gibt das System einen Fehler zurück, fahren Sie mit Schritt 8 fort.
  8. Diagnostizieren Sie Fehler bei der Bereitstellung durch Ausführen der ausführbaren Datei /opt/vmware/alp/bin/diagnose.
    Das Diagnosetool stellt sicher, dass die Dienste ausgeführt werden und dass alle Konfigurationsanforderungen erfüllt sind. Die Diagnoseliste umfasst:
    • Initialisierung des App Launchpad-Dienstes
    • Zuweisung des App Launchpad Service-Kontos
    • Konfiguration des AMQP- oder MQTT-Brokers
    • App Launchpad API-Endpoint-Konfiguration
    • Überwachungsport des App Launchpad-Dienstes
    • Testen der VMware Marketplace-Verbindung vom App Launchpad-Server
    • Testen der Amazon S3-Verbindung von VMware Cloud Director-Zellen
    Wenn keine Bereitstellungsfehler vorhanden sind, gibt das System die folgende Meldung zurück: 
    [root@alp103 bin]# ./diagnose 
Step 1: System diagnose
--------------------------------------------------------------------------------
- App Launchpad service is initialized.

Step 2: Cloud Director diagnose
--------------------------------------------------------------------------------
- Service Account for App Launchpad is good.
- App Launchpad's extension is ready.

Step 3: MQTT diagnose
--------------------------------------------------------------------------------
- Cloud Director MQTT for extensibility is ready.

Step 4: Integration diagnose
--------------------------------------------------------------------------------
- App Launchpad API is up, and version is 2.1.1-19199857.

Step 5: App Launchpad diagnose
--------------------------------------------------------------------------------
- App Launchpad service has started successfully and is listening on port 8086.

Step 6: App Launchpad to Marketplace connection diagnose
--------------------------------------------------------------------------------
- App Launchpad to Marketplace connection succeeds.

Step 7: Cloud Director to AWS S3 connection diagnose
-------------------------------------------------------------------------------- 
- Cloud Director to AWS S3 connection succeeds.