Where to Start?

Rio is distributed under the Apache License, version 2.0.

Rio requires JDK 1.5.x or greater.

Although not required, setting the JAVA_HOME environment variable to point to the home of a Java 5 (or later) installation is always a good idea.

Rio is distributed with dependencies. Dependencies are additional software required for running Rio. Note that each of these libraries is subject to the respective license; check the respective project distribution/website before using any of them in your own environment.

The distribution includes the following third party technology: Apache River 2.1.1 (Jini), CGLIB 2.1_3, Hyperic SIGAR, Commons Compress 1.0, Groovy and the Prefuse Visualization Toolkit.

Hyperic SIGAR is licensed under the GPL with a FLOSS license exception, allowing it to be included with the Rio Apache License v2 distribution. If for some reason the GPL cannot be used with your distribution of Rio, remove the RIO_HOME/lib/hyperic directory.

To install Rio on Linux or OS/X, unzip the distribution package to the desired installation directory. For example, to install into /opt:

unzip rio-4.0.zip -d /opt

This creates a directory called rio-4.0 under /opt

To install Rio on Windows, unzip the distribution package to the desired installation directory. You should use a zip application such as 7zip, not the built-in folder decompression. Note that both Windows and Java 5 have some issues with long file names and file paths, as well as with spaces in directory names. We recommend installing into a directory of your chosen drive, and ensuring that directory names do not have spaces (like C:\Program Files).

Once you have unzipped the distribution, you will have a rio-4.0 directory containing the following items:

• bin - The directory that contains command to start Rio services
• config - Directory that contains configuration for Rio services and platform
• deploy - The default deploy directory used to serve deployed application resources.
• docs - The directory that contains API documentation, and other documentation
• examples - Contains examples of how to develop and deploy applications using Rio
• lib - The directory where the JAR files are located.
• lib-dl - The directory where the client (download) JAR files are located.
• logs - This directory contains log files for Rio
• policy - The directory that contains a policy file
• src - Source code for Rio

You can look at the examples provided, as well as checking put the following tutorials:

• Service tutorial
• Service exec tutorial

RIO_HOME/bin/rio create-project

Starting Rio

The RIO_HOME/bin directory contains starter script (and .cmd) files to start Services and Utilities provided by Rio.

Note, you should make sure that you set the RIO_HOME environment variable to point to the directory that you have installed the Rio distribution.

The rio script is the the command and control utility for starting Rio services and the Rio command line interface. All of the other scripts are wrappers around the rio script. The convention for starting services using the rio scripts is as follows:

• rio startservice-starter

For example:

• rio start cybernode
  Will use the config/start-cybernode.groovy file
• rio start all
  Will use the config/start-all.groovy file

The following scripts are shortcuts for starting the basic services in Rio:

• cybernode - Starts a Cybernode and a Webster on an anonymous port
• monitor - Starts a Provision Monitor, a transient Jini Lookup service and a Webster on port 9010
• webster - Starts a Webster on port 9010
• startall - Starts a Webster on port 9010, a Cybernode, Provision Monitor and a transient Jini Lookup Service

By just running rio, you will be put into the interactive command line shell:

Welcome to the Rio Interactive Shell Program. You can interact
with the Rio using the following commands :

list     http     deploy   destroy  dir
help     pwd      jconsole redeploy set
undeploy cd       ls       stats

For help on any of these commands type help [command].
To leave this program type quit

rio> _