App Launchpad è distribuito come file di installazione RPM e DEB, adatto per diversi tipi di sistema operativo.

Il nome e il formato del file di installazione sono diversi per i vari tipi di sistema operativo. Tutti i nomi dei file includono v.v.v, ovvero la versione del prodotto e nnnnnnnn, ovvero il numero della build. Ad esempio, vmware-vcd-alp-2.1.1-36472856.x86_64.rpm
Sistema operativo Nome e formato del file di installazione
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
Windows, Debian vmware-vcd-alp-v.v.v-nnnnnnnn_amd64.deb

Prerequisiti

  • Verificare che l'ambiente di destinazione soddisfi i requisiti della distribuzione di App Launchpad. Per ulteriori informazioni, vedere Prima di iniziare.
  • Verificare di disporre delle credenziali di un account di amministratore di sistema di VMware Cloud Director. È necessario disporre delle credenziali di amministratore di sistema per creare l'account App-Launchpad-Service.
  • Verificare che il pacchetto di installazione sia caricato nella directory /temp della macchina di destinazione.

Procedura

  1. Aprire una connessione SSH alla macchina virtuale Linux di destinazione dell'installazione, accedere e utilizzare su per ottenere i privilegi root.
  2. Installare il pacchetto RPM o DEB eseguendo il comando di installazione.

    Per RPM:

    rpm -ivh  vmware-vcd-alp-v.v.v-nnnnnnnn.el7.x86_64.rpm
    Se Java SE JDK 11 è installato nella macchina di destinazione della distribuzione, per evitare problemi di installazione, aggiungere l'argomento --nodeps. 
    rpm -ivh --nodeps vmware-vcd-alp-v.v.v-nnnnnnnn.el7.x86_64.rpm

    Per DEB:

    sudo apt-get install ./vmware-alp_$v.v.v-$nnnnnnnn_amd64.deb
  3. Configurare App Launchpad con VMware Cloud Director.
    Per configurare App Launchpad con VMware Cloud Director, utilizzare lo script alp connect. Tramite questo script, si stabilisce una connessione tra App Launchpad e VMware Cloud Director, si definisce o si crea l'account App-Launchpad-Service e si installa il plug-in dell'interfaccia utente di App Launchpad per VMware Cloud Director. Lo script alp connect consente inoltre di configurare App Launchpad con il broker AMQP.
    1. Configurare la connessione tra App Launchpad e VMware Cloud Director.
      Se ci si connette a VMware Cloud Director 10.2 o versione successiva, eseguire il comando seguente:

      Per CentOS Linux, Red Hat Enterprise Linux e 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

      Per Ubuntu e 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

      Se ci si connette a una versione di VMware Cloud Director precedente alla 10.2, eseguire il comando seguente:

      Per CentOS Linux, Red Hat Enterprise Linux e 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

      Per Ubuntu e 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
      La seguente tabella descrive i valori degli argomenti che è necessario immettere.
      Argomento Descrizione
      --sa-user Nome utente dell'account utente di VMware Cloud Director che diventa l'account App-Launchpad-Service. In seguito, durante la configurazione iniziale dei servizi di App Launchpad, App Launchpad assegna il ruolo App-Launchpad-Service a tale account.

      Questo account è dedicato a App Launchpad e non può essere uguale all'account --admin-user.

      Immettere il nome utente utilizzando solo lettere minuscole e non aggiungere il suffisso dell'organizzazione VMware Cloud Director.

      Se un account utente per il nome utente immesso non esiste in VMware Cloud Director, lo script alp connect lo crea.
      --sa-password Password per l'account utente di VMware Cloud Director che diventa l'account App-Launchpad-Service.
      --url Endpoint pubblico di VMware Cloud Director.

      Assicurarsi di non immettere una barra alla fine dell'URL. Ad esempio, immettere https://cloud.example.com anziché https://cloud.example.com/.

      --admin-user Nome utente di un amministratore di sistema di VMware Cloud Director.
      --admin-pass Password dell'account utente dell'amministratore di sistema di VMware Cloud Director.
      --amqp-user Nome utente dell'account utente del broker AMQP dedicato che è stato creato per App Launchpad. Aggiungere il suffisso dell'organizzazione @system al nome utente.
      --amqp-pass Password per l'account utente del broker AMQP dedicato che è stato creato per App Launchpad.
      --amqp-exchange Nome dello scambio diretto del broker AMQP dedicato riservato per App Launchpad. Assicurarsi che:
      • Si stia utilizzando un tipo diretto di scambio AMQP.
      • VMware Cloud Director e App Launchpad utilizzino lo stesso host virtuale del broker AMQP.
      --amqp-queue Se più istanze di VMware Cloud Director utilizzano un singolo host virtuale RabbitMQ, per impedire gli errori dei servizi App Launchpad, specificare la coda AMQP dedicata per l'istanza corrente di App Launchpad. Per assicurarsi che le richieste vengano instradate alla coda corretta, utilizzare questo argomento insieme all'argomento --amqp-routingkey.

      Poiché per impostazione predefinita, il valore dell'argomento è alp, se non è necessario un routing specifico delle richieste, è possibile ignorare questo argomento.

      --amqp-routingkey Chiave di routing per le richieste. Per assicurarsi che le richieste vengano instradate correttamente, utilizzare questo argomento insieme all'argomento --amqp-queue.

      Poiché per impostazione predefinita, il valore dell'argomento è alpkey, se non è necessario un routing specifico delle richieste, è possibile ignorare questo argomento.

      --mqtt Se si configura App Launchpad con VMware Cloud Director 10.2 o versione successiva, è possibile utilizzare il protocollo MQTT per la comunicazione tra App Launchpad e VMware Cloud Director.

      Quando si utilizza il protocollo MQTT, tutti i dettagli di configurazione richiesti da App Launchpad vengono estratti automaticamente da VMware Cloud Director.

      Quando si esegue lo script alp connect, se si specificano entrambi gli argomenti --mqtt e --amqp-exchange, la configurazione di MQTT ha la precedenza. Se VMware Cloud Director è configurato per l'utilizzo di MQTT, App Launchpad ignora la configurazione di AMQP.
      Per VMware Cloud Director 10.2 e versioni successive: 
      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
      Per le versioni di VMware Cloud Director precedenti alla 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'
      Per informazioni sullo script, è possibile eseguire il comando alp connect -h o sudo alp connect -h.
      Il sistema restituisce le informazioni relative al certificato di VMware Cloud Director e all'Accordo di licenza con l'utente finale (EULA) per App Launchpad.
    2. Accettare l'EULA.
    3. Accettare il certificato di VMware Cloud Director.
  4. Verificare che la configurazione di VMware Cloud Director e del broker AMQP sia stata completata correttamente eseguendo il comando alp show.
    Il sistema restituisce tutti i dettagli della configurazione di VMware Cloud Director e del broker AMQP.
  5. (Facoltativo) Per recuperare la password per l'account del servizio, aggiungere l'argomento --show-password al comando alp show.
  6. Avviare il servizio App Launchpad mediante il comando systemctl start alp.
  7. Verificare lo stato del servizio App Launchpad eseguendo il comando systemctl status alp.
    Se il sistema non restituisce errori, procedere alla configurazione di App Launchpad. Vedere Configurazione di App Launchpad. Se il sistema restituisce un errore, procedere con il Passaggio 8.
  8. Diagnosticare gli errori di distribuzione tramite il file eseguibile /opt/vmware/alp/bin/diagnose.
    Lo strumento di diagnosi verifica che i servizi siano in esecuzione e che siano soddisfatti tutti i requisiti di configurazione. L'elenco di diagnostica include:
    • Inizializzazione del servizio App Launchpad
    • Assegnazione dell'account App-Launchpad-Service
    • Configurazione del broker AMQP o MQTT
    • Configurazione dell'endpoint dell'API di App Launchpad
    • Porta di ascolto del servizio App Launchpad
    • Test della connessione di VMware Marketplace dal server di App Launchpad
    • Test della connessione di Amazon S3 dalle celle di VMware Cloud Director
    Se non sono presenti errori di distribuzione, il sistema restituisce il messaggio seguente: 
    [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.