guide - John McLear

Archive for the ‘guide’ Category

Install Etherpad Lite on Ubuntu and Debian

Date: 2011.08.01 | Category: etherpad, guide, install, installations | Response: 15

UPDATE: These docs are now out of date, you should use the official install documents provided by the Etherpad Foundation.

Installing Etherpad Lite on Debian/Ubuntu clean.

Part 1 – Installing prerequisites
```
apt-get install build-essential python libssl-dev git-core git libsqlite3-dev gzip curl
# you will be prompted to press Y
```
Part 2 – Installing nodeJS and NPM
```
mkdir ~/local
cd ~/local
wget http://nodejs.org/dist/v0.6.12/node-v0.6.12.tar.gz
tar -zxvf node-v0.6.11.tar.gz
cd node-v0.6.11
./configure --prefix=$HOME/local/node
make
make install
echo 'export PATH=$HOME/local/node/bin:$PATH' >> ~/.profile
echo 'export NODE_PATH=$HOME/local/node:$HOME/local/node/lib/node_modules' >> ~/.profile
source ~/.profile
```
Part 3 – Installing Etherpad Lite and running it
```
git clone git://github.com/Pita/etherpad-lite.git
etherpad-lite/bin/run.sh
# You will be prompted to type Etherpad Lite rocks my socks.
```
You are now finished installing and Etherpad Lite should be running, you should be able to access it on http://localhost:9001

Only if you have an old version of Debian (Lenny) or Ubuntu then you will need to install sqllite from backports. To do open /etc/apt/sources.list and add:
```
deb http://backports.debian.org/debian-backports lenny-backports main
```
Save and close the file then type
```
apt-get update
apt-get -t lenny-backports install libsqlite3-dev
```
You may need to rebuild your modules if you have an error, to do this do an rm -Rf node_modules and run the startup script (run.sh) again!

Want to run Etherpad Lite as a service? Follow this guide. Make sure you do a chown -R etherpad-lite on the etherpad-lite folder if you have run it as root or any other user before hand..
Installing Etherpad on Debian

Date: 2010.03.10 | Category: debian, etherpad, google, guide, install, installations | Response: 21

IMPORTANT NOTE: ETHERPAD HAS BEEN REPLACED BY ETHERPAD LITE. YOU SHOULD FOLLOW THIS GUIDE.

IMPORTANT NOTE: THIS DOCUMENTATION IS NOW DATED. You can now install Etherpad from apt.

Installing Etherpad 1.0.1 with APT

Add the following line as a source in your graphical package manager (In Ubuntu: System->Administration->Synaptic package manager; then Settings->Repositories and then finally Third party software), or edit the file /etc/apt/sources.list and add it there.
```
deb http://apt.etherpad.org all .
```
```
apt-get update
apt-get install etherpad
```
Answer the questions (if any, depends on your system settings)
```
/etc/init.d/etherpad start
```
Other Linux distributions
Download the .tgz and unpack it
Follow instructions in README

BELOW IS THE OLD GUIDE for Etherpad V1 released by Google

