Tutorial instalasi Document Management system menggunakan Alfresco

Tutorial instalasi Document Management system menggunakan Alfresco

Oleh : Rito

Alfresco merupakan salah satu aplikasi dokumen managemen, yang memiliki kemampuan, untuk dokumen managemen, collaboration, record managemen, knowledge managemen, serta web content managemen dan imaging.

Alfresco menawarkan 2 model, yaitu model enterprise yang berbayar, dan model open source yang didukung oleh komunitas. Alfresco sendiri dibangun dari beberapa aplikasi opensource, seperti Spring, Hibernate, Lucene, standar model seperti JSR-168, JSR-170, Web Services, Java Server Faces dan kontribusi yang berasal dari komunitas open source, sehingga mendapat perangkat lunak yang berkualitas, namun dengan biaya yang relative murah.

Pada Tutorial kali ini, alfresco yang digunakan adalah alfresco yang versi komunitas. Walaupun sebenarnya, alfresco versi enterprise juga dapat kita download, namun untuk yang versi enterprise ini memiliki keterbatasan, yaitu setelah 30 hari pemakaian, maka alfresco tersebut tidak dapat digunakan.

DOWNLOAD PAKET

Untuk instalasi alfresco ini, distribusi linux yang saya gunakan adalah fedora 8. Karena keterbatasan resource, saya menjalankan OS ini pada mesin vmware (vmware nya juga gratis kok, menggunakan vmware server). Agar alfresco ini dapat berjalan dengan baik, sebaiknya alokasikan memorinya sebesar 1 GB. Sedangkan paket dependency yang dibutuhkan untuk menjalan alfresco ini antara lain :

• tomcat5
• tomcat5-common-lib
• tomcat5-jasper
• tomcat5-jsp-2.0-api
• tomcat5-server-lib
• tomcat5-servlet-2.4-api
• openoffice.org-base
• openoffice.org-calc
• openoffice.org-core
• openoffice.org-draw
• openoffice.org-graphicfilter
• openoffice.org-impress
• openoffice.org-math
• openoffice.org-writer
• openoffice.org-xsltfilter
• mysql-server mysql
• xml-commons-apis

karena distribusi fedora sudah sangat mudah dalam instalasi (walaupun harus tetap terkoneksi ke jaringan), maka untuk menginstall semua aplikasi diatas, cukup dengan 1 perintah tunggal.

# yum install tomcat5 tomcat5-common-lib tomcat5-jasper tomcat5-jsp-2.0-api tomcat5-server-lib tomcat5-servlet-2.4-api openoffice.org-base openoffice.org-calc openoffice.org-core openoffice.org-draw openoffice.org-graphicfilter openoffice.org-impress openoffice.org-math openoffice.org-writer openoffice.org-xsltfilter mysql-server mysql xml-commons-apis wget

dengan perintah di atas, maka kita tidak perlu memikirkan kebutuhan dependenci paketnya, seperti jaman rpm apalagi seperti menggunakan tarball. Setelah semua paket terinstall dengan baik, maka proses selanjutnya adalah mendownload paket-paket alfresco, antara lain :

http://superb-west.dl.sourceforge.net/sourceforge/alfresco/alfresco-community-war-2.1.0.tar.gz

http://superb-west.dl.sourceforge.net/sourceforge/alfresco/alfresco-community-sample-extensions-2.1.0.tar.gz

http://easynews.dl.sourceforge.net/sourceforge/alfresco/alfresco-community-wcm-2.1.0.tar.gz

http://mirrors.dotsrc.org/jpackage/1.7/generic/non-free/RPMS/java-1.6.0-sun-compat-1.6.0.06-1jpp.i586.rpm http://download.softagency.net/MySQL/Downloads/Connector-J/mysql-connector-java-5.1.5.tar.gz

download paket di atas dengan menggunakan wget. Namun sebelumnya, agar paket-paket di atas dapat dikumpulkan dengan mudah, kita letakkan ke dalam satu direktory dulu.

# pwd

/root

# mkdir alfresco

# cd alfresco

# pwd

/root/alfresco

# wget http://superb-west.dl.sourceforge.net/sourceforge/alfresco/alfresco-community-war-2.1.0.tar.gz http://superb-west.dl.sourceforge.net/sourceforge/alfresco/alfresco-community-sample-extensions-2.1.0.tar.gz http://easynews.dl.sourceforge.net/sourceforge/alfresco/alfresco-community-wcm-2.1.0.tar.gz http://mirrors.dotsrc.org/jpackage/1.7/generic/non-free/RPMS/java-1.6.0-sun-compat-1.6.0.06-1jpp.i586.rpm http://download.softagency.net/MySQL/Downloads/Connector-J/mysql-connector-java-5.1.5.tar.gz

INSTALASI PAKET

Setelah semua paket terdownload, yang pertama dilakukan adalah dengan melakukan instalasi java.

# rpm -ivh java-1.6.0-sun-compat-1.6.0.06-1jpp.i586.rpm

Kemudian, aktifkan java nya

# alternatives --config java

There are 2 programs which provide 'java'.

