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 icon smile Installing Etherpad on Debian

    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