Plugin Roundcube de ISPConfig 3 en Debian 9 (Stretch)
- Versión del sistema operativo: Debian 9.4 y 9.5 Stretch
- Versión de Roundcube: 1.2.3+dfsg.1-4+deb9u1 y u2
- Versión de ISPConfig 3: 3.1.11 y 3.1.13
Este howto se basa en las Instrucciones de Instalación de ISPConfig3_roundcube del Manual.
Requisitos previos
Utiliza la versión de Roundcube que viene con Debian 9, instálala como se indica en la Guía del Servidor Perfecto para Debian Stretch.
Utiliza ISPConfig actual, ahora la última es la versión 3.1.13.
Añadir usuario remoto ISPConfig
Añade el usuario remoto ISPConfig para el uso de Roundcube. Elige un nombre adecuado, yo uso rcmail-remote. Elige una buena contraseña, yo suelo generar contraseñas con apg, haz apt-get install apg primero.
apg -m 12 -l M NCL
Crea el usuario remoto en el Panel ISPConfig, pestaña Sistema, bajo Gestión de Usuarios está «Usuarios Remotos». Haz click en el botón «Añadir nuevo usuario».
No marqué Acceso Remoto:, mi configuración tiene un servidor de correo electrónico separado donde están instalados los archivos de correo y Roundcube y Dovecot. Así que aunque este es un «usuario remoto», en mi caso no necesita acceso remoto.
Para este usuario elige:
- Server functions - Client functions - Mail user functions - Mail alias functions - Mail spamfilter user functions - Mail spamfilter policy functions - Mail fetchmail functions - Mail spamfilter whitelist functions - Mail spamfilter blacklist functions - Mail user filter functions
Esa lista está en el orden en que aparecen los elementos en el Panel de ISPConfig.
Instala el Plugin ISPConfig RoundCube
Busca los plugins de ISPConfig3 de Github. Usé la última versión para RoundCube 1.2.3. El autor del plugin escribe en el manual que lo descargues desde Subversion directamente al directorio raíz de RoundCube. Yo prefiero hacer el check out en otro sitio, para no estropear el directorio del sistema donde apt-get instala los archivos.
El Readme.Debian en /usr/share/doc/roundcube aconseja «Añadir tu plugin en /var/lib/roundcube/plugins». Hago un checkout desde svn a /root/ISPConfig3_plugins y copio desde allí a /var/lib/roundcube/plugins. Los plugins de los paquetes Debian están instalados en /usr/share/roundcube y hay un enlace simbólico a ellos desde /var/lib/roundcube/plugins. Instala Subversion para obtener el comando svn. (apt-get install subversion).
cd /root mkdir ISPConfig3_plugins cd ISPConfig3_plugins svn co https://github.com/w2c/ispconfig3_roundcube/trunk/ .
cd ispconfig3_account/config cp config.inc.php.dist config.inc.php
Configura el Plugin
Edita el archivo copiado en el último comando de las líneas de comando anteriores. Rellena la información del usuario remoto creado en el Paso 2.
cd /root/ISPConfig3_plugins
editor ispconfig3_account/config/config.inc.php
El archivo original tiene este aspecto:
<?php $rcmail_config['identity_limit'] = false; $rcmail_config['remote_soap_user'] = 'roundcube'; $rcmail_config['remote_soap_pass'] = 'roundcube'; $rcmail_config['soap_url'] = 'http://192.177.167.44:8080/remote/'; ?>
Cambia el remote_soap_user, remote_soap_pass (usuario y pass creados en el Paso 2) y soap_url. Si utilizas el panel ISPConfig con https://, utiliza lo mismo aquí para soap_url. Puedes utilizar la dirección IP o el nombre de host y el dominio en soap_url. El número de puerto es el mismo que para el panel ISPConfig.
Activar el Plugin
Edita la configuración de Roundcube, en el archivo /etc/roundcube/config.inc.php. Busca «Lista de plugins activos». Debian Stretch no activa ningún plugin por defecto, por lo que la lista está vacía a menos que ya hayas activado algún plugin. Si la lista está vacía, es decir, tiene este aspecto
// List of active plugins (in plugins/ directory) // Debian: install roundcube-plugins first to have any $config['plugins'] = array( );
sustitúyela por esto:
$config['plugins'] = array( "jqueryui","ispconfig3_account", "ispconfig3_autoreply", "ispconfig3_autoselect", "ispconfig3_pass", "ispconfig3_spam", "ispconfig3_fetchmail", "ispconfig3_filter", "ispconfig3_forward", "ispconfig3_wblist" );
¡El orden de los plugins es importante! No cambies el orden a menos que sepas lo que haces.
Si no estaba vacía, añade los plugins de ISPConfig3 después de los plugins existentes. Si algún plugin no es necesario, elimínalo de la lista y ya no estará habilitado.
Si sólo utilizas un host de correo, elimina el plugin ispconfig3_autoselect, ya que en ese caso no lo necesitas y sólo crea problemas si no lo configuras correctamente.
He eliminado ispconfig3_forward porque he observado errores en /var/log/roundcube/errors para la línea 135 del archivo ispconfig3_forward/ispconfig3_forward.php.
Copia los plugins a la ubicación del sistema
Ahora debes copiar los plugins del directorio de comprobación a /var/lib/roundcube. Hazlo, por ejemplo, así
cd /root/ISPConfig3_plugins for f in ispconfig3_* ; do echo $f ; cp --recursive $f /var/lib/roundcube/plugins/ ; done
Probando
Si los nuevos Plugins se muestran en Configuración, pero al hacer clic en ellos aparece el mensaje de error «Soap Error: Not Found» o «Soap Error: Bad Request» comprueba la configuración de soap_url. Puede que falte el carácter de barra «/» al final.
Prueba y disfruta. Hay un 5º elemento en el menú Configuración creado por estos plugins.
Si obtienes errores, lee las Preguntas Frecuentes sobre Solución de Problemas del autor de los plugins de ISPConfig3 en https://github.com/w2c/ispconfig3_roundcube/wiki/Troubleshooting—FAQ. Si eso no ayuda, lee los logs de /var/log/roundcube/errors. Si sigues teniendo problemas, consulta otros registros en los directorios /var/log y /var/log/apache2. Si nada ayuda, comprueba que has instalado el servidor según la Guía del Servidor Perfecto. Me han dicho que la imagen de la VM no tiene instalado php-soap, y el ISPConfig instalado por script también carece de este paquete PHP.