mrchrisadams / etherpad

Fork of Etherpad Opensource application. With some fixes. Imports and Exports (with file conversion) patched.

Karteek's Etherpad Fork

Package

• Etherpad source from Etherpad Google Code repository
• Some minor fixes/changes here and there
• Oo.org integration for file exports and file imports from DOC/RTF format
• Commented code for File imports due to license restrictions

How to

1. Grab the code from github $ git clone git://github.com/karteek/etherpad.git
2. Set up the environment in env.sh and source the file. The settings inside are from my MBP. Do update them to meet your machine's settings. $ source env.sh
3. Create a database "etherpad", add a user "etherpad" with password "password" on a MySQL database server. Grant all privileges for on database etherpad to etherpad@localhost
4. Update etherpad.SQL_JDBC_URL, etherpad.SQL_USERNAME, etherpad.SQL_PASSWORD and etherpad.adminPass in the file "etherpad/etc/etherpad.localdev-default.properties"
5. Change dir to etherpad, compile the jar and start the server $ cd etherpad $ bin/rebuildjar.sh $ bin/run-local.sh
6. You are done. Visit http://localhost:9000 to check your instance

How to Enable File Imports

1. File Imports depend on cos.jar - com.oreilly.servlet
2. Do read the license
3. Even now, if you want to continue with imports just apply this gist or
   • Download cos.jar from the site and copy it to infrastructure/lib folder
   • In infrastructure folder, find out the files, where imports functionality is commented $ grep -R "REMOVED_COS_OF_COS" *
   • Uncomment and recompile JAR

How to Enable Exports

1. Make sure that there is a "etherpad.soffice" entry in the file "etherpad/etc/etherpad.localdev-default.properties"
2. You need Openoffice.org to be running on your machine as service. It usually on linux is $ /path/to/openoffice/program/soffice.bin -headless -nofirststartwizard -accept="socket,host=localhost,port=8100;urp;StarOffice.Service"
3. Check the file "infrastructure/com.etherpad.openofficeservice/importexport.scala" for more info

How to deploy the same on example.com

1. Edit your dns and point *.example.com to the same server where example.com resides
2. Make sure that your SMTP is working
3. Open etherpad/src/main.js, and update domain in line #273
4. Open etherpad/src/etherpad/globals.js and change the domain in variable SUPERDOMAINS found at line #30
5. Open etherpad/src/static/crossdomain.xml and add your domain to crossdomains.xml
6. Look into the src folder and update your domain where etherpad.com is used (especially emails) $ grep -ir "etherpad.com" * and update domain in all the files.
7. Open etherpad/etc/etherpad.localdev-default.properties and update
   • devMode to false
   • etherpad.isProduction to true
   • listen to example.com:80 and change passwords too.
8. Now start the server. You will need root access on OS X to bind to ports < 1000. $ bin/run-local.sh

How to do the same on example.com but with a reverse proxy on Apache

1. Do steps 1 thru 7 in above. But dont update listen as told in 7, rather update listen to example.com:9000, and set hidePorts to true
2. Create a vhost entry. It might look like this gist
3. Restart apache, and things should work

Other applied patches

• Enable brace-matching from cjb/etherpad@15e20c0e
• HidePorts from cjb/etherpad@e0b7c500