Instala la nueva experiencia Edge (beta)

Edge for Private Cloud v4.18.01

En este documento, se describe cómo instalar la versión beta de la nueva experiencia de Edge para Edge para la nube privada. La nueva experiencia de Edge es la nueva generación de IU para Edge.

Si deseas probar la nueva experiencia de Edge en un perímetro para la instalación de una nube privada, debes seguir estos pasos:

  • Habilitar SAML en Edge La nueva experiencia de Edge solo admite SAML como método de autenticación de atención.
  • Instalar la nueva experiencia de Edge en su propio nodo No puedes instalarla en un nodo que contiene otros componentes de Edge.

Para obtener más información sobre la nueva experiencia de Edge, consulta La nueva experiencia perimetral para Nube privada.

Descripción general de instalación

Para instalar la versión beta de la nueva experiencia de Edge para Edge en la nube privada, realizar dos procesos de instalación diferentes:

  • Instala la IU de Edge básica, llamada shoehorn, y configura la base. IU de Edge para usar SAML en la autenticación con Edge
  • Instala la nueva experiencia de Edge y configúrala para lo siguiente: usar SAML para autenticar con Edge. Después de instalar la nueva experiencia de Edge, puedes acceder y usarlo para trabajar con Edge.

Requisitos previos de la instalación

  • Debes habilitar SAML en Edge antes de instalar la nueva experiencia de Edge. El nuevo perímetro solo admite SAML como mecanismo de autenticación.

    Nota: En un entorno que no es de producción, puedes dejar la autenticación básica en Edge para que los usuarios de la IU clásica y de la API de Edge puedan seguir usando autenticación.

    Para saber cómo habilitar SAML en Edge, consulta Compatibilidad con SAML en Edge para la nube privada.
  • Debes instalar la nueva experiencia de Edge en su propio nodo. No puedes instalarlo en un nodo. que incluye otros componentes de Edge. El nodo debe cumplir los siguientes requisitos:
    • JAVA 1.8
    • 4 GBytes de RAM
    • 2 núcleos
    • 60 GB de espacio en disco
    • Primero debes instalar la versión 4.18.01 de la utilidad apigee-setup en al nodo, como se describe en Instala Edge apigee-setup.

Consideraciones antes de instalar el nuevo Experiencia perimetral

Como se describió anteriormente en los requisitos previos, la nueva experiencia de Edge requiere que habilites SAML en Edge. Esto significa que la autenticación de usuarios está controlada por un IdP de SAML, en el que se configura el IDP para usar direcciones de correo electrónico como ID de usuario. Por lo tanto, todos los usuarios de la nueva experiencia de Edge deben registrados en el IdP de SAML.

La IU clásica de Edge, la IU predeterminada que instalaste con Edge para la nube privada, no requieren SAML. Puede usar SAML o autenticación básica. Esto significa que puedes hacer lo siguiente:

  • Habilita la compatibilidad con SAML en Edge y en la IU clásica y la nueva experiencia de Edge.

    En esta situación, todos los usuarios de la IU clásica y de la nueva experiencia perimetral se registran en el IdP de SAML. Para obtener información sobre cómo agregar usuarios nuevos al IdP de SAML, consulta Registra usuarios de Edge nuevos.
  • Habilitar la compatibilidad con SAML en Edge, pero dejar habilitada la autenticación básica La nueva experiencia de Edge usa SAML y la IU clásica todavía usan la autenticación básica.

    En esta situación, todos los usuarios de la IU clásica acceden con credenciales de autenticación básicas, en las que sus credenciales se almacenan en la base de datos de OpenLDAP de Edge. Los usuarios con la nueva experiencia de Edge deben estar registrados en el IdP de SAML y acceder con SAML.

    Sin embargo, un usuario de la IU clásica no podrá acceder a la nueva experiencia de Edge hasta que agregues esa usuario al IdP de SAML como se describe en Registrar un dispositivo perimetral nuevo individuales.

Archivo de configuración de la instalación

El archivo de configuración contiene toda la información necesaria para instalar y configurar el Nuevo Experiencia perimetral Puedes usar el mismo archivo de configuración para instalar y configurar IU y la nueva experiencia de Edge.

A continuación, se muestra un ejemplo de archivo de configuración:

# IP of the Edge Management Server. 
# This node also hosts the Edge SSO module and the current, or classic, Edge UI.
IP1=11.111.111.111

# IP of the New Edge experience node.
IP2=22.222.222.222 

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

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

# URLs for the different UIs.
# URL of classic Edge UI.
ROUTES_CLASSICUI="http://$IP1:9000"
# URL of New Edge experience.
ROUTES_SHOEHORN="http://$IP2:9000"

# New Edge experience configuration.
# Enable the New Edge experience.
EDGEUI_ENABLE_UNIFIED_UI=y
# Access port for the New Edge experience.
MANAGEMENT_UI_PORT=3001
MANAGEMENT_UI_APP_ENV=OPDK
MANAGEMENT_UI_IP=$IP2
# Disable TLS on the New Edge experience.
# This release does not support TLS.
MANAGEMENT_UI_USE_HTTPS=n

# SSO configuration for the New Edge experience.
MANAGEMENT_UI_SSO_ENABLED=y
MANAGEMENT_UI_SSO_CLIENT_OVERWRITE=y
MANAGEMENT_UI_SSO_CLIENT_ID=newueclient
MANAGEMENT_UI_SSO_CLIENT_SECRET=secret111

