Umbenennen und umnummerieren

Namen und Adressen #

Der Name eines Netzes ist nur eine Bezeichnung. Er steht in juist status, und mit ihm sprichst du das Netz in Befehlen an. Sonst ändert ein neuer Name nichts. Für den Namen eines Geräts gilt dasselbe, nur ergibt er zusätzlich den DNS-Namen des Geräts: laptop.home.juist.

Jedes Gerät hat im Netz eine IPv4- und eine IPv6-Adresse. Beim Umnummerieren verschiebst du die IPv4-Adressen, entweder die aller Geräte oder die eines einzelnen. Das brauchst du, wenn der Bereich des Netzes mit einem LAN kollidiert, das du nutzt, oder mit einem anderen Netz auf demselben Gerät. IPv6-Adressen ändern sich dabei nie.

Beides sind Änderungen am Mitgliederlog: Ein Admin nimmt sie vor, und alle Geräte ziehen nach. Braucht das Quorum mehr als einen Admin, wartet die Änderung auf die anderen (Mehrere Admins).

Das Netz umbenennen #

juist network rename office

Ein Gerät umbenennen #

juist rename phone tablet

Das Gerät gibst du an wie bei juist remove: mit Namen, Adresse oder Schlüssel. Einen Namen, den schon ein anderes Gerät hat, lehnt juist ab, unabhängig von Groß- und Kleinschreibung.

Ein Gerät, das Dateien teilt, teilt sie unter seinem neuen Namen, etwa tablet.pub.example.org. Bei einem solchen Gerät lehnt juist außerdem einen Namen ab, den ein anderes Gerät veröffentlicht, einen, den das Gerät selbst schon veröffentlicht oder auf sich zeigen lässt, und einen, der kein gültiges DNS-Label ist. Ein laufendes juist share gibt seinen neuen Link aus.

Die Adressen aller Geräte verschieben #

$ juist network renumber 10.7.0.0/22
move "home" from 198.18.36.0/22 to 10.7.0.0/22, old addresses until Fri 9 Oct 14:00? [y/N] y
moving to 10.7.0.0/22; old addresses until Fri 9 Oct 14:00

$ juist network
home
  IPv4          10.7.0.0/22, 198.18.36.0/22 until Fri 9 Oct 14:00
  IPv6          fd77:9359:d9fb::/48

MOVING  FROM         TO        OLD UNTIL
laptop  198.18.36.1  10.7.0.1  Fri 9 Oct 14:00
nas     198.18.36.2  10.7.0.2  Fri 9 Oct 14:00

Bis zum Ablauf der Frist sind die Geräte unter beiden Adressen erreichbar. Danach gelten nur noch die neuen. Verbindungen laufen beim Umzug weiter. Nur Verbindungen von oder zu einer alten Adresse enden, wenn diese wegfällt.

Die Adresse eines einzelnen Geräts verschieben #

juist network renumber phone 10.7.0.9

Damit bekommt phone die Adresse 10.7.0.9, die im Bereich des Netzes liegen muss. Die alte Adresse funktioniert wie oben bis zum Ablauf der Frist weiter.

Alte Adressen vorzeitig stilllegen #

Haben alle Geräte vom Umzug erfahren, musst du nicht auf die Frist warten:

--finish warnt vorher, dass Geräte, die vom Umzug noch nichts wissen, die alte Adresse verlieren.

Das Netz beenden #

juist create zeigt das Break-glass-Geheimnis des Netzes einmal an, als Zeile Break-glass juist-break-glass-1.…, und speichert es nirgends. Mit ihm beendest du das Netz endgültig, ganz ohne Admin. Das ist der Ausweg, wenn nicht mehr genug Admin-Schlüssel übrig sind, um das Netz zu ändern, weil sie verloren gegangen oder gestohlen worden sind.

$ pass show juist/break-glass-home | juist network disable --yes
disabled "home"; every device stops as the record reaches it

Ohne Pipe fragt juist network disable nach der Zeile, ohne sie bei der Eingabe anzuzeigen, und dann, ob es das Netz beenden soll. --secrets FILE liest die Zeile aus einer Datei.

Jedes Gerät gibt den Record weiter und baut seine Tunnel ab, sobald es ihn erhält, und sein juist status meldet dann disabled. Um weiterzumachen, setzt du jedes Gerät mit juist reset zurück und lässt es einem neuen Netz beitreten, das du mit juist create anlegst.

Bewahre die Zeile getrennt von den Admin-Schlüsseln auf: Wer einen Tresor mit beidem erbeutet, kann das Netz verwalten und auch beenden.

Gut zu wissen #

• Alte IPv4-Adressen funktionieren in der Voreinstellung noch 7 Tage. Mit --for 12h oder --for 14d wählst du eine andere Frist. Sie sollte lang genug sein, dass jedes Gerät in dieser Zeit einmal online ist.
• Die Frist steht fest, sobald die Änderung vorgeschlagen ist. Bestätigen andere Admins sie später, sehen sie, wie viel Zeit noch bleibt.
• Ein Gerät hat höchstens eine alte Adresse. Wird es vor Ablauf der Frist erneut verschoben, fällt die frühere alte Adresse sofort weg, und juist warnt davor.
• Stillgelegte Adressen bleiben reserviert, damit kein anderes Gerät sie bekommt, bis du juist network renumber --finish ohne weitere Argumente aufrufst.
• Der neue Bereich muss Platz für alle Geräte bieten. juist warnt, wenn er sich mit einem LAN dieses Hosts überschneidet oder mit einem anderen Netz, dem das Gerät angehört.
• Konfiguration außerhalb von juist, in der alte Adressen stehen, zieht nicht mit um. Firewall-Regeln, Einträge in /etc/hosts und Ähnliches musst du selbst anpassen.
• Mit mehreren Netzen auf dem Gerät gibst du das Netz zuerst an: juist network renumber work 10.7.0.0/24, juist network rename work office.
• Ein Gerätename mit . oder _ ist kein DNS-Name: juist warnt, und das Gerät ist dann nur über seine Adresse erreichbar. Ein Gerät mit der Rolle publish kann einen solchen Namen nicht bekommen, da es unter seinem Namen teilt.
• Ein Admin-Schlüssel behält den Gerätenamen, unter dem er abgelegt wurde; juist admins zeigt ihn.
• Wer die Break-glass-Zeile hat, kann das Netz beenden. Ein Gerät mit einer juist-Version, die älter ist als juist network disable, hält erst an, wenn es aktualisiert ist. Ein Gerät, das in dem Moment offline ist, findet danach kein Gerät mehr, mit dem es sich verbinden kann.
• Netze, die entstanden sind, bevor juist die Zeile anzeigte, haben ihre Geheimnisse im Schlüsselspeicher, als break-glass-NETZ.secrets. juist network disable liest diese Datei dort; bring sie offline.

Fehlersuche #