Aide AlternC v3

Traduire

azerttyu — 2025-09-10T09:43:41Z

Il est possible de contribuer en ajoutant une nouvelle langue ou en mettant à jour les informations.

Les traductions actuelles sont :

Mise à jour 3.5 rcX vers 3.5.*

azerttyu — 2025-02-04T08:28:42Z

Le cycle de vie de l'arrivée de la version 3.5 a été longue. De fait diverses versions intermédiaires ont été proposées en RC (release candidate). Ces versions ont vu divers changement qu'il faut corriger avant de mettre à jour vers un 3.5 stable.

/ !\ Cette documentation est en cours de rédaction et évolue en fonction des RC en cours de diffusion / !\

Principes généraux

Comme indiqué dans l'article Mise à jour 3.3.x vers 3.5.* la version 3.5 est compatible de Debian Buster à Bookworm.
Les prochaines versions (dont les mineures) ne seront validées que pour Bookworm et plus.

Les étapes générales sont :
* corriger les reliquats de code des versions RC
* installer la version 3.5 avec les recommandations suivantes
* mettre à jour vers Debian Bookworm
* rétablir les configurations AlternC

Déclarer le dépôt AlternC

Vérifier le dépôt source d'AlternC. Il est possible que vous ayez utilisé des dépots alternatifs fournis par certains membres de la communauté.
Nous avons fusionné les divergences pour proposer un unique dépôt commun https://debian.alternc.org/

sudo wget https://debian.alternc.org/key.txt -O /usr/share/keyrings/alternc.asc echo "deb [signed-by=/usr/share/keyrings/alternc.asc] https://debian.alternc.org/ $(lsb_release -cs) main" | sudo tee -a /etc/apt/sources.list.d/alternc.list

Corriger les reliquats des version 3.5 rcX

Certains scripts de mise à jour sur le cycle 3.5 ont posé divers problèmes de comportement, par conséquent il faut nettoyer ceci avant toute mise à jours (Applicatif et système)

