kyopages/docs/scripts/getThunderbird.md

# 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 <zl5s2ga7.default>

  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
      <all> = latest, beta
 
  exemple, installation version Release: getThunderbird i-release
           installation version latest, beta: getThunderbird i-all

  getThunderbird i-canal  : installation de Thunderbird <canal> (<all> possible)
  getThunderbird r-canal  : désinstallation de Thunderbird <canal> (<all> possible)
  getThunderbird u-canal  : ajouter ou configurer un profil Thunderbird pour l'utilisateur en cours
  getThunderbird d-canal  : copier un profil default existant sur <canal>

  getThunderbird m-canal  : installation sur le <canal> 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 <zl5s2ga7.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 <beta> 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)