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

Rollback d'Apigee Edge 4.52.01

Si vous rencontrez une erreur lors d'une mise à jour vers Edge 4.52.01, vous pouvez effectuer un rollback du à l'origine de l'erreur, puis relancez la mise à jour.

Vous pouvez effectuer un rollback d'Edge 4.52.01 vers les versions majeures suivantes:

Version 4.52.00
Version 4.51.00

Vous pouvez effectuer un rollback dans deux cas :

Effectuer un rollback vers une version majeure ou mineure précédente Par exemple, de 4.52.01 à 4.52.00.
Effectuer un rollback vers une version de correctif précédente du même version. Par exemple, de 4.52.00.02 à 4.52.00.01.

Pour plus d'informations, voir Version d'Apigee Edge processus.

Qui peut effectuer un rollback

L'utilisateur effectuant un rollback doit être l'utilisateur qui a initialement mis à jour Edge, ou un en tant qu'utilisateur racine.

Par défaut, les composants Edge s'exécutent en tant qu'utilisateur "apigee". Dans certains cas, vous pouvez exécuter Edge composants en tant que différents utilisateurs. Par exemple, si le routeur doit accéder à des ports privilégiés, tels que ceux inférieurs à 1 000, vous devez exécuter le routeur en tant que racine ou en tant qu'utilisateur ayant accès à ces . Vous pouvez également exécuter un composant en tant qu'utilisateur et un autre composant en tant qu'autre utilisateur.

Composants avec du code commun

Les composants Edge suivants partagent un code commun. Par conséquent, pour effectuer un rollback de l'une ces composants sur un nœud, vous devez effectuer un rollback de tous les composants qui se trouvent sur ce nœud.

edge-management-server (serveur de gestion)
edge-message-processor (processeur de messages)
edge-router (routeur)
edge-postgres-server (serveur Postgres)
edge-qpid-server (serveur Qpid)

Par exemple, si le serveur de gestion, le routeur et le processeur de messages sont installés sur le nœud, vous devez les désinstaller tous les trois pour annuler l'un d'entre eux.

Effectuer un rollback vers une version majeure ou mineure précédente

Pour effectuer un rollback vers une version majeure ou mineure précédente, procédez comme suit sur chaque nœud qui héberge le composant:

Téléchargez le fichier bootstrap.sh correspondant à la version à déployer retour:
- Pour revenir à la version 4.51.00, téléchargez bootstrap_4.51.00.sh:
```
curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh 
```

Arrêtez le composant à restaurer:

Pour effectuer le rollback de l'un des composants avec du code commun sur le vous devez tous les arrêter, comme illustré dans l'exemple suivant:

/opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop

Pour effectuer un rollback vers un autre composant du nœud, arrêtez uniquement ce composant: <ph type="x-smartling-placeholder">
- ```
/opt/apigee/apigee-service/bin/apigee-service component stop
```

Si vous effectuez un rollback de la monétisation, désinstallez-la de l'ensemble du serveur de gestion et des messages Nœuds de processeur:
```
/opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
```
Désinstallez le composant pour effectuer un rollback sur le nœud:
1. Pour effectuer le rollback de l'un des composants avec du code commun sur la vous devez tous les désinstaller en désinstallant le composant edge-gateway. , comme le montre l'exemple suivant:
```
/opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
```
2. Pour effectuer le rollback d'un autre composant du nœud, désinstallez-le uniquement, l'exemple suivant montre:
```
/opt/apigee/apigee-service/bin/apigee-service component uninstall
```
  où component est le nom du composant.
3. Pour effectuer un rollback du routeur Edge, vous devez supprimer le contenu du /opt/nginx/conf.d, et désinstaller le Groupe de composants edge-gateway:
```
cd /opt/nginx/conf.d
rm -rf *
```

Désinstallez la version 4.52.01 de apigee-setup:

/opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall

Installez la version 4.51.00 de apigee-service. utilitaire et ses dépendances. L'exemple suivant installe la version 4.51.00 de apigee-service :
```
sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord
```
Où uName et pWord sont le nom d'utilisateur et le mot de passe que vous avez reçus. d'Apigee. Si vous omettez pWord, vous serez invité à le faire.

Si un message d'erreur s'affiche, assurez-vous d'avoir téléchargé le fichier bootstrap.sh à l'étape 1.

Installez apigee-setup:

/opt/apigee/apigee-service/bin/apigee-service apigee-setup install

Installez l'ancienne version du composant:
```
/opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile
```
où component est le composant à installer et configFile est votre fichier de configuration pour l'ancienne version.
Si vous effectuez un rollback de Qpid, videz iptables :
```
sudo iptables -F
```
Répétez cette procédure pour chaque nœud qui héberge le composant faisant l'objet d'un rollback.

Effectuer un rollback vers une version de correctif précédente

Pour effectuer le rollback d'un composant vers une version de correctif spécifique, procédez comme suit sur chaque nœud qui héberge le composant:

