From 82d6c6f1f79465526519f508f575a36b80bab43f Mon Sep 17 00:00:00 2001 From: kyodev Date: Sun, 10 Sep 2017 01:07:13 +0200 Subject: [PATCH] 1.0.0 --- docs/scripts/getThunderbird.md | 394 +++++++++++++++++++++++++++++++++ 1 file changed, 394 insertions(+) create mode 100644 docs/scripts/getThunderbird.md diff --git a/docs/scripts/getThunderbird.md b/docs/scripts/getThunderbird.md new file mode 100644 index 0000000..f973726 --- /dev/null +++ b/docs/scripts/getThunderbird.md @@ -0,0 +1,394 @@ +# getThunderbird + +> c'est un script bash qui télécharge les dernières versions officielles de Thunderbird, canaux possibles: + **latest** la release officielle et **beta** + +> les mises à jour de Thunderbird sont gérées par celui-ci, avec des corrections mineures fréquentes + +> seul le script se mettra éventuellement à jour, sans influence sur les canaux Thunderbird installés + +> le script installe un canal Thunderbird pour l'user en cours, mais toutes les installations/désinstallations + doivent être faites avec les privilèges **root** + + +## installation rapide du script + +**en root**: +```shell +wget -O getThunderbird https://framagit.org/kyodev/kyopages/raw/master/scripts/getThunderbird +chmod +x getThunderbird && ./getThunderbird +``` +```text + _ _____ _ _ _ _ _ + __ _ ___| ||_ _| |__ _ _ _ __ __| | ___ _ __| |__ (_)_ __ __| | + / _' |/ _ \ __|| | | '_ \| | | | '_ \ / _' |/ _ \ '__| '_ \| | '__/ _' | +| (_| | __/ |_ | | | | | | |_| | | | | (_| | __/ | | |_) | | | | (_| | + \__, |\___|\__||_| |_| |_|\__,_|_| |_|\__,_|\___|_| |_.__/|_|_| \__,_| + |___/ + version 1.0.0 - 09/09/2017 + + getThunderbird 1.0.0 installé dans le système. + maintenant, appel du script par: getThunderbird (sans ./) + +``` + +* le script est maintenant dans le système et tout utilisateur peut s'en servir. +* **Thunderbird n'est pas encore installé** +* à moins de savoir ce que vous faites, il est peut-être mieux de désinstaller le paquet officiel + _thunderbird_ ou _icedove_ +* un canal Thunderbird peut maintenant être choisi et installé (`latest`,`beta`) + + +## installation d'un canal Thunderbird + +`getThunderbird i-canal` (canal _all_ possible) par exemple, pour la Release officielle, en **root**: +```shell +getThunderbird i-latest +``` +```text + _ _____ _ _ _ _ _ + __ _ ___| ||_ _| |__ _ _ _ __ __| | ___ _ __| |__ (_)_ __ __| | + / _' |/ _ \ __|| | | '_ \| | | | '_ \ / _' |/ _ \ '__| '_ \| | '__/ _' | +| (_| | __/ |_ | | | | | | |_| | | | | (_| | __/ | | |_) | | | | (_| | + \__, |\___|\__||_| |_| |_|\__,_|_| |_|\__,_|\___|_| |_.__/|_|_| \__,_| + |___/ + version 1.0.0 - 09/09/2017 + + installation thunderbird-latest + + - téléchargement... + +/tmp/getThunderbird-30059/thunderbird-la 100%[=================================>] 48,88M 2,50MB/s in 20s + + - décompression... + + - installation... + + - thunderbird lié à thunderbird-latest + + - récupération du profil default existant + + thunderbird-latest installé + +``` + +* la dernière version officielle Thunderbird est installée, en étant directement chargée sur le site Mozilla +* un lanceur par canal installé est placé dans les menus (Applications/Internet) +* l'installation de Thunderbird sur un canal existant est refaite en **totalité**, mais **le profil + n'est pas modifié** +* si un profil _123xyz.default_ (d'un paquet _thunderbird_ par exemple) existe, il sera laissé en place, mais + une **copie** sera utilisée pour le profil le plus bas trouvé. le passage d'une version paquet debian à une + version Mozilla utilisera donc une copie du profil en cours. l'éventuel profil default sera + utilisé pour la première installation d'un canal. les réinstallations ultérieures, si les profils + ne sont pas supprimés, n'utiliseront pas de profil défault détecté +* les canaux peuvent coexister +* chaque canal peut être lancé en console: `thunderbird-latest` ou `thunderbird-beta` +* le plus bas canal installé peut lui être lancé avec: `thunderbird` + + +## help + +```shell +getThunderbird -h +``` +```text + _ _____ _ _ _ _ _ + __ _ ___| ||_ _| |__ _ _ _ __ __| | ___ _ __| |__ (_)_ __ __| | + / _' |/ _ \ __|| | | '_ \| | | | '_ \ / _' |/ _ \ '__| '_ \| | '__/ _' | +| (_| | __/ |_ | | | | | | |_| | | | | (_| | __/ | | |_) | | | | (_| | + \__, |\___|\__||_| |_| |_|\__,_|_| |_|\__,_|\___|_| |_.__/|_|_| \__,_| + |___/ + version 1.0.0 - 09/09/2017 + + ---------------------------------------------------------------------- + canaux possibles latest, beta + = latest, beta + + exemple, installation version Release: getThunderbird i-release + installation version latest, beta: getThunderbird i-all + + getThunderbird i-canal : installation de Thunderbird ( possible) + getThunderbird r-canal : désinstallation de Thunderbird ( possible) + getThunderbird u-canal : ajouter ou configurer un profil Thunderbird pour l'utilisateur en cours + getThunderbird d-canal : copier un profil default existant sur + + getThunderbird m-canal : installation sur le d'une archive téléchargée manuellement + + getThunderbird version : version(s) installée(s) et en ligne des différents canaux Thunderbird + & version script + ---------------------------------------------------------------------- + ./getThunderbird : installation du script dans le système + getThunderbird -h, --help : affichage aide + getThunderbird -r, --remove : désinstallation du script du système + getThunderbird -u, --upgrade : mise à jour du script + getThunderbird -v, --version : versions du script + ---------------------------------------------------------------------- + Si présent, le *paquet Debian* thunderbird devrait être désinstallé + ---------------------------------------------------------------------- + plus d'infos: https://kyodev.frama.io/kyopages/scripts/getThunderbird/ + +``` + + +## version + +```shell +getThunderbird version +``` +```text + _ _____ _ _ _ _ _ + __ _ ___| ||_ _| |__ _ _ _ __ __| | ___ _ __| |__ (_)_ __ __| | + / _' |/ _ \ __|| | | '_ \| | | | '_ \ / _' |/ _ \ '__| '_ \| | '__/ _' | +| (_| | __/ |_ | | | | | | |_| | | | | (_| | __/ | | |_) | | | | (_| | + \__, |\___|\__||_| |_| |_|\__,_|_| |_|\__,_|\___|_| |_.__/|_|_| \__,_| + |___/ + version 1.0.0b - 09/09/2017 + +....... + version(s) Thunderbird installé(s): latest: 56.0 + version paquet debian Thunderbird: 52.2.1 + versions Thunderbird en ligne: latest: 52.3.0 beta: 56.0b3 + + version script en cours: 1.0.0b + version script en ligne: 1.0.0, mise à jour possible + +``` + +* affiche les versions Thunderbird installées et les versions en ligne +* affiche la version installée du script et la version en ligne du script, avec mise à jour possible éventuelle + + +## profil default + +lors de l'installation d'un canal, un éventuel profil _123xyz.default_ sera copié sur le canal le plus bas +trouvé. + +* si `getThunderbird i-beta` est installé en premier: + * le profil default est copié et le canal beta utilisera une éventuelle configuration existante + * si l'installation est suivie du canal latest (canal plus bas), ce profil default sera aussi copié, et les + deux canaux utiliseront donc une même configuration de base. +* si `getThunderbird i-latest` est installé en premier: + * le profil default est copié et le canal latest utilisera une éventuelle configuration existante + * si l'installation est suivie du canal beta (canal plus haut), aucun profil default ne sera copié + et utilisable + +## profil default, copie + +dupliquer un profil 123xyz.default existant sur un canal choisi ( au lieu du canal le plus bas lors +de l'installation ) +`getThunderbird d-canal` par exemple, pour la version beta: +```shell +getThunderbird d-beta +``` +```text + _ _____ _ _ _ _ _ + __ _ ___| ||_ _| |__ _ _ _ __ __| | ___ _ __| |__ (_)_ __ __| | + / _' |/ _ \ __|| | | '_ \| | | | '_ \ / _' |/ _ \ '__| '_ \| | '__/ _' | +| (_| | __/ |_ | | | | | | |_| | | | | (_| | __/ | | |_) | | | | (_| | + \__, |\___|\__||_| |_| |_|\__,_|_| |_|\__,_|\___|_| |_.__/|_|_| \__,_| + |___/ + version 1.0.0 - 09/09/2017 + + copie d'un profil default sur beta + + copie du profil default sur beta + +``` + +## nouvel utilisateur ou reconfiguration profil + +ajouter un profil d'un canal Thunderbird installé pour un nouvel utilisateur en cours ou configurer +un canal pour l'utilisateur en cours + +`getThunderbird u-canal` par exemple, pour la version beta: + +```shell +getThunderbird u-beta +``` +```text + _ _____ _ _ _ _ _ + __ _ ___| ||_ _| |__ _ _ _ __ __| | ___ _ __| |__ (_)_ __ __| | + / _' |/ _ \ __|| | | '_ \| | | | '_ \ / _' |/ _ \ '__| '_ \| | '__/ _' | +| (_| | __/ |_ | | | | | | |_| | | | | (_| | __/ | | |_) | | | | (_| | + \__, |\___|\__||_| |_| |_|\__,_|_| |_|\__,_|\___|_| |_.__/|_|_| \__,_| + |___/ + + version 1.0.0 - 09/09/2017 + + profil configuré pour kyodev + +``` + +* il faut que canal Thunderbird soit déjà installé +* évite de télécharger inutilement une nouvelle fois pour un nouvel utilisateur + +sans changer de session, on peut utiliser, pour un utilisateur titi et un canal beta, par exemple: +```shell +USER_INSTALL=titi getThunderbird u-beta +``` +**attention**: il faut que l'utilisateur souhaité ait déjà un _home/_ + + +## désinstallation d'un canal Thunderbird + +`getThunderbird r-canal` (canal _all_ possible) par exemple, pour la version beta, en **root**: + +```shell +getThunderbird r-beta +``` +```text + _ _____ _ _ _ _ _ + __ _ ___| ||_ _| |__ _ _ _ __ __| | ___ _ __| |__ (_)_ __ __| | + / _' |/ _ \ __|| | | '_ \| | | | '_ \ / _' |/ _ \ '__| '_ \| | '__/ _' | +| (_| | __/ |_ | | | | | | |_| | | | | (_| | __/ | | |_) | | | | (_| | + \__, |\___|\__||_| |_| |_|\__,_|_| |_|\__,_|\___|_| |_.__/|_|_| \__,_| + |___/ + version 1.0.0 - 09/09/2017 + + - thunderbird lié à thunderbird-latest + + thunderbird-beta désinstallé, mais le profil est toujours en place + le supprimer manuellement si nécessaire, pour cela: + fermer toutes les instances ouvertes de thunderbird + et lancer en console, en user: thunderbird -P + +``` + +* le profil pour Thunderbird **n'est pas supprimé**, il sera donc utilisable en cas de réinstallation +* si thunderbird-canal est ouvert il sera fermé +* thunderbird sera aussi configuré pour le plus bas canal installé + + +## installation manuelle d'une archive + +installer une archive téléchargée manuellement +`getThunderbird m-canal` par exemple, pour la Release officielle, en **root**: +```shell +getThunderbird m-latest thunderbird-56.0b3.tar.bz2``` +```text + _ _____ _ _ _ _ _ + __ _ ___| ||_ _| |__ _ _ _ __ __| | ___ _ __| |__ (_)_ __ __| | + / _' |/ _ \ __|| | | '_ \| | | | '_ \ / _' |/ _ \ '__| '_ \| | '__/ _' | +| (_| | __/ |_ | | | | | | |_| | | | | (_| | __/ | | |_) | | | | (_| | + \__, |\___|\__||_| |_| |_|\__,_|_| |_|\__,_|\___|_| |_.__/|_|_| \__,_| + |___/ + version 1.0.0 - 09/09/2017 + + installation manuelle dans beta de thunderbird version 56.0b3 (thunderbird-56.0b3.tar.bz2) + + - décompression... + + - installation... + + - thunderbird lié à thunderbird-latest + + archive thunderbird-beta 56.0b3 installée + +``` + + +## suppression d'un profil Thunderbird + +**FERMER toutes les instances ouvertes** + +**en user**, lancer en terminal le profil manager de Thunderbird: `thunderbird -P` : + +* sélectionner le profil souhaité +* cliquer sur _supprimer un profil_ + * _supprimer les fichiers_, cela supprimera aussi le répertoire `~/.thunderbird/profilSélectionné` + le profil est **définitivement** détruit +* quitter + + +### suppression manuelle de tous les profils + +si plus aucun canal de Thunderbird n'est installé, qu'il n'y a plus de profil manager disponible, et que vous +êtes certains de vouloir supprimer tous les profils en place, en **user**: +```shell +rm -rf ~/.thunderbird +``` + + +## mise à jour script + +```shell +getThunderbird -u +``` +```text + _ _____ _ _ _ _ _ + __ _ ___| ||_ _| |__ _ _ _ __ __| | ___ _ __| |__ (_)_ __ __| | + / _' |/ _ \ __|| | | '_ \| | | | '_ \ / _' |/ _ \ '__| '_ \| | '__/ _' | +| (_| | __/ |_ | | | | | | |_| | | | | (_| | __/ | | |_) | | | | (_| | + \__, |\___|\__||_| |_| |_|\__,_|_| |_|\__,_|\___|_| |_.__/|_|_| \__,_| + |___/ + version 1.0.0b - 09/09/2017 + + version script en cours: 1.0.0b + version script en ligne: 1.0.0, mise à jour possible + + getThunderbird mis à jour en version 1.0.0 + +``` + +* test toutes les **semaines** +* mise à jour du **script** si une nouvelle version est disponible en ligne. cela n'influe pas sur les + canaux Thunderbird installés +* pas de nouvelle version: pas de téléchargement +* cette tâche est exécutée périodiquement par cron/anachron et n'a pas vraiment vocation à être lancée manuellement +* _anacron_ est utilisé, c'est à dire que la mise à jour sera testée, même lors d'arrêts du Pc + + +## vérification + +tous les évènements importants sont consignées dans le fichier _/var/log/sdeb_getThunderbird.log_ +consulter son contenu: +```shell +cat /var/log/sdeb_getThunderbird.log +``` + + +## supprimer le script + +en **root**: +```shell +getThunderbird -r +``` +```text + _ _____ _ _ _ _ _ + __ _ ___| ||_ _| |__ _ _ _ __ __| | ___ _ __| |__ (_)_ __ __| | + / _' |/ _ \ __|| | | '_ \| | | | '_ \ / _' |/ _ \ '__| '_ \| | '__/ _' | +| (_| | __/ |_ | | | | | | |_| | | | | (_| | __/ | | |_) | | | | (_| | + \__, |\___|\__||_| |_| |_|\__,_|_| |_|\__,_|\___|_| |_.__/|_|_| \__,_| + |___/ + version 1.0.0 - 09/09/2017 + + getThunderbird 1.0.0 supprimé du système. + +``` + +* effacement du script dans le système (_/opt/bin_) +* effacement de l'inscription dans crontab/anacron utilisateur +* cela ne **supprime pas** les éventuels canaux Thunderbird installés + + +## sources + +sur [framagit](https://framagit.org/kyodev/kyopages/blob/master/scripts/getThunderbird) + + +## changelog + +sur [framagit](https://framagit.org/kyodev/kyopages/blob/master/scripts/getThunderbird_changelog.md) + + +## contact + +pour tout problème ou suggestion concernant ce script, n'hésitez pas à ouvrir une issue +[Framagit](https://framagit.org/kyodev/kyopages/issues) + +IRC freenode: ##sdeb + + +## license + +[LPRAB/WTFPL](https://framagit.org/kyodev/kyopages/blob/master/scripts/LICENSE.md)