Contents Next

Général

1 ISPConfig c'est quoi ?

ISPConfig eqt unz suirz logicielle qui permet l'administration de serveurs, espaces web, revendeurs et les virtual hosts (sites).

ISPConfig contient 3 niveaux:

2 Termes et structure du manuel

Correspondant aux 3 niveaux, le manuel est divisé en 3 chapitres:

Note: Cette structure ne veut pas dire que chaque sections est indépendante des autres. Le niveau I contient les niveaux II et III et le niveau II contient le niveau III.
Pour une meilleure vue d'ensemble les manuels I et II incluent des liaisons aux applications qui sont disponibles dans les sous-niveaux respectifs où ils sont décris en détail.

3 Installation/Mise à jour/Désinstallation

3.1 Installation

Pour installer ISPConfig lisez s'il vous plaît le manuel d'installation.Ce manuel est disponible dans le format suivant : HTML.

3.2 Mise à jour

Vous pouvez mettre à jour ISPConfig à la version supérieure si ces versions sont de la même version principale (e.g. 1.x; ex., vous pouvez mettre à jour la version 1.1.12 vers la version 1.2.0). Télécharger la version souhaitée d'ISPConfig sur votre serveur et proceder à une nouvelle installation, pas à une mise à jour. La routine d'installation vous notifieras qu'une version d'ISPConfig est déjà installé sur le serveur et elle éxecuteras les étapes nécessaires à la mise à jour.

3.3 Désinstallation

Si vous souhaitez désinstaller ISPConfig, connectez vous à votre serveur comme root et éxecutez la commande suivante : /root/ispconfig/uninstall Le désintallateur vous demanderas de choisir parmis les options suivantes :

4 Connexion et Déconnexion

La connexion au système ISPConfig est décrite dans les manuels réspectifs (chapitre 1.1 des manuels I - III).

Pour se déconnecter, cliquer sur "Déconnexion" dans le menu.

 

I Manuel Administrateur

1 Général

1.1 Connexion et Mot de Passe