Install prereqs
```
echo "deb http://ftp.de.debian.org/debian sid main non-free" >> /etc/apt/sources.list
apt-get update
apt-get install sun-java6-jdk
```
If the above fails then do not continue. The output of
```
java -version
```
Should read..
```
java version "1.6.0_17"
Java(TM) SE Runtime Environment (build 1.6.0_17-b04)
Java HotSpot(TM) Client VM (build 14.3-b01, mixed mode, sharing)
```
```
apt-get install scala mysql-server libmysql-java mercurial
```
Paste the below to /etc/profile
```
export PATH
export JAVA_HOME="/usr/lib/jvm/java-6-sun"
export SCALA_HOME="/usr/share/java"
export JAVA="/usr/bin/java"
export SCALA="/usr/bin/scala"
export PATH="/usr/bin:/usr/bin:/usr/local/mysql/bin:$PATH"
export MYSQL_CONNECTOR_JAR="/usr/share/java/mysql-connector-java-5.1.10.jar"
export JAVA_HOME SCALA_HOME JAVA SCALA MYSQL_CONNECTOR_JAR PATH
umask 022
```
Download the etherpad source to /usr/local/etherpad
```
hg clone https://etherpad.googlecode.com/hg/ /usr/local/etherpad
```
Set the environment variables
```
export JAVA_HOME="/usr/lib/jvm/java-6-sun"
export SCALA_HOME="/usr/share/java"
export JAVA="/usr/bin/java"
export SCALA="/usr/bin/scala"
export PATH="/usr/bin:/usr/bin:/usr/local/mysql/bin:$PATH"
export MYSQL_CONNECTOR_JAR="/usr/share/java/mysql-connector-java-5.1.10.jar"
```
Add your domain to the superdomain section
```
nano /usr/local/etherpad/trunk/etherpad/src/etherpad/globals.js
```
Search for etherpad.com and replace it with your domain (confused? You will figure it out)

Create the etherpad mysql db and privelidges
```
mysql -u root -p
```
Enter your password when prompted
```
create database etherpad;
grant all privileges on etherpad.* to 'etherpad'@'localhost' identified by 'password';
quit
```
```
cd /usr/local/etherpad/trunk/etherpad/
ln -s /usr/share/java /usr/share/java/lib
bin/rebuildjar.sh
bin/run-local.sh
```
Wait quite a while while it builds.
Test by browsing to your server at http://hostnameofserver:9000

Making pro work…
Make sure it doesn’t redirect to etherpad.com for pro

Edit /usr/local/etherpad/trunk/etherpad/src/main.js

Replace all instances of Etherpad.com with yourdomain.com

Edit /usr/local/etherpad/trunk/etherpad/src/static/crossdomain.xml

Add to the obvious section
```
<allow-access-from domain="yourdomain.com" to-ports="*"/>

<allow-access-from domain="*.yourdomain.com" to-ports="*"/>
```
Edit /usr/local/etherpad/trunk/etherpad/src/etherpad/pro/pro_utils.js

Replace
```
var fromDomain = 'etherpad.com';
```
with
```
var fromDomain = 'yourdomain.com';
```
Note: Originally published on the 19th of Dec 2009, Revised on the 10th of March 2010
Installing Etherpad on Windows (CYGWIN)

Date: 2010.02.18 | Category: etherpad, guide, howto | Response: 21

The new documentation for how to deploy Etherpad Lite on Windows is available here — You should refer to this.

BELOW IS THE OLD DOCUMENTATION FOR ETHERPAD FULL

Grab the latest Etherpad .zip from http://etherpad.org and extract to c:\etherpad

Download and install Cygwin from http://www.cygwin.com/ – use defaults

Download Scala from http://www.scala-lang.org/sites/default/files/linuxsoft_archives/downloads/distrib/files/scala-2.7.7.final.zip and extract to c:\etherpad\scala-2.7.7

Download and install MySQL server from http://dev.mysql.com/downloads/mysql/
Create a MySQL database “etherpad” and a database user “etherpad”

Download the MySQL connector from http://dev.mysql.com/downloads/mirror.php?id=402367 and extract to c:\etherpad\mysql-connector-java-5.1.16

Download Java from http://www.oracle.com/technetwork/java/javase/downloads/jdk-6u25-download-346242.html and extract to c:\etherpad\JDK1.6_23

Open Cygwin (doubleclick on icon)

Change directory to Etherpad:
```
cd /cygdrive/c/Etherpad/
```
Copy the Libraries from one folder to another (temp fix):
```
cp /cygdrive/c/Etherpad/infrastructure/lib/* /cygdrive/c/Etherpad/infrastructure/ace/lib
```
Begin your build (if this errors check your task manager and check there are no java instances running that may cause a conflict):
```
bin/build.sh
```
Copy the default config to the correct location:
```
cp etherpad/etc/etherpad.localdev-default.properties etherpad/etc/etherpad.local.properties
```
Edit etherpad/etc/etherpad.local.properties and set
etherpad.SQL_JDBC_URL = jdbc:mysql://localhost:3306/etherpad
etherpad.SQL_PASSWORD = yoursqlpassword
etherpad.SQL_USERNAME = etherpad
etherpad.adminPass = somestrongpassword
topdomains = yourhostname.com,localhost