Téléchargez la version spécifique du composant:
```
/opt/apigee/apigee-service/bin/apigee-service component_version install
```
Où component_version correspond au composant et à la version de correctif à installer. Par exemple :
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui-4.51.05-0.0.3749 install
```
Si vous utilisez le dépôt en ligne Apigee, vous pouvez déterminer le composant disponible à l'aide de la commande suivante:
```
yum --showduplicates list comp
```
Exemple :
```
yum --showduplicates list edge-ui
```
Installez le composant à l'aide de apigee-setup:
```
/opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile
```
Exemple :
```
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
```
Notez que, lors de l'installation, vous indiquez uniquement le nom du composant, et non sa version.
Répétez cette procédure pour chaque nœud qui héberge le composant faisant l'objet d'un rollback.

Effectuer un rollback de la mise à jour Postgres 10.17

Si vous êtes passé à la version 4.52.01 à partir de la version 4.50.00 ou 4.51.00, vous devez annuler la mise à jour de PostgreSQL en plus des composants Edge.

Pour annuler la mise à jour de Postgres dans une configuration de secours principal:

Convertissez le nouveau nœud de secours en nœud maître Postgres. Le nouveau nœud maître Postgres sera la même version que votre installation Edge précédente.
Configurez l'ancien nœud de secours pour en faire un nœud de secours du nouveau nœud maître. L'ancien nœud de secours sera la même version que votre installation Edge précédente.
Enregistrez les nouveaux nœuds maîtres et de secours auprès des groupes d'analyse et de consommateurs.

Une fois le rollback terminé, l'ancien nœud maître n'est plus nécessaire. Vous pouvez puis mettez l'ancien nœud maître hors service.

Assurez-vous que le nouveau nœud Postgres de secours est en cours d'exécution:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
Si Postgres n'est pas en cours d'exécution, démarrez-le:
```
/opt/apigee/apigee-service/bin/apigee-all start
```

Vérifiez que Postgres est arrêté sur l'ancien nœud maître et l'ancien nœud de secours:

/opt/apigee/apigee-service/bin/apigee-all status

Si Postgres est en cours d'exécution, arrêtez-le:

/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

S'il est installé, démarrez Qpid sur l'ancien nœud de secours:
```
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
```
Remarque: Dans de nombreuses configurations, l'ancien nœud de secours n'hébergera que Postgres, mais pas Qpid.
Promouvez le nouveau nœud de secours en tant que maître Postgres:
1. Faites passer le nouveau nœud de secours en nouveau maître:
```
apigee-service apigee-postgresql promote-standby-to-master new_standby_IP
```
  Si vous y êtes invité, saisissez le mot de passe Postgres de l'utilisateur "apigee", qui est par défaut "postgres".
2. Modifiez le fichier de configuration que vous avez utilisé pour installer votre version actuelle d'Edge afin de spécifier les éléments suivants :
```
# IP address of the new master:
PG_MASTER=new_standby_IP
# IP address of the old standby node
PG_STANDBY=old_standby_IP
```
3. Configurez le nouveau maître:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile
```
Si vous avez déjà mis à niveau l'ancien nœud de secours vers la version plus récente, vous devez d'abord rétrograder le logiciel Apigee sur l'ancien nœud de secours. Si vous utilisez toujours l'ancienne version de secours, vous pouvez ignorer cette étape et passer à l'étape 6.
1. Arrêtez Postgres sur l'ancien nœud de secours:
```
apigee-service apigee-postgresql stop
apigee-service edge-postgres-server stop
```
2. Désinstallez Postgres de l'ancien nœud de secours:
```
apigee-service apigee-postgresql uninstall
apigee-service edge-postgres-server uninstall
```
3. Supprimez le répertoire de données Postgres de l'ancien nœud de secours:
```
cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
```
4. Téléchargez et exécutez l'ancienne version d'amorçage (pour la version d'Apigee que vous déployez ) sur l'ancien nœud de secours. La procédure exacte peut varier selon que vous utilisez une installation en ligne ou hors connexion. L'exécution de l'ancienne version d'Apigee configurer les dépôts yum avec des données de l'ancienne version d'Apigee.
5. Configurez les composants Postgres sur l'ancien nœud de secours:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
```
6. Vérifier que les composants Postgres de l'ancien nœud de secours ont fait l'objet d'un rollback vers l'ancienne version:
```
apigee-service apigee-postgresql version
apigee-service edge-postgres-server version
```
Recréez l'ancien nœud de secours:
1. Modifiez le fichier de configuration que vous avez utilisé pour installer votre version actuelle d'Edge pour spécifier les éléments suivants:
```
# IP address of the new master:
PG_MASTER=new_standby_IP
# IP address of the old standby node
PG_STANDBY=old_standby_IP
```
2. Supprimez le répertoire de données de l'ancien nœud de secours:
```
cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
```
3. Reconfigurez l'ancien nœud de secours pour en faire un nœud de secours du nouveau maître:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
```
4. Vérifiez que Postgres est en cours d'exécution sur l'ancien nœud de secours:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
  Si Postgres n'est pas en cours d'exécution, démarrez-le:
```
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
```
Vérifiez que le nouveau nœud de secours a été ajouté en affichant le /opt/apigee/apigee-postgresql/conf/pg_hba.conf sur le nouveau maître.

Affichez les informations actuelles sur les données analytiques et les groupes de consommateurs en exécutant la commande suivante : sur le serveur de gestion:

curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

Cette commande renvoie le nom du groupe d'analyse dans le champ name, et nom du groupe de consommateurs dans le champ name sous consumer-groups. Il y a aussi renvoie les UUID des anciens nœuds maîtres et nœuds de secours Postgres dans le dans les champs postgres-server et datastores. Vous devriez voir sous la forme suivante:

{
  "name" : "axgroup-001",
  "properties" : {
  },
  "scopes" : [ "VALIDATE~test", "sgilson~prod" ],
  "uuids" : {
    "qpid-server" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
    "postgres-server" : [
      "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256"
    ]
  },
  "consumer-groups" : [ {
    "name" : "consumer-group-001",
    "consumers" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
    "datastores" :
      [ "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256" ],
      "properties" : {     }
    }
  ],
  "data-processors" : {
  }
}

Obtenez l'adresse UUID de l'ancien maître en exécutant la commande curl suivante sur l'ancien nœud maître :
```
curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
```
L'UUID du nœud doit s'afficher à la fin du résultat, sous la forme suivante:
```
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
```
Remarque: Le service edge-postgres-server doit en cours d'exécution. Si le serveur Postgres n'est pas en cours d'exécution, vous pouvez exécuter la commande suivante sur le serveur de gestion pour déterminer l'UUID :
```
curl -u sysAdminEmail:password http://ms_IP:8080/v1/servers?pod=analytics
```
Le résultat de cette commande répertorie l'UUID pour l'adresse IP de chaque nœud Postres.
Répétez l'étape précédente pour obtenir les adresses IP de l'ancien nœud de secours et du nouveau. maître.
Supprimez les anciens nœuds maîtres et de secours du groupe client:
```
curl -u sysAdminEmail:password -X DELETE \
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores/masterUUID,standbyUUID" -v
```
Où axgroup-001 et consumer-group-001 sont les noms par défaut des groupes d'analyse et de consommateurs. Les masterUUID,standbyUUID sont dans le même ordre que apparaît ci-dessus lorsque vous avez consulté les informations actuelles sur les données analytiques et les groupes de consommateurs. Vous devrez peut-être les spécifier en tant que standbyUUID,masterUUID.

La propriété datastores pour consumer-groups doit maintenant être vide.

Supprimez les anciens nœuds maîtres et de secours du groupe d'analyse:

curl -u sysAdminEmail:password -X DELETE \
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v

La propriété postgres-server sous uuids devrait maintenant être vide.

Enregistrez les nouveaux nœuds maîtres et de secours de PG avec les groupes d'analyse et de consommateurs:

curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v
curl -u sysAdminEmail:password -X POST -H "Content-Type:application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores?uuid=masterUUID,standbyUUID" -v

Validez le groupe d'analyse:
```
curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax
```
Les UUID des nouveaux nœuds maître et de secours devraient s'afficher dans le groupe d'analyse et le groupe de consommateurs.

Redémarrez le serveur de gestion Edge:

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

Redémarrez tous les serveurs Qpid:

/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart

Redémarrez tous les serveurs Postgres:

/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

Vérifiez l'état de la réplication en émettant les scripts suivants sur les deux serveurs. Le système doit afficher des résultats identiques sur les deux serveurs pour garantir la réussite de la réplication:
Sur le nouveau nœud maître, exécutez la commande suivante:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
```
Vérifiez qu'il s'agit bien du maître. Sur l'ancien nœud de secours:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
Vérifiez qu'il s'agit de l'instance de secours.
Répétez l'étape précédente après avoir effectué plusieurs requêtes API pour vous assurer que les nœuds sont dans synchro.
Mettez l'ancien système Postgres hors service en suivant la procédure décrite dans Mise hors service d'un Nœud Postgres
Remarque: Si l'ancien nœud maître exécutait Qpid, vous pouvez laisser ce serveur en service pour exécuter Qpid. Vérifiez qu'il est en cours d'exécution. Si ce n'est pas le cas, démarrez-le :
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-server start
```
Vous pouvez également désinstaller Qpid de l'ancienne instance maître et installer Qpid sur le nouveau nœud maître. Après avoir désinstallé Qpid, vous pouvez mettre hors service l'ancien nœud maître.

Effectuer un rollback mTLS

Pour effectuer un rollback de la mise à jour mTLS, procédez comme suit sur tous les hôtes:

Arrêtez Apigee:
```
apigee-all stop
```
Arrêtez l'authentification mTLS:
```
apigee-service apigee-mtls uninstall
```

Réinstallez mTLS:

apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf