© European Community 2008- Licensed under the EUPL V.1.0
Document history
Date / Author / Description11/03/07 / Yanick Pignot / Draft
16/02/09 / Slobodan Filipovic / Change alfresco url to point to alfresco stable
Table of content
1 Background information
2 Introduction
3 Check List
Background information
CIRCABC(Communication and Information Resource Centre for Administrations, Businesses and Citizens) project is the continuation of CIRCA project.
It provides Interest Groups with a private web workspace to collaborate on common objectives and tasks. The current application is available for Member States administrations and the service has been continually improved.
The legal reference of CIRCABC project is IDABC(Interoperable Delivery of European eGovernment Services to public Administrations, Businesses and Citizens)programme Decision 2004/387/EC, Article 5, paragraph 2 and Annex II, section B, point (p).
Introduction
The purpose of this document is to provide a Check List and a quick install guide to run Circabc binaries distribution on a pre-configured Linux Red Hat Server.
The simplest way to use this document is to check the different points one by one. Below each point a short description of the task is describe to provide to the advanced users a Quick Start Guide.
Check List
/ 1. You have admin roles on the Server / 2. You have a clean installation to avoid conflicts with old installations.
/ 3. Check if the locale setting of the server is "UTF-8"
Run: locale
/ 4. Get CIRCABC OSS binaries package
Register to the OSOR collaborative platform:
Request to join CIRCABC projectat :
Location:
File name:circabc3.2-oss-bin.tar.gz
/ 5. Get Alfresco 3.0.x Community war
Url:
File name:alfresco-labs-war-3Stable.tar.gz
Url:
File name:alfresco-mmt3Stable.jar
/ 6. Get MySql 5.1 Database Management System (Client and Server)
Url:
Server file name: MySQL-server-community-5.1.X-0.rhel3.i386.rpm
Client file name: MySQL-client-community-5.1.X-0.rhel3.i386.rpm
/ 7. Get Java J2SDK 1.5
Url:
File name:j2sdk-1_5_0_X-linux-i586-rpm.bin
/ 8. Get Apache Tomcat Application server
Url:
File name:apache-tomcat-5.5.X.tar.gz
/ 9. Installation of MySql
/ 9.1. Installation
Run:rpm –ivh MySQL-server-community-5.1.20-0.rhel3.i386.rpmMySQL-client-community-5.1.20-0.rhel3.i386.rpm
If the following error appears, please read the chapter 3 of the configuration guide:
error: Failed dependencies:perl(DBI) is needed by MySQL-
server-standard-5.1.20-0.rhel3.i386.rpmSuggested resolutions:
perl-DBI-1.32-5.i386.rpm
/ 9.2. Set root password
Run:mysqladmin -u root password "newpwd"
/ 9.3. Create the CIRCABC database
Run:mysql –u root –p
Run:CREATE DATABASEcircabc;
Run:USE circabc;
/ 9.4. Create the CIRCABC user
If CIRCABC runs on this server Run:
GRANT ALL PRIVILEGES ON circabc.* to 'circabc'@'localhost'
IDENTIFIED BY ' circabc' WITH GRANT OPTION;
If CIRCABC runs on a remote server Run:
GRANT ALL PRIVILEGES ON *.* TO 'circabc'@'%' IDENTIFIED BY
'circabc' WITH GRANT OPTION;
/ 10. Installation of Java
Run: chmod a+x j2sdk-1_5_0_13-linux-i586-rpm.bin
Run: ./j2sdk-1_5_0_13-linux-i586-rpm.bin
Run: rpm -iv j2sdk-1_5_0_13-linux-i586.rpm
To test run: /usr/java/j2sdk1.5.0_13/bin/java –version
/ 11. Installation of Tomcat
Run:tar -zxvf apache-tomcat-5.5.26.tar.gz –C /usr
Run:vi /usr/apache-tomcat-5.5.26/bin/catalina.sh
Add the bold lines:
…
# JAVA_HOME Must point at your Java Development Kit installation.
#
JAVA_HOME=/usr/java/j2sdk1.5.0_<version>
# JAVA_OPTS (Optional) Java runtime options used when the
JAVA_OPTS="-server -Xms1024m -Xmx1024m -XX:MaxPermSize=128m -XX:+DisableExplicitGC -Djava.io.tmpdir=/usr/env/circabc/temp"
/ 12. Prepare the File System
/ 12.1. Create Alf Data directory
Run: mkdir –p /usr/env/circabc/alf_data
If the user that runs Tomcat is not the current user run:
chown -R <user>:<group> /usr/env/circabc/alf_data
/ 12.2. Create Temp directory
Run: mkdir –p /usr/env/circabc/alf_data
If the user that runs Tomcat is not the current user run:
Chown -R <user>:<group> /usr/env/circabc/alf_data
/ 12.3. Create Log Files directory
Run: mkdir –p /usr/env/circabc/logs
Run: ln -s /usr/apache-tomcat-5.5.26/logs/usr/env/circabc/logs/tomcat
If the user that runs Tomcat is not the current user run:
chown -R <user>:<group> /usr/env/circabc/logs
/ 13. Install CIRCABC
/ 13.1. Install Circabc
Run:tar -zxvf circabc3.2-oss-bin.tar.gz
Run:tar -zxvf alfresco-labs-war-3Stable.tar.gz alfresco.war
Run: /usr/java/jdk1.5.0_13/bin/java -jar alfresco-mmt.jar install circabc.amp alfresco.war -nobackup -force –verbose
Run: mv alfresco.war circabc.war
Run:cp endorsed/* /usr/apache-tomcat-5.5.26/common/endorsed
/ 13.2. Configure Circabc
Run: unzip config.amp *circa-settings.properties
Run:vi web/WEB-INF/classes/alfresco/extension/config/circa-settings.properties
Modify the bold line:
…
# Web root url
web.root.url=
Run: zip -0 config.amp web/WEB-INF/classes/alfresco/extension/config/circa-settings.properties
Mandatory configuration tips are detailed in the installation document.
/ 13.3. Apply the configuration
Run:usr/java/jdk1.5.013/bin/java -jar alfresco-mmt.jar install config.amp circabc.war -nobackup -force -verbose
/ Launch CIRCABC
Run: cp circabc.war /usr/apache-tomcat-5.5.26/webapps
Run: /usr/apache-tomcat-5.5.26/bin/startup.sh
Get the page:
CIRCABC OSS – Installation Check list-1-24/10/2008