You can now run etherpad via:
```
bin/run.sh
```
Access your Etherpad server at:

http://localhost:9000/

BELOW IS THE OLD DOCUMENTATION THAT I AM LEAVING FOR THE SAKE OF HISTORY AND FOR REFERENCE. DAVE. WE CAME A LONG WAY DAVE.. IT’S BEEN EMOTIONAL :~

Below is my documentation that is sketchy, you should follow this guide instead.

In Windows:
- Install Java, Scala, MySQL, mysqlconnector and Mercurial under Windows.
- JAVA should be set to the java executable.
- JAVA_HOME should be set to the main jdk directory.
- SCALA should be set to the scala executable.
- SCALA_HOME should be set to the main scala distribution directory.
- PATH should contain $JAVA, $SCALA, and mysql
- MYSQL_CONNECTOR_JAR should be set to the mysql-connector JAR file included in the mysql-connector download.

- Install Cygwin.

These Files are needed in /etherpad/trunk/ since the archive holds files both in the etherpad and the infrastructure subfolder.
1. Make a backup of your bin folder
2. Extract the contents of the above .Rar file to the bin folder
3. Run bin/rebuildjar.sh
4. After installation run bin/run-local.sh
Full docs coming later. Post questions as comments and I should be able to answer.

All props goto Jutsi for discovering the solution. Feeling confident without the full docs? Follow the unix docs for config settings and you should be good to go.

See also:
Etherpad-win repository all props to Gyokuro: http://bitbucket.org/gyokuro/etherpad-win/overview/
Etherpad-win wiki all props to Gyokuro: http://bitbucket.org/gyokuro/etherpad-win/wiki/)
Installing the NRPE client, daemon and nagios plugins on debian

Date: 2010.01.18 | Category: guide, install, nagios, nrpe, open source | Response: 0

We assuming have already configured nrpe on your nagios box and you are sudo’d/root

Steps:

adduser nagios (set the password)
cd /home/nagios
wget http://prdownloads.sourceforge.net/sourceforge/nagios/nrpe-2.12.tar.gz
* If this step fails visit http://www.nagios.org/download/addons for the latest URL

tar -zxvf nrpe-2.8.tar.gz
cd nrpe-2.12
apt-get install gcc gawk openssl
apt-get install make
apt-get install libssl-dev
apt-get install nagios-plugins
./configure
make all
make install-plugin
make install-daemon
make install-daemon-config
echo “only_from = 0.0.0.1″ >> /usr/local/nagios/etc/nrpe.cfg
* Remember to replace 0.0.0.1 with your the IP address of your nagios server

cp init-script.debian /etc/init.d/nrpe
chmod 700 /etc/init.d/nrpe
/etc/init.d/nrpe start

You may want to make this script run on start up
update-rc.d nrpe defaults
Configure Etherpad Pro AFTER installation

Date: 2009.12.21 | Category: etherpad, guide, howto | Response: 5

So you have Etherpad installed and working? Now you want to allow users to have sub-domains and their own accounts? Maybe you want the privacy settings, I don’t know…

First off: Got your * dns wildcard in place? You are going to need it.

Then: Set up your smtp server

Finally: Remove the need for SSL

Oh yeah then: Fix the sign in link

Install Etherpad Lite on Ubuntu and Debian

UPDATE: These docs are now out of date, you should use the official install documents provided by the Etherpad Foundation.

Installing Etherpad on Debian

Installing Etherpad on Windows (CYGWIN)

Installing the NRPE client, daemon and nagios plugins on debian

Configure Etherpad Pro AFTER installation

Recent Videos

Recent Posts