Overview #

This section introduces the configuration of the MPI environment.

SimWorks Finite Difference Solutions currently supports three parallel computing approaches: Open MPI, Intel MPI, and Microsoft MPI, enabling users to efficiently execute large-scale parallel simulations.

MPI Environment Configuration #

When configuring the parallel environment, please be sure to adhere to the following:

• The same version of MPI must be installed and configured on all nodes.

• The same local user account should be used to access each node.

• The software must be installed in the same directory path across all nodes.

• If using CUDA-aware Open MPI, ensure that the GPU driver and CUDA version are compatible.

After completing the configuration of Remote resources, it is recommended to use the Resource Test function to verify whether the resources are functioning properly.

Open MPI #

This section provides a brief introduction to configuring Open MPI on Linux systems. Open MPI supports CUDA-aware functionality, and users should ensure that the GPUs on the nodes meet the relevant configuration requirements. For more details, refer to the CUDA-aware documentation and Open MPI installation guide.

1. Install Open MPI

2. Extract and Install the Software AppImage

• Grant executable permissions to the AppImage file (replace with the current version):

chmod +x ./SimWorks_FD_Solutions-v****.AppImage

• Extract the AppImage file, which will generate a squashfs-root folder:

./SimWorks_FD_Solutions-v****.AppImage --appimage-extract

• Move the extracted contents to /opt/simworks/fd_solutions:

sudo mv squashfs-root /opt/simworks/fd_solutions

3. Update Executable Settings

In the Resources configuration, set the Executable Settings / custom executable directory to:

/opt/simworks/fd_solutions/usr/bin/

Intel MPI #

This section provides a brief introduction to configuring Intel MPI on Windows systems.

1. Download and Install Intel MPI

Download Intel MPI from the Intel MPI and install it.

2. Update Environment Variables

Add the installation path (e.g., C:\Program Files (x86)\Intel\oneAPI\mpi\latest\opt\mpi\libfabric\bin) to the Path environment variable. After updating the environment variable, restart the software or command prompt.

3. Enable WinRM Service

• Open the Services window by searching for "Services" in the Start menu or pressing Win + R and entering services.msc.
• Check if the Windows Remote Management (WS-Management) service is running. If it is running, skip this step.
• If the service is not running, start it manually or run the following command in PowerShell as an administrator:

Enable-PSRemoting -Force

• After execution, return to the Services window to verify the service status.

4. Configure Trusted IP

• Press Win + R on the keyboard, enter gpedit.msc to open the Local Group Policy Editor.
• Navigate to:
  Computer Configuration $\rightarrow$ Administrative Templates $\rightarrow$ Windows Components $\rightarrow$ Windows Remote Management (WinRM) $\rightarrow$ WinRM Client $\rightarrow$ Trusted Hosts.
• Enable the policy and add the IP addresses of the remote nodes to the TrustedHostsList.
• In the command line (PowerShell), enter the following command. The IP address can also be replaced with the corresponding hostname. Finally, enter the appropriate account credentials. Press Enter and fill in the login information to confirm whether the remote connection is successful. If the connection is successful, the configuration is complete:

Enter-PSSession -ComputerName 127.0.0.1 -Credential ***

Microsoft MPI #

This section provides a brief introduction to configuring Microsoft MPI on Windows systems.

1. Download and Install Microsoft MPI

Download the msmpisetup.exe installer from the Microsoft MPI and install it.

2. Start MS-MPI Service

• Run the msmpisetup.exe installer.
• Open the Services window and check the status of the MS-MPI Launch Service. If it is not running, start it manually or set it to start automatically.

3. Configure Authentication

Open the command prompt and run the following command. Replace the IP address with the hostname. Follow the prompts to complete the authentication setup. If the output displays Hello, the configuration is successful:

"C:\Program Files\Microsoft MPI\Bin\mpiexec.exe" -n 2 -host 127.0.0.1 cmd /c echo Hello