rm -fr /usr/share/alternc/install/upgrades/*

apt update apt install alternc --reinstall

echo 'UPDATE alternc.alternc_status SET value="3.4.10.sql" WHERE name="alternc_version";' |mysql /usr/share/alternc/install/upgrade_check.sh

Mettre à jour AlternC vers 3.5 stable

apt install alternc --reinstall

Mettre à jour vers Bookworm

Vous pouvez dès lors mettre à jour votre système en suivant les procédures classiques de mises à jour. Vous pouvez suivre vos processus internes ou bien suivre les recommandations officielles fournies par Debian.

Reconfigurer AlternC

Mettez à jour votre dépot Alternc pour Bookworm.

rm /etc/apt/sources.list.d/alternc.list echo "deb [signed-by=/usr/share/keyrings/alternc.asc] https://debian.alternc.org/ $(lsb_release -cs) main" | sudo tee -a /etc/apt/sources.list.d/alternc.list

Mettez à jour vos paquets AlternC. Il est probable que vous n'ayez pas de mise à jours, nous avons essayé de maintenir un paquet unique pour de buster à bookworm.

apt install alternc

Appliquez les configuration AlternC

alternc.install

Vérifiez enfin le bon comportement de votre serveur, en suivant les points d'alertes identifiés lors d'une procédures de mise à jour standard depuis 3.3.

Installer

azerttyu — 2024-08-23T08:48:28Z

Pré-installation

AlternC est prévu pour fonctionner sur la distribution Linux Debian Bookworm.

Pour installer AlternC vous devez :

avoir un accès SSH à votre serveur.
Avoir les droits d'administrateur (sudo -s ou su)
vérifier que @includedir /etc/sudoers.d est présent dans /etc/sudoers avec la commande visudo.

Installation manuelle

ACL

AlternC dépend des acls noyau afin de gérer les droits utilisateurs notamment en ce qui concerne les dossiers web. Vous devez éventuellement vérifier que votre système n'a pas désactivé les ACLs. Pour ce faire, on peut vérifier dans le fichier /etc/fstab que noacl (pour ext3/4) ou noattr2 (pour xfs) n'est pas présent. Voici un exemple de mauvaise configuration :

/dev/md1 / ext3 auto,relatime,noacl 0 0

Sur les systèmes récents (après 2012) les ACL sont activées par défaut.

Quota

AlternC peut également gérer les quotas disques des utilisateurs. Contrairement aux ACLs, les quotas ne sont pas nécessaires au fonctionnement d'AlternC. S'ils ne sont pas activé ou installé, AlternC considérera simplement que les quotas d'espace web sont infinis pour chaque utilisateur. Pour ce faire il faut installer le paquet quota :

apt install quota

Et encore une fois modifier le /etc/fstab pour indiquer leur activation :

/dev/md1 / ext3 acl,usrquota,grpquota,errors=remount-ro 0 1

Notez que certains systèmes de virtualisation ou de containérisation n'autorisent pas la modification ou l'utilisation du fichier fstab, ou requièrent de le changer sur le système hôte. Demandez à votre hébergeur dans ce cas.

Remontage de la partition

Une fois ces modifications effectués, il suffit de remonter la partition concerné -en supposant toujours que c'est la partition / qui contiendra les données utilisateurs avec :

mount -o remount,acl,usrquota,grpquota /
quotacheck -ugm /
quotaon -v /

Vous pouvez être amené à redémarrer votre serveur si vous avez un message de la forme :

quotaon: Your kernel probably supports ext4 quota feature but you are using external quota files. Please switch your filesystem to use ext4 quota feature as external quota files on ext4 are deprecated.

Installation

MariaDB / MySQL

Il est nécessaire d'installer MariaDB (ou anciennement MySQL) pour pouvoir utiliser AlternC. Si vous voulez l'héberger sur la même machine, vous pouvez le faire avec la commande suivante :

apt install mariadb-server

Configuration des dépôts

L'ensemble de l'environnement AlternC est disponible sur notre dépôt dédié. Pour commencer il est donc nécessaire d'ajouter la clef du dépôt et les sources des paquets d'AlternC :

sudo wget https://debian.alternc.org/key.txt -O /usr/share/keyrings/alternc.asc
echo "deb [signed-by=/usr/share/keyrings/alternc.asc] https://debian.alternc.org/ $(lsb_release -cs) main" | sudo tee -a /etc/apt/sources.list.d/alternc.list

Installation

Ensuite, mettez à jour la liste des packages disponibles pour apt :

apt update

Il ne reste qu'à lancer la commande pour installer AlternC (n'oubliez pas la partie finaliser l'installation après cette opération) :

apt install alternc

Vous pouvez activer d'autres plugins en suivant les informations depuis la page des plugins comme

alternc-mailman pour gérer des listes de discussion ou de diffusion avec Mailman,
alternc-roundcube pour pouvoir utiliser un webmail avec Roundcube,
alternc-awstats pour générer des statistiques pour vos sites web avec Awstats,

DNS - serveurs de nom

Les serveurs de noms servent à distribuer l'information sur les noms de domaine installés sur votre serveur. Si vous avez besoin de serveurs de noms, AlternC vous propose un service gratuit sur AlternC.net. Dans ce cas vous pouvez saisir :

DNS primaire : ns1.alternc.net
DNS secondaire : ns2.alternc.net

Si vous avez vos propres serveurs DNS, entrez-les ici. (Souvent, le serveur primaire est le nom DNS de votre serveur AlternC)

Nom de domaine du serveur

Attention, si vous avez un nom de domaine que vous comptez utiliser pour héberger un site, ne l'indiquez pas dans cet écran. En effet, ce nom de domaine sera alors la "porte d'accès" à AlternC.

Utilisez un autre nom de domaine pointant sur votre machine ou un sous-domaine comme panel.votredomaine.com.

En résumé, si votre serveur est sur l'IP 12.34.56.78 et que vous avez le nom de domaine exemple.com pour votre site perso, n'utilisez pas exemple.com mais soit l'adresse IP, soit panel.exemple.com, soit le domaine fourni par votre hébergeur ex : serveur234215.groshebergeur.net

phpMyAdmin

Lors de l'installation, Debian vous demande de configurer PhpMyAdmin, vous pouvez le laisser faire, il vous demandera le mot de passe de l'administrateur de la base de données MySQL pour s'installer. Cependant, AlternC se chargera de modifier quelques peu ces paramètres par la suite.

Postfix

Choisir "Site Internet", puis suivre les instructions, notamment en rappelant le nom de domaine complet de votre serveur (cf plus haut)

Finaliser l'installation

Une fois que l'installation est achevée, le script alternc.install doit être exécuté. Il va générer notamment les configurations de votre serveur pour qu'AlternC fonctionne.

alternc.install

Si vous souhaitez installer un certificat SSL pour votre panel (qui sera aussi utilisé par Dovecot, Proftpd, Postfix etc.) nous vous recommandons d'installer alternc-ssl qui configurera automatiquement un certificat.

Post Installation

Première connexion

Vous pouvez désormais accéder au panel AlternC sur le nom de domaine ou l'IP que vous avez donné. Vous devriez voir une page de login dont l'accès par défaut que vous devez changer immédiatement est :

identifiant : admin
mot de passe : admin

N'oubliez pas de modifier votre mot de passe administrateur en vous rendant dans le menu Gérer les comptes AlternC !

Mise à jour 3.3.x vers 3.5.*

azerttyu — 2024-05-31T09:25:28Z

La mise à jour depuis la version 3.3 vers 3.5.* est une considérée comme majeure.
Cette mise à jour peut présenter certains problèmes, pour limiter les écueils, voici diverses recommandations

Principes généraux

Comme indiqué dans l'article Mise à jour 3.3.x vers 3.5.* la version 3.5.* est compatible de Debian Buster à Bookworm.
Les prochaines versions (dont les mineures) ne seront validées que pour Bookworm et plus.

Les étapes générales sont :
* installer la version 3.5 avec les recommandations suivantes
* mettre à jour vers Debian Bookworm
* rétablir les configurations AlternC

Compatibilité des version AlternC

Pour procéder à la mise à jour vers Alternc 3.5 nous vous recommandons un environnement Debian Buster.
Les versions 3.3 et 3.5 sont compatibles avec cette distribution.

Alternc 3.3 est compatible au maximum avec Debian Buster
Alternc 3.5 est compatible au minimum avec Debian Buster

Mise à jour de vos dépôts

Avec AlternC 3.5 ; le dépôt dédié debian.alternc.org est le seul recommandé. Nous vous invitons à retirer toutes les anciennes références à d'autres dépôts et de ne conserver que le dépôt officiel fourni par AlternC

OpenDkim

AlternC propose une nouvelle configuration pour OpenDkim ; toutefois la mise à jour s'applique après le mises à jour éventuelle du paquet OpenDkim, pour éviter tout conflit, pensez à mettre à jour la configuration /etc/opendkim.conf

# The value from /etc/default/opendkim doesn't seem to be taken into account # @see https://bugs.debian.org/cgi-bin/bugreport.cgi?archive=no&bug=861169 Socket local:/var/run/opendkim/opendkim.sock PidFile /run/opendkim/opendkim.pid UserID opendkim

Penser à vérifier que la configuration **/etc/default/opendkim** corresponde également.

