Changer l'IP d'un ancien robot

Le robot doit prendre une nouvelle adresse IP : votre service informatique la lui attribue, ou le robot change de réseau. Pendant ce changement, le robot n'exécute aucun test, jusqu'à ce qu'il repasse Online. Sur un ancien robot, l'adresse IP, la passerelle et les serveurs DNS sont écrits dans un seul fichier. Une commande tapée sur la console suffit à le réécrire.

Cette page concerne les robots qui n'affichent aucun bureau après la connexion, seulement une ligne de commande. Si vous voyez un bureau Linux, votre robot est de dernière génération : suivez plutôt configurer le réseau du robot.

Avant de commencer

• Un écran, un clavier et un câble vidéo, HDMI ou VGA selon le modèle de robot. La souris est inutile : tout se fait en ligne de commande.
• Les identifiants du robot. Demandez-les à support@kapptivate.com si vous ne les avez pas.
• La nouvelle adresse IP, son masque, la passerelle et les adresses des serveurs DNS, fournis par votre service informatique.
• Sur un réseau d'entreprise filtré, les flux ouverts pour la nouvelle adresse. Ils sont listés dans le document des exigences IP : demandez-le à support@kapptivate.com et transmettez-le à votre service informatique. Sans ces flux, le robot reste Offline sur sa nouvelle adresse.
• Un accès à la plateforme Kapptivate, pour y voir le robot repasser Online.

Se connecter à la console

Branchez l'écran et le clavier à l'arrière du robot. La première ligne affiche Ubuntu et sa version. En dessous, le robot attend un nom d'utilisateur :

Ubuntu 22.04.5 LTS demo-4g-1 tty1

demo-4g-1 login:

Saisissez le nom d'utilisateur, puis le mot de passe de vos identifiants. Le mot de passe ne s'affiche pas pendant la saisie, c'est normal.

Repérer le port et le fichier

Avant d'écrire quoi que ce soit, relevez deux valeurs : le port où le câble est branché, et le nom du fichier réseau. Commencez par le port.

ip -br link | grep ^en

enp1s0           UP             00:00:5e:00:53:01 <BROADCAST,MULTICAST,UP,LOWER_UP>
enp2s0           DOWN           00:00:5e:00:53:02 <NO-CARRIER,BROADCAST,MULTICAST,UP>

Il y a une ligne par port Ethernet. Regardez la deuxième colonne. Le câble est branché sur le port qui y affiche UP, ici enp1s0. Si tous les ports affichent DOWN dans cette colonne, branchez le câble sur un autre port à l'arrière du robot et relancez la commande.

Listez ensuite les fichiers réseau.

ls /etc/netplan

01-netcfg.yaml

Le nom du fichier dépend du robot : 01-netcfg.yaml, 00-installer-config.yaml ou 50-cloud-init.yaml. Les noms qui ne se terminent pas par .yaml, comme .save ou .bak, sont d'anciennes copies, et le robot les ignore. Si deux noms se terminent par .yaml, le robot lit les deux fichiers, et en réécrire un seul ne suffit pas. Dans ce cas, arrêtez-vous et écrivez à support@kapptivate.com.

Copiez maintenant le fichier, en remplaçant FILE par le nom affiché par ls :

sudo cp /etc/netplan/FILE /root/

Si sudo demande un mot de passe, saisissez celui de votre connexion. La copie est rangée dans /root, hors de /etc/netplan, donc le robot ne la lit pas. C'est elle que vous remettez en place pour revenir à la configuration précédente.

Écrire la nouvelle adresse

Toute la configuration tient sur une ligne, sans indentation. Voici la commande, avec en capitales les valeurs à remplacer :

echo "network: {version: 2, ethernets: {PORT: {addresses: [ADDRESS/PREFIX], gateway4: GATEWAY, nameservers: {addresses: [DNS1, DNS2]}}}}" | sudo tee /etc/netplan/FILE

