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

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