L2pNodeLauncher Commands

This is a list containing the most used commands in the L2pNodeLauncher class.

At Start-up

These arguments are all optional (except --port or -p) but have to be the first after the call of the class name:

java -cp "lib/*" i5.las2peer.tools.L2pNodeLauncher [--help] [--colored-shell] --port 9010 [--bootstrap vermeer.informatik.rwth-aachen.de:9085,steen.informatik.rwth-aachen.de:9085] [optional arguments] [interactive commands] [interactive]

Optional arguments

--help (-h) Prints a help message of the L2pNodeLauncher

--colored-shell|-c Enables coloured output, since this feature only works on Unix-like terminals and leads to cryptic output in Windows command shells, it's disabled by default.

--port|-p [port] Sets the port the LAS2peer node should listen to. Example: --port 9010

--bootstrap|-b [host-list] requires a comma seperated list of [address:ip] pairs of bootstrap nodes used connect multiple nodes to a network. If no bootstrap argument is provided, a new las2peer network is started. This argument can occur multiple times. Example: --bootstrap vermeer.informatik.rwth-aachen.de:9085,steen.informatik.rwth-aachen.de:9085

--log-directory|-l [directory] lets you choose the directory for log files (default: log/)

--service-directory|-s [directory] adds the directory you added your services to (default: ./service/) to the class loader. This argument can occur multiple times.

--observer|-o starts a monitoring observer at this node

--node-id-seed|-n [long] generates the node id by using this seed to provide persistence. Set this parameter to keep stored across node restarts. Example: --node-id-seed 123456789

--storage-mode|-m filesystem|memory set Pastry's storage mode. If no storage mode is specified, filesystem will be used.

interactive commands Accepts a list of space separated commands executed automatically after startup in the interactive shell (see below) of the L2pNodeLauncher.

interactive Leaves the L2pNodeLauncher in the interactive shell state after executing all given interactive commands.

Interactive commands

These commands can be either executed when starting the node (in the start script) or after the node has been started by hand:

uploadStartupDirectory(['path/to/startup/directory'])

uploads the contents of the startup directory (default: 'etc/startup') to the network storage of a LAS2peer network (note, that for agents you have to provide the passphrases in the file 'passphrases.txt' stored in the same directory)

registerUserAgent('anonymous','anonymous')

registers a user at this node (for details on how to generate additional user agents, consult the Agents-Users page in this wiki)

startWebConnector / startHttpConnector

starts one of the two predefined connectors

startConnector('connector.package.class')

starts an arbitrary connector given by its class name

startService('i5.las2peer.services.servicePackage.ServiceClass','SampleServicePass')

starts a service with a known agent

startService('i5.las2peer.services.servicePackage.ServiceClass')

starts a service and generates a new service agent for this service

invoke('i5.las2peer.services.servicePackage.ServiceClass','aMethod','parameter1-parameter2')

first argument is the service class, second the service method and third are parameters (use '-' as separator to pass multiple parameters in the last argument of this call)

unregisterCurrentAgent

unregisters the currently active agent (registered by the registerUserAgent method) to register another one to be used with this launcher

findService('i5.las2peer.services.servicePackage.ServiceClass')

looks for the service 'i5.las2peer.services.servicePackage.ServiceClass' in the LAS2peer network and determines whether it exists

findAgent('agent ID')

looks for the given agent with the given agent id in the LAS2peer network

exit / shutdown

closes the current node

getServiceMethods('i5.las2peer.services.servicePackage.ServiceClass')

returns all services methods' signatures of the specified service

interactive

should be executed as a login argument when starting the L2PNodeLauncher and enables the interactive console
(see additional tutorial L2pNodeLauncher - Interactive Command Line)

getLocalNodeInfo

returns some node information specified in the 'nodeInfo.xml' (located in the 'etc' folder)

getInfoOfKnownNodes

returns the node information about all known nodes