Usage distant

Affichage distant X11

En tant qu'application cliente X-Window, manitou peut s'exécuter sur une machine et s'afficher sur une autre dans la mesure où cette dernière fait tourner un serveur X11 qui accepte la connexion.
La redirection de l'affichage est réalisée avec l'option -display en ligne de commande.
Exemple: 

$ manitou -display workstation1:0

Tunnel SSH

Comme manitou est aussi une application cliente SQL, elle peut tourner localement sur un poste de travail et se connecter en distant à la base de données PostgreSQL contenant le mail. Toutefois pour des raisons de sécurité, les serveurs de base de données ne sont souvent accessibles que de leur réseau proche.

En étant autorisé à utiliser ssh pour le connecter à une machine du réseau local ou au serveur de base de données lui-même, un tunnel ssh peut être mis en place en suivant les deux étapes suivantes:

1) se connecter avec ssh à une machine qui soit elle-même autorisée à se connecter au serveur PostgreSQL, en spécifiant un relai d'un port local vers le port TCP distant utilisé par postgres, par exemple: 

ssh machine.domain.tld -L3333:pgserver.domain.tld:5432
En utilisant cette commande, ssh relaie les paquets TCP de localhost:3333 vers machine.domain.tld à l'intérieur de sa propre connexion sécurisée, puis du côté distant, de la machine.domain.tld à pgserver.domain.tld:5432.
3333 est un port choisi arbitrairement, cela pourrait être n'importe quel port TCP disponible sur la machine locale. Also machine.domain.tld can be pgserver.domain.tld if you can and want connect via ssh to the database server directly instead of a satellite machine. In any case, leave the ssh connection open until you quit the manitou user interface.

Under MS-Windows, putty is a popular free ssh client that allows tunneling.

2) run manitou locally with localhost as the database server and 3333 as the port number. Example: 

manitou --dbcnx "host=localhost port=3333 dbname=....." [other options]

Note that this way of connecting remotely through a ssh tunnel work in the general case, not just for accessing a Manitou-Mail database. See the PostgreSQL manual, that has dedicated page on this topic, or the ssh manual for more explanations or troubleshooting hints.