Pré requis

Pour installer et configurer correctement votre serveur, vous devez :

• avoir un serveur en Debian Etch
• savoir éditer votre fichier sources.list
• connaître les commandes de base concernant apt-get
• être possesseur d'un nom de domaine (les exemples utiliseront mdr.rezo.net )

Télécharger Alternc

Dans un premier temps il vous faut télécharger le paquet alternc, comme indiqué sur cette page?.

Nettoyer votre serveur

Cette étape est inutile si vous avez une debian stable toute fraîche. Toutefois nous vous la recommandons si vous avez déjà essayé d'installer des paquets dédiés au web

apt-get remove apache* mysql* postfix* alternc* bind9* courrier-* --purge

Installer les paquets pré-requis

Actuellement il existe divers systèmes de serveur web (apache, apache2, ...) et de MTA (exim, postfix, ...). Vous devez rendre compatible votre serveur avec les applications supportées par Alternc. A terme, le support d'apache2 est prévu toutefois en l'état nous ne garantissons le fonctionnement uniquement avec apache 1.3.

apt-get install apache-ssl

Si vous souhaitez avoir mysql sur le même serveur :

apt-get install mysql-server

Note, acceptez les configuration par défaut, à moins que vous sachiez ce que vous faîtes. Si vous avez un doute, plus de détails ici

Rappel, si vous souhaitez utiliser votre serveur mysql indépendamment cela est tout à fait possible toutefois vous devez être suffisamment expert pour personnaliser la configuration de votre système en conséquence.

Définir votre domaine

Alternc se base sur le nom de votre ordinateur ( hostname ) pour configurer l'ensemble des paquets web. Par conséquent vous devez avoir un nom de domaine à votre disposition. Le nom de votre serveur sera le nom de votre panel. Dans les exemples qui suivent, nous utiliserons mdr.rezo.net pour désigner le serveur par voie de conséquence le panel.

Il est obligatoire de déclarer un sous domaine et non le domaine, c'est à dire mdr.rezo.net et non rezo.net Nous vous conseillons de nommer votre serveur panel.domaine.com ou bureau.domaine.com

Pour affecter le bon nom à votre serveur

hostname mdr.rezo.net

Pour vérifier le nom de votre serveur, utilisez la commande :

hostname --fqdn

Tout va bien, si vous obtenez

mdr.rezo.net

Sinon c'est que le nom de votre serveur n'est pas connu sur le réseau, vous pouvez alors modifier localement votre fichier hosts

nano /etc/hosts

