Migra las propiedades de la IU clásica a la IU de Edge nueva

En Apigee Edge para nube privada 4.54.00, se quita la IU clásica (el componente edge-ui) y ya no está disponible. La IU de Edge nueva (el componente edge-management-ui) es la única IU de Edge para nube privada.

No puedes usar edge-ui en Edge para nube privada 4.54.00. Si personalizaste la IU clásica configurando propiedades en /opt/apigee/customer/application/ui.properties, la nueva IU de Edge no leerá ese archivo. Después de actualizar a la versión 4.54.00, debes establecer las propiedades equivalentes en /opt/apigee/customer/application/management-ui.properties.

En esta página, se enumeran las propiedades de la IU clásica documentadas para ui.properties, las propiedades equivalentes para la IU de New Edge y las propiedades de la IU clásica que no se admiten en la IU de New Edge.

La nueva IU de Edge usa el mismo mecanismo de código con configuración (CwC) que otros componentes de Edge. Para obtener más información, consulta Cómo configurar Edge.

Compara las configuraciones de la IU clásica y la nueva IU de Edge

La nueva IU de Edge reemplaza el componente de IU clásica, el archivo de propiedades, el nombre del servicio, el puerto predeterminado y el formato del certificado TLS. Revisa la siguiente tabla para actualizar tus secuencias de comandos de automatización, reglas de firewall y archivos TLS antes de migrar tus propiedades:

Establece propiedades para la nueva IU de Edge

Establece las propiedades de configuración de la IU de New Edge en /opt/apigee/customer/application/management-ui.properties y reinicia el servicio edge-management-ui para que los cambios se apliquen.

Para establecer una propiedad para la IU de Edge nueva, sigue estos pasos:

1. Abre el archivo management-ui.properties en un editor. Si el archivo no existe, créalo:

   vi /opt/apigee/customer/application/management-ui.properties
   

2. Establece la propiedad. Por ejemplo:

   conf_uebe_disableGeoMap=true

3. Guarda los cambios.
4. Asegúrate de que el archivo sea propiedad del usuario apigee:

   chown apigee:apigee /opt/apigee/customer/application/management-ui.properties
   

5. Reinicia la nueva IU de Edge:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
   

Sigue estas reglas de formato cuando configures las propiedades de la IU de Edge nueva:

• Los nombres de las propiedades distinguen mayúsculas de minúsculas. Por ejemplo, conf_uebe_disableGeoMap es válido, pero conf_uebe_disablegeomap no lo es.
• Encierra los valores de cadena entre comillas dobles, por ejemplo, conf_uebe_branding_companyNameShort="My Company".
• No encierres entre comillas los valores booleanos (true o false) ni los valores numéricos. Si un valor booleano o numérico está entre comillas, la IU de Edge nueva no se inicia.

Para verificar el valor actual de una propiedad, usa la opción -search. Por ejemplo:

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui \
  configure -search conf_uebe_disableGeoMap

Asigna las propiedades de la IU clásica a la nueva IU de Edge

En las siguientes tablas, se asigna cada propiedad de la IU clásica admitida en ui.properties a su propiedad equivalente de la IU de Edge nueva en management-ui.properties. En la columna Predeterminado, se muestra el valor predeterminado en la IU de Edge nueva.

Configura las propiedades de los componentes

Asigna las marcas de función de la IU clásica a las propiedades de conf_uebe_* correspondientes en management-ui.properties:

Configura las propiedades de sesión y TLS

Asigna el tiempo de espera de la sesión de la IU clásica y las propiedades de TLS a sus equivalentes de la IU de Edge nueva en management-ui.properties:

Configura las propiedades y plantillas de correo electrónico

Asigna las propiedades de remitente, asunto, desarrollo de la marca, URL del host y vencimiento del vínculo del correo electrónico de la IU clásica de Map a la nueva IU de Edge:

La nueva IU de Edge usa plantillas de correo electrónico integradas. Para usar las plantillas que personalizaste para la IU clásica, haz lo siguiente:

