TurnKey Linux Virtual Appliance Library

Notes on installing Wave Federation Server on clean install of Turnkey base

Stephen Weber's picture

Today I set up a Wave Federation server in a VirtualBox instance of Turnkey base. I followed two sets of instructions which were spot-on except for two times that I got lost and confused.

First, after setting up a new VirtualBox machine using Turnkey Base, 2GB virtual hard-disk, and 384MB RAM, I followed this forum post to set up OpenFire: www.turnkeylinux.org/forum/general/20090814/openfire-virtual-appliance

The only change to that process is that you need to install sun-java6-jdk, not sun-java6-bin. This is because in the next step we download the Wave Federation prototype server and build it. You also need to install ant (apt-get install ant).

The instructions to install the prototype server can be found here: code.google.com/p/wave-protocol/wiki/Installation. Again, the documentation is accurate, but perhaps confusing. I'm not sure what good names for test servers are, but my choice of "core.com" functioned adequately.

A summarized list of the steps involved:

  1. install Turnkey Base appliance
  2. change script provided by jonesmz to install sun-java6-jdk
  3. run script to update Ubuntu, Turnkey, and install OpenFire
  4. run 'apt-get install ant'
  5. perform OpenFire basic setup (admin account)
  6. configure OpenFire to support Wave as an extension
  7. download the current server code
  8. build the code
  9. edit the run-config.sh file
  10. start the server
  11. in another terminal window, run a client to connect to the server

Worked really well for me, the next step would be figuring out how to connect a local command-line client to the server inside VirtualBox.

Hope this helps get a Wave Federation appliance up and available!

Liraz Siri's picture

Extremely helpful

Thanks Stephen, this is good stuff. I talked to Alon a few days ago about including a Wave federation server in our next batch of releases, and this kind of information makes it easier for us to get started. Excellent.
Stephen Weber's picture

NP

Glad you liked it and that I'm not the only one getting excited about WF servers and helping get this technology off the ground. I wasn't sure what the next step for Turnkey would be, so I just stopped there. If anyone needs more info from my install, feel free to ask!

RE:Running the run-client-console.sh script in Windows XP

Stephen,

I am running an Openfire message server on my XP system.

 

I downloaded all the Google Wave Federation programs and did the ant build successfully.

I am trying to run the "run-client-console.sh command in a DOS Command window. I change the directroy to the wave-protocol directory then try to run the shell however my system seem to not recognize the command $:./run-client-console.sh   Do I need to find a comprable .bat file instead of attempting to run a .sh command??

An y help you can give me would be appreciated. Thanks, Norm

 

 

Stephen Weber's picture

Windows conversion

Since this site is focused on Ubuntu in particular and open-source in general, I hadn't considered being able to run this on Windows. Here's my best guess, and suggest you blog your success and become The One Who Knows in as wide a circle as possible :)

The main bit inside the run-client-console.sh file is the following lines:

./run-config.sh
java -jar dist/fedone-client-console-$FEDONE_VERSION.jar $USER_NAME $WAVE_SERVER_HOSTNAME $WAVE_SERVER_PORT



run-config.sh sets all those capitalized-name variables. If you want to cross-read the files to figure out what exact incantation you need at the command line, you can write your own batch file to run it for you. On Google's page discussing the ConsoleClient, I found this example batch as part of a comment (search for 'batch'):

set WAVE_SERVER_DOMAIN_NAME=wavewriter.org
set WAVE_SERVER_HOSTNAME=wave.wavewriter.org
set WAVE_SERVER_PORT=5275
set USERNAME=adpro@%WAVE_SERVER_DOMAIN_NAME%

java -jar dist/fedone-client-console-0.2.jar %USERNAME% %WAVE_SERVER_HOSTNAME% %WAVE_SERVER_PORT% 

Hope that helps!

Jeremy's picture

.sh bash scripts will not run natively on Windows!

To the best of my knowledge bash scripts will not run natively on Windows. Without reading all about what the wave server entails I would assume that the script is only meant to be run within a Linux client!? Sorry not much help I know.

Alon Swartz's picture

Customization Mechanism (TKLPatch)

We have just released TKLPatch. If someone could create a patch for the above it would dramatically push this appliance forward.
Alon Swartz's picture

New TKLPatch section on development wiki

I have created a new section in the development wiki for TKLPatches, and have added this patch to the list. Feel free to update the patch page as you see fit.

I have two videos up on

I have two videos up on youtube. you should see the if you search google wave federation on youtube.

Liraz Siri's picture

Specific links

To the youtube videos you are referring to would help.

Post new comment

The content of this field is kept private and will not be shown publicly. If you have a Gravatar account, used to display your avatar.
  • Web page addresses and e-mail addresses turn into links automatically.
  • Allowed HTML tags: <a> <p> <span> <div> <h1> <h2> <h3> <h4> <h5> <h6> <img> <map> <area> <hr> <br> <br /> <ul> <ol> <li> <dl> <dt> <dd> <table> <tr> <td> <em> <b> <u> <i> <strong> <font> <del> <ins> <sub> <sup> <quote> <blockquote> <pre> <address> <code> <cite> <strike> <caption>

More information about formatting options

Leave this field empty. It's part of a security mechanism.
(Dear spammers: moderators are notified of all new posts. Spam is deleted immediately)