Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Most recent steps for Gateway users

In order to use most recent version of Kepler do following. First of all make sure you have directory imas-kepler inside your $HOME

Code Block
> mkdir -p $HOME/imas-kepler/modulefiles

Make sure to set IMAS_KEPLER_DIR variable inside .cshrc file

Code Block
> echo "setenv IMAS_KEPLER_DIR $HOME/imas-kepler" >> ~/.cshrc

Info
titleMore info (technical details) can be found here

You can find more info regarding this installation at ITER: https://confluence.iter.org/display/IMP/2019/05/24/New+release+and+installation+of+IMAS+and+Kepler+on+ITER+cluster

Info
titleMake sure to set KEPLER_DIR properly

If you want, you can use KEPLER_DIR variable to set preferred location for all Kepler installations

Code Block
# tcsh
> setenv KEPLER_DIR $ITMWORK/imas_kepler
 
# bash
> export KEPLER_DIR=$ITMWORK/imas_kepler
 

You can use different location if you like.

Warning
titleITM_KEPLER_DIR vs. KEPLER_DIR

In the past, KEPLER_DIR variable was used to set location of user based installations inside ITM. This variable was adapted by IMAS based release of Kepler.

If you want to set location of your ITM based Keplers, make sure to use variable ITM_KEPLER_DIR

Load imasenv/3.23.1Now, you can load imasenv/3.21.0 module by calling

Code Block
> module load imasenv/3.2123.01

By default Note that this module uses kepler/2.5p25p4-23.0.1.5 instead of kepler/2.5p2-2.1.3 is loaded together with imasenv/3.23.1

Code Block
> module load imasenv/3.21.0.23.1
INFO: No wpcdenv was set. Using default one.
IMAS environment loaded.
Please do not forget to set database by calling 'imasdb <machine_name>' ! 

Now, you can install your personal Kepler installation (please note that since release kepler/2.5p5p4-23.10.5 and 0 and keplertools-1.78.0 it 1 it is possible to switch between different installations of Kepler (- they will not collide).

Code Block
> kepler_install my_own_kepler2.5p4-3.0.1
Using IMAS_KEPLER_DIR at: /pfs/work/g2michal/imas-keplers/afs/eufus.eu/user/g/g2michal/.local/kepler.
Using KEPLER_SRC from KEPLER: /gw/swimas/extra/keplerkeplertools/21.5p2-2.1.58.0.
mkdir: created directory ?/pfs/work/afs/eufus.eu/user/g/g2michal/imas-keplers.local/kepler/my_own_kepler?2.5p4-3.0.1
mkdir: created directory ?/pfs/work/g2michal/imas-keplers/my_own_kepler/.kepler?/afs/eufus.eu/user/g/g2michal/.local/kepler/my_2.5p4-3.0.1/.kepler
mkdir: created directory ?/pfs/work/afs/eufus.eu/user/g/g2michal/imas-keplers.local/kepler/my_own_kepler2.5p4-3.0.1/.ptolemyII?
mkdir: created directory ?/pfs/work/g2michal/imas-keplers/my_own_kepler/KeplerData?/afs/eufus.eu/user/g/g2michal/.local/kepler/my_2.5p4-3.0.1/KeplerData
Done installing /pfs/work/afs/eufus.eu/user/g/g2michal/imas-keplers.local/kepler/my_own_kepler2.5p4-3.0.1/kepler.
?/gw/swimas/extra/keplertools/1.78.01/share/modulefiles/kepler? -> ?/pfs/work/g2michal/imas-keplers/afs/eufus.eu/user/g/g2michal/.local/kepler/modulefiles/kepler/my_own_kepler?

2.5p4-3.0.1
Kepler was installed inside /pfs/work/afs/eufus.eu/user/g/g2michal/imas-keplers.local/kepler/my_own_kepler2.5p4-3.0.1
Its module file is: /pfs/work/g2michal/imas-keplers/afs/eufus.eu/user/g/g2michal/.local/kepler/modulefiles/kepler/my_own_kepler2.5p4-3.0.1
To see available installations: kepler_avail
To remove this installation, run: kepler_remove my_2.5p4-3.0.1
To load this environment, run: kepler_load my_2.5p4-3.0.1
( or module switch kepler/my_own_kepler
To see available installations: module avail kepler load /afs/eufus.eu/user/g/g2michal/.local/kepler/modulefiles/kepler/my_2.5p4-3.0.1 )
Warning
titleKepler location

Note that by default, Kepler is installed inside $HOME/.local/kepler.

You can change this location by setting KEPLER_DIR variable

Code Block
# tcsh
> mkdir $ITMWORK/my_imas_keplers
> setenv KEPLER_DIR $ITMWORK/my_imas_keplers# tcsh


# bash
> mkdir $ITMWORK/my_imas_keplers
> export KEPLER_DIR=$ITMWORK/my_imas_keplers

Now, you can list your own Kepler installations by calling

Code Block
> kepler_avail
Using KEPLER_DIR at: /afs/eufus.eu/user/g/g2michal/.local/kepler.
Available local installations (* currently loaded):
* my_2.5p4-3.0.1  	: /gw/swimas/extra/kepler/2.5p4-3.0.1	keplertools/1.8.1
WARNING: KEPLER is not in KEPLER_DIR (/afs/eufus.eu/user/g/g2michal/.local/kepler)!
Info
titleWarning

> module avail kepler

---- /pfs/work/g2michal/imas-keplers/modulefiles ----
kepler/my_own_kepler kepler/test

As you can see, your personal Kepler installations are available via modules. In order to switch to given version of Kepler you need to switch the module

Code Block
> module switch kepler/my_own_keplerkepler_load my_2.5p4-3.0.1

Once you have set version of Kepler, you can run it by typing kepler

Code Block
> kepler
kepler
The base dir is /marconi_workafs/eufus_gw/work.eu/g2itmdev/user/g2michal/imas-keplers/.local/kepler/my_own_kepler2.5p4-3.0.1/kepler
Kepler.run going to run.setMain(org.kepler.Kepler)
JVM Memory: min = 1G,  max = 8G, stack = 20m, maxPermGen = default
...
...