Running Kepler at Marconi Gateway
Note |
---|
In case you have never ever installed Kepler you can always take a look at short demo movie that is located at following location: $SWITMDIR/resources/tutorials/movies/installation_of_kepler.mp4 |
Warning |
---|
Note that this page may become outdated after some time. You can always take a look at TWiki pages to get most recent version of manual: Kepler installation at Marconi Gateway |
Setting up environment
Backing up old files
Before first configuration of Kepler, make sure to backup your old data files
Code Block |
---|
language | bash |
---|
linenumbers | true |
---|
|
cd ~
mv .kepler .kepler~
mv KeplerData KeplerData~
mv .ptolemyII .ptolemyII~ |
Creating place to store your personal installations of Kepler
Make sure to create directory where Kepler installations will be stored (ITMWORK is a preffered place)
Code Block |
---|
language | bash |
---|
linenumbers | true |
---|
|
mkdir $ITMWORK/my_keplers
# it might be convenient to create symbolic link inside HOME as well
ln -s "$ITMWORK/my_keplers" my_keplers |
And make sure to export ITM_KEPLER_DIR variable that points to this location
Code Block |
---|
language | bash |
---|
linenumbers | true |
---|
|
# for tcsh, put following command inside .cshrc
setenv ITM_KEPLER_DIR $ITMWORK/my_keplers
# for bash, put following command inside .bashrc
export ITM_KEPLER_DIR=$ITMWORK/my_keplers |
Using helper scripts for Kepler installation
By default, you have access to helper scripts that make it easier to install and maintain Kepler installations
script | arguments/options | purpose |
---|
list_keplers.sh | -help (shows options)
-all (shows all Kepler versions)
| list available keplers |
install_kepler.sh | target_dir src_kepler description
target_dir: chosen directory name inside $ITM_KEPLER_DIR src_kepler: name of Kepler version (as given by list_keplers.sh) description: chosen descriptive text (in quotes) | installs local or central keplers |
list_my_keplers.sh | | lists keplers that are already installed in your home location |
switch_to_kepler.sh | kepler_name
kepler_name: name of the installed Kepler (as given by list_my_keplers.sh)
| changes current working version of Kepler |
Sample installation session
Make sure $ITM_KEPLER_DIR points to location where Keplers will be installed
Code Block |
---|
language | bash |
---|
linenumbers | true |
---|
|
setenv ITM_KEPLER_DIR $ITMWORK/my_keplers |
List all available Keplers
Code Block |
---|
language | bash |
---|
linenumbers | true |
---|
|
# You can use list_keplers.sh to do so
<g2michal@s34 ~>list_keplers.sh -all
List of available Kepler installations
Local installations
- local (default)
Version based on Kepler 2.4
- 2.4/R3_RC/local
Version based on Kepler 2.5
- 2.4/R3_RC/local
Central installations
- central (default)
- rc
Version based on Kepler 2.4
- 2.4/R3_RC_ETS/central
- 2.4/R3_RC/central
Version based on Kepler 2.5
- 2.5/R3_RC/central |
Install Kepler that contains all ETS actors - using central installation
Code Block |
---|
language | bash |
---|
linenumbers | true |
---|
|
# I will use following command
# install_kepler.sh my_R3_RC_ETS 2.4/R3_RC_ETS/central 'This is my first installation at Marconi'
# my_R3_RC_ETS - is the name of directory where Kepler will be stored
# 2.4/R3_RC_ETS/central - points to installation I am interested in
# 'This is my first installation at Marconi' - this is just a description that can make it easier
# to choose between installations later on
<g2michal@s34 ~>install_kepler.sh my_R3_RC_ETS 2.4/R3_RC_ETS/central 'This is my first installation at Marconi'
Using location at: /afs/eufus.eu/user/g/g2michal/kepler_dir
Linking common ...
~/kepler_dir/my_R3_RC_ETS/kepler ~
~
Linking gui ...
~/kepler_dir/my_R3_RC_ETS/kepler ~
~
Linking kepler-tasks ...
Linking build-area ...
Linking build-area/target ...
Copying kepler.sh ...
Creating itm subdirectory structure ...
Linking directories ...
build-area
...
...
configurations
Creating info file
Creating Kepler related directories
Kepler was installed inside /afs/eufus.eu/user/g/g2michal/kepler_dir/my_R3_RC_ETS |
After Kepler is installed, you can list all of your personal installations
Code Block |
---|
language | bash |
---|
linenumbers | true |
---|
|
# you can do this using list_my_kepler.sh script
<g2michal@s34 ~>list_my_keplers.sh
Using location at: /afs/eufus.eu/user/g/g2michal/kepler_dir
Following kepler installations are ready for use
selected type name - 'description'
[ ] [Central ] my_R3_RC_ETS - 'This is my first installation at Marconi'
To use one of these, type
switch_to_kepler.sh [name] |
You can switch between your own installations
Code Block |
---|
language | bash |
---|
linenumbers | true |
---|
|
# in order to switch between installations you have to run
# switch_to_kepler.sh script
<g2michal@s34 ~>switch_to_kepler.sh my_R3_RC_ETS
Using location at: /afs/eufus.eu/user/g/g2michal/kepler_dir
Removing old links [ OK ]
Linking new kepler: my_R3_RC_ETS [ OK ]
# after switching between Kepler, you can easily check which
# installation is currently used. All you have to do is to
# run list_my_keplers.sh again
# note "[X]" next to Kepler installation being currently used
<g2michal@s34 ~>list_my_keplers.sh
Using location at: /afs/eufus.eu/user/g/g2michal/kepler_dir
Following kepler installations are ready for use
selected type name - 'description'
[x] [Central ] my_R3_RC_ETS - 'This is my first installation at Marconi'
To use one of these, type
switch_to_kepler.sh [name] |
You are ready to run Kepler
Code Block |
---|
language | bash |
---|
linenumbers | true |
---|
|
# make sure to set TOKAMAK name before running Kepler
# in case of tcsh, make sure to run
source $ITMSCRIPTDIR/ITMv2 test
kepler.sh
# if you prefer bash, use this one
source $ITMSCRIPTDIR/ITMv2.sh jet
kepler.sh |