Installing Labs 3 Stable on Debian Etch

[resplin]

Obsolete Pages{{Obsolete}}

The official documentation is at: http://docs.alfresco.com

Table of Contents

• 1 Install JAVA
  
  
  
  • 1.1 1. Edit your /etc/apt/sources.list
  
  
  • 1.2 2. Add a line to /etc/apt/apt.conf.d/70debconf
  
  
  • 1.3 3. Create /etc/apt/preferences
  
  
  • 1.4 4. Install Java 6 JDK
  
  


• 2 Install ImageMagick


• 3 Install swftools


• 4 Installing Openoffice for headless use


• 5 Installing Alfresco
  
  
  
  • 5.1 64 bits setup
  
  


• 6 Editing Alfresco Files
  
  
  
  • 6.1 alfresco.sh
  
  
  • 6.2 virtual_alf.sh
  
  
  • 6.3 First start
  
  
  • 6.4 repository.properties
  
  
  • 6.5 SMB/CIFS Configuration
  
  


• 7 INIT Scripts

Install JAVA

In order to install Java 6 on Debian Etch you need to edit your apt sources. As Java 6 is not stable in Debian Etch we solve this issue with apt pinning:

APT Pinning
(Edit all lines marked as bold)

1. Edit your /etc/apt/sources.list

deb http://ftp.debian.org/debian/ etch main non-free
deb-src http://ftp.debian.org/debian/ etch main non-free


deb http://security.debian.org/ etch/updates main contrib non-free
deb-src http://security.debian.org/ etch/updates main contrib non-free


deb http://www.debian-multimedia.org etch main
deb http://www.dipconsultants.com/debian etch main


### unstable #######
deb http://ftp.debian.org/debian/ unstable main non-free

2. Add a line to /etc/apt/apt.conf.d/70debconf

// Pre-configure all packages with debconf before they are installed.
// If you don't like it, comment it out.
DPkg::Pre-Install-Pkgs {'/usr/sbin/dpkg-preconfigure --apt || true';};
APT::Cache-Limit '100000000';

3. Create /etc/apt/preferences

Package: *
Pin: release a=stable
Pin-Priority: 700


Package: *
Pin: release a=unstable
Pin-Priority: 600

4. Install Java 6 JDK

apt-get update
apt-get install sun-java6-jdk

Make sure the Java files are installed to /usr/lib/jvm/java-6-sun/.

Install ImageMagick

Make sure ImageMagick is installed on the system:

apt-get install imagemagick

Install swftools

As there is no .deb package for swftools available which fits to the package configuration of Debian you have to compile swftools yourself. Download http://swftools.org/swftools-2009-02-07-1827.tar.gz to your system.

wget http://swftools.org/swftools-2009-02-07-1827.tar.gz

After you downloaded the version untar it.

tar -xzf swftools-2009-02-07-1827.tar.gz

Before compiling the sources you need a few dev packages:

apt-get install libjpeg62-dev libfreetype6-dev libpng3-dev libt1-dev libungif4-dev

If you are running Red Hat based distros its:

sudo yum install install libjpeg-devel libfreetype-devel libpng-devel libt-devel libungif-devel

After you installed these packages cd into the swftools directory and run

./configure

Please take a closer look at the protocol. This protocol will state if there is any library missing. If you are missing one or more libraries take the name of it and search for this library

apt-cache search lib name

If you found the library install the -dev package of this library and re-run the configure script. Take a look at the protocol once again. If there is no missing file continue compiling and installing the package.

make
make install

After that you should be able to run pdf2swf by typing

pdf2swf -V

Installing Openoffice for headless use

(Please notice the following description OpenOffice.org Headless)

First of all install xvfb for running X11 programs in a terminal environment.

apt-get install xvfb xfonts-base

Make sure you can start xvfb by typing

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

After that start installing OpenOffice

apt-get install openoffice.org

After installing OpenOffice you should try to run Openoffice

soffice '-accept=socket,host=localhost,port=8100;urp;StarOffice.ServiceManager' -nofirststartwizard -nologo -headless -display :1 &

If an error occurs feel free to use the link above to disable the manual registration of OpenOffice.

Installing Alfresco

Donwload Alfresco Labs 3 Stable. Go to your home directory or to a tmp directory and type

wget http://eu.dl.alfresco.com/release/labs/build-1526/Alfresco-Labs-3Stable-Linux-x86-Install?dl_file=release/labs/build-1526/Alfresco-Labs-3Stable-Linux-x86-Install

