Seattle, August 8 - 28, 2007
Please find below some instructions on the software to preinstall for the summer school. In this first email, I'd like to set up software so that you can subsequently compile the QDP++ library. This requires a basic set of software modules that you should be able to install in a straightforward manner for most linux and mac setups. On linux, most of this software should be available as RPMs or Debian packages, that can be set up with yum (RPMs) or with synaptic/apt-get on linux machines. I am afraid I haven't a Mac at hand, however, I do have installation instructions for Cygwin. I attach the steps I took to install Cygwin on my home PC along with the modules. Where I can, I will also point you to the sources in case you need to install using the "configure ; make; make" install chain.
I will send out instructions as to how to install QDP++ itself in the next email.
OK here goes. Please respond to firstname.lastname@example.org if you have difficulties.
First I give a list of the needed modules. If you are running MS XP you can skip directly to the section on Cygwin below, since these modules can be selected as part of the Cygwin installation.
List of modules and their source locations - but bear in mind that there may be pre built versions of these you don't need to compile - see the later sections.
GNU m4-1.4.1 (from http://ftp.gnu.org/gnu/m4 )
GNU gcc/g++ v3.4.6 (from http://gcc.gnu.org - you will need to go to a
mirror site eg
Libxml2 & Its development libraries
cvs (eg: from http://ftp.gnu.org/non-gnu/cvs )
A command line SSH client (open SSH?) - most of you should have this already. If not get it from http://directory.fsf.org/OpenSSH.html
For RHMC work it would be useful to have the GNU Multiple Precision (gmp) libraries. You can get them from www.swox.com
wget - a command line utility for downloading files via http. You can get it from: http://directory.fsf.org/wget.html
Apart from this you need a good editor (emacs/vi) and a good shell (I prefer bash)
Useful also are
And for scripting: PERL, Python
And for plotting: Grace at http://plasma-gate.weizmann.ac.il/Grace
-----------Instructions for setting up Cygwin--------------------
Cygwin gives you a unix window under XP.
(NB This is being done under Windows XP. Your mileage may vary.)
Go to http://www.cygwin.com
Click on the main window that says "Install or update now! (using setup.exe) "
A dialog will come up entitled "Opening setup.exe. You have chosen to open setup.exe which is an Application from http://www.cygwin.com. Would you like to save this file?"
Click on "Save File"
This will download setup.exe. Your download manager will offer to let you "Open or Remove" this file. Click "Open"
My browser then asks me if I really want to open the file. I click "OK"
The Cygwin Setup window pops up (It says "Cygwin Net Release Setup Program". I click Next
Then a dialogue pops up offering me to
Install from Internet
Download without Installing
Install from Local Directory.
I select "Install from Internet ( downloaded files will be kept for future re-use". Then I click "Next"
In the next dialogue, I select "C:\cygwin" as the "Root directory". I select Install for "All Users (RECOMMENDED) and "Default Text File Type" as "Unix/binary (RECOMMENDED)". Then I click "Next"
The next dialogue asks me to select a "Local Package Directory". I type in "C:\Cygwin_Local". Then I click "Next"
On the next dialogue I am asked about my internet connection. I select "Direct Connection" and click "Next"
The next dialogue offers me a choice of mirror sites to download from. I select "http://mirror.mcs.anl.gov" as a site that is close to me and then click "Next"
After a brief download I get a window where I can select packages.
I open up the Devel tree
(Note that when you select, say, automake-1.9, some earlier versions, 1.5, 1.6,..., will automatically be selected too. This is correct.)
From the Editors Tree I select
From the Libs tree I select
From Math tree I select
From the Net tree I select
From the Perl tree I select perl (default)
From the Shells tree I select
From the System tree I select
From the Utils tree I select
From the Web tree I select
I do not select any X-Windows stuff
I click "Next"
At this point Cygwin downloads all my packages, and installs them. At the end of the installation, I get an option to create an icon on my desktop and to add an icon to the start menu. I select both and click "Finish"
Some Linux Notes
Here are the names of packages for Ubuntu (and presumably Debian) You can use the synaptic manager for this or apt-get
This is a bare minimum, also useful are perl, python, gnuplot, grace (for scripting/plotting)
- Fedora Core/Red Hat Enterprise/CentOS and likes (I am quoting from Fedora Core 6)
The RPM package names are (version numbers may vary) you may also find non RedHat exclusive RPMs at rpmfind.net for your own brand of linux.
Grace may not be so easy to find for Red Hat Derivatives.
Other distros may need to do their own digging. I am afraid I don't have access to opensuse/gentoo and others. However, the names will be similar. Important are the case of development libraries for libxml2 and gmp (or libgmp) ie: libgmp-devel or gmp-devel and libxml2-devel or xml2-devel since they contain libraries we need.
Mac users, Kostas tells me that it is easy to install these things on Macs. PowerPC based Macs can also use gcc-4.1.x rather than just plain gcc-3.4
OK. So this may look daunting but hopefully it is not going to turn out to be daunting. Most of these packages can be installed already when you install the machine. Typically I only need to install the Libxml2 and libgmp libraries on unix systems. Also GCC-3.4 is not critical. I will produce instructions tomorrow for QDP++ that will turn off flags, that would make gcc-4.x misbehave with our code.
With best wishes,