Mise à jour du logiciel

SKOOR 9.0 : Étant donné que SKOOR 9.0 passe de PostgreSQL 13 à 17, certaines étapes supplémentaires sont nécessaires, comme décrit ici.

SKOOR 8.1 : Les tâches Selenium avec Python doivent être vérifiées. Pour éviter une fuite de ressources, l'opération driver.quit() est traitée dans tous les cas, comme décrit ici

Veuillez suivre toutes les instructions du support SKOOR avant d'effectuer une mise à jour. Il peut y avoir des étapes de préparation obligatoires qui peuvent entraîner des erreurs si elles sont ignorées

En général, la mise à jour des paquets SKOOR Engine et/ou Collector déjà installés à partir du référentiel est très simple :

dnf clean all
dnf update skoor-repo
dnf dnf clean all
dnf update eranger'*'

Guide rapide

La procédure suivante peut servir de liste de contrôle pour une mise à jour standard du logiciel :

  1. Vérifiez les dépôts RPM requis et les abonnements Red Hat

  2. Vérifiez si des sauvegardes complètes et de configuration sont disponibles. Cependant, il est toujours recommandé d'effectuer une sauvegarde complète avant une mise à jour

  3. Notez l'état général du système ou prenez une capture d'écran de la barre d'état située en bas de l'interface utilisateur de SKOOR Engine

  4. Définissez la maintenance globale sur tous les collecteurs concernés par la mise à jour (les collecteurs externes peuvent rester inchangés ou être mis à jour ultérieurement)

  5. Sur les systèmes répliqués (principal/de secours) :

    1. Vérifiez l'état de la réplication et intervenez si l'état n'est pas OK

    2. Arrêtez la réplication

    3. Effectuez la mise à jour du server de secours

  6. Effectuez la mise à jour du server (principal)

  7. Démarrer la réplication si elle n'est pas en cours

  8. Mettre à jour les collecteurs externes s'ils sont configurés

  9. Mettre à jour Dashboard Viewer s'il est configuré

  10. Rechercher les nouveaux fichiers de configuration se terminant par .rpmnew et fusionner leur contenu avec les fichiers d'origine si nécessaire.
    Cela peut être effectué à l'aide de :
    rpmconf -a

  11. Vérification

    1. L'état général du système est identique à celui d'avant ou les différences peuvent être expliquées

    2. La réplication fonctionne comme auparavant

    3. Les tableaux de bord / Dashboard Viewer sont accessibles

    4. Les alertes sont envoyées (e-mail, SMS, etc.)

  12. Fin de la maintenance

  13. Créer une nouvelle sauvegarde complète

Détails du guide rapide

Les informations suivantes s'appliquent à une installation SKOOR standard. Les configurations personnalisées doivent être prises en compte

Chemin d'accès standard aux sauvegardes :

/opt/eranger/server/backups

Exécuter une sauvegarde complète :

cd /var/lib/pgsql
sudo -u postgres /opt/eranger/bin/eranger-server-backup.sh full

Définir la maintenance globale sur tous les collecteurs liés à la mise à jour dans /root/Collectors

Vérifier l'état de la réplication et arrêter le mode veille :

/opt/eranger/bin/eranger-server-replication.pl status
<standby-ip>
<standby-ip> checking ssh for user reranger
<primary-ip> is running
Last read on master(<primary-ip>) 0 seconds ago
/opt/eranger/bin/eranger-server-replication.pl stopstandby

Empreintes GPG :

RPM-GPG-KEY-SKOOR :

0C18 95B8 11D4 71E5 D043 EFA3 69E1 147C 2CB4 0F3A

RPM-GPG-KEY-PGDG :

68c9 e2b9 1a37 d136 fe74 d176 1f16 d2e1 442d f0f8

RPM-GPG-KEY-TIMESCALEDB :

1005 fb68 604c e9b8 f687 9cf7 59f1 8edf 47f2 4417

Mise à jour vers SKOOR 9.0