Allez sur l'URL d'ISPConfig (e.g. https://www.domain.tld:81 or http://www.domain.tld:81; remplacer "www.domain.tld" convenablement) avec votre navigateur et entrer votre nom d'utilisateur et votre mot de passe dans le formulaire "Login". Confirmez en cliquant sur "Login".


1.2 Interface ISPConfig pour les Administrateurs Serveur

L'interface administrateur est constitué des séctions suivantes :


1.3 Privilèges pour les Administrateurs Serveur dans ISPConfig

Les privilèges d'un administrateur ISPConfig inclus inclus ceux d'un revendeur et d'un client, i.e. en tant qu'administrateur vous pouvez executer des actions appartenant à un revendeur ou à un client sans avoir à vous identifier comme tel.

Privilèges d'un administrateur ISPConfig
  • Modifier les paramètres serveur.
  • Créer et gérer des revendeurs, voir leurs statistiques
  • Créer des sauvegarde de la base de données d'ISPConfig
  • Editer les entrées DNS

Privilèges d'un revendeur

  • Créer et gérer des clients, voir leurs statistiques
  • Créer et gérer des sites web
  • Créer des entrées DNS

Privilèges d'un client

  • Voir les données de base d'un site ainsi que ces statistiques
  • Créer et gérer des utilisateurs et des boites mail
  • Créer et gérer des (sous)domaines
  • Demande de certificats SSL (option)
  • Gérer les accès à MySQL

Privilèges d'un utilisateur

  • Modifier les paramètres de sa boite mail (mot de passe, paramètres du filtre anti-spam et de l'anti-virus)

1.4 Sauver

Le système ISPConfig vous offre deux possibilités de sauver les données entrées dans un formulaire :

1.5 Changer votre mot de passe ISPConfig

Vous pouver changer votre mot de passe ISPConfig dans "Outils" -> "Changer de Mot de Passe".

Entrer votre mot de passe actuel et votre nouveau mot de passe (2x) dans le formulaire "Changer de Mot de Passe " et cliquer sur "Save".

1.6 Paramètrage de la Langue

Vous pouvez modifier la langue du système ISPConfig dans "Outils" -> "Changer la Langue".

Dans le formulaire "Changer la Langue" choississez la langue que vous souhaitez utiliser et cliquer sur "Sauver".

Note: Le paramètrage de la langue affecte uniquement votre compte. Les autres utilisateurs du système ISPConfig (comme les revendeurs ou les clients) peuvent choisir leur langue individuellement.

1.7 Affichage des mots de passe dans le Système ISPConfig

Les mots de passe saisis dans ISPConfig (e.g. les mots de passe revendeurs ou client pour accéder au système ISPConfig; mot de passe pour les bases de données MySQL) ne sont pas affiché dans ISPConfig une fois qu'ils ont été sauvé pour des raisons de sécurité! Ainsi, un champ de mot de passe vide dans un formulaire ISPConfig ne veut pas dire qu'aucun mot de passe n'a été entré auparavant.

Un mot de passe existant n'est pas affiché après la validation de son formulaire respectif.

1.8 Aide

Cliquer sur le'élément de menu "Aide".

Ici vous trouverez le manuel administrateur, revendeur et client en Allemand, Anglais et Français au format PDF ainsi que des liens à la Base de connaissance sur le site web de Projektfarm.

En plus de cela vous pouvez trouver un point d'interrogation à côté de beaucoup de champs d'entrée dans le système ISPConfig :

Si vous cliquez sur le point d'interrogation, un petit pop-up contenant une aide contextuelle s'ouvriras.

 

2 Paramètres Généraux

2.1 Paramètres Serveur (Logiciels)

Selon votre serveur certains paramètres sont remplis automatiquement au moment de l'installation d'ISPConfig. Certains paramètres doivent être renseignés manuellement :

Pour voir les paramètres généraux ou pour faire des modifications, cliquez sur "Administration", ouvrez le dossier "Serveur" et cliquez sur le document "Paramètres".

2.2 Statut du Serveur (Matériel et Statistiques)

Les données matérielles de votre serveur sont chargées dans ISPConfig lors de l'installation. De plus ISPConfig system donne certaines informations sur l'état et l'utilisation du serveur. Ces informations sont visiblent à 2 endroits :

Dans le champ "Statut Serveur" qui s'affiche après votre connexion ou en cliquant sur "Gestion ISP". Il est aussi visible dans "Administration" dans le dossier "Serveur" puis cliquer sur "Statut".

Les informations suivantes sont disponible :

2.3 Sauvegarde de base de données

Les données de tous les revendeurs, clients, sites, domaines, utilisateurs et adresses e-mail sont enregistrés dans la base de données d'ISPConfig. C'est pourquoi il est fortement recommandé de faire une sauvegarde régulière, vérifier, optimiser et - si nécessaire - réparer la base de données.

Voici comment accéder aux fonctions de la base de données :

Cliquez sur le menu "Administration".


Dans l'arbre, cliquez sur "Base de données ISPConfig".

2.4 Services (Surveillance et Pare-Feu)

ISPConfig vous permet de démarrer/arreter/relancer des services, de surveiller l'état des services (si un service surveillé tombe en panne, un e-mail d'avertissement est envyé à l'administrateur; voir chapitre I-2.1, "E-Mail de l'Admin") et de configurer le pare-feu (dans le cas où iptables ou ipchains est installé sur votre serveur).

Cliquez sur "Administration" -> "Serveur" -> "Services". Le formulaire "Services ISP" s'ouvre avec les onglets "Services", "Surveillance" et "Pare-Feu".

2.4.1 Démarrer/Arrêter/Redémarrer les Services

Sur l'onglet "Services" vous pouvez voir le statut des plus important services du serveur (online/offline), et vous avez la possibilité de démarrer/arrêter/redémarrer ces services. Pour confirmer vos changements, cliquez sur "Sauver" ou en allant sur un autre onglet (voir chapitre I-1.4 "Sauver").

2.4.2 Surveillance de Services

Sous "Surveillance" vous pouvez spécifier les services à surveiller par ISPConfig. Les paramètres par défaut sont de surveiller "Web-Server", "FTP-Server" et "MySQL-Server". La vérification est effectuée toutes les 30 minutes. Si un service est en erreur, un email est envoyé à l'administrateur (voir chapitre I-2.1, "E-Mail de l'Admin").

Note : Si votre serveur mail est en erreur, aucun mail ne pourras être envoyé à l'administrateur!

Voici comment créer une nouvelle surveillance de service :

Cliquez sur le bouton "Ajouter".

Le formulaire "ISP Monitor" est chargé.

Entrez les informations suivantes :

Puis cliquez sur "Sauver", ou changez d'onglet.

Dans l'onglet "Actions" vous pouvez entrer la commande shell qui seras executée si le service correspondant est hors-ligne (e.g. une commande pour redémarrer le service) :

Une fois les informations enregistrées les services qui sont surveillés sont listés dans le tableau "Services ISP" dans l'onglet "Surveillance" et peut être modifié ici.

2.4.3 Pare-Feu

Dans l'onglet "Pare-Feu" vous pouvez ajouter ou éditer des règles de pare-feu. Le Pare-Feu est actif uniquement si vous l'avez démarré dans l'onglet "Services". Par défaut le Pare-Feu est inactif.

Quelques règles de pare-feu sont implementée dans ISPConfig par défaut :

Il y à deux états possible :

  1. Un port (et donc le service l'utilisant) est accessible de l'extérieur et n'est pas bloqué par le pare-feu : "oui" est donc affiché dans la colonne "Actif".
  2. Un port n'est pas accessible de l'extérieur et il est bloqué par le pare-feu : C'est le cas des ports avec "non" affiché dans la colonne "Actif" et aussi pour tous les autres ports non listé ici !

Les règles existantes peuvent être modifiées en cliquant sur leur nom ; le boutton "Ajouter" vous permet d'en créer de nouvelles.

Les informations suivantes sont nécessaires :

Note: Pour empêcher que le serveur soit inaccessible de l'extérieur à tous (même pour l'administrateur) le système ISPConfig vous laisse bloquer tous les ports sauf le port 22 (SSH) et le port 81 (ISPConfig)! Si vous tentez de bloquer ces ports, Le système ISPConfig l'ignoreras !

2.5 Gestionnaire de mise à jour

Le gestionnaire de mise à jour est accessible via "Administration" -> "Gestionnaire de mise à jour" -> "Mise à Jour". Cette interface vous facilite l'installation des mise à jour et outils pour ISPConfig fournis par Projektfarm GmbH comme le webmail, phpMyAdmin.

Il y à deux possibilités de mise à jour :

  1. Vous télécharger la mise à jour à partir du site de Projektfarm sur votre disque dur local. Vous choisissez "Upload", selectionner le fichier avec le bouton "Parcourir..." dans le champ"Fichier" et cliquez sur "Lancer l'Installation". Le champ "URL" est ignoré ici.
  2. Vous installez la mise à jour directement depuis le site de Projektfarm. Vous choisissez donc "URL" et entrez l'URL du fichier de mise à jour dans le champ "URL". Cliquez sur "Lancer l'Installation".

Si Projektfarm GmbH fournis un MD5 avec la mise à jour, copiez le dans le champ "MD5". ISPConfig compare le "vrai" MD5 (celui que le système calculeras à partir du fichier) avec le MD5 que vous avez fournis afin de vérifier l'intégrité de la mise à jour. Si les MD5s diffèrent la mise à jour ne seras pas installée.

3 Revendeurs

La gestion des revendeurs se fait par l'arbre de structure. Chaque revendeur est présent deux fois :


3.1 Ajouter un Revendeur

L'ajout se fait en 5 étapes.

1. Etape : Ouvrir la page "Revendeur ISP"

Cliquez sur le bouton "Nouveau revendeur".

L e formulaire "Revendeur ISP" s'affiche avec l'onglet "Données Principales ".


2. Etape : Donner un titre, un dossier et les données principales

3. Etape : Limite d'espace, de sites, d'utilisateurs et de domaines

Cliquez sur l'onglet "Limites".


4. Etape : Entrer les informations d'accès du revendeur (utilisateur et mot de passe)

Cliquez sur l'onglet "Données d'Identification".


5. Etape : Enregistrement

Cliquez sur "Sauver".

3.2 Modifier les donnés Revendeur

Ouvrir le dossier "Revendeur" dans l'arbre d'ISPConfig et cliquez sur le revendeur que vous souhaitez modifier. Le formulaire "Revendeur ISP" apparait. Modifier les informations puis cliquez sur "Sauver".

4 Fonctions des Revendeurs

4.1 Clients

Vous avez un aperçu des revendeurs et de vos clients en regardant l'arbre de structure :


Les fonctions affectant les clients peuvent être effectuées par les revendeur dans le niveau revendeur d'ISPConfig. Nous ne les verrons donc que brièvement. Apprenez en plus en lisant le Manuel Revendeur.

Les actions suivantes peuvent être réalisées :

4.2 Gestion des Sites

La gestion des sites administrateur se fait via le dossier "Sites". Les sites revendeurs via le sous-dossier "Sites" du dossier revendeur.

Les fonctions liées aux sites peuvent être effectuées par des revendeurs et dans une certaine mesure par des clients. En voici une courte liste.

Niveau Revendeur :

Niveau Client :

4.3 Entrées DNS

4.3.1 Créer des entrée DNS (voir le Manuel Revendeur)

Une entrée DNS d'un site ou un alias de domaine est créé comme suit :

1. Etape : Ouvrir le formulaire du Site.

Dans l'arbre de structure cliquez sur le client , allez sur l'onglet "Gestion de Sites " et cliquez sur l'adresse IP du site correspondant.

Ou :

Ouvrir le site correspondant dans l'arbre.

2. Etape : Ouvrir un alis de domaine et l'activer (optionel).

Allez sur l'onglet "Alias de Domaine" et cliquez sur l'adresse IP de l'alias.



3. Etape : Activer le DNS.

Cocher "Créer les DNS" et "Créer l'enregistrement MX".


4. Etape : Sauver.

Cliquez sur "Sauver".

Maintenant le site est visible comme nouvelle entrée dans "Gestion DNS".

4.3.2 Entrée DNS Secondaire (Zone Esclave)

Voici comment créer une Entrée DNS Secondaire (Zone Esclave) :

1. Etape : Ouvrir le formulaire de zone Esclave

Cliquer sur "Nouvel Esclave ".

2. Etape : Créer la Zone Esclave

3. Etape : Sauver

Cliquez sur "Sauver".

4.3.3 Modifier les entrées DNS .

Voici comment faire :

Cliquez dans le menu sur "Gestion DNS".

Dans l'arbre cliquez sur l'entrée DNS à modifier.

5 Statistiques

Les statistiques d' ISPConfig regroupe les information concernant l'utilisation de l'espace disque et du trafic.

5.1 Statistiques Revendeurs

En choisissant le revendeur dans l'arborescence (en tant qu'administrateur ISPConfig) vous pouvez voir les statistiques du revendeur.

Dans le formulaire "Revendeur ISP" (sous l'onglet "Statistiques") vous trouverez les informations de trafic concernant les sites, email et FTP du revendeur, réparti selon les clients du revendeur.


5.2 Statistiques Clients

Elles peuvent être vues par le revendeur correspondant comme décris au chapitre II-5.1.

5.3 Statistiques des Sites

Elles peuvent être vues par le revendeur correspondant comme décris au chapitre II-5.2.

5.4 Statistiques Webalizer

Les statistiques Webalizer peuvent être vues par le revendeur correspondant comme décris au chapitre II-5.3.

6 Web-FTP/Protection de Répertoires (.htaccess/.htpasswd)

Le Web-FTP est vu en détail dans le chapitre III-4.

7 Logiciels Complémentaires

Les logiciels suivant sont disponibles pour ISPConfig :

Ils sont disponibles gratuitement sur le site d'ISPConfig et sont à installer en utilisant le "Gestionnaire de Mise à Jour " (voir chapitre I-2.5). Après l'installation vous trouverez un lien vers ces logiciels sous "Outils".

7.1 Webmail

L' application utilisé s'appelle "Uebimiau". Plus d'informations sont disponible sur le site du projet Uebimiau : http://uebimiau.sourceforge.net/ .

Cette application est accessible par le lien placé sous "Outils" ou par le dossier "webmail" qui se situe dans le site web de votre système ISPConfig, soit https://www.domain.tld:81/webmail/ où www.domain.tld doit être remplacé convenablement.

7.2 phpMyAdmin

Plus d'informations à propos de phpMyAdmin sont disponible sur http://www.phpmyadmin.net/ .

Cette application est accessible par le lien placé sous "Outils" ou par le dossier "phpmyadmin" qui se situe dans le site web de votre système ISPConfig, soit https://www.domain.tld:81/phpmyadmin/ où www.domain.tld doit être remplacé convenablement.

Annexe

1 Démarrer/Arrêter le système ISPConfig

ISPConfig peut être démarrer/arrêter manuellement par une ligne de commande. Connecter vous à la ligne de commande en tant que root et executer les commandes suivantes :

/etc/rc.d/init.d/ispconfig_server start|stop|restart (RedHat et Mandrake)

ou

/etc/init.d/ispconfig_server start|stop|restart (SuSE et Debian).

2 Démarrer/Arrêter vsftpd

Si vous utilisé vsftpd comme serveur FTP ce service n'est plus lancé par inetd/xinetd après l'installation d'ISPConfig mais par ispconfig_tcpserver qui est installé par le système ISPConfig. Cela permet de s'assurer que vsftpd lance un compte FTP anonyme par adresse IP. Avec inetd/xinetd vsftpd peut lancer seulement un compte FTP Anonyme par serveur même si le serveur à plusieurs adresses IP. Pour éviter cet inconvénient comparé au serveur proftpd le système ISPCONFIG utilise l'ispconfig_tcpserver.

vsftp peut être démarrer/arrêter par la commande suivante :

/etc/rc.d/init.d/ispconfig_tcpserver start|stop|restart (RedHat et Mandrake)

or

/etc/init.d/ispconfig_tcpserver start|stop|restart (SuSE et Debian).

Si vous utiliser proftpd comme serveur FTP rien ne change.

3 Tâches Cron

Les tâches cron suivantes sont lancées par ISPConfig :

Commande Description Heure
/root/ispconfig/php/php /root/ispconfig/scripts/shell/logs.php &> /dev/null Analyse des fichiers log Apache pour les statistiques de traffic d'ISPConfig 23:59h
/root/ispconfig/php/php /root/ispconfig/scripts/shell/ftp_logs.php &> /dev/null Analyse des fichiers log FTP pour les statistiques de traffic d'ISPConfig 23:59h
/root/ispconfig/php/php /root/ispconfig/scripts/shell/mail_logs.php &> /dev/null Analyse des fichiers log mail pour les statistiques de traffic d'ISPConfig 23:59h
/root/ispconfig/php/php /root/ispconfig/scripts/shell/cleanup.php &> /dev/null Suppression des sauvegarde des sites qui ont été éffacé de la corbeille 23:59h
/root/ispconfig/php/php /root/ispconfig/scripts/shell/webalizer.php &> /dev/null Création des Statistiques Webalizer 04:00h
/root/ispconfig/php/php /root/ispconfig/scripts/shell/check_services.php &> /dev/null Surveillance (voir chapitre I-2.4.2) toutes les 30 min.

4 Permissions des Dossiers d'un Site créer par ISPConfig

Dans un nouveau site vous trouverez les répertoires suivant avec les permissions suivantes :

S'il n'y à pas d'administrateur pour le site (voir chapitre III-2.2.1), par défaut les dossiers appartiennent à l'utilisateur sous lequel le serveur web Apache est lancé (ici "nobody"); Autrement ils appartiennent à l'administrateur du site (dans notre cas "web5_admin").

L e groupe des dossiers et toujours le groupe du site, dans notre cas "web5".

5 Ajout Manuel dans les Fichiers de Configuration

Depuis la version 1.2.0 d'ISPConfig vous pouvez ajouter des entrée manuelles dans les fichiers suivant (Ils ne seront pas effacé par ISPConfig):

Vous trouverez une ligne parmis les deux suivante dans chacun de ces fichiers :

Après cette ligne vous pouvez ajouter vos entrées dans le fichier.

Les ajout dans la configuration Apache d'un virtual host (site) doivent être faites dans le champ "Directives Apache (Optionel)" dans l'onglet "Base" du site correspondant (voir chapitre II-3.1).


Contents Next