commande nimadm
Objectif
- Créer une copie du groupe de volumes racine (rootvg) sur un (ou plusieurs) disque(s) libre(s) et le migrer simultanément vers une nouvelle version ou un nouveau niveau de version d'AIX.
- A l'aide d'une copie de rootvg, créez une nouvelle ressource NIM mksysb qui est migrée vers une nouvelle version ou niveau d'édition d' AIX.
- A l'aide d'une ressource NIM mksysb, créez une nouvelle ressource NIM mksysb migrée vers une nouvelle version ou niveau d'édition d' AIX.
- A l'aide d'une ressource NIM mksysb, effectuez une restauration sur un ou plusieurs disques libres et migrez simultanément vers une nouvelle version ou un nouveau niveau d'édition d' AIX.
À partir du niveau technologique AIX®7.3 (TL) 3, la nimadm commande prend également en AIX charge les mises à jour TL ou AIX Service Pack (SP).
Syntaxe
- Effectuer la migration du disque secondaire
nimadm -l lpp_source -c NIMClient -s SPOT -d TargetDisks [ -a PreMigrationScript ] [ -b installp_bundle] [ -z PostMigrationScript] [ -e exclude_files] [ -i image_data ] [ -j VGname ] [ -m NFSMountOptions ] [ -o bosinst_data] [-P Phase] [ -j VGname ] [-Y ] [ -U ] [ -F ] [ -A ] [ -D ] [ -E ] [ -V ] [{ -B | -r }]- Nettoyage de la migration des disques secondaires sur le client
nimadm -C -c NIMClient -s SPOT [ -F ] [ -D ] [ -E ]- Groupe de volumes réveillé
nimadm -W -c NIMClient -s SPOT -d TargetDisks [-m NFSMountOptions ] [-z PostMigrationScript ] [ -F ] [ -D ] [ -E ]- Groupe de volumes de mise en veille
nimadm -S -c NIMClient -s SPOT [ -F ] [ -D ] [ -E ]- Synchronisation du logiciel de migration disque secondaire
nimadm -M -s SPOT -l lpp_source [ -d device ] [ -P ] [ -F ]- Migration de mksysb vers le client
nimadm -T NIMmksysb -c NIMClient -s SPOT -l lpp_source -d TargetDisks -j VGname -Y [ -U ] [ -a PreMigrationScript ] [ -b installpBundle ] [ -z PostMigrationScript ] [ -i ImageData ] [ -m NFSMountOptions ] [ -o bosinst_data ] [ -P Phase ] [ -F ] [ -A ] [ -D ] [ -E ] [ -V ] [ -B | -r ]- Migration de mksysb vers mksysb
nimadm -T NIMmksysb -O mksysbfile -s SPOT -l lpp_source -j VGname -Y [ -U ] [ -N NIMmksysb ] [ -a PreMigrationScript ] [ -b installp_bundle ] [ -z PostMigrationScript ] [ -i image_data ] [ -m NFSMountOptions ] [ -o bosinst_data ] [ -P Phase ] [ -F ] [ -A ] [ -D ] [ -E ] [ -V ]- Migration du client vers mksysb
nimadm -c nim_client -O mksysbfile -s SPOT -l lpp_source -j VGname -Y [ -U ] [ -N NIMmksysb ] [ -a PreMigrationScript ] [ -b installp_bundle ] [ -z PostMigrationScript ] [ -i image_data ] [ -m NFSMountOptions ] [ -o bosinst_data ] [ -P Phase ] [ -e exclude_files] [ -F ] [ -A ] [ -D ] [ -E ] [ -V ]- Effectuer une migration de disque alternée multi-clients (en parallèle)
- Avec un fichier JSON contenant les données du client
nimadm -n -f Client_json_file -Y [ -l lpp_source ] [ -s SPOT ] [ -U ] [ -a PreMigrationScript ] [ -b installp_bundle ] [ -z PostMigrationScript ] [ -e exclude_files ] [ -i image_data ] [ -m NFSMountOptions ] [ -o bosinst_data ] [ -P Phase ] [ -j VGname ] [ -F ] [ -A ] [ -D ] [ -E ] [{ -B | -r }]- Option interactive
nimadm -n -Y [ -l lpp_source ] [ -s SPOT ] [ -U ] [ -a PreMigrationScript ] [ -b installp_bundle ] [ -z PostMigrationScript ] [ -e exclude_files ] [ -i image_data ] [ -m NFSMountOptions ] [ -o bosinst_data ] [ -P Phase ] [ -j VGname ] [ -F ] [ -A ] [ -D ] [ -E ] [ -V ] [{ -B | -r }]
Note : Pour consulter la liste des attributs obligatoires et facultatifs pour la migration parallèle, voir Attributs obligatoires et facultatifs pour la migration parallèle.- Migration multi-clients mksysb vers un client (parallèle)
- Avec un fichier JSON contenant les données du client
nimadm -n -f Client_json_file -Y [ -T NIMmksysb ] [ -l lpp_source ] [ -s SPOT ] [ -j VGname ] [ -U ] [ -a PreMigrationScript ] [ -b installp_bundle ] [ -z PostMigrationScript ] [ -i image_data ] [ -m NFSMountOptions ] [ -o bosinst_data ] [ -P Phase ] [ -F ] [ -A ] [ -D ] [ -E ] [ -V ] [{ -B | -r }]- Option interactive
nimadm -n -Y [ -T NIMmksysb ] [ -l lpp_source ] [ -s SPOT ] [ -j VGname ] [ -U ] [ -a PreMigrationScript ] [ -b installp_bundle ] [ -z PostMigrationScript ] [ -i image_data ] [ -m NFSMountOptions ] [ -o bosinst_data ] [ -P Phase ] [ -F ] [ -A ] [ -D ] [ -E ] [ -V ] [{ -B | -r }]
Note : Pour consulter la liste des attributs obligatoires et facultatifs pour la migration parallèle, voir Attributs obligatoires et facultatifs pour la migration parallèle.
x un certain nombre de processeurs CPU sont dédiés au maître NIM, alors 3 x x les clients peuvent être migrés en parallèle. Par exemple, avec un processeur CPU dédié au maître NIM, trois LPAR clients peuvent être utilisées simultanément avec une utilisation maximale de 95 % du CPU afin d'atteindre une efficacité maximale lors d'une nimadm opération multi-clients.Descriptif
La commande nimadm est un utilitaire qui permet à l'administrateur système de créer une copie de rootvg sur un ou plusieurs disques libres et de la migrer simultanément vers une nouvelle version ou un nouveau niveau d'édition d' AIX. La commande nimadm utilise les ressources NIM pour exécuter cette fonction.
- Temps d'indisponibilité réduit. La migration est effectuée alors que le système est opérationnel. Il n'est pas nécessaire de démarrer à partir du support d'installation et la plupart des opérations se produisent sur le maître NIM.
- La commande nimadm facilite la reprise rapide en cas d'échec de la migration. Comme la commande nimadm utilise alt_disk_install pour créer une copie de rootvg, toutes les modifications sont apportées à la copie (
altinst_rootvg). En cas d'échec grave de l'installation de la migration, la migration ayant échoué est nettoyée et l'administrateur n'a pas besoin d'effectuer d'action supplémentaire. En cas de problème avec le nouveau niveau (migré) d' AIX, le système peut être rapidement renvoyé au système d'exploitation de pré-migration en effectuant un amorçage à partir du disque d'origine. - La commande nimadm permet un haut degré de flexibilité et de personnalisation dans le processus de migration à l'aide de ressources de personnalisation NIM facultatives. Les ressources de personnalisation NIM sont
image_data,bosinst_data,exclude_files,pre-migration,installp_bundleetpost-migration.
Ce document fournit des informations sur la commande nimadm . Pour une couverture complète de alt_disk_install, de NIM, de la migration et d'autres problèmes d'installation connexes, voir Installation d' AIX.
- Mise en cache du disque local nimadm
La mise en cache du disque local permet au maître NIM d'éviter d'avoir à écrire NFS sur le client, ce qui peut être utile si l'opération nimadm ne s'exécute pas de manière optimale en raison d'un col de bouteille d'écriture NFS . Si cette fonction est appelée avec l'indicateur -j VGname , la commande nimadm crée des systèmes de fichiers sur le groupe de volumes indiqué (sur le maître NIM). De plus, la commande nimadm utilise des flux pour mettre en cache toutes les données du client vers ces systèmes de fichiers.
Les avantages et les inconvénients de la fonction de mise en cache du disque local nimadm sont les suivants:- Avantages
- Amélioration des performances pour les opérations nimadm qui se trouvent sur des réseaux relativement lents.
- Amélioration des performances des opérations nimadm qui constituent un goulot d'étranglement dans les écritures NFS (NFS ).
- Diminution de l'utilisation de l'unité centrale sur le client.
- Les systèmes de fichiers client ne sont pas exportés.
- Inconvénients
- Les systèmes de fichiers cache occupent de l'espace sur le maître NIM (vous devez disposer de suffisamment d'espace pour héberger les systèmes de fichiers rootvg du client et l'espace de migration pour chaque client)
- Augmentation de l'utilisation de l'unité centrale sur le maître.
- Augmentation des E-S sur le maître (pour des performances optimales, utilisez un groupe de volumes (disque) qui ne contient pas de ressource NIM utilisée dans l'opération).
- Comment exécuter la mise en cache du disque
- Vérifiez que vous êtes au dernier niveau de bos.alt_disk_install.rte sur le maître NIM.
- Ajoutez l'indicateur -j VGName à toutes les opérations nimadm . Par exemple,
nimadm -j rootvgounimadm -j cachevg.
Vous pouvez exclure des systèmes de fichiers spécifiques (qui ne sont pas impliqués dans la migration) de la mise en cache sur le réseau (ils sont toujours copiés localement dansaltinst_rootvgsur le client). Pour spécifier une liste de systèmes de fichiers à exclure de la mise en cache du réseau, vous devez créer un fichier à l'emplacement de la ressource SPOT utilisée pour la migration. Pour obtenir l'emplacement exact du chemin SPOT, entrez la commande suivante:# lsnim -a location SpotName
Le nom du fichier doit être au format suivant:Nim_Client.nimadm_cache.exclRemarque: ce fichier s'applique au client NIM indiqué dans Nim_Client. Le chemin d'accès complet doit être au format suivant:
Par exemple, /nim_resources/520spot/usr/myclient.nimadm_cache.excl.Spot_Location/Nim_Client.nimadm_cache.exclPour exclure un système de fichiers de la mise en cache, entrez un système de fichiers (à exclure) par ligne dans ce fichier. Pour exclure un système de fichiers, vous devez vous assurer des points suivants:- N'excluez pas les systèmes de fichiers impliqués dans le processus de migration. En d'autres termes, ces systèmes de fichiers contiennent des fichiers logiciels qui sont migrés. L'exclusion de ces fichiers peut entraîner des résultats imprévisibles.
- N'excluez pas (ne peut pas) les systèmes de fichiers AIX suivants: /, /usr, /var, /opt, /homeet /tmp.
Les quatre phases suivantes sont modifiées par la commande nimadm avec la mise en cache-disque (toutes les autres phases restent les mêmes):- Phase 2-Le maître NIM crée un système de fichiers cache local dans le groupe de volumes cible indiqué (sur le maître NIM).
- Phase 3-Le maître NIM remplit les systèmes de fichiers cache avec les données du client.
- Phase 9-Le maître NIM écrit toutes les données migrées dans le groupe de volumes root de remplacement du client.
- Phase 10-Le maître NIM nettoie et supprime les systèmes de fichiers cache locaux.
- nimadm exigences
- La configuration requise pour nimadm est la suivante:
- Le maître NIM doit avoir le même niveau de bos.alt_disk_install.rte installé dans son groupe de volumes root et dans le SPOT utilisé pour effectuer la migration. (Remarque: il n'est pas nécessaire d'installer les utilitaires alt_disk_install sur le client).
- La ressource
lpp_sourceNIM sélectionnée et la ressource SPOT NIM sélectionnée doivent correspondre au niveau AIX vers lequel vous effectuez la migration. - Le maître NIM doit être au même niveau AIX ou à un niveau supérieur que celui vers lequel il est migré.
- Le client (le système à migrer) doit être au niveau AIX 4.3.3 ou supérieur.
- Le client doit disposer d'un disque (ou de disques) suffisamment grand pour cloner le groupe de volumes root et de 500 Mo supplémentaires (environ) d'espace disponible pour la migration. La quantité totale d'espace requis dépend de la configuration du système d'origine et de la personnalisation de nimadm .
- Le client cible doit être enregistré auprès du maître en tant que client NIM autonome. Pour plus d'informations, voir la commande niminit . Le maître NIM doit pouvoir exécuter des commandes à distance sur le client à l'aide du protocole
rshd. - Le maître NIM doit pouvoir exécuter des commandes à distance sur le client à l'aide du protocole
rshd. - Le maître NIM et le client doivent tous deux disposer d'un minimum de 128 mégaoctets de mémoire RAM.
- Un réseau fiable, qui peut faciliter de grandes quantités de trafic NFS , doit exister entre le maître NIM et le client. Le maître NIM et le client doivent pouvoir effectuer des montages NFS et des opérations de lecture / écriture.
- Le matériel et les logiciels du client doivent prendre en charge le niveau AIX qui est en cours de migration et qui répond à toutes les autres exigences de migration conventionnelles.
- Tous les serveurs d'applications et de base de données, tels que DB2 et LDAP, doivent être arrêtés avant d'exécuter la commande nimadm pour cloner le groupe de volumes root d'un système client. Sinon, les serveurs d'applications et les serveurs de base de données ne démarrent pas normalement une fois les opérations de la commande nimadm terminées.
Remarque: Si vous ne pouvez pas répondre aux exigences 1-10, vous devez effectuer une migration classique. Si vous ne pouvez pas répondre à l'exigence 11, la migration n'est pas possible.Attention: avant d'effectuer une migration nimadm , vous devez accepter tous les contrats de licence logicielle pour les logiciels à installer. Vous pouvez accepter tous les contrats de licence logicielle pour les logiciels à installer en spécifiant l'indicateur -Y comme argument de la commande nimadm ou en définissant la variable d'environnement ADM_ACCEPT_LICENSES sur yes. - nimadm limitations
- Les limitations suivantes s'appliquent à la commande nimadm :
- Si la base de calcul sécurisée (TCB) est activée dans le groupe de volumes root du client, vous devez la désactiver (de façon permanente), utiliser l'option de mise en cache-disque (-j) ou effectuer une migration conventionnelle. Cette limitation est due au fait que le bloc de contrôle des tâches doit accéder aux métadonnées de fichier, qui ne sont pas accessibles via le système de fichiers réseau (NFS).
- Toutes les ressources NIM utilisées par la commande nimadm doivent être locales sur le maître NIM.
- Bien qu'il n'y ait pratiquement aucune interférence avec le groupe de volumes rootvg actif du client au cours de la migration, le client peut subir une réduction mineure des performances en raison de l'augmentation des entrées-sorties de disque, de l'activité
biodet de l'utilisation de l'UC associée au clonage de la commande alt_disk_install . - Il peut être nécessaire d'optimiser le système NFS pour optimiser les performances de nimadm .
- Les noms de répertoire réservés sur le client NIM pour nimadm sont /ALT_MIG_SPOT, /ALT_MIG_EXCL, /ALT_MIG_IMAGESet /ALT_MIG_IMD. La commande nimadm échoue si ces noms sont utilisés.
- Ressources NIM utilisées par nimadm:
- ressources
SPOTressources " (-s ) - La ressource spot NIM est requise pour toutes les opérations nimadm (migration, nettoyage, réveil, veille). Tous les utilitaires nimadm et alt_disk_install utilisés par le client sont installés dans cette ressource. Il n'est pas nécessaire d'installer le logiciel nimadm sur le client. L'opération NIM cust doit être utilisée pour installer les ensembles de fichiers suivants dans l'emplacement:
- Obligatoire- bos.alt_disk_install.rte (doit correspondre au niveau du maître NIM).
- Catalogue de messages facultatif- bos.msg.$LANG.alt_disk_install.rte
- ressources
lpp_sourceressources " (-l ) - Cette ressource NIM est la source des images d'installation utilisées pour la migration du système. Il est requis pour les opérations de migration nimadm . Le
lpp_sourcedoit contenir toutes les images système du niveau vers lequel le système est migré (vérifiez l'attribut lpp_source images dans la sortie lsnim -llpp_source). Il doit également contenir les imagesinstallpfacultatives qui doivent être migrées. pre-migration- Cette ressource de script qui est exécutée sur le maître NIM, mais dans l'environnement du système de fichiers alt_inst du client qui est monté sur le maître (cette opération est effectuée à l'aide de la commande chroot ). Ce script est exécuté avant le début de la migration.
post-migration- Cette ressource de script est similaire au script
pre-migration, mais elle est exécutée une fois la migration terminée. image_data- Indique une ressource
image_dataqui est transmise à alt_disk_install (en tant qu'arguments de l'indicateur -i ). NIM alloue et monte cette ressource sur le client avant d'appeler alt_disk_install. exclude_files- Indique une ressource
exclude_filestransmise à alt_disk_install (en tant qu'argument de l'indicateur -e ). NIM alloue et monte cette ressource sur le client avant d'appeler alt_disk_install. installp_bundle- Cette ressource NIM indique les logiciels supplémentaires que la commande nimadm installe une fois la migration terminée.
bosinst_data- Cette ressource NIM indique divers paramètres d'installation pouvant être utilisés par la commande nimadm .
- ressources
- Processus de migration de nimadm
- La commande nimadm effectue la migration en 12 phases. Chaque phase peut être exécutée individuellement à l'aide de l'indicateur -P . Les phases nimadm doivent être exécutées de manière séquentielle. Les phases nimadm sont les suivantes:
- Le maître envoie une commande alt_disk_install au client qui effectue une copie du groupe de volumes rootvg sur les disques cible (cette opération est par coïncidence la phase 1 du processus alt_disk_install ). Dans cette phase,
altinst_rootvg(rootvg de remplacement) est créé. Si une cible mksysb est indiquée, mksysb est utilisé pour créer un groupe de volumes rootvg à l'aide de la mise en cache du disque local sur le maître NIM. - Le maître exécute des commandes de client distant pour exporter tous les systèmes de fichiers /alt_inst vers le maître. Les systèmes de fichiers sont exportés en tant que lecture / écriture avec accès root au document maître. Si une cible mksysb est spécifiée, les systèmes de fichiers cache sont créés en fonction des données d'image du mksysb.
- Le système NFS maître monte les systèmes de fichiers exportés en phase 2. Si une cible mksysb est spécifiée, l'archive mksysb est restaurée dans les systèmes de fichiers cache créés lors de la phase 2.
- Si la ressource de script
pre-migrationest spécifiée, le script est exécuté pendant cette période. - Les fichiers de configuration système sont sauvegardés. L'espace de migration initial est calculé et des extensions de système de fichiers appropriées sont effectuées.
bosest restauré et la base de données d'unités est fusionnée (similaire à une migration classique). Les méthodes de fusion de la migration sont exécutées et des traitements divers sont effectués. - Les ensembles de fichiers du système sont migrés à l'aide de
installp. Toutes les images RPM requises sont installées au cours de cette phase. - Si la ressource de script
post-migrationest spécifiée, le script est exécuté pendant cette période. - La commande bosboot est exécutée pour créer une image d'amorçage client écrite sur le volume logique d'amorçage du client (
hd5). - Les montages effectués sur le maître lors de la phase 3 sont supprimés.
- Les exportations client créées lors de la phase 2 sont supprimées.
- Le alt_disk_install est de nouveau appelé (phase 3 de alt_disk_install) pour effectuer les derniers ajustements et placer
altinst_rootvgen veille. La liste des unités d'amorçage est définie sur le disque cible (sauf si l'indicateur -B est utilisé). Si une sortie mksysb est indiquée, le cache est archivé dans un fichier mksysb et transformé en ressource NIM mksysb . - Le nettoyage est exécuté pour mettre fin à la migration. Le client est réamorcé, si l'indicateur -r est spécifié.
Remarque: La commande nimadm prend en charge la migration simultanée de plusieurs clients. - Le maître envoie une commande alt_disk_install au client qui effectue une copie du groupe de volumes rootvg sur les disques cible (cette opération est par coïncidence la phase 1 du processus alt_disk_install ). Dans cette phase,
- Taille du volume logique d'amorçage
La commande nimadm crée un volume logique d'amorçage avec la taille appropriée pour accueillir la nouvelle image d'amorçage. Lorsque vous migrez votre version actuelle d' AIX vers AIX 7.3, la taille du volume logique d'amorçage est de 40 Mo.
- Opération de nettoyage nimadm
Cette opération, indiquée avec l'indicateur -C , est conçue pour être nettoyée après un échec de migration qui, pour une raison quelconque, n'a pas effectué de nettoyage proprement dit. Il peut également être utilisé pour effacer une migration précédente afin d'effectuer une nouvelle migration.
- nimadm réveil et veille
Une fois la migration terminée, la commande nimadm peut être utilisée pour "réveiller" le
altinst_rootvgmigré ou le groupe de volumes root d'origine (s'il est amorcé à partir du disque migré). L'indicateur d'activation nimadm (-W ) effectue un alt_disk_install réveil, NFS exporte les systèmes de fichiers /alt_inst et les monte sur le maître NIM. La fonction de veille nimadm (-S ) permet d'annuler l'activation en démontant les montages du maître NIM, en désexportant les systèmes de fichiers /alt_inst et en exécutant la fonction de veille alt_disk_install sur le client.- Chiffrement des volumes logiques par défaut du groupe de volumes racine
- À partir d'AIX 7.3, TL 3, vous pouvez sélectionner les volumes logiques par défaut du rootvg pour le chiffrement. Pour activer cette fonction, procédez comme suit :
- Créez une ressource " bosinst_data et spécifiez "
ENCRYPTLV=yes|no|preservedans la strophe de flux de contrôle du fichier " bosinst_data.L'attribut "ENCRYPTLVa les valeurs valides suivantes :ENCRYPTLV=yes: active la fonction de cryptage de la commande 'nimadm et lit le choix de l'utilisateur dans la strophe 'lv_encryptionENCRYPTLV=preserve: Active la fonction de cryptage de la commande 'nimadm et conserve l'état de cryptage des volumes logiques par défaut du client rootvg lors de la création 'altinst_rootvg.ENCRYPTLV=no: les volumes logiques par défaut dualtinst_rootvgne sont pas cryptés.
- Exécutez la commande " nimadm avec l'argument "
-o bosinst_data_resource_name.
Chaque volume logique de la strophe "lv_encryptiondu fichier de ressources " bosinst_data peut prendre les valeurs suivantes :- yes - Chiffre le volume logique.
- no - Le volume logique n'est pas chiffré.
- preserve - Maintient l'état précédent du volume logique.
lv_encryptionde la ressource " bosinst_data, voir la rubrique bosinst_data lv_encryption stanza.Remarque : cette fonction ne prend en charge que le chiffrement des volumes logiques rootvg par défaut.Pour vérifier l'état cryptographique de "altinst_rootvg, entrez la commande suivante :hdcryptmgr showlv rootvgRemarque : pour chiffrer 10 volumes logiques, au moins 11 emplacements de chiffrement PKS (Platform keystore) doivent être disponibles. L'un des emplacements de cryptage PKS est conservé comme tampon. - Créez une ressource " bosinst_data et spécifiez "
À partir de AIX 7.3, TL 3, toutes les informations mentionnées précédemment concernant l'opération de migration à l'aide de la nimadm commande s'appliquent également à une mise à AIX jour TL ou SP. Vous pouvez utiliser le -U drapeau de la nimadm commande pour effectuer les mises à AIX jour TL ou SP.
Indicateurs
| Article | Descriptif |
|---|---|
| -a PreMigrationScript | Indique la ressource de script NIM pre-migration . |
| -A | Ajoute un horodatage au début de chaque phase de l'opération " nimadm. L'horodatage est affiché au format MM-DD-YYYY HH-MM-SS. |
| -b groupe_installp | Indique la ressource installp_bundle NIM. |
| -B | Indique que la liste des unités d'amorçage n'est pas en cours d'exécution après la migration de nimadm . Si cette option est définie, l'indicateur -r ne peut pas être utilisé. |
| -c ClientDisks | Indique le client défini NIM qui est la cible de cette opération nimadm . Cet indicateur est obligatoire pour toutes les opérations nimadm . |
| -C | Effectue un nettoyage nimadm . |
| -d TargetDisks | Indique le disque cible client utilisé pour créer altinst_rootvg (le groupe de volumes migré). |
| -D | Définit la commande nimadm en mode débogage. Cette fonction doit être utilisée uniquement pour déboguer les problèmes liés à nimadm et n'est pas définie par défaut. |
| -e fichiers_exclusion | Indique la ressource exclude_files NIM. Cette ressource est utilisée par la commande alt_disk_install lors de la phase 1. |
| -E | Entre dans le débogueur nimadm si une erreur de migration grave se produit. |
| -f Fichier_json_client | Spécifie le chemin d'accès complet du fichier JSON qui contient les données de toutes les LPAR clientes participant à la migration. Pour plus d'informations sur la création d'un fichier JSON, voir Création d'un fichier JSON avec des données de LPAR client. |
| -F | Force le déverrouillage d'un client. Normalement, la commande nimadm verrouille un client pour effectuer diverses opérations. Lorsque le client est verrouillé, d'autres opérations nimadm ou NIM ne peuvent pas être effectuées. Cet indicateur ne doit être utilisé que dans le cas inhabituel où un client est incorrectement verrouillé. Un client n'est pas correctement verrouillé si, pour une raison quelconque, la commande nimadm n'a pas pu appeler le nettoyage après un échec. |
| -i données_image | Indique la ressource image_data NIM. Cette ressource est utilisée par la commande alt_disk_install lors des phases 1 et 11. |
| -j nom_GV | Crée des systèmes de fichiers sur le groupe de volumes indiqué (sur le maître NIM) et utilise des flux pour mettre en cache toutes les données du client sur ces systèmes de fichiers. |
| -l source_lpp | Indique la ressource NIM lpp_source à utiliser pour cette opération nimadm . Cet indicateur est requis pour les opérations de migration. |
| -m NFSMountOptions | Indique les arguments transmis à la commande de montage qui monte les ressources client sur le maître. Cet indicateur peut être utilisé pour optimiser les performances NFS associées à nimadm . |
| -M | Vérifie que les niveaux du logiciel alt_disk_install (bos.alt_disk_install) sur le maître NIM, SPOT, lpp_source et l'unité en option sont synchronisés (correspondent). S'il n'y a pas de correspondance, la commande nimadm installe le niveau le plus élevé trouvé dans lpp_source ou sur l'unité facultative. |
| -n | Commute les opérations nimadm de commande en mode de migration parallèle. Pour effectuer la migration de plusieurs LPAR clientes, le -n drapeau est nécessaire. Remarque :
Pour effectuer les opérations " nimadm, les données du LPAR client doivent être fournies soit de manière interactive, soit au moyen d'un fichier JSON créé manuellement. Si l'indicateur '-n est utilisé sans l'indicateur '-f, la commande 'nimadm permet d'obtenir une session de questionnaire interactive. Vous pouvez fournir des données LPAR pour plusieurs clients en utilisant ce questionnaire pour effectuer des opérations " nimadm. Un fichier " client_data.json est créé automatiquement dans le répertoire " /var/adm/ras pendant la session du questionnaire interactif. S'il existe un fichier portant le même nom que le fichier " client_data.json dans le répertoire " /var/adm/ras, le fichier existant est sauvegardé en tant que fichier " client_data.json.prev dans le même répertoire avant que le nouveau fichier ne soit créé. Vous pouvez également fournir le chemin complet d'un fichier JSON personnalisé en utilisant l'indicateur '-f avec l'indicateur '-n Pour plus d'informations sur l'indicateur '-f, voir l'indicateur '-f |
| -N NIMmksysb | Indique la nouvelle ressource NIM mksysb unique à créer. Si l'indicateur -N est spécifié, l'indicateur -O doit être spécifié. |
| -o données_bosinst_données | Indique la ressource NIM bosinst_data . |
| -O fichier mksysb | Indique le nom du chemin d'accès au fichier de la bande mksysb migrée. Si l'indicateur -O est spécifié, l'indicateur -j et l'indicateur -c ou -T doivent être spécifiés. |
| -P Phase | Phase à exécuter lors de cet appel de la commande nimadm . S'il y a plus d'une phase, les phases doivent être séparées par des espaces ou des virgules. Les phases valides sont 1 à 12. |
| -r | Indique que le client doit redémarrer une fois la migration de nimadm terminée. |
| -s SPOT | Indique la ressource SPOT NIM à utiliser pour cette opération nimadm . Cet indicateur est obligatoire pour toutes les opérations nimadm . |
| -S | Exécute la fonction nimadm sleep . Cette fonction doit être exécutée pour mettre fin à un nimadm wake-up. |
| -T NIMmksysb | Indique une ressource NIM mksysb existante à migrer. Si l'indicateur -T est spécifié, l'indicateur -j et l'indicateur -O ou -c doivent être spécifiés. |
| -U | Effectue une mise à AIX jour TL ou SP à l'aide de la source LPP et du SPOT fournis. Remarque : Cette option est prise en charge à partir d'AIX 7.3, niveau technologique 3.
|
| -V | Active la sortie prolixe. |
| -W | Exécute la fonction nimadm wake-up . |
| -Y | Accepte les contrats de licence logicielle requis pour l'installation des logiciels. |
| -z PostMigrationScript | Indique la ressource de script NIM post-migration . |
Attributs obligatoires et facultatifs pour la migration parallèle
| Arguments | Obligatoire ou facultatif | Méthode de transmission des arguments |
|---|---|---|
-l lpp_source |
Obligatoire | Fichier JSON ou ligne de commande |
-c NIMClient |
Obligatoire | Fichier JSON |
-s SPOT |
Obligatoire | Fichier JSON ou ligne de commande |
-d TargetDisks |
Obligatoire | Fichier JSON |
-a PreMigrationScript |
Facultatif | Fichier JSON ou ligne de commande |
-b installp_bundle |
Facultatif | Fichier JSON ou ligne de commande |
-z PostMigrationScript |
Facultatif | Fichier JSON ou ligne de commande |
-e exclude_files] |
Facultatif | Fichier JSON ou ligne de commande |
-i image_data |
Facultatif | Fichier JSON ou ligne de commande |
-T NIMmksysb |
Migration des disques alternatifs : pas nécessaire |
Fichier JSON ou ligne de commande |
-j VGname |
Migration de disque alternatif : Facultatif |
Fichier JSON ou ligne de commande |
-m NFSMountOptions |
Facultatif | Fichier JSON ou ligne de commande |
-o bosinst_data |
Facultatif | Fichier JSON ou ligne de commande |
-Y |
Obligatoire | Ligne de commande |
-F |
Facultatif | Ligne de commande |
-D |
Facultatif | Ligne de commande |
-E |
Facultatif | Ligne de commande |
-V |
Facultatif | Ligne de commande |
-P |
Facultatif | Ligne de commande |
-B | -r |
Facultatif | Fichier JSON ou ligne de commande |
-U |
Facultatif | Fichier JSON ou ligne de commande |
- Pour tous les attributs pour lesquels les arguments peuvent être transmis soit en utilisant un fichier JSON client, soit en utilisant la ligne de commande, les valeurs mentionnées dans le fichier JSON client sont préférées à la ligne de commande pour un client particulaire.
- Si un attribut a des données communes pour tous les LPARs clients, vous pouvez mentionner la valeur une seule fois dans la ligne de commande au lieu de répéter la même valeur pour chaque LPAR client dans le fichier JSON ou pendant la session du questionnaire interactif.
Statut de sortie
- 0 %
- Toutes les opérations liées à la commande nimadm qui ont abouti.
- >0
- Une erreur s'est produite.
Security
- Contrôle d'accès
- Vous devez disposer des droits d'accès root pour exécuter la commande nimadm .
- Utilisateurs RBAC
- Attention aux utilisateurs du contrôle d'accès à base de rôles: Cette commande peut effectuer des opérations privilégiées. Seuls les utilisateurs privilégiés peuvent exécuter des opérations privilégiées. Pour plus d'informations sur les autorisations et les privilèges, voir Base de données des commandes privilégiées dans Sécurité. Pour obtenir la liste des privilèges et des autorisations associés à cette commande, voir la commande 'lssecattr ou la sous-commande 'getcmdattr
Création d'un fichier JSON avec les données du LPAR client
La commande 'nimadm prend en charge la migration parallèle de LPAR multi-clients. Les données de tous les LPARs clients participant à la migration doivent être fournies pour effectuer les opérations " nimadm. Lorsque vous utilisez uniquement l'indicateur " -n, vous pouvez fournir les données d'un ou de plusieurs LPAR clients en remplissant le questionnaire interactif. Lorsque l'indicateur '-n est utilisé avec l'indicateur '-f, le chemin complet du fichier JSON qui contient les données du LPAR client doit être spécifié.
{
"client_1":"<name of the nim client lpar>",
"client_1_target_disk":"<Target disk for the client lpar>",
"client_1_res_lpp_source":"<LPP-source resource name>",
"client_1_res_spot":"<Spot resource name>",
"client_1_res_target_mksysb":"<existing NIM mksysb resource to migrate>",
"client_1_vgname":"<volume group (on the NIM master) to cache all of the data from the client to these file systems>",
"client_1_res_premig_script":"<premigration script resource name>",
"client_1_res_postmig_script":"<post migration script resource name>",
"client_1_res_image_data":"<Image data resource name>",
"client_1_res_exclude_files":"<Exclude files resource name>",
"client_1_res_install_img_bundle":"<Installp bundle resource name>",
"client_1_res_bosinst_data":"<Bosinst data resource name>",
"client_1_opt_nfs_mount":"<nfs mount options>",
"client_1_opt_skip_bootlist":"<Do you want to skip running bootlist after the nimadm migration? (Enter y for yes/n for no)>",
"client_1_opt_reboot":"<Should client be rebooted after migration? (Enter y for yes/n for no)>",
"client_1_opt_update":"<Do you want to perform a TL/SP update? (Enter y for yes/n for no)>"
}
{
"client_1":"aix1",
"client_1_target_disk":"hdisk1",
"client_1_res_lpp_source":"lpp1",
"client_1_res_spot":"spot1",
"client_1_res_target_mksysb":"mksysb_72Z",
"client_1_vgname":"nimadmVg1",
"client_1_res_premig_script":"premig1",
"client_1_res_postmig_script":"postmig1",
"client_1_res_image_data":"img1",
"client_1_res_exclude_files":"excl1",
"client_1_res_install_img_bundle":"instl1",
"client_1_res_bosinst_data":"bi1",
"client_1_opt_nfs_mount":"-Vcdrfs",
"client_1_opt_skip_bootlist":"y",
"client_1_opt_update":"n",
"client_2":"aix2",
"client_2_target_disk":"hdisk2",
"client_2_res_lpp_source":"lpp2",
"client_2_res_spot":"spot2",
"client_2_res_target_mksysb":"mksysb_72X",
"client_2_vgname":"nimadmVg2",
"client_2_res_premig_script":"premig2",
"client_2_res_postmig_script":"postmig2",
"client_2_res_image_data":"img2",
"client_2_res_exclude_files":"excl2",
"client_2_res_install_img_bundle":"instl2",
"client_2_res_bosinst_data":"bi2",
"client_2_opt_nfs_mount":"-vcdrfs",
"client_2_opt_skip_bootlist":"n",
"client_2_opt_reboot":"n",
"client_2_opt_update":"y"
}
- Maintenir l'ordre des numéros de série des LPARs clients. Les différentes LPAR clientes sont indiquées en utilisant le format "
client_dans le fichier JSON, où "xxdoit commencer par "1et suivre l'ordre des numéros de série des autres LPAR clientes. Par exemple, les multiples entrées LPAR client telles que "client_1, "client_2, "client_4et "client_5dans le fichier JSON sont incorrectes car l'entrée "client_3est manquante. - Conservez les noms de champs comme '
client_, 'xclient_, 'x_target_diskclient_, où 'x_res_lpp_sourcexest l'ordre des numéros de série du LPAR client dans le fichier JSON. - Si l'un des LPARs clients ne contient pas de valeur pour l'un des champs du fichier JSON, vous pouvez soit conserver la valeur du champ vide, soit supprimer le champ du fichier JSON. Voici un exemple d'entrée de LPAR client indiquée par le "
client_3dans le fichier JSON avec uniquement le nom spécifique du client, le disque cible et le nom du groupe de volumes :"client_3": "lpar-3", "client_3_target_disk": "hdisk3", “client_3_vgname”:”nimadmVg3”Dans cet exemple, tous les autres champs de "
client_3ont les valeurs par défaut ou les valeurs de la ligne de commande. - Si l'une des valeurs de champ, comme le nom NIM '
lpp_source, le nom de la ressource spot NIM, etc., dans le fichier JSON s'applique à tous les LPAR clients mentionnés dans le fichier JSON, spécifiez la valeur une seule fois dans les arguments de la ligne de commande. Les options "
skip bootlistet "reboots'excluent mutuellement. Les champs 'client_et 'x_opt_skip_bootlistclient_dans le fichier JSON qui contient les données LPAR du client ne peuvent pas être définis comme y en même temps pour un client particulier. Toutefois, les champs "x_opt_rebootclient_et "x_opt_skip_bootlistclient_peuvent être définis comme n en même temps pour un client donné.x_opt_rebootPar exemple, si le champ "
client_1" du fichier JSON du client est défini comme " y dans le champ "client_1_opt_skip_bootlist", le champ "client_1_opt_rebootn'est pas défini ou est défini comme " n. Toutefois, si le champ "client_1_opt_skip_bootlistest défini comme n, le champ "client_1_opt_rebootpeut être défini comme y ou n.Note : Si le champ "client_est défini comme y pour un LPAR client, l'indicateur " -B est défini en interne pour le même LPAR client par la commande " nimadm. Si le champ "x_opt_skip_bootlistclient_est défini comme y pour un LPAR client, l'indicateur " -r est défini en interne pour le même LPAR client par la commande " nimadm. Les drapeaux '-B et '-r ne sont pas définis en interne pour le LPAR client si les champs 'x_opt_rebootclient_et 'x_opt_skip_bootlistclient_ont tous deux la valeur n.x_opt_rebootVoici un exemple de fichier JSON d'un client avec différents paramètres pour les champs "client_et "x_opt_skip_bootlistclient_x_opt_reboot{ "client_1":"aix1", "client_1_target_disk":"hdisk1", "client_1_opt_skip_bootlist":"y", "client_2":"aix2", "client_2_target_disk":"hdisk2", "client_2_opt_skip_bootlist":"n", "client_2_opt_reboot":"y", "client_3":"aix3", "client_3_target_disk":"hdisk3", "client_3_opt_skip_bootlist":"n", "client_3_opt_reboot":"n" }Dans cet exemple, les données relatives au "
client_3peuvent être fournies sans les champs "client_3_opt_skip_bootlistet "client_3_opt_rebootVoici les commandes que la commande " nimadm exécute en interne pour ce fichier JSON :/usr/sbin/nimadm -c aix3 -d hdisk3 -l lpp1 -s spot1 -Y -A 2>/var/adm/ras/nimadm_parallel/aix3_error.log /usr/sbin/nimadm -c aix2 -d hdisk2 -l lpp1 -s spot1 -r -Y -A 2>/var/adm/ras/nimadm_parallel/aix2_error.log /usr/sbin/nimadm -c aix1 -d hdisk1 -l lpp1 -s spot1 -B -Y -A 2>/var/adm/ras/nimadm_parallel/aix1_error.log- Le champ "
client_x_opt_updatedoit avoir la valeur y pour effectuer une mise à jour AIX TL ou SP. Si le champ "client_x_opt_updatea la valeur " y", l'indicateur " -U est défini en interne pour le même LPAR client par la commande " nimadm.
Exemples
- Pour exécuter la migration " nimadm vers le client NIM cible aix1 en utilisant la ressource NIM "
SPOTspot1, la ressource NIM "lpp_sourcelpp1 et les disques cibles hdisk1 et hdisk2, entrez la commande suivante :nimadm -c aix1 -s spot1 -l lpp1 -d "hdisk1 hdisk2" -YL'indicateur '-Y permet d'accepter tous les accords de licence de logiciel requis pour le logiciel à installer.
- Pour exécuter la même opération que dans l'exemple précédent sur hdisk2, ainsi que les scripts '
pre-migrationnimscript1 et 'post-migrationnimscript2, entrez la commande suivante :nimadm -c aix1 -s spot1 -a nimscrip1 -z nimscript2 -l lpp1 -d hdisk1 -Y - Pour exécuter le nettoyage " nimadm sur le client aix1 en utilisant la ressource NIM "
SPOTspot1, entrez la commande suivante :nimadm -C -c aix1 -s spot1 - Pour créer une nouvelle ressource mksysb migrée d'un client avec le nom de fichier nim1, entrez la commande suivante:
nimadm -c aix1 -s spot1 -l lpp1 -O /export/mksysb/mksysb1 -j vg00 -Y -N nim1 - Pour créer une ressource mksysb migrée avec le nom de fichier nim3 à partir d'une ressource mksysb NIM existante, entrez la commande suivante:
nimadm -s spot1 -l lpp1 -j vg00 -Y -T nim2 -O /export/mksysb/m2 -N nim3 - Pour migrer une ressource NIM existante et la placer sur un client, entrez la commande suivante:
nimadm -c aix1 -s spot1 -l lpp1 -d hdisk1 -j vg00 -T nim2 -YRemarque: Aucune modification n'est apportée à la ressourcenim2NIM mksysb. - Pour afficher les horodatages de la nimadm migration vers le client NIM cible
flan003à l'aide de la ressource NIMSPOTspot1, de la ressource NIMlpp_sourcelpp1et du disque ciblehdisk1, entrez la commande suivante:nimadm -j nimadm -c flan003 -s spot1 -l lpp1 -d hdisk1 -Y -AUne sortie similaire à l'exemple suivant s'affiche :Initializing the NIM master. Starting Alternate Disk Migration. +-----------------------------------------------------------------------------+ 01-12-2023 01:21:29 Executing nimadm phase 1. +-----------------------------------------------------------------------------+ Cloning altinst_rootvg on client, Phase 1. for backup and restore into the alternate file system... Phase 1 complete. +-----------------------------------------------------------------------------+ 01-12-2023 01:22:32 Executing nimadm phase 2. +-----------------------------------------------------------------------------+ Creating nimadm cache file systems on volume group nimadm. - Pour exécuter nimadm l'opération en utilisant le mode interactif pour deux clients NIM,
aix1etaix2, avec les disques cibleshdisk1ethdisk2, respectivement, la ressource NIM SPOT commespot1, la ressource NIM lpp_source commelpp1, et avec d'autres ressources différentes, entrez la commande suivante :nimadm -n -YUne session interactive similaire à la suivante démarre pour obtenir les informations nécessaires aux opérations du "nimadm:Client #1 ##############Enter client name - aix1 Enter target disk - hdisk1 No lpp_source is provided in the command line. Enter lpp_source name - lpp1 No spot is provided in the command line. Enter spot name - spot1 No "-T" argument specified in the command line. Type "mksysb" to perform mksysb to client migration. Otherwise, type "." to go ahead with normal migration mksysb Enter target mksysb resource - mksysb_72Z Enter vgname - nimadmVg1 Enter pre-migration script resource or "." to skip - premig1 Enter post-migration script resource or "." to skip - postmig1 Enter image.data resource or "." to skip - img1 Enter exclude files resource or "." to skip - excl1 Enter install image bundle resource or "." to skip - instl1 Enter bosinst_data resource or "." to skip - bi1 Enter nfs mount options or "." to skip - -Vcdrfs Do you want to skip running the bootlist after nimadm migration? (yes/no) Note - Entering "yes" will set "-B" flag in the nimadm command - yes Would you like to update using provided lpp_source and spot? (yes/no) Note - Entering "yes" will set "-U" flag in the nimadm command - no Do you want to add any more clients? Type 'y' for yes, 'n' for no y Client #2 ##############Enter client name - aix2 Enter target disk - hdisk2 No lpp_source is provided in the command line. Enter lpp_source name - lpp2 No spot is provided in the command line. Enter spot name - spot2 No "-T" argument specified in the command line. Type "mksysb" to perform mksysb to client migration. Otherwise, type "." to go ahead with normal migration mksysb Enter target mksysb resource - mksysb_72X Enter vgname - nimadmVg2 Enter pre-migration script resource or "." to skip - premig2 Enter post-migration script resource or "." to skip - postmig2 Enter image.data resource or "." to skip - img2 Enter exclude files resource or "." to skip - excl2 Enter install image bundle resource or "." to skip - instl2 Enter bosinst_data resource or "." to skip - bi2Enter nfs mount options or "." to skip - -vcdrfs Do you want to skip running the bootlist after nimadm migration? (yes/no) Note - Entering "yes" will set "-B" flag in the nimadm command - no Should the client reboot automatically after nimadm migration is complete? (yes/no) Note - Entering "yes" will set "-r" flag in the nimadm command - no Would you like to update using provided lpp_source and spot? (yes/no) Note - Entering "yes" will set "-U" flag in the nimadm command - yes Do you want to add any more clients? Type 'y' for yes, 'n' for no nStarting:/usr/sbin/nimadm -c aix2 -d hdisk2 -l lpp2 -s spot2 -T mksysb_72X -j nimadmVg2 -i img2 -o bi2 -e excl2 -b instl2 -a premig2 -z postmig2 -m -vcdrfs -Y -A 2>/var/adm/ras/nimadm_parallel/aix2_error.log Starting:/usr/sbin/nimadm -c aix1 -d hdisk1 -l lpp1 -s spot1 -T mksysb_72Z -j nimadmVg1 -i img1 -o bi1 -e excl1 -b instl1 -a premig1 -z postmig1 -m -Vcdrfs -B -Y -U -A 2>/var/adm/ras/nimadm_parallel/aix1_error.log 02-21-2024 09:40:38 : Started nimadm for aix2 02-21-2024 09:40:38 : Started nimadm for aix1 ... # cat /var/adm/ras/client_data.json { "client_1":"aix1", "client_1_target_disk":"hdisk1", "client_1_res_lpp_source":"lpp1", "client_1_res_spot":"spot1", "client_1_res_target_mksysb":"mksysb_72Z", "client_1_vgname":"nimadmVg1", "client_1_res_premig_script":"premig1", "client_1_res_postmig_script":"postmig1", "client_1_res_image_data":"img1", "client_1_res_exclude_files":"excl1", "client_1_res_install_img_bundle":"instl1", "client_1_res_bosinst_data":"bi1", "client_1_opt_nfs_mount":"-Vcdrfs", "client_1_opt_skip_bootlist":"y", "client_1_opt_update":"n", "client_2":"aix2", "client_2_target_disk":"hdisk2", "client_2_res_lpp_source":"lpp2", "client_2_res_spot":"spot2", "client_2_res_target_mksysb":"mksysb_72X", "client_2_vgname":"nimadmVg2", "client_2_res_premig_script":"premig2", "client_2_res_postmig_script":"postmig2", "client_2_res_image_data":"img2", "client_2_res_exclude_files":"excl2", "client_2_res_install_img_bundle":"instl2", "client_2_res_bosinst_data":"bi2", "client_2_opt_nfs_mount":"-vcdrfs", "client_2_opt_skip_bootlist":"n", "client_2_opt_reboot":"n", "client_2_opt_update":"y" } - Pour exécuter nimadm l'opération à l'aide d'un fichier JSON contenant les données LPAR du client, entrez la commande suivante :
nimadm -n –f /home/dev/client_data.json -l lpp1 –s spot1 -YDans cet exemple, le fichier JSON " client_data.json est placé dans le répertoire " /home/dev. Tous les LPAR clients mentionnés dans le fichier JSON utilisent la ressource NIM SPOT "
spot1et la ressource NIM lpp_source "lpp1. - Pour effectuer une mise à jour AIX TL ou SP à l'aide de la commande " nimadm afin de cibler le client NIM "
aix1en utilisant la ressource NIM SPOT "spot1", la ressource NIM lpp_source "lpp1et les disques cibles "hdisk1et "hdisk2, entrez la commande suivante :nimadm -c aix1 -s spot1 -l lpp1 -d "hdisk1 hdisk2" -Y -UNote : L'indicateur '-Y accepte tous les accords de licence requis pour le logiciel à installer. - Pour exécuter la migration " nimadm vers le client NIM cible aix1 en utilisant la ressource NIM "
SPOTspot1, la ressource NIM "lpp_sourcelpp_source1, le disque cible hdisk2, et pour utiliser le fichier de ressource "bosinst_data" nim_bosinst_resource " afin d'activer la fonction qui permet de sélectionner les volumes logiques du rootvg par défaut pour le cryptage, entrez la commande suivante :nimadm -c aix1 -s spot1 -l lpp1 -o nim_bosinst_resource -d "hdisk2" -Y
Fichiers
| Article | Descriptif |
|---|---|
| /usr/sbin/nimadm | Contient la commande nimadm . |
| /var/adm/ras/alt_mig/ClientName_alt_mig.log | Contient des informations sur la progression de l'exécution de la commande 'nimadm |
| /var/adm/ras/nimadm_parallel/ClientName_error.log | Contient les erreurs d'exécution de la commande " nimadm |