Install GCC

GCC stands for GNU Compiler Collection. The latest version is GCC 4.3. The use of this tutorial is to install GCC 4, which is not available in some linux distributions. In those systems GCC 3 is available instead but I suppose that for some reason you need GCC 4. (Of course we will use GCC 3, or any other available C compiler to build GCC 4.) The tutorial is focused in obtaining 'g++' (GNU C++) among all the available compilers in the collection. This tutorial is based on this other guide, although this version is much more straightforward.

You can check which version of GCC is currently installed by running

 $gcc -v
 ...
 gcc version 3.4.6 20060404 (Red Hat 3.4.6-3)

This tutorial is mainly oriented to install in a campus cluster. If you want a bleeding edge compiler in your Linux computer it is better to just use an up to date distribution instead of going through these instructions. For example Ubuntu 9.10 has as default compiler gcc 4.4, just by doing:

sudo apt-get install gcc

Preparation and Downloads

If you are not interested about the details and feel lucky you can donwload this script and run it in your computer.

The tutorial assumes that you want to install GCC/g++ in your userspace directories (i.e. in your home directory). To do that create the following directories:

mkdir ~/soft
mkdir ~/usr

GCC depends on several libraries and tools most of which are usually in the system already, except for GMP library, MPFR and MPC. Fortunately we don't need to install these three libraries explicitly. The GCC installation takes care of their compilation as long as the sources directories are put in the GCC source directory. The three directories should be named gmp, mpfr and mpc.

So, first download the GCC sources.

cd ~/soft
export GCC_VER=4.4.2
wget wget http://gcc-uk.internet.bs/releases/gcc-$GCC_VER/gcc-$GCC_VER.tar.gz
tar -jxvf gcc-$GCC_VER.tar.bz2
mv gcc-$GCC_VER gcc-source

And then download and uncompress GMP, MPFR and MPC

cd ~/soft

export GMP_VER=4.3.1
wget ftp://ftp.gmplib.org/pub/gmp-4.3.1/gmp-$GMP_VER.tar.gz
tar -zxvf gmp-$GMP_VER.tar.gz
mv gmp-$GMP_VER gcc-source/gmp

export MPFR_VER=2.4.2
wget http://www.mpfr.org/mpfr-current/mpfr-$MPFR_VER.tar.gz
tar -zxvf mpfr-$MPFR_VER.tar.gz
mv mpfr-$MPFR_VER gcc-source/mpfr

export MPC_VER=0.8.1
wget http://www.multiprecision.org/mpc/download/mpc-$MPC_VER.tar.gz
tar -zxvf mpc-$MPC_VER.tar.gz
mv mpc-$MPC_VER gcc-source/mpc

The source directory is ready to for compilation.

Compilation

This is important and different from other usual compilation procedures: GCC should be compiled in a directory different from the source directory, in this case we will create a "build" directory.

cd ~/soft
mkdir gcc-build
cd gcc-build

Then we will 'configure' from that directory. Everything will be installed in ~/usr, including the executable compilers in ~/usr/bin and the library files in ~/usr/lib. To specify that you do

cd ~/soft/gcc-build
../gcc-source/configure --prefix=$HOME/usr --enable-languages=c++,fortran --enable-shared

If you don't need the Fortran compiler specify --enable-languages=c++. (C compiler is enabled by default.) Even if you don't use Fortran it can be useful to compile Lapack for example.

Check that the configure works (if it doesn't, report it in this wiki) before doing:

make -j 2                   #takes ~60 minutes

and finally:

make install

To test the version installed:

$ ~/usr/bin/g++ -v
Using built-in specs.
Target: x86_64-unknown-linux-gnu
Configured with: ../gcc-4.3.3/configure --prefix=$HOME/usr --with-local-prefix=$HOME/usr/local --with-gmp=/home/correaa/usr --with-mpfr=/home/correaa/usr --enable-languages=c++
Thread model: posix
gcc version 4.3.3 (GCC)

and do

~/usr/bin/g++ --print-search-dirs

to see which libraries and directories will be used by default.

The installation also includes the C++ Standard Template Library.

Basic Usage

This is the "Hello, world!" program

 #include <iostream>
 int main(){
   std::cout << "Hello, world!\n";
 }

which can be compiled with our brand new compiler:

 cd /tmp
 wget http://micro.stanford.edu/mediawiki-1.11.0/images/Hello_world.cpp.tar -o hello_world.cpp.tar
 tar -xvf hello_word.cpp.tar
 ~/usr/bin/g++ -Wl,-rpath=$HOME/usr/lib:$HOME/usr/lib64 hello_world.cpp -o hello_world
 ./hello_world

Note that you have to specify the tilde (~) in order to run that specific compiler and not the default system one. The rpath option tells the compiler to use your local (home) version of the runtime and standard libraries instead of the default ones (in /usr/lib and /usr/lib64).

In any case you can check which libraries are being used by doing:

 ldd ./hello_world

Now you are powerful and can tell your friends that you compiled a compiler. Now seriously, you can build programs that you could not compile or compiled with bugs with the system compiler.

Libraries

By following this tutorial you should have the C and C++ compilers of the GNU Compiler Collection, with them you can use any decent C or C++ library available, for example the Standard Template Library (included with GCC), FFTW, BOOST and HDF5.

Install MPICH2

This is the procedure to compile and install the MPICH2 library and environment. The instructions are taken from the official documentation and from this wiki-page.

 mkdir ~/usr
 mkdir ~/soft
 cd ~/soft
 wget http://www.mcs.anl.gov/research/projects/mpich2/downloads/tarballs/1.0.8/mpich2-1.0.8.tar.gz 
 tar -zxvf mpich2-1.0.8.tar.gz

Like GCC, MPICH2 should be compiled in a different directory than the location of the sources (this is not the case for version 1.1.:

 mkdir mpich2-1.0.8-build
 cd mpich2-1.0.8-build
 ../mpich2-1.0.8/configure --prefix=$HOME/usr |& tee configure.log
 make |& tee make.log
 make install

The compilation takes ~20 minutes. (Do not try make -j 2 or make install only). The compiler wrappers (i.e. scripts to compile with MPI settings) are installed in ~/usr/bin, for example ~/usr/bin/mpicxx for the C++ MPI wrapper.

Now set up the environment, in your home directory create a configuration file. This need to be done only once.

 cd ~/
 touch .mpd.conf
 chmod 600 .mpd.conf
 echo 'MPD_SECRETWORD=nano' > .mpd.conf

Test example

Now you are ready to compile the example (based on this original example)

 cd ~/tmp
 wget http://micro.stanford.edu/mediawiki-1.11.0/images/Mpich2_example.tar -o mpich2_example.tar
 tar -xvf mpich2_example.tar 
 cd mpich2_example
 ~/usr/bin/mpicxx mpich2_example.cpp -o mpich2_example

Before executing a MPI program you will need to start the MPI daemon

 ~/usr/bin/mpd &

And then the program can be run

 ~/usr/bin/mpirun -np 2 ./mpich2_example