Cette configuration est utile dans plusieurs cas :
- L'administrateur a une seule adresse IP et veut faire
tourner le WebMail et IIS sous le port 80
- L'administrateur veut une solution de secours
- L'administrateur a l'habitude de l'administration de IIS
et veut aussi l'utiliser pour le WebMail
Le WebMail n'a pas été conçu au départ pour tourner sous IIS,
IceWarp Ltd. ne peut donc garantir toutes les fonctionnalités du WebMail sous
IIS. Après de nombreux tests et avec l'aide de nos clients, nous avons cependant
montré que, moyennant les changements indiqués ci-dessous, tout fonctionne
correctement.
La description ci-dessous a été effectuée sur une machine de
test avec IIS 6.0 et Merak Mail Server 8.2.4.r comprenant WebMail 5.5.1. Cela
devrait aussi marcher avec des versions plus anciennes de Merak (WebMail) et,
bien sûr de IIS (5.x).
Description pas à pas :
1. Modification des fichiers WebMail pour qu'ils soient
compatibles avec IIS.
A. Création du fichier config.php
Créez (ou ouvrez) config.php dans un éditeur de texte. Le
fichier se situe dans ..\Merak\HTML\Mail par défaut. Insérez la ligne :
><?$SERVER_INSTALL_PATH = 'le vrai chemin d'accès à
Merak\WebMail';?>
Par exemple <?$SERVER_INSTALL_PATH = 'C:/Program
Files/Merak/WebMail/';?>
Attention : il doit y avoir un CRLF
après ?> sinon, les fichiers attachés ne seront pas affichés
correctement
B. Modification du fichier fastlog.php (seulement pour les versions de WebMail
antérieure à 5.5.2)
Ouvrez le fichier fastlog.php qui est situé dans le répertoire
par défaut \Merak\HTML\Mail\ et remplacez le bloc :
if ($AUTH_USER)
{
$username = $AUTH_USER;
$password = $AUTH_PASSWORD;
}
par le bloc :
if ($PHP_AUTH_USER)
{
$username = $PHP_AUTH_USER;
$password = $PHP_AUTH_PW;
}
2. Création du répertoire virtuel du WebMail sur IIS
Lancez IIS. Pour cela, allez dans panneau de configuration
-> outils d'administration -> Services
Internet (IIS).
Sélectionnez l'arbre des sites Web par défaut et cliquez sur
le menu Action -> Nouveau -> Répertoire virtuel...
Après accueil par l'assistant de création des répertoires
virtuels, cliquez 'Suivant' puis remplissez l'Alias. C'est le nom
d'identification du répertoire pour les utilisateurs du WebMail à travers IIS,
appelez-le par exemple WebMail.
L'écran suivant demande le chemin du répertoire où se situent
les fichiers HTML. Par défaut, c'est C:\Program files\Merak\HTML\Mail.
La définition des permissions est ensuite demandée. Validez
les permissions : lire, exécuter les scripts,
exécuter.
Cliquez 'Suivant' puis 'Terminer' pour finir la création.
3. Modification des propriétés du nouveau répertoire
virtuel
Après réalisation de l'étape précédente, une nouvelle ligne
est apparue dans l'arbre, faites un clic droit dessus et choisissez
'Propriétés'.
Dans l'onglet répertoire virtuel, cliquez sur le bouton
'Configuration...' puis sur le bouton 'Ajouter' de l'onglet 'Mappages'.
Dans la boîte de dialogue suivante, cherchez le fichier
php.exe qui est dans le répertoire par défaut C:\Program Files\Merak\WebMail et
qui est l'interpréteur des fichiers HTML, remplissez l'extension .php pour
indiquer pour quelles extensions il fonctionne. Faites attention que le chemin
de l'exécutable doit être entre "".
et confirmez par 'OK'. Puis 'OK' une fois de plus pour
retourner à la boîte de dialogue 'Propriétés'. Choisir ensuite l'onglet
'Documents'. Il faut ajouter un nouveau type de document par défaut. Cliquez sur
'Ajouter' et remplissez 'index.php'
Finissez en cliquant sur 'OK' puis déplacez le nouveau type en
tête de liste en cliquant sur la flèche montante.
Choisissez l'onglet 'Sécurité de répertoire' et cliquez sur le
bouton 'Modifier...' de la section 'Connexions anonymes et contrôle
d'authentification'. Copiez le nom d'utilisateur qui est dans la sous-section
'Connexion anonyme'.
4. Assignation des droits appropriés à l'utilisateur
La dernière étape consiste à indiquer les autorisations
correctes à l'utilisateur qui sert d'accès anonyme pour les bons répertoires.
Les répertoires sont les suivants :
- %%pathToMerakDirectory%%\WebMail\users
- %%pathToMerakDirectory%%\WebMail\config
- %%pathToMerakDirectory%%\WebMail\sessions
- %%pathToMerakDirectory%%\temp
- %%pathToMerakDirectory%%\html\temp
- %%pathToMerakDirectory%%\Mail
- Windows\temp (ceci est nécessaire pour les pièces jointes
- elles seraient perdues si ce répertoire n'était pas accessible mais il peut
être modifié comme indiqué à la fin de cette fiche)
Par défaut %%pathToMerakDirectory%% est C:\Program
Files\Merak.
La procédure pour établir les droits est montrée pour le
premier répertoire, les autres sont similaires.
Allez dans le répertoire Merak\WebMail, faites un clic droit
sur le répertoire et choisissez 'Propriétés'. Choisir l'onglet Sécurité.
Cliquez sur le bouton 'Ajouter' et recopiez l'utilisateur que
vous aviez copié dans l'onglet 'Sécurité de répertoire' de la configuration
IIS.
Cliquez sur OK et validez les permissions d'écriture et de
lecture pour cet utilisateur.
Faite de même pour les autres répertoires de la liste
ci-dessus.
5. Création d'une nouvelle extension pour PHP.EXE
Revenez à la console IIS et créez une nouvelle extension pour
php.exe (WebMail php). Sélectionnez 'Web Service Extensions' sur le panneau
droit, faire un clic droit et sélectionnez "Add a new service extension'.
et ajoutez le chemin %%pathToMerakDirectory%%\php\php.exe et
l'autoriser (validez la case 'Set extension status to Allowed').
Pour les versions de IIS plus anciennes que la 6.0, vous n'avez
pas à créer de nouvelle extension pour PHP.EXE
6. Modification du port par défaut et démarrage du
service
Vous devez maintenant démarrer le service IIS et,
éventuellement changer le port par défaut de IIS (si vous voulez des services
Web simultanés : Merak, IIS, Apache,...). Allez sur la console IIS manager et
choisissez 'Web Sites' avec le bouton droit, choisissez 'Properties'. Modifiez
le port TCP à un port ouvert (par exemple 801).
Pour démarrer le service, sélectionnez 'Default Web Site' et
sur le menu du bouton droit, cliquez sur 'Start'
7. Voir le WebMail sous IIS
Vérifiez que le WebMail tourne normalement sous IIS. Vous
devriez voir l'écran de connexion par cet URL :
http://monIP/WebMail or http://monhôte/WebMail.
Points supplémentaires :
- Permettre la personnalisation de l'hôte virtuel (ce qui
n'est pas possible sous IIS même après tous les changements précédents).
- Créez des répertoires virtuels sous IIS correspondants
aux hôtes virtuels. Tous prennent leurs données à partir du répertoire
html\mail\ .
- Ouvrez le fichier html\mail\include.php et après les
lignes ci-dessous :
//MSIE check // on JS submit is nullkuli bezpecnosti
se tam
testuje /temp/<file>.tmp
if((eregi("MSIE",$HTTP_USER_AGENT) ||
!$HTTP_USER_AGENT) && !eregi("Opera",$HTTP_USER_AGENT)) $isie=1;
if(eregi("^Mozilla",$HTTP_USER_AGENT) &&
substr($HTTP_USER_AGENT,strpos($HTTP_USER_AGENT,"/")+1,3)>=5)
$ismozilla=1;
// ajouter cette ligne
$URL =
$HTTP_HOST.$PHP_SELF.$QUERY_STRING;
- Permettre des fichiers attachés de plus de 2 MB
Modifiez le fichier wmi.ini qui est dans le répertoire
Windows; trouvez la ligne :
upload_max_filesize = 2M
et modifiez la quantité en fonction de votre
besoin.
-
Modifiez cette valeur si vos
fichiers attachés ne sont pas traités correctement.
- Modifier le répertoire temp pour les fichiers reçus
Par défaut, le WebMail utilise le répertoire temporaire
de Windows, il est recommandé de le changer en un répertoire temporaire
WebMail qui est dans html\temp.
Pour cela, ouvrez de nouveau wmi.ini et cherchez la
ligne :
;upload_tmp_dir =
supprimez le point virgule au début et mettez le chemin
du répertoire html\temp dans Merak. N'oubliez pas d'assigner à ce répertoire
les permissions correctes comme décrit au point 4.
-
Si vous changez le répertoire
temporaire, notez que ce nouveau répertoire doit avoir le nom "temp" par
exemple webmail/temp/ ou .../temp/, etc... (pour la sécurité du
WebMail)
Vérifiez
