Mai 2010

Table of Contents
1. Fast Start
2. More Targets
3. Important ctrl commands
3. Important graph commands
4. Debian and Fedora Customization
5. Sound transfert to host




1. Fast Start


                tar xvf cloonix-x.y.tar.gz
                cd cloonix-x.y


  Launch the switch daemon and the graphical frontend:

              ./start_clownix_net 
              ./graph 


  Run a demo:
  Right click on canvas, choose menu load topo, choose a file topology,
  for example virtual_platform_configs/ospf_demo_opewrt_kvm/topology
  the demo should begin.

  To see the boot console of the machines: do "screen -r"
  The "screen" software is used to store all the consoles for the 
  started machines in a single terminal. 
  To switch from machine to machine in screen term, do 

              Crtl-A "


  You can get into a machine by double-click on it in the graph 
  canvas or with ./ssh:

             ./ssh root@name_of_machine

  You can copy files or directories with ./scp:

             ./scp file_name root@Clown01:/root

  Note that ./ssh and ./scp are results of the compilation of a patched openssh.
  The real scp and ssh cannot get into the cloonix network because it is isolated 
  from the ip stack.



2. More Targets

  Basic default target UML and KVM OpenWrt machine are shipped 
  with the cloonix-x.y because they are lightweight.

  For heavier machines downloadable at cloonix.net:


              mv linux.tar.gz           cloonix-x.y/bulk
              mv ubuntu_uml.tar.gz      cloonix-x.y/bulk
              mv debian_uml.tar.gz      cloonix-x.y/bulk

              mv ubuntu_kvm.tar.gz      cloonix-x.y/bulk

              cd cloonix-x.y/bulk

              tar xvf linux.tar.gz
              tar xvf ubuntu_uml.tar.gz
              tar xvf debian_uml.tar.gz


  To have the desktop for the KVM machines, rigth-click on the machine
  on the graph canvas and choose qemu-gtk desktop use Ctrl-Alt to get
  in/out of the desktop.



3. Important ctrl commands
  When the daemon is started, a client named "ctrl" can be used to send commands.

  To dump the links between machines, the topology:

              ./ctrl -t


  To clean all machines and kill the switch daemon:

              ./ctrl -k





3. Important graph commands
  To make the topology with graph:
    Click on the vm with the right mouse button to select the machine.
    Then drag-drop a lan
    Then drag-drop 2 machines
    Then double-click on the lan
    Then click on an interface of a machine,
    Do it again for the second machine,
    Double-click on each machine, ifconfig them and ping.

  To make a graphical tracepath:
    Right-click on the canvas, pick Refresh ip info
    Right-click on a machine, choose Tracepath and go to the ip number of the other machine.




4. Machine Customization
  You can remake your machines or customize them
  based on mount, chroot, losetup, yum or apt-get, 
  see in the README of the "cloonix-x.y/sources/how_to_create_vm" directory. 


5. Sound transfert to host
  Required: pulseaudio on your host.

  Be root on you host, in file "/etc/pulse/default.pa"
  insert the following line:

load-module module-native-protocol-unix socket=/tmp/cloonix_pulse_sock

  restart pulseaudio by a reboot or by any other means

  To test the sound:

            ssh -Y root@10.1.0.1
            arecord | aplay

  You should hear yourself.