== Getting an account ==

First, you need to get an account from NOTUR, the webpage for you request is : https://www.metacenter.no/user/application/form/notur/.

== ssh configuration ==

You can add the following lines to `~/.ssh/config` on your local machine:
{{{
#!sh
Host vilje vilje.hpc.ntnu.no
    HostName vilje.hpc.ntnu.no
    User YOURVILJEUSERNAME
}}}
and replace `YOURVILJEUSERNAME` by your vilje username.

Once this is done, you can ssh vilje by simply doing:

{{{
#!sh
ssh vilje
}}}

== Password-less ssh ==

Once you have the account, you can setup a public key authentification in order to avoid having to input your password for each run. 
You need to have a SSH public/private key pair. If you do not, you can create a SSH public/private key pair by typing the following command and following the prompts (no passphrase necessary):
{{{
#!sh
$your_localhost% ssh-keygen -t rsa
Generating public/private rsa key pair.
Enter file in which to save the key (/Users/username/.ssh/id_rsa):RETURN
Enter passphrase (empty for no passphrase):RETURN
Enter same passphrase again:RETURN
Your identification has been saved in /Users/username/.ssh/id_rsa.
Your public key has been saved in /Users/username/.ssh/id_rsa.pub.
}}}

Two files were created: your private key `/Users/username/.ssh/id_rsa`, and the public key `/Users/username/.ssh/id_rsa.pub`. The private key is read-only and only for you, it is used to decrypt all correspondence encrypted with the public key. The contents of the public key need to be copied to `~/.ssh/authorized_keys` on your vilje account:

{{{
#!sh
$your_localhost%scp ~/.ssh/id_rsa.pub username@your_remosthost:~
}}}

Now on '''Vilje''', copy the content of id_rsa.pub:

{{{
#!sh
$your_remosthost%cat ~/id_rsa.pub >> ~/.ssh/authorized_keys
$your_remosthost%rm ~/id_rsa.pub
}}}

== Environment ==

On Vilje, add the following lines to `~/.bashrc`:
{{{
#!sh
export ISSM_DIR=PATHTOTRUNK
#
module load intelcomp/13.0.1 mpt/2.06 petsc/3.4.1d
module load parmetis/4.0.2 mumps/4.10.0
module load automake
}}}

''Log out and log back in'' to apply this change.

== Installing ISSM on Vilje ==

You can check out ISSM and install m1qn3. This is the only package we will install, the module loaded from your bashrc are taking care of the rest.

Use the following configuration script (adapt to your needs):

{{{
#!/bin/sh                                                                                                                                                       
./configure \
    --prefix=$ISSM_DIR \
    --without-kriging \
    --with-wrappers=no \
    --with-petsc-dir="/sw/sdev/Modules/petsc/petsc-3.4.1" \
    --with-mpi-include="/sw/sgi/mpt/mpt-2.06/include/"  \
    --with-mpi-libflags="-L/sw/sgi/mpt/mpt-2.06/lib -lmpi -lmpi++" \
    --with-metis-dir="/sw/sdev/Modules/parmetis/parmetis-4.0.2/include" \
    --with-mumps-dir="/sw/sdev/Modules/mumps/mumps-4.10.0" \
    --with-cxxoptflags="-O2 -xAVX" \
    --with-m1qn3-dir="$ISSM_DIR/externalpackages/m1qn3/install" \
    --enable-development
}}}

You will need to comment the following line in src/c/main/EnvironmentInint.cpp
{{{
if(!my_rank) printf("(website: %s contact: %s)\n",PACKAGE_URL,PACKAGE_BUGREPORT);
}}}

== vilje_settings.py ==
{{{
def vilje_settings(md):                                                                                                                     
    md.login='YOURNOTURLOGIN'
    md.queue='workq'
    md.codepath='YOURCODEPATH'#home is fne
    md.executionpath='YOUREXECPATH'#should be in /work/username to avoid flooding your home
    md.accountname='nn4659k'#this is for ice2ice
    md.numnodes=1
    md.numprocess=8
    return md
}}}
== vilje_settings.m ==

The use of the Python version of the code is encouraged at Uib but you are welcom to clone the python settings.