Mudando de SquirrelMail para RoundCube no seu Servidor ISPConfig3

Este tutorial foi criado para aqueles que instalaram O Servidor Perfeito - CentOS 5.4 x86_64 [ISPConfig 3] e não gostam do SquirrelMail como cliente de webmail. Aqui está um guia para substituir o SquirrelMail pelo RoundCube, que é mais visualmente atraente e mais fácil de gerenciar para nossos clientes.

Importante! Eu não tentei, mas… como instalar o SquirrelMail não mudou nos recentes Howtos do Servidor Perfeito CentOS 5.x. Eu acho que este tutorial também é válido para versões anteriores do CentOS, e até mesmo outras distribuições Linux, não muda praticamente nada no sistema.

Passo 1.

Baixe o RoundCube, descompacte, remova arquivos desnecessários e prepare a pasta de instalação. Substitua roundcubemail-0.3.1 pela última disponível.

cd /usr/share  
wget http://downloads.sourceforge.net/project/roundcubemail/roundcubemail/0.3.1/roundcubemail-0.3.1.tar.gz?use_mirror=ignum  
tar -vxf roundcubemail-0.3.1.tar.gz  
rm -fr roundcubemail-0.3.1.tar.gz  
cd roundcubemail-0.3.1  
rm -fr installer  
chmod 755 temp logs  
cd config  
cp db.inc.php.dist db.inc.php  
cp main.inc.php.dist main.inc.php

Passo 2.

Agora vamos criar nosso banco de dados para o RoundCube. Eu criei o meu com o ISPConfig porque quero que ele seja exibido na minha lista de bancos de dados do ISPConfig. Este é meu exemplo de Banco de Dados:

Nome do banco de dados: roundcubedb  
Usuário do banco de dados: roundcubeuser  
Senha do banco de dados: 12345

Altere isso para mais segurança

Passo 3.

É necessário instalar o RoundCube manualmente, porque se você usar o instalador do RoundCube, ele relatará um erro de versão do php e não continuará com a instalação. Edite o arquivo db.inc.php, procure a seguinte linha e edite-a com nossos dados (o banco de dados que criamos no ISPConfig).

vi db.inc.php

Altere a linha:

[...]  
$rcmail_config['db_dsnw'] = 'mysql://roundcube:pass@localhost/roundcubemail';  
[...]

para:

[...]  
$rcmail_config['db_dsnw'] = 'mysql://roundcubeuser:12345@localhost/roundcubedb';  
[...]

Também altere essas configurações no arquivo main.inc.php:

vi main.inc.php

Altere as linhas:

[...]  
$rcmail_config['message_cache_lifetime'] = '10d';  
[...]  
$rcmail_config['default_host'] = '';  
[...]  
$rcmail_config['smtp_server'] = '';  
[...]  
$rcmail_config['session_lifetime'] = 10;  
[...]  
$rcmail_config['create_default_folders'] = FALSE;  
[...]

para:

[...]  
$rcmail_config['message_cache_lifetime'] = '30m';   
[...]  
$rcmail_config['default_host'] = 'localhost';  
[...]  
$rcmail_config['smtp_server'] = '%h';   
[...]  
$rcmail_config['session_lifetime'] = 30;   
[...]  
$rcmail_config['create_default_folders'] = TRUE;  
[...]

Passo 4.

Agora precisamos criar manualmente as tabelas no nosso banco de dados RoundCube. Procure o arquivo mysql.initial.sql na pasta roundcubemail-0.3.1/SQL/ e copie seu conteúdo:

