xref: /inferno-os/doc/gridinstall.ms (revision 46439007cf417cbd9ac8049bb4122c890097a0fa)
1.FP palatino
2.TL
3Installing the Vita Nuova grid software
4.AU
5Vita Nuova
6.br
75 May 2005
8.NH 1
9Package contents
10.LP
11The installation CD contains software for  both grid client and the server (scheduler),
12in separate directories in the root directory of the CD:
13.B client
14and
15.B server .
16.NH 1
17Client software
18.LP
19The grid client software will be installed on Windows NT4/2000/XP machines,
20in the directory (folder)
21.CW C:\eVNClient .
22.IP 1.
23On a Windows machine with the CD loaded,
24use Windows Explorer (or equivalent) to move to the directory named
25.CW \eclient\einstall
26on the CD.
27.IP 2.
28Double-click
29.CW setup.exe
30in that directory.
31It will display a new window that prompts for a destination directory.
32The directory need not exist but if it does, it should be empty.
33The default should be
34.CW C:\eVNClient .
35You can change the name if required (eg, because
36.CW C:
37lacks space), but
38you will then need to edit several files, as discussed below,
39and make appropriate changes to the instructions below.
40Hit the
41.SM ENTER
42key to start installation.
43The program will prompt for permission to create the directory if it does not already exist.
44It will then populate it with all files required by the client.
45.IP 3.
46Move in Explorer to the directory
47.CW C:\eVNClient\egrid\eslave .
48Check that the file
49.CW schedaddr
50contains the right address for your scheduler machine.
51If you changed the drive letter, you must also change the
52four
53.CW .bat
54files in the directory to replace the
55.CW C:
56drive letter by the one you used.
57.IP 4.
58You can now add the grid client as a Windows service by running the appropriate
59.CW .bat
60file on the client.
61Use
62.RS
63.IP
64\f5install_service.bat\fP
65for Windows 2000 and Windows XP
66.IP \fIOR\fP
67\f5install_service_nt4.bat\fP
68for Windows NT4
69.LP
70Just double-clicking in Explorer on the chosen name should install the service.
71.RE
72.LP
73Once installed as a service the client software will start automatically when
74the client machine next boots.
75You can start it manually using the Windows Services Manager in the usual way.
76There are two
77.CW .bat
78files to remove the service (when desired): \f5remove_service.bat\fP
79for 2000/XP and \f5remove_service_nt4.bat\fP for NT4.
80.LP
81The manual page
82.I scheduler-intro (1)
83in the PDF file
84.CW \escheduler.pdf
85on the CD gives more details on running and configuring the client software.
86The manual page
87.I scheduler-monitor (1)
88in the same PDF file describes the use of the Client Monitor software.
89.LP
90On Windows machines you can remove the directory
91.CW C:\eVNClient\eLinux
92to reduce the space required on Windows clients.
93.NH 1
94Server software
95.LP
96The grid server software will be installed on Linux (Redhat 8 or 9), in the directory
97.CW /grid/inferno ,
98which should either not exist or be empty.
99.LP
100Linux will usually mount the CD at
101.CW /mnt/cdrom .
102.IP 1.
103In a shell (`New Terminal') window, type the following command:
104.P1
105sh /mnt/cdrom/server/install/Linux-grid-386.sh
106.P2
107Assuming it has permission to do so, it will populate
108.CW /grid/inferno
109with the Inferno distribution, including the grid scheduler components.
110.IP 2.
111The file
112.CW /mnt/cdrom/server/install/gridsched.sh
113contains a Bourne shell script that can be copied to an appropriate
114place on your system, or used as the basis for one of your own,
115to simplify starting the scheduler.
116In particular it sets the right bin directory in
117.CW PATH
118to find Inferno's
119.I emu ,
120and starts
121.I emu
122with the right parameters to find the
123.CW /grid/inferno
124directory and start the scheduler in the right environment.
125.LP
126Now check that
127.CW /grid/inferno/grid/master/config
128contains the right network address for your scheduler.
129The manual pages
130.I scheduler-intro (1)
131and
132.I scheduler (1)
133in
134.CW scheduler.pdf
135on the CD give more details on invoking the scheduler in
136different ways.
137