• PORT : le port qui affichait UP, par exemple enp1s0.
• ADDRESS/PREFIX : la nouvelle adresse IP, une barre oblique, puis le masque sous sa forme courte, par exemple 192.168.10.42/24. Le tableau ci-dessous donne la forme courte du masque fourni par votre service informatique.
• GATEWAY : l'adresse de la passerelle.
• DNS1, DNS2 : les serveurs DNS, séparés par une virgule et une espace. S'il n'y en a qu'un, écrivez-le seul.
• FILE : le nom de fichier affiché par ls.

Si votre masque n'est pas dans le tableau, demandez sa forme courte à votre service informatique.

Par exemple, pour un robot en 192.168.10.42 sur un réseau 255.255.255.0 :

echo "network: {version: 2, ethernets: {enp1s0: {addresses: [192.168.10.42/24], gateway4: 192.168.10.1, nameservers: {addresses: [192.168.10.53, 192.168.10.54]}}}}" | sudo tee /etc/netplan/01-netcfg.yaml

La commande réaffiche la ligne, qui est désormais le contenu du fichier. Seul le port câblé reçoit une adresse : si vous déplacez le câble sur un autre port plus tard, reprenez cette page.

Vérifier le fichier et l'appliquer

Vérifiez d'abord le fichier.

sudo netplan generate

Sous Ubuntu 18.04 et 20.04, un fichier valide n'affiche rien. À partir d'Ubuntu 22.04, il affiche cet avertissement, qui ne bloque rien :

** (generate:2408447): WARNING **: 10:06:30.273: `gateway4` has been deprecated, use default routes instead.
See the 'Default routes' section of the documentation for more details.

Sous Ubuntu 24.04, un second avertissement peut suivre, Permissions for /etc/netplan/01-netcfg.yaml are too open. Il ne bloque rien non plus.

Si la ligne contient une faute de frappe, la commande affiche une erreur. L'erreur commence par le nom du fichier, suivi du numéro de ligne et du numéro de colonne où se trouve la faute. Voici les trois erreurs les plus probables.

/etc/netplan/01-netcfg.yaml:1:55: Error in network definition: address '192.168.10.42' is missing /prefixlength

Le masque manque après l'adresse. Ajoutez /24, ou la forme courte donnée par le tableau.

/etc/netplan/01-netcfg.yaml:2:1: Invalid YAML: did not find expected ',' or '}':

Une accolade manque. La ligne doit se terminer par quatre } avant le guillemet final.

/etc/netplan/01-netcfg.yaml:1:75: Error in network definition: unknown key 'gateway4:192.168.10.1'

Une espace manque après un deux-points. Dans la ligne, chaque : et chaque , est suivi d'une espace.

Pour corriger, appuyez deux fois sur la flèche du haut : la commande echo réapparaît. Corrigez-la, appuyez sur Entrée pour réécrire le fichier, puis relancez sudo netplan generate. Sous Ubuntu 18.04, les messages sont formulés un peu différemment, mais ils signalent les mêmes erreurs.

Quand la vérification ne signale plus d'erreur, appliquez le fichier.

sudo netplan apply

La commande n'affiche rien, ou les mêmes avertissements que la vérification. Relevez ensuite l'adresse que le robot utilise réellement.

ip route get 1.1.1.1

1.1.1.1 via 192.168.10.1 dev enp1s0 src 192.168.10.42 uid 1000
    cache

src doit afficher la nouvelle adresse, et via la passerelle. Les autres réponses possibles de cette commande sont décrites dans vérifier la connexion réseau du robot.

Redémarrer et relire le statut

Redémarrez le robot.

sudo reboot

Le robot redémarre sur sa nouvelle adresse. Il est déjà déployé : vous n'avez rien à demander au support. Laissez à la plateforme environ trois minutes, puis relisez le statut du robot dans la liste de vos robots. Il doit repasser Online.

S'il reste Offline, déroulez vérifier la connexion réseau du robot : l'adresse, la passerelle, puis les flux.

Revenir à la configuration précédente

Remettez la copie en place, puis appliquez-la, en remplaçant FILE par le nom du fichier copié :

sudo cp /root/FILE /etc/netplan/
sudo netplan apply

Et ensuite ?