Running GiBUU on a Windows System

Step 1: Downloading the code

For GiBUU developers

1. Install ​putty on your system
   • At JLU Giessen you may also use the ​automatic network installation: Choose "Weitere Software" and then "putty".
2. Set up a ssh-key pair to be used with putty.
   • Go via putty, e.g., to tp1 an run "ssh-keygen" by typing

     ssh-keygen -t dsa
     

     This generates a dsa-keyfile called "id_dsa.pub" in the directory "~/.ssh".
   • Now execute

     cat ~/.ssh.id_dsa.pub >> .ssh/authorized_keys
     

   • Open in your Windows "PuTTYgen"
   • Choose "conversions" and read in your freshly created private (not public!) dsa key, which is given by the file "~/.ssh/id_dsa". Save the key after conversion as a ".ppk"-file
   • Start putty's pageant (Start->Programme->Putty->Pageant)
   • Load the freshly created .ppk-file into pageant
     • Hint: Add the command "pageant 'path to your ppk.file'" as a link to your Windows-Autostart, such that pageant is started at system start.
3. Install ​tortoise on your system
4. Make sure "Pageant" is running and your ssh-key is loaded.
5. Download GiBUU to your windows hard drive. Details:
   1. Right click on your Desktop: After installing ​tortoise a menu item "SVN checkout" should be available.
   2. Left click on "SVN checkout".
   3. Enter in the field "URL of repository"

      svn+ssh://yourName@tp11.physik.uni-giessen.de/home/svn/buu/GiBUU/   
      

      to download the code. Replace "yourName" by your user name ;)
   4. Choose checkout directory, e.g.

      C:\GiBUU 
      

      • Please take care, that the full path where you store GiBUU does not include any blanks.
      • Especially "C:\Dokumente und Einstellungen\..." is no good, but "C:\GiBUU" is fine!
   5. Click on "ok", and then "yes" to create the checkout directory.

For normal users

1. Get your login account or just ​login.
2. Download the ​tar-ball to your system.
   • Please take care, that the path where you store the tar-ball does not include blanks.
   • Especially "C:\Dokumente und Einstellungen\..." is no good, but "C:\work\" is fine!

Step 2: Compiling & Running GiBUU

Using Cygwin

1. Download ​cygwin
2. Setup cygwin. In the package selection choose additionally:
   • devel/gcc4-fortran
   • devel/make
   • utils/which
   • utils/bzip2
3. After the installation finished, start cygwin.
4. Now go to the GiBUU directory
   • If you downloaded the tar ball, change to the download directory (e.g.

      cd /cygdrive/c/work 
     

     Now unpack the tar-ball

     tar xzf tarballName.tgz
     

   • If you used svn to get the code, then simply "cd" to the code directory, e.g.

     cd /cygdrive/c/GiBUU
     

5. Go to workingCode and type

   make renew
   

   and thereafter

   make bw FORT=gfortran-4
   

6. After make is done, you will find the executable "main.x" in the "testRun" directory, where you can run GiBUU with the command

   ./main.x < jobCardName
   

   Sample jobcards are available in testRun/jobCards, cf. also our FAQ page for more informations.

In a terminal

Download your code to a network share, which is also accessible by some linux client. Go via putty to your linux client and compile the code as explained in "Readme_Quickstart.txt".

Advantage: Much faster compilation and better performance than Cygwin.