1. Most recent steps for Gateway users
In order to use most recent version of Kepler do following.
More 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
Make sure to set KEPLER_DIR properly
If you want, you can use KEPLER_DIR
variable to set preferred location for all Kepler installations
# tcsh > setenv KEPLER_DIR $ITMWORK/imas_kepler # bash > export KEPLER_DIR=$ITMWORK/imas_kepler
You can use different location if you like.
ITM_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
module by calling
> module load imasenv
By default kepler/2.5p4-3.0.1
is loaded together with imasenv
> module load imasenv INFO: No wpcdenv was set. Using default one. IMAS environment loaded.
Now, you can install your personal Kepler installation.
> module switch kepler/2.5p4-3.0.5 WARNING: switching to keplertools/1.8.7 > kepler_install my_2.5p4-3.0.5 Done installing /afs/eufus.eu/user/g/g2michal/.local/kepler/my_2.5p4-3.0.5/kepler. Kepler was installed in /afs/eufus.eu/user/g/g2michal/.local/kepler/my_2.5p4-3.0.5
Kepler location
Note that by default, Kepler is installed inside $HOME/.local/kepler
.
You can change this location by setting KEPLER_DIR
variable
# 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
> kepler_avail Using KEPLER_DIR at: /afs/eufus.eu/user/g/g2michal/.local/kepler. Available local installations (* currently loaded): my_2.5p4-3.0.5 : /gw/swimas/extra/kepler/2.5p4-3.0.5 keplertools/1.8.7 NOTE: No installation is currently loaded, please use `kepler_load` to load one or create a new one with `kepler_install`.
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 (load) Kepler version. You can do it by running kepler_load
command.
Take a look at the output of kepler_avail
after you have loaded Kepler. You can see asterisk next to loaded Kepler.
> kepler_load my_2.5p4-3.0.5 Using KEPLER_DIR at: /afs/eufus.eu/user/g/g2michal/.local/kepler. > kepler_avail Using KEPLER_DIR at: /afs/eufus.eu/user/g/g2michal/.local/kepler. Available local installations (* currently loaded): * my_2.5p4-3.0.5 : /gw/swimas/extra/kepler/2.5p4-3.0.5 keplertools/1.8.7
Once you have set version of Kepler, you can run it by typing kepler
> kepler The base dir is /afs/eufus.eu/g2itmdev/user/g2michal/.local/kepler/my_2.5p4-3.0.1/kepler Kepler.run going to run.setMain(org.kepler.Kepler) JVM Memory: min = 1G, max = 8G, stack = 20m, maxPermGen = default ... ...