File: README

package info (click to toggle)
rpvm 0.6.2-2
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 440 kB
  • ctags: 90
  • sloc: ansic: 1,075; sh: 57; makefile: 12
file content (78 lines) | stat: -rw-r--r-- 3,041 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
"rpvm" is an R package providing interface to PVM (Parallel Virtual Machine).

Copywright (2001) Na (Michael) Li <nali@umn.edu> and 
A. J. Rossini <rossini@u.washington.edu>.

=============================================================================
NOTICE
=============================================================================

rpvm is free software; you can redistribute  it and/or modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2, or (at your option) any later
version.

rpvm is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
for more details.
    
A copy of the GNU General Public License is available on the World Wide
Web at http://www.gnu.org/copyleft/gpl.html.  You can also obtain it by
writing to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge,
MA 02139, USA.

=============================================================================
DEPENDENCE
=============================================================================

rpvm depends on R version 1.8.0 or higher and PVM 3.4.3.  Optionally rsprng.
    
=============================================================================
INSTALLATION:
=============================================================================

1.  Install pvm 3.4.3 (http://www.netlib.org/pvm3/pvm.3.4.3.tgz) and set
    environment variable PVM_ROOT to the directory pvm is installed.
    See pvm documentation for details.

    Binary distributions of pvm are available for some platforms (rpm for
    Redhat Linux, deb for Debian GNU/Linux, etc.).

    You need install pvm for each host you want to include in the virtual
    machine.

2.  Install rpvm

    R INSTALL rpvm_version.tgz.

    You need install rpvm for each host.

    If PVM_ROOT is not set, the configure script will try to look for
    first /usr/lib/pvm3/ then $HOME/pvm3/ and stop if none exists.

3.  Install slaveR.sh

    You need copy the script 'slaveR.sh' (under $R_LIBS/rpvm) to somewhere
    pvmd can find on each host.  The easiest way is:

    cp $R_LIBS/rpvm/slaveR.sh $PVM_ROOT/bin/$PVM_ARCH

4.  Try run 'demo (helloR)' in R.

=============================================================================
TEST:
=============================================================================

The examples in the Rd files are "dummy" examples in that

R CMD check rpvm

won't actually run those examples.  However, there are two scripts in tests
dir which should run successfully if pvm has been installed properly.

Caveat: To be able to run the test successfully, the local host shouldn't be
part of a already running VM (since rpvm may not be installed on other hosts).
After the test, pvmd is left running on the local host (attempts to shut down
the VM with .PVM.halt() in the test R script will abruptly shutdown R itself
and resulted in error exit).