Tradespace Demos: Installation Instructions

Nirvana ships with an environment and set of sample clients, in various languages, for a simple demonstration application named Tradespace. The Tradespace environment and clients are not activated by default; if you wish to experiment with them, the instructions on this page will explain how to get them up and running.

IMPORTANT: These steps assume you are happy to configure your Nirvana Realm to provide access to the demonstration Tradespace environment on a new Nirvana Interface on port 8080. If you wish to change any default port numbers, for example, you should follow the more detailed instructions (see <Nirvana Installation Path>/demo/README.txt which explains in detail how to set up the Tradespace demonstration application).

Installing the Tradespace Demos using Default Settings

If you are indeed happy to use the default settings (which will create a Nirvana Interface on port 8080 of your server), the steps for various server operating systems are as follows:

  • Windows (DOS Command Prompt)

    Open up a Nirvana Java command prompt from the Nirvana Installation / Client menu. Then execute the following commands: 

    setupFX.bat
startAllFX.bat

  • Linux / Solaris / Mac OS X / Generic Unix

    Open a shell / terminal window, then execute the following commands: 

    cd <Nirvana Installation Path>/Client/<realm name>/
./Java\ Examples\ Command\ Prompt
./setupFX.sh
./startAllFX.sh

    Please note that unless you chose a different name when installing your realm, the default <realm name> is nirvana.

What Do These Steps Do?

Executing the above commands will:

  1. Create a Nirvana Interface on your Realm, listening on port 8080,

  2. Create a web file plugin to allow browsers to access the various Tradespace clients via this port,

  3. Create a number of channels in your realm:

    • /FXDemo/chat
    • /FXDemo/prices
    • /FXDemo/trades
    • /FXDemo/news

  4. Run a Java class which publishes dummy price data to the /FXDemo/prices channel,

  5. Run a Java class which subscribes to an RSS-style "news" channel on a my-Channels demonstration Nirvana Realm at showcase.my-channels.com, then publishes any received events to the local /FXDemo/news channel.

Running the Demo Tradespace Clients

To run the demo clients, visit the following URL in a web browser:

  • http://your_host_name:8080/

where your_host_name is the fully-qualified hostname of your machine where the Nirvana realm and demos are running.

If you opted to customise your installation by following the instructions in <Nirvana Installation Path>/demo/README.txt, and changed the port on which the Nirvana interface is running, please visit the following URL instead:

  • http://your_host_name:your_port/
where your_port is the port you changed.

The page you see in the browser contains links to all of the local Tradespace demos, including JavaScript, Flex, Silverlight and Java Webstart.