Instalasi Alfresco Community 3.3g Di Ubuntu Server 8.10 Alt
Transcript of 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
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
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
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
| |--- 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
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
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
#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
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
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
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
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