Avant de commencer

Avant d'installer Apigee mTLS, vous devez vous assurer que vous n'avez pas désactivé localhost et que vous avez remplacé un service de pare-feu par défaut (dans de nombreux cas, firewalld) par iptables sur les nœuds de votre cluster.

Sauvegarder vos données Cassandra, Zookeeper et Postgres

Avant d'installer Apigee mTLS, vous devez sauvegarder les données des composants suivants :

  • apigee-cassandra
  • apigee-zookeeper
  • apigee-postgresql

Pour savoir comment sauvegarder les données de ces composants, consultez Comment sauvegarder.

Assurez-vous que l'adresse loopback est activée

Apigee mTLS nécessite l'activation de l'adresse loopback localhost. L'adresse IP 127.0.0.1 doit être routable et doit correspondre à localhost sur chaque nœud du cluster. Les serveurs proxy Consul du maillage de services en dépendent.

Si vous avez déjà désactivé l'adresse loopback localhost, vous devez la réactiver sur tous les nœuds de votre cluster.

Remplacer le pare-feu par défaut

Le pare-feu par défaut sur CentOS et RedHat Enterprise Linux (RHEL) est firewalld. Toutefois, Apigee mTLS nécessite que vous utilisiez iptables comme pare-feu. Par conséquent, vous devez :

  1. Désactivez et supprimez firewalld, s'il est installé.

    ET

  2. Installez iptables sur chaque nœud et assurez-vous qu'il est en cours d'exécution.

Cette section explique comment effectuer ces tâches.

L'ordre des nœuds sur lesquels vous effectuez cette opération n'a pas d'importance.

Pour désinstaller firewalld et vous assurer que iptables est installé et en cours d'exécution :

  1. Connectez-vous au nœud en tant qu'utilisateur racine.
  2. Arrêtez tous les composants en exécutant la commande suivante : 
    /opt/apigee/apigee-service/bin/apigee-all stop
  3. Désactivez et désinstallez firewalld :
    1. Arrêtez le service firewalld en exécutant la commande suivante : 
      systemctl stop firewalld
    2. Désactivez le service firewalld et masquez-le en exécutant les commandes suivantes : 
      systemctl disable firewalld
systemctl mask --now firewalld
    3. Supprimez le service firewalld avec yum en exécutant la commande suivante : 
      yum remove firewalld
    4. Réinitialisez tous les services dont l'état est "Échec" en exécutant la commande suivante : 
      systemctl reset-failed
    5. Actualisez tous les services en exécutant la commande suivante : 
      systemctl daemon-reload
  4. Installez iptables :
    1. Installez les packages iptables et iptables-services en exécutant la commande suivante : 
      yum install iptables iptables-services
    2. Actualisez les services en cours d'exécution en exécutant la commande suivante : 
      systemctl daemon-reload
    3. Activez iptables en exécutant la commande suivante : 
      systemctl enable iptables ip6tables
    4. Démarrez les services iptables et ip6tables en exécutant la commande suivante : 
      systemctl start iptables ip6tables
  5. Répétez ce processus pour chaque nœud du cluster.