Installing Labs 3c

[resplin]

Obsolete Pages{{Obsolete}}

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

Labs 3Installation3.0
Download and install Labs 3c to test drive the Draft CMIS implementation.

Alfresco Labs 3c is available for Windows and Linux. Learn more about what's in Alfresco Labs 3c. For further information, refer to the Release Notes.

To add your own experience of installing Labs 3, see the Community experience page.

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
  
  


• 3 Installing Alfresco components


• 4 Installing SharePoint Protocol Support


• 5 Running Alfresco Labs 3
  
  
  
  • 5.1 Starting the Alfresco server
  
  
  • 5.2 Stopping the Alfresco server
  
  
  • 5.3 Starting the web client and Share
  
  


• 6 Installation files explained
  
  
  
  • 6.1 Alfresco
  
  
  • 6.2 SharePoint Protocol support
  
  
  • 6.3 Alfresco WCM
  
  
  • 6.4 Alfresco Web Service Client
  
  
  • 6.5 Alfresco SDK and APIs
  
  
  • 6.6 Extensions
  
  
  • 6.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-3c-Full-Setup.exe	Complete installation
If you already have JDK installed	Alfresco-Labs-3c-OOo-Setup.exe	Installation excluding JDK
If you already have JDK and OpenOffice installed	Alfresco-Labs-3c-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 3c:

1. Ensure you have downloaded Alfresco-Labs-3c-Full-Setup.exe.
   
2. Double-click Alfresco Labs-3c-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 3c.
   
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.

Windows installation excluding JDK

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

To install Alfresco Labs 3c, excluding JDK:

1. Ensure you have downloaded Alfresco-Labs-3c-OOo-Setup.exe
   
2. Double-click Alfresco Labs-3c-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 production environment, replace this with a production quality database, such as MySQL.
    
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.

Windows installation excluding JDK and OpenOffice

If you already have the Java Developer Toolkit (JDK) 5 or 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 3c, excluding JDK and OpenOffice:

1. Ensure you have downloaded Alfresco-Labs-3c-Mini-Setup.exe
   
2. Double-click Alfresco Labs-3c-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.

Linux download and installation

The following installation files are available for download:

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

Linux complete installation

These instructions are for working in an X11 environment. For instructions for Installing Labs 3 on Linux with command line interface.

Before you install Alfresco, ensure that you have JDK 5 or 6 installed on your machine.

To install Alfresco Labs 3c using the Linux installer:

1. Ensure you have downloaded Alfresco- Labs-3c-Linux-x86-Install.
   
2. Run Alfresco-Labs-3c-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. Typical install selects all the default options for installation. To modify the installation settings, select Custom and click Next.
   
8. In the Choose Destination Location window, click Next to accept the default location for Alfresco Labs 3c.
   
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. (Note: In the current version, the installer looks for <path>/soffice.exe, so as workaround until fixed, cp soffice.bin soffice.exe will help the installer to finish correctly. [http://forums.alfresco.com/en/viewtopic.php?f=8&t=14304&p=47221&hi...])
    
11. In the InstallJammer Wizard Complete window, click Finish.
    
12. In the Readme window, click Close.
    

For all other installation files on Linux, follow the Installing on Linux instructions.

Installing Alfresco components

Alfresco requires additional software components to ensure that all its functionality is available, for example, Flash, SWF Tools. These components can be installed either before or after you have installed Alfresco.

For information on how to install the additional components, refer to Installing Alfresco components.

Installing SharePoint Protocol Support

Note: If you use the Windows or Linux installers to install Alfresco Labs 3, the SharePoint Protocol Support is installed by default. These instructions describe how to install the SharePoint Protocol Support into the Alfresco WAR. When you install this file, it responds to the SharePoint requests from Office, and therefore allows Alfresco to appear as a SharePoint server.

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.
   
3. Copy the ROOT.war file into the Tomcat 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 your Alfresco server.
      

Note: Refer to Known Issues in the Release Notes for more information on the SharePoint Protocol Support.

Running Alfresco Labs 3

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 on Windows:

• If you have installed Labs 3 using the installer, from the Start menu, select All Programs > Alfresco Labs > Start Alfresco Server, or
  
• Browse to C:\Alfresco and double-click alf_start.bat
  

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

To start Alfresco on Linux:

• Browse to /opt/alfresco/ and run alfresco.sh start
  

Stopping the Alfresco server

To stop the Alfresco server on Windows:

• If you have installed Labs 3 using the installer, from the Start menu, select All Programs > Alfresco Labs > Stop Alfresco Server, or
  
• Browse to C:\Alfresco and double-click alf_stop.bat
  

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

To stop the Alfresco server on Linux:

• Browse to /opt/alfresco/ and run alfresco.sh stop
  

Starting the web client and Share

To start the web client on Windows:

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

To start Alfresco Share on Windows:

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

To start the web client on any platform:

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

To start Alfresco Share on any platform:

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-3c-Full-Setup.exe	Full Alfresco install for Windows, including Share, DM and WCM web client, Web Studio, Records Management, and SharePoint functionality
Alfresco-Labs-3c-Mini-Setup.exe	Full Alfresco install for Windows, excluding JDK and OpenOffice
Alfresco-Labs-3c-OOo-Setup.exe	Full Alfresco install for Windows, excluding JDK
Alfresco-Labs-3c-Linux-x86-Install	Full Alfresco install for Linux, including Share, DM and WCM web client, Web Studio, Records Management, and SharePoint functionality
alfresco-labs-tomcat-3c.tar.gz	Preconfigured Tomcat bundle for any platform, including Linux, Solaris, and Apple Mac OS (.tar.gz format)
alfresco-labs-tomcat-3c.zip	Preconfigured Tomcat bundle for Windows (.zip format)
alfresco-labs-war-3c.tar.gz	Alfresco war files for deployment in existing application servers
alfresco-labs-war-3c.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-3c.tar.gz	WCM functionality for adding to an Alfresco Labs 3 install
alfresco-labs-wcm-3c.zip	WCM functionality for adding to an Alfresco Labs 3 install, zipped
alfresco-labs-deployment-3c.zip	http://wiki.alfresco.com/wiki/WCM_Deployment_Features
AlfrescoDeployLabs-3c-Setup.exe	Windows Installer for Deployment/FSR
AlfrescoDeployLabs-3c-Linux-x86-Install	Linux Installer for Deployment/FSR
alfresco-truncateMalformedXml.amp	XML utility

Alfresco Web Service Client

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

Alfresco SDK and APIs

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

Extensions

File	Description
alfresco-mmt-3c.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-3c.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-3c.zip	Add-in for Microsoft Excel  2003
alfresco-labs-office2003-addins-3c.zip	Add-in for Microsoft Office 2003
alfresco-labs-powerpoint2003-addin-3c.zip	Add-in for Microsoft Powerpoint 2003
alfresco-labs-word2003-addin-3c.zip	Add-in for Microsoft Word 2003