맛깔나는 SE 레시피 콘서트 -- SEROOT.COM :)

제 목 : RoundCube 웹메일 설치방법

구 분 : 설치 메뉴얼
작성자 : 이선규 (neosky) (neosky(at)smileserv.com, admin(at)nple.com, http://seroot.com)
작성일 : 2010년 7월 13일

0. RoundCube Webmail 소개

RoundCube Webmail (라운드큐브 웹메일)l은 웹에서 편리하게 메일서비스를 이용할 수 있도록 하는
프로그램입니다. 기존에 사용하던 Squirrel Mail (다람쥐 메일) 보다는 세련된 인터페이스를 보여주고 있습니다.

▼ RoundCube Webmail 공식 홈페이지

▼ RoundCube Webmail 을 사용하기 위한 서버 필요사항 및 테스트된 브라우저 환경

Server Requirements¶

Apache, Lighttpd (>=1.4.13 for SSL), or Cherokee Web server
Directory on the Web server allowed to run scripts
If using Apache, .htaccess support or configuration to override DirectoryIndex
PHP version 5.2.1 or greater with

PCRE (Perl-Compatible Regular Expressions)
Session support
Socket support
MySQL, PostgreSQL, or SQLite database engine
iconv (recommended)
OpenSSL (recommended)
Mbstring (optional)
FileInfo (optional)
Mcrypt (optional)

php.ini options:

error_reporting E_ALL & ~E_NOTICE (or lower)
file_uploads on (for attachment upload features)
memory_limit (increase as suitable to support large attachments)
session.auto_start off
magic_quotes_gpc off

If using MySQL or PostgreSQL, a database server and database user with permission to create tables

If using MySQL 5.0.2 or later, disable STRICT_TRANS_TABLES and STRICT_ALL_TABLES

OpenSSL and Socket modules for PHP required to connect to secure IMAP or IMAPS, for secure SMTP and to use the spell checker

Additionally, the CURL module for PHP is required for spell checking with TinyMCE (HTML WYSIWYG Editor).

An IMAP server which supports IMAP 4 rev 1
An SMTP server (recommended) or PHP configured for mail delivery

Browser Requirements¶

JavaScript? enabled
Accept cookies
Support for XMLHttpRequest
CSS2 Support

Tested browsers¶

Internet Explorer 6 (Windows 2000 and Windows XP)
Internet Explorer 7 (Windows XP)
Safari 2 (Mac OS X 10.4)
Safari 3 (Mac OS X 10.5 and Windows XP)
Firefox 2 (Windows XP, Mac OS X, and Linux)
Firefox 3 (Windows XP, Linux, and OpenSolaris)

Browsers reported to work¶

Camino 1.5.x (Mac OS X 10.4)
Opera 9.25 (Windows Server 2003, Windows XP, and FreeBSD 6)
Opera 9.30 (Wii, TinyMCE is non-functional)
Opera 9.60 beta1 (Windows XP)

RoundCube Webmail 설치

1. RoundCube Webmail 다운로드

2010.07 현재 최신버전은 0.3.1 이고, 0.4 beta 버전이 발표되어 있다.
아래 URL에서 다운로드 받거나, 그 다음 URL에서 직접 다운로드 한다.

- 다운로드 메뉴 : http://www.roundcube.net/download
- 다운로드 주소 : http://downloads.sourceforge.net/project/roundcubemail/roundcubemail/0.3.1/roundcubemail-0.3.1.tar.gz?use_mirror=cdnetworks-kr-2&ts=1278983479

▲ /usr/local/src 디렉토리로 이동해서 다운로드 받습니다.

# cd /usr/local/src
# wget http://downloads.sourceforge.net/project/roundcubemail/roundcubemail/0.3.1/roundcubemail-0.3.1.tar.gz?use_mirror=cdnetworks-kr-2&ts=1278983479

2. 서버측 설치작업

▲ 압축해제

# tar xvfz roundcubemail-0.3.1.tar.gz
...
roundcubemail-0.3.1/skins/default/watermark.html
roundcubemail-0.3.1/SQL/
roundcubemail-0.3.1/SQL/mssql.initial.sql
roundcubemail-0.3.1/SQL/mysql.initial.sql
roundcubemail-0.3.1/SQL/mysql.update.sql
roundcubemail-0.3.1/SQL/postgres.initial.sql
roundcubemail-0.3.1/SQL/postgres.update.sql
roundcubemail-0.3.1/SQL/sqlite.initial.sql
roundcubemail-0.3.1/SQL/sqlite.update.sql
roundcubemail-0.3.1/temp/
roundcubemail-0.3.1/temp/.htaccess
roundcubemail-0.3.1/UPGRADING

▲ 웹에서 서비스할 위치로 이동시킵니다.

# mv roundcubemail-0.3.1 /home/nple/public_html/mail

▲ logs, temp 디렉토리에 쓰기권한을 부여합니다.

# chmod 707 logs temp
`logs'의 모드를 0707(rwx---rwx)으로 변경하였습니다
`temp'의 모드를 0707(rwx---rwx)으로 변경하였습니다

▲ 데이터베이스를 생성합니다.

mysql> CREATE DATABASE roundcubemail;
mysql> GRANT ALL PRIVILEGES ON roundcubemail.* TO roundcubemail@localhost IDENTIFIED BY 'fkdnsemzbqmapdlf)(*&';
mysql> FLUSH PRIVILEGES;
mysql> quit

▲ 웹에서 접근할 수 있도록 버추얼호스트 설정을 해줍니다.

<VirtualHost 222.122.11.22>
   DocumentRoot "/home/nple/public_html/mail"
   ServerName mail.nple.com
   ErrorLog "logs/mail.nple.com-error_log"
   CustomLog "logs/mail.nple.com-access_log" combined
</VirtualHost>

# /etc/init.d/apachectl graceful

3. 웹에서 설치작업

▲ 위에서 설정한 주소에 installer를 붙이게되면 웹에서 설치하는 화면이 나타납니다.

http://mail.nple.com/installer/

3-1. 필요요건 안내

아래 화면에서와 같이 충족요건이 갖추어져야 합니다.

   1. PHP 5.2.0 버전이나 그 이상에서 포함되어야 하는 것들

   - PCRE, Session support, Libiconv (추천사항), OpenSSL (추천사항), FileInfo (선택사항),
Multibyte/mbstring (선택사항), Mcrypt (선택사항)

   2. php.ini 옵션에 설정되어야 하는 것들

   - error_reporting E_ALL & E_NOTICE (또는 이하)
- file_uploads on
   - session.auto_start off

   3. MySQL 또는 PostgreSQL 데이터베이스 엔진 또는 SQLite extension for PHP

   4. SMTP Server (추천사항) or 메일 배달을 위한 PHP 설정

* 위 조건에 충족된다면 [START INSTALLATION] 버튼을 눌러 진행하도록 합니다.

▼ RoundCube Webmail Installer 초기화면

3-2. 환경체크

앞에서 충족요건사항에 대해 자체체크하게 되고, 그 결과 값을 보여준다.

▼ RoundCube Webmail Installer 에서 체크한 서버환경

3-3. 환경설정 (이미지는 클릭하면 크게 보임)

RoundCube Webmail 을 이용하기 위한 환경설정으로 설치 이후에도 설정가능하므로
여기서는 기본적으로 설정되어야 할 사항에 대해서만 살펴보겠다.

1. Database setup -- 앞에서 설정했던 DATABASE 정보를 입력해준다.

Database type : [ MySQL ]

Database server : localhost
Database name : roundcubemail
Database user name : roundcubemail
Database password : 패스워드

2. IMAP Settings

default_host : nple.com (사용할 도메인을 입력합니다. +add 로 도메인 추가가 가능합니다.)

3. SMTP Settings

smtp_server : mail.nple.com (메일호스트 도메인을 입력합니다.)

4. Display settings & user prefs

language : ko_KR (사용할 언어를 입력합니다.)

[CREATE CONFIG] 를 눌러 다음으로 진행합니다.

▼ RoundCube Webmail Installer 에서 환경설정 화면

3-4. config 설정파일 복사

새로 작성된 main.inc.php 와 db.inc.php 파일 내용을 복사해서 서버내 config 디렉토리 내에 생성합니다.

# cd /home/nple/public_html/mail/config
# vi main.inc.php (내용 복사후 저장)
# vi db.inc.php (내용 복사후 저장)

[CONTINUE] 를 눌러 다음으로 진행합니다.

3-5. 환경 테스트

모든 항목이 올바로 되어 있다면 아래와 같이 OK 메세지를 만날 수 있습니다.
여기서 메일 테스트를 해볼 수 있으나, 실제 RoundCube Webmail 로 접속해서 메일 발송을 해보도록 하겠습니다.

▼ RoundCube Webmail Installer 에서 환경테스트 화면