2.1. Installation¶
The BDSS, the Workflow Manager and all plugins can be cloned from the Force 2020 github respositories. For the BDSS and Workflow Manager,
git clone https://github.com/force-h2020/force-bdss
git clone https://github.com/force-h2020/force-wfmanager
This tutorial uses the Enthought-Example and Nevergrad plugins as examples,
git clone https://github.com/force-h2020/force-bdss-plugin-enthought-example
git clone https://github.com/force-h2020/force-bdss-plugin-nevergrad
2.1.1. Enthought Deployment Manager¶
The BDSS, the Workflow Manager and plugins must be installed through the Enthought Deployment Manager (EDM), a python virtual environment and package manager. For new users it is worth examining EDM’s documentation.
To install EDM, follow the instructions specific to your operating system ,here.
2.1.2. The Bootstrap Environment¶
Once EDM is installed create a ‘bootstrap’ environment from which you can install the BDSS, Workflow Manager and plugins,
edm install -e bootstrap -y click setuptools
Note that ‘bootstrap’ can be replaced by any name to the same effect. Now you can enter
bootstrap
with,
edm shell -e bootstrap
and your shell prompt is prefixed with (bootstrap)
.
2.1.3. The BDSS Runtime Environment¶
Although repositories (BDSS, etc) are installed from the bootstrap
environment, they are
installed into a separate environment, within which the BDSS and the Workflow Manager will
actually run. Thus this environment has also to be created before installation. To do this
first cd into the cloned force-bdss respository,
~/Force-Project (bootstrap)$ cd force-bdss
and then,
~/Force-Project/force-bdss (bootstrap)$ python -m ci build-env
This creates a environment called force-pyXX
, where XX
refers to the python version that
the environment runs (e.g. force-py36
for python 3.6) . You will now see it in the list of EDM environments,
(bootstrap)$ edm environments list
>> * bootstrap cpython 3.6.9+2 win_x86_64 msvc2015 ~\.edm\envs\bootstrap
>> force-py36 cpython 3.6.9+2 win_x86_64 msvc2015 ~.edm\envs\force-pyXX
To run BDSS from the command line see Using the Command Line.
2.1.4. Repository Installation¶
From the bootstrap
environment (not force-pyXX
!), for each respository in turn,
cd into its directory and then install it with python -m ci install
. i.e.,
~/Force-Project/force-bdss (bootstrap)$ python -m ci install
~/Force-Project/force-bdss (bootstrap)$ cd ../force-wfmanager
~/Force-Project/force-wfmanager (bootstrap)$ python -m ci install
~/Force-Project/force-wfmanager (bootstrap)$ cd ../force-bdss-plugin-enthought-example
~/Force-Project/force-bdss-plugin-enthought-example (edm)$ python -m ci install
~/Force-Project/force-wfmanager (bootstrap)$ cd ../force-bdss-plugin-nevergrad
~/Force-Project/force-bdss-plugin-nevergrad (bootstrap)$ python -m ci install
...etc