Archive for the ‘guide’ Category

• Installing Etherpad on Debian

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

  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://etherpad.org/apt 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

  ---

  [Translate]

• Installing Etherpad on Windows (CYGWIN)

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

  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/)

  ---

  [Translate]

• 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

  ---

  [Translate]

• 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

  ---

  [Translate]