modify some setup details and add ++local simpler way to start charm program.
[charm.git] / README.cygwin
1 Now you can compile charm++ under Windows9x/2000/NT with Cygwin.
2 Note: This version of cygwin is still under testing.
3
4 To compile charm on cygwin:
5 1. install cygwin from: http://sourceware.cygnus.com/cygwin
6    with inetutils, openssh and w32api packages. 
7
8 2. before compiling, make sure you have /bin/sh correctly installed, otherwise
9    make a link from /bin/bash:  ln -s /bin/bash.exe /bin/sh.exe
10    compile charm++:    ./build charm++ net-cygwin
11
12 3. setting up running environment:
13    There are several ways to do this, using rsh or ssh. 
14    Under Windows2000/NT, ssh is recommended, I once had difficulty to have 
15    inetd working.
16    Starting from Charm++ <version>, you no long need rshd or sshd to start
17    charm program on local machine. This is for testing purpose though, for 
18    best performance, launch one process per processor with daemons.
19
20  ** RSH **
21    setup /etc/inetd.conf and /etc/services to start rshd, 
22    Here is an example of /etc/inetd.conf:
23
24 ###
25 shell stream tcp nowait.1000  root /usr/sbin/in.rshd  in.rshd
26 ###
27
28    and an example of /etc/services:
29
30 ###   
31 shell     514/tcp    cmd
32 ###
33
34    before running charm program, start 'inetd' first to get rshd running.
35
36  ** SSH **
37    Check /etc/passwd, make sure your home directory is correct.
38    run "/usr/bin/ssh-config" to setup all ssh config files.
39    Setup ~/.shosts, or add your public key to your ~/.ssh/authorized_keys to 
40    login without password authentication.
41    now you can start sshd and run charm programs.
42
43  ** run only on local machine **
44      This allow a user to run charm program on his desktop machine for testing 
45    purpose without the hassle of setting up rsh deamons. To launch a charm++
46    program on your local machine, use "++local" option via:
47   
48      charmrun +p4 ++local pgm
49