FLUPIX

FLUka in knopPIX

Vasilis.Vlachoudis@cern.ch
(c) 2008


www.fluka.org
www.fluka.org/flair

About

FLUPIX is Linux Live CD, with pre-installed FLUKA, flair and all the necessary tools in for performing fluka runs. In the packages.txt you will find a complete list of the packages currently included in the ISO image.

To save disk space, FLUPIX is only able to run through the VirtualBox machine (www.virtualbox.org) a free and open source Virtual machine supported by Sun.

Requirements

Installation

1. Download and Install from VirtualBox the appropriate binary for your platform.
2. Download flupix-XXX.iso and the auxiliary flupix-vdi.zip files, from the download section of the FLUKA web site
3. Start Virtualbox and create a virtual machine using the following settings in the wizard

   Name:	FLUPIX
   OS Type:	Linux 2.6
   Base Memory:	>1024 MB (not less than 1024 MB)
   Boot Hard Disk:	<no hard disk> (Click "continue" on the warning message)

4. Change the settings:

           CD/DVD-ROM
                   [x] Mount CD/DVD Drive
                   (o) ISO Image File
                       Click on the Folder Icon
                       Click on Add
                       Find the flupix-XXX.iso
                       Click Select
   
           Network
                   Adapter 0
                   [x] Enable Network Adapter
                   Adapter Type  PCnet-FASTIII or INTEL PRO 1000/MT are Ok
                   Attached to   NAT
   

   Optionally you could also change the following:

           Audio
                   [x] Enable Audio
                       Select the appropriate Host Audio Driver
                             Windows DirectSound
                          or
                             ALSA Audio Driver
                       Audio Controller: ICH AC97
   
           USB
                   This is kind of tricky (The following is valid for
                   Windows) for linux please give a look to the
                   VirtualBox manual for Linux Hosts
   
                   [x] Enable USB Controller
                   [x] Enable USB 2.0 Controller
                   Insert your USB stick
                   Click on the [add] icon to add a new filter
                   REMOVE your USB stick
   
                   Now to use your USB stick you will have to INSERT IT
                   only when you start the VirtualMachine. The reason is
                   that otherwise Windows will get the handle of it and
                   the VirtualMachine will not be able to access it.
   

5. Optionally you can create a disk for swapping and saving the data or use the pre-existing ones from the flupix-vdi.zip file. Locate the .VirtualBox installation directory. Let's assume that <user> is your user name. Unpack the content of flupix-vdi.zip in the following location based on your OS system

   XP:	C:\Documents And Settings\<user>\.VirtualBox\HardDisks
   Vista:	C:\Users\<user>\.VirtualBox\HardDisks
   Mac:	/Users/<user>/Library/VirtualBox/HardDisks
   Linux:	/home/<user>/.VirtualBox/HardDisks

   
   In the Hard Disks tab add the two disks:

               - Click on [+] Add icon
               - Click again on [+] Add icon on the
                 "Select a hard disk image file" dialog
               - Locate the flupix.vdi and click "Open"
   	

   Now the flupix.vdi will appear as a IDE Primary Master Do the same for the "swap.vdi" as a IDE Primary Slave

Running FLUPIX

FLUPIX & VirtualBox Tips

• The default key for entering/releasing the mouse from VirtualBox is the RIGHT-CTRL key. FLUPIX has the Guest additions of vbox which means that you can use the normal mouse from Windows as the mouse of FLUPIX
• To transfer data between host and guest system create a shared folder and mount it from linux. There is a small tool in /usr/local/bin/vboxmount to allow easy mount of a VBox shared folder inside FLUPIX. The steps are the following:
  1. Create Shared folder in VirtualBox For example named: vbox and pointing to
     C:\Documents And Settings\user
  2. From a FLUPIX terminal type
     cd
     vboxmount vbox windows
     The vboxmount will create a directory ${HOME}/windows and will link the "vbox" shared folder to this directory If no options are given it will create a folder named "vbox" and it will try to mount the Shared folder "vbox"
• To migrate from a previous version of FLUPIX, open a terminal and type the command:
  migrate.sh
  

Copyright and User License

Copyright Vasilis.Vlachoudis@cern.ch for the European Organization for Nuclear Research (CERN)

All rights not expressly granted under this license are reserved.

Installation, use, reproduction, display of the software ("flupix"), in source and binary forms, are permitted free of charge on a non-exclusive basis for internal scientific, non-commercial and non-weapon-related use by non-profit organizations only.

For commercial use of the software, please contact the main author Vasilis.Vlachoudis@cern.ch for further information.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

DISCLAIMER

THIS SOFTWARE IS PROVIDED BY THE AUTHOR "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, IMPLIED WARRANTIES OF MERCHANTABILITY, OF SATISFACTORY QUALITY, AND FITNESS FOR A PARTICULAR PURPOSE OR USE ARE DISCLAIMED. THE COPYRIGHT HOLDERS AND THE AUTHORS MAKE NO REPRESENTATION THAT THE SOFTWARE AND MODIFICATIONS THEREOF, WILL NOT INFRINGE ANY PATENT, COPYRIGHT, TRADE SECRET OR OTHER PROPRIETARY RIGHT.

LIMITATION OF LIABILITY

THE COPYRIGHT HOLDERS AND THE AUTHORS SHALL HAVE NO LIABILITY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, CONSEQUENTIAL, EXEMPLARY, OR PUNITIVE DAMAGES OF ANY CHARACTER INCLUDING, WITHOUT LIMITATION, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, LOSS OF USE, DATA OR PROFITS, OR BUSINESS INTERRUPTION, HOWEVER CAUSED AND ON ANY THEORY OF CONTRACT, WARRANTY, TORT (INCLUDING NEGLIGENCE), PRODUCT LIABILITY OR OTHERWISE, ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.