-- Estrutura inicial do banco de dados RoundCube Webmail
/*!40014  SET FOREIGN_KEY_CHECKS=0 */;
-- Estrutura da tabela para a tabela `session`
CREATE TABLE `session` (
 `sess_id` varchar(40) NOT NULL,
 `created` datetime NOT NULL DEFAULT '1000-01-01 00:00:00',
 `changed` datetime NOT NULL DEFAULT '1000-01-01 00:00:00',
 `ip` varchar(40) NOT NULL,
 `vars` mediumtext NOT NULL,
 PRIMARY KEY(`sess_id`),
 INDEX `changed_index` (`changed`)
) /*!40000 ENGINE=INNODB */ /*!40101 CHARACTER SET utf8 COLLATE utf8_general_ci */;
-- Estrutura da tabela para a tabela `users`
CREATE TABLE `users` (
 `user_id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
 `username` varchar(128) NOT NULL,
 `mail_host` varchar(128) NOT NULL,
 `alias` varchar(128) NOT NULL,
 `created` datetime NOT NULL DEFAULT '1000-01-01 00:00:00',
 `last_login` datetime NOT NULL DEFAULT '1000-01-01 00:00:00',
 `language` varchar(5),
 `preferences` text,
 PRIMARY KEY(`user_id`),
 INDEX `username_index` (`username`),
 INDEX `alias_index` (`alias`)
) /*!40000 ENGINE=INNODB */ /*!40101 CHARACTER SET utf8 COLLATE utf8_general_ci */;
-- Estrutura da tabela para a tabela `messages`
CREATE TABLE `messages` (
 `message_id` int(11) UNSIGNED NOT NULL AUTO_INCREMENT,
 `user_id` int(10) UNSIGNED NOT NULL DEFAULT '0',
 `del` tinyint(1) NOT NULL DEFAULT '0',
 `cache_key` varchar(128) /*!40101 CHARACTER SET ascii COLLATE ascii_general_ci */ NOT NULL,
 `created` datetime NOT NULL DEFAULT '1000-01-01 00:00:00',
 `idx` int(11) UNSIGNED NOT NULL DEFAULT '0',
 `uid` int(11) UNSIGNED NOT NULL DEFAULT '0',
 `subject` varchar(255) NOT NULL,
 `from` varchar(255) NOT NULL,
 `to` varchar(255) NOT NULL,
 `cc` varchar(255) NOT NULL,
 `date` datetime NOT NULL DEFAULT '1000-01-01 00:00:00',
 `size` int(11) UNSIGNED NOT NULL DEFAULT '0',
 `headers` text NOT NULL,
 `structure` text,
 PRIMARY KEY(`message_id`),
 INDEX `created_index` (`created`),
 INDEX `index_index` (`user_id`, `cache_key`, `idx`),
 UNIQUE `uniqueness` (`user_id`, `cache_key`, `uid`),
 CONSTRAINT `user_id_fk_messages` FOREIGN KEY (`user_id`)
   REFERENCES `users`(`user_id`)
   /*!40008
     ON DELETE CASCADE
     ON UPDATE CASCADE */
) /*!40000 ENGINE=INNODB */ /*!40101 CHARACTER SET utf8 COLLATE utf8_general_ci */;
-- Estrutura da tabela para a tabela `cache`
CREATE TABLE `cache` (
 `cache_id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
 `cache_key` varchar(128) /*!40101 CHARACTER SET ascii COLLATE ascii_general_ci */ NOT NULL ,
 `created` datetime NOT NULL DEFAULT '1000-01-01 00:00:00',
 `data` longtext NOT NULL,
 `user_id` int(10) UNSIGNED NOT NULL DEFAULT '0',
 PRIMARY KEY(`cache_id`),
 INDEX `created_index` (`created`),
 INDEX `user_cache_index` (`user_id`,`cache_key`),
 CONSTRAINT `user_id_fk_cache` FOREIGN KEY (`user_id`)
   REFERENCES `users`(`user_id`)
   /*!40008
     ON DELETE CASCADE
     ON UPDATE CASCADE */
) /*!40000 ENGINE=INNODB */ /*!40101 CHARACTER SET utf8 COLLATE utf8_general_ci */;
-- Estrutura da tabela para a tabela `contacts`
CREATE TABLE `contacts` (
 `contact_id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
 `changed` datetime NOT NULL DEFAULT '1000-01-01 00:00:00',
 `del` tinyint(1) NOT NULL DEFAULT '0',
 `name` varchar(128) NOT NULL,
 `email` varchar(128) NOT NULL,
 `firstname` varchar(128) NOT NULL,
 `surname` varchar(128) NOT NULL,
 `vcard` text NULL,
 `user_id` int(10) UNSIGNED NOT NULL DEFAULT '0',
 PRIMARY KEY(`contact_id`),
 INDEX `user_contacts_index` (`user_id`,`email`),
 CONSTRAINT `user_id_fk_contacts` FOREIGN KEY (`user_id`)
   REFERENCES `users`(`user_id`)
   /*!40008
     ON DELETE CASCADE
     ON UPDATE CASCADE */
) /*!40000 ENGINE=INNODB */ /*!40101 CHARACTER SET utf8 COLLATE utf8_general_ci */;
-- Estrutura da tabela para a tabela `identities`
CREATE TABLE `identities` (
 `identity_id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
 `del` tinyint(1) NOT NULL DEFAULT '0',
 `standard` tinyint(1) NOT NULL DEFAULT '0',
 `name` varchar(128) NOT NULL,
 `organization` varchar(128) NOT NULL DEFAULT '',
 `email` varchar(128) NOT NULL,
 `reply-to` varchar(128) NOT NULL DEFAULT '',
 `bcc` varchar(128) NOT NULL DEFAULT '',
 `signature` text,
 `html_signature` tinyint(1) NOT NULL DEFAULT '0',
 `user_id` int(10) UNSIGNED NOT NULL DEFAULT '0',
 PRIMARY KEY(`identity_id`),
 CONSTRAINT `user_id_fk_identities` FOREIGN KEY (`user_id`)
   REFERENCES `users`(`user_id`)
   /*!40008
     ON DELETE CASCADE
     ON UPDATE CASCADE */
) /*!40000 ENGINE=INNODB */ /*!40101 CHARACTER SET utf8 COLLATE utf8_general_ci */;
/*!40014 SET FOREIGN_KEY_CHECKS=1 */;

Agora vá para http://www.seudominio.tld:8080/phpmyadmin, insira seu nome de usuário e senha do MySQL. Selecione nosso banco de dados RoundCube “roundcubedb” e vá para a aba SQL, na caixa de texto, cole o texto que você copiou do mysql.initial.sql e execute a consulta. Instalamos com sucesso o RoundCube Webmail.

Passo 5.

Queremos o RoundCube como nosso Webmail padrão. O SquirrelMail não será usado, nem queremos que nossos clientes sofram qualquer alteração. Procedemos assim: Este passo cada um pode adaptar às suas necessidades. O SquirrelMail pode ser mantido, criando um novo alias para o RoundCube.

cd /usr/share  
mv squirrelmail squirrelmail.bak  
mv roundcubemail-0.3.1 squirrelmail

Passo 6.

Finalmente, vá para http://www.seudominio.tld:8080/webmail e faça login para aproveitar este lindo Webmail.

Informações:

Mais informações sobre o RoundCube: http://www.roundcube.net
Howto de Falko O Servidor Perfeito - CentOS 5.4 x86_64 [ISPConfig 3]

Agradecimentos Especiais a:

Falko. Seus Howtos do Servidor Perfeito me ajudaram muito na minha iniciação com servidores Linux.
Minha namorada Naty. Ela fez a tradução do texto.
A equipe do HowtoForge pelo excelente trabalho.