Table des matières
Pour ajouter, supprimer ou modifier des serveurs dans Kochizz, utilisez le gestionnaire de serveurs accessible en utilisant le sous menu "Gérer les serveurs" dans le menu "Serveurs". Vous pouvez aussi cliquer une fois sur la bouton dont l'icône est une plume Apache dans la barre d'outils. Le dialogue de gestion des serveurs est affiché :
Si vous voulez modifier un serveur existant, double-cliquez sur son nom ou sélectionnez-le puis cliquez sur "Editer". Si vous voulez supprimer un serveur, sélectionnez-le puis cliquez sur "Supprimer". Vous pouvez aussi créer un nouveau serveur en cliquant sur "Ajouter".
Lorsque vous créez un nouveau serveur ou que vous éditez un serveur existant, vous devez entrer :
-
Dans l'onglet "Paramètres généraux", un nom de serveur, le chemin d'accès au fichier de configuration principal et éventuellement la configuration avec laquelle il est liée.
-
Dans l'onglet "Contrôle du serveur", vous pouvez renseigner les champs servant à définir les paramètres d'interfaçage avec le serveur. Sous Windows, le contrôle du service et la dialogue avec Apache sont deux opérations différentes, comme ceci est détaillé à la section suivante. Vous devez donc saisir en plus l'identifieur du service ainsi que le poste sur lequel il fonctionne (si celui-ci est démarré sur le poste local, utilisez ici une valeur vide). Dans tous les cas, vous devez aussi entrer le chemin d'accès à l'application "dialoguant" localement avec Apache, afin de vérifier si la configuration est correcte. Sous Unix, cette application est également utilisée pour contrôlée le serveur local (sous cet OS, les serveurs distants ne sont donc pas pilotables).
A titre d'information, avec Apache 2, le nom d'instance de service Windows est "Apache2" et l'application de contrôle "apache2ctl".
-
Dans l'onglet "Autres", vous pouvez enfin décider de charger le serveur au démarrage de Kochizz en cochant la case correspondante.
Notez que pour enregistrer facilement un serveur, vous pouvez directement utiliser l'article de menu de ce nom ou cliquer sur le bouton de la barre de menus affichant une croix verte.
Une fois qu'un serveur a été enregistré, il peut être chargé facilement en utilisant le menu "Charger un serveur existant" du menu" Serveurs". Les serveurs apparaissent nommés par la chaîne fournie lors de leur enregistrement :
Les méthodes d'interfaçage sont différentes sous Windows et sous Unix (Linux et Mac OS X) :
-
Sous Unix, l'application de contrôle (apache2ctl avec Apache2, par exemple) permet de piloter l'instance locale à Apache. L'utilisation de cette unique application permet donc d'intéragir avec le serveur local, pour, par exemple, vérifier la validité de la configuration actuelle ou redémarrer le serveur.
-
Sous Microsoft Windows, le serveur Apache est implémenté comme une application service, qui peut être contrôlée depuis un autre poste si les droits réseau assignés à l'utilisateur sont suffisants. Certains packs de ressources installent Apache comme une application console et non une application service, ce type de logiciel ne fonctionnant pas sous Windows 95, 98 et Me. Kochizz ne supporte PAS le pilotage d'Apache dans un tel mode de fonctionnement, l'utilisation du serveur en mode non service étant vivement déconseillé par les développeurs.
Par conséquent, vous devrez entrer deux types de données si vous utilisez cet OS: d'une part, les paramètres d'accès au service, pour contrôler n'importe quel serveur Apache installé sous Windows accessible depuis votre poste, d'autre part, le chemin d'accès à l'application permettant d'intéragir pleinement avec l'instance locale. Si vous vous interfacez avec un serveur distant, n'utilisez pas cette application de contrôle; pour l'instant, apachectl ne permet pas de s'interfacer avec autre chose qu'un serveur local.
Notez que sous Windows et Unix, le changement d'état du serveur nécessite des droits étendus. Vous devrez certainement lancer l'application en tant que root (Unix) ou administrateur (Windows) afin que l'utilisation des fonctions de changement d'état fonctionnent.
Une fois les applications de contrôle correctement associées à un serveur comme vu précedemment, vous pouvez :
-
Vérifier si la configuration du serveur local est correcte, en cliquant sur l'item de menu "Vérifier la configuration courante" :
Si le serveur n'a pas renvoyé d'erreur, Kochizz vous le signalera. Sinon le logiciel vous reportera le status de l'analyse. Soit la configuration ne contient que des avertissements, non pénalisants et ne perturbant pas le fonctionnement général du logiciel - dans ce cas, Kochizz vous proposera leur descriptif tel renvoyé par l'application:
En cas d'erreur, Kochizz affichera de la même manière un descriptif de l'erreur, et permettra de positionner le focus à l'endroit du fichier ou l'erreur est détectée :
-
Affiche l'hôte virtuel courant ou tous les hôtes virtuels, en utilisant les articles de menu "Tester tous les hôtes virtuels" ou "Tester l'hôte virtuel courant". Les sites hébergés par le serveur seront ouvert dans le navigateur par défaut.
-
Enfin, il est possible de contrôler le serveur (l'instance locale sous Unix, et un possible poste du réseau local sous Windows - selon les paramètres configurés) en utilisant les icônes et les sous-menus du menu "Serveur" :
-
"Démarrer le serveur" lance le serveur Apache s'il n'était pas déjà démarré,
-
"Stopper le serveur" arrête le serveur Apache,
-
"Arrêter proprement le serveur" arrête le serveur dans un mode spécial permettant de ne pas couper brutalement l'accès aux ressources aux clients. Cette fonctionnalité n'est pas disponible sous Windows.
-
"Redémarrer le serveur" redémarre le serveur Apache
-
"Redémarrer le serveur proprement" redémarre le serveur Apache en préservant les sessions afin que l'opération ne perturbe pas la qualité de service du logiciel. Cette fonctionnlité n'est pas disponible sous Windows.
En cas d'erreur, Kochizz vous affichera le message renvoyé par le gestionnaire de service (sous Windows) ou l'application de contrôle (sous Unix).
-
L'aide contextuelle est tirée du projet Apache-doc. Cette section vous permettra de configurer cette aide pour qu'elle corresponde au mieux au serveur édité, et d'affiner l'aide manuellement si besoin est.
Kochizz se base sur la documentation Apache pour afficher des bulles d'aide et proposer les directives adéquates selon le contexte d'édition. La documentation Apache est spécifique à une version de serveur donnée : pour télécharger celle qui correspond au serveur que vous désirez configurer, rendez-vous sur "http://svn.apache.org/repos/asf/httpd/httpd/tags/#VERSION_DESIREE#/docs/manual/", où vous replacerez "#VERSION_DESIREE#" par la version d'Apache voulue, et téléchargez le répertoire "mod" (par SVN idéalement). Ce répertoire contient la documentation au format XML utilisée par Kochizz,a insi que des fichiers HTML générés à partir de ces fichiers XML. Créez ensuite une configuration sous Kochizz en indiquant le répertoire téléchargé.
La documentation par défaut fournie par Apache-doc peut être surchargée par un fichier dont le format est propre à Kochizz. Le format de ce fichier est définie par un schéma XML contenu dans le fichier "directivesConf/ApacheConf.xsd" et les fichiers de surcharge disponibles sont dans les répertoires du même niveau, classés selon leur langue. Le fichier de surcharge est indispensable pour gérer les contraintes hiérarchiques entre les directives Apache ("Directory" ne peut être inclut dans "File" par exemple), et permet également de surcharger les définitions et les descriptions de paramètres de chaque directive si ceux analysés dans la documentation Apache ne conviennent pas. Ce fichier est pour l'instant uniquement disponible en langue anglaise, mais peut-être utilisé sans problème avec de la documentation en autre langue.