Difference between revisions of "RoundCube/fr"

From SME Server
Jump to navigationJump to search
 
(11 intermediate revisions by the same user not shown)
Line 5: Line 5:
  
 
==RoundCube V1.0 pour le serveur SME Koozali==
 
==RoundCube V1.0 pour le serveur SME Koozali==
===Maintaineur===
+
===Mainteneur===
 
[mailto:stephdl@de-labrusse.fr stephdl] Stéphane de Labrusse AKA [[User:stephdl|Stephdl]]
 
[mailto:stephdl@de-labrusse.fr stephdl] Stéphane de Labrusse AKA [[User:stephdl|Stephdl]]
 
{{ #smeversion: smeserver-roundcube }}
 
{{ #smeversion: smeserver-roundcube }}
{{ #smeversion: roundcubemail_plugins }}
+
Le paquet roundcubemail_plugins est obsolète dans SME10, tout est fourni par la contribution smeserver-roundcube.
{| class="wikitable"
+
 
!Release
+
 
!Released
+
{| class="wikitable centre"
!Active Support
+
!Version
!Security Support
+
!Date de publication
!Latest
+
!Maintenance active
 +
!Maintenance de la sécurité
 +
!Dernière
 
|-
 
|-
 
|1.6
 
|1.6
|25 Jul 2022
+
|25 juil. 2022
|Yes
+
|Oui
|Yes
+
|Oui
|1.6.0
+
|1.6.5
 
|-
 
|-
 
|1.5 LTS
 
|1.5 LTS
|18 Oct 2021
+
|18 oct. 2021
|Yes
+
|Oui
|Yes
+
|Oui
|1.5.3
+
|1.5.6
 
|}
 
|}
 
  
 
===Installation===
 
===Installation===
 
<tabs container=""><tab name="Pour SME 10">
 
<tabs container=""><tab name="Pour SME 10">
Ceci nécessite une refonte.
 
 
Nous pouvons utiliser le dépôt Remi pour Roundcube en soi.
 
https://wiki.contribs.org/Remi-roundcube
 
 
Il aura besoin de la réécriture du plugin smeserver-roundcube pour php-fpm :
 
 
 
  yum install smeserver-extrarepositories-remi-roundcube -y
 
  yum install smeserver-extrarepositories-remi-roundcube -y
  
Pour la version LTS 1.5.3, ajouter ceci :
+
Nous ne prenons désormais en charge que la version 1.6.
yum install yum-plugin-versionlock -y
 
yum versionlock  roundcubemail-1.5.3
 
sinon vous mettrez à jour vers la version 1.6.
 
  
  yum install smeserver-roundcube  --enablerepo=smedev,smecontribs,smetest,remi-roundcube
+
  yum install smeserver-roundcube  --enablerepo=smecontribs,remi-roundcube
  
semble faire l'installation même si vous obtenez une erreur : « Could not open input file: /usr/share/roundcubemail/composer.phar »
+
Si vous avez précédement verrouillé la version 1.5, pour retrograder versionlock :
 +
<syntaxhighlight lang="bash">
 +
yum versionlock delete roundcubemail
 +
yum update -y
 +
signal-event smeserver-roundcube-update
 +
</syntaxhighlight>
  
 
</tab><tab name="Pour SME 9">
 
</tab><tab name="Pour SME 9">
 
  yum install smeserver-roundcube --enablerepo=smecontribs
 
  yum install smeserver-roundcube --enablerepo=smecontribs
  
Répondre « oui » (y) pour tous les plugins que vous voulez activer
+
Répondre « oui » (y) pour toutes les extensions que vous voulez activer
  
 
Si vous ne voulez pas redémarrer votre serveur :
 
Si vous ne voulez pas redémarrer votre serveur :
Line 87: Line 83:
 
===Utilisation===
 
===Utilisation===
 
http://nom_du_serveur/roundcube'' et se connecter avec votre compte utilisateur du serveur SME.
 
http://nom_du_serveur/roundcube'' et se connecter avec votre compte utilisateur du serveur SME.
 +
 +
{{Note box|type=Note : |Roundcube se connectera en IMAP avec SSL au domaine primaire de votre serveur.
 +
Vous avez besoin d'un certificat valide ou auto-signé incluant au moins votre propre nom de domaine comme serveur DNS alternatif.}}
  
 
===Journaux===
 
===Journaux===
Les journaux sont disponibles :
+
<tabs container=""><tab name="Pour SME 9 et les versions suivantes">
* pour sme8
+
less /var/log/roundcubemail/errors
 +
</tab><tab name="Pour SME 8">
 
  less /opt/roundcube/logs/errors
 
  less /opt/roundcube/logs/errors
* pour sme9
+
</tab></tabs>
less /var/log/roundcubemail/errors
+
 
* pour SME 10
+
===Limiter l'accès à l'interface web===
  
 +
{{Note box|type=Note : | par défaut, l'interface webmail Roundcube est accessible depuis tout l'Internet sans nécessiter une authentication HTTP supplémentaire.}}
  
===Limiter l'accès à l'interface web===
+
L'accès à Roundcube peut être ajusté finement en règlant la propriété correspondante dans la BDD de configuration du serveur SME :
{{Note box|type=Note : | par défaut, l'interface webmail Roundcube est accessible depuis tout l'internet sans nécessiter une authentication HTTP supplémentaire.}}
+
<tabs container=""><tab name="Pour la version SME 10 smeserver-roundcube-1.2-20 et les plus récentes">
 +
Pour modifier l'accès à « public », effectuer :
 +
  config setprop roundcube access public
 +
  systemctl restart httpd-e-smith
 +
ou pour modifier l'accès à « privé » (LAN + IP externes autorisées) :
 +
  config setprop roundcube access private
 +
  systemctl restart httpd-e-smith
  
L'acès à Roundcube peut être ajusté finement en règlant la propriété correspondante dans la BDD de configuration du serveur SME :
+
Pour désactiver roundcube :
 +
  config setprop roundcube status disabled
 +
  signal-event smeserver-roundcube-update
 +
Pour activer roundcube :
 +
  config setprop roundcube status enabled
 +
  signal-event smeserver-roundcube-update
  
 +
</tab><tab name="Pour les versions pour SME 10 avant la 1.2-20">
 
  config setprop roundcube PublicAccess OPTION
 
  config setprop roundcube PublicAccess OPTION
 +
où « OPTION » est l'un des paramètres suivants :
 +
 +
        none            => Pas d'accès
 +
        local            => Réseau local (mot de passe non requis)
 +
        local-pw        => Réseau local (mot de passe requis)
 +
        global          => Tout l'Internet (mot de passe non requis, c'est la configuration par défaut de SME)
 +
        global-pw        => Tout l'Internet (mot de passe requis)
 +
        global-pw-remote => Tout l'Internet (mot de passe requis en dehors du réseau local)
 +
 +
Par exemple, pour restreindre l'accès au seul LAN :
 +
 +
config setprop roundcube PublicAccess local
 +
 +
Pour activer ces modifications dans la BDD de configuration, exécutez ensuite ces commandes :
 +
systemctl restart httpd-e-smith
  
 +
</tab><tab name="Pour SME 8, 9">
 +
config setprop roundcube PublicAccess OPTION
 
où « OPTION » est l'un des paramètres suivants :
 
où « OPTION » est l'un des paramètres suivants :
  
         none            => Pas d'acès
+
         none            => Pas d'accès
 
         local            => Réseau local (mot de passe non requis)
 
         local            => Réseau local (mot de passe non requis)
 
         local-pw        => Réseau local (mot de passe requis)
 
         local-pw        => Réseau local (mot de passe requis)
Line 116: Line 146:
  
 
  config setprop roundcube PublicAccess local
 
  config setprop roundcube PublicAccess local
 
 
Pour activer ces modifications dans la BDD de configuration, exécutez ensuite ces commandes :
 
Pour activer ces modifications dans la BDD de configuration, exécutez ensuite ces commandes :
 +
systemctl restart httpd-e-smith
  
 
  expand-template /etc/httpd/conf/httpd.conf
 
  expand-template /etc/httpd/conf/httpd.conf
 
  sv h /service/httpd-e-smith
 
  sv h /service/httpd-e-smith
 +
 +
</tab></tabs>
  
 
Note : pour une description générale sur la façon de régler une BDD sur le serveur SME, jeter un œil sur [[Web Application RPM#New DB settings]].
 
Note : pour une description générale sur la façon de régler une BDD sur le serveur SME, jeter un œil sur [[Web Application RPM#New DB settings]].
  
=== Customization ===
+
=== Personnalisation ===
 +
{| class="wikitable"
 +
|+
 +
config setprop roundcube
 +
!propriété
 +
!par défaut
 +
!valeurs acceptées
 +
!commentaire
 +
|-
 +
|Dbname
 +
|roundcube
 +
|
 +
|
 +
|-
 +
|DbPassword
 +
|
 +
|
 +
|
 +
|-
 +
|DbUser
 +
|
 +
|
 +
|
 +
|-
 +
|Name
 +
|RoundCube IMAP Client
 +
|
 +
|
 +
|-
 +
|URL
 +
|
 +
|string
 +
|vous pouvez ajouter une URL à vos domaines en tant qu'alias http. Ce peut-être un webmail (si le webmail par défaut est désactivé).
 +
|-
 +
|PluginsList
 +
|globaladdressbook,contextmenu,markasjunk,vcard_attachments,newmail_notifier,emoticons,managesieve,nextcloud_attachments
 +
|comma separated list
 +
|si vous devez ajouter ou supprimer un module d'extension, vous devez modifier cette chaîne afin de le détecter .
 +
|-
 +
|access
 +
|public
 +
|private,public
 +
|
 +
|-
 +
|status
 +
|enabled
 +
|enabled,disabled
 +
|
 +
|-
 +
|MaxUploadSize
 +
|100M
 +
|
 +
|
 +
|-
 +
|MemoryLimit
 +
|512M
 +
|
 +
|
 +
|-
 +
|PHPBaseDir
 +
|/usr/share/roundcubemail:/etc/roundcubemail/:/var/log/roundcubemail:/var/lib/roundcubemail:/var/log/roundcube.log:/var/lib/php/roundcube:/home/e-smith/files/roundcube:/dev/urandom:/proc/meminfo:/usr/share/GeoIP/GeoLite2-Country.mmdb:/proc/cpuinfo
 +
|chaînes séparées par :
 +
|la propriété sera ajoutée à la chaîne existante
 +
|-
 +
|PHPmaxChildren
 +
|20
 +
|number
 +
|
 +
|-
 +
|PHPminServers
 +
|4
 +
|number
 +
|
 +
|-
 +
|PHPstartServers
 +
|6
 +
|number
 +
|
 +
|-
 +
|PHPmaxServers
 +
|8
 +
|number
 +
|
 +
|-
 +
|PHPmaxRequests
 +
|1000
 +
|number
 +
|
 +
|-
 +
|nextcloudURI
 +
|<nowiki>https://$DomainName/nextcloud</nowiki> or <nowiki>https://$nextcloud{'Virtualhost'}</nowiki>
 +
|
 +
|remplacera la valeur par défaut, utile si nextcloud n'est pas sur le même serveur
 +
|-
 +
|nextcloudFolder
 +
|Mail Attachments
 +
|string
 +
|ne peut pas être un sous-répertoire
 +
|-
 +
|NCsoftlimit
 +
|<nowiki>$qmail{'MaxMessageSize'}||'25M'</nowiki>
 +
|number with M
 +
|taille limite pour les pièces jointes
 +
|-
 +
|nextcloudBehavior
 +
|prompt
 +
|prompt,upload
 +
|afficher la boîte de dialogue ou télécharger directement
 +
|-
 +
|nextcloudVerifyCerts
 +
|true
 +
|true,false
 +
|vous permet d'outrepasser la vérification du certificat en cas de certificat auto-signé
 +
|}
  
 +
puis :
  
====Roundcube plugins====
+
signal-event roundcube-update
  
 +
====Extension pour Roundcube====
  
=====Default plugins shipped with smeserver-roundcube=====
+
=====Installation d'extensions supplémentaires=====
The smeserver-roundcube contrib is shipped with the following plugins already installed and enabled by default:
+
{{Note box|type=Note : |à contre-courant, le projet Roundcube est actuellement en train de passer de la mise à disposition d'extensions via http://trac.roundcube.net/wiki/Plugin_Repository à un nouveau référentiel d'extensions à part entière sur http://plugins.roundcube.net et un processus d'installation des extensions semi-automatisé. Les administrateurs de serveur SME sont encouragés à utiliser la nouvelle méthode de style décrite ci-dessous.}}
  
config getprop roundcube PluginsList
+
Pour installer une extension supplémentaire (absente par défaut) de Roundcube au roundcube du serveur SME server :
 
''globaladdressbook,carddav,calendar,libcalendaring,contextmenu,markasjunk,vcard_attachments,newmail_notifier,emoticons,tasklist,managesieve''
 
  
=====Installing additional plugins=====
+
'''Étape 1 :''' chercher la page de l'extension sur http://plugins.roundcube.net/packages (par exemple : http://plugins.roundcube.net/packages/cor/message_highlight)
{{Note box|The upstream Roundcube project is currently transitioning from making plugins available through http://trac.roundcube.net/wiki/Plugin_Repository to a new full fledged plugin repository at http://plugins.roundcube.net and a semi-automated plugin installation process. SME server admins are encouraged to use the new style method described below. }}
 
  
To install an additional (non-default) Roundcube plugin in SME server roundcube :
+
'''Étape 2 :''' prendre note du nom du paquet et de la version indiqués dans le 'require:' ligne de droite sous le titre de l'en-tête de la version de l'extension (par exemple : "cor/message_highlight" : "dev-master")
  
'''Step 1:''' Find the plugin page on http://plugins.roundcube.net/packages (eg. http://plugins.roundcube.net/packages/cor/message_highlight)
+
'''Étape 3 :''' ajouter le nom du paquet et la version au bloc "require:" dans /opt/roundcube/composer.json. Faire attention au séparateur virgule (,), c'est très important !
 +
<tabs container=""><tab name="Pour SME 10">
 +
cd /usr/share/roundcubemail
 +
/usr/bin/php74  /usr/local/bin/composer require cor/message_highlight --with-dependencies
 +
</tab><tab name="Pour SME 9">
 +
* for sme9
 +
nano /usr/share/roundcubemail/composer.json
  
'''Step 2:''' Take note of the package name and version shown in the 'require:' line right below the title of the plugin's version heading (eg. "cor/message_highlight": "dev-master")
+
  "require": {
 +
      "php": ">=5.3.0",
 +
      "roundcube/plugin-installer": ">=0.1.3",
 +
      "johndoh/markasjunk2": "dev-release-1.0",
 +
      "johndoh/contextmenu": "dev-master",
 +
      "johndoh/globaladdressbook": "dev-release-1.0",
 +
        "cor/message_highlight": "dev-master"
 +
    },
  
'''Step 3:''' Add the package name and version to the "require:" block in /opt/roundcube/composer.json. Take attention to the comma (,) separator, it is really important!
+
</tab><tab name="Pour SME 8">
* for sme8
 
 
  nano /opt/roundcube/composer.json
 
  nano /opt/roundcube/composer.json
* for sme9
 
nano /usr/share/roundcubemail/composer.json
 
  
 
   "require": {
 
   "require": {
Line 160: Line 314:
 
         "cor/message_highlight": "dev-master"
 
         "cor/message_highlight": "dev-master"
 
     },
 
     },
 +
</tab></tabs>
  
* for sme10 nothing to do there.
+
'''Étape 4 :''' après chaque modification de composer.json, de façon à télécharger automatiquement et à installer l'extension, lancer :
 
 
'''Step 4:''' after each modification to composer.json, in order to automatically download and install the plugin launch
 
 
  rcplugin_update.sh
 
  rcplugin_update.sh
  
When asked, answer yes to automatically activate the plugin in the current Roundcube configuration.
+
A la demande, répondre « yes » pour activer automatiquement l'extension dans la configuration actuelle de Roundcube.
  
'''Step 5:''' In order to keep the list of installed plugins persistent when this contrib is updated (ie. configuration templates are expanded again), you *absolutely* need to add the newly installed Roundcube plugin to the "PluginsList" property of "roundcube" in the configuration database of SME server in addition to steps above:
+
'''Étape 5 :''' de façon à garder pérenne la liste des extensions installées quand la contribution est mise à jour (c'est-à-dire que les modèles de configuration soient à nouveau propagés), vous devez *absolument* ajouter l'extension de RoundCube nouvellement installée à la propriété "PluginsList" de "roundcube" dans la base de données (BDD) de configuration du serveur SME par les étapes supplémentaires ci-après :
  
'''Step 5a:''' First show the list of plugins currently in the configuration DB:
+
'''Étape 5a :''' afficher d'abord la liste des extensions actuelles dans la BDD de configuration :
  
 
  config getprop roundcube PluginsList
 
  config getprop roundcube PluginsList
Line 176: Line 329:
 
  ''PluginsList=globaladdressbook,carddav,calendar,libcalendaring,contextmenu,markasjunk,vcard_attachments,newmail_notifier,emoticons,tasklist,managesieve''
 
  ''PluginsList=globaladdressbook,carddav,calendar,libcalendaring,contextmenu,markasjunk,vcard_attachments,newmail_notifier,emoticons,tasklist,managesieve''
  
'''Step 5b:''' Add your newly installed plugin to the list (separated by a comma (,) and without spaces) and activate the change:
+
'''Étape 5b :''' ajouter l'extension nouvellement installée à la liste (separée par une virgule (,) est sans espaces) et enregistrer la modification :
  
 
  config setprop roundcube PluginsList globaladdressbook,carddav,calendar,libcalendaring,contextmenu,markasjunk2,vcard_attachments,newmail_notifier,emoticons,tasklist,managesieve,message_highlight
 
  config setprop roundcube PluginsList globaladdressbook,carddav,calendar,libcalendaring,contextmenu,markasjunk2,vcard_attachments,newmail_notifier,emoticons,tasklist,managesieve,message_highlight
  
'''Step 5c:''' Activate the changes to the config DB:
+
'''Étape 5c :''' enregistrer les modifications dans la BDD de configuration :
 
  signal-event roundcube-update
 
  signal-event roundcube-update
  
Step 5 in short, using backticks:
+
Étape 5 en raccourci, en utilisant les apostrophes inverses (Alt Gr + 7) :
  
 
  config setprop roundcube PluginsList `config getprop roundcube PluginsList`,message_highlight
 
  config setprop roundcube PluginsList `config getprop roundcube PluginsList`,message_highlight
 
  signal-event conf-roundcube
 
  signal-event conf-roundcube
  
To check for updates to plugins already installed, you can at any time issue the following command again:
+
Pour vérifier l'existence de mises à jour des extensions déjà installées, vous pouvez à tout moment re-exécuter la commande suivante :
 
  rcplugin_update.sh
 
  rcplugin_update.sh
  
====Customize Roundcube settings====
+
===Notes diverses===
  
For special needs you should create your personal template file if you want your config file will not be overwritten by the smeserver-roundcube templates. This also applies to Roundcube plugins in /opt/roundcube/plugins/ which occasionally come with their own config.inc.php or generic config.php.inc.dist which you can use to set default options.
+
====Prise en charge du filtre de messagerie (Sieve)====
 +
Roundcube sur le serveur SME comprend l'extension « managesieve » installée et activée par défaut (sieverules est obsolète et vous devez utiliser uniquement managesieve). L'extension « managesieve » ajoute dans le menu des items supplémentaires aux réglages de l'interface web de Roundcube pour permettre aux utilisateurs de définir commodément les filtres des courriels et les messages d'absence.
  
* The config file for Roundcube itself is now templated, so changes need to be made in a new custom template fragment
+
=====Dépannage=====
:*for sme8
+
* Si les courriels ne sont pas correctement filtrés par les filtres configurés dans les paramètres utilisateur de RoundCube, vérifier les points suivants :
ll /etc/e-smith/templates/opt/roundcube/config/config.inc.php/
+
** est-ce que la contribution [[Dovecot-extras|smeserver-dovecot-extras]] est installée et le service « sieve » activé ( <tt>config getprop sieve status</tt> => enabled ) ? S'il n'est pas activé : <tt>config setprop sieve status enabled</tt>
+
** est-ce que l'utilisation de « sieve » a été délibérement désactivée pour l'utilisateur en question ( <tt>db accounts getprop $USER Sieve</tt> => disabled ) ? S'il a été désactivé : <tt>db accounts setprop $USER Sieve enabled</tt> (Notez le « S » majuscule dans Sieve !)
''10default_host          15Ldap_addressbook      20plugins_configuration  template-begin          template-end            ''
+
** si la contribution [[Mailsorting|smeserver-mailsorting]] est aussi installée sur le serveur, les courriels sont en premier lieu filtrés par procmail ou maildrop avant qu'ils ne soient remis à l'agent de réception dovecot et aux filtres sieve. Il y a de fortes chances qu'une règle existe dans le fichier .procmailrc ou .mailfilter d'un utilisateur qui intercepte tous les courriels avant qu'ils n'atteignent la dernière étape du processus de distribution.
:* for sme9/sme10
 
ls /etc/e-smith/templates/etc/roundcubemail/config.inc.php/
 
10SQL_DATABASE  20LOGGING_DEBUGGING  30IMAP  40SMTP  50LDAP  60SYSTEM  70USER_INTERFACE  80ADDRESSBOOKS_SETTINGS  90USER_PREFERENCES  95PLUGINS  template-begin  template-end
 
 
 
* check which setting you want to change with
 
cat /etc/roundcubemail/defaults.inc.php
 
 
 
* Extend the default settings by adding a new template fragment and add your customizations/additions there, eg.:
 
vim /etc/e-smith/templates/etc/roundcubemail/config/config.inc.php/30my_custom_settings
 
 
 
* Finally, expand the template:
 
signal-event roundcube-update
 
 
 
Likewise, plugin customization can be done by creating custom template fragments.
 
For example, to set if and how the "vacation management panel" of the "managesieve" plugin should appear in the Roundcube webmail frontend:
 
 
 
* check the current configuration of the managesieve plugin:
 
cat /usr/share/roundcubemail/plugins/managesieve/config.inc.php
 
 
 
* check current template fragments for the plugin configuration:
 
ll /etc/e-smith/templates/usr/share/roundcubemail/plugins/managesieve/config.inc.php/
 
 
 
  ''...''
 
  ''-rw-r--r-- 1 root root  266 30. Nov 19:45 30showvacation''
 
  ''...''
 
 
 
* copy the relevant template fragment to /etc/e-smith/templates-custom/... and modify the setting: 
 
mkdir -p /etc/e-smith/templates-custom/usr/share/roundcubemail/plugins/managesieve/config.inc.php
 
 
 
cp /etc/e-smith/templates/usr/share/roundcubemail/plugins/managesieve/config.inc.php/30showvacation /etc/e-smith/templates-custom/usr/share/roundcubemail/plugins/managesieve/config.inc.php/
 
 
vim /etc/e-smith/templates-custom/usr/share/roundcubemail/plugins/managesieve/config.inc.php/30showvacation
 
 
 
* Finally, expand the customized template:
 
signal-event roundcube-update
 
{{Note box|If you think your setting should be the SME default raise a bug}}
 
 
 
====Add an alternative URL====
 
 
 
If Roundcube should be reachable by an alternative URL to http://yourserver.net/roundcube, eg.
 
 
 
http://yourserver.net/webmail
 
or
 
http://yourserver.net/mail
 
 
 
{{warning box|The URL '''/webmail''' is by default used by the horde webmail, so you have to deactivate the webmail in the server-manager's "Configuration" -> "Email" panel if you want to use it for roundcube instead.}}
 
 
 
{{note box|this adds another url, it doesn't remove the default}}
 
 
 
config setprop roundcube URL webmail
 
or
 
config setprop roundcube URL mail
 
 
 
To enable your changes run these commands
 
 
 
expand-template /etc/httpd/conf/httpd.conf
 
sv h /service/httpd-e-smith
 
 
 
*If you want to remove completely the new url
 
 
 
config delprop roundcube URL
 
 
 
then
 
 
 
expand-template /etc/httpd/conf/httpd.conf
 
sv h /service/httpd-e-smith
 
 
 
===Miscellaneous notes===
 
 
 
====Mail filter support (Sieve)====
 
Roundcube V1.0 on SME server comes with the managesieve plugin installed and enabled by default. The managesieve plugin adds additional menu items to the settings in Roundcube's webinterface to allow users to define mail filters and vacation messages in a convenient way. However, to make use of these features, the [[Dovecot-extras|smeserver-dovecot-extras]] contrib also has to be installed (this adds sieve script support and a manage sieve daemon to SME server). If these features are not wanted, Roundcube's managesieve plugin should be disabled (reverse [[#Adding additional plugins|Step 5 described above]], ie. remove <tt>managesieve</tt> from the list of installed plugins).
 
 
 
{{Warning box|sieverules has been deprecated and you must only use managesieve}}
 
 
 
=====Troubleshooting=====
 
* If mails are not correctly filtered by the filters configured in user's roundcube settings, check the following:
 
** Is [[Dovecot-extras|smeserver-dovecot-extras]] installed and is the sieve service enabled ( <tt>config getprop sieve status</tt> => enabled )? If it is not enabled: <tt>config setprop sieve status enabled</tt>
 
** Is using sieve deliberately disabled for the user in question ( <tt>db accounts getprop $USER Sieve</tt> => disabled )? If it is disabled: <tt>db accounts setprop $USER Sieve enabled</tt> (Note the capital "S" in Sieve!)
 
** If [[Mailsorting|smeserver-mailsorting]] is also installed on the server, mails are first filtered by procmail or maildrop before they are handed off to the dovecot delivery agent and sieve filters. Chances are that a rule exists in a user's .procmailrc or .mailfilter file that intercepts all mails before they get to the latter stage in the mail delivery process.
 
 
      
 
      
 
------------------
 
------------------
  
=== Bugs ===
+
=== Bogues ===
Please raise bugs under the SME-Contribs section in {{BugzillaFileBug|product=|component=|title=bugzilla}}and select the smeserver-roundcube component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-roundcube|title=this link}}.
+
Veuillez ouvrir les bogues dans la section SME-Contribs dans {{BugzillaFileBug|product=|component=|title=bugzilla}}et sélectionner le composant smeserver-roundcube ou utiliser{{BugzillaFileBug|product=SME%20Contribs|component=smeserver-roundcube|title=ce lien}}.
 +
 
 
* smeserver-roundcube
 
* smeserver-roundcube
{{#bugzilla:columns=id,product,version,status,summary |sort=id|order=desc |component=smeserver-roundcube|noresultsmessage="No open bugs found."}}
+
{{#bugzilla:columns=id,product,version,status,summary |sort=id|order=desc |component=smeserver-roundcube|noresultsmessage="Pas trouvé de bogues ouverts."}}
 
* roundcubemail_plugins
 
* roundcubemail_plugins
{{#bugzilla:columns=id,product,version,status,summary |sort=id|order=desc |component=roundcubemail_plugins|noresultsmessage="No open bugs found."}}
+
{{#bugzilla:columns=id,product,version,status,summary |sort=id|order=desc |component=roundcubemail_plugins|noresultsmessage="Pas trouvé de bogues ouverts."}}
  
 
[[Category: Contrib/fr]]
 
[[Category: Contrib/fr]]

Latest revision as of 11:19, 27 February 2024


PythonIcon.png Skill level: Easy
Les instructions pour installation et l'utilisation de Roundcube peuvent être suivies par un débutant ; la modification des options nécessite une connaissance basique de Linux.


Is this article helpful to you?
Please consider donating or volunteering
Thank you!

Roundcube.png


RoundCube V1.0 pour le serveur SME Koozali

Mainteneur

stephdl Stéphane de Labrusse AKA Stephdl

Contrib 10:
Contrib 9:
smeserver-roundcube
The latest version of smeserver-roundcube is available in the SME repository, click on the version number(s) for more information.


Le paquet roundcubemail_plugins est obsolète dans SME10, tout est fourni par la contribution smeserver-roundcube.


Version Date de publication Maintenance active Maintenance de la sécurité Dernière
1.6 25 juil. 2022 Oui Oui 1.6.5
1.5 LTS 18 oct. 2021 Oui Oui 1.5.6

Installation

yum install smeserver-extrarepositories-remi-roundcube -y

Nous ne prenons désormais en charge que la version 1.6.

yum install smeserver-roundcube   --enablerepo=smecontribs,remi-roundcube

Si vous avez précédement verrouillé la version 1.5, pour retrograder versionlock :

yum versionlock delete roundcubemail
yum update -y
signal-event smeserver-roundcube-update
yum install smeserver-roundcube --enablerepo=smecontribs

Répondre « oui » (y) pour toutes les extensions que vous voulez activer

Si vous ne voulez pas redémarrer votre serveur :

signal-event roundcube-update

sinon :

signal-event post-upgrade; signal-event reboot

Mise à jour :

yum upgrade --enablerepo=smecontribs,remi-roundcube

For SME8

Remember to first configure the two required repositories, stephdl and epel, then issue the following command on the SME Server shell:

yum install smeserver-roundcube --enablerepo=epel,stephdl
rcplugin_update.sh

answer yes (y) for all plugins you want to activate

If you do not want to restart your server

signal-event roundcube-update

or

signal-event post-upgrade; signal-event reboot

Désinstallation

Pour supprimer le paquet, exécutez la commande suivante sur l'interface du serveur SME :

yum remove roundcube smeserver-roundcube smeserver-roundcube_plugins

Pour supprimer la base de données mysql et l'utilisateur, les deux appartenants à RoundCube, voir MySQL#Remove a database and MySQL#Remove a user. Il n'y a pas besoin de redémarrer.

Utilisation

http://nom_du_serveur/roundcube et se connecter avec votre compte utilisateur du serveur SME.


Important.png Note :
Roundcube se connectera en IMAP avec SSL au domaine primaire de votre serveur.

Vous avez besoin d'un certificat valide ou auto-signé incluant au moins votre propre nom de domaine comme serveur DNS alternatif.


Journaux

less /var/log/roundcubemail/errors
less /opt/roundcube/logs/errors

Limiter l'accès à l'interface web

Important.png Note :
par défaut, l'interface webmail Roundcube est accessible depuis tout l'Internet sans nécessiter une authentication HTTP supplémentaire.


L'accès à Roundcube peut être ajusté finement en règlant la propriété correspondante dans la BDD de configuration du serveur SME :

Pour modifier l'accès à « public », effectuer :

 config setprop roundcube access public
 systemctl restart httpd-e-smith

ou pour modifier l'accès à « privé » (LAN + IP externes autorisées) :

 config setprop roundcube access private
 systemctl restart httpd-e-smith

Pour désactiver roundcube :

 config setprop roundcube status disabled
 signal-event smeserver-roundcube-update

Pour activer roundcube :

 config setprop roundcube status enabled
 signal-event smeserver-roundcube-update
config setprop roundcube PublicAccess OPTION

où « OPTION » est l'un des paramètres suivants :

       none             => Pas d'accès
       local            => Réseau local (mot de passe non requis)
       local-pw         => Réseau local (mot de passe requis)
       global           => Tout l'Internet (mot de passe non requis, c'est la configuration par défaut de SME)
       global-pw        => Tout l'Internet (mot de passe requis)
       global-pw-remote => Tout l'Internet (mot de passe requis en dehors du réseau local)

Par exemple, pour restreindre l'accès au seul LAN :

config setprop roundcube PublicAccess local

Pour activer ces modifications dans la BDD de configuration, exécutez ensuite ces commandes :

systemctl restart httpd-e-smith
config setprop roundcube PublicAccess OPTION

où « OPTION » est l'un des paramètres suivants :

       none             => Pas d'accès
       local            => Réseau local (mot de passe non requis)
       local-pw         => Réseau local (mot de passe requis)
       global           => Tout l'Internet (mot de passe non requis, c'est la configuration par défaut de SME)
       global-pw        => Tout l'Internet (mot de passe requis)
       global-pw-remote => Tout l'Internet (mot de passe requis en dehors du réseau local)

Par exemple, pour restreindre l'accès au seul LAN :

config setprop roundcube PublicAccess local

Pour activer ces modifications dans la BDD de configuration, exécutez ensuite ces commandes :

systemctl restart httpd-e-smith
expand-template /etc/httpd/conf/httpd.conf
sv h /service/httpd-e-smith

Note : pour une description générale sur la façon de régler une BDD sur le serveur SME, jeter un œil sur Web Application RPM#New DB settings.

Personnalisation

config setprop roundcube
propriété par défaut valeurs acceptées commentaire
Dbname roundcube
DbPassword
DbUser
Name RoundCube IMAP Client
URL string vous pouvez ajouter une URL à vos domaines en tant qu'alias http. Ce peut-être un webmail (si le webmail par défaut est désactivé).
PluginsList globaladdressbook,contextmenu,markasjunk,vcard_attachments,newmail_notifier,emoticons,managesieve,nextcloud_attachments comma separated list si vous devez ajouter ou supprimer un module d'extension, vous devez modifier cette chaîne afin de le détecter .
access public private,public
status enabled enabled,disabled
MaxUploadSize 100M
MemoryLimit 512M
PHPBaseDir /usr/share/roundcubemail:/etc/roundcubemail/:/var/log/roundcubemail:/var/lib/roundcubemail:/var/log/roundcube.log:/var/lib/php/roundcube:/home/e-smith/files/roundcube:/dev/urandom:/proc/meminfo:/usr/share/GeoIP/GeoLite2-Country.mmdb:/proc/cpuinfo chaînes séparées par : la propriété sera ajoutée à la chaîne existante
PHPmaxChildren 20 number
PHPminServers 4 number
PHPstartServers 6 number
PHPmaxServers 8 number
PHPmaxRequests 1000 number
nextcloudURI https://$DomainName/nextcloud or https://$nextcloud{'Virtualhost'} remplacera la valeur par défaut, utile si nextcloud n'est pas sur le même serveur
nextcloudFolder Mail Attachments string ne peut pas être un sous-répertoire
NCsoftlimit $qmail{'MaxMessageSize'}||'25M' number with M taille limite pour les pièces jointes
nextcloudBehavior prompt prompt,upload afficher la boîte de dialogue ou télécharger directement
nextcloudVerifyCerts true true,false vous permet d'outrepasser la vérification du certificat en cas de certificat auto-signé

puis :

signal-event roundcube-update

Extension pour Roundcube

Installation d'extensions supplémentaires
Important.png Note :
à contre-courant, le projet Roundcube est actuellement en train de passer de la mise à disposition d'extensions via http://trac.roundcube.net/wiki/Plugin_Repository à un nouveau référentiel d'extensions à part entière sur http://plugins.roundcube.net et un processus d'installation des extensions semi-automatisé. Les administrateurs de serveur SME sont encouragés à utiliser la nouvelle méthode de style décrite ci-dessous.


Pour installer une extension supplémentaire (absente par défaut) de Roundcube au roundcube du serveur SME server :

Étape 1 : chercher la page de l'extension sur http://plugins.roundcube.net/packages (par exemple : http://plugins.roundcube.net/packages/cor/message_highlight)

Étape 2 : prendre note du nom du paquet et de la version indiqués dans le 'require:' ligne de droite sous le titre de l'en-tête de la version de l'extension (par exemple : "cor/message_highlight" : "dev-master")

Étape 3 : ajouter le nom du paquet et la version au bloc "require:" dans /opt/roundcube/composer.json. Faire attention au séparateur virgule (,), c'est très important !

cd /usr/share/roundcubemail
/usr/bin/php74  /usr/local/bin/composer require cor/message_highlight --with-dependencies
  • for sme9
nano /usr/share/roundcubemail/composer.json
 "require": {
      	"php": ">=5.3.0",
      	"roundcube/plugin-installer": ">=0.1.3",
      	"johndoh/markasjunk2": "dev-release-1.0",
      	"johndoh/contextmenu": "dev-master",
      	"johndoh/globaladdressbook": "dev-release-1.0",
        "cor/message_highlight": "dev-master"
    },
nano /opt/roundcube/composer.json
 "require": {
      	"php": ">=5.3.0",
      	"roundcube/plugin-installer": ">=0.1.3",
      	"johndoh/markasjunk2": "dev-release-1.0",
      	"johndoh/contextmenu": "dev-master",
      	"johndoh/globaladdressbook": "dev-release-1.0",
        "cor/message_highlight": "dev-master"
    },

Étape 4 : après chaque modification de composer.json, de façon à télécharger automatiquement et à installer l'extension, lancer :

rcplugin_update.sh

A la demande, répondre « yes » pour activer automatiquement l'extension dans la configuration actuelle de Roundcube.

Étape 5 : de façon à garder pérenne la liste des extensions installées quand la contribution est mise à jour (c'est-à-dire que les modèles de configuration soient à nouveau propagés), vous devez *absolument* ajouter l'extension de RoundCube nouvellement installée à la propriété "PluginsList" de "roundcube" dans la base de données (BDD) de configuration du serveur SME par les étapes supplémentaires ci-après :

Étape 5a : afficher d'abord la liste des extensions actuelles dans la BDD de configuration :

config getprop roundcube PluginsList

PluginsList=globaladdressbook,carddav,calendar,libcalendaring,contextmenu,markasjunk,vcard_attachments,newmail_notifier,emoticons,tasklist,managesieve

Étape 5b : ajouter l'extension nouvellement installée à la liste (separée par une virgule (,) est sans espaces) et enregistrer la modification :

config setprop roundcube PluginsList globaladdressbook,carddav,calendar,libcalendaring,contextmenu,markasjunk2,vcard_attachments,newmail_notifier,emoticons,tasklist,managesieve,message_highlight

Étape 5c : enregistrer les modifications dans la BDD de configuration :

signal-event roundcube-update

Étape 5 en raccourci, en utilisant les apostrophes inverses (Alt Gr + 7) :

config setprop roundcube PluginsList `config getprop roundcube PluginsList`,message_highlight
signal-event conf-roundcube

Pour vérifier l'existence de mises à jour des extensions déjà installées, vous pouvez à tout moment re-exécuter la commande suivante :

rcplugin_update.sh

Notes diverses

Prise en charge du filtre de messagerie (Sieve)

Roundcube sur le serveur SME comprend l'extension « managesieve » installée et activée par défaut (sieverules est obsolète et vous devez utiliser uniquement managesieve). L'extension « managesieve » ajoute dans le menu des items supplémentaires aux réglages de l'interface web de Roundcube pour permettre aux utilisateurs de définir commodément les filtres des courriels et les messages d'absence.

Dépannage
  • Si les courriels ne sont pas correctement filtrés par les filtres configurés dans les paramètres utilisateur de RoundCube, vérifier les points suivants :
    • est-ce que la contribution smeserver-dovecot-extras est installée et le service « sieve » activé ( config getprop sieve status => enabled ) ? S'il n'est pas activé : config setprop sieve status enabled
    • est-ce que l'utilisation de « sieve » a été délibérement désactivée pour l'utilisateur en question ( db accounts getprop $USER Sieve => disabled ) ? S'il a été désactivé : db accounts setprop $USER Sieve enabled (Notez le « S » majuscule dans Sieve !)
    • si la contribution smeserver-mailsorting est aussi installée sur le serveur, les courriels sont en premier lieu filtrés par procmail ou maildrop avant qu'ils ne soient remis à l'agent de réception dovecot et aux filtres sieve. Il y a de fortes chances qu'une règle existe dans le fichier .procmailrc ou .mailfilter d'un utilisateur qui intercepte tous les courriels avant qu'ils n'atteignent la dernière étape du processus de distribution.

Bogues

Veuillez ouvrir les bogues dans la section SME-Contribs dans bugzilla et sélectionner le composant smeserver-roundcube ou utiliser ce lien .

  • smeserver-roundcube
IDProductVersionStatusSummary (2 tasks)
12587SME Contribs10.0CONFIRMEDcomposer installs skins in plugins folder
12270SME Contribs10.0CONFIRMEDNFR: Allow the specification of the host for the imap mail
  • roundcubemail_plugins
"Pas trouvé de bogues ouverts."