Documentation dédiée à l'application VHCS  «  

VHCS Documentation - Manuel de l'Administrateur

Posted by M. declercq on Nov. 3 2006, commented by Mazenovi on May 5, (popular)  
Tags: vhcs documentation administrateur

Avant Propos

Cette documentation a été rédigée dans un esprit de pédagogie afin que les nouveaux administrateurs de l'application VHCS puissent passer à la pratique le plus rapidement possible.

Nous attirons votre attention sur le fait que cette documentation n'est pas officielle. Si vous recherchez une documentation officielle concernant l'application VHCS, nous vous invitons à vous rendre sur le site vhcs.net.

Présentation de l'application

VHCS (Virtual Hosting Control System) est une application Open Sources fonctionnant sur les systèmes UNIX. Elle permet la gestion de plusieurs domaines via un seul panneau de contrôl. VHCS est composé de trois rangs d'utilisateur : Les Administrateurs, les Revendeurs et les Utilisateurs. Dans cette partie de la documentation, seule l'utilisation au rang des Administrateurs sera abordée.

Connexion en tant qu'Administrateur

Pour accéder au pannel d'administration de VHCS en tant qu'Administrateur il suffit de taper une Url de type http://www.votredomaine.tld/vhcs2/ dans la barre d'adresse d'un navigateur. Ainsi, une page de connexion apparaît, page dans laquelle il suffit d'entrer ses identifiants pour se connecter :

Les identifiants de l'Administrateur qui est créé par défaut sont ceux que vous avez défini pendant l'installation de l'application VHCS.

Ps : Par défaut, le pseudo de l'Administrateur est admin sauf si vous en avez choisi un autre pendant l'installation.

Informations générales

Lorsque qu'on se connecte en tant qu'Administrateur, on arrive sur une première page, laquelle permet de prendre rapidement connaissance de l'état actuel du Serveur :

A gauche se trouve un menu qui permet d'avoir accès aux divers services proposés et à droite ceux de la page en cours.

Ainsi, dans la première page, nous avons accès à diverses informations notamment :

1. Le nombre d'utilisateurs enregistrés au rang d'Administrateur ;
2. Le nombre d'utilisateurs enregistrés au rang de Revendeur ;
3. Le nombre d'utilisateur enregistrés au rang d'Utilisateur ;
4. Le nombre de domaine gérés par le Serveur ;
5. Le nombre de sous-domaines gérés par le Serveur ;
6. Le nombre d'alias de domaine gérés par le Serveur ;
7. Le nombre de compte de messagerie présents le Serveur ;
8. Le nombre de compte FTP présents sur le Serveur ;
9. Le nombre de bases de données présentes sur le Serveur ainsi que le nombre de ses utilisateurs.

Toutes ces informations ne sont pas nominatives et correspondent simplement à l'état d'utilisation générale du Serveur.

En dessous de ces informations, nous pouvons aussi voir le traffic général du Serveur.

Les menus et les services associés

Comme indiqué ci avant, à gauche du panel d'administration se trouve un menu à partir duquel nous pouvons accéder aux divers services proposés par l'application VHCS. Voici une courte description des divers onglets apparaîssant dans la partie administration de l'application VHCS suivi de leur mode de fonctionnement.

A. Onglet Informations générales :

L'onglet Information Générale est celui à partir duquel nous pouvons prendre connaissance des informations générales concernant le Serveur. Il se divise en sous menu (liens) chacun permettant d'avoir accès à des services différents :

a. Lien Vue d'ensemble :

Il s'agit de la page qui apparaît par défaut lorsqu'on se connecte au panel d'administration de VHCS. Elle permet de prendre connaissance des informations générales concernant le Serveur (cf. ci-dessus).

b. Lien Changer le mot de passe :

En cliquant sur le lien changer de mot de passe, nous avons accès à une nouvelle page qui permet de modifier le mot de passe de l'administrateur actuellement connecté :

c. Lien Changer infos perso :

Le lien changer infos perso permet d'accéder à une nouvelle page à partir de laquelle il est possible d'insérer/modifier nos informations personnelles (Nom, Prénom, adresse...). Ces informations correspondent à l'utilisateur actuellement connecté :

Pour insérer/modifier les informations personnelles, il suffit de remplir les divers champs du formulaire (partie droite) et de valider en appuyant sur le bouton nommé : Mettre les données à jours. Une fois ceci fait, une mention en rouge (Les données personnelles ont été mises à jour avec succès!) apparaît en haut du formulaire, cette dernière indiquant que les changements ont bien été pris en comptes.

d. Lien Multilangue :

Le lien nommé multilangue permet d'avoir accès à une page à partir de laquelle il est possible de changer la langue de l'interface d'administration de VHCS :

Pour importer un fichier langue, il suffit de cliquer sur le bouton Parcourir, d'aller chercher le fichier sur son poste de travail et ensuite, de cliquer sur le bouton Installer.

Pour activer une langue que l'on vient d'importer, il suffit de la selectionner et de cliquer sur enregistrer.

Ps : Sur certaine configuration, pour que l'activation d'une langue importée soit effective, il est nécessaire de la selectionner et l'enregistrer deux fois.

e. Lien Affichage

En cliquant sur le lien Affichage, nous avons accès à une page qui nous permet de personnaliser l'entête du panel d'administration en y ajoutant un logo :

Pour ajouter/modifier un logo, il suffit de cliquer sur le bouton Parcourir, d'aller chercher le fichier (format jpg) sur le poste de travail, et enfin de valider en cliquant sur le bouton Enregistrer.

f. Lien Menus personnalisés :

