How to Add a New Server Component to Wonderland?

[s v]

Hi there,

I was wondering if there is any tutorials on how to add a new server
component to my owl.
For example, as of now I have Web Administration Server, Darkstar
Server, Voice Bridge and Shared Application Server. I want to be able
to add another server, eg. MyPersonalServer (running on the same
machine as all the other servers which is localhost in my case). Any
comments would be appreciated, as to how to setup and configure the
new server in owl.

Thanks.

[Josmas Flores]

What would you be running in that server? If I'm allowed to ask! :)

There's nothing stopping you from installing more applications in the
glassfish server (if it's a Java appl that you want to serve).

cheers,
Jos

[Jonathan Kaplan]

There is no documentation for creating new services, but there are a bunch of examples:

http://code.google.com/p/openwonderland-modules/source/browse/trunk/0.5/unstable/red5-server

http://code.google.com/p/openwonderland-modules/source/browse/trunk/0.5/unstable/cmu-module

The red5 example is probably the easiest to follow. If you look at the red5 modules after it is built, you will see a structure like this:

module.xml

requires.xml

runner/

runner/red5-dist.zip

weblib/

weblib/red5-server-weblib.jar

The entry point for the service is the "runner" class, which is located in red5-server-weblib.jar. This class basically specifies how the module will be deployed:

http://code.google.com/p/openwonderland-modules/source/browse/trunk/0.5/unstable/red5-server/src/classes/org/jdesktop/wonderland/modules/red5/weblib/Red5Runner.java

The important method is getDeployFiles(), which returns a set of zip files. In the red5 module, this includes the red5-dist.zip file from our module, and the wonderland-client-dist.zip which is supplied by Wonderland.

Once you have a module with these components installed, you can create an instance of your service using the name of the runner class. See the "Configuring" section of the Red5 module README for details:

http://code.google.com/p/openwonderland-modules/source/browse/trunk/0.5/unstable/red5-server/README

When your service is instantiated, the contents of all the zip files returned by getDeployFiles() will be unzipped into ~/.wonderland-server/0.5-dev/run/<service_name>/run. Your .zip file should include a run.xml file. This file will be executed by the Wonderland server with the properties specified on the edit page for that server.

[s v]

Thanks Jonathan, that worked like a charm. Just to make sure though, I
am supposed to deploy my server modules first using the Manage Modules
interface on the
Server Manager GUI before installing the new server component using
the Manage Server interface right? I did try it without deploying the
modules but it did not work, so
I deployed the modules and then installed the server component and
that worked just fine.

On Apr 26, 5:20 pm, Jonathan Kaplan <jonathan...@gmail.com> wrote:
> There is no documentation for creating new services, but there are a bunch
> of examples:
>

> http://code.google.com/p/openwonderland-modules/source/browse/trunk/0...http://code.google.com/p/openwonderland-modules/source/browse/trunk/0...

>
> The red5 example is probably the easiest to follow. If you look at the red5
> modules after it is built, you will see a structure like this:
>
> module.xml
> requires.xml
> runner/
> runner/red5-dist.zip
> weblib/
> weblib/red5-server-weblib.jar
>
> The entry point for the service is the "runner" class, which is located in
> red5-server-weblib.jar. This class basically specifies how the module will
> be deployed:
>

> http://code.google.com/p/openwonderland-modules/source/browse/trunk/0...

>
> The important method is getDeployFiles(), which returns a set of zip files.
> In the red5 module, this includes the red5-dist.zip file from our module,
> and the wonderland-client-dist.zip which is supplied by Wonderland.
>
> Once you have a module with these components installed, you can create an
> instance of your service using the name of the runner class. See the
> "Configuring" section of the Red5 module README for details:
>

> http://code.google.com/p/openwonderland-modules/source/browse/trunk/0...