16
Cara Instalasi Alfresco Community WAR 3.3g di Ubuntu Server Alt. 8.10 I. PENYIAPAN SERVER 1. Install Operating System pada server melalui CD. Pada tutorial ini menggunakan OS Ubuntu 8.10 Alt. 2. Konfigurasi network interface ke static dengan melakukan konfigurasi pada file /etc/network/interfaces pada saat ini digunakan alamat IP 192.168.1.86. Note : untuk setting dengan akses root menggunakan password : blackgemi. Untuk aplikasi editing nano untuk save menggunakan perintah : Ctrl + O dan untuk exit : Ctrl + X. Direkto ri : /etc/network/interfaces Perinta h : sudo nano /etc/network/interfaces Konfigu rasi # This file describes the network interfaces available on your system # and how to activate them. For more information, see interfaces(5). # The loopback network interface auto lo iface lo inet loopback auto eth0 iface eth0 inet static address 192.168.1.86 network 192.168.1.0 gateway 192.168.1.1 dns-nameservers 192.168.1.2 dns-search blackgemi.com 3. Restart interfaces Perinta h : sudo /etc/init.d/networking restart Created by Black Gemi

Instalasi Alfresco Community 3.3g Di Ubuntu Server 8.10 Alt

Embed Size (px)

Citation preview

Page 1: Instalasi Alfresco Community 3.3g Di Ubuntu Server 8.10 Alt

Cara Instalasi Alfresco Community WAR 3.3g di Ubuntu Server Alt. 8.10

I. PENYIAPAN SERVER

1. Install Operating System pada server melalui CD. Pada tutorial ini menggunakan OS Ubuntu 8.10 Alt.

2. Konfigurasi network interface ke static dengan melakukan konfigurasi pada file /etc/network/interfaces pada saat ini digunakan alamat IP 192.168.1.86.

Note : untuk setting dengan akses root menggunakan password : blackgemi. Untuk aplikasi editing nano untuk save menggunakan perintah : Ctrl + O dan untuk exit : Ctrl + X.

Direktori : /etc/network/interfaces

Perintah : sudo nano /etc/network/interfaces

Konfigurasi # This file describes the network interfaces available on your system

# and how to activate them. For more information, see interfaces(5).

# The loopback network interfaceauto lo

iface lo inet loopback

auto eth0iface eth0 inet static

address 192.168.1.86 network 192.168.1.0 gateway 192.168.1.1 dns-nameservers 192.168.1.2 dns-search blackgemi.com

3. Restart interfaces

Perintah : sudo /etc/init.d/networking restart

4. Konfigurasi DNS Resolve untuk domain BLACKGEMI.NET.

Direktori : /etc/resolv.conf

Perintah : sudo nano /etc/resolv.conf

Konfigurasi search BLACKGEMI.NETnameserver 192.168.1.2

5. Konfigurasi repository yang akan digunakan oleh server dimana dalam hal ini diarahkan ke http://mirror.blackgemi.com (repo ini adalah repo contoh, bisa menggunakan repo yang lain yang terdapat aplikasi yang diperlukan alfresco yaitu Mysql Server, Java SDK, Mysql Connector, Flash Player, Open Office, Image Magick, SWF Tools)

Created by Black Gemi

Page 2: Instalasi Alfresco Community 3.3g Di Ubuntu Server 8.10 Alt

Direktori : /etc/apt/sources.list

Perintah : sudo nano /etc/apt/sources.list

Konfigurasi # deb cdrom:[Ubuntu 8.10 _Intrepid Ibex_ - Release i386 (20081028)]/ intrepid m$

#deb cdrom:[Ubuntu 8.10 _Intrepid Ibex_ - Release i386 (20081028)]/ intrepid ma$

# See http://help.ubuntu.com/community/UpgradeNotes for how to upgrade to

# newer versions of the distribution.

deb http://mirror.blackgemi.com/archive.ubuntu.com/ubuntu/ intrepid main restricted universe multiverse

