Quick Start

To replicate a file, you need a setup with at least two OSDs. For testing, you can run two OSDs on the same machine, just make sure that they use differen ports (http_port and listen.port in osdconfig.properties).

1. create and mount a volume (see install & setup)
2. copy a file, e.g. a short movie for demonstration into the mounted XtreemFS volume
   
   > cp ~/movie.avi ~/xtreemfs/
3. set the file read-only
   
   > xtfs_repl --set_readonly ~/xtreemfs/movie.avi
4. check the replicas for the file
   
   > xtfs_repl -l ~/xtreemfs/movie.avi
   

   File is read-only.
   REPLICA 1:
            Striping Policy: STRIPING_POLICY_RAID0
            Stripe-Size: 128 KB
            Stripe-Width: 1 (OSDs)
            OSDs:
                    [Head-OSD] UUID: test-localhost-OSD, URL: /192.168.1.1:32640
   

5. check the list of OSDs that can be used to create a new replica of the file:
   
   > xtfs_repl -o ~/xtreemfs/movie.avi
   

   [1] UUID: test-localhost-OSD2, URL: /192.168.1.2:32640
   

   If the list is empty, please make sure that your setup is correct and that both OSDs are registered with the directory service.
6. add a new, full replica for the file
   
   > xtfs_repl --add_auto --full ~/xtreemfs/movie.avi
   
   A new replica is now created on the second OSD which automatically fetches the data from the original copy of the file.
7. You can now try the failover by e.g. watching the movie with a player (we tested it with mplayer). Use the OSDs status page to check which OSD is currently used and then kill it. The client will automatically switch to the second OSD.
   
   For more advanced setups please read the section about Replica Selection Policies in the user guide.

XtreemOS is an Integrated Project funded by the European Commission's IST program under contract #FP6-033576.© 2006-2009. Logo and box image © explonauten.net. legal/Datenschutz.