Please note that it can be useful to download the software by heading to the homepage of Alfresco and follow the links for the latest Community labs edition.
After you downloaded the file install Alfresco by typing

chmod +x Alfresco-Labs-3Stable-Linux-x86-Install
./Alfresco-Labs-3Stable-Linux-x86-Install --mode console

Try to install Alfresco in /opt/Alfresco and answer any other questions with Y.

64 bits setup

If you are running a x64 kernel, you should consider installing the 'ia32-libs' package in order to run the Alfresco installer in console mode.

apt-get install ia32-libs

If not, the installer will simply not run without returning any error. (Tested with lenny x64 under OpenVZ)

Then follow the standard setup instructions.

Editing Alfresco Files

alfresco.sh

First of all edit the startup file for Alfresco. Use your favourite editor to do that.

joe /opt/Alfresco/alfresco.sh

Find the line for ALF Home Dir and Java Home and edit it to

#!/bin/sh
# Start or stop Alfresco server
# Set the following to where Tomcat is installed
ALF_HOME=/opt/Alfresco
cd '$ALF_HOME'
APPSERVER='${ALF_HOME}/tomcat'
export JAVA_HOME='/usr/lib/jvm/java-6-sun'
# Set any default JVM values
export JAVA_OPTS='-Xms128m -Xmx512m -XX:MaxPermSize=128m -server'

virtual_alf.sh

After that edit the corresponding lines in virtual_alf.sh

joe /opt/Alfresco/virtual_alf.sh

#!/bin/sh
# Start or stop Alfresco server
# Set the following to where Tomcat is installed
ALF_HOME=/opt/Alfresco
cd '$ALF_HOME'
APPSERVER='$ALF_HOME'/virtual-tomcat
export JAVA_HOME='/usr/lib/jvm/java-6-sun'

First start

Now you have to start Alfresco. There will be several errors but by starting the application the war archive will be extracted to its final destination. So the following changes will be made directly to the working instance of Alfresco.

/opt/Alfresco/alfresco.sh start

Wait a few minutes until java will stop consuming much CPU. Then stop Alfresco again.

/opt/Alfresco/alfresco.sh stop

repository.properties

You need to change the ImageMagick and pdf2swf paths in your configuration file.

joe /opt/Alfresco/tomcat/webapps/alfresco/WEB-INF/classes/alfresco/repository.properties

Replace the corresponding lines with the following lines at the end of file:

img.root=/usr

swf.exe=/usr/local/bin/pdf2swf

SMB/CIFS Configuration

Make sure you know the hostname, the domain and the broadcast address. Fill in these information in the file.server.properties.

joe /opt/Alfresco/tomcat/webapps/alfresco/WEB-INF/classes/alfresco/file-servers.properties

INIT Scripts

To get Alfresco starting while booting up you will need to create an init script. The following init script starts alfresco and routes port 8080 to the external http port 80. Additonally, the init script runs Openoffice, due to an unresolved problem with the standard Alfresco Openoffice configuration. If you have any other webserver running on your server just delete the iptables entries.

joe /etc/init.d/alfresco

#! /bin/sh
# /etc/init.d/alfresco
#


# Start/Stop Script
export PATH=$PATH:/usr/local/bin/pdf2swf
case '$1' in
 start)
   Xvfb :1 -screen 0 1024x768x24 -fbdir /usr/src &
   /opt/Alfresco/alfresco.sh start
   xvfb-run -a /usr/lib/openoffice/program/soffice.bin -headless -accept='socket,port=8100;urp;' -display :1 &
   

   iptables -F
   iptables -t nat -F
   iptables -P INPUT ACCEPT
   iptables -P FORWARD ACCEPT
   iptables -P OUTPUT ACCEPT 
   iptables -t nat -I PREROUTING -p tcp --dport 80 -j REDIRECT --to-port 8080
       
   /opt/Alfresco/virtual_alf.sh start
   ;;
 stop)
   /opt/Alfresco/alfresco.sh stop
   /opt/Alfresco/virtual_alf.sh stop
   ;;
 *)  
   echo 'Usage: /etc/init.d/alfresco {start|stop}'
   exit 1
   ;;
esac  


exit 0

To read more about init scripts follow this link init scripts

chmod +x /etc/init.d/alfresco
update-rc.d alfresco defaults

After rebooting the machine the Alfresco system should be reachable on HTTP Port 80.
Please check the logs under /opt/Alfresco/alfresco.log if there are any further errors.
Labs 3
Installation
3.0
Linux
Debian