# Location of New Edge experience.
MANAGEMENT_UI_PUBLIC_URIS=http://$IP2:3001
MANAGEMENT_UI_SSO_REGISTERED_PUBLIC_URIS=$MANAGEMENT_UI_PUBLIC_URIS
MANAGEMENT_UI_SSO_CSRF_SECRET=secret222
MANAGEMENT_UI_SSO_CSRF_EXPIRATION_HOURS=24
MANAGEMENT_UI_SSO_STRICT_TRANSPORT_SECURITY_AGE_HOURS=24
MANAGEMENT_UI_SSO_PUBLIC_KEY_CACHE_HOURS=0.5

# Edge SSO configuration.
# Some settings are for the classic UI, 
# but are still required to configure the New Edge experience.
# Enable SSO.
EDGEUI_SSO_ENABLED=y

# Information about Classic UI
EDGEUI_PUBLIC_URIS=http://$IP1:9000
# Information about publicly accessible URL for Classic UI.
EDGEUI_SSO_REGISTERED_PUBLIC_URIS=$EDGEUI_PUBLIC_URIS
# The name of the OAuth client used to connect to apigee-sso. 
# The default client name is edgeui.
# Apigee recommends that you use the same settings as you used
# when enabling SAML on the classic Edge UI.
EDGEUI_SSO_CLIENT_NAME=edgeui
# Oauth client password using uppercase, lowercase, number, and special chars. 
EDGEUI_SSO_CLIENT_SECRET=ssoClient123
# If set, existing EDGEUI client will deleted and new one will be created.
EDGEUI_SSO_CLIENT_OVERWRITE=y

# Information about Edge SSO module.
# Externally accessible IP or DNS of Edge SSO module.
SSO_PUBLIC_URL_HOSTNAME=$IP1
SSO_PUBLIC_URL_PORT=9099
# Default is http. Set to https if you enabled TLS on the Edge SSO module.
# If Edge SSO uses a self-signed cert, you must also set MANAGEMENT_UI_SKIP_VERIFY to "y".
# MANAGEMENT_UI_SKIP_VERIFY=y
SSO_PUBLIC_URL_SCHEME=http
# SSO admin credentials as set when you installed Edge SSO module.
SSO_ADMIN_NAME=ssoadmin
SSO_ADMIN_SECRET=Secret123

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

Instala la IU base de Edge (Shoehorn).

Debes instalar la IU básica de Edge, llamada shoehorn, antes de instalar el nuevo Experiencia perimetral

Para instalar la IU base, haz lo siguiente:

  1. Instala la versión 4.18.01 de la utilidad apigee-setup en el nodo como que se describe en Instala la configuración de Apigee de Edge utilidad.
  2. Yum limpio: 
    > sudo yum clean all
  3. Cree el archivo de configuración como se describió anteriormente y asegúrese de que sea propiedad de “apigee” usuario: 
    > chown apigee:apigee configFile

    En el ejemplo anterior, configFile es el archivo de configuración descrito anteriormente en Archivo de configuración de la instalación.

  4. Instala la versión de Shoehorn de la IU de Edge: 
    > /opt/apigee/apigee-service/bin/apigee-service edge-ui install
  5. Configura la IU de Edge: 
    > /opt/apigee/apigee-service/bin/apigee-service edge-ui setup -f configFile
  6. Habilita SAML en la IU de Edge: 
    > /opt/apigee/apigee-service/bin/apigee-service edge-ui configure-sso -f configFile

Instala la nueva experiencia de Edge

Después de instalar la IU básica de Edge, puedes instalar y configurar el nuevo Edge una experiencia fluida a los desarrolladores.

Para instalar la nueva experiencia de Edge, sigue estos pasos:

  1. Instala la nueva experiencia de Edge: 
    > /opt/apigee/apigee-service/bin/apigee-service edge-management-ui install
  2. Cambia al directorio edge-management-ui: 
    > cd /opt/apigee/edge-management-ui
  3. Configura la nueva experiencia de Edge: 
    > /opt/apigee/apigee-service/bin/apigee-service edge-management-ui setup -f configFile

    En el ejemplo anterior, configFile es el archivo de configuración descrito anteriormente en Archivo de configuración de la instalación.

  4. Habilita SAML en la nueva experiencia de Edge: 
    > /opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-sso -f configFile
  5. Para acceder a la nueva experiencia de Edge, abre la siguiente URL en un navegador: 
    http://newEdgeExperienceIP:3001

    En el ejemplo anterior, newEdgeExperienceIP es la dirección IP del nodo que aloja el nodo. la nueva experiencia de Edge. Se le solicitarán sus credenciales de SAML. Luego de ingresar credenciales, aparecerá la experiencia New Edge.

  6. Conoce las novedades Edge Experience for Private Cloud (Beta) para obtener más información, incluidos vínculos a información sobre el uso de la nueva experiencia de Edge.

Desinstala la nueva experiencia de Edge

Para desinstalar la nueva experiencia de Edge, haz lo siguiente:

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

Para desinstalar la IU básica de Edge (shoehorn), haz lo siguiente:

> /opt/apigee/apigee-service/bin/apigee-service edge-ui uninstall

Para quitar Edge por completo del nodo, haz lo siguiente:

  1. Detén todos los servicios de Edge que se ejecuten 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-|baas)")
  4. Quita el directorio raíz de instalación: 
    > sudo rm -rf /opt/apigee