Labs working page

[resplin]

Obsolete Pages{{Obsolete}}

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

Labs 3Installation3.0
Work in progress/Draft

Alfresco Labs 3 B is available for Windows and Linux.

Table of Contents

• 1 Windows download and installation
  
  
  
  • 1.1 Windows complete installation
  
  
  • 1.2 Windows installation excluding JDK
  
  
  • 1.3 Windows installation excluding JDK and OpenOffice
  
  


• 2 Linux download and installation
  
  
  
  • 2.1 Linux complete installation
  
  
  • 2.2 Installing SharePoint Protocol Support on Linux
  
  


• 3 Running Alfresco Labs 3 (on Windows)
  
  
  
  • 3.1 Starting the Alfresco server
  
  
  • 3.2 Stopping the Alfresco server
  
  
  • 3.3 Starting the web client
  
  


• 4 Installation files explained
  
  
  
  • 4.1 Alfresco
  
  
  • 4.2 SharePoint Protocol support
  
  
  • 4.3 Alfresco WCM
  
  
  • 4.4 Alfresco Web Client
  
  
  • 4.5 Alfresco SDK and APIs
  
  
  • 4.6 Extensions
  
  
  • 4.7 Microsoft Office add-ins
  
  

Windows download and installation

There are three different windows files for download, depending on what you already have installed on your machine.

Use the following to determine which set of instructions to follow.

Determine your scenario	Download	Use the following instructions
If no Alfresco component is installed on your system	Alfresco-Labs-3b-Full-Setup.exe	Complete installation
If you already have JDK installed	Alfresco-Labs-3b-OOo-Setup.exe	Installation excluding JDK
If you already have JDK and OpenOffice installed	Alfresco-Labs-3b-Mini-Setup.exe	Installation excluding JDK and OpenOffice

Important  The files are currently replicating across all SourceForge servers. If the download is not immediately available, please try again later.

Windows complete installation

The installation wizard for Microsoft Windows installs all the software and components that you require for running Alfresco.

To install Alfresco Labs 3 B:

1. Ensure you have downloaded Alfresco-Labs-3b-Full-Setup.exe.
   
2. Double-click Alfresco Labs-3b-Full-Setup.exe.
   
3. At the Language Selection prompt, select English and click OK.
   
4. When prompted to confirm installation, click Yes. The Installation wizard launches.
   
5. In the Welcome window, click Next.
   
6. In the Setup Type window, select Typical, and click Next.
   
7. In the Choose Destination Location window, click Next to accept the default location for Alfresco Labs 3 B.
   
8. In the Start Copying Files window, review the settings and click Next. The installation starts.
   
9. In the Database Selection window, select Derby as the database to use for your evaluation, and click Next. To run Alfresco Share in a production environment, replace this with a production quality database, such as MySQL.
   
10. In the InstallJammer Wizard Complete window, click Finish.
    
11. In the Readme window, click Close.
    

The installation is complete. To run Alfresco, see Running Alfresco Labs 3 (on Windows).

Windows installation excluding JDK

If you already have the Java Developer Toolkit (JDK) installed, complete the following instructions. Alfresco supports JDK 1.5 or 1.6 (latest versions of either).

To install Alfresco Labs 3 B, excluding JDK:

1. Ensure you have downloaded Alfresco-Labs-3b-OOo-Setup.exe
   
2. Double-click Alfresco Labs-3b-OOo-Setup.exe.
   
3. At the Language Selection prompt, select English and click OK.
   
4. When prompted to confirm installation, click Yes. The Installation wizard launches.
   
5. In the Welcome window, click Next. The Browse for Folders window displays, prompting you to locate your JDK installation.
   
6. Browse to your JDK installation and click OK.
   
7. In the Setup Type window, select Typical, and click Next.
   
8. In the Choose Destination Location window, click Next to accept the default location to install Alfresco Labs 3.
   
9. In the Start Copying Files window, review the settings and click Next. The installation starts. A prompt notifies you when OpenOffice is being installed. No action is required.
   
10. In the Database Selection window, select Derby as the database to use for your evaluation, and click Next. To run Alfresco Share in a
    
11. In the InstallJammer Wizard Complete window, click Finish.
    
12. In the Readme window, click Close.
    

The installation is complete. To run Alfresco, see Running Alfresco Labs 3 (on Windows).

