Relecture doc creation pm Trisquel #3

New Issue

Closed

opened 2023-10-16 15:09:49 +02:00 by neox · 0 comments

neox commented

2023-10-16 15:09:49 +02:00

Owner

Ci-après, quelques commentaires de relecture.

Bravo pour le style, c'est agréable à lire \o/

Installer un microprogramme libre

Recommandation de mettre « TODO page dédiée ».

Suggestion de faire une page dédiée sur laquelle pointer.

Récupérer l'image Trisquel NetInstall, qui est la plus adaptée à l'installation de serveurs.

La version DVD avec « Installer Trisquel en mode texte » ne fonctionne pas avec la console série ?

Du coup, obligé de passer par le réseau ? Donc plus lent ?

– A la date
+ À la date

Utiliser TAB pour éditer la ligne de commande du menu de démarrage du média et remplacer dans la ligne de commande du noyau vga=788 par console=ttyS0,115200n8.
Supprimer également la directive quiet.
Appuyer sur entrée pour continuer le démarrage.

Recommandation d'utiliser des puces :

Éditer la ligne de commande du menu de démarrage du média :

appuyer sur TAB ;

remplacer dans la ligne de commande du noyau vga=788 par console=ttyS0,115200n8 ;

supprimer la directive quiet ;

appuyer sur entrée pour continuer le démarrage.

via la console série, sans écran.

Comment configurer côté pc de l'admin qui fait l'installation ?

Y-a-t-il des câbles dédiés sur chaque site ? Où sont-ils rangés ?

Installer avec la langue anglaise et la locale en_US.UTF8.
Indiquer le lieu en France, utiliser le miroir allemand.

Suggestion de simplifier la rédaction avec des puces :
Configuration :

langue : anglaise
locale : en_US.UTF8
lieu : France
miroir : en Allemagne

une partition de démarrage (en ext2)

Pourquoi pas ext4 ? À une époque ext2 ne fonctionnait pas avec ext2, ce n'est plus un problème ?

Redémarrer à l'issue de cette commande.

Recommandation de mettre la commande (a priori, pas reboot mais un truc comme kexec -e ?).

Redémarrer la machine à la fin de ces étapes.

Un reboot ou un kexec ? Recommandation de guider l'opérateur avec la commande.

– Autoriser les ports 222, 25, 5665, 68, 7789, 16514, 49152, 49153, 3493 :
+ Ouvrir des ports :

Recommandation de ne pas répéter les numéros.

À quoi correspondent les ports ? Recommandation d'indiquer les services associés en commentaire :

ufw allow 25    # SMTP.
ufw allow 68    # BOOTPC.
ufw allow 222   # SSH.
ufw allow 3493  # ???
ufw allow 5665  # ???
ufw allow 7789  # ???
ufw allow 16514 # ???
ufw allow 49152 # ???
ufw allow 49153 # ???

– Créer un nouvel utilisateur dédié : virt-user
+ Créer un nouvel utilisateur dédié `virt-user` :

Recommandations :

une phrase pour expliquer à quoi sert ce compte.
documenter la neutralisaiton du mdp ?
donner l'URL à mettre dans virt-manager pour accéder via ce compte.

Éditer /etc/skel/.bashrc et /home/admin666/.bashrc :
Éditer le fichier /root/.bashrc :

Là, c'est plus « écraser » qu'éditer. Comment savoir ce qui a été modifié et pourquoi ? En cas de futur évolution des fichiers, impossible de faire suivre les modifications.

Suggestion : mettre le diff entre l'original et le nouveau. La plupart du temps, quand les modifications sont peu nombreuses, ça suffit.

Ci-après, quelques commentaires de relecture. ---- Bravo pour le style, c'est agréable à lire \o/ ---- > Installer un microprogramme libre Recommandation de mettre « TODO page dédiée ». Suggestion de faire une page dédiée sur laquelle pointer. ---- > Récupérer l'image Trisquel NetInstall, qui est la plus adaptée à l'installation de serveurs. La version DVD avec « Installer Trisquel en mode texte » ne fonctionne pas avec la console série ? Du coup, obligé de passer par le réseau ? Donc plus lent ? ---- ``` – A la date + À la date ``` ---- > Utiliser `TAB` pour éditer la ligne de commande du menu de démarrage du média et remplacer dans la ligne de commande du noyau `vga=788` par `console=ttyS0,115200n8`. > Supprimer également la directive `quiet`. > Appuyer sur entrée pour continuer le démarrage. Recommandation d'utiliser des puces : > Éditer la ligne de commande du menu de démarrage du média : > - appuyer sur `TAB` ; > - remplacer dans la ligne de commande du noyau `vga=788` par `console=ttyS0,115200n8` ; > - supprimer la directive `quiet` ; > - appuyer sur entrée pour continuer le démarrage. ---- > via la console série, sans écran. Comment configurer côté pc de l'admin qui fait l'installation ? Y-a-t-il des câbles dédiés sur chaque site ? Où sont-ils rangés ? ---- > Installer avec la langue anglaise et la locale en_US.UTF8. > Indiquer le lieu en France, utiliser le miroir allemand. Suggestion de simplifier la rédaction avec des puces : Configuration : - langue : anglaise - locale : en_US.UTF8 - lieu : France - miroir : en Allemagne ---- > une partition de démarrage (en ext2) Pourquoi pas ext4 ? À une époque ext2 ne fonctionnait pas avec ext2, ce n'est plus un problème ? ---- > Redémarrer à l'issue de cette commande. Recommandation de mettre la commande (a priori, pas reboot mais un truc comme kexec -e ?). ---- > Redémarrer la machine à la fin de ces étapes. Un reboot ou un kexec ? Recommandation de guider l'opérateur avec la commande. ---- ``` – Autoriser les ports 222, 25, 5665, 68, 7789, 16514, 49152, 49153, 3493 : + Ouvrir des ports : ``` Recommandation de ne pas répéter les numéros. À quoi correspondent les ports ? Recommandation d'indiquer les services associés en commentaire : ``` ufw allow 25 # SMTP. ufw allow 68 # BOOTPC. ufw allow 222 # SSH. ufw allow 3493 # ??? ufw allow 5665 # ??? ufw allow 7789 # ??? ufw allow 16514 # ??? ufw allow 49152 # ??? ufw allow 49153 # ??? ``` ----- ``` – Créer un nouvel utilisateur dédié : virt-user + Créer un nouvel utilisateur dédié `virt-user` : ``` Recommandations : - une phrase pour expliquer à quoi sert ce compte. - documenter la neutralisaiton du mdp ? - donner l'URL à mettre dans virt-manager pour accéder via ce compte. ---- > Éditer /etc/skel/.bashrc et /home/admin666/.bashrc : > Éditer le fichier /root/.bashrc : Là, c'est plus « écraser » qu'éditer. Comment savoir ce qui a été modifié et pourquoi ? En cas de futur évolution des fichiers, impossible de faire suivre les modifications. Suggestion : mettre le diff entre l'original et le nouveau. La plupart du temps, quand les modifications sont peu nombreuses, ça suffit.