November 2009

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


  If the file /root/.ssh/id_rsa.pub is not present: 
  then do "ssh-keygen -t rsa" and hit return until it ends.
  This is for the use of ssh and scp without passwords.

  The daemon managing the swith must be owned by root and have the 
  capacity to carry its root power when launched by normal user, 
  the following must be done as root:

             chown root ./bin_clownix/uml_clownix_switch
             chmod 04755 ./bin_clownix/uml_clownix_switch


  Launch the software:

              ./start_clownix_net 
              ./graph 


  Run a demo:
  Right click on canvas, choose menu load topo, file 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 -Y root@ip_of_the_machine (10.1.0.1 for first machine in default config)

  For the demo given as example, you can launch wireshark in your host and
  spy on the tap1 interface, you will see your protocol in action.
  Wireshark is also in all the UML heavy machines (Fedora, Debian and Ubuntu).



2. More Targets

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

  For heavier Fedora, Debian or Ubuntu UML Machines:


               mv linux.tar.gz           cloonix-x.y/bulk
               mv xxxx_uml.tar.gz        cloonix-x.y/bulk

              cd cloonix-x.y/bulk
              tar xvf linux.tar.gz
              tar xvf xxxx_uml.tar.gz



  For massive Fedora, Debian or Ubuntu KVM Machines:


              mv xxxx_kvm.tar.gz  cloonix-x.y/bulk
              cd cloonix-x.y/bulk
              tar xvf xxxx_kvm.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 names and admin ip of machines:

              ./ctrl -n


  To dump the links between machines, the topology:

              ./ctrl -t


  To clean all machines:

              ./ctrl -d


  To clean all machines and kill the 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-tcp auth-anonymous=1

  restart pulseaudio by a reboot or by any other means

  do not forget "iptables -F" or find a more delicate way to
  authorize the virtual machine to connect to the host pulseaudio.

  To test the sound:

            ssh -Y root@10.1.0.1
            arecord | aplay

  You should hear yourself (not re-tested in last versions).