Running GiBUU on a Windows System

Currently the recommended way of using GiBUU on a Windows system is via Cygwin.

Cygwin

1. Download ​cygwin
2. Install cygwin. In the package selection, make sure the following packages are being installed:
   • devel/gcc-fortran
   • devel/make
   • devel/subversion
   • base/which
   • archive/libbz2-devel
   • perl/perl
   • net/openssh
3. After the installation finished, start cygwin.
4. Create a directory for GiBUU, e.g.:

    cd /cygdrive/c
    mkdir GiBUU
    cd GiBUU
   

5. Checkout out the GiBUU code using svn, as explained in svn.
6. Go to the directory "workingCode" (or "release1.x") and type

   make
   

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

   ./GiBUU.x < jobCardName
   

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

Alternative checkout via TortoiseSVN / Putty

​TortoiseSVN is a nice GUI tool that integrates with the Windows Explorer. It can also be used to checkout the GiBUU code. However, this is currently not recommended, since it can potentially lead to file-permission problems in Cygwin.

For GiBUU developers

You can do the following to check out the code via svn+ssh with Cygwin (using ssh keys to avoid typing passwords all the time).

See ​TortoiseSVN SSH HowTo or follow the explanation given below:

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. Make sure "Pageant" is running and your ssh-key is loaded.
4. Open "putty" and go to "Session"
   • Enter
     • Host Name = yourUserName@svn.hepforge.org
     • Port = 22
     • Connection type = ssh
   • Now save the session as "putty_hepforge" (Putty->Session->Save Session)
   • Click on putty_hepforge and check whether a putty window opens which connects you directly to the Hepforge server. You should not be asked for your password! If you are still asked for it, please verify step 3! If putty can't connect, please verify hostname and port!
5. Install ​tortoise on your system
6. 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://putty_hepforge/hepforge/svn/gibuu
      

      to download the code.
   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.