[[TOC(WikiStart,releaseNotes,windows,depth=2)]] 

= Running GiBUU on a Windows System =

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

== 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. 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 [wiki:svn].
 6. Go to the directory "workingCode" (or "release1.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.



== Alternative checkout via TortoiseSVN / Putty ==

[http://tortoisesvn.tigris.org/ 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 [http://tortoisesvn.net/ssh_howto.html 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.