Veuillez vous assurer qu'il n'y a pas de liens depuis /var/lib/pgsql/13/data vers des emplacements en dehors de /var/lib/pgsql, car cela pourrait causer des problèmes lors de la mise à niveau. Assurez-vous également qu'il n'y a pas de points de montage vers d'autres périphériques à l'intérieur de /var/lib/pgsql.

  • Une version mise à jour de skoor-repo (9.0) est nécessaire.
    Installez-la à l'aide de la commande suivante :

    dnf clean all
    dnf update skoor-repo.rpm
  • Si la réplication est en place, elle doit être arrêtée avant de procéder à la mise à niveau

    /opt/eranger/bin/eranger-server-replication.pl stopstandby

Mettez d'abord à niveau le serveur de secours (sans exécuter le script update-postgresql), puis mettez à niveau le serveur principal et effectuez une mise à jour complète (createstandby).

  • La mise à jour doit être effectuée à l'aide d'une mise à jour complète, et non simplement avec dnf update “eranger-*” ou une commande similaire.

    dnf clean all
    dnf update
  • Après « dnf update », exécutez « /opt/eranger/database-utils/bin/upgrade-postgresql ».

    /opt/eranger/database-utils/bin/upgrade-postgresql

Cela met à niveau le cluster PostgreSQL 13 vers un cluster PostgreSQL 17.

  • Après /opt/eranger/database-utils/bin/upgrade-postgresql, le nouveau cluster doit être analysé à l'aide de

    su postgres -c "/usr/pgsql-17/bin/vacuumdb --all --analyze-in-stages"

Cette étape est très importante. Ne la sautez pas. Le système peut déjà être utilisé pendant son exécution.

  • Si tout fonctionne comme prévu, l'ancien cluster peut être supprimé à l'aide de

     /var/lib/pgsql/delete_old_cluster.sh

Mise à jour vers SKOOR 8.1

Les tâches Selenium doivent être adaptées lors de l'utilisation de scripts Python. Il est important que l'opération driver.quit() soit exécutée dans tous les cas. Sinon, il y aura une fuite de ressources !

Un nouveau paquet RPM, eranger-python, est fourni avec cette version, principalement pour les scripts dans SKOOR Studio. Il est recommandé d'utiliser cet environnement Python également pour les scripts d'importation hérités.

Mise à jour vers SKOOR 7.2

Chaque SKOOR Collector utilise au moins un répertoire pour stocker les fichiers de mesure temporaires. Avec SKOOR 7.2, tous les répertoires temporaires des collecteurs seront nettoyés régulièrement :

  • Les fichiers datant de plus de 72 heures sont supprimés

  • Les répertoires vides datant de plus de 24 heures sont supprimés

Étant donné que le collecteur envoie toutes les données de mesure au server après chaque exécution de tâche, il n'y a aucune raison de conserver ces fichiers plus longtemps dans le répertoire des fichiers temporaires. Cependant, si des fichiers tels que des scripts ou d'autres données persistantes ont été créés dans l'un de ces répertoires, ils doivent être déplacés vers un autre emplacement avant la mise à niveau vers la version 7.2.

Utilisez la commande suivante pour obtenir la liste des répertoires temporaires des collecteurs (à exécuter sur le collecteur local ainsi que sur tous les collecteurs externes) :

grep -oP "server\\d+_fetch_parse_dir\\s*=\\s*/var/opt/run/eranger/collector/.+" /etc/opt/eranger/eranger-collector.cfg | perl -pe 's/server\d+_fetch_parse_dir\s*=\s*//g'

Veuillez vous assurer que tous les fichiers présents dans ces répertoires peuvent être supprimés en toute sécurité.

Mise à jour vers SKOOR 7.0

Le paquet RPM sdaas-webservice a été remplacé par le nouveau paquet eranger-etl, également disponible dans le référentiel RPM de SKOOR.

Veuillez installer eranger-etl après la mise à niveau vers la version 7.0 (la suppression de sdaas-webservice doit être autorisée pour éviter tout conflit) :

yum remove sdaas-webservice && yum install eranger-etl