do not detect the failure on node 0 when load balancing is undergoing
[charm.git] / README.cygwin
index 83257cba220e10de0fa62545ceca0f4f5a48ba4e..8d4e24de9410123148ebfd107a955c606e2162c2 100644 (file)
@@ -2,7 +2,11 @@
 
        Copyright (C) 1989-2000 Regents of the University of Illinois
 
 
        Copyright (C) 1989-2000 Regents of the University of Illinois
 
-Now you can compile charm++ under Windows9x/2000/NT with Cygwin.
+Now you can compile charm++ under Windows9x/2000/NT/XP with Cygwin using its 
+GNU compiler. The generated executables require cygwin1.dll, and have to run
+under cygwin environment. To build Charm++ program that do not depend on 
+Cygwin DLL and only depend on runtime libraries distributed as part of the 
+OS (Win9x/NT), one needs to compile Charm++ using Mingw.
 Note: This version of cygwin is still under testing.
 Check the FAQ at end of this file for more help.
 
 Note: This version of cygwin is still under testing.
 Check the FAQ at end of this file for more help.
 
@@ -11,15 +15,16 @@ Check the FAQ at end of this file for more help.
                     ===========================
 
 To compile charm on cygwin:
                     ===========================
 
 To compile charm on cygwin:
-1. install cygwin from: http://sourceware.cygnus.com/cygwin
-   with inetutils, openssh, w32api packages and gcc of course. Remember to
+1. install cygwin from: http://www.cygwin.com/mirrors.html
+   download inetutils, openssh, w32api packages and gcc of course. Remember to
    choose default file type as "unix" at the beginning of cygwin installation.
 
 2. before compiling, make sure you have /bin/sh correctly installed, otherwise
    make a link from /bin/bash.exe:  ln -s /bin/bash.exe /bin/sh.exe
    choose default file type as "unix" at the beginning of cygwin installation.
 
 2. before compiling, make sure you have /bin/sh correctly installed, otherwise
    make a link from /bin/bash.exe:  ln -s /bin/bash.exe /bin/sh.exe
-   compile charm++:    ./build charm++ net-cygwin
+   compile charm++:    
+     ./build charm++ net-cygwin
 
 
-3. setting up running environment:
+3. set up environment:
      There are several ways to do this, using rsh or ssh. 
    Under Windows2000/NT, ssh is recommended, I once had difficulty to have 
    inetd working.
      There are several ways to do this, using rsh or ssh. 
    Under Windows2000/NT, ssh is recommended, I once had difficulty to have 
    inetd working.
@@ -56,9 +61,13 @@ shell     514/tcp    cmd
    for the first time to generate global config files and server keys; and 
    run /usr/bin/ssh-user-config creates the private and public keys for a user.
    You may need to modify /etc/sshd_config or /etc/ssh_config for your needs.
    for the first time to generate global config files and server keys; and 
    run /usr/bin/ssh-user-config creates the private and public keys for a user.
    You may need to modify /etc/sshd_config or /etc/ssh_config for your needs.
+   
      Setup ~/.shosts, or add your public key to your ~/.ssh/authorized_keys to 
      Setup ~/.shosts, or add your public key to your ~/.ssh/authorized_keys to 
-   allow you to login without password authentication.
-   now you can start sshd and run charm programs. To tell Charmrun to use ssh
+   allow you to login without password authentication. You can test if your
+   setting works by:   
+       ssh localhost date
+   
+   Now you can start sshd and run charm programs. To tell Charmrun to use ssh
    instead of rsh(default), you need to add ++shell option in ~/.nodelist file:
 
 group main ++shell /bin/ssh
    instead of rsh(default), you need to add ++shell option in ~/.nodelist file:
 
 group main ++shell /bin/ssh
@@ -79,7 +88,7 @@ host localhost
    This will run only one copy of program locally.
 
 4. If you have any problem with it, please check the FAQ below for help.
    This will run only one copy of program locally.
 
 4. If you have any problem with it, please check the FAQ below for help.
-   Let me know if it works or not by sending email to (ppl@uiuc.edu).
+   Let me know if it works or not by sending email to (charm@cs.illinois.edu).
 
 
 
 
 
 
@@ -100,7 +109,7 @@ host localhost
    (It may not be the latest stable version though)
    1. login the cvs server:
 
    (It may not be the latest stable version though)
    1. login the cvs server:
 
-      cvs -d :pserver:checkout@thrift.cs.uiuc.edu:/expand6/cvsroot login
+      cvs -d :pserver:checkout@thrift.cs.illinois.edu:/expand6/cvsroot login
 
       when CVS passwd is prompted, just type <Enter>.
    2. checkout charm
 
       when CVS passwd is prompted, just type <Enter>.
    2. checkout charm
@@ -112,6 +121,23 @@ host localhost
 
       cvs logout
 
 
       cvs logout
 
+ * How to compile Charm++ executable using Mingw?
+
+   Make sure mingw-runtime is installed using Cygwin setup program. 
+
+   Download "MinGW API for MS-Windows" from mingw website: 
+      http://www.mingw.org/download.shtml 
+   The downloaded file should be named as w32api-3.11.tar.gz.
+   Install the file under /usr/local/mingw
+
+   Now build charm++ with "mingw" option:
+     ./build charm++ net-cygwin mingw
+
+   One can then compile Charm++ application using mingw support and run 
+   applications outside of Cygwin. However, note that one can not use 
+   ssh mode in charmrun to start a parallel job. Instead, use charmd which 
+   is a daemon process that listen charm command and start processes.
+
  * Problem: Charm++ build script stops when it compile "ckfutures.ci", with 
    error message: "Syntax error at line 1: parse error"
 
  * Problem: Charm++ build script stops when it compile "ckfutures.ci", with 
    error message: "Syntax error at line 1: parse error"