Version PHP

La version maximale de PHP validée est 8.2

, le système de dépendance fait qu'un version php différente de php peut être installé à la place ou en plus.
Vous devez vérifier d'avoir la même version PHP pour :

php-cli
libmod_apache

Notes :

apache peuvent faire un SEGFAULT si 2 versions lib_modapache < 8.x sont activées
2 version php 8.x peuvent être activées en module apaches sans conflit apparent

Dans tous les cas vous devez activer une seule et unique version PHP

Incron

Le comportement de Incron a évolué, pensez à bien accepter les changements concernant les fichiers :

/etc/incron.d/alternc_do_action
/etc/incron.d/alternc_update_domains

Postfix et Dovecot

Alternc.install force la création d'un nouveau mot de passe sans le sauvegarder dans debconf. Il est possible dans ce cas que dovecot et/ou postfix ne fonctionnent plus.

Identifier le mot de passe valide :

debconf-get-selections |grep alternc_mail_password

Mettre à jour les configurations postfix et dovecot :

sed -i 's/MotDePasseDansLaConfig/MotDePasseDebConf/' /etc/dovecot/*conf sed -i 's/MotDePasseDansLaConfig/MotDePasseDebConf/' /etc/postfix/*.cf systemctl restart postfix systemctl restart dovecot

Les versions php à disposition

azerttyu — 2023-11-14T10:23:44Z

Vous pouvez consulter différentes exécutions php sur le site de démonstration :

Par défaut AlternC fournit uniquement une version php vers le module apache. Les autres versions PHP sont disponibles via le plugin alternc-php-fpm

Synchronisation DNS

azerttyu — 2023-11-14T10:10:10Z

Le site démonstration utilise le service de DNS secondaire alternc.net.
La communauté met à disposition plusieurs serveurs DNS secondaire.

Pour chaque compte déclaré sur le service, il est possible de d'ajouter ses serveurs AlternC.
Ainsi le domaine de test dmanager.org utilise les services DNS :

ns1.alternc.net
ns2.alternc.net

Pour ce faire le fichier de configuration /etc/alternc/local.sh est configuré ainsi :

# Primary DNS hostname NS1_HOSTNAME="ns1.alternc.net" # Secondary DNS hostname NS2_HOSTNAME="ns2.alternc.net"

Il est possible d'ajouter des sous domaines pour les tests et de voir leur propagation. Il faut compter une heure environ.

alternc-php-fpm

azerttyu — 2023-11-13T10:08:43Z

Ce plugin permet de gérer plusieurs version de PHP.

Le plugin détecte automatiquement la présence des version php via la présence des phpX.Y-fpm

Nous conseillons l'installation des paquets fournis par sury.

alternc-sympa

azerttyu — 2023-11-13T10:05:19Z

Plugin alternc-sympa : https://github.com/AlternC/alternc-sympa

- Les plugins

Alternc-acme

azerttyu — 2023-11-13T09:56:39Z

Ce plugin prend en charge la génération de certificats SSL selon le protocole acme.
Il est actuellement compatible avec let's encrypt via le paquet certbot

Aide AlternC v3

Traduire

Mise à jour 3.5 rcX vers 3.5.*

Principes généraux

Déclarer le dépôt AlternC

Corriger les reliquats des version 3.5 rcX

Mettre à jour AlternC vers 3.5 stable

Mettre à jour vers Bookworm

Reconfigurer AlternC

Installer

Sommaire

Pré-installation

Installation manuelle

ACL

Quota

Remontage de la partition

Installation

MariaDB / MySQL

Configuration des dépôts

Installation

DNS - serveurs de nom

Nom de domaine du serveur

Finaliser l'installation

Post Installation

Première connexion

Mise à jour 3.3.x vers 3.5.*

Principes généraux

Compatibilité des version AlternC

Mise à jour de vos dépôts

OpenDkim

Version PHP

La version maximale de PHP validée est 8.2

Incron

Postfix et Dovecot

Les versions php à disposition

Synchronisation DNS

alternc-php-fpm

alternc-sympa

Alternc-acme