Skip to main content
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Maintenir le système d'exploitation hôte pour ONTAP Mediator

Contributeurs netapp-camdenc netapp-aoife
PDF

Assurez-vous que le système d’exploitation hôte de ONTAP Mediator bénéficie d’une maintenance régulière afin d’obtenir des performances optimales.

Redémarrez l'hôte

Redémarrez l'hôte uniquement lorsque les clusters sont opérationnels. Les clusters ne peuvent pas réagir aux pannes lorsque ONTAP Mediator est hors ligne. Planifiez une maintenance avant de redémarrer.

ONTAP Mediator reprend automatiquement son activité lors d'un redémarrage et rétablit les relations précédemment configurées avec les clusters ONTAP.

Mises à jour du package hôte

Mettez à jour toute bibliothèque ou tout paquet yum, à l'exception du noyau. Redémarrez l'hôte si nécessaire pour que les modifications prennent effet. Planifiez une fenêtre de maintenance avant de redémarrer l'hôte.

Si vous installez le yum-utils paquet, utilisez la needs-restarting commande pour détecter si des modifications apportées au paquet nécessitent un redémarrage.

Redémarrez après la mise à jour des dépendances d'ONTAP Mediator, car les modifications ne prennent pas effet immédiatement.

Mettre à niveau le noyau du système d'exploitation hôte

SCST doit être compilé pour le noyau que vous utilisez. Pour mettre à jour le système d’exploitation, vous devez planifier du temps pour la maintenance.

Avant de commencer

Les exigences suivantes s'appliquent lorsque le package SCST est installé avec ONTAP Mediator.

  • Vous pouvez mettre à jour tous les paquets de bibliothèque, à l'exception du noyau, mais un redémarrage peut être nécessaire pour appliquer les modifications dans ONTAP Mediator. Prévoyez une interruption si vous devez redémarrer.

  • Il est recommandé de maintenir le noyau du système d'exploitation à jour. Mettez à niveau le noyau vers une version prise en charge répertoriée dans "Matrice des versions d’ONTAP Mediator". Un redémarrage du système est nécessaire ; prévoyez donc une interruption de service pour la maintenance.

    • Désinstallez le module du noyau SCST avant de redémarrer, puis réinstallez-le après le redémarrage.

    • Préparez une version compatible de SCST à réinstaller avant de commencer la mise à niveau du noyau du système d'exploitation.

Remarque Si vous avez installé ONTAP Mediator 1.12 ou une version ultérieure prenant uniquement en charge HTTPS, le paquet SCST n'est pas installé et le noyau du système d'exploitation hôte peut être mis à niveau sans incidence sur ONTAP Mediator. Consultez la documentation de votre système d'exploitation hôte pour obtenir les instructions de mise à niveau.
Étapes

Suivez ces étapes pour mettre à niveau le noyau du système d'exploitation hôte.

Remarque Avant de mettre à niveau le noyau, vérifiez que le système d’exploitation et la version d’ONTAP Mediator sont compatibles. Pour connaître les versions prises en charge, consultez le "Matrice de prise en charge des systèmes d'exploitation".

  1. Arrêtez ONTAP Mediator.

  2. Désinstallez le package SCST, voir Effectuer la maintenance de l'hôte. (SCST ne propose pas de mécanisme de mise à niveau.)

  3. Mettez à jour le système d'exploitation, puis redémarrez.

  4. Réinstallez le package SCST.

  5. Réactivez ONTAP Mediator.

Effectuer la maintenance de l'hôte

La mise à jour du noyau de la machine virtuelle peut entraîner des problèmes de compatibilité avec les modules SCST. Désinstallez puis réinstallez SCST manuellement.

Remarque Si vous avez installé ONTAP Mediator 1.12 ou une version ultérieure prenant uniquement en charge HTTPS, le package SCST n'est pas installé et vous pouvez ignorer cette tâche.

Étape 1 : Désinstaller SCST

Pour désinstaller SCST, utilisez l’archive tar correspondant à votre version d’ONTAP Mediator.

Étapes

  1. Téléchargez le paquet SCST approprié (comme indiqué dans le tableau suivant) et extrayez-le.

    Pour cette version …​

    Utilisez ce bundle tar…​

    ONTAP Mediator 1.12.1

    scst-3.10.tar.gz

    ONTAP Mediator 1.12

    scst-3.10.tar.gz

    ONTAP Mediator 1.11

    scst-3.9.tar.gz

    ONTAP Mediator 1.10

    scst-3.9.tar.gz

    ONTAP Mediator 1.9.1

    scst-3.8.0.tar.bz2

    ONTAP Mediator 1.9

    scst-3.8.0.tar.bz2

    ONTAP Mediator 1.8

    scst-3.8.0.tar.bz2

    ONTAP Mediator 1.7

    scst-3.7.0.tar.bz2

    ONTAP Mediator 1.6

    scst-3.7.0.tar.bz2

    ONTAP Mediator 1.5

    scst-3.6.0.tar.bz2

    ONTAP Mediator 1.4

    scst-3.6.0.tar.bz2

    ONTAP Mediator 1.3

    scst-3.5.0.tar.bz2

    ONTAP Mediator 1.1

    scst-3.4.0.tar.bz2

    ONTAP Mediator 1.0

    scst-3.3.0.tar.bz2

    1. Accédez au package open source depuis le "Téléchargements SCST sur sourceforge".

    2. Sélectionnez Télécharger les versions publiées.

    3. Extrayez l’archive sur votre VM.

  2. Exécutez les commandes de désinstallation suivantes dans le scst répertoire :

    1. systemctl stop mediator-scst

    2. make scstadm_uninstall

    3. make iscsi_uninstall

    4. make usr_uninstall

    5. make scst_uninstall

    6. depmod

