Changes

Jump to navigation Jump to search
no edit summary
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.
 
Le paquet roundcubemail_plugins est obsolète dans SME10, tout est fourni par la contribution smeserver-roundcube.
      −
{| class="wikitable"
+
{| class="wikitable centre"
!Release
+
!Version
!Released
+
!Date de publication
!Active Support
+
!Maintenance active
!Security Support
+
!Maintenance de la sécurité
!Latest
+
!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===
Line 37: Line 35:  
  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=smecontribs,remi-roundcube
 
  yum install smeserver-roundcube  --enablerepo=smecontribs,remi-roundcube
   −
Pour retrograder versionlock :
+
Si vous avez précédement verrouillé la version 1.5, pour retrograder versionlock :
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
 
yum versionlock delete roundcubemail
 
yum versionlock delete roundcubemail
yum update
+
yum update -y
/usr/bin/rcplugin_update.sh
   
signal-event smeserver-roundcube-update
 
signal-event smeserver-roundcube-update
 
</syntaxhighlight>
 
</syntaxhighlight>
Line 89: 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 SME 8
+
less /var/log/roundcubemail/errors
 +
</tab><tab name="Pour SME 8">
 
  less /opt/roundcube/logs/errors
 
  less /opt/roundcube/logs/errors
* pour SME 9 et suivantes
+
</tab></tabs>
less /var/log/roundcubemail/errors
+
 
 +
===Limiter l'accès à l'interface web===
   −
{{Note box|type=Note : |Roundcube se connectera en IMAP avec SSL au domaine principal de votre serveur. Vous avez besoin d'un certificat valide ou auto-signé incluant au moins votre propre nom de domaine comme DNS alternatif.}}
+
{{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 118: 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]].
    
=== Personnalisation ===
 
=== 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 :
 +
 +
signal-event roundcube-update
    
====Extension pour Roundcube====
 
====Extension pour Roundcube====
  −
  −
=====Extensions par défaut contenues dans la contribution smeserver-roundcube=====
  −
La contribution smeserver-roundcube est empaquetée avec les extensions suivantes déjà installées et activées par défaut :
  −
  −
config getprop roundcube PluginsList
  −
  −
''globaladdressbook,carddav,calendar,libcalendaring,contextmenu,markasjunk,vcard_attachments,newmail_notifier,emoticons,tasklist,managesieve''
      
=====Installation d'extensions supplémentaires=====
 
=====Installation d'extensions supplémentaires=====
Line 206: Line 344:  
  rcplugin_update.sh
 
  rcplugin_update.sh
   −
====Paramètres personalisés de Roundcube====
+
===Notes diverses===
 
  −
Pour des besoins spécifiques, vous pouvez créer votre fichier modèle personnalisé si vous voulez que votre fichier de configuration ne soit pas écrasé par les modèles de la contribution smeserver-roundcube. Cela s'applique aussi aux extensions de Roundcube dans /opt/roundcube/plugins/ qui viennent occasionnellement avec leur propre ficihier config.inc.php ou le fichier générique config.php.inc.dist que vous pouvez utiliser pour régler les options par défaut.
  −
 
  −
* Le fichier de configuration de Roundcube lui-même est maintenant sous forme de modèles, les modifications doivent donc être faites dans un nouveau fragment de modèle.
  −
:*pour sme8
  −
ll /etc/e-smith/templates/opt/roundcube/config/config.inc.php/
  −
  −
''10default_host          15Ldap_addressbook      20plugins_configuration  template-begin          template-end            ''
  −
:* pour 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
  −
 
  −
* Vérifier quel réglage vous voulez modifier avec :
  −
cat /etc/roundcubemail/defaults.inc.php
  −
 
  −
* Étendez les paramètres par défaut en ajoutant un nouveau fragment de modèle et ajoutez-y vos personnalisations/ajouts, par exemple :
  −
vim /etc/e-smith/templates/etc/roundcubemail/config/config.inc.php/30my_custom_settings
  −
 
  −
* A la fin, propagez le modèle :
  −
signal-event roundcube-update
  −
 
  −
De même, la personnalisation de l'extension peut être effectuée en créant des fragments de modèle personnalisés.
  −
Par exemple, pour définir si et comment le « panneau de gestion des congés » de l'extension « managesieve » doit apparaître dans l'interface webmail Roundcube :
  −
 
  −
* vérifiez la configuration actuelle de l'extension managesieve :
  −
cat /usr/share/roundcubemail/plugins/managesieve/config.inc.php
  −
 
  −
* vérifiez les fragments actues de modèles pour la configuration de l'extension :
  −
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''
  −
  ''...''
  −
 
  −
* copiez le fragment de modèle pertinent vers /etc/e-smith/templates-custom/... et modifiez le réglage : 
  −
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
+
====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.
   −
expand-template /etc/httpd/conf/httpd.conf
+
=====Dépannage=====
sv h /service/httpd-e-smith
+
* 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 [[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>
*If you want to remove completely the new url
+
** 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 !)
 
+
** 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.
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]]
3,054

edits

Navigation menu