Changes

From SME Server
Jump to navigationJump to search
266 bytes added ,  21:53, 5 December 2014
m
no edit summary
Line 3: Line 3:  
{{usefulnote}}
 
{{usefulnote}}
 
<blockquote style="float: right;">[[File:roundcube.png|250px]]</blockquote><br>
 
<blockquote style="float: right;">[[File:roundcube.png|250px]]</blockquote><br>
==RoundCube V0.9.5 for SME Server==
  −
===Maintainer===
  −
[mailto:stephdl@de-labrusse.fr stephdl] Stéphane de Labrusse AKA [[User:stephdl|Stephdl]]<br />
  −
  −
[http://www.dungog.net Dungog.net] (Software) : original developper
  −
  −
===Description===
  −
RoundCube Webmail is a browser-based multilingual IMAP client with an application-like user interface. It provides full functionality you expect from an e-mail client, including MIME support, address book, folder manipulation, message searching and spell checking. For more information see ''http://www.roundcube.net/''. Actually roundcube is only available with ''beta'' status, but it run very fast and stable.
  −
  −
===Installation===
  −
Install from the [http://mirror.contribs.org/releases/7/smecontribs/i386/repoview/ SME Contribs] repository issue the following command on the SME Server shell:
  −
  −
yum --enablerepo=smecontribs install smeserver-roundcube
  −
  −
If you do not want to restart your server
  −
signal-event conf-roundcube; signal-event console-save
  −
or
  −
signal-event post-upgrade; signal-event reboot
  −
  −
===Uninstallation===
  −
To remove the package issue the following command on the SME Server shell:
  −
rpm -e roundcube smeserver-roundcube
  −
  −
To remove mysql database and user, both are roundcube, see [[MySQL#Remove a database]] and [[MySQL#Remove a user]]. There is no need to reboot.
  −
  −
===Usage===
  −
http://servername/roundcube'' and logon with your SME Server user account.
  −
  −
===Logs===
  −
Logs are available :
  −
  −
less /opt/roundcube/logs/errors
  −
  −
=== Options ===
  −
You can fine tune access to roundcube with DB settings. For details have a look at [[Web Application RPM#New DB settings]].
  −
  −
  −
====Activate Roundcube Plugin====
  −
Plugins need to be allowed in the main.config.php of roundcube, you can also write  options in this file. If you want to modify options you have to modify the template in /etc/e-smith/templates/opt/roundcube/config/main.inc.php/20plugin<br />
  −
  −
Please add all plugins you want to activate in the command line below :
  −
$rcmail_config['plugins'] = array('plugin1','plugin2','plugin3');
  −
where "plugin*" is a valid name of plugin and a valid folder name in /opt/roundcube/plugins
  −
  −
see the file 20plugin for example
  −
  −
nano /etc/e-smith/templates/opt/roundcube/config/main.inc.php/20plugin
  −
save by ctrl+x
  −
expand-template /opt/roundcube/config/main.inc.php
  −
  −
====Personal settings====
  −
  −
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.
  −
  −
* The config file is now templated, so changes need to be made in a new fragment
  −
# ll /etc/e-smith/templates/opt/roundcube/config/config.inc.php/
  −
10default_host          15Ldap_addressbook      20plugins_configuration  template-begin          template-end           
  −
  −
* check which setting you want to change with
  −
cat /opt/roundcube/config/defaults.inc.php
  −
or for a plugin like managesieve
  −
cat /opt/roundcube/plugins/managesieve/config.inc.php.dist
  −
  −
* Add the new settings in a new file
  −
vim /etc/e-smith/templates/opt/roundcube/config/config.inc.php/30my_custom_settings
  −
or for a plugin like managesieve
  −
mkdir -p /etc/e-smith/templates-custom/opt/roundcube/plugins/managesieve/config.inc.php
  −
vim /etc/e-smith/templates-custom/opt/roundcube/plugins/managesieve/config.inc.php/10pluginsetting
  −
  −
* Now you have to expand
  −
signal-event conf-roundcube
  −
  −
  −
All plugins in /opt/roundcube/plugins/ comes with their own config.inc.php.dist which you can use to set default options.
  −
  −
{{Note box|If you think your setting should be the SME default raise a bug}}
  −
  −
====Limit access to roundcube====
  −
config setprop roundcube PublicAccess OPTION
  −
  −
OPTION is either of the following.
  −
  −
        none            => No access
  −
        local            => Local network  (no password required)
  −
        local-pw        => Local network  (password required)
  −
        global          => Entire Internet(no password required)
  −
        global-pw        => Entire Internet(password required)
  −
        global-pw-remote => Entire Internet(password required outside local network)
  −
  −
{{Note box|the global option is already the default option to control access to this contribs}}
  −
  −
config setprop roundcube PublicAccess global
  −
  −
To enable your changes run these commands
  −
  −
expand-template /etc/httpd/conf/httpd.conf
  −
sv h /service/httpd-e-smith
  −
  −
====Add a different URL====
  −
by example
  −
http://yourserver.net/webmail
  −
or
  −
http://yourserver.net/mail
  −
  −
{{warning box|This URL of '''/webmail''' is used by the horde webmail, so you have to deactivated the webmail in the server-manager}}
  −
  −
{{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
  −
  −
  −
{{Note box|If you think your setting should be the SME default raise a bug}}
  −
  −
=== Bugs ===
  −
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}}.
  −
  −
  −
[[Category: Contrib]]
  −
[[Category: Webapps]]
  −
[[Category: Dungog]]
  −
[[Category: Mail]]
      
==RoundCube V1.0 for SME Server==
 
==RoundCube V1.0 for SME Server==
Line 146: Line 9:     
===Installation===
 
===Installation===
====For SME8====
+
 
 +
==== '''For SME8''' ====
 
Remember to first configure the two required repositories, [[stephdl]] and [[epel]],
 
Remember to first configure the two required repositories, [[stephdl]] and [[epel]],
 
then issue the following command on the SME Server shell:
 
then issue the following command on the SME Server shell:
Line 160: Line 24:  
  signal-event post-upgrade; signal-event reboot
 
  signal-event post-upgrade; signal-event reboot
   −
====For SME9====
+
{{#switchtablink:For SME9|Click here to go to the next tab...}}
 +
 
 +
==== '''For SME9''' ====
 
Remember to first configure the required [[stephdl]] repository, then issue the following command on the SME Server shell:
 
Remember to first configure the required [[stephdl]] repository, then issue the following command on the SME Server shell:
   Line 172: Line 38:  
or
 
or
 
  signal-event post-upgrade; signal-event reboot
 
  signal-event post-upgrade; signal-event reboot
 +
<headertabs/>
    
===Uninstallation===
 
===Uninstallation===
Line 187: Line 54:  
  less /opt/roundcube/logs/errors
 
  less /opt/roundcube/logs/errors
   −
===Access===
+
===Limit access to web interface===
 
{{Note box|By default, the Roundcube webmail interface is accessible from the entire internet without requiring additional HTTP authentication. }}
 
{{Note box|By default, the Roundcube webmail interface is accessible from the entire internet without requiring additional HTTP authentication. }}
   Line 344: Line 211:  
  # 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
 +
 +
==RoundCube V0.9.5 for SME Server==
 +
{{note box|RoundCube version 0.95beta is possibly deprecated. SME admins are encouraged to use the stable version 1.0 described above instead.}}
 +
===Maintainer===
 +
[mailto:stephdl@de-labrusse.fr stephdl] Stéphane de Labrusse AKA [[User:stephdl|Stephdl]]<br />
 +
 +
[http://www.dungog.net Dungog.net] (Software) : original developper
 +
 +
===Description===
 +
RoundCube Webmail is a browser-based multilingual IMAP client with an application-like user interface. It provides full functionality you expect from an e-mail client, including MIME support, address book, folder manipulation, message searching and spell checking. For more information see ''http://www.roundcube.net/''. Actually roundcube is only available with ''beta'' status, but it runs very fast and stable.
 +
 +
===Installation===
 +
Install from the [http://mirror.contribs.org/releases/7/smecontribs/i386/repoview/ SME Contribs] repository issue the following command on the SME Server shell:
 +
 +
yum --enablerepo=smecontribs install smeserver-roundcube
 +
 +
If you do not want to restart your server
 +
signal-event conf-roundcube; signal-event console-save
 +
or
 +
signal-event post-upgrade; signal-event reboot
 +
 +
===Uninstallation===
 +
To remove the package issue the following command on the SME Server shell:
 +
rpm -e roundcube smeserver-roundcube
 +
 +
To remove mysql database and user, both are roundcube, see [[MySQL#Remove a database]] and [[MySQL#Remove a user]]. There is no need to reboot.
 +
 +
===Usage===
 +
http://servername/roundcube'' and logon with your SME Server user account.
 +
 +
===Logs===
 +
Logs are available :
 +
 +
less /opt/roundcube/logs/errors
 +
 +
=== Options ===
 +
You can fine tune access to roundcube with DB settings. For details have a look at [[Web Application RPM#New DB settings]].
 +
 +
 +
====Activate Roundcube Plugin====
 +
Plugins need to be allowed in the main.config.php of roundcube, you can also write  options in this file. If you want to modify options you have to modify the template in /etc/e-smith/templates/opt/roundcube/config/main.inc.php/20plugin<br />
 +
 +
Please add all plugins you want to activate in the command line below :
 +
$rcmail_config['plugins'] = array('plugin1','plugin2','plugin3');
 +
where "plugin*" is a valid name of plugin and a valid folder name in /opt/roundcube/plugins
 +
 +
see the file 20plugin for example
 +
 +
nano /etc/e-smith/templates/opt/roundcube/config/main.inc.php/20plugin
 +
save by ctrl+x
 +
expand-template /opt/roundcube/config/main.inc.php
 +
 +
====Personal settings====
 +
 +
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.
 +
 +
* The config file is now templated, so changes need to be made in a new fragment
 +
# ll /etc/e-smith/templates/opt/roundcube/config/config.inc.php/
 +
10default_host          15Ldap_addressbook      20plugins_configuration  template-begin          template-end           
 +
 +
* check which setting you want to change with
 +
cat /opt/roundcube/config/defaults.inc.php
 +
or for a plugin like managesieve
 +
cat /opt/roundcube/plugins/managesieve/config.inc.php.dist
 +
 +
* Add the new settings in a new file
 +
vim /etc/e-smith/templates/opt/roundcube/config/config.inc.php/30my_custom_settings
 +
or for a plugin like managesieve
 +
mkdir -p /etc/e-smith/templates-custom/opt/roundcube/plugins/managesieve/config.inc.php
 +
vim /etc/e-smith/templates-custom/opt/roundcube/plugins/managesieve/config.inc.php/10pluginsetting
 +
 +
* Now you have to expand
 +
signal-event conf-roundcube
 +
 +
 +
All plugins in /opt/roundcube/plugins/ comes with their own config.inc.php.dist which you can use to set default options.
 +
 +
{{Note box|If you think your setting should be the SME default raise a bug}}
 +
 +
====Limit access to roundcube====
 +
config setprop roundcube PublicAccess OPTION
 +
 +
OPTION is either of the following.
 +
 +
        none            => No access
 +
        local            => Local network  (no password required)
 +
        local-pw        => Local network  (password required)
 +
        global          => Entire Internet(no password required)
 +
        global-pw        => Entire Internet(password required)
 +
        global-pw-remote => Entire Internet(password required outside local network)
 +
 +
{{Note box|the global option is already the default option to control access to this contribs}}
 +
 +
config setprop roundcube PublicAccess global
 +
 +
To enable your changes run these commands
 +
 +
expand-template /etc/httpd/conf/httpd.conf
 +
sv h /service/httpd-e-smith
 +
 +
====Add a different URL====
 +
by example
 +
http://yourserver.net/webmail
 +
or
 +
http://yourserver.net/mail
 +
 +
{{warning box|This URL of '''/webmail''' is used by the horde webmail, so you have to deactivated the webmail in the server-manager}}
 +
 +
{{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
 +
 +
 +
{{Note box|If you think your setting should be the SME default raise a bug}}
 +
 +
=== Bugs ===
 +
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}}.
 +
 +
 +
[[Category: Contrib]]
 +
[[Category: Webapps]]
 +
[[Category: Dungog]]
 +
[[Category: Mail]]
34

edits

Navigation menu