Installing Labs 3

From AlfrescoWiki

Jump to: navigation, search

Download and install Labs 3b to test drive the Draft CMIS implementation.

Alfresco Labs 3b is available for Windows and Linux. Learn more about what's in Alfresco Labs 3b.

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

Contents

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 scenarioDownloadUse 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 3b:

  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 3b.
  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 5 or 6 (latest versions of either).

To install Alfresco Labs 3b, 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 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 (on Windows).

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 3b, 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 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 3b 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. 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 3b.
  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. (Please 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. [[1]])
  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 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.

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

FileDescription
Alfresco-Labs-3b-Full-Setup.exeFull Alfresco install for Windows, including Share Preview, DM & WCM web client, Records Management, & SharePoint functionality
Alfresco-Labs-3b-Mini-Setup.exeFull Alfresco install for Windows, excluding JDK and OpenOffice
Alfresco-Labs-3b-OOo-Setup.exeFull Alfresco install for Windows, excluding JDK
Alfresco-Labs-3b-Linux-x86-InstallFull Alfresco install for Linux
alfresco-labs-tomcat-3b.tar.gzPreconfigured Tomcat bundle for any platform, including Linux, Solaris, and Apple Mac OS (.tar.gz format)
alfresco-labs-tomcat-3b.zipPreconfigured Tomcat bundle for Windows (.zip format)
alfresco-labs-war-3b.tar.gzAlfresco war files for deployment in existing application servers
alfresco-labs-war-3b.zipAlfresco war files for deployment into existing application servers, zipped

SharePoint Protocol support

FileDescription
vti-module.ampConnector functionality for Microsoft SharePoint Protocol support
ROOT.warMicrosoft SharePoint Protocol support servlet that forwards Office requests to the main web application

Alfresco WCM

FileDescription
alfresco-labs-wcm-3b.tar.gzWCM functionality for adding to an Alfresco Labs 3 install
alfresco-labs-wcm-3b.zipWCM functionality for adding to an Alfresco Labs 3 install, zipped
alfresco-labs-deployment-3b.ziphttp://wiki.alfresco.com/wiki/WCM_Deployment_Features
AlfrescoDeployLabs-3b-Setup.exeWindows Installer for Deployment/FSR
AlfrescoDeployLabs-3b-Linux-x86-InstallLinux Installer for Deployment/FSR
alfresco-truncateMalformedXml.ampXML utility

Alfresco Web Service Client

FileDescription
alfresco-web-service-client-3b.tar.gzWSDL-based API providing standard remote access to the Alfresco Repository
alfresco-web-service-client-3b.zipWSDL-based API providing standard remote access to the Alfresco Repository, zipped

Alfresco SDK and APIs

FileDescription
alfresco-labs-sdk-3b.tar.gzSoftware Development Kit, including the source files
alfresco-labs-sdk-3b.zipSoftware Development Kit, including the source files, zipped
alfresco-labs-sample-extensions-3b.tar.gzSample extensions such as custom-repository.properties
alfresco-labs-sample-extensions-3b.zipSample extensions such as custom-repository.properties, zipped
phpIntegration.ampAdd-in for PHP integration

Extensions

FileDescription
alfresco-mmt-3b.jarModule Management Tool, already included in main server bundles. http://wiki.alfresco.com/wiki/Module_Management_Tool
aggadget.zipiGoogle gadgets
alfresco-blog-integration.ampBlog publishing, deprecated
alfresco-bm-3b.jarJCR Benchmarking toolkit, http://wiki.alfresco.com/wiki/Server_Benchmarks
alfresco-fb-doclib.ampFaceBook integration
alfresco-recordsmanagement.ampRecords Management sample functionality, http://wiki.alfresco.com/wiki/Records_Management_User_Guide

Microsoft Office add-ins

FileDescription
alfresco-labs-excel2003-addin-3b.zipAdd-in for Microsoft Excel 2003
alfresco-labs-office2003-addins-3b.zipAdd-in for Microsoft Office 2003
alfresco-labs-powerpoint2003-addin-3b.zipAdd-in for Microsoft Powerpoint 2003
alfresco-labs-word2003-addin-3b.zipAdd-in for Microsoft Word 2003