Eurekastreams Ubuntu 10.04 LTS Installation Guide

So you’ve heard about Eureka Streams, the open source social networking platform from Lockheed Martin @ http://www.eurekastreams.org and you’d like to check it out. Here’s how.

  1. Start with a virtual machine (http://www.virtualbox.org/wiki/Downloads to download VirtualBox);
  2. Download the Ubuntu 10.04 LTS ISO (http://www.ubuntu.com/desktop/get-ubuntu/download) and set it up according the defaults. I did give it 100GB of disk space, expanding dynamically;
  3. At the command line type ‘sudo apt-get install nano‘ to install a command line text editor;
  4. At the command line type ‘sudo nano /etc/apt/sources.list‘ and paste in the text from http://kenning.co.nz/wp-content/uploads/2010/08/apt-get-sources.txt which will make sure you can pick packages from the universe repositories;
  5. At the command line type ‘sudo apt-get update‘;
  6. At the command line type ‘sudo apt-get upgrade‘;
  7. At the command line type ‘sudo apt-get install memcached‘;
  8. At the command line type ‘sudo apt-get install default-jdk‘;
  9. At the command line type ‘sudo apt-get install git-core‘;
  10. At the command line type ‘sudo apt-get install postgresql‘;
  11. At the command line type ‘sudo apt-get install maven2‘;
  12. Edit /etc/environment and add ‘JAVA_HOME=/usr/lib/jvm/default-java‘;
  13. Log out and log back in;
  14. At the command line type ‘echo $JAVA_HOME‘ and make sure the above
    location is returned;
  15. At the command line type ‘git clone https://git@github.com/lmco/eurekastreams.git‘;
  16. At the command line, change to the eurekastreams folder created;
  17. At the command line type ‘mvn install:install-file -Dfile=lib/shindig-common-3.3.jar -DgroupId=org.apache.shindig -DartifactId=shindig-common -Dversion=3.3 -Dpackaging=jar -DgeneratePom=true‘;
  18. At the command line type ‘mvn install:install-file -Dfile=lib/shindig-features-3.3.jar -DgroupId=org.apache.shindig -DartifactId=shindig-features -Dversion=3.3 -Dpackaging=jar -DgeneratePom=true‘;
  19. At the command line type ‘mvn install:install-file -Dfile=lib/shindig-gadgets-3.3.jar -DgroupId=org.apache.shindig -DartifactId=shindig-gadgets -Dversion=3.3 -Dpackaging=jar -DgeneratePom=true‘;
  20. At the command line type ‘mvn install:install-file -Dfile=lib/shindig-server-3.3.war -DgroupId=org.apache.shindig -DartifactId=shindig-server -Dversion=3.3 -Dpackaging=war -DgeneratePom=true‘;
  21. At the command line type ‘mvn install:install-file -Dfile=lib/shindig-social-api-3.3.jar -DgroupId=org.apache.shindig -DartifactId=shindig-social-api -Dversion=3.3 -Dpackaging=jar -DgeneratePom=true‘;
  22. At the command line type ‘mvn install:install-file -Dfile=lib/shindig-common-3.3-tests.jar -DgroupId=org.apache.shindig -DartifactId=shindig-common -Dversion=3.3 -Dpackaging=test-jar -DgeneratePom=true‘;
  23. At the command line type ‘mvn install:install-file -Dfile=lib/gwt-dnd-2.6.5.2.jar -DgroupId=com.google.code.gwt-dnd -DartifactId=gwt-dnd -Dversion=2.6.5.2 -Dpackaging=jar -DgeneratePom=true‘;
  24. At the command line type ‘mvn install:install-file -Dfile=lib/carousel-0.6.1.jar -DgroupId=com.gwtyuicarousel -DartifactId=carousel -Dversion=0.6.1 -Dpackaging=jar -DgeneratePom=true‘;
  25. At the command line type ‘mvn install:install-file -Dfile=lib/urlrewrite-3.2.0-beta.jar -DgroupId=org.tuckey -DartifactId=urlrewrite -Dversion=3.2.0-beta -Dpackaging=jar -DgeneratePom=true‘;
  26. At the command line type ‘mvn install‘;
  27. At the command line type ‘mvn clean install -Dopenaccess-security -Dbuild.web.baseurl=http://localhost:8080 -Dbuild.web.grbaseurl=http://localhost:8081‘;
  28. Change to the ‘web/target/classes/db/scripts‘ folder;
  29. At the command line type ‘sudo -u postgres psql postgres‘;
  30. At the PSQL command line type ‘\password postgres‘ and pick a password for the postgres account;
  31. At the command line type ‘sudo -u postgres createdb eurekastreams‘ to create a eurekastreams DB;
  32. At the command line type ‘sudo pico dev_reset_db.sh‘ and search for ‘scripts$‘ and then remove the trailing dollar sign;
  33. At the command line type ‘sudo pico dev_apply_updates.sh‘ and search for ‘scripts$‘ and then remove the trailing dollar sign;
  34. At the command line type ‘sudo nano /root/eurekastreams/web/target/classes/db/schema/eurekastreams_1_databasecreate.sql‘ (or where ever you installed eurekastreams) and search for the word ‘template1’ and replace with ‘template0’. This will stop the database creation step failing because of encoding differences;
  35. At the command line type ‘sudo -u postgres createuser –superuser $USER‘ to create a postgresql account as the user you’re using because you’ll need to be a postgresql super user to be able to run the dev_reset_db.sh script – note there’s two dashes before superuser;
  36. At the command line type ‘sudo -u postgres psql‘;
  37. At the PSQL command line type ‘\password $USER‘ where $USER is the user you’ve logged in as and give your postgresql user a password;
  38. At the command line type ‘./dev_reset_db.sh eurekastreams eurekastreams localhost‘, make sure you have a eurekastreams DB but no eurekastreams SQL account;
  39. The command will execute. It will drop the existing eurekastreams DB, and then create a eurekastreams SQL account. It may then ask you for a password for the eurekastreams account;
  40. If it does, at the command line type ‘sudo apt-get install pgadmin3‘;
  41. At the command line type ‘pgadmin3‘;
  42. In PGAdmin, log in as the ‘postgresql’ account with the password you entered at step 30;
  43. Right click on the eurekastreams user, and reset the password to something you know;
  44. Then go back to the dev_reset_db script and enter the password you’ve created for the script. The script won’t accept a blank password;
  45. The script should then populate the eurekastreams DB;
  46. At the command line type ‘sudo pico /etc/postgresql/8.4/main/pg_hba.conf‘;
  47. Change the ‘local all all ident‘ line to ‘local all all trust‘ line and save the file;
  48. At the command line type ‘sudo /etc/init.d/postgresql-8.4 restart‘ to restart the SQL server;
  49. Change back to the eurekastreams/web folder;
  50. At the command line type ‘mvn jetty:run -DskipTests -Dlog.home=$HOME/logs -Denv.WEBPORT=8080 -Denv.GRWEBPORT=8081‘ and wait for the Jetty server to start;
  51. Head to http://localhost:8080 and type the username ‘sysadmin’ and a blank password.

It should now log you in!

One thought on “Eurekastreams Ubuntu 10.04 LTS Installation Guide

Leave a Reply

Your email address will not be published.