Ver el código de «Universal Office Converter (unoconv)»

{{Convertidores de documento}}{{Pendiente de traducir}}

==¿Qué es unoconv?==

"unoconv" is a command line program that is used to convert between different office document file formats. It uses an instance of [http://libreoffice.org LibreOffice] to do the conversion and is used by the [[Actividad de tarea]] to convert documents to pdf so that they can be annotated. If unoconv is not installed - the only impact is that the assignment activities will only allow annotations when students upload a pdf document. 

The steps required to install unoconv are different depending on the operating system that you have installed Moodle on. 

== Instalar unoconv en Linux ==
The required version of unoconv is at least 0.7. Depending on your flavour of linux, this may be available in your package manager and you can install it directly with:

===Ubuntu 18.04 LTS===
<pre>
apt-get install unoconv
mkdir /var/www/.config
chown www-data:www-data /var/www/.config
</pre>

===Ubuntu 16.04 LTS===

<pre>
apt-get install unoconv
</pre>

If your package manager contains an older version of the package, you will have to find a newer version and install it manually ([https://packages.debian.org/stretch/unoconv Debian Testing]). Unoconv itself is just a python script, so it has few dependencies.

Potential problems:
* On some systems the apache user home directory is set to a non existent folder. This can cause unoconv to fail. There are 2 solutions to this - one is to make a (writable) home directory for the apache user (like /home/www-data). The other is to run a unoconv listener (described below) as another user other than the apache user (someone with a valid, writable home directory).
* If you are still running 14.04LTS then unoconv won't work as shipped. This might not be the most efficient route but it worked by first installing unoconv (version 0.6) from the package manager as above. You will then need to grab unoconv 0.7 from Github (https://github.com/dagwieers/unoconv), then upgrade to the latest libreoffice using the PPA (https://launchpad.net/~libreoffice/+archive/ubuntu/ppa). Point moodle at the Github version of unoconv. You need to modify the Python unoconv file by changing 'python' in the first line to 'python3'. You also need to change the permissions on the directory /var/www so that the user www-data can write to it (www-data needs to write to its home directory which it cannot do by default).
On Debian Stable, the cleanest method to install [https://packages.debian.org/jessie-backports/unoconv unoconv] is using Jessie-backports. First, enable backports repo line in /etc/apt/sources.list:
<pre>
#### Jessie-backports  ####
deb http://ftp.debian.org/debian jessie-backports main
</pre>

Then, update and install unoconv from jessie-backports:
<pre>
apt-get update
apt-get install -t jessie-backports unoconv
</pre>

The package will bring all necessary dependencies for you.


===Ubuntu 14.04 LTS===

1) Navigate to opt directory
<pre>
cd /opt
</pre>

2) Download unoconv
<pre>
sudo wget https://raw.githubusercontent.com/dagwieers/unoconv/master/unoconv
</pre>

3) Modify the Python unoconv file by changing 'python' in the first line to 'python3'
<pre>
sudo nano /opt/unoconv
</pre><br>
eg. <pre>#!/usr/bin/env python3</pre>

4) Make unoconv executable
<pre>
sudo chmod ugo+x /opt/unoconv
</pre>

5) Add LibreOffice PPA to your system and install the latest version
<pre>
sudo add-apt-repository ppa:libreoffice/ppa
sudo apt-get update
sudo apt-get install libreoffice
</pre>

6) Change permissions so apache can write to its home directory
<pre>
sudo chown www-data /var/www
</pre>

7) From your browser navigate to
''Site administration > Server > System paths'' and add the path to unoconv<br>
/opt/unoconv
*Note: if you would like to preserve the default path add a symbolic link to /usr/bin: 
<pre>
sudo ln -s /opt/unoconv /usr/bin/
</pre>

8) Navigate to 
''Site administration > Plugins > Activity modules > Assignment > Feedback plugins > Annotate PDF > Test unoconv path'' <br>
You should see: <br>
"The unoconv path appears to be properly configured."<br>
*Download the converted pdf test file. (if the PDF fails to load ensure that www-data can write to its home directory: /var/www)