Windows installation excluding JDK and OpenOffice

If you already have the Java Developer Toolkit (JDK) 1.5 or 1.6 and OpenOffice installed, complete the following instructions.
You can also use these instructions if you do not want to use OpenOffice for document conversions.

To install Alfresco Labs 3 B, excluding JDK and OpenOffice:

1. Ensure you have downloaded Alfresco-Labs-3b-Mini-Setup.exe
   
2. Double-click Alfresco Labs-3b-Mini-Setup.exe.
   
3. At the Language Selection prompt, select English and click OK.
   
4. When prompted to confirm installation, click Yes. The Installation wizard launches.
   
5. In the Welcome window, click Next. The Browse for Folders window displays, prompting you to locate your JDK installation.
   
6. Browse to your JDK installation and click OK.
   
7. In the Setup Type window, select Typical, and click Next.
   
8. In the Choose Destination Location window, click Next to accept the default location for Alfresco Labs 3.
   
9. In the Start Copying Files window, review the settings and click Next. The installation starts.
   
10. In the Database Selection window, select Derby as the database to use for your evaluation, and click Next. To run Alfresco Share in a production environment, replace this with a production quality database such as MySQL.
    
11. In the OpenOffice Location window, browse to your OpenOffice location and click OK. If you do not want to use OpenOffice for your document conversions, select the Alfresco installation folder as the location.
    
12. In the InstallJammer Wizard Complete window, click Finish.
    
13. In the Readme window, click Close.
    

The installation is complete. To run Alfresco, see Running Alfresco Labs 3 (on Windows).

Linux download and installation

The following installation files are available for download:

• Linux installer: Alfresco-Labs-3b-Linux-x86-Install See the instructions for the complete installation.
  
• Tomcat Bundle: alfresco-labs-tomcat-3b.tar.gz
  
• WAR File Only: alfresco-labs-war-3b.tar.gz
  
• Alfresco WCM (optional, requires one of the above): alfresco-labs-wcm-3b.tar.gz
  

Linux complete installation

Before you install Alfresco, ensure that you have JDK 1.5 or 1.6 installed on your machine.

To install Alfresco Labs 3 B using the Linux installer:

1. Ensure you have downloaded Alfresco-Labs-3b-Linux-x86-Install.
   
2. Run Alfresco-Labs-3b-Linux-x86-Install.
   
3. At the Language Selection prompt, select English and click OK.
   
4. When prompted to confirm installation, click Yes. The Installation wizard launches.
   
5. In the Welcome window, click Next. The Browse for Folder window displays, prompting you to locate your JDK installation.
   
6. Browse to your JDK installation and click OK.
   
7. In the Setup Type window, select Typical and click Next.
   
8. In the Choose Destination Location window, click Next to accept the default location for Alfresco Labs 3 B.
   
9. In the Start Copying Files window, review the settings and click Next. The installation starts.
   
10. In the OpenOffice Location window, browse to your OpenOffice location and click OK. If you do not want to use OpenOffice for your document conversions, select the Alfresco installation folder as the location.
    
11. In the InstallJammer Wizard Complete window, click Finish.
    
12. In the Readme window, click Close.
    

For all other installation files on Linux:

1. Follow the Installing on Linux instructions.
   
2. Install pdf2swf to enable the Flash preview functionality. Make sure you use the last development snapshots because 0.8.1 from 2007-02-28 does not support some functionalities Alfresco needs to render the preview.
   

Installing SharePoint Protocol Support on Linux

To install the SharePoint Protocol Support:

1. Shut down your Alfresco server.
   
2. Install the vti-module.amp file into the alfresco.war file using the Module_Management_Tool. The vti-module.amp file holds the functionality for the Sharepoint connector. When you install this file into alfreso.war, it responds to the SharePoint requests from Office, and therefore allows Alfresco to appear as a SharePoint server.
   
3. Copy the ROOT.war file into the Tomcat bundle webapps folder:
   
   1. Delete the ROOT folder from the webapps folder (if there is one).
      
   2. Copy ROOT.war into the webapps folder.
      
   3. Start Tomcat.
      

Note:If this does not work, refer to Known Issues in the Release Notes.

Running Alfresco Labs 3 (on Windows)

This section describes how to run the Alfresco server and web client.

Starting the Alfresco server

Once you have installed Alfresco, you can test the installation by starting the server.