deb http://mirror.blackgemi.com/archive.ubuntu.com/ubuntu/ intrepid-updates main restricted universe multiverse

deb http://mirror.blackgemi.com/archive.ubuntu.com/ubuntu/ intrepid-backports main restricted universe multiverse

deb http://mirror.blackgemi.com/archive.canonical.com/ubuntu/ intrepid partner

deb http://mirror.blackgemi.com/security.ubuntu.com/ubuntu/ intrepid-security main restricted universe multiverse

deb http://mirror.blackgemi.com/ppa.launchpad.net/pidgin-developers/ppa/ubuntu intrepid main

deb http://mirror.blackgemi.com/ppa.launchpad.net/openoffice-pkgs/ppa/ubuntu intrepid main

6. Upgrade dan Update aplikasi dalam server.

Perintah : sudo apt-get dist-upgrade

: sudo apt-get update

7. Untuk memudahkan konfigurasi via remote digunakan aplikasi SSH Server.

Perintah : sudo apt-get install ssh openssh-server

Created by Black Gemi

Page 3: Instalasi Alfresco Community 3.3g Di Ubuntu Server 8.10 Alt

8. Untuk memudahkan konfigurasi di server dengan format GUI dengan akses root digunakan aplikasi Nautilus.

Perintah : sudo apt-get install nautilus

Perintah eksekusi

: sudo gksu nautilus

II. INSTALASI APLIKASI PENDUKUNG ALFRESCO COMMUNITY

Aplikasi yang digunakan dalam proses instalasi ini adalah sebagai berikut.

1. Alfresco Community War 3.3g (alfresco-comunity-war-3.3g.tar.bz)

2. Apache Tomcat 6.0.20 (apache-tomcat-6.0.20.tar.gz)

3. Common el 1.0 (commons-el-1.0.tar.gz)

4. Mysql Server 5 (dari repository)

5. Java SDK 6 (dari repository)

6. Mysql Connector 5.1.6 (dari repository)

7. Flash Player (dari repository)

8. Open Office 2.4 (dari repository)

9. Image Magick (dari repository)

10. SWF Tools (dari repository)

Berikut ini ada langkah-langkah instalasinya.

1. Install Flash Player

Perintah : sudo apt-get -f install flashplugin-nonfree

sudo apt-get -f install

2. Install Java SDK 6

Perintah : sudo apt-get install sun-java6-jdk

Created by Black Gemi

Page 4: Instalasi Alfresco Community 3.3g Di Ubuntu Server 8.10 Alt

3. Install Mysql dan Mysql Connector

Perintah : sudo apt-get install mysql-server-5.0

sudo apt-get install libmysql-java

Untuk proses create, copy, ekstrak, delete folder pada proses selanjutnya dilakukan seperti di system operasi Windows dengan aplikasi Nautilus, sebelumnya aktifkan aplikasi dengan perintah : ‘gsku nautilus’ di terminal.

4. Ekstrak tomcat di directori /opt (dalam instalasi ini memakai nama ‘tomcat’), sehingga direktori tomcat sekarang menjadi ‘/opt/tomcat’.

5. Buat folder shared di dalam folder tomcat (/opt/tomcat/shared)

6. Di dalam folder shared buat folder classes (/opt/tomcat/shared/classes) dan lib (/opt/tomcat/shared/lib) .

7. Buat folder alfresco di dalam folder classes (/opt/tomcat/shared/classes/alfresco).

8. Untuk proses instalasi Mysql connector yang menggunakan repository, copy isi folder /usr/share/java/ ke /opt/tomcat/shared/lib. Bisa juga dilakukan dengan cara men-download Mysql connector dari web Mysql dan mengcopy mysql-connector-java-5.1.6-bin.jar ke dalam folder lib.

9. Download common-el-1.0.tar.gz dari apache common dan copy common-el.jar ke folder /opt/tomcat/shared/lib.

