Table des matières
Kochizz édite de manière visuelle les fichiers utilisés pour le paramètrage des serveurs Web Apache. Dans une certaine mesure, il peut servir aussi à contrôler l'état des instances locales, permettant par exemple de recharger une configuration modifiée sans quitter l'éditeur. Kochizz est libre, multiplates-formes, et extensible; mais gardez à l'esprit qu'il ne s'agit que d'une première version dont l'étendue des fonctionnalités pourra évoluer en fonction des besoins et des demandes de ses utilisateurs.
Le but premier de Kochizz est de proposer une édition visuelle confortable des configurations Apache, permettant :
-
De visualiser facilement l'arborescence des directives telle qu'elle est traitée par Apache,
-
D'effectuer rapidement des opérations d'édition sur les fichiers, incluant l'ajout et la suppression de branches entières de directives, l'activation ou la désactivation de blocs de commandes, le déplacement par glisser-déposer de directives...
-
De contrôler la validité des directives (et, au sens plus général, d'une configuration entière), à la fois sur leur valeur et leur position dans le fichier en fonction du contexte courant,
-
Dans une moindre mesure, de s'interfacer avec les outils d'Apache, offrant la possibilité de tester une configuration ou de démarrer/arrêter un serveur.
Kochizz fonctionne dans les deux sens : il analyse des fichiers existant, construit une représentation visuelle de leur contenu, et peut les regénérer si des modifications leur sont apportées. Le logiciel suit également les documents éventuellement inclus afin que la vue affichée représente la configuration dans sa globalité.
Kochizz ne fournit pas d'assistant permettant de créer ou de modifier une configuration Apache sans manipuler les directives qui composent ses fichiers de configuration. Une connaissance minimale du fonctionnement et du paramètrage d'Apache est requise afin de pouvoir exploiter le logiciel. Kochizz reste un éditeur graphique et non un super-assistant géant capable de repasser vos chemises.
Kochizz n'est pas exigeant en mémoire ou en espace disque. Tout PC étant équipé d'une configuration standard devrait pouvoir faire fonctionner le logiciel. Il n'est pas de plus nécessaire d'installer Apache pour pouvoir faire fonctionner le logiciel.
Kochizz fonctionne sous Linux, Microsoft Windows, et Mac OS X. Il est possible qu'il soit compatible avec d'autres systèmes basés sur Unix (tels FreeBSD), mais ceux-ci n'ont pas été testés.
Sous Windows, l'installation se fait en utilisant le programme fourni. L'installateur copie par défaut les fichiers dans le répertoire Program Files et ajoute un raccourci dans le menu Démarrer afin que vous puissiez démarrer facilement Kochizz. L'installateur nécessite les droits administrateur pour fonctionner correctement.
Sous Linux/Mac OS, après décompression de l'archive dans un répertoire, lancer le script shell "kochizz.sh" pour démarrer l'application.
Des scripts shell pour UNIX et Mac et batch pour Windows sont disponibles à la racine du paquetage des sources ("prepare*install*). Ils doivent être édités à la main pour configurer les variables en début de script; et génèrent les paquetages de binaires et leurs dépendances (aide du logiciel, aide de Apache...). La compilation simple de l'exécutable Kochizz est réalisée par les scripts "makeKochizz-*" du répertoire "src". La compilation nécessité la pré-installation de QT4.3.0 au minimum. La génération de l'aide HTML nécessite un processeur XSLT et les feuilles XSLT de transformation DocBook to HTML.
Kochizz n'a pas besoin de droits spéciaux pour être utilisé. Néanmoins, les opérations suivantes peuvent devoir être exécutées dans un compte utilisateur particulier :
-
Lorsque vous ouvrez des fichiers utilisés par Apache, ceux-ci doivent être accessibles en lecture afin d'être analysés par le logiciel.
-
Lorsque vous regénérez la configuration courante, vous devez possèder assez de droits pour écrire dans les répertoires qui la contiennent. Par exemple, sous Debian, un utilisateur lambda ne peut pas écrire dans /etc/apache2, l'application doit être lancée sous l'identité de l'utilisateur root grâce à la commande sudo. Toutefois, le script "kochizz.sh", qui sert à localiser les dépendeances de librairies (selon la méthode préconisée par Qt), ne fonctionne a priori pas quand il est lancé avec "sudo". Veuillez donc ouvrir une sesison "root" dans ce cas où résoudre manuellement les dépendances de librairies avant de lancer directement le binaire.
-
Lorsque vous pilotez le serveur, l'arrêt et le démarrage de celui-ci nécessitent également des droits élevés et nécessitent également dans la majorité des cas de démarrer le logiciel dans un contexte administrateur.
Kochizz manipule les objets suivants, dont on peut retrouver la dénomination dans les menus et les dialogues affichés par le logiciel :
-
Des "fichiers de configuration" sous leur forme "brute", c'est à dire des fichiers texte comportant des directives reconnues par Apache (le plus souvent, d'extension "*.conf").
-
Des "configurations Apache", c'est-à-dire un ensemble de règles indiquant quelles directives sont valides, et dans quel contexte pour une version donnée du serveur. Ces règles sont construites d'une part en analysant les fichiers de configuration utilisés par les développeurs pour générer la documentation d'Apache, d'autre part en lisant un fichier propre à Kochizz raffinant les descriptions de certaines directives. Kochizz permet d'enregistrer plusieurs configurations : elles peuvent être exploitées lorsque un fichier ou un ensemble de fichiers doivent être ouvert et affichés à l'écran.
-
Des "serveurs", c'est à dire un jeu de fichiers nommé correspondant généralement à un serveur exploité en local, qui peut être contrôlé de manière minimale si besoin (démarrage, arrêt, etc.)
Vous n'avez pas besoin de créer une configuration Apache ni un serveur pour exploiter Kochizz. Vous pouvez exploiter le logiciel "à vide" en vous contentant de l'utiliser pour lire et écrire des fichiers de configuration unitaires. Vous ne bénéficierez pas dans ce cas de fonctionnalités de contrôle et d'aide à la saisie. Pour exploiter le plein potentiel de Kochizz, nous vous recommandons donc de parcourir la suite de ce document afin que vous puissiez découvrir comment gérer des serveurs et des configurations Apache.