Anita Kuno f0026fffc6 Add info about browser incompatibility to etherpad.rst

There is a chrome extension that adds empty lines to an etherpad.
We want to note this extension and discourage its use for
consumers of etherpads.

Change-Id: Ib5a8f4edf17f578c0fbd98cb0b124ff37b557584

2014-01-16 13:31:46 -05:00

2.2 KiB

Raw Blame History

title: Etherpad

Etherpad

Etherpad (previously known as "etherpad-lite") is installed on etherpad.openstack.org to facilitate real-time collaboration on documents. It is used extensively during OpenStack Developer Summits.

At a Glance

Hosts

http://etherpad.openstack.org

Puppet

modules/etherpad_lite
modules/openstack_project/manifests/etherpad.pp
modules/openstack_project/manifests/etherpad_dev.pp

Projects

Bugs

Overview

Apache is configured as a reverse proxy and there is a MySQL database backend.

Manual Administrative Tasks

The following sections describe tasks that individuals with root access may need to perform on rare occasions.

Deleting a Pad

On occasion it may be necessary to delete a pad, so as to redact sensitive or illegal data posted to it (the revision history it keeps makes this harder than just clearing the current contents through a browser). This is fairly easily accomplished via the HTTP API, but you need the key which is saved in a file on the server so it's easiest if done when SSH'd into it locally:

wget -qO- 'http://localhost:9001/api/1/deletePad?apikey='$(cat \
/opt/etherpad-lite/etherpad-lite/APIKEY.txt)'&padID=XXXXXXXXXX'

...where XXXXXXXXXX is the pad's name as it appears at the end of its URL. If all goes well, you should receive a response like:

{"code":0,"message":"ok","data":null}

Browse to the original pad's URL and you should now see the fresh welcome message boilerplate for a new pad. Check the pad's history and note that it has no authors and no prior revisions.

Incompatible Behaviour

If an etherpad consumer is browsing to the etherpad using a chrome browser with an extension called Accents Plus installed, the etherpad will add infinite empty lines to the bottom of the etherpad. We recommend disabling this extension while viewing etherpads with chrome. * http://www.chromeextensions.org/other/accents-plus/#.UtghyfiZg5k

2.2 KiB Raw Blame History