Obsolete Pages{{Obsolete}}
The official documentation is at: http://docs.alfresco.com
This guide is a work in progress, as it stands now it shows how to install Alfresco Document Management and Collaboration (a.k.a Share). I intend to show how to install all aspects including WCM and integration with Drupal and MediaWiki etc.
1) Minimal install, fully updated
2) Install Apache, Java, MySQL, PHP, OpenOffice and Tomcat
zypper in apache2 apache2-mod_php5 java-1_6_0-sun mysql mysql-connector-java php5 php5-mysql OpenOffice_org tomcat6 (agree to license)
3) Download Alfresco Labs 3 from here to a temp dir and extract. The files I downloaded are:
alfresco-labs-war-3Stable.tar.gz
alfresco-labs-wcm-3Stable.tar.gz
alfresco-web-service-client-3Stable.tar.gz
alfresco-mmt-3Stable.jar
vti-module.amp
aggadget.zip
org.alfresco.module.mediawikiintegration.amp
alfresco-truncateMalformedXml.amp
phpIntegration.amp
4) Due to Bug BNC 471639 edit /usr/bin/dtomcat6 and add the output to echo $JAVA_HOME
For me this was /usr/lib/jvm/jre
Add this just above # CLASSPATH munging
5) Create required directories -
mkdir -p /srv/tomcat6/shared/lib
mkdir /srv/tomcat6/shared/classes
mkdir -p /opt/alfresco/alf_data
6) Copy/Move the .war files from the directory you extracted alfresco-labs-war-3Stable.tar.gz to /srv/tomcat6/webapps
7) Edit /etc/tomcat6/catalina.properties and change the line that starts with shared.loader=
It should now be shared.loader=/srv/tomcat6/shared/classes,/srv/tomcat6/shared/lib/*.jar
8) Copy the MySQL java connector to the correct directory:
cp /usr/share/java/mysql-connector-java-5.1.6.jar /srv/tomcat6/shared/lib/
9) Setup the database using the sql schema provided which is located in $UNPACKED_WAR_DIR/extras/databases/mysql
~> mysql -u root -p
mysql> source db_setup.sql
10) Download the sample configuration files alfresco-labs-sample-extensions-3Stable.tar.gz and extract into /srv/tomcat6/shared/classes
11)Go into /srv/tomcat6/shared/classes/alfresco/extension and create a sample directory - move all .sample and .zip into the sample dir
mv *.sample* sample/
mv *.zip sample/
12) We need a few of the sample files back here as real files so:
cp sample/custom-hibernate-dialect.properties.sample custom-hibernate-dialect.properties
cp sample/custom-repository-context.xml.sample custom-repository-context.xml
cp sample/custom-repository.properties.sample custom-repository.properties
13) Edit custom-hibernate-dialect.properties and ensure that the MySQL dialect line is uncommented - hibernate.dialect=org.hibernate.dialect.MySQLInnoDBDialect
14) Edit custom-repository.properties to
- Set the location you want your content stored -
dir.root=/opt/alfresco/alf_data
- Uncomment the database connection properties -
db.username=alfresco
db.password=alfresco
db.pool.initial=10
db.pool.max=100
- If you want you can enable the index tracking & recovery by uncommenting the appropriate section -
index.tracking.cronExpression=0/5 * * * * ?
index.recovery.mode=AUTO
- Enable the MySQL connection -
db.driver=org.gjt.mm.mysql.Driver
db.url=jdbc:mysql://localhost/alfresco
- As this is a test machine I am using the single port for all RMI services. You can, as you will see, configure them to use different ports -
alfresco.rmi.services.port=50500
15) Ensure that the correct permissions are set on the directories
chown -R tomcat:tomcat /srv/tomcat6
chown -R tomcat:tomcat /opt/alfresco
16) Ensure that the logfile is created in the correct place
Edit /srv/tomcat6/alfresco/WEB-INF/classes/log4j.properties and /srv/tomcat6/share/WEB-INF/classes/log4j.properties to have:
log4j.appender.File.File=/var/log/alfresco.log
17) Edit /etc/sysconfig/tomcat6 and add
JAVA_OPTS='$JAVA_OPTS -Xms128m -Xmx512m -XX:MaxPermSize=128m -server'
18) Start OpenOffice using the following command:
soffice '-accept=socket,host=localhost,port=8100;urp;StarOffice.ServiceManager' -nologo -headless
19) Start tomcat rctomcat6 start
check to see if .war files have extracted - /srv/tomcat6/webapps should now have directories called alfresco and share. If not restart tomcat rctomcat6 restart
Installation3.2OpenSUSE
- NOTE* When Installing to OpenSuse11.1 , REMEMBER to Do the step for CHOWN tomcat:tomcat to the alfresco directories and the data directory in which you setup for the data of alfresco to be installed. Also, as a precaution, due to the fact that OpenSuse11.1 Has default Java-Openjdk active, you will need to uninstall OpenJDK and install Sun-Java6-1.6.0 and let it update so that it makes the active java ---> point to java-sun-java6-1.6.0 vs. the openjdk alternative. If you do not do this step, your alfresco will error out with 'Unknown Language Error for All' and will fail.
Steps for this to be inserted above :
After install :
1. Remove OpenJDK from the Suseinstallation using Software Manager or Yast.
2. Search for latest version of Sun-Java6-1.6.0 or similiar and install that.
3. Then configure as noted above and things should work fine.
