how-to-start.md

How to Start

Environment

In order to enable DDS environment you need to source the DDS_env.sh script. The script is located in the directory where you installed PoD.

cd [DDS INSTALLATION]
source DDS_env.sh

Server

Use the dds-session command to start/stop/list DDS sessions.

dds-session start

Deploy Agents

In order to deploy agents you can use different DDS plug-ins.

One of the fastest way to deploy DDS is to use the localhost plug-in.

But if you want to use multiple hoists, then the SSH plug-in is the right tool.
When you don't have an RMS or you want to use a Cloud based system or even if you want just to use resources around you, like computers of your colleagues, then the plug-in is the best way to go.

First of all you need to define resources.

Then use `dds-submit`` to deploy DDS agents on the given resources:

dds-submit --rms ssh -c FULL_PATH_TO_YOUR_SSHPLUGIN_RESOURCE_FILE

Check availability of Agents

Using dds-info you can query different kinds of information from DDS. For example you can check how many agents are already online:

dds-info -n

or query more detailed info about agents:

dds-info -l

Activate Topology

Once you get enough online agents, you can activate them. Activation of agents means, that DDS will use the given topology to distribute user tasks across available resources (agents):

dds-topology --activate FULL_PATH_TO_YOUR_TOPOLOGY_FILE

DDS will automatically check whether available resources are actually sufficient to execute the given topology.