DAMASK_EICMD/installation/mods_MarcMentat/installation.txt

Install MPIE modifications to use DAMASK_marc2010/11/12

Refer to http://damask.mpie.de for complete installation instructions.

Usually you will need to be root for this to work!

This is for the Linux64 version of Marc/Mentat2010(.2)/11/12.
See Marc and Mentat Release Guide for List of Build and Supported Platforms!

The Intel Fortran compiler needs to be installed. The 2010 release of Marc/Mentat relies on Intel Fortran 10.1(_18)! The 2011/2012 release of Marc/Mentat relies on Intel Fortran 12.0! Make sure that ifort (the compiler executable) is in the PATH and that LD_LIBRARY_PATH is set correctly, refer to the Intel installation guide for instructions on how to do this.

The AMD Core Math Library or an other BLAS implementation (currently IMKL and LAPACK are supported) needs to be installed! 
Add acml path to LD_LIBRARY_PATH, to do so either use the script setup_shellrc.py in the installstion folder or for a systemwide setup edit /etc/csh.cshrc.local and/or /etc/bash.bashrc.local.
Assuming ACML is installed in path ACMLDIR the path should read: /ACMLDIR/ifort64_mp/lib (this is the version using paralllization, ie openmp):
 for bash: LD_LIBRARY_PATH="/ACMLDIR/ifort64_mp/lib:${LD_LIBRARY_PATH}"; export LD_LIBRARY_PATH
 for csh:  setenv LD_LIBRARY_PATH /ACMLDIR/ifort64_mp/lib:${LD_LIBRARY_PATH}
 
As the apply_DAMASK_modifications script has to fix the path for the BLAS it needs to be installed in a place that can be accessed by all users of the system. In addition you have to specify the respective locations in DAMASK_ROOT/lib/pathInfo. 

1) Install Marc, Mentat and Documentation as usual
   Run the test example including subroutines to confirm that the installation of both Marc/Mentat and the Intel Fortran Compiler is ok!
2) Run the apply_DAMASK_modifications script from this directory.


APPENDIX:

The structure of this directory should be (VERSION = 2010 or 2010.2 or 2011):

./installation.txt                          this text
./apply_MPIE_modifications                  script file to apply modifications to the installation
./VERSION/Marc_tools/comp_user.org          original file from installation
./VERSION/Marc_tools/comp_user              modified version using -O1 optimization
./VERSION/Marc_tools/comp_user_l            modified version using -O0 optimization
./VERSION/Marc_tools/comp_user_h            modified version using -O2 optimization
./VERSION/Marc_tools/comp_user_mp           modified version using -O1 optimization and OpenMP
./VERSION/Marc_tools/comp_user_lmp          modified version using -O0 optimization and OpenMP
./VERSION/Marc_tools/comp_user_hmp          modified version using -O2 optimization and OpenMP
./VERSION/Marc_tools/run_marc.org           original file from installation
./VERSION/Marc_tools/run_marc               modified version using -O1 optimization
./VERSION/Marc_tools/run_l_marc             modified version using -O0 optimization
./VERSION/Marc_tools/run_h_marc             modified version using -O2 optimization
./VERSION/Marc_tools/run_mp_marc            modified version using -O1 optimization and OpenMP
./VERSION/Marc_tools/run_lmp_marc           modified version using -O0 optimization and OpenMP
./VERSION/Marc_tools/run_hmp_marc           modified version using -O2 optimization and OpenMP
./VERSION/Marc_tools/include_linux64.org    original file from installation
./VERSION/Marc_tools/include_linux64        modified version
./VERSION/Mentat_bin/edit_window.org        original file from installation
./VERSION/Mentat_bin/edit_window            modified version
./VERSION/Mentat_bin/submit1.org            original file from installation
./VERSION/Mentat_bin/submit4                modified version of original calling run_h_marc
./VERSION/Mentat_bin/submit5                modified version of original calling run_marc
./VERSION/Mentat_bin/submit6                modified version of original calling run_l_marc
./VERSION/Mentat_bin/submit7                modified version of original calling run_hmp_marc
./VERSION/Mentat_bin/submit8                modified version of original calling run_mp_marc
./VERSION/Mentat_bin/submit9                modified version of original calling run_lmp_marc
./VERSION/Mentat_bin/kill4                  kill file for submit4, identical to original kill1
./VERSION/Mentat_bin/kill5                  kill file for submit5, identical to original kill1
./VERSION/Mentat_bin/kill6                  kill file for submit6, identical to original kill1
./VERSION/Mentat_bin/kill7                  kill file for submit7, identical to original kill1
./VERSION/Mentat_bin/kill8                  kill file for submit8, identical to original kill1
./VERSION/Mentat_bin/kill9                  kill file for submit9, identical to original kill1
./VERSION/Mentat_menus/job_run.ms.org       original file from installation
./VERSION/Mentat_menus/job_run.ms           modified version