main

::UNATTENDED INSTALLATION:

On each machine do the following:

a) Unzip the archive
b) Run setup.exe -u flags

flags:
Required:
-account domain\username

The launcher will run under this account.  It is recommended that this user be an administrator on the local machine but it isn't required.

-password password
Optional:
-bin, -min, or -src

bin: default, binaries only                                  <= run mpi applications
min: binaries + include files and libraries            <= compile and run mpi applications
src: bin + min + source code and project files  <= compile and run mpi applications and rebuild mpich

-home path
If the path does not exist it will be created.  If this option is not specified, the default path is \mpich

Example:

setup -u -account mcs\ashton -password a$7B%
setup -u -src -account mcs\ashton -password bubba123 -home "c:\Program Files\mpich"

c) Wait for setup to finish and then delete the files unzipped from the package.

Warning:

Setup.exe is not a console application so the command prompt will return immediately but setup will not be finished.  If you watch the task manager you will see the application running for a while.  The CPU usage won't go up very much while it is running because it is I/O bound. When setup finishes you will not know whether or not it succeeded unless you look at the MPICH registry entry under HKLM::SOFTWARE and see if the default value is "Installed".  Also the -np option for MPIRun will not work as expected after using the unattended install.  You will have to use configuration files to launch applications or you will have to set the Hosts value in the registry as explained in step 11.3 of the long manual installation below.

 

::UNATTENDED UNINSTALLATION:

On each machine do the following:

a) Unzip the archive
b) Run setup.exe -u -UnInstall [-KeepSrc]

If you use the -KeepSrc flag then the source code will not be deleted, only the dlls and launcher will be removed.

c) Wait for setup to finish and then delete the files unzipped from the package.

 

::SHORT MANUAL INSTALLATION:

On each machine do the following:

a) unzip the archive
b) run setup.exe
c) follow the wizard selecting 'local host only' on the Location page
d) Run regedit and set the Hosts value in the MPICH key as described in step 11.3 below.

 

::LONG MANUAL INSTALLATION:

  1. Extract the files from the zipped archive.
  2. Create a home directory of your choosing for mpich on each node.
  3. Copy mpich.nt.bin.1.0.exe to the home directory on each node.
  4. Copy mpich.nt.min.1.0.exe to the home directory on each node that you wish to be able to compile mpi applications from.
  5. Copy mpich.nt.src.1.0.exe to the home directory on each node that you wish to contain source code.
  6. Run the three(two or one) self-extracting executables you just copied.
  7. Move the mpich dlls to the system32 directory

    [mpich home directory]\lib\mpich_tcp_shm.dll -> winnt\system32\mpich_tcp_shm.dll
    [mpich home directory]\lib\mpich_tcp_shmd.dll -> winnt\system32\mpich_tcp_shmd.dll
    [mpich home directory]\lib\pmpich_tcp_shm.dll -> winnt\system32\pmpich_tcp_shm.dll
    [mpich home directory]\lib\pmpich_tcp_shmd.dll -> winnt\system32\pmpich_tcp_shmd.dll

  8. Now you have the necessary files on each node.
  9. From the bin subdirectory on each node run the following commands:
    1. MPIJobServer -RegServer
    2. MPILaunchServer -Service
    3. MPISystemServer -RegServer
  10. Repeat the following on each node:
    1. Run DCOMCNFG
    2. Double click MPIJobServer
    3. Select the Identity tab
    4. Select [This user] and fill in the information for a user that the job server can run as.
    5. hit OK twice
  11. Run Regedit (or regedt32) Connect to the registry on each node and do the following:
    1. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\MPICH (This key was created by running MPIJobServer -RegServer)
    2. Add a string value named "Home" and set the value to the directory you created on the node Do not leave a trailing '\' - example: good "c:\mpich", bad "c:\mpich\"
    3. Add a string value named "Hosts" Set this value to a '|' deliminated string of host names where you plan to install mpich excluding the current host
      • Example: If I am going to install on four machines - NodeA, NodeB, NodeC, NodeD
      • On NodeA "Hosts" -> "NodeB|NodeC|NodeD"
      • On NodeB "Hosts" -> "NodeA|NodeC|NodeD"
      • On NodeC "Hosts" -> "NodeA|NodeB|NodeD"
      • On NodeD "Hosts" -> "NodeA|NodeB|NodeC"
    4. Add a string value named "Include" Set this value to a '|' deliminated string of include directories. This should look like the following: "[home]\include|[home]\mpid\nt_tcp|[home]\mpid\ch2|[home]\mpid\util" where [home] is expanded to the home directory you created.
  12. Delete mpich.nt.bin.1.0.exe, mpich.nt.min.1.0.exe and mpich.nt.src.1.0.exe

main
Installation
Compiling an MPI application
MPIRun
Re-Building MPICH.NT
Launcher
Running applications without using the launcher
Subtle configuration options