To start Alfresco:

• From the Start menu, select All Programs > Alfresco > Start Alfresco Server
  

A DOS window opens displaying a message indicating the server has started.
INFO: Server startup in nnnn ms

Stopping the Alfresco server

To stop Alfresco:

• From the Start menu, select All Programs > Alfresco Enterprise > Stop Alfresco Server
  

The DOS window that opened during startup closes, and Alfresco has stopped.

Starting the web client

To start the web client:

1. From the Start menu, select All Programs > Alfresco Enterprise > Alfresco Share
   
2. Log in using admin as the default user name and password.
   

Alternatively

1. From your web browser connect to: http://HOSTNAME:8080/share
   
2. Log in using admin as the default user name and password.
   

Installation files explained

Alfresco

File	Description
Alfresco-Labs-3b-Full-Setup.exe	Full Alfresco install for Windows, including Share Preview, DM & WCM web client, Records Management, & SharePoint functionality
Alfresco-Labs-3b-Mini-Setup.exe	Full Alfresco install for Windows, excluding JDK and OpenOffice
Alfresco-Labs-3b-OOo-Setup.exe	Full Alfresco install for Windows, excluding JDK
Alfresco-Labs-3b-Linux-x86-Install	Full Alfresco install for Linux
alfresco-labs-tomcat-3b.tar.gz	Preconfigured Tomcat bundle
alfresco-labs-tomcat-3b.zip	Preconfigured Tomcat bundle, zipped
alfresco-labs-war-3b.tar.gz	Alfresco war files for deployment in existing application servers
alfresco-labs-war-3b.zip	Alfresco war files for deployment into existing application servers, zipped

SharePoint Protocol support

File	Description
vti-module.amp	Connector functionality for Microsoft SharePoint Protocol support
ROOT.war	Microsoft SharePoint Protocol support servlet that forwards Office requests to the main web application

Alfresco WCM

File	Description
alfresco-labs-wcm-3b.tar.gz	WCM functionality for adding to an Alfresco Labs 3 install
alfresco-labs-wcm-3b.zip	WCM functionality for adding to an Alfresco Labs 3 install, zipped
alfresco-labs-deployment-3b.zip	http://wiki.alfresco.com/wiki/WCM_Deployment_Features
AlfrescoDeployLabs-3b-Setup.exe	Windows Installer for Deployment/FSR
AlfrescoDeployLabs-3b-Linux-x86-Install	Linux Installer for Deployment/FSR
alfresco-truncateMalformedXml.amp	XML utility

Alfresco Web Client

File	Description
alfresco-web-service-client-3b.tar.gz	WSDL-based API providing standard remote access to the Alfresco Repository
alfresco-web-service-client-3b.zip	WSDL-based API providing standard remote access to the Alfresco Repository, zipped

Alfresco SDK and APIs

File	Description
alfresco-labs-sdk-3b.tar.gz	Software Development Kit, including the source files
alfresco-labs-sdk-3b.zip	Software Development Kit, including the source files, zipped
alfresco-labs-sample-extensions-3b.tar.gz	Sample extensions such as custom-repository.properties
alfresco-labs-sample-extensions-3b.zip	Sample extensions such as custom-repository.properties, zipped
phpIntegration.amp	Add-in for PHP integration

Extensions

File	Description
alfresco-mmt-3b.jar	Module Management Tool, already included in main server bundles. http://wiki.alfresco.com/wiki/Module_Management_Tool
aggadget.zip	iGoogle gadgets
alfresco-blog-integration.amp	Blog publishing, deprecated
alfresco-bm-3b.jar	JCR Benchmarking toolkit, http://wiki.alfresco.com/wiki/Server_Benchmarks
alfresco-fb-doclib.amp	FaceBook integration
alfresco-recordsmanagement.amp	Records Management sample functionality, http://wiki.alfresco.com/wiki/Records_Management_User_Guide

Microsoft Office add-ins

File	Description
alfresco-labs-excel2003-addin-3b.zip	Add-in for Microsoft Excel  2003
alfresco-labs-office2003-addins-3b.zip	Add-in for Microsoft Office 2003
alfresco-labs-powerpoint2003-addin-3b.zip	Add-in for Microsoft Powerpoint 2003
alfresco-labs-word2003-addin-3b.zip	Add-in for Microsoft Word 2003