Cette page a été traduite par l'API Cloud Translation.

Installer la nouvelle expérience Edge (bêta)

Edge for Private Cloud v4.18.05

Ce document explique comment installer la version bêta de la nouvelle expérience Edge pour Edge pour le cloud privé. La nouvelle expérience Edge est la nouvelle génération d'interface utilisateur pour Edge.

Pour tester l'expérience New Edge dans une installation Edge pour le cloud privé, vous devez:

Activer SAML sur Edge. La nouvelle expérience Edge n'est compatible qu'avec SAML comme mécanisme d'authentification.
Installez la nouvelle expérience Edge sur son propre nœud. Vous ne pouvez pas l'installer sur un nœud contenant d'autres composants Edge.

Pour en savoir plus sur la nouvelle expérience Edge, consultez la page La nouvelle expérience Edge pour le cloud privé.

Présentation de l'installation

Pour installer la version bêta de la nouvelle expérience Edge pour Edge pour le cloud privé, vous devez effectuer deux processus d'installation différents:

Installez l'interface utilisateur Edge de base, appelée shoehorn, puis configurez-la pour qu'elle utilise SAML afin de vous authentifier auprès d'Edge.

Remarque: Vous ne pouvez pas utiliser l'interface utilisateur Edge de base pour vous connecter à Edge. Il s'agit simplement d'une exigence pour installer la nouvelle expérience Edge.
Installez la nouvelle expérience Edge et configurez-la pour qu'elle utilise SAML pour l'authentification auprès d'Edge. Après avoir installé la nouvelle expérience Edge, vous pouvez vous connecter et l'utiliser pour fonctionner avec Edge.

Conditions requises pour l'installation

Vous devez activer SAML sur Edge avant d'installer la nouvelle expérience Edge. New Edge n'est compatible qu'avec le mécanisme d'authentification SAML.
Remarque: Dans un environnement hors production, vous pouvez laisser l'authentification de base activée sur Edge afin que les utilisateurs de l'interface utilisateur classique et de l'API Edge puissent toujours utiliser l'authentification de base.

Pour plus d'informations sur l'activation de SAML sur Edge, voir Prise en charge de SAML sur Edge for Private Cloud.
Vous devez installer la nouvelle expérience Edge sur son propre nœud. Vous ne pouvez pas l'installer sur un nœud contenant d'autres composants Edge. Le nœud doit répondre aux exigences suivantes :
- JAVA 1.8
- 4 Go de RAM
- 2 cœurs
- 60 Go d'espace disque
- Vous devez d'abord installer la version 4.18.05 de l'utilitaire apigee-setup sur le nœud, comme décrit dans la section Installer l'utilitaire de configuration d'Apigee Edge.

Éléments à prendre en compte avant d'installer la nouvelle expérience Edge

Comme décrit ci-dessus dans les conditions préalables, vous devez activer SAML sur Edge pour pouvoir profiter de l'expérience New Edge. Cela signifie que l'authentification des utilisateurs est contrôlée par un IdP SAML, pour lequel vous le configurez pour qu'il utilise des adresses e-mail comme ID utilisateur. Tous les utilisateurs de New Edge Experience doivent donc être enregistrés auprès de l'IdP SAML.

L'interface utilisateur classique d'Edge, l'interface utilisateur par défaut que vous avez installée avec Edge pour le cloud privé, ne nécessite pas SAML. Elle peut utiliser soit l'authentification SAML, soit l'authentification de base. Vous pouvez donc:

Activez la prise en charge de SAML sur Edge, ainsi que sur l'interface utilisateur classique et la nouvelle expérience Edge.
Dans ce scénario, tous les utilisateurs de l'interface utilisateur classique et de la nouvelle expérience Edge sont enregistrés auprès de l'IdP SAML. Pour plus d'informations sur l'ajout de nouveaux utilisateurs à l'IdP SAML, consultez Enregistrer de nouveaux utilisateurs Edge.
Activer la prise en charge SAML sur Edge, mais laisser l'authentification de base activée. La nouvelle expérience Edge utilise SAML, tandis que l'interface utilisateur classique utilise toujours l'authentification de base.
Dans ce scénario, tous les utilisateurs de l'interface utilisateur classique se connectent avec des identifiants d'authentification de base, où leurs identifiants sont stockés dans la base de données Edge OpenLDAP. Les nouveaux utilisateurs de l'expérience Edge sont enregistrés auprès de l'IdP SAML et se connectent à l'aide de SAML.

Toutefois, un utilisateur d'interface utilisateur classique ne peut pas se connecter à la nouvelle expérience Edge tant que vous ne l'avez pas ajouté à l'IdP SAML, comme décrit dans Enregistrer de nouveaux utilisateurs Edge.

Modifications de la configuration d'installation par rapport à Edge 4.18.01

La version Edge 4.18.05 de l'expérience New Edge contient les modifications suivantes apportées au fichier de configuration de la version Edge 4.18.01. Ces propriétés sont décrites en détail dans la section suivante:

Change type	Propriétés concernées
Ajouté	# Shoehorn UI configurations. SHOEHORN_SCHEME SHOEHORN_IP SHOEHORN_PORT # Classic UI configurations. CLASSIC_UI_SCHEME CLASSIC_UI_IP CLASSIC_UI_PORT # Information about Edge SSO module. MANAGEMENT_UI_SKIP_VERIFY
Supprimée	ROUTES_SHOEHORN ROUTES_CLASSICUI
Remplacement	MANAGEMENT_UI_USE_HTTPS Remplacé par: MANAGEMENT_UI_SCHEME

Change type

Propriétés concernées

