Installing Live Edit

Live Edit works with Microsoft Office and OpenOffice.org. It is available for Internet Explorer and Firefox browsers. The table below summarizes the extensions and packages you need to install for each OS and browser. The Microsoft Office extension is available in 32- and 64-bit. You need to install the version corresponding to Microsoft Office, not the operating system (if you run MS Office 32-bit on Windows 7 64-bit, you need to install Live Edit for MS Office 32-bit).   Internet Explorer Firefox Microsoft Office 32-bit Live Edit MS Office-IE 32-bit (.msi) Live Edit MS Office-IE 32-bit (.msi) Firefox Protocol Handler for FF <3.6 or Firefox Protocol Handler for FF 4+ Microsoft Office 64-bit Live Edit MS Office-IE 64-bit (.msi) Live Edit MS Office-IE 64-bit (.msi) Firefox Protocol Handler for FF <3.6 or Firefox Protocol Handler for FF 4+ OpenOffice.org / LibreOffice Live Edit MS Office-IE 32-bit (.msi) Live Edit OOo Distribution (.exe) Live Edit OpenOffice.org extension (.oxt) Firefox Protocol Handler for FF <3.6 or Firefox Protocol Handler for FF 4+ All Live Edit extension versions are available from: http://download.nuxeo.org/desktop-integration/live-edit/. Live Edit MS Office requirements The Live Edit MS Office installers require .Net and the installation of the Microsoft Office Primary Interop Assemblies (PIA) that corresponds to the version of Microsoft Office. These are already installed on a complete default installation of MS Office, so you probably don't need to install them. PIA for MS Office 2010: http://www.microsoft.com/download/en/details.aspx?id=3508 PIA for MS Office 2007: http://www.microsoft.com/download/en/details.aspx?id=18346 For Internet Explorer 9 users If you are on a 64-bits Windows you have two versions of Internet Explorer 9 (32-bits and 64-bits of course), if you have Office 32-bits and use Internet Explorer 64-bits, you'll need to apply this registry fix to enable Live Edit in Internet Explorer 9 64-bits: liveedit-ie-x64-fix.reg For Windows XP / MS Office 2003 32 bits users You need to install the previous version of Live Edit (2.3.0) available from: http://download.nuxeo.org/desktop-integration/live-edit/nuxeo-liveedit-msoffice-ie-2.3.0.msi. You also need to install the Microsoft Visual Studio 2005 Tools for Office Runtime available from: http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=24263.

On this page For MS Office and Internet Explorer users For MS Office and Firefox users Installing Live Edit for MS Office Installing Firefox Protocol Handler Configuring the Firefox protocol handler For OpenOffice.org and Internet Explorer users For OpenOffice.org and Firefox users Installing the Live Edit OpenOffice.org extension (.oxt) Installing Firefox Protocol Handler Configuring the Firefox protocol handler For Google Chrome users under MS Windows

For MS Office and Internet Explorer users

To install Live Edit for MS Office:

1. Run the Live Edit installer and follow the instructions.
2. If your are using Internet Explorer, close all windows and restart it.
3. Go on your Nuxeo application.
   You now have new icons displayed:
   • MS Office icons below the search box
     
   • an online editing icon in the workspace listing for MS office documents
     
   • an online editing icon in the Summary tab of MS office documents
     
     You can now edit documents online.

For MS Office and Firefox users

Making LiveEdit work for MS Office documents when you use Firefox takes 3 steps:

1. Install Live Edit for MS Office,
2. Install the Firefox extension for Live Edit, called protocal handler,
3. Configure the Firefox protocol handler.

Installing Live Edit for MS Office

You need to install Live Edit for Microsoft Office using the same installer as for MS Office and Internet Explorer: just run the installer and follow the instructions displayed.
At the end of this step, you won't see the online editing icons, because you need to install and configure the Firefox protocol handler.

Installing Firefox Protocol Handler

The Firefox Live Edit extension is a regular Firefox extension and gets installed the same way as any other extension on that browser.
To install it, click on the link to download it and follow the instructions displayed.
At this stage, you still won't see the online editing icons in the application. To see the icons and be able to edit documents, you need ton configure the protocol handler.

Configuring the Firefox protocol handler

To configure Live Edit Firefox Protocol Handler:

1. In Firefox, go to Tools > Add-ons > Nuxeo Live Edit Protocol Handler > Preferences (or Options).
2. Change the temp folder : /tmp/ with C:\Temp (or another temp folder like C:\Windows\Temp)
3. Set the mime-types you want to use Live Edit with and click on Add new mapping (see below for the mimetypes mapping).
4. Be sure that the checkbox "Use NXWss" is un-checked.

