App Launchpad se distribuye en forma de archivos de instalación RPM y DEB, para adaptarse a diferentes tipos de sistema operativo.

El nombre y el formato del archivo de instalación son diferentes para los distintos tipos de sistema operativo. Todos los nombres de archivo incluyen v.v.v, que es la versión del producto, y nnnnnnnn, que es el número de la compilación. Por ejemplo, vmware-vcd-alp-2.1.1-36472856.x86_64.rpm
SO Nombre y formato del archivo de instalación
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

Requisitos previos

  • Compruebe que el entorno de destino cumpla los requisitos de implementación de App Launchpad. Para obtener más información, consulte Antes de comenzar.
  • Compruebe que tiene las credenciales de una cuenta de administrador del sistema de VMware Cloud Director. Necesita credenciales de administrador del sistema para crear la cuenta de App-Launchpad-Service.
  • Compruebe que el paquete de instalación esté cargado en el directorio /tmp de la máquina de destino.

Procedimiento

  1. Abra una conexión SSH con la máquina virtual Linux de destino de instalación, inicie sesión y use su para obtener privilegios de root.
  2. Instale el paquete RPM o DEB ejecutando el comando de instalación.

    Para RPM:

    rpm -ivh  vmware-vcd-alp-v.v.v-nnnnnnnn.el7.x86_64.rpm
    Si se instala Java SE JDK 11 en el equipo de destino de la implementación, para evitar problemas de instalación, anexe el argumento --nodeps. 
    rpm -ivh --nodeps vmware-vcd-alp-v.v.v-nnnnnnnn.el7.x86_64.rpm

    Para DEB:

    sudo apt-get install ./vmware-alp_$v.v.v-$nnnnnnnn_amd64.deb
  3. Configure App Launchpad con VMware Cloud Director.
    Para configurar App Launchpad con VMware Cloud Director, utilice el script alp connect. Mediante el uso de este script, puede establecer una conexión entre App Launchpad y VMware Cloud Director, definir o crear la cuenta de App-Launchpad-Service e instalar el complemento de interfaz de usuario de App Launchpad para VMware Cloud Director. El script alp connect también configura App Launchpad con el agente de AMQP.
    1. Configure la conexión entre App Launchpad y VMware Cloud Director.
      Si va a conectarse a VMware Cloud Director 10.2 o una versión posterior, ejecute el siguiente comando:

      Para CentOS Linux, Red Hat Enterprise Linux y 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

      Para Ubuntu y 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

      Si va a conectarse a una versión de VMware Cloud Director anterior a la 10.2, ejecute el siguiente comando:

      Para CentOS Linux, Red Hat Enterprise Linux y 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

      Para Ubuntu y 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
      En la siguiente tabla se describen los valores de los argumentos que debe introducir.
      Argumento Descripción
      --sa-user El nombre de usuario de la cuenta de usuario de VMware Cloud Director que se convierte en la cuenta de App-Launchpad-Service. Más adelante, durante la configuración inicial de los servicios de App Launchpad, App Launchpad asigna la función App-Launchpad-Service a la cuenta.

      Esta cuenta está dedicada a App Launchpad y no puede ser la misma que la cuenta de --admin-user.

      Introduzca el nombre de usuario con minúsculas y no agregue el sufijo de organización de VMware Cloud Director.

      Si no existe ninguna cuenta de usuario para el nombre de usuario que introduzca en VMware Cloud Director, el script alp connect la creará.
      --sa-password La contraseña de la cuenta de usuario de VMware Cloud Director que pasa a ser la cuenta de App-Launchpad-Service.
      --url El endpoint público de VMware Cloud Director.

      Asegúrese de no introducir una barra diagonal al final de la URL. Por ejemplo, introduzca https://cloud.example.com en lugar de https://cloud.example.com/.

      --admin-user El nombre de usuario de un administrador del sistema de VMware Cloud Director.
      --admin-pass La contraseña para la cuenta de usuario del administrador del sistema de VMware Cloud Director.
      --amqp-user El nombre de usuario de la cuenta de usuario del agente de AMQP dedicado creada para App Launchpad. Agregue el sufijo de organización @system al nombre de usuario.
      --amqp-pass La contraseña de la cuenta de usuario del agente de AMQP dedicado creada para App Launchpad.
      --amqp-exchange El nombre del intercambio directo de agente de AMQP dedicado reservado para App Launchpad. Asegúrese de que:
      • se utiliza un tipo directo de intercambio de AMQP.
      • VMware Cloud Director y App Launchpad utilizan el mismo host virtual del agente de AMQP.
      --amqp-queue Si varias instancias de VMware Cloud Director utilizan un único host virtual de RabbitMQ, para evitar errores de servicios de App Launchpad, especifique la cola de AMQP dedicada para la instancia actual de App Launchpad. Para asegurarse de que las solicitudes se enruten a la cola correcta, utilice este argumento junto con el argumento --amqp-routingkey.

      De forma predeterminada, el valor del argumento es alp, por lo que si no necesita un enrutamiento específico de solicitudes, puede omitir este argumento.

      --amqp-routingkey La clave de enrutamiento para las solicitudes. Para asegurarse de que las solicitudes estén enrutadas correctamente, utilice este argumento junto con el argumento --amqp-queue.

      De forma predeterminada, el valor del argumento es alpkey, por lo que si no necesita un enrutamiento específico de solicitudes, puede omitir este argumento.

      --mqtt Si configura App Launchpad con VMware Cloud Director 10.2 o una versión posterior, puede utilizar el protocolo MQTT para la comunicación entre App Launchpad y VMware Cloud Director.

      Cuando se utiliza el protocolo MQTT, todos los detalles de configuración que App Launchpad requiere se extraen automáticamente de VMware Cloud Director.

      Al ejecutar el script alp connect, si proporciona los argumentos --mqtt y --amqp-exchange, la configuración de MQTT tiene prioridad. Si VMware Cloud Director está configurado para usar MQTT, App Launchpad omite la configuración de AMQP.
      Para VMware Cloud Director 10.2 y versiones posteriores: 
      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
      Para versiones de VMware Cloud Director anteriores a la 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'
      Para obtener ayuda sobre el script, puede ejecutar los comandos alp connect -h o sudo alp connect -h.
      El sistema devuelve información sobre el certificado de VMware Cloud Director y el contrato de licencia de usuario final (CLUF) para App Launchpad.
    2. Acepte el CLUF.
    3. Acepte el certificado de VMware Cloud Director.
  4. Compruebe que las configuraciones de VMware Cloud Director y el agente de AMQP se hayan realizado correctamente mediante la ejecución del comando alp show.
    El sistema devuelve todos los detalles de configuración del agente de AMQP y VMware Cloud Director.
  5. (opcional) Para recuperar la contraseña de la cuenta de servicio, anexe el argumento --show-password al comando alp show.
  6. Inicie el servicio de App Launchpad ejecutando el comando systemctl start alp.
  7. Compruebe el estado del servicio de App Launchpad ejecutando el comando systemctl status alp.
    Si el sistema no devuelve errores, continúe con la configuración de App Launchpad. Consulte la Configurar App Launchpad. Si el sistema devuelve un error, continúe con el Paso 8.
  8. Para diagnosticar errores de implementación, ejecute el archivo ejecutable /opt/vmware/alp/bin/diagnose.
    La herramienta de diagnóstico verifica que los servicios estén en funcionamiento y que se cumplan todos los requisitos de configuración. La lista de diagnósticos incluye:
    • Inicialización del servicio de App Launchpad
    • Asignación de la cuenta de App-Launchpad-Service
    • Configuración del agente de MQTT o AMQP
    • Configuración del endpoint de API de App Launchpad
    • Puerto de escucha del servicio de App Launchpad
    • Probar la conexión con VMware Marketplace desde el servidor de App Launchpad
    • Probar la conexión con Amazon S3 desde celdas de VMware Cloud Director
    Si no hay errores de implementación, el sistema devuelve el mensaje siguiente: 
    [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.