All communication with the ecflow_server is done with ecflow_client
For any communication with the server, the client needs to know the machine
where the server is running and the port on the server. There can be multiple
servers running on the same machine, each with unique port numbers.
This tutorial will show examples of using the client via the shell and in a Python script.
Client Shell Interface¶
For a full list of available commands type:
> ecflow_client --helpDefault host and port is localhost:3141
These defaults are overridden by ECF_NODE and ECF_PORT environment variables
- This can be further overridden by using –port and –host optionsand can be used for any of shell level command shown with –help option.For example to ping a server on the command line we can use:
>
...
ecflow_client --ping --host=machineX --port=
...
4141
Client Python Interface¶
The python interface uses the same algorithm for determining the host and port,
and allows the host and port to be set explicitly. See class ecflow.Client
This is shown by the following python example:
#!/usr/bin/env python2....
7
...
import ecflow
...
try:
...
# When no arguments specified uses ECF_NODE and/or ECF_PORT,...
...
# otherwise defaults to localhost:...
3141
...
ci ...
=...
ecflow.Client()
...
ci.ping()
...
# Explicitly set host and port using the same ...
client
...
# For alternative argument list see ecflow.Client.set_host_port() ...
...
ci.set_host_port("machineX:4141")
ci.ping()
...
# Create a new client, Explicitly setting host and port....
...
# For alternative argument list see ecflow....
Client
...
ci = ecflow.Client("oetzi:3444")
...
ci.ping()
...
except RuntimeError, e:
...
print "ping failed: ...
" + str(e);
What to do:
interface, then set ECF_NODE and ECF_PORT environment variables.
It should be noted that, if the server was started with ecf_start.sh script
on your local machine, use netstat to determine the port number.
> netstat -lnptu