Configura la IU de Edge nueva

En este documento, se describe cómo instalar y configurar la nueva IU de Edge para Apigee Edge para nube privada. En la versión 4.54.00, la nueva IU de Edge consta de dos componentes RPM:

  • edge-management-ui: Es el servidor de backend de la nueva IU de Edge.
  • edge-management-ui-static: Son los recursos web estáticos para el frontend de la nueva IU de Edge.

La nueva IU de Edge se instala de forma predeterminada cuando ejecutas setup.sh con el aio (todo en uno), sa (independiente) o ms (servidor de administración), o se puede instalar de forma independiente en un nodo con el perfil ue.

Requisitos previos

Antes de instalar o configurar la nueva IU de Edge en una instalación de Apigee Edge para nube privada, asegúrate de que el nodo cumpla los siguientes requisitos:

  • Requisitos de hardware y SO:
    • 4 GB de RAM
    • 2 núcleos de CPU
    • 60 GB de espacio en disco
    • La versión 4.54.00 de la utilidad apigee-setup instalada en el nodo, como se describe en Instala la utilidad apigee-setup de Edge.
    • El puerto 3001 debe estar abierto. Este es el puerto predeterminado que se usa para las solicitudes a la nueva IU de Edge. Si cambias el puerto con las propiedades que se describen en Archivo de configuración de la nueva IU de Edge, asegúrate de que esté abierto.
  • Autenticación:
    • Autenticación básica (predeterminada): Está habilitada de forma predeterminada (AUTH_MODE=basic). Usa las credenciales del servidor de administración de Edge y SymasLDAP sin requerir un proveedor de identidad externo (IdP).
    • SSO / IdP externo (opcional): De manera opcional, puedes configurar el SSO de Apigee o un IdP externo (como SAML o OIDC). Si te conectas a un IdP externo a través de TLS, tu IdP debe admitir TLS v1.2 o versiones posteriores.

Para obtener más información sobre las funciones de la nueva IU de Edge, consulta La nueva IU de Edge para la nube privada.

Descripción general de la instalación y la configuración

En un nivel superior, el proceso para instalar o volver a configurar la nueva IU de Edge con el ue perfil es el siguiente:

  • Asegúrate de que la utilidad apigee-setup esté instalada en el nodo.
  • Crea un archivo de configuración silenciosa y modifícalo con tu configuración.
  • Ejecuta /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile. Esto instala y configura edge-management-ui y edge-management-ui-static.
  • Accede y prueba la nueva IU de Edge en http://new_edge_UI_IP:3001.

Si tu servidor de administración y el servidor de la nueva IU de Edge están detrás de un balanceador de cargas con descarga de TLS que se produce en el balanceador de cargas, asegúrate de que la configuración refleje las propiedades destacadas en Configura la nueva IU de Edge cuando la finalización de TLS se produce en el balanceador de cargas.

Archivo de configuración de la nueva IU de Edge

En el siguiente ejemplo, se muestra un archivo de configuración para instalar y configurar la nueva IU de Edge con la autenticación básica predeterminada.

Configuración de autenticación básica (predeterminada)

# IP of the Edge Management Server.
IP1=management_server_IP

# IP of the New Edge UI node (can be the same as IP1 or a separate node).
IP2=new_edge_UI_server_IP

# Edge sys admin credentials.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=your_password    # If omitted, you are prompted for it.

# Edge Management Server information.
APIGEE_PORT_HTTP_MS=8080
MSIP=$IP1
MS_SCHEME=http

#
# New Edge UI configuration.
#
MANAGEMENT_UI_PORT=3001
MANAGEMENT_UI_IP=$IP2
MANAGEMENT_UI_APP_ENV=OPDK
MANAGEMENT_UI_SCHEME=http
MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT

# Authentication mode (basic is default)
AUTH_MODE=basic

## SMTP Configuration
SKIP_SMTP=n       # Skip now and configure later by specifying "y".
SMTPHOST=smtp.example.com
SMTPUSER=your@email.com
SMTPPASSWORD=your_email_password
SMTPSSL=y
SMTPPORT=465      # If no SSL, use a different port, such as 25.
SMTPMAILFROM="My Company <myco@company.com>"

Instala o configura la nueva IU de Edge

Para instalar o configurar la nueva IU de Edge con el perfil ue, haz lo siguiente:

  1. Accede al nodo de destino como administrador.
  2. Instala la versión 4.54.00 de la utilidad apigee-setup en el nodo, como se describe en Instala la utilidad apigee-setup de Edge.
  3. Ejecuta el siguiente comando para limpiar toda la información almacenada en caché con Yum: 
    sudo yum clean all
  4. Crea el archivo de configuración como se describe en Archivo de configuración de la nueva IU de Edge y asegúrate de que sea propiedad del usuario "apigee": 
    chown apigee:apigee configFile
  5. En el nodo, ejecuta el siguiente comando: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile

    La utilidad apigee-setup instala y configura edge-management-ui y edge-management-ui-static.

  6. Para acceder a la nueva IU de Edge, abre la siguiente URL en un navegador: 
    http://new_edge_UI_IP:3001

    Donde new_edge_UI_IP es la dirección IP o el nombre de host del nodo que aloja la nueva IU de Edge.

  7. Ingresa tus credenciales.

    Aparecerá la nueva IU de Edge. Para obtener información sobre el uso de la nueva IU de Edge, consulta La nueva IU de Edge para la nube privada.

    Si no se muestra la nueva IU de Edge, asegúrate de que el puerto 3001 esté abierto para las conexiones.

Opcional: Si deseas configurar el SSO de Apigee para la autenticación, sigue los pasos que se indican en Instala y configura el SSO de Apigee y Habilita un IdP externo en la nueva IU de Edge.

Desinstala la nueva IU de Edge

Para desinstalar la nueva IU de Edge de un nodo, desinstala los componentes edge-management-ui y edge-management-ui-static.

Para desinstalar los componentes de la nueva IU de Edge, haz lo siguiente:

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui uninstall
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui-static uninstall

Para quitar todos los componentes de Edge del nodo, haz lo siguiente:

  1. Detén todos los servicios de Edge que se ejecutan en la máquina: 
    /opt/apigee/apigee-service/bin/apigee-all stop
  2. Borra la caché de yum: 
    sudo yum clean all
  3. Quita todos los RPM de Apigee: 
    sudo rpm -e $(rpm -qa | egrep "(apigee-|edge-)")
  4. Quita el directorio raíz de instalación: 
    sudo rm -rf /opt/apigee