Lopad
From CrisisCommons Wiki
Lopad Project Homepage
Taken from: http://etherpad.com/crisiscampLDN
Lopad Project Homepage
Who's Working on It?
30/1/2010
@nickstreet @tkb @mrchrisadams
What is the lopad project?
Blog post at: http://blog.aptivate.org/2010/01/30/lopad-high-speed-low-bandwidth-collaboration/
Aptivate makes a service called loband - it takes high bandwidth webpages and makes them work quickly on slow connections.
There's a demand (from people like UNFAO, users in Rwanda etc.) for a related service, tuned for low bandwidth environments, that lets users easily collaborate over a text file. There's already a service called Etherpad (etherpad.com) which has been open-sourced since Google bought it and plans to discontinue the public service. There are some other public instances of etherpad (e.g. this PiratePad) but the goal of the lopad is to:
- Create lopad.org - a free public instance of etherpad, promoted for use in the relief and development sectors but open to anyone
- Optimise lopad.org to perform well on low bandwidth and/or high latency connections.
Lopad Fork We have created a fork of the etherpad project on github for developing the lopad project: http://wiki.github.com/nickstreet/lopad/
Server Details We have a server at lopad.org A 1core, 2gb vm provided by 1and1.co.uk for this purpose Running CentOS minimal (i.e. we've binned Plesk stuff that was there by default)
Useful guides: Google's instructions - http://code.google.com/p/etherpad/wiki/Instructions Instructions for CentOS - http://pauleira.com/13/installing-etherpad/
Get the dependencies installed Java 1.6: yum install java yum install java-1.6.0-openjdk-devel.i386 1:1.6.0.0-1.7.b09.el5 (development package needed for /usr/bin/jar).
Scala 1.7 yum install scala
Mysql yum install scala
Setup the exports Exports for the lopad.org server export JAVA_HOME="/usr/lib/jvm/jre-1.6.0-openjdk/" export JAVA="/usr/lib/jvm/jre-1.6.0-openjdk/bin/java" export SCALA="/home/etherpad/scala-2.7.7.final/bin/scala" export SCALA_HOME="/home/etherpad/scala-2.7.7.final/" export PATH=/home/etherpad/scala-2.7.7.final/bin/:$PATH export MYSQL_CONNECTOR_JAR="/usr/lib/mysql-connector-java-5.1.11/mysql-connector-java-5.1.11.jar" export mysql=mysql
(download mysql-connector from - http://dev.mysql.com/get/Downloads/Connector-J/mysql-connector-java-5.1.11.tar.gz/from/http://www.mirrorservice.org/sites/ftp.mysql.com/)
Exports on the headshift dummy server export SCALA="/home/etherpad/crisiscamp/scala-2.7.7.final/bin/scala" export SCALA_HOME="/home/etherpad/crisiscamp/scala-2.7.7.final//" export PATH=/home/etherpad/crisiscamp/scala-2.7.7.final/bin/:$PATH export MYSQL_CONNECTOR_JAR="/usr/share/java/mysql-connector-java-5.1.11/mysql-connector-java-5.1.11.jar" export mysql=mysql
clone the lopad git clone git://github.com/nickstreet/lopad.git
Setup the database in the etherpad directory run: sudo bin/setup-mysql-db.sh
Compile Go to the etherpad directory, and run: bin/rebuildjar.sh
Unfortunately this isn't currently working
Customise the installation for the server Follow the instructions here - http://pauleira.com/13/installing-etherpad/
Investigate how to make it work better over low bandwidths.
Pingdom tools is a good way of checking where the bandwidth is used:
http://tools.pingdom.com/?url=http://etherpad.com/crisiscampLDN&treeview=0&column=objectID&order=1&type=0&save=true
total page weight is - 385.2k
259.6kb are used by the main javascript file 67.6kb used by images 35kb by css 22.9kb by html
Reference
http://blog.aptivate.org/2010/01/23/make-sure-your-apps-work-in-the-field/
http://github.com/nickstreet/lopad
http://wiki.crisiscommons.org/wiki/Crisis_Camp_London
how to push to remote branch: http://gitready.com/beginner/2009/01/21/pushing-and-pulling.html
add to your hosts file:
- how to rebrand etherpad to lopad
http://www.mclear.co.uk/2010/01/rebranding-etherpad.html
- For tracking and graphing usage stats of lopad
I've setup an account on serverdensity that gives fairly easy to read graphs of usage and load on the box we're using for loband.
Username: crisiscampldn Password: 1db6ade3ce51ef01443d
Login for serverdensity: <> ?

