The basic requirements and restrictions for running any model with MPI were discussed under MPI on a Single Machine. This page focuses only on setting up the cluster option, which allows a model to be run across multiple computers simultaneously. This option requires a master PC main node where the model is set to run and any number of slave PCsworker nodes. The configuration of this kind of system is relatively complicated and will likely require the support of an IT administrator. The setup requirements are described below. Guiding principles for domain decomposition for running MPI are also provided here.
1. Requirements for All Computers on a Cluster (
...
Main &
...
Worker Nodes)
Connect all computers running a Windows OS (best if they all have the same operating system, e.g. Windows 10 build 1809) with a Local Area Network (LAN).
It is recommended that all the computers in the cluster have been logged in with the same Administrator account and password. The user can create the new user to have the same username for all PCs.
Install Intel MPI Library for Windows which is available from this link. The user must install the same version of the library on all machines.
Open the Command Prompt with administrator permissions (run as Administrator) and use the following commands to determine the usernames and domain names of the computers
...
Set the same name for hard disks of the master main and slave worker nodes (PCs). It is required that the hard disk drive of the master PC main node and the slave PCs worker nodes be the same ( e.g C, E, D). For example, in the master PCmain node, the MPI model is located in E drive, then all slave PCs worker nodes must use the E drive.
Firewall requirements. It is recommended to disable the firewall for guest/public networks.
2. Configuration for
...
Main Node
Share the working directory (for example: "MPI_Model" is the folder containing the MPI model to be run, so the working directory in the master PC main node will be "E:\EFDC_Explorer Modeling System\Testing\EFDC\MPI_Model")
Share the installed folder of EEMS (contains EFDC+ MPI exe). For example, copy the EFDC+ MPI exe folder to the shared folder containing the model. Figure 1 show steps to share folders.
Anchor EFDC EFDC
...
Figure 1 Share working directory from the Master PC Main Node (1).
3. Configuration for
...
Worker Computers
On the master computer main node the folder "MPI_Model" is shared, to check whether the model folder ("MPI_Model") is shared or not, the user can paste the directory path (\\Master-Domain-name\shared folder name) to Windows Explorer on the slave worker computer (in this example it is "\\DSI-D03\MPI_Model"). If the folders are displayed the connection is established. Figure 2 shows that folders inside the shared folder "MPI_Model" on the slave worker computer can be seen.
...
Figure 2 Share working directory from the Master PC Main Node (2).
Create the same directory structure on the slave worker computer.
In this example the model folder on the master PC main node is "E:\EFDC_Explorer Modeling System\Testing\EFDC\MPI_Model" so the user should create a folder path as "E:\EFDC_Explorer Modeling System\Testing\EFDC\" on the slave worker computers. Note that there no need to create the folder name "MPI_Model", otherwise the next steps will have an error.
Open Command Prompt using the administrator permissions (see Figure 3) and use the following commands to link the shared folder between the master computer main node and the salve computersworker nodes.
General case: Mklink /d "Working-Directory" "Shared-Directory"
In this example: mklink /d "E:\EFDC_Explorer Modeling System\Testing\EFDC\MPI_Model" "\\DSI-D03\MPI_Model"
...
In the List of Computer Nodes table type computer names (including the master main and slave PCsworker nodes) in the Computer column. It is recommended to put name of the master PC main node on the first row and slave PCs worker nodes in the following rows (see Figure 7). Another option is to put the IP address of the PCs. Figure 8 shows how to get IP address of the current PC.
In the Slots column, the user can manage the number of subdomains to be assigned to each computer. For example, this model has 8 MPI subdomains, in which two subdomains are assigned to run on the master computermain node, and six subdomains on the slave worker computer (see Figure 7).
Click on the Ping button on the Check column to verify that the connection is established between computers on the local network . Ping is the reaction time of your connection–how fast you get a response after you have sent out a request. A fast ping means a more responsive connection. It will show “Failed” if not connected.
Click Save button to save out the Host file (hostfile.txt). The Host file contains information on the configuration including the list of computer nodes (see Figure 9). Next time the user wants to rerun the model, the Host file can be used by clicking Load button.
Finally, click Run EFDC+ button to run the model. Figure 10 shows the EFDC+ MPI window running and show number of cores using in the master main and slave worker computers
...
Figure 7 EFDC+ Run Options: MPI Cluster tab.
...