2016-10-18 17:36:45 +02:00
---
categories: hardware
title: Howto Master switch APC
...
2021-07-07 19:23:53 +02:00
Documentation AP89XX :
* Firmware version 6.8.0 : < https: // download . schneider-electric . com / files ? p_File_Name = 990-5569M_EN.pdf&p_Doc_Ref=990-5569_EN&p_enDocType=User+guide >
* Firmware version 5.X.X : < https: // download . schneider-electric . com / files ? p_File_Name = JSAI-862KZR_R2_EN.pdf&p_Doc_Ref=SPD_JSAI-862KZR_EN&p_enDocType=User+guide >
2016-10-18 17:36:45 +02:00
## Installation
2021-07-07 19:23:53 +02:00
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).
2016-10-18 17:36:45 +02:00
2021-07-07 19:23:53 +02:00
Via telnet ou ssh, en résumé :
2016-10-18 17:36:45 +02:00
- Relever l'adresse MAC de l'APC
2021-07-07 19:23:53 +02:00
- Depuis une autre machine : arp -s < future_IP_APC > < MAC_APC > (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 < future_IP_APC > < MAC_APC > ))
2016-10-18 17:36:45 +02:00
- Depuis cette autre machine, faire un : ping -s 113 < future_IP_APC >
2021-07-07 19:23:53 +02:00
- Puis : telnet/ssh < future_IP_APC > avec le login/passwd apc/apc.
- Enfin, bien penser à lui fixer son adresse IP définitive !!
2016-10-18 17:36:45 +02:00
## Manipulations de base
2021-07-07 19:23:53 +02:00
- Définir le nom et domaine de l'APC
- Positionner les paramètres réseaux (IP/Netmask/Gateway/DNS)
2016-10-18 17:36:45 +02:00
- Changer le login/passwd
2021-07-07 19:23:53 +02:00
- 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
2016-10-18 17:36:45 +02:00
- Relever les machines branchées à ses ports
2021-07-07 19:23:53 +02:00
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.
2016-10-18 17:36:45 +02:00
2021-07-07 19:23:53 +02:00
## Commandes CLI pour le firmware version interactif
### Contrôle des ports
2016-10-18 17:36:45 +02:00
~~~
2021-07-07 19:23:53 +02:00
# 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"
2016-10-18 17:36:45 +02:00
~~~
2021-07-07 19:23:53 +02:00
## Commandes CLI pour le firmware version 5.X.X
### Commandes générales
2017-02-16 11:21:20 +01:00
~~~
2021-07-07 19:23:53 +02:00
apc> help tcpip # gestion du réseau
2017-02-16 11:21:20 +01:00
Usage: tcpip -- Configure and display TCP/IP v4 parameters
tcpip [-S < enable | disable > ]
[-i < ipv4 address > ]
[-s < subnet mask > ]
[-g < gateway > ]
[-d < domain name > ]
2021-07-07 19:23:53 +02:00
[-h < host name > ] # 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
2017-02-16 11:21:20 +01:00
~~~
2021-07-07 19:23:53 +02:00
Les paramètres mail et de DST peuvent se régler depuis l'interface web.
2017-02-16 11:21:20 +01:00
2021-07-07 19:23:53 +02:00
### Contrôle des ports
2016-10-18 17:36:45 +02:00
~~~
2021-07-07 19:23:53 +02:00
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
2016-10-18 17:36:45 +02:00
appcli # passe en mode CLI spécial pour gérer les outlets
~~~
2020-08-27 10:47:32 +02:00
2021-07-07 19:23:53 +02:00
## Commandes CLI pour le firmware version 6.X.X
### Commandes générales
2020-08-27 10:47:32 +02:00
~~~
2021-07-07 19:23:53 +02:00
apc>help tcpip # gestion du réseau
Usage: tcpip -- Configure and display TCP/IP v4 parameters
tcpip [-S < enable | disable > ]
[-i < ipv4 address > ]
[-s < subnet mask > ]
[-g < gateway > ]
[-d < domain name > ]
[-h < host name > ] # 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
2020-08-27 10:47:32 +02:00
~~~
2021-07-07 19:23:53 +02:00
## 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
2021-07-07 19:28:21 +02:00
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ée en Wh).
2021-07-07 19:23:53 +02:00
2021-07-07 19:28:21 +02:00
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. Cela perd souvent en intérêt, surtout lorsqu'une machine est double alimentée : sa charge se répartit plus ou moins entre les 2 alimentations, qui est donc trop faible pour être mesurée.
2021-07-07 19:23:53 +02:00
## 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.
2016-10-18 17:36:45 +02:00
## 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
2021-07-07 19:23:53 +02:00
* 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?)
2016-10-18 17:36:45 +02:00
* Cela redémarre, l'upgrade est terminée
2020-03-06 14:19:13 +01:00
## Chainer les APC entre eux
Afin d'administrer jusqu'à 4 APCs à travers une seule IP, il est possible de les chainer entre eux.
Ils doivent pour cela être en version 6 minimum.
* Brancher l'APC 1 au réseau, et lui configurer une IP
* Brancher le port OUT de l'APC 1 au port IN de l'APC 2, et faire de même pour le nombre d'APCs souhaités (limité à 4)
* Chaque extrémité doit être bouché avec un bouchon réseau fourni : le port IN du premier APC et le port OUT du dernier APC
2016-10-18 17:36:45 +02:00
## Port série
2020-08-19 10:03:35 +02:00
### screen
2016-10-18 17:36:45 +02:00
~~~
2020-08-19 10:03:35 +02:00
# screen /dev/ttyUSB0 9600
2016-10-18 17:36:45 +02:00
~~~
2020-08-19 10:03:35 +02:00
### minicom
2016-10-18 17:36:45 +02:00
~~~
2020-08-19 10:03:35 +02:00
# minicom -b 9600 -D /dev/ttyUSB0
~~~
Il est aussi possible de créer un fichier de configuration et la commande `minicom` avec le nom de la configuration :
~~~
# cat /etc/minicom/minirc.apc
pu port /dev/ttyUSB0
pu baudrate 9600
pu bits 8
pu parity N
pu stopbits 1
pu rtscts No
# minicom apc
~~~
### cu
~~~
# cu -l /dev/cuaU0 -s 9600
2016-10-18 17:36:45 +02:00
~~~
Attention, parfois les caractères sont illisibles (problème matériel ?)
et il faut taper les commandes à l'aveugle...
## Reset des accès
2018-10-09 18:20:05 +02:00
Le reset des accès n'impacte pas les prises de courant.
2021-07-07 19:23:53 +02:00
2018-06-22 18:17:10 +02:00
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.