Grant installation and quick start guide

1  Install binaries

2  Setup a 'safe' environnement

Since there is not yet any security controle while running tasks, any tasklets can do anything to the node it is running on : read, write or send files on the net, add or remove neighbours nodes, stop the node itself... To prevent from serious dammages, it is recommanded to run grant node inside a "safe" environnement.

Always run grant as user without any privilege : grant only needs to write file in current directory and user home dir (this should be same, depending on the way grant is invoked) to maintain its configuration up to date, download tasklets to run and store tasklets outputs. All other locations should be read only for grant user.

To prevent tasklet to see systems or other users public files, one of the following setup is needed :

3  Starting grant node

Just run grant with "start" argument :

> start

This will start grant node service using default parameters. Standard output should print logs and a web server is started. To control node activity, browse http://localhost/, your browser should present you a XML content showing your node's status information.

If grant start fail, you are probably not allowed to open server socket on TCP port 80. May be a web server is already running and listening this port, or if you are using an unix system, you can't open port under 1024 as standard user. Try to use an alternet port to run grant :

> start -port 8080

Then, node status information will be available from URL http://localhost:8080/

Once your node is started, you have to add neighbours to it (automatic neighbourg list fill is planned). Use the add commande :

> grant add -node xmlrpc+http://localhost:8080 -rnode xmlrpc+

For now you have to find yourself nodes URL. You may find some by digging your known nodes status information, if none, start from the grant's site one : take your browser to

4  Submit job

Use the "submit" command of grant. The required argument is the tasklet to run specs. The tasklet spec is the URL from where taslet jar file can be downloaded followed by the main tasklet classname. Then add tasklet proper args if required.

> submit

This will submit tasklet execution query to the grant node runnin on localhost using defaults parameters. Depending on your installation, following switches may be required :

5  Shutting down a node.

Stop your node with the following command when it is listening to port 8080 :

> stop -node xmlrpc+http://localhost:8080

By reading this you may think that you can stop any node just by knowing its URL. You are right ! This will change as soon as possible and this is another reason why grant is not secured enough to enter an operationnal stage.