...

Components to be installed

...

If we are using the fat-client set-up then following needs to be installed locally:

* UDA fat-client
* UDA plugins (from https://git.iter.org/projects/IMAS/repos/uda-plugins/browse)plugins 

If we are using the thin-client set-up then only the UDA client needs to be installed – though a UDA server will need to be running somewhere accessible with the UDA plugins running on that server. * Should module files be created manually?

- When you install UDA it should create a modulefiles directory.

In addition to the basic installation steps I believe a new module-file should be produced for the uda-plugins library produced in this process which should be named with the corresponding access layer version it’s valid for. I think Jonathan set something up to achieve this a couple of  years ago but I don’t know if it will be executed in the default build. scripts/cmake-itm-marconi.sh seems to install to /gw/swimas/extra/uda/plugins/1.2.0/AL/$AL_VERSION so maybe this already works out of the box

To reiterate there is no run-time dependency on the data-dictionary (only access layer), but where mapping files exist I don’t think they have been updated since 3.28 or similar. Just to say that I don’t think the plugin version control tracks the DD version they are consistent with in any way. This means that we can compile today against 3.32 or whatever version we are at, (and the code will run without seg faulting or stack smashing or other library-mismatch errors you may see) but the data retrieval will fail as the mappings do not yet comply with the latest DD updates. Procedurally, perhaps there should be a step to confirm DD compliance of the mappings at each release too.

UDA

Dependencies

UDA is completely DD & AL independent.

A common uda server can be used for all imas IMAS versions to date and the imas IMAS backend calls this in fat mode. I don’t know if this fat-mode configuration is subject to change. There is a dependency of some of the mapping plugins on the imas library (I think both imas_mapping and exp2imas also do depend on it too), but the result is that the uda plugins library needs to be recompiled for every new access layer version deployed. 

Installation

...

* UDA-plugins is IMAS LL dependent

There is no run-time dependency on the data-dictionary (only access layer), only on mapping files, that should be consistent with DD version. The inconsistency will not cause any runtime errors (crash etc) but the data retrieval will fail as the mappings do not yet comply with the latest DD updates. Procedurally, perhaps there should be a step to confirm DD compliance of the mappings at each release too.

The UDA plugin required for remote IMAS access (IMAS_REMOTE,  IMAS_PARTIAL, etc.) is currently compiled against the IMAS lowlevel library and so will need to be recompiled if the library .so version changes. It should be DD independent though. The other plugins (IMAS_MAPPING, EXP2IMAS, etc.) are DD & AL independent.

...

- Plugins should be independent of UDA version. There was a renaming of a variable in the server between 2.4.1 and 2.5.0 which has unfortunately meant plugins need to be tweaked to compile against the new version, but we try to avoid this.

* Are UDA-plugins bound to specific version of IMAS? (I see module load IMAS/3.24.0/AL/4.1.5 in 'marconi' script)?

 * Should module files be created manually?

- When you install UDA it should create a modulefiles directory.

In addition to the basic installation steps I believe a new module-file should be produced for the uda-plugins library produced in this process which should be named with the corresponding access layer version it’s valid for. I think Jonathan set something up to achieve this a couple of  years ago but I don’t know if it will be executed in the default build. scripts/cmake-itm-marconi.sh seems to install to /gw/swimas/extra/uda/plugins/1.2.0/AL/$AL_VERSION so maybe this already works out of the box- Most of the plugins are not bound to IMAS but a few of them (IMAS_REMOTE,  IMAS_PARTIAL, etc.) compile against the IMAS lowlevel so pick up the “so” version of that library (i.e. libimas.so.3)

1. Cloning repository
   1. git clone ssh://git@git.iter.org/imas/uda-plugins.git
   2. cd uda-plugins
   3. git checkout tags/<tag numer>
2. Building

...