The CLI can be run in either an interactive (shell) mode, or directly from the command line. The manpage for the CLI is as follows:
org.rioproject.tools.cli.CLI [commands] [options]
commands
list [type] [options]
List discovered services
type
monitor|cybernode Lists details for either service
options
cpu|codeserver Only one allowed, default is to list "all"
destroy [all]
Destroy a specific service (prompted), or all services
deploy opstring [-t=deploy-timeout] [-icuv]
Deploy an application
-i Turns off interactive prompting
-c Verifies codebase
-u Automatically update deployments
-v Verbose mode
-t Time in milliseconds to wait for deployment status
undeploy opstring
Undeploy an application
redeploy opstring [clean] [delay=millis-to-delay]
Redeploy an application
options
groups=group1,group2 Comma separated names of multicast groups to
discover. If "all" is provided, this will be
translated to DiscoveryGroupManagment.ALL_GROUPS
locators=jini://host[:port] Comma separated names of lookup locators to
discover
discoveryTimeout=millis Discovery timeout (in milliseconds)
httpPort=port Port to use when starting Webster
-noHttp Do not start Webster, mutually exclusive
with the httpPort option
If the CLI is invoked without any command options (list, destroy, deploy, redeploy, undeploy), the user is presented with the following 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>
Shell Specific Commands
Directory based commands
| pwd | Path of working directory |
| cd | Change directory. the "~" character can be used, this will change back to the CLI's home directory |
| ls | Directory listing of the current working directory |
| dir | Synonomous with the ls command |
Environment
| set | Property settings, view and/or modify properties the CLI uses |
| stats | System statistics. Details are shown for the current user, time logged in, whether a Webster instance has been started, and if so details on the Webster instance (port, roots, address bound to), discovered and discarded lookup services, and any pending service information retrieval requests |
Utility
| jconsole | For all services which have both net.jini.lookup.entry.jmx.JMXProtocolType and net.jini.lookup.entry.jmx.JMXProperty as attributes a list will be created allowing a jcosole to be launched binding to the selected JVM |
| http | Start and stop Webster instances. |
| !! | Run the previous command again |
If you are running the CLI on OSX (or other unixes) and ant to use your up & down arrows for command line retrieval, use rlwrap. Instead of running "rio", run instead "rlwrap rio". Or create an alias in your .bash_profile (or appropriate login shell settings file) |
