MANUEL DE GESTION D'UN HEBERGEMENT MUTUALISE avec VIRTUALMIN

GNU Free Documentation Licence http://www.gnu.org/copyleft/fdl.html

Introduction................................................................................................................................... 3 Se connecter Virtualmin............................................................................................................ 4 Informations sur votre hbergement .......................................................................................... 4 Diffrents types d'hbergement ................................................................................................... 4 Structure de la page d'administration Virtualmin .................................................................... 5 Crer un sous-serveur (sub-server)............................................................................................. 8 Crer un alias pour l'hbergement web...................................................................................... 9 Ajouter / Modifier les utilisateurs FTP/MySQL ...................................................................... 11 Gestion de bases de donnes MySQL........................................................................................ 13 Fonctions avances de gestion MySQL ..................................................................................... 14 Dlguer les tches d'administration de votre hbergement .................................................. 18 Modifier les paramtres DNS .................................................................................................... 19 Modifier les directives d'Apache ............................................................................................... 23 Lire les logs Apache de votre hbergement web et reprer les problmes ............................ 25 Le gestionnaire des fichiers Filemanager .............................................................................. 26 PostgreSQL, WebDAV et SVN.................................................................................................. 27

Introduction
Ds que votre hbergement est cr, un mail avec les codes d'accs est envoy votre adresse e-mail. Cet e-mail contient les informations suivantes :
Nom de domaine : monsite.be Serveur d'hbergement x.netline.be Nom d'utilisateur: monsite Mot de passe: 6PhF3exEfrLEJbY URL interface gestion : https://x.netline.be:10000/ Adresse du site web : http://www.monsite.be/ Adresse statistiques : http://www.monsite.be/stats Webalizer analyse logs : Enabled Base de donnes MySQL : monsite MySQL login : monsite MySQL password : 6PhF3exEfrLEJbY :

Ces donnes sont fictives. Elles seront utilises tout au long de ce manuel titre d'exemple. partir des informations ci-haut, allez sur l'url de l'interface de gestion :
URL interface gestion : https://monsite.be:10000/

