The executable ecflow_server is used to start an ecflow_server using the default port number or that defined by the environment variable ECF_PORT.
cd ECF_dir1 nohup ecflow_server & # start ecFlow with default port 3141
Multiple ECFs can be run on the same host using different port numbers. There are two mechanisms for specifying the port number:
- Using arguments on the command line. i.e. ecflow_server --port=3141
- Using the Environment variable. ECF_PORT
If both are specified the command line argument takes precedence
cd ../ECF_dir2 ecflow_server –-port=3142& # start ecFlow with port number 3142 cd ../ECF_dir3 export ECF_PORT=3143 ecflow_server & # starts ecFlow with port number 3143
Note: the ECFs are started in different directories so that the output and checkpoint files are not overwritten
Adding a new server to ecflow_ui adds the definition to the file ~/.ecflowrc/servers. This can be modified directly.
You cannot start two ecFlow servers on the same machine with the same port number. To simplify users wanting their own ecFlow servers we have a script ecflow_start.sh that sets up an ecFlow server using a port number based on the users own unique user ID
You can check what port numbers are being used, with netstat: To list all open network ports on your machine, run netstat -lnptu.
Here is a breakdown of the parameters:
- l - List all listening ports
- n - Display the numeric IP addresses (i.e., don't do reverse DNS lookups
- p - List the process name that is attached to that port
- t - List all TCP connections
- u - List all UDP connections
Figure 7 1 Viewing new ECFLOW servers with ecflow_ui
When using non-default ecFlow servers, ecflow_ui needs to be configured to recognise the port used. Opening the edit-preferences under ecflow_ui and selecting the servers tab you can describe your new ecFlow server to ecflow_ui.
Adding a new server to ecflow_ui adds the definition to the file ~/.xecfrc/servers. This can be modified directly.
It is a good idea to use a startup script that automatically sets up a unique port number.