Ajouté

# Shoehorn UI configurations.
SHOEHORN_SCHEME
SHOEHORN_IP
SHOEHORN_PORT

# Classic UI configurations.
CLASSIC_UI_SCHEME
CLASSIC_UI_IP
CLASSIC_UI_PORT

# Information about Edge SSO module.
MANAGEMENT_UI_SKIP_VERIFY

Supprimée

ROUTES_SHOEHORN
ROUTES_CLASSICUI

Remplacement

MANAGEMENT_UI_USE_HTTPS

Remplacé par:

MANAGEMENT_UI_SCHEME

Fichier de configuration d'installation

Le fichier de configuration contient toutes les informations nécessaires pour installer et configurer la nouvelle expérience Edge. Vous pouvez utiliser le même fichier de configuration pour installer et configurer l'interface utilisateur de base et l'expérience New Edge.

Voici un exemple de fichier de configuration:

# 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

#
# New Edge experience configuration.
#

# Enable the New Edge experience.
EDGEUI_ENABLE_UNIFIED_UI=y
# Specify IP and port for the New Edge experience.
MANAGEMENT_UI_PORT=3001
MANAGEMENT_UI_IP=$IP2
# Specify a Private Cloud deployment.
MANAGEMENT_UI_APP_ENV=OPDK
# Disable TLS on the New Edge experience.
# This release does not support TLS.
MANAGEMENT_UI_SCHEME=http

# 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

# 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

#
# Shoehorn UI configuration.
#

# The first two properties use the same values as the New Edge experience.
SHOEHORN_SCHEME=$MANAGEMENT_UI_SCHEME
SHOEHORN_IP=$MANAGEMENT_UI_IP
SHOEHORN_PORT=9000

#
# Edge Classic UI configuration.
# Some settings are for the classic UI,
# but are still required to configure the New Edge experience.
#

# These settings assume that Classic UI is installed on the Management Server.
CLASSIC_UI_IP=$MSIP
CLASSIC_UI_PORT=9000
CLASSIC_UI_SCHEME=http
EDGEUI_PUBLIC_URIS=$CLASSIC_UI_SCHEME://$CLASSIC_UI_IP:$CLASSIC_UI_PORT

# Information about publicly accessible URL for Classic UI.
EDGEUI_SSO_REGISTERED_PUBLIC_URIS=$EDGEUI_PUBLIC_URIS

# Enable SSO.
EDGEUI_SSO_ENABLED=y

# 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".
SSO_PUBLIC_URL_SCHEME=http
# MANAGEMENT_UI_SKIP_VERIFY=y
# 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"

Installer l'interface utilisateur Edge de base (chaussure)

Vous devez installer l'interface utilisateur Edge de base, appelée shoehorn, avant de pouvoir installer la nouvelle expérience Edge.

Pour installer l'interface utilisateur de base:

Installez la version 4.18.05 de l'utilitaire apigee-setup sur le nœud, comme décrit dans la section Installer l'utilitaire de configuration d'Edge Apigee.
Clean Yum:
```
sudo yum clean all
```
Créez le fichier de configuration comme décrit ci-dessus et assurez-vous qu'il appartient à l'utilisateur "apigee" :
```
chown apigee:apigee configFile
```
où configFile est le fichier de configuration décrit ci-dessus dans la section Fichier de configuration d'installation.
Installez la version Shoehorn de l'interface utilisateur Edge :
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui install
```

Configurez l'interface utilisateur Edge :

/opt/apigee/apigee-service/bin/apigee-service edge-ui setup -f configFile

Activez SAML dans l'interface utilisateur Edge :
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui configure-sso -f configFile
```
Attention: N'essayez pas de vous connecter à l'interface utilisateur avant d'avoir installé et configuré l'expérience New Edge ci-dessous.

Installer la nouvelle expérience Edge

Après avoir installé l'interface utilisateur Edge de base, vous pouvez ensuite installer et configurer la nouvelle expérience Edge.

Pour installer la nouvelle expérience Edge:

Installez la nouvelle expérience Edge :

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

Accédez au répertoire edge-management-ui :
```
cd /opt/apigee/edge-management-ui
```
Configurez la nouvelle expérience Edge :
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui setup -f configFile
```
où configFile est le fichier de configuration décrit ci-dessus dans la section Fichier de configuration d'installation.

Activer SAML dans la nouvelle expérience Edge :

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-sso -f configFile

Connectez-vous à l'expérience New Edge en ouvrant l'URL suivante dans un navigateur :
```
http://newEdgeExperienceIP:3001
```
où newEdgeExperienceIP est l'adresse IP du nœud hébergeant la nouvelle expérience Edge. Vous serez invité à saisir vos identifiants SAML. Une fois vos identifiants saisis, l'expérience New Edge s'affiche.
Consultez la section Nouvelle expérience Edge pour le cloud privé (bêta) pour plus d'informations, y compris des liens pour plus d'informations sur l'utilisation de la nouvelle expérience Edge.

Désinstaller la nouvelle expérience Edge

Pour désinstaller la nouvelle expérience Edge:

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

Pour désinstaller l'interface utilisateur Edge de base (shoehorn):

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

Pour supprimer complètement Edge du nœud:

Arrêtez tous les services Edge exécutés sur la machine :
```
/opt/apigee/apigee-service/bin/apigee-all stop
```
Videz le cache yum :
```
sudo yum clean all
```

Supprimez tous les RPM Apigee :

sudo rpm -e $(rpm -qa | egrep "(apigee-|edge-)")

Supprimez le répertoire racine d'installation :
```
sudo rm -rf /opt/apigee
```