[[TOC(WikiStart,releaseNotes,windows,depth=2)]] 
= Running GiBUU on a Windows System =

== Step 1: Downloading the code ==

=== For normal users ===
 1. [wiki:GiBUUDownload#Gettingfullaccess  Get your  login account] or just [/login login].
 2. Download the [/browser/releases/ 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!

=== For GiBUU developers ===
   
 See [http://tortoisesvn.net/ssh_howto TortoiseSVN SSH HowTo] or follow the explanation given below:

 1. Install [http://www.chiark.greenend.org.uk/~sgtatham/putty/ putty] on your system
       * At JLU Giessen you may also use the [http://www.uni-giessen.de/hrz/service/icd.html 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 [http://tortoisesvn.tigris.org/ tortoise] on your system
 6. Download GiBUU to your windows hard drive.  Details:
    1. Right click on your Desktop: After installing [http://tortoisesvn.tigris.org/ 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.


== Step 2: Compiling & Running GiBUU ==
=== Using Cygwin ===
 1. Download [http://www.cygwin.com/ cygwin] 
 2. Setup cygwin. In the package selection choose additionally:
    * devel/gcc4-fortran
    * devel/make
    * devel/subversion
    * utils/which
    * utils/bzip2
    * libs/libbz2-devel
    * perl/perl
 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 the directory "workingCode" (or "release1.x.x") and type
    {{{
    make
    }}}
 6. 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 [wiki:FAQ 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".[[BR]]

'''Advantage:''' Much faster compilation and better performance than Cygwin.