Le serveur Pitux centralise la gestion de toutes les machines Pitux existantes. Pour cela, il utilise un ensemble de programmes et de fichiers dont vous trouverez la description ici.
fgaliegue-fom@pitux.com

Les deux répertoires de travail du système Pitux

Pitux utilise deux répertoires de travail :

• le répertoire principal, /pitux/ConfClient ;
• un sous-répertoire dans le répertoire personnel ($HOME) du revendeur, $HOME/ConfClient.

Fichiers types

Les fichiers types se trouvent dans le répertoire type/. Ils matérialisent des configurations de machines Pitux complètes ou bien de modules isolés. Dans ces fichiers, on trouve des références par leurs noms à un ou plusieurs fichier(s) de définition, vus ci-dessous, qui décrivent complètement un module.

Les fichiers types prédéfinis par Pitux, dans /pitux/ConfClient/type, représentent pour la grande majorité un module bien particulier (squid pour un cache web, par exemple). Dans ce cas, le fichier de définition référencé aura pratiquement toujours le même nom que le fichier type, mais ce n'est pas toujours le cas. Une configuration complète de machine sera un fichier type ayant le contenu de plusieurs de ces fichiers types unitaires.

Il existe quelques configurations complètes prédéfinies, toujours dans le même répertoire, qui commencent par pX-. Par exemple, le fichier type pX-adsl peut vous servir de base pour la configuration d'une machine disposant d'une connexion ADSL.

Une description du format de ces fichiers peut être trouvée ici.

Fichiers de définition

Ces fichiers se trouvent dans le répertoire type/dependances. Ils décrivent complètement un module en donnant une liste de leurs fichiers de configuration, avec éventuellement une liste de paquetages RPM nécessaires à leur fonctionnement, des commandes à exécuter pour sa bonne mise en place, et enfin une liste des fichiers de paramètres (décrits ci-dessous) à remplir pour configurer le module.

Vous pouvez trouver une description du format des fichiers de définition ici.
fgaliegue-fom@pitux.com

Fichiers de paramètres

Ces fichiers sont dans le répertoire m4param. Ils contiennent les paramètres qui doivent être remplis pour la bonne opération d'un module. Ils sont référencés depuis les fichiers de définition.

Remplir les variables de ces fichiers de paramètres est la seule partie visible du système lorsque l'on crée une configuration, c'est pourquoi une liaison directe est faite dans la Description des fichiers types entre les fichiers types et les fichiers de paramètres. Un fichier type demande en effet de remplir certains paramètres, mais c'est par l'intermédiaire d'une référence à un ou plusieurs fichier(s) de définition qui eux-mêmes contiennent (éventuellement) des références à un ou plusieurs fichier(s) de paramètres.

Vous pouvez trouver une description du format des fichiers de paramètres ici.
fgaliegue-fom@pitux.com

Fichiers modèles

L'arborescence des fichiers modèles se trouve dans le répertoire m4scripts. Il s'agit des fichiers de configuration tels qu'ils se trouveront dans la machine Pitux et référencés dans les fichiers de définition, avant traitement par le système Pitux. Vous pourrez donc y voir des références à des variables m4, parfois même dans le nom du fichier lui-même.
fgaliegue-fom@pitux.com

Les programmes du système Pitux

Tous les programmes du système Pitux (create-config, etc) se trouvent dans le répertoire /pitux/bin. Ils ne sont pas directement appelables. Des alias du même nom sont créés pour chaque compte revendeur qui font appel à ces programmes via l'utilitaire sudo.

Chacun de ces programmes est documenté par une page de manuel sur le serveur Pitux. Une retranscription de ces pages de manuel peut être trouvée ici.
fgaliegue-fom@pitux.com

Les RPM

Certains modules réclament l'installation de paquetages supplémentaires sur la machine Pitux. Le format de paquetage utilisé est RPM. Une section est dédiée à la gestion des RPM et précise leur emplacement : voyez ici.
fgaliegue-fom@pitux.com