VMMC Installation Guide
The Shrimp Project
Department of Computer Science
About this Document
Welcome to VMMC! This document describes how to install the VMMC software on a Windows NT PC cluster.
Users of VMMC are encouraged to join the email list used for VMMC announcements. Join the list to keep up with the latest VMMC developments. To join the email list, send a message firstname.lastname@example.org with "subscribe vmmc-announce email@example.com" in the body of the message. Email traffic is minimal.
We welcome input about this document or VMMC. Please send your comments or questions to
This document is a step-by-step guide to installing the VMMC system software on a Windows NT cluster. Make sure that you are the administrator (or have administrator privileges) for the entire installation process.
Phase 0: Pre-installation Checklist
Installing VMMC on a Windows NT cluster is a little tricky because NT must be configured in a specific way. For example, our test install on new out-of-the-box Dell PCs failed because the Dell's default NT configuration does not allow VMMC to work correctly. We had to reinstall NT (and Service Pack 3) in order for VMMC to work.
Before installing VMMC verify the following:
Phase 1: Set up the installation environment
This phase sets up the installation files in a shared folder. This allows all PCs in the cluster to access them for installation in Phase 2.
DO NOT INSTALL or EXECUTE ANY FILES IN THIS PHASE.
Step 1. Export a network shared folder
Create a temporary install folderc:\temp\vmmcinst. The folder must be exported (shared). To share a folder simply right-click on it in the Windows Explorer and then select "share".
This folder can be created on any machine on the network (PC, file server, etc).
Do not use a VMMC machine for this shared folder (if possible).
WARNING: DO NOT NAME THIS FOLDER "VMMC".
Step 2. Copy the VMMC system installation program
Copy the VMMC system installation program (vmmc_nt_2_0.zip) to the shared folder and unzip it.
Step 3. Download UWIN
Download the AT&T Research's UWIN software fromhttp://www.research.att.com/cgi-bin/access.cgi/as/vt/ext-software/www-ne-license.cgi?table.uwin_beta.binary. Make sure to download both:
The UWIN package provides a UNIX interface for Windows NT. We use it for launching remote applications and scripts within the cluster. More information on UWIN is available at
Step 4. Prepare vmmc-hosts.txt (for VMMC)
The VMMC system needs to know the names of all the machines in the cluster. Edit the file calledvmmc-hosts.txt in the shared folder. Add the name of each machine in the cluster, one per line. This is an sample file for a four node cluster whose machines are named edge, bono, led, and zeppelin:
# this is a sample vmmc-hosts.txt file
Step 5. Prepare .rhosts (for UWIN)
UWIN needs an.rhosts file to determine who is allowed to launch remote commands. Each entry in the .rhosts file specifies a host and userid pair that is allowed access. Access to the cluster machines is grouped into two sets:
A new user account, named
# this is a sample .rhosts file
# each line is: host userid
# cluster nodes with "vmmc" account
# non-cluster hosts and users
Phase 2: Install system software on each node in the cluster
On every node in the cluster you must perform the following three steps. The software for each step is already in the shared folder.
Login as Administrator (or equivalent) for all steps in this phase.
Step 1. Install VMMC system software
Begin the by installing the VMMC system software. Simply executesetup.bat in the shared folder.
Step 2. Install UWIN
Install the UWIN executables, firstuwin_base and then uwin_perl.
Step 3. Reboot
Reboot the node and proceed to the next cluster node.
Phase 3: Acceptance Test
As part of VMMC system installation, we include a two-node test program that measures ping-pong bandwidth and latency for various message sizes. The test program and the script that invokes it reside in the directory%SystemRoot%\VMMC\test. To run the test, do the following:
Phase 4: Install the VMMC SDK and test the cluster
Select a development machine, preferably not a cluster node, and install the VMMC software development kit (vmmc_sdk_2_0.zip). The SDK contains test programs as well as instructions on how to test the cluster.
The VMMC Team