et connectez-vous avec votre identifiant (codes d'accs) :

Nom d'utilisateur : Mot de passe: monsite 6PhF3exEfrLEJbY

Se connecter Virtualmin

Informations sur votre hbergement

Aprs connexion, la premire page affichera les informations relatives votre hbergement mutualis. Dans le contexte Apache, serveur virtuel veut dire Site web ou hbergement

Diffrents types d'hbergement

Selon votre type d'hbergement, vous verrez les diffrents quotas d'utilisation :
Type d'hbergement Simple Conseill Large Espace disque (quota) 20MB 3GB 10GB Sous-serveurs 1 5 10 Utilisateurs supplmentaires 0 10 20 Bases de donnes 1 3 15 Botes e-mail 100MB)* 1 10 20 Listes de diffusion (mailman)** 0 5 10

Structure de la page d'administration Virtualmin

La page d'administration de Virtualmin est spare en 2 parties. La partie de gauche contient 2 menus principaux : Virtualmin (gestion de votre hbergement web) et Webmin(gestion du systme). Virtualmin vous aidera configurer et grer votre hbergement web. Entre autres, vous pourrez : Visualiser l'espace disque utilis de votre serveur : le quota * Modifier le mot de passe de vos utilisateurs Crer et grer des utilisateurs

Crer et grer les bases de donnes Modifier les paramtres DNS Configurer votre site web (configuration Apache) Effectuer un backup personnalis de votre hbergement web Parcourir les logs (journaux) de votre hbergement web. Uploader et tlcharger de fichiers via le module Manager/Gestionnaire de fichiers Dfinir des rpertoires protgs.

File

Changer la langue de votre gestionnaire Virtualmin/Webmin Ne changez pas le thme "Virtualmin", les autres thmes Webmin ne sont pas adapts l'utilisation avec Virtualmin et votre navigation pourrait tre limite ! Crer des tches planifies (cron jobs) Parcourir les logs (journaux) de votre hbergement web.
-

La partie de droite affiche les informations que vous avez demandes en

cliquant sur un de liens du menu de gauche. Par exemple, lorsque vous cliquez sur Virtualmin -> Edit Virtual Server, vous pouvez visualiser en premier lieu les dtails de votre hbergement web :
Le mot de passe de l'administrateur

En cliquant sur Virtualmin -> Edit Virtual Server -> Configurable settings

et puis sur Show... vous pouvez visualiser le mot de passe enregistr pour l'administrateur de notre hbergement : En cochant la case Set to ... vous pouvez modifier le mot de passe : Pour enregistrer le nouveau mot de passe et aussi toute autre modification qui peut tre effectue via le menu 'Edit Virtual Server', cliquez sur le bouton 'Save Virtual Server ':

Vrifier vos quotas et limites d'utilisation

En cliquant sur Virtualmin -> Edit Virtual Server -> Quotas and Limits, vous pouvez visualiser la taille de l'espace disque utilis, l'espace disque utilis par vos bases de donnes et le total :

Crer un sous-serveur (sub-server)

Qu'est-ce que c'est un sous-serveur et quoi a peut me servir?

Comme son nom l'indique, un sous-serveur se trouve sous l'hbergement web principal. Avec un sous-

serveur vous pouvez crer un 2e, 3e, etc ... site web (selon le type d'abonnement) dans le mme hbergement web principal. Vous pouvez utilisez un sous-serveur pour un nouveau site, un sous-site ou alors un site en plusieurs langues.

Comment crer un sous-serveur?

Cliquez sur Virtualmin -> Create Server et puis sur New virtual server type: Sub-server Vous devez ensuite placer en FTP les fichiers publics de votre site secondaire (sous-serveur) sous le rper toire: /home/monsite/domains/mon_sous_serveur.be/public_html * Rappel : Les fichiers publics de votre site principal sont placs dans le rpertoire : /home/domains/monsite/public_html Ne jamais effacer ce rpertoire !!

Crer un alias pour l'hbergement web

Qu'est-ce qu'un alias et quoi a peut me servir?

Exemple : Vous avez enregistr les noms de domaine suivants : monsite.be, monsite.eu, monsite.com et vous souhaitez que ces 3 noms de domaine pointent vers le mme site/hbergement. Dans le cas o vous voulez lier plusieurs noms de domaine au mme site, vous pouvez le faire en crant un alias de l'hbergement web.

Comment crer un alias?

Cliquez sur Virtualmin -> Create Server et puis sur New virtual server type: Alias of monsite.be Introduisez le nom de domaine de votre alias et vrifiez que le deux cases Setup DNS zone et Setup website for domain dans Enabled Features sont coches. Cliquez sur Create Server pour crer votre alias serveur. L'alias est en train de se crer :

Setting Up Virtual Server

In domain aliasdemonsite.be Creating home directory .. .. done Adding new DNS zone .... done Adding slave zone on dns1.netline.be dns2.netline.be dns4.netline.be dns3.netline.be .... done Updating target virtual website .. .. done

Re-starting DNS server .... done Re-starting slave DNS servers .... done Applying web server configuration .... done Saving server details .... done Sending email notif ication to domain owner .. .. email sent to monsite@karlmarx.netline.be Updating Webmin user ..

.. done Re-loading Webmin .. .. done Si vous passez cette phase sans erreur, alors votre nouveau alias apparatra dans le menu droulant de gauche :

Ajouter / Modifier les utilisateurs FTP/MySQL

Afin de crer des nouveaux utilisateurs FTP ou MySQL, cliquez sur le menu Virtualmin -> Edit FTP Users . Ds lors une liste avec les utilisateurs dj crs s'affiche. Vous pouvez Supprimer ou diter les utilisateurs qui y sont prsents. En cliquant sur le lien: Add a user to this server vous pouvez crer un nouvel utilisateur.

Vous pouvez dfinir l'espace disponible (quota) de l'utilisateur via le sous menu Quota and Home Directory Settings et aussi, via le sous-menu Other user permissions s'il s'agit : d'un simpe utilisateur (Login permissions= Email Only) d'un utilisateur FTP (Login permissions= Email and FTP) d'un utilisateur avec accs votre base de donnes (cliquez sur le nom de la

base de donnes correspondante sous le menuAllow access to databases ) Pour crer un pur utilisateur mysql , il convient de lui donner des accs restreints seulement mysql et pas de login au niveau du site : "Email only". Un attaquant qui obtient votre login MySQL ne pourra donc pas faire de login en FTP sur votre hbergement. Cliquez ensuite sur Create et le nouvel utilisateur sera cr.

Gestion de bases de donnes MySQL

En cliquant sur Virtualmin -> Edit Databases, vous allez pouvoir visualiser les bases de donnes qui sont lies votre hbergement. Vous pouvez diter une base de donnes existante en cliquant simplement sur le nom de la base, p.ex.monsite. Des dtails sur la base de donnes s'afficheront et vous aurez le choix de : Supprimer cette base de donnes (Delete This Database) Grer cette base de donnes (Manage Database) Si vous cliquez sur Manage Database, vous pouvez visualiser/diter et supprimer les tables et les donnes (de la mme faon qu'avec phpmyadmin) Pour crer une nouvelle base de donnes, il suffit de cliquer sur le lien Create a new database . Vous devez alors insrer le nom de la nouvelle base de donnes et si vous dsirez un autre jeu de car actres que celui par dfaut, vous pouvez le choisir via l'option Character set for MySQL database .