Ajoutez dans ce fichier une ligne du genre (xxx.yyy.zzz.www étant l'ip publique de votre serveur):

xxx.yyy.zzz.www     mdr.rezo.net

Installer Alternc

apt-get install alternc

Le gestionnaire de paquets devrait vous proposer une liste de paquets à installer :

The following NEW packages will be installed:
  alternc apache bind9 ca-certificates courier-authdaemon courier-authlib
  courier-authlib-mysql courier-authlib-userdb courier-base courier-imap
  courier-imap-ssl courier-pop courier-pop-ssl courier-ssl gettext
  gettext-base libapache-mod-php5 libbind9-0 libdns22 libfam0 libisc11
  libisccc0 libisccfg1 liblockfile1 libltdl3 liblwres9 libperl5.8
  libsasl2-modules lockfile-progs pdksh perl-suid php5-cli php5-common
  php5-mysql phpmyadmin postfix postfix-mysql proftpd proftpd-mysql quota
  rsync sasl2-bin squirrelmail wwwconfig-common
0 upgraded, 44 newly installed, 0 to remove and 4 not upgraded.
Need to get 19.4MB of archives.
After unpacking 58.5MB of additional disk space will be used.

Confirmez avec "Y".

Le système de package debian installe alors AlternC et les packages en dépendance comme :

Lorsque les packages en dépendance d'AlternC s'installent, ils peuvent vous poser plusieurs questions. Pour la plupart des réponses il suffit de taper sur enter pour valider la valeur par défaut. A cette étape les réponses importe peu car AlternC écrasera les fichiers de configuration de ces logiciels.

Note Si vous souhaitez installer les plugins d'AlternC pour mailman ou awstats ou encore les plugins pour cacti ou nagios, attendez de disposer d'un AlternC configuré et fonctionnel, car ces plugins nécessitent souvent un AlternC proprement configuré pour pouvoir être installés.

Configurer Alternc

Pendant l'installation, nous vous demandons confirmation de l'installation d'AlternC sur le serveur :

Do you REALLY want to install AlternC on this computer ?

Ce message n'est pas là pour vous effrayer mais bien pour vous rappeler que vous aller modifier profondément l'organisation de votre serveur.

En effet, AlternC modifie de nombreux paramètres fondamentaux du serveur parmi lesquels la configuration d'apache, de postfix ou de proftpd. Si vous confirmez, Alternc fera le nécessaire pour configurer le serveur.

La dernière phase d'installation consistera à la configuration du serveur, votre console devrait se finir par ceci :

[...]
Setting up alternc (0.9.7) ...
Updating /etc/alternc/local.sh
checking for upgrades
config phpmyadmin
running alternc.install
Setup MySQL and database...
Granting users 
ERROR 1045 (28000) at line 1: Access denied for user 'debian-sys-maint'@'localhost' (using password: YES)
debian-sys-maintainer doesn't have the right credentials, assuming we're doing an upgrade
ERROR 1045 (28000): Access denied for user 'sysusr'@'localhost' (using password: YES)
Still not working, assuming clean install and empty root password
Setting AlternC 'alternc' system table and privileges 
Installing AlternC schema 
MYSQL.SH OK!
Restarting apache 1.3 web server....
Restarting apache-ssl 1.3 web server....
Generating locales (this might take a while)...
[...]
Generation complete.
Reloading apache 1.3 configuration....
Reloading apache-ssl 1.3 configuration....
Reloading Postfix configuration...postfix/postfix-script: fatal: the Postfix mail system is not running
failed.
Reloading domain name service...: bind.
Stopping Courier authentication services: authdaemond.
Starting Courier authentication services: authdaemond.
Stopping Courier IMAP server: imapd.
Starting Courier IMAP server: imapd.
Stopping Courier IMAP-SSL server: imapd-ssl.
Starting Courier IMAP-SSL server: imapd-ssl.
Stopping Courier POP3 server: pop3d.
Starting Courier POP3 server: pop3d.
Stopping Courier POP3-SSL server: pop3d-ssl.
Starting Courier POP3-SSL server: pop3d-ssl.
Reloading configuration files for periodic command scheduler: crond.
Reloading ftp server: proftpd.
adding open_base_dir protection for:.
Creating admin user...

*******************************************
*                                         *
*               Admin account             *
*               ------------              *
*                                         *
* user: admin             password: admin *
*                                         *
* Please change this as soon as possible! *
*                                         *
*******************************************
Stopping apache 1.3 web server....
Stopping apache-ssl 1.3 web server....
Starting apache 1.3 web server....
Starting apache-ssl 1.3 web server....

Relancer Apache

Bien que la dernière opération d'Alternc consiste à relancer Apache, le système automatique ne marche pas toujours vous devez donc faire :

/etc/init.d/apache stop
/etc/init.d/apache start

Ceci permet de s'assurer que les modifications des configurations d'Apache seront bien prise en compte.

Accéder au panel

La dernière étape de l'installation consiste à créer un compte AlternC administrateur, dont :

• le login est admin
• le mot de passe est admin

Vous pouvez donc vous connecter à l'interface d'administration à l'adresse  http://mdr.rezo.net/ en remplaçant "mdr.rezo.net" par le hostname déclaré au tout début de l'installation. Connectez-vous alors avec le login / pass admin et allez dans "configuration" pour modifier votre mot de passe tout de suite (...)