1. Crea el directorio /opt/apigee/edge-management-ui/email-templates.
2. Copia los archivos personalizados password-reset.html, user-added-existing.html y user-added-new.html del directorio de copia de seguridad que creaste antes de la actualización (por ejemplo, /opt/apigee/customer/backup/) a /opt/apigee/edge-management-ui/email-templates. Los nombres de los archivos de plantilla y los marcadores de posición son los mismos que en la IU clásica.
3. Asegúrate de que el directorio y los archivos pertenezcan al usuario apigee.
4. Reinicia la IU de New Edge.

Para obtener más información, consulta Personaliza plantillas de correo electrónico de Edge.

Configura las propiedades de las contraseñas generadas automáticamente

Asigna las propiedades de contraseña generadas de forma automática de la IU clásica a la IU de New Edge:

Configura la conexión del servidor de administración y las propiedades del secreto compartido

Asigna las propiedades de conexión, credenciales y secreto de la aplicación del servidor de administración de la IU clásica de Edge a la nueva IU de Edge:

Quita las propiedades de la IU clásica que no requieren ninguna acción

Las siguientes propiedades de la IU clásica no tienen equivalente en la IU de Edge nueva porque el comportamiento siempre está habilitado. No incluyas estas propiedades en management-ui.properties (y quítalas de cualquier secuencia de comandos de configuración automatizada):

Quita las propiedades no compatibles de la IU clásica

Las siguientes propiedades de la IU clásica no son compatibles y no tienen equivalente en la nueva IU de Edge. No incluyas estas propiedades en management-ui.properties (y quítalas de cualquier secuencia de comandos de configuración automatizada):

Revisa un ejemplo de migración

En el siguiente ejemplo, se compara un archivo ui.properties de la IU clásica con el archivo management-ui.properties equivalente para la IU de Edge nueva.

IU clásica, /opt/apigee/customer/application/ui.properties:

conf_apigee_apigee.feature.disablegeomap=false
conf_apigee-base_apigee.feature.enabletraceforinternaladdresses="true"
conf_application_session.maxage="1d"
conf_apigee-base_apigee.emails.passwordreset.subject="Reset your My Company password"
conf_apigee_apigee.branding.companynameshort="My Company"
conf_apigee_apigee.emails.hosturl="https://ui.mycompany.com"

IU de Edge nueva, /opt/apigee/customer/application/management-ui.properties:

conf_uebe_disableGeoMap=false
conf_uebe_trace_for_internal_addresses=true
conf_uebe_authsessiontimeout=24
conf_apigee_apigee.emails.passwordReset.subject="Reset your My Company password"
conf_uebe_branding_companyNameShort="My Company"
conf_apigee_apigee.emails.hosturl="https://ui.mycompany.com"

Ten en cuenta que el valor booleano true no está entre comillas y que el tiempo de espera de la sesión 1d se reemplaza por 24.

Después de guardar el archivo, reinicia la IU de New Edge:

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Lista de tareas de resumen

Usa la siguiente lista de tareas para completar la migración a la nueva IU de Edge en Apigee Edge para la nube privada 4.54.00:

1. Crea una copia de seguridad de /opt/apigee/customer/application/ui.properties y de cualquier plantilla de correo electrónico personalizada de /opt/apigee/edge-ui/email-templates antes de actualizar.
2. Agrega propiedades asignadas a /opt/apigee/customer/application/management-ui.properties sin citar valores booleanos o numéricos, y omite las propiedades de la IU clásica no admitidas.
3. Copia las plantillas de correo electrónico personalizadas de tu directorio de copia de seguridad a /opt/apigee/edge-management-ui/email-templates.
4. Vuelve a encriptar las credenciales de administrador del sistema con ./bin/management-ui --encrypt si configuras conf_uebe_mgmtCredential.
5. Establece la propiedad del archivo en apigee:apigee y reinicia edge-management-ui.