HOWTO Install eyeOS Office Support

From eyeOS Wiki

Jump to: navigation, search

eyeOS 1.5 comes with support to open and edit Office Documents like doc, odt, odp, ppt, ods, xls and other popular Office File formats.

By default, this feature is not enabled, because it needs some configurations at the server where eyeOS is installed. If you don't configure it, your eyeOS will not be able to open Office files.

To get office support, follow these simple steps (on the server; clients don't need any special configuration).

Contents

How to install

1. Install OpenOffice (eyeOS uses OpenOffice to convert formats).

2. Install xvfb (OpenOffice needs a X server to be executed in).

3. Make sure that the owner of the home directory of the apache user (www-data or nobody in some installations) is the apache user. For example, in Debian installations the apache user is www-data and the home for the user is /var/www but this directory is owned by root. You can change the home for apache user to /tmp if you don't want to change the owner or create a new directory.

4. Copy extras/OpenOffice/eyeOS.xba from the eyeOS installation directory to /usr/lib/openoffice/share/basic/Tools/

5. Edit /usr/lib/openoffice/share/basic/Tools/script.xlb and add <library:element library:name="eyeOS"/> under <library:element library:name="Debug"/>

6. Execute Xvfb :1 -ac -screen 0 800x600x16 -fbdir /tmp &

Possible problems

1. In the step 6, you may get the following error message: "Could not open default font 'fixed' xvfb". This means that you need some fonts in order to get xvfb working. To fix this problem, install the package xfonts-base (in Debian-based systems).

2. In the step 4, the path /usr/lib/openoffice/share/basic/Tools/ may not exist. This is because this path is OpenOffice's default lib path in Debian-based systems. You have to use the correct path for your system.

Some tips

If you want to execute Xvfb in each boot of your system, you can add a simple script in /etc/init.d/ called xvfb, with the following content:

Xvfb :1 -ac -screen 0 800x600x16 -fbdir /tmp &

and chmod it as executable.

A case with Ubuntu GNU/Linux 8.04 /Server

1. To minimize error messages, install the following packages:

sudo apt-get install openoffice.org xvfb xfonts-base x11-xkb-utils xfonts-100dpi xfonts-75dpi xfonts-scalable xfonts-cyrillic x-ttcidfont-conf xfs

2. Set Apache as owner in a new temporary directory:

sudo mkdir /var/www/tmp_eyeos
sudo chown -R www-data:www-data /var/www/tmp_eyeos

3. Copy the eyeOS plugin to OpenOffice (change eyeOS/eyeOS1ea3d52090 for your eyeOS web directory):

sudo cp /var/www/eyeOS/eyeOS1ea3d52090/extras/OpenOffice/eyeOS.xba /usr/lib/openoffice/share/basic/Tools/

4. Edit /usr/lib/openoffice/share/basic/Tools/script.xlb and under the existing line:

<library:element library:name="Debug"/>
add a new line:
<library:element library:name="eyeOS"/>

5. Create a text file for xvfb start, as /etc/init.d/xvfb.sh and with this content:

# !/bin/sh
echo "Starting Virtual Framebuffer 'fake' X server for OpenOffice in eyeOS..."
Xvfb :1 -ac -screen 0 800x600x16 -fbdir /var/www/tmp_eyeos

6. Give the file execution permissions, then run the new script:

sudo chmod +x /etc/init.d/xvfb.sh
/etc/init.d/xvfb.sh
and test eyeOS for OOffice text documents or SpreadSheets.

7. If all is right, link the xvfb starter to be run on each boot:

sudo ln -s /etc/init.d/xvfb.sh /etc/rc2.d/S99xvfb
sudo ln -s /etc/init.d/xvfb.sh /etc/rc3.d/S99xvfb
sudo ln -s /etc/init.d/xvfb.sh /etc/rc4.d/S99xvfb
sudo ln -s /etc/init.d/xvfb.sh /etc/rc5.d/S99xvfb

This procedure may be good for any Debian or Ubuntu system with LAMP

Personal tools