====== Quick Installation Guide on Ubuntu Server 9.04 ======

===== Single-user Instance =====

This section is intended for user willing to install GridWay without need to share the installation with other users.
We will assume a installation done by a user with sudo capabilities and placed in a directory inside the $HOME folder.

==== Pre-requisites and download ====
We assume that your installation will be performed at ''$HOME/gridway''.
<xterm>
sudo apt-get install subversion make libssl-dev xinetd ant
mkdir $HOME/gridway
cd $HOME/gridway
wget <nowiki>http://dev.gridway.org/attachments/download/35/gridway_5.5.1.tar.gz</nowiki>
gunzip -c gridway_5.5.1.tar.gz | tar xvf -
cd $HOME/gridway/gridway_5.5.1
</xterm>

==== Environment setup ====
From here on, we assume you have already installed the Globus Toolkit 4.2 and your ''$GLOBUS_LOCATION'' is ''/opt/globus/4.2.1''. Check the [[http://www.globus.org/toolkit/docs/4.2/4.2.1/admin/quickstart|Globus Quick Start Guide]] in order to know how to easily install Globus on your machine (you can restrict yourself there to sections 1.1, 1.2 and 1.5).

You will need to add following environmental variables in your ~/.profile
<xterm>
nano $HOME/.profile
</xterm>
Add at the end the following content:
<file>
GLOBUS_LOCATION=/opt/globus/4.2.1
GW_LOCATION=$HOME/gridway/5.5.1
JAVA_HOME=/usr/lib/jvm/java-6-openjdk
ANT_HOME=/usr/share/ant
PATH=$GW_LOCATION/bin:$GLOBUS_LOCATION/bin:${PATH}
LD_LIBRARY_PATH=$GW_LOCATION/lib:${LD_LIBRARY_PATH}
export PATH LD_LIBRARY_PATH GLOBUS_LOCATION GW_LOCATION JAVA_HOME ANT_HOME
</file>

And do not forget to source this file in order to follow:
<xterm>
. $HOME/.profile
</xterm>

==== Installation ====
This step is required only if you want to compile GridWay with support of the drmaa-ruby and ldap:
<xterm>
sudo apt-get install ruby-dev libnet-ldap-perl
</xterm>

In any case, you are ready for the ''./configure; make; make install'' phase:
<xterm>
./configure --enable-ldap --enable-prews --enable-drmaa-ruby --prefix=$HOME/gridway/5.5.1
make
make install
</xterm>

==== Configuration ====
You will need to edit the ''$HOME/gridway/5.5.1/etc/gwd.conf'' according to the [[documentation:release_5.5:cg| Configuration Guide]].

==== Starting the daemon ====
<xterm>
gwd
</xterm>

Now you are done! Check the [[documentation:release_5.5:ug|User's Guide]] to check your installation and submit your first jobs.

===== Multiuser Instance =====

If you are a sysdamin willing to give support to more than one user simultaneously, then this section is for you.

==== Prepare GridWay Admin and Group ====
<xterm>
sudo addgroup gwusers
sudo adduser --system --home /opt/gridway --ingroup gwusers --shell /bin/sh gwadmin
</xterm>

==== Prerequisites and download ====
<xterm>
sudo apt-get install subversion make libssl-dev xinetd ant
cd /opt/gridway
sudo -u gwadmin svn co <nowiki>http://svn.gridway.org/gridway/trunk 5.5_installation_sources</nowiki>
</xterm>

==== Environment setup ====
From here on, we assume you have already installed the Globus Toolkit 4.2 and your ''$GLOBUS_LOCATION'' is ''/opt/globus/4.2.1''. Check the [[http://www.globus.org/toolkit/docs/4.2/4.2.1/admin/quickstart|Globus Quick Start Guide]] in order to know how to easily install Globus on your machine (you can restrict yourself there to sections 1.1, 1.2 and 1.5).

You will need environmental variables for the gwusers so
<xterm>
sudo nano /etc/profile.d/gridway.sh
</xterm>
and edit the ''/etc/profile.d/gridway.sh'' file with the following content:
<file>
for i in `groups`; do
 if [ "$i" = 'gwusers' ]; then
  GLOBUS_LOCATION=/opt/globus/4.2.1
  GW_LOCATION=/opt/gridway/5.5
  JAVA_HOME=/usr/lib/jvm/java-6-openjdk
  ANT_HOME=/usr/share/ant
  PATH=$GW_LOCATION/bin:$GLOBUS_LOCATION/bin:${PATH}
  LD_LIBRARY_PATH=$GW_LOCATION/lib:${LD_LIBRARY_PATH}
  export PATH LD_LIBRARY_PATH GLOBUS_LOCATION GW_LOCATION JAVA_HOME ANT_HOME
 fi
done
</file>

==== Installation ====
This step is required only if you want to compile GridWay with support of the drmaa-ruby and ldap:
<xterm>
sudo apt-get install ruby ruby-dev libnet-ldap-perl
</xterm>

In any case, you are ready for the ''./configure; make; make install'' phase, but it will be trickier since the gwadmin is a system user (that's why we use ''sudo -u'') and environmental variables are loaded when login (that's why we use ''sh -l'')
<xterm>
cd /opt/gridway/5.5_installation_sources
sudo -u gwadmin sh -lc './configure --enable-ldap --enable-prews --enable-drmaa-ruby --enable-drmaa1 --prefix=/opt/gridway/5.5'
sudo -u gwadmin sh -lc 'make'
sudo -u gwadmin sh -lc 'make install'
</xterm>

==== Configuration ====
You will need to edit the ''/opt/gridway/5.5/etc/gwd.conf'' according to the [[documentation:release_5.5:cg| Configuration Guide]].

Moreover the administrator of GridWay needs to launch the Execution and Transfer MADs as the user themselves, therefore some privileges are required to be set in the /etc/sudoers file.

<xterm>
sudo visudo
</xterm>
and add the following lines
<file>
Runas_Alias GWUSERS = %gwusers
Defaults>GWUSERS env_keep="GW_LOCATION GLOBUS_LOCATION GLOBUS_TCP_PORT_RANGE"
gwadmin ALL=(GWUSERS) NOPASSWD: /opt/gridway/5.5/bin/gw_em_mad_prews *
gwadmin ALL=(GWUSERS) NOPASSWD: /opt/gridway/5.5/bin/gw_em_mad_ws *
gwadmin ALL=(GWUSERS) NOPASSWD: /opt/gridway/5.5/bin/gw_tm_mad_dummy *
gwadmin ALL=(GWUSERS) NOPASSWD: /opt/gridway/5.5/bin/gw_tm_mad_ftp *
</file>

==== Starting the daemon (simple way)====
<xterm>
sudo -u gwadmin sh -lc 'gwd -m'
</xterm>

We recommend you to insert a similar line into your ''/etc/rc.local'' to get it started every time after boot
<file>
su gwadmin -c "sh -lc 'gwd -m'"
</file>