Modifier le lien de connexion dans ISPmanager

Lors de l'utilisation du CMS MODx sur des serveurs où le panneau de contrôle ISPmanager est installé, des conflits surviennent lors de l'accès au panneau d'administration des sites MODx, car ils utilisent le même lien /manager/. Nous allons passer en revue plusieurs méthodes pour résoudre ce conflit en modifiant le lien d'ISPmanager.

Option 1

Modifiez l'adresse du panneau via ses paramètres internes. Dans la section « Paramètres » de votre panneau ISPmanager, sélectionnez « Adresse du panneau ». Dans la fenêtre qui s'affiche, remplacez la valeur du champ « Panneau de contrôle » par le lien souhaité.

Dans les versions récentes du panneau, la fenêtre peut avoir une apparence différente.

Le panneau modifiera automatiquement les fichiers nécessaires et redémarrera le serveur web. Immédiatement après l'entrée en vigueur des modifications, le message « Not Found » s'affichera, car le panneau est déjà accessible à la nouvelle adresse.

Dans les versions récentes du panneau, il peut être nécessaire de modifier ou de supprimer les directives de redirection dans la configuration nginx. Le panneau ne les modifie pas automatiquement. La procédure est décrite en fin d'article.

Option 2

Ajoutez un alias dans la configuration Apache, dans la section VirtualHost de votre projet MODx :

Alias /manager/ /home/user/data/www/SITE/manager/

où /home/user/data/www/SITE/manager/ est le chemin complet vers le répertoire manager de votre site MODx. Si vous ne parvenez pas à localiser le répertoire de votre site, son emplacement peut également être déterminé dans la section VirtualHost — la directive DocumentRoot indique le chemin complet vers le répertoire racine du site.

Après avoir modifié la configuration, redémarrez Apache.

Dans les versions récentes du panneau, il peut être nécessaire de modifier ou de supprimer les directives de redirection dans la configuration nginx. Le panneau ne les modifie pas automatiquement. La procédure est décrite en fin d'article.

Option 3

Modifiez le fichier /usr/local/ispmgr/etc/ispmgr.inc, qui est inclus dans le fichier de configuration principal d'Apache. Cette méthode est identique à l'option 1, mais les modifications sont effectuées manuellement. Ce fichier contient un alias qui redirige le serveur web vers le panneau ISPmanager lorsque le lien /manager/ est utilisé. Copiez le fichier :

cp /usr/local/ispmgr/etc/ispmgr.inc /usr/local/ispmgr/etc/myispmgr.inc

Dans le nouveau fichier /usr/local/ispmgr/etc/myispmgr.inc, modifiez la ligne suivante :

Alias /manager /usr/local/ispmgr/bin/

en indiquant le nouveau lien vers le panneau. Par exemple :

Alias /ispmanager /usr/local/ispmgr/bin/

Vous devrez ensuite mettre à jour le chemin du fichier dans la configuration Apache, car celui-ci ne connaît pas encore le nouveau fichier de configuration /usr/local/ispmgr/etc/myispmgr.inc. Ouvrez le fichier de configuration Apache avec un éditeur de texte (par exemple nano, joe, vi, vim) :

nano /etc/apache2/apache2.conf

et remplacez l'adresse dans la ligne

Include /usr/local/ispmgr/etc/ispmgr.inc

par

Include /usr/local/ispmgr/etc/myispmgr.inc

Le remplacement peut être effectué automatiquement avec sed :

sed -i "s/usr\/local\/ispmgr\/etc\/ispmgr.inc/usr\/local\/ispmgr\/etc\/myispmgr.inc/g" /etc/apache2/apache2.conf

Après ces modifications, redémarrez Apache.

Il peut également être nécessaire de redémarrer le panneau lui-même :

rm -rf /usr/local/ispmgr/var/.xmlcache ; killall -9 ispmgr

nginx

Les versions récentes du panneau ajoutent le fichier de configuration

/usr/local/ispmgr/etc/nginx.inc

ainsi qu'une redirection pour chaque hôte virtuel dans le fichier de configuration /etc/nginx/nginx.conf :

rewrite ^(/manager/.*)$ https://$host$1 permanent;

Notez que la redirection est créée pour un lien avec un slash final.

Pour le fichier /usr/local/ispmgr/etc/nginx.inc, vous devez modifier le bloc location :

location ^~ /manager

en indiquant le lien souhaité.

Pour supprimer la redirection nginx depuis le lien /manager/, vous pouvez commenter la ligne rewrite ^(/manager/.*)$ https://$host$1 permanent; dans le fichier de configuration de votre hôte virtuel /etc/nginx/nginx.conf, ou modifier le lien dans la directive de redirection en le remplaçant par le nouveau lien du panneau. Cela peut être fait automatiquement de la façon suivante :

sed -i "s/\^(\/manager\/\.\*)/\^(\/ispmanager\/\.\*)/g" /etc/nginx/nginx.conf

Redémarrez ensuite nginx :

/etc/init.d/nginx restart

Il peut être nécessaire de redémarrer votre navigateur.

Remarque

Le chemin du fichier de configuration du serveur web Apache dépend de votre distribution GNU/Linux.

Pour Debian, Ubuntu

/etc/apache2/apache2.conf

Pour CentOS

/etc/httpd/conf/httpd.conf

Vous pouvez redémarrer Apache avec la commande :

apachectl restart

Ou, selon la distribution :

Pour Debian, Ubuntu

/etc/init.d/apache2 restart

Pour CentOS

/etc/init.d/httpd restart