Fonctions avances de gestion MySQL

Via le menu Webmin -> Servers -> MySQL Database server , vous pouvez : crer manuellement une nouvelle table de la base de donnes visualiser les tables et les donnes excuter des requtes SQL faire le backup d'une base, de toutes les tables ou de certaines tables seulement. impor ter des tables et des donnes depuis un fichier SQL ou un fichier texte.
-

Crer une nouvelle table

Pour crer une nouvelle table dans la base de donnes slectionne, cliquez sur Create a new table.Insrez le nom de la nouvelle table, sleectionnez le type et s'il faut copiez les champs de donnes depuis une autre temps. Par aprs, ajoutez les champs de donnes et cliquez sur Create pour crer la

nouvelle table.

Crer une vue MySQL

Vous pouvez galement crer une vue MySQL,qui sont des tables virtuelles issues de l'assemblage d'autres tables en fonction de certains critres. Techniquement les vues sont cres l'aide d'une requte SELECT . Elles ne stockent pas les donnes qu'elles contiennent mais conservent juste la requte permettant de les crer.Pour en crer une, cliquez sur le bouton Create view , introduisez un nom pour cette vue et insrez votre requte de slection MySQL.

Excuter une requte SQL / Importer des tables

En cliquant sur le bouton Execute SQL , vous pouvez galement excuter une requte MySQL. Soit introduire la requte SQL via l'onglet Execute SQL :

Soit l'excuter depuis un fichier qui se trouve sur votre espace d'hbergement ou depuis un fichier de votre ordinateur : Ou alors l'importer depuis un fichier texte (csv avec ou sans guillemets, txt spar par tabulation ...) : Celle-ci est la mthode la plus utilise pour importer des tables/donnes dans une base de donnes . La fonction "execute SQL" est plus puissante que celle se trouvant sur Phpmyadmin et permet d'importer des fichiers SQL

plus volumineux car elle n'est pas limit par un temps d'execution ou la taille du fichier SQL.

Dlguer les tches d'administration de votre hbergement

Vous pouvez crer des administrateurs supplmentaires auxquels vous pouvez dleguer certaines tches sans qu'ils aient accs toutes les fonctionnalits de votre hbergement. Pour crer un nouvel administrateur de votre hbergement, allez dans le menu Administration Options -> Manage Extra Admins et cliquez sur Add a new extra administrator. Vous pouvez alors slectionner quelles tches d'administration ce nouvel administrateur pourra excuter.

Modifier les paramtres DNS

