Commande clctrl
Objectif
Fournit un ensemble de fonctions d'administration système pour la gestion d'un cluster.
Syntaxe
Options clctrl <sous-commande>
où <sous-commande> sont {-début | -arrêt | -optimiser | -sec | -valider}
Syntaxe de la sous-commande
Pour mettre un noeud hors ligne à des fins de maintenance ou le remettre en ligne:
clctrl [-n nom_cluster]{-début | -arrêt} [-n nom_cluster]{ -m noeud [, ... ] | -a}
Pour afficher ou définir des valeurs d'attribut optimisable de cluster:
clctrl -tune -h [accordable]
clctrl -tune [-n nom | -u uuid] ( -a | {-L | -x} [accordable] | {-o accordable})
clctrl -optimiser [-n nom | -u identificateur unique universel] (-D | {-d accordable} | {-o accordable= value }))
Pour afficher ou définir des valeurs réglables de sécurité:
clctrl -s { -l niveau_sécurité -s sec_alg } [-e] [ -t type_certificat [-c fichier_certificat -f fichier_clé_privée ]]
Pour valider manuellement un nouveau niveau de cluster qui est effectif dans l'ensemble du cluster:
clctrl [-n nom_cluster] -commit
Descriptif
La commande clctrl fournit un ensemble de sous-commandes pour la gestion d'un cluster.
La sous-commande -stop est utilisée pour placer un ou plusieurs noeuds hors ligne à des fins de maintenance. Lorsqu'un noeud est arrêté, les autres noeuds sont considérés comme étant arrêtés. Un noeud arrêté n'envoie ni ne reçoit de messages de signal de présence et reste à l'état arrêté, même lors d'une opération de réamorçage, jusqu'à ce qu'une sous-commande -start le force à rejoindre le cluster. La sous-commande -stop peut également être émise alors qu'un noeud est arrêté pour l'empêcher de rejoindre le cluster lors de l'initialisation.
La sous-commande -start est utilisée pour replacer un ou plusieurs noeuds en ligne après qu'ils aient été placés hors ligne pour maintenance. Le démarrage d'un noeud lui permet de rejoindre le cluster et de considérer les autres noeuds comme étant en ligne. La sous-commande -start peut également être émise alors qu'un noeud est arrêté pour lui permettre de rejoindre le cluster lors de l'initialisation.
La sous-commande -tune permet d'afficher ou de définir des valeurs optimisables de cluster. Les indicateurs suivants contrôlent la sous-commande -tune :
| Article | Descriptif |
|---|---|
| -a | Affiche les valeurs de tous les paramètres optimisables, un par ligne. |
| -d | Réinitialise tous les paramètres réglables à leurs valeurs par défaut. |
| -d optimisable | Réinitialise le paramètre réglable à sa valeur par défaut. |
| -h | Affiche l'aide sur la commande et ses arguments. |
| -h réglable | Affiche l'aide relative à un paramètre réglable. |
| -L optimisable | Répertorie les informations sur un ou tous les paramètres optimisés dans un format de tableau. |
| -n nom | Indique le nom du cluster ou de l'entité de noeud à laquelle appartient le paramètre réglable. Ce nom doit être unique. Sinon, l'indicateur -u uuid doit être utilisé pour identifier l'entité. |
| -o optimisable | Affiche la valeur en cours d'un paramètre réglable. |
| -o tunable= valeur | Définit le paramètre réglable sur la valeur. |
| -u uuid | Indique l'identificateur unique universel du cluster ou de l'entité de noeud. Si ni l'option -u ni l'option -n ne sont spécifiées, le noeud appelant est supposé. |
| -x optimisables | Répertorie les informations sur un ou tous les paramètres réglables dans un format séparé par des virgules |
| Article | Descriptif |
|---|---|
| -c | Indique le chemin d'accès au fichier de certificat pour la clé asymétrique. |
| -e | Affiche les valeurs de tous les paramètres de sécurité, un par ligne. |
| -f | Indique le chemin d'accès au fichier de clé privée pour la clé asymétrique. |
| -l | Définit le niveau de sécurité. La valeur 0 désactive la sécurité ; la valeur 1-3 active la sécurité et définit le niveau sur la valeur. Le niveau de sécurité par défaut est 2. |
| -S | Indique le type d'algorithme utilisé pour générer la clé symétrique. La valeur peut être AES, DES ou 3DES. La définition d'une valeur NULL désactive la sécurité si elle est activée. La valeur par défaut est AES. |
| -t | Indique le type de certificat pour la clé asymétrique. La valeur peut être définie sur Certificats auto-signés, Open SSL Certificatesou SSH Certificates. La valeur par défaut est Certificats autosignés. |
La sous-commande -commit valide manuellement un nouveau niveau de cluster qui est effectif dans l'ensemble du cluster, après la mise à niveau des niveaux de logiciel CAA sur tous les noeuds. Le logiciel CAA valide automatiquement le nouveau niveau de cluster. Toutefois, un administrateur système peut avoir besoin de valider manuellement le nouveau niveau de cluster si la validation automatique du nouveau niveau de cluster échoue.
Exemples
- Pour mettre hors ligne un noeud nommé fileserver1 à des fins de maintenance:
clctrl -stop -n clustername -m fileserver1 - Pour remettre le noeud en ligne une fois la maintenance terminée:
clctrl -start -n clustername -m fileserver1 - Pour mettre tous les noeuds hors ligne pour la maintenance:
clctrl -stop -n clustername -a - Pour remettre tous les noeuds en ligne après la maintenance:
clctrl -start -n clustername -a - Pour afficher des informations sur tous les paramètres optimisables de cluster dans un format de table, procédez comme suit:
clctrl -tune -L - Pour afficher l'aide relative au mode de référentiel optimisable:
clctrl -tune -h repos_mode - Pour définir la valeur des paramètres optimisables de cluster:
clctrl -tune -o repos_mode=e - Pour afficher la valeur en cours de tous les paramètres de sécurité, procédez comme suit:
clctrl -sec -e - Pour définir l'algorithme de sécurité utilisé pour générer la clé symétrique:
clctrl -sec -s DES - Pour valider manuellement un nouveau niveau de cluster qui est effectif dans l'ensemble du cluster:
clctrl -commit - Pour définir le mode de communication de cluster sur le mode unicast:
clctrl -tune -o communication_mode=u - Pour définir le mode de communication de cluster sur le mode multidiffusion:
clctrl -tune -o communication_mode=m