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
Remove KEPLER_DIR variable
Make sure you don't have KEPLER_DIR set inside ~/.cshrc or ~/.profile or ~/.bashrc
Load imasenv/3.23.1 module by calling
> module load imasenv/3.23.1
By default kepler/2.5p4-3.0.1 is loaded together with imasenv/3.23.1
> module load imasenv/3.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.5p4-3.0.0 and keplertools-1.8.1 it is possible to switch between different installations of Kepler - they will not collide).
> kepler_install my_2.5p4-3.0.1 Using KEPLER_DIR at: /afs/eufus.eu/user/g/g2michal/.local/kepler. Using KEPLER_SRC from KEPLER: /gw/swimas/extra/keplertools/1.8.0. mkdir: created directory /afs/eufus.eu/user/g/g2michal/.local/kepler/my_2.5p4-3.0.1 mkdir: created directory /afs/eufus.eu/user/g/g2michal/.local/kepler/my_2.5p4-3.0.1/.kepler mkdir: created directory /afs/eufus.eu/user/g/g2michal/.local/kepler/my_2.5p4-3.0.1/.ptolemyII mkdir: created directory /afs/eufus.eu/user/g/g2michal/.local/kepler/my_2.5p4-3.0.1/KeplerData Done installing /afs/eufus.eu/user/g/g2michal/.local/kepler/my_2.5p4-3.0.1/kepler. /gw/swimas/extra/keplertools/1.8.1/share/modulefiles/kepler? -> /afs/eufus.eu/user/g/g2michal/.local/kepler/modulefiles/kepler/my_2.5p4-3.0.1 Kepler was installed inside /afs/eufus.eu/user/g/g2michal/.local/kepler/my_2.5p4-3.0.1 Its module file is: /afs/eufus.eu/user/g/g2michal/.local/kepler/modulefiles/kepler/my_2.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 load /afs/eufus.eu/user/g/g2michal/.local/kepler/modulefiles/kepler/my_2.5p4-3.0.1 )
Kepler location
Note that by default, Kepler is installed inside $HOME/.local/kepler.
You can change this location by creating symbolic link pointing to some other place
> mkdir $ITMWORK/my_imas_keplers > mkdir -p ~/.local > cd ~/.local # make sure to backup all the stuff you already have there > mv kepler kepler~ > ln -s $ITMWORK/my_imas_keplers kepler
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.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)!
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
> kepler_load my_2.5p4-3.0.1
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 ... ...