Le DNS, systme de noms de domaine , est un systme permettant d' tablir une correspondance entre une adresse IP et un nom de domaine et, plus gnralement, de trouver une information partir d'un nom de domaine. Le systme DNS a t invent car les humains ne peuvent gnr alement pas bien mmoriser des chiffres (adresses IP) mais bien des noms. Le systme DNS permet de mmoriser des IP numr iques (p.ex. l'adresse IP 62.58.108.11) plus facilement, en permettant aux humains de retenir uniquement un nom associ (p.ex. le nom de domaine www.netline.be). Les machines (les ordinateurs connects sur Internet) peuvent quand eux "rsoudre" ces noms de domaines en IP car elles ont besoin de l'adresse d'une ressource Internet au format numrique pour pouvoir achminer les requtes de l'utilisateur (routage par adresses IP). Avec le DNS, la rsolution se fait par l'intermdiaire d'un serveur . Quand un utilisateur souhaite accder un site web, par exemple celui de www.netline.be, son ordinateur met une requte spciale un serveur DNS, demandant 'Quelle est l'adresse de www.netline.be?'. Le serveur rpond en retournant l'adresse IP du serveur qui est, dans ce cas-ci, 62.58.108.11. Il est galement possible de poser la question inverse, savoir 'Quel est le nom de domaine ou quels sont les noms de domaine de telle adresse IP ?'. On parle alors de rsolution inverse (reverse query) en

rfr ence l'enregistrement DNS de type PTR.

Les principaux enregistrements ou records DNS sont : A record ou address record qui fait correspondre un nom d'hte (p.ex. www.netline.be) une adresse IPv4 de 32 bits distribus sur quatre octets (p.ex. 62.58.108.11) ; NS record ou name server record qui dfinit les serveurs DNS de ce domaine ; MX record ou mail exchange record qui dfinit les serveurs de courriel pour ce domaine. Via le menu Virtualmin -> Services -> DNS Domain, vous pouvez grer le fichier de votre zone dns.

Comment modifier le MX record configur par dfaut ?

Les MX record qui sont prconfigurs avec votre hbergement lorsque vous accdez pour la premire fois l'interface de gestion Virtualmin sont gnralement ceux qui correspondent aux serveurs mail ddis sur lequels vos botes e-mail sont gres et il ne faut donc rien changer dans cette section pour viter tout dysfonctionnement de votre systme de courrier lectronique ! Lorsque vous souhaitez garder vos e-mail sur un autre serveur e-mail, p.ex. votre serveur Groupware d'entreprise ou un serveur e-mail chez un autre prestataire Internet, il convient de remplacer les MX records associs votre nom de domaine par ceux fourni par votre administateur/prestataire e-mail. Dans ce cas, remplacez les deux enregistrements MX par dfaut par ceux obtenu par votre administrateur e- mail. Attention dans la case "Mail Server", il est interdit de saisir une adresse IP numr ique, il faut toujours utiliser un nom de domaine (ou sous-domaine). Si votre prestataire e-mail vous fournit uniquement une adresse IP numrique de votre serveur e-mail, il faudra changer d'abord le A record "mail.monsite.be" en lui associant cette adresse IP. ensuite il faut ajouter dans le MX "Mail Server" : mail.monsite.be

Vous pouvez visualiser les records de la zone en cliquant sur le type du record correspondant (p.ex.cliquez sur Mail Server pour visualiser les MX records de votre domaine). Pour ajouter un nouveau record , p.ex. un nouveau MX record, cliquez sur Mail Server , rentrez les nouvelles donnes et cliquez sur Create Vous pouvez galement visualiser tous les records en cliquant sur All : Pour modifier un record il suffit juste de cliquer dessus, porter les modifications et cliquer sur Save .

Aprs que vous ayez apport des modifications votre fichier de zone (ajout, suppression ou dition des records), il faut retourner sur la page principale d'dition de la zone (Return to record types ou via le menu Virtualmin -> Services -> DNS Domain et cliquer sur le bouton pour appliquer les changements.

Modifier les directives d'Apache

Ne modifiez jamais les valeurs par dfaut, sans en connatre les consquences. Via le menu Virtualmin -> Services -> Configure Website, vous pouvez modifier les paramtres de configur ation de votre hbergement web Apache.

Activer le fichier .htaccess

Si vous installerez un CMS (Drupal, Joomla etc) souvent un fichier .htaccess est aussi install. Ce fichier est ncessaire pour avoir p.ex. ses propres url ou crer des rdirections. Par dfaut, sur un hbergement mutualis, l'utilisation des fichiers .htaccess n'est pas active. Si un fichier .htaccess est prsent vous obtiendrez une erreur 403. Via le menu Virtualmin -> Services -> Configure Website vous pouvez modifier les paramtres afin que le fichier .htaccess puisse tre utilis. Cliquez sur l'icne Show Directives et puis sur <Directory /home/monsite/public_html> puis de nouveau sur Show Direct ives ( ce moment vous tes dans les paramtres par rprtoire PerDirectory OptionsFor Directory /var/www/htdocs/monsite/public on monsite.be:80 ) Cliquer sur la ligne AllowOverride AuthConfig Limit

Dans le section Options file can override.. slectionnez Selected below... et cochez TOUTES les cases. Cliquez sur Save pour sauvegarder les changements et puis sur Apply Change (en haut doite de votre fentre) pour appliques les changements. La directive AllowOverr ide AuthConfig Limit devient alors AllowOverride All.

Lire les logs Apache de votre hbergement web et reprer les problmes
Consulter les logs de votre hbergement web est une tape trs utile pour rsoudre les problmes que vous pourriez rencontrer avec votre site. Nous vous suggrons d'ailleurs de toujours vrifier les logs avant de contacter le service support de Netline et de nous les envoyer si ncessaire. Vous pouvez visualiser les logs d'accs et les logs d'erreur de votre hbergement web via le menu Virtualmin -> Logs and Reports. Par dfaut, les 20 dernires lignes du fichier log seront affiches mais vous pouvez modifier cela et vous pouvez aussi lancer une recherche sur un certain mot.

Le gestionnaire des fichiers Filemanager

Pour uploader les fichiers de votre site sur le serveur, il existe 2 faons : la faon classique via FTP
-

Dans ce cas, vous devez configurer votre client FTP (Filezilla, FireFTP, Cyberduck, etc...) de manire se connecter au serveur avec les paramtres de connexion que vous avec reus:
Serveur d'hbergement : karlmarx.netline.be Nom d'utilisateur: monsite Mot de passe: 6PhF3exEfrLEJbY

via le gestionnaire des fichiers Filemanager

-

Pour y accder, connectez-vous Virtualmin, puis Webmin -> Others -> Filemanager . Dans ce cas vous n'avez pas besoin d'un client FTP spar, mais il est ncessaire que les applets Java soient supports par votre navigateur (java vm doit tre install). C'est un outil trs puissant qui vous permet entre autres d' uploader sur le serveur un dossier compress et l'extraire sur placevia le bouton Extract.

PostgreSQL, WebDAV et SVN

Ces 3 services sont installs mais pas activs par dfaut. Si vous en avez besoin, veuillez contacter le support technique de Netline (support@netline.be) afin que nous l'activions pour vous.

Webdav
WebDAV ( Web-based Distributed Authoring and Versioning ) est un protocole (plus prcisment, une extension du protocole HTTP) qui permet de simplifier la gestion de fichiers avec des serveurs distants. Il permet de rcuprer, dposer, synchroniser et publier des fichiers (et dossiers) rapidement et facilement. L'objectif principal de WebDAV est de rendre possible l'criture travers le web et pas seulement la lecture de donnes. WebDAV permet plusieurs utilisateurs d'diter le contenu d'un dossier web simultanment. Il saura grer les droits d'accs aux fichiers (ou dossiers), en verrouillant momentanment les fichiers et dossiers dits. Sous Windows XP, les dossiers WebDAV se trouvent dans les "Favoris rseau". Voici une brve description des extensions fournies par DAV : Protection contre l'crasement : mcanisme de verrouillage et de dverrouillage pour viter les problmes de synchronisation de mises jour. Le protocole DAV supporte les accs exclusifs et partags. Proprits : mta-donnes (titre, sujet, crateur, et ctera) Gestion des attributs de fichiers : copier, renommer, dplacer et supprimer des fichiers Contrle d'accs : limitation d'accs des ressources diverses. Gnralement, DAV considre qu'un contrle d'accs est dj en place, et ne fournit pas de

mcanisme d'authentification robuste. Une fois le WebDAV activ, il apparatra dans un nouveau menu DAV Authentication sous le menu Virtualmin -> Services : Ne modifiez par les paramtres par dfaut sous peine de non fonctionnement de WebDAV. Vous pouvez accorder la permission d'utilisation de WebDAV aux utilisateurs via le menu : Virtualmin -> Edit FTP Users. Cliquez sur le nom d'utilisateur et puis sur 'Other user permissions' Et activez le login DAV :

WebDAV peut tre utile dans le cas d'une petite association ou socit afin de partager des dossiers et de documents sans devoir passer par un serveur de partage de fichiers (Samba ou Windows Serveur).

Subversion
Subversion est un logiciel de gestion de sources et de contrle de versions. Ce type de programmes a plusieurs fonctions, notamment : garder un historique des diffrentes versions des fichiers d'un projet ; permettre le retour une version antrieure quelconque ; garder un historique des modif ications avec leur nature, leur date, leur auteur... ; permettre un accs souple ces fichiers, en local ou via un rseau ; permettre des utilisateurs distincts et souvent distants de travailler ensemble sur les mmes fichiers. Subversion est surtout destine aux dveloppeurs et aux utilisateurs avancs. Une fois le SVN activ, il apparatra dans un nouveau menu SVN Repositories sous le menu Virtualmin -> Services : Si vous cliquez dessus, la premire fois vous allez devoir crer un rpertoire SVN : Par aprs, vous pourrez visualiser/modifier les repositories existants ou en ajouter de nouveaux :

Vous pouvez accorder la permission d'utilisation de SVN aux utilisateurs via le menu :Virtualmin -> Edit FTP Users. Cliquez sur le nom d'utilisateur et puis sur 'Other user permissions', activez le login SVN via 'Subversion login enabled?'
-

accordez l'accs au repository appropri via 'Allow access to repositories'

-

Pour plus d'infos sur SubVersion, vous pouvez consulter le manuel :Version Control with Subversion by Ben Collins-Sussman, Brian W. Fitzpatrick, C. Michael Pilato (en anglais): http://svnbook.red-bean.com/en/1.5/svn-book.pdf