Difference between revisions of "Installation linux"

From relax wiki
Jump to navigation Jump to search
(Switched to the {{relax source}} template for repository links, and removed all SVN references.)
 
(19 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 +
__TOC__
 +
 
== Installing the relax dependencies ==
 
== Installing the relax dependencies ==
  
Line 20: Line 22:
 
yum install subversion
 
yum install subversion
 
yum install python-matplotlib
 
yum install python-matplotlib
 +
 +
# We can manage python package installations with pip
 +
sudo easy_install pip
 
</source>
 
</source>
  
Line 26: Line 31:
 
== Minfx and Bmrblib ==
 
== Minfx and Bmrblib ==
  
Remember to check, if there are newer versions of [http://download.gna.org/minfx minfx] and [http://download.gna.org/bmrblib bmrblib]. <br>
+
# [[Minfx#Install | Minfx]]
The [https://gna.org/projects/minfx/ minfx] and [https://gna.org/projects/bmrblib/ bmrblib] libraries can be installed on all Linux systems by typing:
+
# [[Bmrblib#Install | Bmrblib]]
<source lang="bash">
+
# [[mpi4py#Install | mpi4py]]
cd $HOME/Downloads
 
 
 
wget http://download.gna.org/minfx/minfx-1.0.5.tar.gz
 
tar -xzf minfx-1.0.5.tar.gz
 
cd minfx-1.0.5
 
sudo python setup.py install
 
cd ..
 
 
 
wget http://download.gna.org/bmrblib/bmrblib-1.0.3.tar.gz
 
tar -xzf bmrblib-1.0.3.tar.gz
 
cd bmrblib-1.0.3
 
sudo python setup.py install
 
cd ..
 
</source>
 
 
 
== mpi4py ==
 
Relax can run some [[mpi4py | optimizations]] with multi-processors. [http://www.nmr-relax.com/manual/Usage_multi_processor.html See the manual].<br>
 
It needs '''openmpi-devel''' and the python package '''mpi4py'''.<br>
 
NOTE, this is not an necessity to run relax, and should only be tried if large number analysis would be tried out.
 
 
 
Remember to check, if there are newer versions of [https://bitbucket.org/mpi4py/mpi4py/downloads mpi4py]. <br>
 
The [https://code.google.com/p/mpi4py/ mpi4py] libraries can be installed on all Linux systems by typing [http://mpi4py.scipy.org/docs/usrman/install.html or check instructions here.]:
 
<source lang="bash">
 
# Install openmpi-devel, to get 'mpicc'
 
sudo yum install openmpi-devel
 
# Check for mpicc
 
which mpicc
 
# If not found, try this fix, ref: http://forums.fedoraforum.org/showthread.php?t=194688
 
#For 32 computer.
 
sudo ln -s /usr/lib/openmpi/bin/mpicc /usr/bin/mpicc
 
# For 64 bit computer.
 
sudo ln -s /usr/lib64/openmpi/bin/mpicc /usr/bin/mpicc
 
# Source your shell settings, to find the executable,
 
# or restart your terminal.
 
source $HOME/.cshrc
 
 
 
# Then install mpi4py
 
cd $HOME/Downloads
 
wget https://bitbucket.org/mpi4py/mpi4py/downloads/mpi4py-1.3.1.tar.gz
 
tar -xzf mpi4py-1.3.1.tar.gz
 
cd mpi4py-1.3.1
 
python setup.py build
 
sudo python setup.py install
 
</source>
 
  
 
== Testing the Python installation ==
 
== Testing the Python installation ==
  
 
Before installing relax, it is best to be sure that the Python modules are functional by importing them:
 
Before installing relax, it is best to be sure that the Python modules are functional by importing them:
<source lang="python">
+
 
 +
{{collapsible script
 +
| type  = Python commands
 +
| title  = Testing modules by importing them.
 +
| lang   = python
 +
| script =
 
$ python
 
$ python
 
Python 2.6.6 (r266:84292, Oct 12 2012, 14:23:48)
 
Python 2.6.6 (r266:84292, Oct 12 2012, 14:23:48)
Line 97: Line 63:
 
>>> mpi4py.__file__
 
>>> mpi4py.__file__
 
'...'
 
'...'
</source>
+
}}
  
 
== Checking out a relax branch ==
 
== Checking out a relax branch ==
  
If you would like to play with relax branch rather than the main [http://www.nmr-relax.com/download.html relax downloads], the [http://subversion.tigris.org/ Subversion] program should first be installed. <br>
+
If you would like to play with relax branch rather than the main [http://www.nmr-relax.com/download.html relax downloads], the [https://git-scm.com/ Git] program should first be installed. <br>
You can see the different branches [http://svn.gna.org/viewcvs/relax/ here.] <br>
+
You can see the different branches {{relax source|text=here}}. <br>
 
First the relax sources can be checked out of the source code repository and the C modules compiled:
 
First the relax sources can be checked out of the source code repository and the C modules compiled:
  
=== Using subversion ===
+
=== Using git ===
To check out the relax_disp or trunk branch using the subversion client, simply type:
+
To check out the relax trunk using the git client, simply type:
<source lang="bash">
+
{{#tag:source|
svn co svn://svn.gna.org/svn/relax/branches/relax_disp relax_disp
+
{{relax clone}}
svn co svn://svn.gna.org/svn/relax/trunk relax_trunk
+
| lang="bash"
</source>
+
}}
 
 
If this svn command does not work, try:
 
<source lang="bash">
 
svn co http://svn.gna.org/svn/relax/branches/relax_disp relax_disp
 
svn co http://svn.gna.org/svn/relax/trunk relax_trunk
 
</source>
 
  
 
=== Compilation of the C modules ===
 
=== Compilation of the C modules ===
  
For the R1 and R2 and relaxation dispersion analyses, the relax C modules must be compiled.  This is done using the scons program, by simply typing:
+
For the {{:R1}} and {{:R2}} and relaxation dispersion analyses, the relax C modules must be compiled.  This is done using the scons program, by simply typing:
 
<source lang="bash">
 
<source lang="bash">
cd relax_disp
+
cd relax_trunk
 
scons
 
scons
 
</source>
 
</source>
Line 133: Line 93:
  
 
<source lang="bash">
 
<source lang="bash">
cd relax_disp
+
cd relax_trunk
 
echo "setenv PATH $PWD"':$PATH' >> $HOME/.cshrc
 
echo "setenv PATH $PWD"':$PATH' >> $HOME/.cshrc
 
</source>
 
</source>
Line 151: Line 111:
 
</source>
 
</source>
  
=== In multiprocessor mode ===
+
== Test installation ==
<source lang="bash">
+
{{caution|After an installation you should really run an [[Installation_test]].}}
set RELAX=`which relax`
 
# Normal
 
mpirun -np N+1 $RELAX --multi='mpi4py'
 
# In gui
 
mpirun -np N+1 $RELAX --multi='mpi4py' -g
 
</source>
 
where N is the number of slaves you have.  See the mpirun documentation for details - this is not part of relax.  <br>
 
This code runs in the GUI, the script UI and the prompt UI, i.e. everywhere.
 
  
== Helper start scripts ==
+
== Trouble shooting ==
If you have several versions or development branches of relax installed, you could probably use some of these scripts, and put them in your PATH.
+
=== The menu icons are missing in Linux. ===
=== Script for force running the disp branch of relax on server computer ===
+
On some Linux systems, the icons for the menu items are not shown. This was a decision taken by the Gnome developers at some point to keep the GUI minimal, though in recent versions this behaviour has been reverted. <br>
This script exemplifies a setup, where the above installation requirements is met on one server computer ''haddock'', and where satellite computers
+
If you suffer from this problem, to reactive the icons simply type in the shell:
are forced to run on this computer.
+
gconftool-2 --get /desktop/gnome/interface/menus_have_icons
 
+
gconftool-2 --type boolean --set /desktop/gnome/interface/menus_have_icons true
The file '''relax_disp''' is made executable (''chmod +x relax_disp''), and put in a PATH, known by all satellite computers.
 
<source lang="bash">
 
#!/bin/tcsh -f
 
 
 
# Set the lax version used for this script.
 
set RELAX=/network_drive/software_user/software/NMR-relax/relax_disp/relax
 
 
 
# Check machine, since only machine haddock have correct packages installed.
 
if ( $HOST != "haddock") then
 
        echo "You have to run on haddock. I do it for you"
 
        ssh haddock -Y -t "cd $PWD; $RELAX $argv; /bin/tcsh"
 
else
 
        $RELAX $argv
 
endif
 
</source>
 
 
 
=== Script for running the disp branch of relax with maximum number of processors available ===
 
This script exemplifies a setup, to test the running relax with maximum number of processors.
 
  
The file '''relax_test''' is made executable, and put in a PATH, known by all satellite computers.
+
For GNOME 3
<source lang="bash">
+
# Get schemas
#!/bin/tcsh -fe
+
gsettings list-schemas
 +
gsettings list-schemas | grep org.gnome.desktop
 +
gsettings list-schemas | grep org.gnome.desktop.interface
  
# Set the relax version used for this script.
+
# Get keys
set RELAX=/sbinlab2/tlinnet/software/NMR-relax/relax_disp/relax
+
gsettings list-keys org.gnome.desktop.interface
 +
gsettings list-keys org.gnome.desktop.interface | grep icon
 +
gsettings list-keys org.gnome.desktop.interface | grep desktop
  
# Set number of available CPUs.
+
# Get value
set NPROC=`nproc`
+
gsettings get org.gnome.desktop.interface icon-theme
set NP=`echo $NPROC + 1 | bc `
 
 
 
echo "Running relax with NP=$NP in multi-processor mode"
 
 
 
# Run relax in multi processor mode.
 
/usr/lib64/openmpi/bin/mpirun -np $NP $RELAX --multi='mpi4py' $argv
 
</source>
 
  
== TEST INSTALLATION ==
+
# https://wiki.archlinux.org/index.php/GNOME/Tips_and_tricks#Enable_button_and_menu_icons
After an installation you should really run an [[Installation_test]]
+
# Since GTK+ 3.10, the GSettings key 'menus-have-icons' has been deprecated. Icons in buttons and menus can still be enabled by setting the following overrides:
 +
gsettings set org.gnome.settings-daemon.plugins.xsettings overrides "{'Gtk/ButtonImages': <1>, 'Gtk/MenuImages': <1>}"
  
== Trouble shooting ==
+
# Check
=== The menu icons are missing in Linux. ===
+
gsettings list-keys org.gnome.settings-daemon.plugins.xsettings
On some Linux systems, the icons for the menu items are not shown. This was a decision taken by the Gnome developers at some point to keep the GUI minimal, though in recent versions this behaviour has been reverted. <br>
+
  gsettings get org.gnome.settings-daemon.plugins.xsettings overrides
If you suffer from this problem, to reactive the icons simply type in the shell:
 
  gconftool-2 --type boolean --set /desktop/gnome/interface/menus_have_icons true
 
  
 
== See also ==
 
== See also ==
 
[[Category:Installation]]
 
[[Category:Installation]]

Latest revision as of 20:42, 27 October 2017

Installing the relax dependencies

The python-devel and scons packages are only required if the C modules need to be compiled for your system.

  • Grace software is used for visualisation of 2D data sets.
  • subversion is only if you wan't to checkout the source code.
  • matplotlib is not a necessity, but is likely to be implemented later for extended plotting.

RHEL 5 and compatible distributions

For RPM-based Linux distributions with access to the YUM installer, first install the relax dependencies with:

yum install python
yum install python-devel
yum install numpy
yum install scipy
yum install scons
yum install wxPython
yum install grace
yum install subversion
yum install python-matplotlib

# We can manage python package installations with pip
sudo easy_install pip

If you do not have root access but are in the sudo group, then add a sudo before each of the above commands.

Minfx and Bmrblib

  1. Minfx
  2. Bmrblib
  3. mpi4py

Testing the Python installation

Before installing relax, it is best to be sure that the Python modules are functional by importing them:

Checking out a relax branch

If you would like to play with relax branch rather than the main relax downloads, the Git program should first be installed.
You can see the different branches here.
First the relax sources can be checked out of the source code repository and the C modules compiled:

Using git

To check out the relax trunk using the git client, simply type:

git clone git://git.code.sf.net/p/nmr-relax/code/ relax

Compilation of the C modules

For the R1 and R2 and relaxation dispersion analyses, the relax C modules must be compiled. This is done using the scons program, by simply typing:

cd relax_trunk
scons

You must be in the base relax directory for this to work.

In addition, if you would like to compile the relax user manual via LaTeX, you can also use scons. See the wiki page manual.:

Add to path - C_shell / Tcsh

cd relax_trunk
echo "setenv PATH $PWD"':$PATH' >> $HOME/.cshrc

Restart the terminal, to load the new variables.

Start relax

Normal

# Normal
relax
# See help
relax -h
# In GUI mode
relax -g
# Execute script
relax -g

Test installation

Caution  After an installation you should really run an Installation_test.

Trouble shooting

The menu icons are missing in Linux.

On some Linux systems, the icons for the menu items are not shown. This was a decision taken by the Gnome developers at some point to keep the GUI minimal, though in recent versions this behaviour has been reverted.
If you suffer from this problem, to reactive the icons simply type in the shell:

gconftool-2 --get /desktop/gnome/interface/menus_have_icons
gconftool-2 --type boolean --set /desktop/gnome/interface/menus_have_icons true

For GNOME 3

# Get schemas
gsettings list-schemas
gsettings list-schemas | grep org.gnome.desktop
gsettings list-schemas | grep org.gnome.desktop.interface
# Get keys
gsettings list-keys org.gnome.desktop.interface 
gsettings list-keys org.gnome.desktop.interface | grep icon
gsettings list-keys org.gnome.desktop.interface | grep desktop
# Get value
gsettings get org.gnome.desktop.interface icon-theme
# https://wiki.archlinux.org/index.php/GNOME/Tips_and_tricks#Enable_button_and_menu_icons
# Since GTK+ 3.10, the GSettings key 'menus-have-icons' has been deprecated. Icons in buttons and menus can still be enabled by setting the following overrides: 
gsettings set org.gnome.settings-daemon.plugins.xsettings overrides "{'Gtk/ButtonImages': <1>, 'Gtk/MenuImages': <1>}"
# Check
gsettings list-keys org.gnome.settings-daemon.plugins.xsettings
gsettings get org.gnome.settings-daemon.plugins.xsettings overrides

See also