10. Ekstrak alfresco-comunity-war-3.3g.tar.bz di direktori mana saja, kemudian copy isi folder alfresco-community-war-3.3g/extensions ke dalam folder /opt/tomcat/shared/classes/alfresco.

11. Copy file alfresco-global.properties dari folder alfresco-community-war-3.3g/extensions/extension ke folder /opt/tomcat/shared/classes (/opt/tomcat/shared/classes/alfresco-global.properties)

12. Copy file endorsed dari folder alfresco-community-war-3.3g ke folder /opt/tomcat (/opt/tomcat/endorsed).

Secara garis besar langkah 4-12 dapat diilustrasikan dengan gambar berikut ini.

</opt/tomcat> |---endorsed | |--- xalan.jar

Created by Black Gemi

Page 5: Instalasi Alfresco Community 3.3g Di Ubuntu Server 8.10 Alt

| |--- serializer.jar |---shared |---lib | |---mysql-connector-java-5.1.6-bin.jar | |---commons-el.jar |---classes |---alfresco-global.properties |---alfresco |---extension |---messages |---web-extension

13. Tambahkan konfigurasi berikut ini di file catalina.properties

Direktori : /opt/tomcat/conf/catalina.properties

Perintah : sudo nano /opt/tomcat/conf/catalina.properties