Étape 2 : Installer SCST

Pour installer manuellement SCST, vous avez besoin du paquet tar SCST utilisé pour la version installée d'ONTAP Mediator (voir le Table SCST).

À propos de cette tâche

  • Effectuez cette étape avant d’installer ONTAP Mediator. Si la version de SCST que vous utilisez est plus récente que la version fournie avec le programme d’installation de ONTAP Mediator, celui-ci ignore cette étape.

  • Dans certains scénarios, l'installation par défaut de SCST sur le système d'exploitation mis à niveau peut échouer car le système d'exploitation mis à niveau nécessite un correctif.

    À partir d'ONTAP Mediator 1.12.1, si l'installation échoue, vous pouvez utiliser l'outil de réparation SCST situé dans /usr/local/bin/mediator_repair_scst pour réparer l'installation.

    Si le système d'exploitation mis à niveau nécessite un correctif, l'outil le contient pour la version de SCST fournie avec le package ONTAP Mediator. L' mediator_repair_scst`outil est un outil autonome distinct du programme d'installation principal et est inclus dans le fichier ONTAP Mediator `tgz. Il n'affecte pas l'installation ni les chemins de mise à niveau d'ONTAP Mediator.

Étapes

  1. Exécutez les commandes d'installation suivantes dans le scst répertoire:

    1. make 2release

    2. make scst_install

    3. make usr_install

    4. make iscsi_install

    5. make scstadm_install

    6. depmod

      Remarque

      Si vous effectuez une première installation et souhaitez préinstaller ONTAP Mediator, exécutez la commande suivante avant de passer à l'étape suivante :

      mkdir -p /opt/netapp/lib/ontap_mediator/ontap_mediator/SCST_mod_keys

    7. cp scst/src/certs/scst_module_key.der /opt/netapp/lib/ontap_mediator/ontap_mediator/SCST_mod_keys/

    8. patch /etc/init.d/scst < /opt/netapp/lib/ontap_mediator/systemd/scst.patch

      Remarque Si vous préinstallez SCST avant ONTAP Mediator lors d'une première installation, ignorez cette étape. Le programme d'installation applique les correctifs SCST nécessaires.

  2. Si vous le souhaitez, si le démarrage sécurisé est activé, avant de redémarrer, effectuez les étapes suivantes :

    1. Déterminez le nom de chaque fichier pour les modules scst_vdisk, scst et iscsi_scst :

      [root@localhost ~]# modinfo -n scst_vdisk
[root@localhost ~]# modinfo -n scst
[root@localhost ~]# modinfo -n iscsi_scst

    2. Déterminez la version du noyau :

      [root@localhost ~]# uname -r

    3. Signez chaque fichier de module avec le noyau:

      [root@localhost ~]# /usr/src/kernels/<KERNEL-RELEASE>/scripts/sign-file \sha256 \
/opt/netapp/lib/ontap_mediator/ontap_mediator/SCST_mod_keys/scst_module_key.priv \
/opt/netapp/lib/ontap_mediator/ontap_mediator/SCST_mod_keys/scst_module_key.der \
_module-filename_

    4. Installez la clé UEFI avec le micrologiciel.

      Les instructions pour installer la clé UEFI se trouvent à l'adresse suivante :

      /opt/netapp/lib/ontap_mediator/ontap_mediator/SCST_mod_keys/README.module-signing

      La clé UEFI générée se trouve à l'emplacement suivant :

    /opt/netapp/lib/ontap_mediator/ontap_mediator/SCST_mod_keys/scst_module_key.der

  3. Redémarrez le système :

    reboot

Modifications du nom d'hôte ou de l'adresse IP de l'hôte

À propos de cette tâche

  • Effectuez cette tâche sur l'hôte Linux sur lequel vous avez installé ONTAP Mediator.

  • Ne faites cela que si les certificats auto-signés ne sont plus valides parce que le nom d'hôte ou l'adresse IP changent après l'installation de ONTAP Mediator.

  • Une fois le certificat temporaire auto-signé remplacé par un certificat tiers de confiance, vous ne devez pas utiliser cette tâche pour régénérer un certificat. Si vous ne possédez pas de certificat auto-signé, vous ne pouvez pas utiliser cette procédure.

Étape

Créez un certificat auto-signé temporaire pour l'hôte actuel :

  1. Redémarrer ONTAP Mediator :

    ./make_self_signed_certs.sh overwrite

    [root@xyz000123456 ~]# cd /opt/netapp/lib/ontap_mediator/ontap_mediator/server_config
[root@xyz000123456 server_config]# ./make_self_signed_certs.sh overwrite

Adding Subject Alternative Names to the self-signed server certificate
#
# OpenSSL example configuration file.
Generating self-signed certificates
Generating RSA private key, 4096 bit long modulus (2 primes)
..................................................................................................................................................................++++
........................................................++++
e is 65537 (0x010001)
Generating a RSA private key
................................................++++
.............................................................................................................................................++++
writing new private key to 'ontap_mediator_server.key'
-----
Signature ok
subject=C = US, ST = California, L = San Jose, O = "NetApp, Inc.", OU = ONTAP Core Software, CN = ONTAP Mediator, emailAddress = support@netapp.com
Getting CA Private Key

[root@xyz000123456 server_config]# systemctl restart ontap_mediator