5. Be sure that the checkbox "Preserve compatibility" is un-checked.

   Since version 0.4.6 of the protocol handler, there is a checkbox labeled "Preserve compatibility" that allows to preserve the backward compatibility. This box must be checked when the targeted server is pre 5.2. Without checking it, the add-on is forming a different type of headers allowing using of a bunch of new features like WebEngine (but it works only for the server 5.2 +). Simple said: if Live Edit appear not to work (there is no available Edit online link) and the targeted Nuxeo server is not 5.2 or higher, check that the "Preserve compatibility" is marked. if some cool features like WebEngine are not available (throwing exception) and the targeted Nuxeo server is 5.2 or higher, check that the "Preserve compatibility" is not marked.

6. Click Ok.

MS Office mimetype mapping with MS Office

For OpenOffice.org and Internet Explorer users

To make Live Edit work when you use OpenOffice.org and Internet Explorer, you need to:

1. install the MS Office - IE Live Edit (see Installing Live Edit for MS Office),
2. install the OpenOffice.org - IE Live Edit extension (see below).

To install Live Edit for OpenOffice.org and Internet Explorer:

1. Run the OpenOffice.org - IE Live Edit installer (.exe) and follow the instructions displayed.
2. Restart Internet Explorer if you have windows open.
3. Go on your Nuxeo application.
   You now have new icons displayed:
   • MS Office and OpenOffice.org icons below the search box
     
   • an online editing icon in the workspace listing for MS Office and OpenOffice.org documents
     
   • an online editing icon in the Summary tab of MS Office and OpenOffice.org documents
     
     You can now edit documents online.

For OpenOffice.org and Firefox users

To be able to edit OpenOffice.org documents online using Firefox, you need to:

1. install the Live Edit OpenOffice.org extension (.otx),
2. install the Firefox protocol handler,
3. configure the Firefox protocol handler.

Installing the Live Edit OpenOffice.org extension (.oxt)

The Live Edit extension for OpenOffice.org is a regular OOo extension and gets installed the same way as any other extension: just double-click the .otx file and follow the instructions.

The Live Edit extension for OpenOffice requires Java support in OpenOffice, this is included in most of distributions, but on some Linux distributions you may need to install openoffice-java-common for the extension installation to work.

Then you need to install and configure the Firefox extension.

Installing Firefox Protocol Handler

The Firefox Live Edit extension is a regular Firefox extension and gets installed the same way as any other extension on that browser.
To install it, click on the link to download it and follow the instructions displayed.
At this stage, you still won't see the online editing icons in the application. To see the icons and be able to edit documents, you need ton configure the protocol handler.

Configuring the Firefox protocol handler

To configure Live Edit Firefox Protocol Handler:

1. In Firefox, go to Tools > Add-ons > Nuxeo Live Edit Protocol Handler > Preferences (or Options).
2. Change the temp folder : /tmp/ with C:\Temp (or another temp folder like C:\Windows\Temp)
3. Set the mime-types you want to use Live Edit with and click on Add new mapping (see below for the mimetypes mapping).
4. Be sure that the checkbox "Use NXWss" is un-checked.

5. Be sure that the checkbox "Preserve compatibility" is un-checked.

   Since version 0.4.6 of the protocol handler, there is a checkbox labeled "Preserve compatibility" that allows to preserve the backward compatibility. This box must be checked when the targeted server is pre 5.2. Without checking it, the addon is forming a different type of headers allowing using of a bunch of new features like WebEngine (but it works only for the server 5.2 +). Simple said: if Live Edit appear not to work (there is no available Edit online link) and the targeted Nuxeo server is not 5.2 or higher, check that the "Preserve compatibility" is marked. if some cool features like WebEngine are not available (throwing exception) and the targeted Nuxeo server is 5.2 or higher, check that the "Preserve compatibility" is not marked.

6. Click Ok.

OpenOffice.org and MS Office mimetype mapping with OpenOffice.org

Live Edit OpenOffice.org is not compatible with MS Office 2007 documents yet.

For Google Chrome users under MS Windows

For Windows users, Chrome will use Windows registry where NuxeoLiveEdit protocol is declared (LiveEdit for MS IE must be installed). However some steps are needed to configure your computer and the server.

On your machine, you need to force Chrome to handle nxedit protocol:

1. Close Google Chrome because at shutdown it dumps its properties in the file we'll modify.
2. Edit the Local Statefile located under:
   • XP: C:\Documents and Settings\<USERNAME>\Local Settings\Application Data\Google\Chrome\User Data;
   • Vista/7: C:\Users\<USERNAME>\AppData\Local\Google\Chrome\User Data.

3. Add the protocol nxedit under the protocol_handlersection, as such:

      "protocol_handler": {
         "excluded_schemes": {
            ...
            "nxedit": false,
            ...
      }
   

If the section protocol_handler doesn't exist, find a mailto link and follow it, it should initialize this section.

Server side, because we don't have yet a mechanism to detect that LiveEdit is configured, you have to set a property to allow LiveEdit on each document type. As a consequence, you'll have to pay attention when clicking on LiveEdit links.

1. Edit $NUXEO_HOME/templates/common/config/nuxeo.properties.
2. Change the value for the property org.nuxeo.ecm.platform.liveedit.config from client to server (uncomment the line if needed).
3. Restart the Nuxeo server.