Konfigurasi shared.loader = ${catalina.base}/shared/classes,${catalina.base}/shared/lib/*.jar

14. Ubah konfigurasi dir.root pada file alfresco-global.properties. Direktori root adalah direktori yang digunakan untuk menyimpan data yang nantinya digunakan untuk proses backup dan restore alfresco.

Note : untuk mencegah warning saat start alfresco, dir.root sebaiknya dibuat fix, tidak relative path seperti defaultnya ('./alf_data')

Direktori : /opt/tomcat/shared/classes/alfresco-global.properties

Perintah : sudo nano /opt/tomcat/shared/classes/alfresco-global.properties

Konfigurasi dir.root=/opt/tomcat/webapps/files

15. Membuat database untuk alfresco via Mysql. Dalam proses instalasi ini digunakan user database : root dan password database : blackgemi. Database yang akan dibuat adalah alfresco, username : alfresco, password : alfresco.

Perintah : sudo mysql –uroot –pblackgemi

mysql > CREATE DATABASE alfresco;

mysql > GRANT ALL PRIVILEGES on alfresco.* TO 'alfresco'@'localhost' identified by 'alfresco';

mysql > FLUSH PRIVILEGES; mysql > exit

Created by Black Gemi

Page 6: Instalasi Alfresco Community 3.3g Di Ubuntu Server 8.10 Alt

16. Testing koneksi ke mysql dengan user dan password yang telah dibuat diatas.

Perintah : sudo mysql –ualfresco –palfresco

mysql> show databases;

17. Edit file alfresco-global.properties untuk menambahkan konfigurasi database yang telah dibuat diatas.

Direktori : /opt/tomcat/shared/classes/alfresco-global.properties

Perintah : sudo nano /opt/tomcat/shared/classes/alfresco-global.properties

Konfigurasi db.name=alfrescodb.username=alfrescodb.password=alfrescodb.host=localhostdb.port=3306

18. Install Open Office Headless dan cek path aslinya.

Perintah : sudo apt-get install openoffice.org-headless openoffice.org-java-common sudo which soffice

19. Edit file alfresco-global.properties untuk menambahkan konfigurasi open office.

Direktori : /opt/tomcat/shared/classes/alfresco-global.properties

Perintah : sudo nano /opt/tomcat/shared/classes/alfresco-global.properties

Konfigurasi ooo.exe=usr/bin/sofficeooo.enabled=true

20. Install Image Magick dan cek path aslinya.

Perintah : sudo apt-get install imagemagick sudo which imagemagick

21. Edit file alfresco-global.properties untuk menambahkan konfigurasi Image Magick. Path yang akan ditambahkan pada konfigurasi adalah path program convert dikurangi /bin/convert.

contoh: jika hasil dari "> which convert" = "/usr/bin/convert" brarti img.root = "/usr"Direktori : /opt/tomcat/shared/classes/alfresco-global.properties

Perintah : sudo nano /opt/tomcat/shared/classes/alfresco-global.properties

Konfigurasi img.root=/usr

22. Install SWFTools dan cek path aslinya.Perintah :sudo apt-get install zlib1g-dev

sudo apt-get install libjpeg-dev sudo apt-get install giflib-tools / libgif-dev

Created by Black Gemi

Page 7: Instalasi Alfresco Community 3.3g Di Ubuntu Server 8.10 Alt

sudo apt-get install libfreetype6-dev sudo apt-get install gcc sudo apt-get install g++ sudo apt-get install swftools sudo which pdf2swf

23. Edit file alfresco-global.properties untuk menambahkan konfigurasi SWFTools.Direktori : /opt/tomcat/shared/classes/alfresco-global.properties

Perintah : sudo nano /opt/tomcat/shared/classes/alfresco-global.properties

Konfigurasi swf.exe=/usr/bin/pdf2swf

III.Setting Autentifikasi dengan LDAPTambahkan konfigurasi berikut ini di alfresco-global.properties

Direktori : /opt/tomcat/shared/classes/alfresco-global.properties

Perintah : sudo nano /opt/tomcat/shared/classes/alfresco-global.properties

Konfigurasi authentication.chain=passthru1:passthrupassthru.authentication.domain=passthru.authentication.servers=BLACKGEMI.NET\\192.168.1.2,192.168.1.2passthru.authentication.guestAccess=falsepassthru.authentication.authenticateCIFS=truepassthru.authentication.sso.enabled=falsepassthru.authentication.defaultAdministratorUserNames=blackgemi ntlm.authentication.sso.enabled=false

IV. Setting CIFS File SystemTambahkan konfigurasi berikut ini di alfresco-global.properties

Direktori : /opt/tomcat/shared/classes/alfresco-global.properties

Perintah : sudo nano /opt/tomcat/shared/classes/alfresco-global.properties

Konfigurasi filesystem.domainMappings=BLACKGEMI.NETfilesystem.domainMappings.value.BLACKGEMI.NET.rangeFrom=192.168.1.0filesystem.domainMappings.value.BLACKGEMI.NET.rangeTo=255.255.255.255

#cifs.enabled=falsecifs.serverName=blackgemi-sharecifs.domain=BLACKGEMI.NET

#cifs.WINS.autoDetectEnabled=false

Created by Black Gemi

Page 8: Instalasi Alfresco Community 3.3g Di Ubuntu Server 8.10 Alt

#cifs.WINS.primary=#cifs.WINS.secondary=

ftp.enabled=false

V. Mengubah port Alfresco dari port 8080 ke port 80Ubah konfigurasi berikut ini di server.xml

Direktori : /opt/tomcat/conf/server.xml

Perintah : sudo nano /opt/tomcat/conf/server.xml

Konfigurasi Awal

<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />

Konfigurasi Akhir

<Connector port="80" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="443" />

VI. Meng-expose Web ServiceTambahkan konfigurasi berikut ini di alfresco-global.properties

Direktori : /opt/tomcat/shared/classes/alfresco-global.properties

Perintah : sudo nano /opt/tomcat/shared/classes/alfresco-global.properties

Konfigurasi repo.remote.endpoint.url=http://localhost:80/alfresco/service

V. Instalasi Alfresco Community1. Copy file alfresco.war dan share.war dari folder alfresco-community-war-3.3g ke

/opt/tomcat/webapps/.

2. Tambahkan konfigurasi heap memory sebelum memulai instalasi

Direktori : /opt/tomcat/bin/startup.sh

Perintah : sudo nano /opt/tomcat/bin/startup.sh

Konfigurasi Awal

os400=falsedarwin=falsecase "`uname`" inCYGWIN*) cygwin=true;;OS400*) os400=true;;

Created by Black Gemi

Page 9: Instalasi Alfresco Community 3.3g Di Ubuntu Server 8.10 Alt

Darwin*) darwin=true;;esac

# resolve links - $0 may be a softlinkPRG="$0"

Konfigurasi Akhir

os400=falsedarwin=falsecase "`uname`" inCYGWIN*) cygwin=true;;OS400*) os400=true;;Darwin*) darwin=true;;Esac

export JAVA_OPTS="-Xms128m -Xmx512m -XX:MaxPermSize=128m -server -Dalfresco.home=${ALF_HOME} -Dcom.sun.management.jmxremote";

# resolve links - $0 may be a softlinkPRG="$0"

3. Untuk melakukan penginstalan masuk ke direktori /opt/tomcat/bin

Direktori : /opt/tomcat/bin

Perintah : sudo ./startup.sh

4. Untuk melihat log instalasi dapat dilakukan dengan perintah berikut ini.

Direktori : /opt/tomcat/bin

Perintah : sudo tail -f alfresco.log

5. Untuk melihat hasil instalasi bisa diakses di alamat : http://192.168.1.86/share atau http://192.168.1.86/alfresco

VI. Mengarahkan link pada logo ke site blackgemi Ubah konfigurasi pada file header.get.html.ftlDirektori :/opt/tomcat/webapps/share/WEB-INF/classes/alfresco/site-webscripts/org/alfresco/

components/header/header.get.html.ftl

Perintah : sudo nano /opt/tomcat/webapps/share/WEB-INF/classes/alfresco/site-webscripts/org/alfresco/components/header/header.get.html.ftl

Konfigurasi Awal

<#assign logo=msg("header.logo")><#if logo="header.logo"><#assign logo="app-logo.png"></#if><div class="header"> <div class="logo-wrapper"> <div class="logo"> <a href="#" onclick="thisHeader.showAboutShare(); return false;"><img src="${url.context}/themes/${theme}/images/${logo}" alt="Alfresco Share" /></$ </div> </div>

Konfigurasi <#assign logo=msg("header.logo")><#if logo="header.logo"><#assign

Created by Black Gemi

Page 10: Instalasi Alfresco Community 3.3g Di Ubuntu Server 8.10 Alt

Akhir logo="app-logo.png"></#if><div class="header"> <div class="logo-wrapper"> <div class="logo"> <a href="http://192.168.1.86/share/page/site/blackgemi/dashboard"; return false;"><img src="${url.context}/themes/${theme}/images/${logo}" alt="Alfresco $ </div> </div>

VII. Meng-hidden personal menu (My Dashboard, My Profile, Sites, People)Ubah konfigurasi pada file header.get.html.ftl, dengan menambahkan tanda “<#-- … -->”

Direktori :/opt/tomcat/webapps/share/WEB-INF/classes/alfresco/site-webscripts/org/alfresco/components/header/header.get.html.ftl

Perintah : sudo nano /opt/tomcat/webapps/share/WEB-INF/classes/alfresco/site-webscripts/org/alfresco/components/header/header.get.html.ftl

Konfigurasi Awal

<div class="menu-wrapper"> <#if !user.isGuest> <div class="personal-menu"> <span class="menu-item-icon my-dashboard"><a href="${url.context}/page/user/${user.name?url}/dashboard">${msg("link.myDashboard")}</a></span> <span class="menu-item-icon my-profile"><a href="${url.context}/page/user/${user.name?url}/profile">${msg("link.myProfile")}</a></span> <span id="${args.htmlid}-sites-linkMenuButton" class="link-menu-button"> <span class="menu-item-icon sites link-menu-button-link"><a href="${url.context}/page/site-finder">${msg("link.sites")}</a></span> <input id="${args.htmlid}-sites" type="button"/> </span> <span class="menu-item-icon people"><a href="${url.context}/page/people-finder">${msg("link.people")}</a></span> <#if repoLibraryVisible><span class="menu-item-icon repository"><a href="${url.context}/page/repository">${msg("link.repository")}</a></span></#if> </div> </#if>

Konfigurasi Akhir

<#-- <div class="menu-wrapper"> <#if !user.isGuest> <div class="personal-menu"> <span class="menu-item-icon my-dashboard"><a href="${url.context}/page/user/${user.name?url}/dashboard">${msg("link.myDashboard")}</a></span> <span class="menu-item-icon my-profile"><a href="${url.context}/page/user/${user.name?url}/profile">${msg("link.myProfile")}</a></span> <span id="${args.htmlid}-sites-linkMenuButton" class="link-menu-button"> <span class="menu-item-icon sites link-menu-button-link"><a href="${url.context}/page/site-finder">${msg("link.sites")}</a></span> <input id="${args.htmlid}-sites" type="button"/> </span> <span class="menu-item-icon people"><a href="${url.context}/page/people-finder">${msg("link.people")}</a></span> <#if repoLibraryVisible><span class="menu-item-icon repository"><a href="${url.context}/page/repository">${msg("link.repository")}</a></span></#if> </div> </#if>-->

Created by Black Gemi

Page 11: Instalasi Alfresco Community 3.3g Di Ubuntu Server 8.10 Alt

VIII. Memindahkan file alfresco ke HD Eksternal

1. Format file system HD Eksternal ke format ext 3

2. Membuat partisi baru di Ubuntu (ReiserFS filesystem) dengan nama /dev/sdb1

Perintah : sudo mkreiserfs /dev/sdb1

3. Tambahkan konfigurasi mount ke fstab

Direktori :/etc/fstab

Perintah : sudo nano /etc/fstab

Konfigurasi /dev/sdb1 /opt/tomcat reiserfs relatime 0 3

4. Mount /opt/tomcat/

Perintah : sudo mount /opt/tomcat

5. Pindahkan /opt/tomcat ke /opt/tomcat.old

Perintah : sudo mv /opt/tomcat /opt/tomcat.old

6. Buat direktori baru /opt/tomcat

Perintah : sudo mkdir /opt/tomcat

7. Mount kembali /opt/tomcat

Perintah : sudo mount /opt/tomcat

8. Copy file dari /opt/tomcat.old ke /opt/tomcat

Direktori : /opt/tomcat

Perintah sudo cp -a /opt/tomcat.old/*

IX. Membuat Boot Up Script untuk Alfresco

1. Agar Alfresco bisa beroperasi langsung ketika server dihidupkan perlu ditambahkan konfigurasi berikut ini.

Created by Black Gemi

Page 12: Instalasi Alfresco Community 3.3g Di Ubuntu Server 8.10 Alt

Direktori :/opt

Perintah : sudo alfresco.sh

Konfigurasi #!/bin/sh# Start or stop Server Alfresco# Sesuaikan dimana Tomcat diinstalALF_HOME=/opt/cd "$ALF_HOME"APPSERVER="${ALF_HOME}/tomcat"if [ "$1" = "start" ]; then "${APPSERVER}/bin/startup.sh"

elif [ "$1" = "stop" ]; then "${APPSERVER}/bin/shutdown.sh"fi

2. Untuk mendaftarkan script diatas di /etc/init.d dalam dokumentasi ini menggunakan script berikut ini

Direktori :/opt

Perintah : sudo initialize.sh

Konfigurasi #!/bin/shALF_HOME=/optecho "Membuat link ke init.d"ln -s $ALF_HOME/alfresco.sh /etc/init.d/alfrescoupdate-rc.d alfresco defaultsln -s $ALF_HOME/alfresco.sh /etc/init.d/alfrescoupdate-rc.d alfresco defaults

3. Eksekusi script initialize.sh.

Direktori :/opt

Perintah sudo chmod 777 initialize.shsudo ./initialize.sh

4. Untuk mengecek apakah alfresco sudah terdaftar di boot up, dapat dilihat di /etc/init.d

5. Untuk melihat hasilnya, reboot server Alfresco.

Created by Black Gemi