Etherpad is a highly customizable Open Source online editor providing collaborative editing in real-time. Etherpad allows you to edit documents collaboratively in real-time, much like a live multi-player editor that runs in your browser. When you install pad_project module in Odoo, you need to set up Etherpad server first. Installation and Setup of Etherpad is littelbit difficult and tricky. So here we came up with step by step guide to set up Etherpad server in Ubuntu.
We tried to set up Etherpad server inside Ubuntu 14.04 server.
Installation of Etherpad-lite
Create etherpad user.
sudo adduser –system –home=/opt/etherpad –group etherpad
Note : I choose /opt folder for the program location in order to keep things clean. So if you want to change that folder then make sure to alter some of the instructions and configuration files below respectively.
sudo apt-get install gzip git-core curl python libssl-dev build-essential abiword python-software-properties
Install nodejs & npm
curl -sL https://deb.nodesource.com/setup_5.x | sudo -E bash –
sudo apt-get install -y nodejs
Install and run Etherpad Lite
sudo su – etherpad -s /bin/bash
mkdir -p ~/local/etherpad
git clone git://github.com/ether/etherpad-lite.git
Etherpad-lite servcice is started now by running command bin/run.sh. Without closing the terminal you can open your favorite browser and access etherpad by this link http://localhost:9001/ or http://0.0.0.0:9001/
If you are able to see, following screen then it means your etherpad server is working properly.
Note : If you want to change the port for Etherpad server or other necessary changes, you can set them in following file.
Now let’s integrate this etherpad with Odoo. Install pad_project module.
After installation, you have to configure PAD server IP and API key in order to integrate Odoo with Etherpad server. To do so, open any company and inside Configuration tab, you will need to set proper values.
Pad Server : http://localhost:9001
Pad Api Key : ( You can get it from /opt/etherpad/local/etherpad/etherpad-lite/APIKEY.txt file. Just open that file, copy that key and paste it over here. )
Note : You can install Etherpad-lite into different server then Odoo server. It is not necessary to keep them both in same server. Just provide the remote IP inside ‘Pad Server‘ option inside the configuration in Odoo.
Upon everything properly set up, you will see etherpad available inside any task screen.
You have to start etherpad server manually everytime when you want it to integrate with Odoo. So if you want to create service for etherpad, follow below steps,
sudo mkdir /var/log/etherpad-lite
sudo touch /var/log/etherpad-lite/etherpad-lite.log
sudo chown etherpad.etherpad /var/log/etherpad-lite
sudo chmod -R 777 /var/log/etherpad-lite
Create file etherpad-lite under /etc/init.d folder & Paste the following file content into it.
sudo chmod -R 777 /etc/init.d/etherpad-lite
sudo chown -R etherpad.etherpad /etc/init.d/etherpad-lite
Let’s start Etherpad services,
service etherpad-lite start
If you want Etherpad services at startup time then apply following command,
sudo update-rc.d etherpad-lite defaults
That was all about how to set up Etherpad server and integreate it with Odoo. Feel free to send your valuable feedback in Comments area. I will look forward for your queries in case of if above steps are not working.