Aller au contenu principal
Version: 1.3.1.0

Mise à niveau Ambari

Ambari peut être mis à niveau indépendamment de la distribution ODP.

1. Avant de commencer​

  • Passez en revue les notes de version Ambari correspondant à vos versions ODP et Ambari afin d'identifier les changements majeurs.
  • Assurez-vous de disposer des privilèges administrateur sur l'hôte Ambari Server et sur chaque hôte Ambari Agent.
  • Sauvegardez la base Ambari Server (pg_dump, mysqldump, etc.) et copiez /etc/ambari-server/conf/ambari.properties dans un emplacement sûr.
remarque

Si /var/lib/ambari-server/ambari-env.sh a été personnalisé (taille de heap, options JVM, etc.), restaurez ces modifications après la mise à niveau. L'installateur écrase le fichier mais conserve une copie .rpmsave.

2. Arrêter les services Ambari​

  1. Placez Ambari Metrics et Ambari Infra en mode Maintenance, puis arrêtez les deux services.
  2. Arrêtez Ambari Server sur l'hôte Ambari Server : 
    systemctl stop ambari-server
    Si systemd n'est pas utilisé : 
    ambari-server stop
  3. Arrêtez Ambari Agent sur chaque hôte Agent : 
    systemctl stop ambari-agent
    ou 
    ambari-agent stop
remarque

Exécuter l'Agent sous systemd peut arrêter les processus fils lors des redémarrages. Envisagez les scripts non-systemd si ce comportement pose problème.

3. Actualiser les dépôts Clemlab​

Téléchargez le de dépôt contenant la mise à jour depuis le catalogue des dépôts correspondant à votre système, puis placez-le dans le répertoire du gestionnaire de paquets.

4. Installer JDK 17 sur chaque hôte​

attention

Ambari Server 2.8.1.0 requiert JDK 17. Installez-le sur tous les hôtes avant toute mise à niveau d'un paquet Ambari. Vous pouvez conserver JDK 8 en parallèle.

Ubuntu 22/24

apt install -y openjdk-17-jdk

CentOS / RHEL / Rocky / AlmaLinux 7/8/9

dnf install -y java-17-openjdk java-17-openjdk-devel
info

Une migration complète vers JDK 17 pour toute la pile ODP n'est supportée qu'à partir d'ODP 1.3+. En attendant, procédez ainsi : installer JDK 17, mettre à niveau Ambari Server, pointer Ambari vers JDK 17, redémarrer Ambari, mettre ODP ≥ 1.3 à jour, puis basculer l'exécution de la pile sur JDK 17.

5. Mettre à niveau les paquets Ambari​

5.1 Ambari Server​

Ubuntu 22/24

apt update -y
apt-get install --only-upgrade ambari-server

CentOS / RHEL / Rocky / AlmaLinux 7/8/9

yum upgrade -y ambari-server
danger

Ne démarrez pas Ambari Server maintenant. Reconfigurez-le d'abord avec la configuration double JDK décrite en section 6 avant toute manipulation des métadonnées. Depuis Ambari 2.8.1.0, vous pouvez distinguer le JDK de la pile et celui d'Ambari (voir le changement amont). Un runtime JDK 17 complet exige ODP ≥ 1.3.

5.2 Ambari Agent​

Exécutez ces commandes sur chaque hôte Agent.

Ubuntu 22/24

apt update -y
apt upgrade ambari-agent

CentOS / RHEL / Rocky / AlmaLinux 7/8/9

yum upgrade -y ambari-agent

5.3 Ambari Infra​

Ubuntu 22/24

apt update -y
apt upgrade ambari-infra-solr ambari-infra-solr-client

CentOS / RHEL / Rocky / AlmaLinux 7/8

yum upgrade -y ambari-infra-solr ambari-infra-solr-client

5.4 Ambari Metrics​

Ubuntu 22/24

apt update -y
apt upgrade ambari-metrics

CentOS / RHEL / Rocky / AlmaLinux 7/8

yum upgrade -y ambari-metrics

6. Pointez Ambari Server vers JDK 17​

Recueillez les informations de base de données ainsi que les chemins Java avant d'exécuter la commande de configuration. Exemple :

  • Base de données : Postgres sur admin01.dev01.hadoop.clemlab.com:5432
  • Nom : ambari_db, utilisateur ambari, mot de passe ambari123%X
  • JAVA_HOME JDK 8 : /usr/lib/jvm/java-1.8.0-openjdk-amd64
  • JAVA_HOME JDK 17 : /usr/lib/jvm/java-17-openjdk-amd64/
ambari-server setup --silent \
  --java-home=/usr/lib/jvm/java-1.8.0-openjdk-amd64 \
  --ambari-java-home=/usr/lib/jvm/java-17-openjdk-amd64/ \
  --database=postgres \
  --databasehost=admin01.dev01.hadoop.clemlab.com \
  --databaseport=5432 \
  --databasename=ambari_db \
  --databaseusername=ambari \
  --databasepassword='******'

7. Mettre à niveau les métadonnées Ambari Server​

ambari-server upgrade
Upgrading ambari-server
INFO: Upgrade Ambari Server
INFO: Updating Ambari Server properties in ambari.properties ...
INFO: Updating Ambari Server properties in ambari-env.sh ...
INFO: Original file ambari-env.sh kept
WARNING: Original file krb5JAASLogin.conf kept
INFO: File krb5JAASLogin.conf updated.
INFO: Fixing database objects owner
Ambari Server configured for Postgres. Confirm you have made a backup of the Ambari Server database [y/n] (n)?

Après avoir confirmé la sauvegarde (yes), vous devriez voir :

INFO: Upgrading database schema
INFO: Return code from schema upgrade command, retcode = 0
INFO: Console output from schema upgrade command:
INFO: {}
INFO: Schema upgrade completed
Adjusting ambari-server permissions and ownership...
Ambari repo file doesn't contain latest json url, skipping repoinfos modification
Ambari Server 'upgrade' completed successfully.

Lorsque la ligne Ambari Server 'upgrade' completed successfully. apparaît, les métadonnées sont prêtes.

8. Redémarrer les services après la mise à niveau​

Ambari Server​

info

Ne redémarrez Ambari Server qu'après avoir finalisé la configuration JDK et la mise à niveau des métadonnées.

Si vous devez relancer la configuration silencieuse avec vos paramètres spécifiques, faites-le maintenant, puis démarrez le service :

systemctl start ambari-server

ou

ambari-server start

Ambari Agent​

ambari-agent start

Connectez-vous à l'interface Ambari (par exemple http://ambari.clemlab.com:8080 ou https://ambari.clemlab.com:8442) et redémarrez Ambari Infra ainsi que Ambari Metrics.

9. Mettre à jour l'alternative Java (si nécessaire)​

Certaines distributions basculent automatiquement l'alternative java par défaut vers JDK 17. Les versions ODP antérieures à 1.3 exigent encore JDK 8 en runtime principal ; rétablissez-le si besoin :

sudo update-alternatives --set java /usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java