1 소개

2 Prerequisites

2.1 MySQL의 UTF8 설정
2.2 Tomcat 패키지 버그 수정
2.3 JVM의 힙 사이즈 조정

3 Dependencies

4 기본 설치

5 확장 기능 설치

6 OpenOffice.org

7 Apache2

8 네트워크 접속

8.1 CIFS 서버
8.2 FTP 서버
8.3 NFS 서버
8.4 WebDAV 서버

9 참고자료

[edit]

1 소개 #

Alfresco(http://www.alfresco.com)는 엔터프라이즈 급의 콘텐츠 관리 시스템(Content Management System, CMS)이다. 이 문서에서는 2008년 4월 4일자 Sid에서 WAR 파일을 이용한 Alfresco Community를 설치하는 방법을 다룬다. 본 문서에서는 자바 서블릿 컨테이너로는 Tomcat을, DBMS로는 MySQL을 사용한다.

[edit]

2 Prerequisites #

아래의 패키지가 컴퓨터에 설치되어 있어있고, 정상적으로 작동한다는 가정 하에 다음 과정을 진행한다.

tomcat5.5
apache2
sun-java6-jre
openoffice.org
php5-common
mysql-server

[edit]

2.1 MySQL의 UTF8 설정 #

MySQL의 한글 설정을 위해서, 기본 인코딩을 UTF8으로 설정한다. 데이터베이스에 EUC-KR로 인코딩된 데이터가 없을 경우, 다음과 같이 /etc/mysql/my.cnf 파일의 다음 부분을 아래와 같이 수정하여, MySQL의 기본 인코딩을 UTF8으로 바꿀 수 있다.

[client]
default-character-set=utf8

[mysqld]
init_connect=SET collation_connection = utf8_general_ci
init_connect=SET NAMES utf8
default-character-set=utf8
character-set-server=utf8
collation-server=utf8_general_ci

[mysql]
default-character-set=utf8

이후, MySQL을 재시작한다.

# /etc/init.d/mysql restart

[edit]

2.2 Tomcat 패키지 버그 수정 #

5.5.25-5 버전의 tomcat5.5 패키지는 tomcat5.5-webapps 패키지의 /usr/share/tomcat5.5-webapps/ 아래에 위치한 예제 파일들에 대해 적절한 권한 설정이 되어 있지 않다. Alfresco 설치와는 상관없지만, Tomcat의 로그파일 분석 시에 어려움을 주므로 이를 해결해 주는 것이 좋다. /etc/tomcat5.5/policy.d/ 아래의 04webapps.policy 파일에 다음을 추가한다.

grant codeBase "file:${catalina.home}/bin/tomcat-juli.jar" {
       permission java.io.FilePermission "/usr/share/tomcat5.5-webapps/jsp-examples/WEB-INF/classes/logging.properties", "read";
       permission java.io.FilePermission "/usr/share/tomcat5.5-webapps/servlets-examples/WEB-INF/classes/logging.properties", "read";
};

[edit]

2.3 JVM의 힙 사이즈 조정 #

Alfresco는 JVM의 힙 최대 크기를 512Mb 이상 잡을 것을 권장한다. 시스템의 메모리가 충분할 경우, /etc/default/tomcat5.5에 다음을 추가한다.

JAVA_OPTS="-Xmx512M"

[edit]

3 Dependencies #

Alfresco는 많은 오픈소스 프로그램을 사용한다. 다음과 같이 필요한 패키지를 설치한다.

# apt-get install sun-java6-jdk liblucene-java liblog4j1.2-java libhibernate3-java imagemagick libmysql-java

libmysql-java 패키지의 mysql-connector-java.jar 아카이브를 Tomcat의 libs 디렉터리로 링크를 걸어준다.

# cd /usr/share/tomcat5.5/common/lib/
# ln -s ../../../java/mysql-connector-java.jar ./
# ln -s ../../../java/mysql-connector-java-5.1.5.jar ./

[edit]

4 기본 설치 #

Alfresco Community는 SourceForge.net(http://sourceforge.net/project/showfiles.php?group_id=143373&package_id=157460&release_id=524558)에서 받을 수 있다. 여기서는 2008년 4월 4일 현재 안정버전인 alfresco-community-war-2.1.0.tar.gz를 내려 받았다. 이후, /opt/alfresco에 압축을 푼다.

# mkdir -p /opt/alfresco
# tar xvfz ./alfresco-community-war-2.1.0.tar.gz -C/opt/alfresco

Alfresco에서 제공하는 SQL 스크립트를 이용하여 MySQL 데이터베이스를 생성한다.

# tar xvfz ./alfresco-c
# mysql -u root -p < /opt/alfresco/extras/databases/mysql/db_setup.sql

데이터베이스 계정의 암호를 설정한다.

$ mysql -u root -p

mysql> use mysql;
mysql> update user set password = password('<your Alfresco database user password>') where user = 'alfresco';
mysql> flush privileges;

이제 Alfresco 저장소로 사용할 디렉터리를 만들고, 소유권을 조정한다.

# mkdir -p /var/lib/alfresco/{alf_data,tmp}
# chown -R tomcat55:nogroup /var/lib/alfresco/

Alfresco Community WAR 파일을 Tomcat의 웹 어플리케이션 디렉터리로 복사한다.

# cp /opt/alfresco/alfresco.war /var/lib/tomcat5.5/webapps/
# chown tomcat55:nogroup /var/lib/tomcat5.5/webapps/alfresco.war

Tomcat 서버가 정상적으로 동작하고 있다면, /var/lib/tomcat5.5/webapps/alfresco 디렉터리가 생성되어 있는 것을 볼 수 있다.

# ls -ld /var/lib/tomcat5.5/webapps/alfresco

생성된 디렉터리를 볼 수 있다면, /var/lib/tomcat5.5/webapps/alfresco/에 있는 WEB-INF/classes/alfresco/repository.properties 파일의 다음 부분을 아래와 같이 수정한다. <your Alfresco database user name>에는 MySQL 계정인 alfresco를 넣어주고, <your Alfresco database user password>에는 위에서 설정한 암호를 넣어준다.

dir.root=/var/lib/alfresco/alf_data

…

db.schema.update=true
db.driver=org.gjt.mm.mysql.Driver
db.name=alfresco
db.url=jdbc:mysql://localhost/${db.name}?useUnicode=true&characterEncoding=utf-8
db.username=<your Alfresco database user name>
db.password=<your Alfresco database user password>
db.pool.initial=10
db.pool.max=20

Alfresco가 로그를 기록하는 위치를 변경한다. /var/lib/tomcat5.5/webapps/alfresco/에 있는 WEB-INF/classes/log4j.properties 파일에서 log4j.appender.File.File에 로그파일의 위치를 넣어주면 된다.

log4j.appender.File.File=/var/log/tomcat5.5/alfresco.log

/etc/tomcat5.5/policy.d/에 있는 04webapps.policy 파일에 다음 내용을 추가하여, Tomcat이 Alfresco를 구동할 수 있도록 퍼미션을 조정한다.

grant codeBase "file:${catalina.home}/bin/tomcat-juli.jar" {
       permission java.io.FilePermission "/var/lib/tomcat5.5/webapps/alfresco/WEB-INF/classes/logging.properties", "read";
};

grant codeBase "file:${catalina.home}/webapps/alfresco/-" {
    permission java.security.AllPermission;
};

이제 Tomcat을 재시작한다.

 # /etc/init.d/tomcat5.5 restart

잠시 기다린 후, 웹 브라우저의 주소칸에 [http]

http://localhost:8180/alfresco를 입력하면 Alfresco의 시작 페이지를 볼 수 있다. User Name에 "admin", Password에 "admin"을 입력하면 관리자 계정으로 로그인 할 수 있다. 시작 페이지를 볼 수 없을 경우, /var/log/tomcat5.5에 있는 catalina.<date>.log와 alfresco.log를 분석하여 문제를 해결한다.

[edit]

5 확장 기능 설치 #

다음과 같이 Alfresco 확장 기능을 설치한다. 기본 메시지를 영어로 유지하기 위해서, 중복된 파일은 덮어쓰지 않도록 주의한다.

# cd /var/lib/tomcat5.5/webapps/alfresco/WEB-INF/classes/alfresco
# cp -Riv /opt/alfresco/extensions/extension/* ./extension/
# chown -R tomcat55:nogroup ./extension/
# cp -Riv /opt/alfresco/extensions/messages/* ./messages/
# chown -R tomcat55:nogroup ./messages/

/var/lib/tomcat5.5/webapps/alfresco/ 아래의 WEB-INF/classes/alfresco/extension/custom-hibernate-dialect.properties의 다음 부분을 아래와 같이 수정하여, MySQL 드라이버를 활성화 시키고 다른 것들은 비활성화 한다.

#
# HSQL dialect
#
#hibernate.dialect=org.hibernate.dialect.HSQLDialect

#
# MySQL dialect (default)
#
hibernate.dialect=org.hibernate.dialect.MySQLInnoDBDialect

역시, /var/lib/tomcat5.5/webapps/alfresco/ 아래의 WEB-INF/classes/alfresco/extension/custom-repository.properties의 다음 부분을 아래와 같이 수정한다.

#
# HSQL connection
#
#db.driver=org.hsqldb.jdbcDriver
#db.url=jdbc:hsqldb:file:alf_data/hsql_data/alfresco;ifexists=true;shutdown=true;

#
# MySQL connection (This is default and requires mysql-connector-java-5.0.3-bin.jar, which ships with the Alfresco server)
#
db.driver=org.gjt.mm.mysql.Driver
db.url=jdbc:mysql://localhost/${db.name}?useUnicode=true&characterEncoding=utf-8

웹 클라이언트에서 다양한 언어 지원을 위해서 다음 명령어를 실행한다. 아직 한글은 지원되지 않는다.

# cd /var/lib/tomcat5.5/webapps/alfresco/WEB-INF/classes/alfresco/extension/
# cp -iv web-client-config-custom.xml.sample web-client-config-custom.xml

이제 Tomcat을 재시작 한다.

# /etc/init.d/tomcat5.5 restart

[edit]

6 OpenOffice.org #

OpenOffice.org 서비스 매니저를 가상 X 서버 위에 띄어 놓으면, 이를 통해 Alfresco에서 문서 변환 작업을 할 수 있다. 우선 필요한 패키지를 설치한다.

# apt-get install xvfb openoffice.org

부팅 시에 필요한 서비스가 실행되도록 스크립트를 만든다. 먼저, /etc/init.d/에 다음 내용과 같이 xvfb.sh 파일을 만든다.

/usr/bin/Xvfb :1 -screen 1 1024x768x24 -fbdir /usr/src &

역시, /etc/init.d에 다음 내용과 같이 office.sh 파일을 만든다.

/usr/bin/soffice "-accept=socket,host=localhost,port=8100;urp;StarOffice.ServiceManager" -nologo -headless -display :1 &

다음 명령으로 부팅 시에 위의 스크립트들이 실행되도록 한다.

# chmod +x /etc/init.d/{xvfb,office}.sh
# update-rc.d xvfb.sh start 99 2 3 4 5 . stop 99 0 1 6 .
# update-rc.d office.sh start 99 2 3 4 5 . stop 99 0 1 6 .

[edit]

7 Apache2 #

Apache2의 서비스 포트를 이용해서 Alfresco를 이용할 수 있도록 설정한다. 즉, http://localhost:8180/alfresco 대신에 [http]

http://localhost/alfresco로 URL을 변경하는 방법에 대해 알아본다. 먼저, 내부 프록시 모듈을 활성화한다.

# cd /etc/apache2/mods-enabled/
# ln -s ../mods-available/proxy.* ./
# ln -s ../mods-available/proxy_http.load ./

디폴트 설정은 모든 프록시 접근이 막혀있으므로, /etc/apache2/mods-enabled/에 있는 proxy.conf을 아래와 같이 수정한다.

<IfModule mod_proxy.c>
        ProxyRequests Off
        <Proxy http://localhost>
                AddDefaultCharset off
                Order deny,allow
                Allow from all
        </Proxy>
        ProxyVia On
</IfModule>

/etc/apache2/sites-enabled/ 아래의 버추얼 호스트 파일에 다음을 추가한다.

    ProxyPass           /alfresco       http://localhost:8180/alfresco
    ProxyPassReverse    /alfresco       http://localhost:8180/alfresco

이제 Apache2를 재시작하면, http://localhost/alfresco 접속하여 Alfresco를 이용할 수 있다.

[edit]

8 네트워크 접속 #

/var/lib/tomcat5.5/webapps/alfresco/에 있는 WEB-INF/classes/alfresco/{file-server,web-client-config}.xml과 WEB-INF/classes/alfresco/extension/file-servers-custom.xml을 보면 8080 포트를 사용하도록 되어있는 곳이 있다. 이를 모두 찾아서, 8180 포트로 고쳐준다.

Tomcat에서 구동되는 자바 어플리케이션은 tomcat55 사용자 권한으로 실행하게 된다. 이럴 경우, 일반 유저인 tomcat55는 1024번 이하의 포트번호를 열수 없는 문제가 발생한다. 이를 해결하기 위해서 각 파일서버에서 1024번 위의 포트를 열고, 방화벽을 이용해서 해당 서비스의 요청이 들어올 경우, 우리가 열어준 포트로 포워드 시키면 된다.

[edit]

8.1 CIFS 서버 #

WEB-INF/classes/alfresco/file-server.xml의 CIFS Server 설정 부분을 다음과 같이 수정한다. 컴퓨터가 속해있는 도메인이 있을 경우, <your domain> 부분에 도메인을 적어준다. non-privileged 포트를 사용하기 위한 포트 설정부분도 아래를 참고하여 수정한다.

   ...

   <config evaluator="string-compare" condition="CIFS Server">
          <serverEnable enabled="true"/>
      <host name="${localname}_A" domain="<your domain>"/>
      <comment>Alfresco CIFS Server</comment>

      <!-- Set to the broadcast mask for the subnet -->
      <broadcast>255.255.255.255</broadcast>

      <!-- Use Java socket based NetBIOS over TCP/IP and native SMB on linux -->
      <tcpipSMB platforms="linux,solaris,macosx"/>
      <netBIOSSMB platforms="linux,solaris,macosx"/>

           <!-- Can be mapped to non-privileged ports, then use firewall rules to forward
                    requests from the standard ports -->
      <tcpipSMB port="1445" platforms="linux,solaris,macosx"/>
      <netBIOSSMB sessionPort="1139" namePort="1137" datagramPort="1138" platforms="linux,solaris,macosx"/>

   ...

다음 명령으로 방화벽 설정을 할 수 있다. 하지만, 이들 명령어는 기존의 방화벽과 NAT 규칙을 모두 지워버리므로 주의하도록 한다.

# echo 1 > /proc/sys/net/ipv4/ip_forward
# modprobe iptable_nat
# iptables -F
# iptables -t nat -F
# iptables -P INPUT ACCEPT
# iptables -P FORWARD ACCEPT
# iptables -P OUTPUT ACCEPT
# iptables -t nat -A PREROUTING -p tcp --dport 445 -j REDIRECT --to-ports 1445
# iptables -t nat -A PREROUTING -p tcp --dport 139 -j REDIRECT --to-ports 1139
# iptables -t nat -A PREROUTING -p udp --dport 137 -j REDIRECT --to-ports 1137
# iptables -t nat -A PREROUTING -p udp --dport 138 -j REDIRECT --to-ports 1138