The OceanStore Project OceanStore HelloWorld HOWTO by Hakim Weatherspoon, Chiu Wah Kelvin So, and Jason Lee

Directions to run your Helloworld experiment:

Remember all files you create need to be in the helloworld directory.

• First thing, RTFM
  
  • Read the explanation of our run directory and run-experiment framework.
    
• Write the helloworld1.exp
• Write your own helloworld.exp that includes: 1. the federation, 2. the client, and 3. the server (Look at the example in tapestry_dynamic_regression.exp).
  • mortal = If all mortal nodes exit, experiment exits.
  • daemon = kill the node after all mortal machines have exited
  • name config_file tapestry_type exit_type
    (e.g. HelloWorldServer ${run_dir}/tapestry_client.cfg static daemon)
  • add glob stage_name (e.g. add HelloWorldClient HelloWorldClient3.stg)
• Stg files
  • look at DynamicTest.stg
    • inside of initargs scope, those are init parameter for each stage. The number can be accessed by the stage inside method init by config.getInt(/* name of parameter */).
      example: to access parameter oldobjs in the stage, use config.getInt(oldobjs).
• Run the experiment
  • To run experiment you just go into pond/run directory and execute the following command: ./run-experiment --bamboo helloworld.exp
    
    
• Your own Regression test
  • To write your own regression test, copy dd /regression/test-run.run-experiment.dynamic to the name test-run.run-experiment.helloworld1.
  • replace /tapestry_dynamic_regression.exp with /helloworld1.exp.
    
    
• Debug
  • To debug, you will need to look at the log files in the /tmp directory. The files will start with experiment-PID-...

1. Check for bad words in your log file. Argument is the PID.
2. Clear out your log files from /tmp.
3. Set your OSTORE_SERVERS environment variable. Useful for running experiments on the cluster:
   
   All you have to do is
   1) comment out 'hosts localhosts' and change to 'hosts ROC' in the exp file.
   2) place a unique number next to each node in the exp file
   3) setenv REMOTE_OSTORE_RUN_DIR oceanstore/pond/run (may have to use /home/eecs/$USER)
   4) setenv OSTORE_SERVERS set-of-machines (e.g. You can run the attached HowTo_set-ostore-servers from to -i.e. HowTo_set-ostore-servers 31 39)
   

Click here to go to HelloWorld Exercise step2