Selection Command

-----------------------------------------------

*+ 1 /usr/lib/jvm/jre-1.6.0-sun/bin/java

2 /usr/lib/jvm/jre-1.5.0-gcj/bin/java

Enter to keep the current selection[+], or type selection number: 1

Periksa paket java yang telah diinstall

# rpm -qa | grep java

sun-javadb-core-10.3.1-4.1

java-1.5.0-gcj-1.5.0.0-17.fc8

sun-javadb-demo-10.3.1-4.1

java-1.6.0-sun-compat-1.6.0.06-1jpp

sun-javadb-common-10.3.1-4.1

sun-javadb-docs-10.3.1-4.1

tzdata-java-2007h-1.fc8

sun-javadb-javadoc-10.3.1-4.1

sun-javadb-client-10.3.1-4.1

java_cup-0.10-0.k.6jpp.1

KONFIGURASI PAKET

1. Konfigurasi tomcat

selanjutnya adalah mengkonfigurasi tomcat, yaitu dengan menambahkan

JAVA_OPTS="$JAVA_OPTS -Xms512m -Xmx512m"

Di /etc/sysconfig/tomcat5

JAVA_OPTS="$JAVA_OPTS -Xms512m -Xmx512m"

Aktifkan service tomcat pada saat restart

# chkconfig –add tomcat5

# chkconfig –level 235 tomcat5 on

2. Konfigurasi Mysql

Agar jika system linux nya jika direstart dapat menghidupkan mysql nya,
maka perlu kita configure terlebih dulu

# chkconfig –add mysqld

# chkconfig –level 235 mysqld on

Hidupkan service mysql

# /etc/init.d/mysqld start

3. Konfigurasi alfresco

Buat direktory alfresco terlebih dulu

# mkdir /opt/alfresco

# cd /opt/alfresco

Extrak paket alfresco-community-war-2.1.0.tar.gz

# tar –xvzf /root/alfresco/alfresco-community-war-2.1.0.tar.gz

Import database mysql nya

# pwd

/opt/alfresco

# mysql –u root –p < . mysql -u root -p < ./extras/databases/mysql/db_setup.sql

Cek hasil impor database:

# mysql

Welcome to the MySQL monitor. Commands end with ; or \g.

Your MySQL connection id is 38

Server version: 5.0.45 Source distribution

Type 'help;' or '\h' for help. Type '\c' to clear the buffer.

mysql> show databases;

+----------------------------+

| Database |

+----------------------------+

| information_schema |

| alfresco |

| mysql |

| test |

+----------------------------+

4 rows in set (0.00 sec)

4. Konfigurasi mysql konektor java

Agar database yang akan kita gunakan dapat berkomunikasi dengan baik, maka java membuthkan konektornya.

# tar –xvzf /root/alfresco/mysql-connector-java-5.1.5.tar.gz

# cd mysql-connector-java-5.1.5

# cp mysql-connector-java-5.1.5-bin.jar /usr/share/java/

# rebuild-jar-repository /var/lib/tomcat5/common/endorsed
 mysql-connector-java-5.1.5-bin.jar

5.  Buat alfresco repository

Untuk membuat repository alfresco, terlebih dulu buat dulu direktorynya 

# mkdir -p /var/lib/alfresco/alf_data/

# chown -R tomcat:tomcat /var/lib/alfresco

# chmod –Rf 777 /var/lib/alfresco

6.   Instal alfresco pada tomcat

# pwd

/opt/alfresco

# cp alfresco.war /var/lib/tomcat5/webapps/

Restart tomcat 

# service tomcat5 start

# service tomcat5 stop

7. Modifikasi konfigurasi alfresco

# cd /var/lib/tomcat5/shared/classes/
# tar –xvzf /root/alfresco/alfresco-community-sample-extensions-2.1.0.tar.gz

# cd alfresco/extension

# cp custom-repository-context.xml.sample custom-repository-context.xml

# cp custom-repository.properties.sample custom-repository.properties

# cp custom-hibernate-dialect.properties.sample
 custom-hibernate-dialect.properties

vi custom-repository.properties

modifikasi baris berikut :

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

db.username=alfresco

db.password=alfresco

db.pool.initial=10

db.pool.max=100

# 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/alfresco

kemudian simpan

Lalu masuk ke mysql, kemudian tambahkan user alfresco, dan password alfresco

# mysql

mysql > user mysql;

mysql> set password for 'alfresco'@'localhost' = PASSWORD('alfersco');  

mysql> exit

# cd /var/lib/tomcat5/webapps/alfresco/WEB-INF/classes

# vi log4j.properties

Modifikasi baris ini 

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

8. Menambahkan komponen WCM

# cd /opt/alfresco/

# mkdir wcm

# tar -xvzf /root/alfresco/alfresco-community-wcm-2.1.0.tar.gz

# cp wcm-bootstrap-context.xml /var/lib/tomcat5/shared/classes/alfresco/extension/

Jalankan Service tomcat

# service tomcat5 start

9. Jika sukses, maka akan muncul tampilan seperti berikut :