From eb0a4e2993df6a086a47a8ff65e33bf104f676c8 Mon Sep 17 00:00:00 2001 From: jdubois Date: Wed, 7 Jul 2021 19:23:53 +0200 Subject: [PATCH] =?UTF-8?q?M=C3=A0J,=20clarification=20selon=20version,=20?= =?UTF-8?q?et=20ajout=20de=20plusieurs=20infos=20(monitoring=20via=20SNMP,?= =?UTF-8?q?=20APC=20avec=20compteurs=20par=20prises,=20cas=20double=20alim?= =?UTF-8?q?)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- HowtoMasterswitchAPC.md | 155 +++++++++++++++++++++++++++++----------- 1 file changed, 113 insertions(+), 42 deletions(-) diff --git a/HowtoMasterswitchAPC.md b/HowtoMasterswitchAPC.md index 86d24794..1aa901e3 100644 --- a/HowtoMasterswitchAPC.md +++ b/HowtoMasterswitchAPC.md @@ -3,93 +3,163 @@ categories: hardware title: Howto Master switch APC ... -* Documentation : +Documentation AP89XX : + +* Firmware version 6.8.0 : +* Firmware version 5.X.X : ## Installation -Cette partie est normalement documentée dans la section **Remote access to the control console** du manuel. +Deux solutions : via un [câble console](#port-série), ou via telnet/ssh. Attention : telnet est actif par défaut (ssh inactif) jusqu'à la version 6.8, à partir de laquelle c'est ssh qui devient actif par défaut (telnet inactif). -En résumé : +Via telnet ou ssh, en résumé : - Relever l'adresse MAC de l'APC -- Depuis une autre machine : arp -s (Note : cela doit apparemment être fait sur une machine avec future_IP_APC comprise dans le réseau d'une *vraie* interface (par exemple, cela ne semble pas marcher avec eth0:0... même en faisant arp -i eth0:0 -s ) +- Depuis une autre machine : arp -s (Note : cela doit apparemment être fait sur une machine avec future_IP_APC comprise dans le réseau d'une *vraie* interface (par exemple, cela ne semble pas marcher avec eth0:0... même en faisant arp -i eth0:0 -s )) - Depuis cette autre machine, faire un : ping -s 113 -- Puis : telnet avec le login/passwd apc/apc. -- En fin, bien penser à lui fixer son adresse IP définitive !! +- Puis : telnet/ssh avec le login/passwd apc/apc. +- Enfin, bien penser à lui fixer son adresse IP définitive !! ## Manipulations de base -- Définir le nom et domaine de l'APC (dans 2>1>5>1 et 3>2>1) -- Positionner les paramètres réseaux (IP/Netmask/Gateway), DNS -- Configurer un serveur NTP, et se mettre en timezone GMT +- Définir le nom et domaine de l'APC +- Positionner les paramètres réseaux (IP/Netmask/Gateway/DNS) - Changer le login/passwd +- Configurer SNMP +- Configurer un serveur NTP, et se mettre en timezone GMT +- Configurer les paramètres mails (serveur SMTP/from/to) pour recevoir des notifications par mail - Relever les machines branchées à ses ports -## Commande pour CLI du modèle AP8959EU3 +Selon la version du firmware de l'APC, les commandes sont différentes. Une fois connecté à un APC, la version de son firmware est visible en haut à droite, ainsi qu'avec la commande `about` sous "APC OS(AOS)" sauf pour la version interactives où il n'y a justement pas de commande, mais des menus à suivre. -### Commandes générales : +## Commandes CLI pour le firmware version interactif + +### Contrôle des ports ~~~ -system -n APC42 # changer le nom de l'APC -reboot # redémarrer le firmware (ne redémarre pas les outlets ;-) -console -S telnet # active le telnet ET désactive le SSH -snmp -S enable # active le SNMP -userPasswd root -user -an root -ap PASSWORD # change le mot de passe du compte admin "root" -dns -p X.X.X.X # configure le serveur dns primaire -email -g1 enable -s1 X.X.X.X -t1 foo@example.com -r1 custom -f1 bar@example.com # configure l'envoi d'alertes mail -system # liste des infos de l'APC -prodInfo # liste des infos de l'APC +# Lister tous les ports : +"1- Device Manager" > "2- Outlet Management" > "1- Outlet Control/Configuration" + +# À partir de ce menu, redémarrer le port n°3 : +"3- XXXXX ON" > "1- Control Outlet" > "3- Immediate Reboot" OU "2- Immediate Off" puis "1- Immediate On" ~~~ -### Gestion du réseau : + +## Commandes CLI pour le firmware version 5.X.X + +### Commandes générales ~~~ -apc> help tcpip +apc> help tcpip # gestion du réseau Usage: tcpip -- Configure and display TCP/IP v4 parameters tcpip [-S ] [-i ] [-s ] [-g ] [-d ] - [-h ] + [-h ] # hostname “réseau”, différent du hostname “système” (system -n) + +user -an root -ap PASSWORD # changer le mot de passe du compte admin "root", l'utilisateur est créé si nécessaire +userDelete apc # supprimer l'utilisateur par défaut "apc" +system -n APC42 # changer le nom de l'APC +snmp -S enable # activer le SNMP +dns -p X.X.X.X # configurer le serveur dns primaire +ntp -p X.X.X.X # configurer le serveur ntp primaire +console -S telnet # activer le telnet ET désactive le SSH (défaut sur cette version) +reboot # redémarrer le firmware (ne redémarre pas les prises) +system # lister des infos de l'APC +prodInfo # lister des infos de l'APC ~~~ -**tcpip -h** est le hostname "réseau", il est différent du hostname "système" (**system -n**) +Les paramètres mail et de DST peuvent se régler depuis l'interface web. -### Contrôle des ports : +### Contrôle des ports ~~~ -olName all # liste tous les ports -olStatus all # liste tous les ports avec le status des ports -olStatus 3 # liste le status du port 3 -olName 3 salut # renomme le port 3 en "salut" -olReboot 3 # reboot le port 3 (salut donc) -olOff 3 # éteint le port salut -olOn 3 # allume le port salut +olStatus all # lister tous les ports avec leur status ON ou OFF +olStatus 3 # afficher le status du port 3 +olName 3 salut # renommer le port 3 en "salut" +olReboot 3 # reboot le port 3 (salut, donc) +olOff 3 # éteintre le port salut +olOn 3 # allumer le port salut + appcli # passe en mode CLI spécial pour gérer les outlets ~~~ -## Commande pour CLI du modèle interactif -### Contrôle des ports : +## Commandes CLI pour le firmware version 6.X.X + + +### Commandes générales ~~~ -# Lister tous les ports : -"1- Device Manager" > "2- Outlet Management" > "1- Outlet Control/Configuration" -# À partir de ce menu, redémarrer le port n°3 : -"3- XXXXX ON" > "1- Control Outlet" > "3- Immediate Reboot" ou "2- Immediate Off" puis "1- Immediate On" +apc>help tcpip # gestion du réseau +Usage: tcpip -- Configure and display TCP/IP v4 parameters + tcpip [-S ] + [-i ] + [-s ] + [-g ] + [-d ] + [-h ] # hostname “réseau”, différent du hostname “système” (system -n) + +user -n root -pw PASSWORD -pe Administrator -e enable # changer le mot de passe du compte admin "root", l'utilisateur est créé si nécessaire +user -n apc -cp apc -e disable # désactiver l'utilisateur par défaut "apc" +system -n APC42 # changer le nom de l'APC +console -t enable # activer le telnet ET désactive le SSH (telnet par défaut jusqu'à 6.8, SSH par défaut à partir de 6.8) +snmp -S enable -c1 public -a1 read -n1 Y.Y.Y.Y # activer le snmp sur la communauté "public" en RO, avec autorisation pour l'IP "Y.Y.Y.Y" uniquement +dns -p X.X.X.X # configurer le serveur dns primaire +ntp -p X.X.X.X # configurer le serveur ntp primaire +email -g1 enable -s1 X.X.X.X -t1 foo@example.com -r1 custom -f1 bar@example.com # configurer l'envoi d'alertes mail +reboot # redémarrer le firmware (ne redémarre pas les prises) +system # lister des infos de l'APC +prodInfo # lister des infos de l'APC ~~~ +Le paramètre de DST peut se régler depuis l'interface web. + +### Contrôle des ports + +~~~ +olStatus all # lister tous les ports avec leur status ON ou OFF +olStatus 3 # afficher le status du port 3 +olName 3 salut # renommer le port 3 en "salut" +olReboot 3 # reboot le port 3 (salut, donc) +olOff 3 # éteintre le port salut +olOn 3 # allumer le port salut + +appcli # passe en mode CLI spécial pour gérer les outlets +~~~ + +## Cas d'une machine avec double alimentation + +Lorsqu'une machine a 2 alimentations (que ce soit via 2 APCs différents, ou sur 2 prises du même APC) et que l'on souhaite éteindre ou redémarrer cette machine, il faut bien penser à éteindre les ports d'alimentation des **2 prises**, sinon la machine restera alimentée par au moins une autre prise : + +* On **éteint** l'alimentation de la **1e prise** +* On **éteint** l'alimentation de la **2e prise** +* On **rallume** l'alimentation de la **2e prise** +* On **rallume** l'alimentation de la **1e prise** + +## APCs avec compteurs par prises + +Les modèles AP86XX ont un compteur par prise, permettant de savoir quelle machine consomme combien (intensité en A, puissance en W, et énergie consommé en Wh). + +Cependant comme indiqué sur la [FAQ](https://www.apc.com/us/en/faqs/FA156074/#PDUG2), les valeurs en dessous de 0.5A et 50W pour chaque prise ne sont pas mesurées et sont indiqués comme 0A/0W. + +## Monitoring via SNMP + +Les OID `.1.3.6.1.4.1.318.1.1.12` (rPDU) et `.1.3.6.1.4.1.318.1.1.26` (rPDU2, à préférer) permettent d'intérroger les APCs sur leur état, notamment l'intensité utilisée sur le moment. + +Voir la page [HowtoCollectd#plugin-snmp]() pour des exemples de configuration avec Collectd. + ## Mise à jour du firmware **Voir si l'on possède les anciens binaires... certains binaires récents semblent incompatibles avec du vieux matériel** * Télécharger les binaires (un binaire pour AOS et un binaire pour le rpdu?) * Se connecter en FTP avec le login administrateur -* passer en mode binaire (binary) et uploader le firmware "aos" -* une fois terminée, l'APC redémarre tout seul -* une fois redémarré, se connecter à nouveau en FTP, passer en mode binaire et uploader le firmware "Rack PDU APP" ('rpdu?) +* Passer en mode binaire (binary) et uploader le firmware "aos" +* Une fois terminée, l'APC redémarre tout seul +* Une fois redémarré, se connecter à nouveau en FTP, passer en mode binaire et uploader le firmware "Rack PDU APP" ('rpdu?) * Cela redémarre, l'upgrade est terminée ## Chainer les APC entre eux @@ -141,4 +211,5 @@ et il faut taper les commandes à l'aveugle... ## Reset des accès Le reset des accès n'impacte pas les prises de courant. + Appuyer sur le bouton RESET. Après quelques secondes, la LED réseau clignote alternativement en orange et vert. Il faut à ce moment là appuyer à nouveau sur le bouton RESET. On peut ainsi accéder à l'APC via le port série avec le login **apc** et le mot de passe **apc**. Attention, il faut vite se connecter : l'accès est reset pendant uniquement 30 secondes. \ No newline at end of file