Use this method of installing Alfresco if you already have installed a JDK, a supported database, an application server, and the additional Alfresco components.. To download and install
Trang 1Installing the Alfresco WAR on any platform
Use the Web Archive (WAR) file to install Alfresco on any platform A WAR file
is a JAR file used to distribute a collection of files (JavaServer Pages, servlets, Java classes, XML files, tag libraries, and static web pages) that together constitute a web application
Use this method of installing Alfresco if you already have installed a JDK, a
supported database, an application server, and the additional Alfresco components The WAR zip includes the binaries for ImageMagick and pdf2swf To download and install the Alfresco WAR file you need to carry out the following:
1 Browse to the Alfresco Community Edition download area
2 Select and download one of the following files:
alfresco-community-war-3.2.zip
alfresco-community-war-3.2.tar.gz
3 Specify a location for the download
4 Extract the downloaded file
5 Copy the alfresco.war file and share.war file to the appropriate location for your application server, for example: <TOMCAT_HOME>/webapps
If you deployed previous versions of Alfresco, you must remove any temporary files created by your application server
Modifying the directory paths for Tomcat 6.x
If you install Tomcat 6.x separately, some of the directories that were present in Tomcat 5.x will not be present in the former For example, Tomcat 6.x does not contain the shared/classes and shared/lib directories Alfresco uses these directories to locate some of the configuration override files This section describes how to configure Tomcat 6.x to use the correct directory structure and files for Alfresco:
1 Locate <TOMCAT_HOME>
2 Create the shared/classes directory
3 Open the <TOMCAT-HOME>/conf/catalina.properties file
4 Change the value shared.loader= to the following:
shared.loader=${catalina.base}/shared/classes,${catalina.base}/ shared/lib/*.jar
5 Copy the JDBC drivers for the database you are using to lib/
Trang 26 Ensure that a copy of the commons-el.jar file is in the lib directory.
7 If you are using Java SE 6, copy any jar files that needed to go into the Tomcat common/endorsed directory into the following directory:
jdk6/jre/lib/endorsed
Downloading the extension samples
Each Alfresco distribution includes a download containing sample extension files, such as the Spring configuration You can use these sample extensions for advanced Alfresco customizations by downloading and installing the files mentioned below,
as follows:
1 Browse to the Alfresco Community Edition downloads area
2 Select and download one of the following files:
alfresco-community-sample-extensions-3.2.zip
alfresco-community-sample-extensions-3.2.tar.gz
3 Specify a location for the download The extension samples are available for you to configure Once you have downloaded the sample files, copy them into <classPathRoot>
Deploying Share into a separate Tomcat
instance
This task provides information for running Share in a separate Tomcat instance These instructions are for Windows deployments, but Linux-based deployments can use the same methods:
1 Install a new Tomcat instance
2 Modify the /conf/server.xml file for the new Tomcat instance as follows:
a Change the port number in the line (for example, to 8006):
<Server port="8005" shutdown="SHUTDOWN">
b Change the port number in the section (for example, to 8180):
<! Define a non-SSL HTTP/1.1 Connector on port 8080 >
<Connector port="8080"
3 Move the share.war file from the original Tomcat /webapps directory to the
Trang 34 (Optional) Configure the original Alfresco Tomcat deployment.
5 Start the original Tomcat You can use Alfresco-supplied batch files
6 Ensure that a copy of the commons-el.jar file is in the Share Tomcat
lib directory
7 If you are running the Share Tomcat on a separate machine, you must modify the override file in the Share Tomcat web-extension directory, as follows:
1 Open the webscript-framework-config-custom.xml file
2 Change any instance of the server and port to the correct name or IP address of the Alfresco server: http://<server-name>:8080
3 Start the new Share Tomcat You can use copies of the Alfresco-supplied batch files, or your own
Installing Alfresco components
This section describes how to install components that integrate with Alfresco These can be installed any time before or after installing Alfresco This section will take you through the installation of these components:
• Alfresco WCM
• WCM standalone deployment receiver
• OpenOffice
• ImageMagick
• Microsoft Office Add-ins
• Flash Player
• SWFTools
• TinyMCE language packs
• Alfresco Module Package
• Microsoft Office SharePoint Protocol Support
Installing Alfresco WCM
This section describes how to set up Alfresco Web Content Management (WCM) to
an existing instance of Alfresco:
1 Browse to the Alfresco Community Edition download area
Trang 42 Select one of the following files:
° Windows: alfresco-community-wcm-3.2.zip
° Linux: alfresco-community-wcm-3.2.tar.gz
3 Download the file into the Alfresco home directory For example:
° Windows: C:\Alfresco
° Linux: /opt/alfresco
4 Browse to the Alfresco home directory and unzip the downloaded file
5 If your unzip program asks about existing directories, allow this because no existing files will be overwritten
6 In the root of the Alfresco home directory, copy the
wcm-bootstrap-context.xml file to the <extension> directory
7 Restart the Alfresco server
This ensures that the Alfresco server starts to use the installed WCM components To
restart the Alfresco server, see the Starting the Alfresco server section further on in this
chapter WCM is installed and configured
Verifying the WCM installation
Verify the WCM installation after you have installed, configured, and started the Alfresco server:
1 In the Alfresco home directory, open alfresco.log
2 In alfresco.log, search for the following text: The Web Forms folder was successfully created: and The Web Projects folder was successfully created:
3 Check that the following additional spaces are in your Alfresco repository:
° Web Projects in Company Home
° Web Forms in Data Dictionary
WCM has been installed, configured, started, and verified To use the Website
Preview feature, start the Alfresco virtualization server (see the Starting the Alfresco
virtualization server section later in this chapter).
Trang 5Installing the WCM standalone deployment receiver
The standalone deployment receiver allows a web project from WCM to be deployed
to a remote file server, typically a web or application server The published files are then typically published by a web server such as Apache for static content, or an application server such as Tomcat or JBoss for dynamic content To carry out the installation follow the steps mentioned below:
1 Browse to the Alfresco Community Edition download area
2 Download one of the following files:
° Windows: Alfresco-DeploymentCommunity-3.2-Setup.exe
° Linux: Alfresco-DeploymentCommunity-3.2-Linux-x86-Install
3 At the Language selection prompt, click on OK.
4 At the Install Alfresco Standalone Deployment Receiver prompt,
click on Yes.
5 In the Welcome to the Alfresco Standalone Deployment Receiver window, click on Next.
6 In the Choose Destination Location window, click on Next to accept
the default location for Alfresco or choose another location For example,
C:\alfresco\deployment on Windows or /opt/alfresco/deployment
on Linux
7 In the Deployment Settings window, enter the following settings:
Temporary Data The directory in which to store temporary data files
Log Location The directory in which to store log data
Metadata Location The directory in which to store metadata
Target Location The directory in which to store deployment files
Name of default filesystem target The default name of the filesystem target is default
8 For Windows directory locations, the backslashes need to be changed For example, use C:\\directory1\\directory2 Alternatively, you can use the slash character as a separator, for example, C:/directory1/directory2
9 Click on Next.
10 Enter a username and password for the user account that will administer the deployment receiver
Trang 611 If you are using RMI as your transport protocol, enter the port numbers for the following:
Deployment setting Description
RMI Registry Port Number The port number for the RMI registry Choose the default of
44101 to avoid conflict with the other services
RMI Service Port Number The port number to use for the RMI service Choose this so
that there are no conflicts with other services
12 In the Start Copying Files window, click on Next.
13 In the InstallJammer Wizard Complete window, click on Finish.
The deployment receiver, out of the box, is configured with a single filesystem deployment target
Compiling and deploying the customizations on top
of the WCM core
We already talked about the build process for the code deployment in the previous sections So we have the build file ready and now we will see how we can deploy the code or customizations we have done for Alfresco WCM There are two main approaches for this
Integrating the code in the existing Alfresco WAR file
In this approach, we will integrate the files directly in the alfresco.war file For this you need to run the integrate-extension target This target has some dependent targets, which will compile the Java source files Make the JAR file and then package everything in one ZIP file and then integrate it with the alfresco.war file
Deploying the code as an AMP
AMP stands for Alfresco Module Package Using this approach, you can install
the code as a module If you are installing using AMP, you should follow the
folder-specific folder structure for that, which has already been described earlier
in the Source code tree section Apart from the folder structure, there are two other
files that need to be created:
• module.properties: This will specify the metadata of the module with the
ID and version number
Trang 7The sample module.properties file that we have used here will look like:
# Cignex module
module.id=Cignex
module.title=Cignex Website
module.description=Cignex Website module
module.version=1.0
• file-mapping.xml: This file will be used if you want to customize the way
in which your AMP file is mapped into the WAR If it is not provided, then the default mapping information will be used
Here we have customized this for the WEB-INF folder, which generally contains the faces-config-custom.xml or any faces-related
configuration files
The content for file-mapping.xml file is:
# Custom AMP to WAR location mappings
/web/WEB-INF=/WEB-INF
For deploying the code as an AMP, you need to run the update-war target This target has some dependent targets, which will compile the Java source files Make the JAR file and then create an AMP package with all of the customized files and finally install this AMP to the Alfresco WAR file and update the WAR file
Installing OpenOffice
Within Alfresco, you can transform a document from one format to another, for example, a text file to a PDF file To have access to these transformation facilities in Alfresco, you must install OpenOffice This is optional and can be done any time after Alfresco is installed If you installed Alfresco using an installation wizard, OpenOffice may already be installed
Trang 81 Browse to the OpenOffice.org download site: http://download.
openoffice.org
2 Download the latest (stable) version of OpenOffice for your platform
3 When prompted, specify a download destination
4 Browse to the location of your downloaded file and install the application
5 A wizard guides you through the installation
6 Accept the license agreement and click on Next.
7 Enter customer information and click on Next.
8 Select the Setup Type as Custom and click on Next.
Trang 99 Change the installation directory to:
° Windows: c:\Alfresco\OpenOffice
° Linux: /opt/alfresco/OpenOffice
10 Optionally, select the files for which you want OpenOffice to be the default
application and click on Next.
11 Start one of the OpenOffice programs for the initial registration and then close the program
12 If the Alfresco server is running, stop and restart the server
13 Modify the ooo.exe= property in the
<classPathRoot>\alfresco-global.properties file to point to the OpenOffice binary office.exe
Installing ImageMagick
To enable image manipulation in Alfresco, you must install and configure
ImageMagick Alfresco uses ImageMagick to manipulate images for previewing If you installed Alfresco using one of the installation wizards, ImageMagick has already been installed If however, ImageMagick has not been installed, you can choose to do
so by downloading it and installing it to work with your Alfresco instance
Trang 101 Verify if ImageMagick is already installed in your system You can run the
convert command, which is part of ImageMagick and is usually located in
/usr/bin
2 If ImageMagick is not in your system, browse to the ImageMagick download site and install the appropriate package for your platform
3 Modify the img.root= and img.exe= properties in the <classPathRoot>/ alfrescoglobal.properties file to point to the ImageMagick root directory For example, in Windows:
° Set the img.root= property to img.root=C:/Alfresco/ImageMagick
° Set the img.exe= property to img.exe=C:/Alfresco/ImageMagick/ bin/convert.exe
And for Linux:
° Set the img.root= property to img.root=/ImageMagick
° Set the img.exe= property to img.exe=/ImageMagick/bin/
convert.exe
° Ensure that you do not include a slash (/) at the end of the path For example, /ImageMagick/
Installing Microsoft Office add-ins
This task describes how to install Alfresco Add-ins for Microsoft® Office
applications, such as Word, Excel, and PowerPoint The Alfresco add-ins have been designed with Microsoft Office 2003 in mind However, they are also compatible with Microsoft Office 2007 Before you start, make sure that:
• The NET Programmability Support option is installed for each of the Office applications that you are installing the add-ins in (such as Word, Excel, and PowerPoint) To find these options, run the Office Setup program and expand the list of available options for each application You may require your original Office 2003 install media to add these required components
• The installing user has Windows administrator privileges
• Any Microsoft Office applications on your system are NOT running,
including Outlook if you use Word as an e-mail editor If you are running Office 2007 on Windows Vista, note that Microsoft has rewritten the
WebDAV parts of Vista, which means you will experience READ-ONLY access to the Alfresco repository over WebDAV This is a known problem with Vista and affects many applications, including Microsoft's own
SharePoint Server There is no known workaround at the time of writing