===CentOS / RedHat===
Just before you start, you might like to consider installing the latest [http://www.tecmint.com/install-libreoffice-on-rhel-centos-fedora-debian-ubuntu-linux-mint/ LibreOffice 5.2] directly from RPM packages, that are not part of the distribution you are using.
As of nov-2016, CentOS and RedHat 7.2 comes with OpenOffice 4.3 . so if you are not interested in using this version and would like to install latest 5.2 independent LibreOffice 5.2 , please remove any openoffice packages you might have on your OS by issuing:
<pre>
yum remove openoffice* libreoffice*
</pre>
It is recommended to chose your localized libreoffice version for better document conversions.  
<pre>
yum install libreoffice libreoffice-pyuno
git clone https://github.com/dagwieers/unoconv.git
# copy 
cp unoconv/unoconv /usr/bin
# or link unoconv to /usr/bin
ln -s unoconv/unoconv /usr/bin/unoconv
</pre>
 Note: depends on what version you are installing, openoffice or libreoffice, make sure you installed the *-pyuno package. (the headless package is already compiled into the core)

Make sure it is properly configured:
http://your-moodle/admin/search.php?query=unoconv

Production servers should consider running unoconv in listener mode, see [[Installing_unoconv#Run_a_unoconv_listener]] or follow directions bellow
<pre>
vi /etc/systemd/system/unoconv.service
</pre>
And then copy and paste the following configuration into it:
<pre>
[Unit]
Description=Unoconv listener for document conversions
Documentation=https://github.com/dagwieers/unoconv
After=network.target remote-fs.target nss-lookup.target

[Service]
Type=simple
Environment="UNO_PATH=/usr/lib64/libreoffice/program"
ExecStart=/usr/bin/unoconv --listener

[Install]
WantedBy=multi-user.target
</pre>
And then enable and start the above service
<pre>
systemctl enable unoconv.service
systemctl start unoconv.service
</pre>
If your selinux is enable yous should set 
<pre>
#setsebool -P httpd_execmem on
</pre>
== Installing unoconv on OS X ==
Download and install LibreOffice for Mac. Unfortunately - newer versions of LibreOffice are not currently compatible with unoconv for mac and you will have to install LibreOffice 4.2 (Direct download link - https://downloadarchive.documentfoundation.org/libreoffice/old/4.2.5.2/mac/x86_64/LibreOffice_4.2.5.2_MacOS_x86-64.dmg).

Get the latest version of the unoconv python script. One way to do this is with http://brew.sh/ brew.
<pre>
brew install unoconv
</pre>

If you haven't done it already - install ghostscript. One way to install ghostscript is also with http://brew.sh/ brew
<pre>
brew install ghostscript
</pre>

Set the paths to unoconv and ghostscript in Moodle (''Site administration > Server > System paths''). If you used brew, they will both be installed to /usr/local/bin.

LibreOffice needs write access to the current users home directory to create some temporary files. When unoconv is run as the webserver user (_www) it does not normally have this permission.

There are some ways to get around this - one way is just to give the "_www" user write access to /Library/WebServer. 

Another solution is to convince LibreOffice that this users home directory is somewhere else. This can be done by inserting this code into the top of the unoconv python script.
Code to insert:
<pre>
# Set home to a writable folder. 
os.environ['HOME'] = '/tmp/'                                                                                                        
</pre>

This needs to be inserted at line 36 immediately after the line "exitcode = 0"

== Instalar unoconv en Windows ==
Descargar e instalar LibreOffice para Windows.

Descargue la versión más reciente del script unoconv de https://github.com/dagwieers/unoconv/releases (descargar versión ZIP). 

Del archivo ZIP descargado - extrael elarchivo "unoconv-0.7\unoconv" (no tiene extensióndel archivo). Este es el script de unoconv - no se necesita ningún otro archivo de los incluidos en el paquete. 

Renombre el script descargado a C:\unoconv\unoconv.py

Crear un archivo para proceso en  lotes (''batch'') C:\unoconv\unoconv.bat con estos contenidos:

<pre>
@"C:\Program Files\LibreOffice\program\python.exe" c:\unoconv\unoconv.py %*
</pre>

Configure las rutas en Moodle. 

Ingrese como admin y vaya a ''Administración del sitio > Servidor > Rutas del sistema''

Configure pathtogs al binario de su instalación de ghostscript, (C:\gs\bin\gswin32c.exe)
(No use gswin32.exe ni gswin64.exe, esos no son programas para línea de comandos - use gswin32c.exe o gswin64c.exe)

Configure pathtounoconv al archivo de proceso en lotes (''batch'') creado arriba (C:\unoconv\unoconv.bat)

Pruebe que funcionan correctamente ghostscript y unoconv en las páginas de prueba de administración "Administracióndel sitio > Plugins > Módulos de actividad > Tarea > Plugins de retroalimentación > Annotate PDF".

== Correr un unoconv listener ==
Unoconv utilises a client/server process when converting documents. By default, when there is no running server process - each time unoconv runs it will start a server process, send its request and shut down the server process when the request is complete. The drawback of this mode is that if 2 requests are submitted simultaneously - this can cause the first request to shutdown the server process when the second request is still in progress - and the second conversion request fails. A more robust way to configure unoconv is to start a server process at boot time, and/or run a script to monitor it and restart it if it crashes.

To start a unoconv listener at boot time - you need a start up script. Different operating systems and Linux distributions use different startup scripts - but here are some examples of startup scripts for different systems.

[https://docs.moodle.org/34/en/mod/assign/feedback/editpdf/testunoconv/upstart Upstart script for Ubuntu based systems]

[https://docs.moodle.org/34/en/mod/assign/feedback/editpdf/testunoconv/launchd Launchd script for OS X]

[https://docs.moodle.org/34/en/mod/assign/feedback/editpdf/testunoconv/initd Init script for Debian]

[https://docs.moodle.org/34/en/mod/assign/feedback/editpdf/testunoconv/initdcentos6Init script for CentOS/RedHat 6.x]

[https://docs.moodle.org/34/en/mod/assign/feedback/editpdf/testunoconv/systemd SystemD service script for CentOS/RedHat 7.x]

== Descargar el procesamiento a un servidor diferente ==
Processing office documents can put increased load on your webserver, which may impact on the responsiveness of your site. If you are installing unoconv on a large site you may want to consider running unoconv on a server that is not also serving web requests.

How to do this:

Install unoconv on each webservers and the remote server following the installation instructions above. 

Make sure unoconv is started at boot time on the remote server with the "--listener" argument and is monitored and restarted if it exits (see Debian init script for an example of how to do this). By default, unoconv will only listen on localhost (127.0.0.1): if you want to connect to the listener process from another server, you need to start the unoconv listener process with the "--server" argument too!

An example command for starting a listener on a remote server (0.0.0.0 listens on all interfaces):
<pre>
unoconv --listener --server 0.0.0.0 --port 2002
</pre>

Open the firewall port 2002 between the moodle webservers and the machine running unoconv.

Share the moodle data root between the webservers and the machine running unoconv. This folder must be mounted at the same path on all servers. 

Install a wrapper for unoconv on the webservers that forwards the requests to the remote server. Example:
<pre>
#!/bin/bash
# Wrapper script for unoconv to forward processing.
# Install to /usr/bin/unoconv-remote with 755 permissions
/usr/bin/unoconv --server=<ip of remote server> "$@"
</pre>

Configure the path to unoconv in the Moodle admin settings to point to this wrapper script.

==Recursos adicionales==

[https://github.com/dagwieers/unoconv GitHub dagwieers/unoconv] has additional information on installation of unoconv and troubleshooting tips.

==Slución de problemas==
* [http://webnetkit.com/soffice-bin-using-100-cpu-moodle/ soffice.bin using 100% of CPU MOODLE]

==Vea también==

* [https://moodle.org/mod/forum/discuss.php?d=335310 Is the unoconv installation a security risk?] forum discussion



[[Categoría:Administración del sitio]]
[[Categoría:Tarea]]

[[en:Universal Office Converter (unoconv)]]