Ce menu (lien) permet d'avoir accès à une page à partir de laquelle il est possible d'ajouter de nouveaux boutons (onglets) à l'interface d'administration de VHCS. Cela peut être très utile notamment si l'on souhaite installer le logiciel awstats (logiciel de statistiques) et le rendre accessible via un bouton situé sur l'interface d'administration de VHCS (côté revendeur et/ou utilisateur) :

Pour créer un nouveau bouton, il suffit de remplir le formulaire situé à droite de la page :

Nom du bouton : Dans ce champ, il faut simplement indiquer le nom que l'on souhaite attribuer au nouveau bouton. Il s'agira dans la plupart des cas du nom de l'application à laquelle il correspond ;

Lien du bouton : Ici, deux possibilités existents. Soit nous insérons un lien relative (Ex : ../../stats/) soit nous inséront l'url complète menant à l'application (Ex: http://nuxwin.com/stats/).

Cible du bouton : Ce champ permet de définir la fenêtre dans laquelle la page cible de l'application à l'aquelle fait référence le bouton doit s'afficher. Elle permet donc de diriger l'ouverture d'un document cible vers une fenêtre déterminée. Voici les valeurs qui peuvent être utilisées :

_blank : Ouverture de la page cible dans une nouvelle fenêtre ;
_parent : Ouverture de la page cible dans le cadre parent ( de niveau immédiatement supérieur).

Ps : Ces valeurs correspondent en fait à celles de l'attribut target qui est employé dans la balise <a> attribut="valeur"</a>. D'autres valeurs existent mais elles ne sont pas vraiment utiles.

Montrer entrant : Bien que la traduction de ce champ de formulaire ne veuille strictement rien dire, ce dernier est particulièrement intéressant. Il permet de définir sous quel rang(s) d'utilisateur le nouveau bouton doit apparaîtres. Ainsi, si dans le menu déroulant on choisi l'option Niveau des Revendeurs, le bouton ne sera accessible qu'aux Revendeurs, si on choisi l'option Niveau utilisateur, le nouveau bouton ne sera accessible qu'aux Utilisateurs. Enfin, si on choisi l'option Niveau Revendeur et Utilisateur le nouveau bouton sera accessible aux Renvendeur et Utilisateurs.

Une fois tous les champs renseignés, il suffit de cliquer sur le bouton nommé Enregistrer pour que le nouveau bouton soit disponible dans l'interface d'administration de VHCS.

A. Onglet Gérer les utilisateurs :

L'onglet Gérer les utilisateurs permet d'avoir accès aux liens menant aux services de gestion des utilisateurs tous rangs confondu. C'est à partir de cet onglet que l'on a accès aux services qui permettent de créer les nouveaux Administrateurs et Revendeurs, voir quels sont les utilisateurs actuellement connectés au panel d'administration et bien d'autres services encore...

a. Lien Vue d'ensemble :

Le lien Vue d'ensemble de l'onglet Gérer les utilisateur correspond à la page qui apparaît lorsqu'on clique sur ce dernier.

Comme nous pouvons le voir (partie droite), cette page est divisée en trois partie (tableaux) bien distinctes. Chaque tableau correspond en fait à un rang d'utilisateur (Administrateurs, Revendeurs, Utilisateurs).

1. Tableau Administrateur

Le tableau relatif aux Administrateurs permet d'obtenir divers informations les concernant :

1. Le pseudo de chaque Administrateur enregistrés ;
2. Le pseudo de la personne qui les a créé.

A partir de ce tableau, il est possible de supprimer un compte Administrateur en cliquant sur le lien nommé Supprimer qui se trouve complètement à droite de chaque comptes.

Ps : Le premier Administrateur qui a été créer pendant l'installation de l'application VHCS ne peut pas être supprimé et ne contient aucune information concernant son créateur.

2. Tableau Revendeur

Le tableau relatif aux revendeurs propose les mêmes services (date de création du compte en plus) que celui des Administrateur mais n'agit que sur les comptes des Revendeurs. Il propose en outre un lien nommé Changer qui permet à l'Administrateur de se logguer sous le compte Revendeur qui y est associé

3. Tableau Utilisateurs

Le tableau relatif aux utilisateur est un peu plus complexe que les deux précédents dans la mesure ou il dispose d'options supplémentaires :

1. Recherche d'un Utilisateur selon divers critères :

L'option de recherche automatique de comptes Utilisateur permet de ne pas avoir besoin de les chercher manuellement, ce qui pourrait être assez long si l'on avez plus de 100 comptes utilisateurs.

2. Activation/Désactivation d'un compte :

Comme nous pouvons le voir dans la capture d'écran présentée ci-dessus, à droite de chaque compte utilisateur appparaît un petit icône de statut. Cet icône de statut peu prendre 4 formes différentes selon le statut actuel du compte utilisateur qui y est associé :

: Cet icône de statut indique que le compte utilisateur est actif ;
: Cet icône de statut indique que le compte utilisateur est entrain d'être mis à jour. C'est notamment le cas lorsqu'on Active/Désactive un compte ;
: Cet icône de statut indique que le compte utilisateur est désactivé ;
: Cet icône de statut indique qu'il y a une erreur dans la configuration du compte utilisateur. D'une manière générale, si cet icône apparaît, cela provient d'une mauvaise configuration au niveau du fichier vhcs2.conf d'apache qui est soit absent, soit altéré ou mal généné.

Add a comment ·  Trackback

Dexinou on Dec. 4 2006
Excellent comme d'hab

Mazenovi on May 5
Pour un vhcs fraîchement installé y a t il une explication pour que le premier user ajouté mette plusieurs heures à se créer (reste en attente de création)? Peut il y avoir un rapport avec la propagation des dns?

2 comments ·  Add a comment