Setting up LibreOffice as a document converter for Sakai will massively improve the quality of the document preview functionality in the new grader. LibreOffice can be setup as a full blown server serving multiple nodes or as a Docker image running on each Sakai node. This guide will focus on the Docker image per Sakai node approach.
Step-by-step guide
- Install Docker on your Sakai node. This may well be your development machine if you're just trying this out. Visit https://docker.com and install the version for your OS.
- Now download and run the libreoffice/online:master Docker image. On linux or OSX you'd use this command: docker run -d -p 9980:9980 -e "extra_params=--o:ssl.enable=false" libreoffice/online:master. Details on the environment variable you can supply can be found at https://hub.docker.com/r/libreoffice/online/.
- Now you will have a LIbreOffice Online server running in a Docker container and listening on port 9980. On linux you can verify this with this command: netstat -nlp | grep 9980.
- In your sakai.properties or local.properties, add this property: fileconversion.enabled=true. Restart Tomcat. The file conversion service in Sakai should now talk to your Dockerised LIbreOffice Online server. This is currently setup to work with attachments in Sakai. Try this out in the Assignments tool by submitting a large powerpoint file. Within a few minutes that file should be available as a PDF and you'll be able to view it in the browser from the new grader.
File Types OOTB
DOCX
DOC
ODT
ODP
PPT
PPTX
Related articles