35a0cbbb28122301749bab97b678a2f11e47ed2a
[bootmanager.git] / source / steps / ReadNodeConfiguration.py
1 # Copyright (c) 2003 Intel Corporation
2 # All rights reserved.
3
4 # Redistribution and use in source and binary forms, with or without
5 # modification, are permitted provided that the following conditions are
6 # met:
7
8 #     * Redistributions of source code must retain the above copyright
9 #       notice, this list of conditions and the following disclaimer.
10
11 #     * Redistributions in binary form must reproduce the above
12 #       copyright notice, this list of conditions and the following
13 #       disclaimer in the documentation and/or other materials provided
14 #       with the distribution.
15
16 #     * Neither the name of the Intel Corporation nor the names of its
17 #       contributors may be used to endorse or promote products derived
18 #       from this software without specific prior written permission.
19
20 # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
21 # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22 # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
23 # A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE INTEL OR
24 # CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
25 # EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
26 # PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
27 # PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
28 # LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
29 # NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
30 # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31
32 # EXPORT LAWS: THIS LICENSE ADDS NO RESTRICTIONS TO THE EXPORT LAWS OF
33 # YOUR JURISDICTION. It is licensee's responsibility to comply with any
34 # export regulations applicable in licensee's jurisdiction. Under
35 # CURRENT (May 2000) U.S. export regulations this software is eligible
36 # for export from the U.S. and can be downloaded by or otherwise
37 # exported or reexported worldwide EXCEPT to U.S. embargoed destinations
38 # which include Cuba, Iraq, Libya, North Korea, Iran, Syria, Sudan,
39 # Afghanistan and any other country to which the U.S. has embargoed
40 # goods and services.
41
42
43 import sys, os, traceback
44 import string
45 import socket
46 import re
47
48 import utils
49 from Exceptions import *
50 import BootServerRequest
51 import BootAPI
52 import StartDebug
53 import notify_messages
54 import UpdateBootStateWithPLC
55
56
57 # two possible names of the configuration files
58 NEW_CONF_FILE_NAME= "plnode.txt"
59 OLD_CONF_FILE_NAME= "planet.cnf"
60
61
62 def Run( vars, log ):   
63     """
64     read the machines node configuration file, which contains
65     the node key and the node_id for this machine.
66     
67     these files can exist in several different locations with
68     several different names. Below is the search order:
69
70     filename      floppy   flash    cd
71     plnode.txt      1        2      4 (/usr/boot), 5 (/usr)
72     planet.cnf      3
73
74     The locations will be searched in the above order, plnode.txt
75     will be checked first, then planet.cnf. Flash devices will only
76     be searched on 3.0 cds.
77
78     Because some of the earlier
79     boot cds don't validate the configuration file (which results
80     in a file named /tmp/planet-clean.cnf), and some do, lets
81     bypass this, and mount and attempt to read in the conf
82     file ourselves. If it doesn't exist, we cannot continue, and a
83     BootManagerException will be raised. If the configuration file is found
84     and read, return 1.
85
86     Expect the following variables from the store:
87     BOOT_CD_VERSION          A tuple of the current bootcd version
88     SUPPORT_FILE_DIR         directory on the boot servers containing
89                              scripts and support files
90     
91     Sets the following variables from the configuration file:
92     WAS_NODE_ID_IN_CONF         Set to 1 if the node id was in the conf file
93     WAS_NODE_KEY_IN_CONF         Set to 1 if the node key was in the conf file
94     NONE_ID                     The db node_id for this machine
95     NODE_KEY                    The key for this node
96     NETWORK_SETTINGS            A dictionary of the values from the network
97                                 configuration file. keys set:
98                                    method
99                                    ip        
100                                    mac       
101                                    gateway   
102                                    network   
103                                    broadcast 
104                                    netmask   
105                                    dns1      
106                                    dns2      
107                                    hostname  
108                                    domainname
109
110     the mac address is read from the machine unless it exists in the
111     configuration file.
112     """
113
114     log.write( "\n\nStep: Reading node configuration file.\n" )
115
116
117     # make sure we have the variables we need
118     try:
119         BOOT_CD_VERSION= vars["BOOT_CD_VERSION"]
120         if BOOT_CD_VERSION == "":
121             raise ValueError, "BOOT_CD_VERSION"
122
123         SUPPORT_FILE_DIR= vars["SUPPORT_FILE_DIR"]
124         if SUPPORT_FILE_DIR == None:
125             raise ValueError, "SUPPORT_FILE_DIR"
126
127     except KeyError, var:
128         raise BootManagerException, "Missing variable in vars: %s\n" % var
129     except ValueError, var:
130         raise BootManagerException, "Variable in vars, shouldn't be: %s\n" % var
131
132
133     NETWORK_SETTINGS= {}
134     NETWORK_SETTINGS['method']= "dhcp"
135     NETWORK_SETTINGS['ip']= ""
136     NETWORK_SETTINGS['mac']= ""
137     NETWORK_SETTINGS['gateway']= ""
138     NETWORK_SETTINGS['network']= ""
139     NETWORK_SETTINGS['broadcast']= ""
140     NETWORK_SETTINGS['netmask']= ""
141     NETWORK_SETTINGS['dns1']= ""
142     NETWORK_SETTINGS['dns2']= ""
143     NETWORK_SETTINGS['hostname']= "localhost"
144     NETWORK_SETTINGS['domainname']= "localdomain"
145     vars['NETWORK_SETTINGS']= NETWORK_SETTINGS
146
147     vars['NODE_ID']= 0
148     vars['NODE_KEY']= ""
149
150     vars['WAS_NODE_ID_IN_CONF']= 0
151     vars['WAS_NODE_KEY_IN_CONF']= 0
152
153     # for any devices that need to be mounted to get the configuration
154     # file, mount them here.
155     mount_point= "/tmp/conffilemount"
156     utils.makedirs( mount_point )
157
158     old_conf_file_contents= None
159     conf_file_contents= None
160     
161     
162     # 1. check the regular floppy device
163     log.write( "Checking standard floppy disk for plnode.txt file.\n" )
164
165     log.write( "Mounting /dev/fd0 on %s\n" % mount_point )
166     utils.sysexec_noerr( "mount -o ro -t ext2,msdos /dev/fd0 %s " \
167                          % mount_point, log )
168
169     conf_file_path= "%s/%s" % (mount_point,NEW_CONF_FILE_NAME)
170     
171     log.write( "Checking for existence of %s\n" % conf_file_path )
172     if os.access( conf_file_path, os.R_OK ):
173         try:
174             conf_file= file(conf_file_path,"r")
175             conf_file_contents= conf_file.read()
176             conf_file.close()
177             log.write( "Read in contents of file %s\n" % conf_file_path )
178         except IOError, e:
179             log.write( "Unable to read file %s\n" % conf_file_path )
180             pass
181
182         utils.sysexec_noerr( "umount %s" % mount_point, log )
183         if __parse_configuration_file( vars, log, conf_file_contents):
184             return 1
185         else:
186             raise BootManagerException( "Found configuration file plnode.txt " \
187                                         "on floppy, but was unable to parse it." )
188
189
190     # try the old file name, same device. its actually number 3 on the search
191     # order, but do it now to save mounting/unmounting the disk twice.
192     # try to parse it later...
193     conf_file_path= "%s/%s" % (mount_point,OLD_CONF_FILE_NAME)
194
195     log.write( "Checking for existence of %s (used later)\n" % conf_file_path )
196     if os.access( conf_file_path, os.R_OK ):
197         try:
198             old_conf_file= file(conf_file_path,"r")
199             old_conf_file_contents= old_conf_file.read()
200             old_conf_file.close()
201             log.write( "Read in contents of file %s\n" % conf_file_path )
202         except IOError, e:
203             log.write( "Unable to read file %s\n" % conf_file_path )
204             pass
205         
206     utils.sysexec_noerr( "umount %s" % mount_point, log )
207
208
209
210     if BOOT_CD_VERSION[0] == 3:
211         # 2. check flash devices on 3.0 based cds
212         log.write( "Checking flash devices for plnode.txt file.\n" )
213
214         # this is done the same way the 3.0 cds do it, by attempting
215         # to mount and sd*1 devices that are removable
216         devices= os.listdir("/sys/block/")
217
218         for device in devices:
219             if device[:2] != "sd":
220                 log.write( "Skipping non-scsi device %s\n" % device )
221                 continue
222
223             # test removable
224             removable_file_path= "/sys/block/%s/removable" % device
225             try:
226                 removable= int(file(removable_file_path,"r").read().strip())
227             except ValueError, e:
228                 continue
229             except IOError, e:
230                 continue
231
232             if not removable:
233                 log.write( "Skipping non-removable device %s\n" % device )
234                 continue
235
236             log.write( "Checking removable device %s\n" % device )
237
238             partitions= file("/proc/partitions", "r")
239             for line in partitions:
240                 found_file= 0
241                 parsed_file= 0
242                 
243                 if not re.search("%s[0-9]*$" % device, line):
244                     continue
245
246                 try:
247                     # major minor  #blocks  name
248                     parts= string.split(line)
249
250                     # ok, try to mount it and see if we have a conf file.
251                     full_device= "/dev/%s" % parts[3]
252                 except IndexError, e:
253                     log.write( "Incorrect /proc/partitions line:\n%s\n" % line )
254                     continue
255
256                 log.write( "Mounting %s on %s\n" % (full_device,mount_point) )
257                 try:
258                     utils.sysexec( "mount -o ro -t ext2,msdos %s %s" \
259                                    % (full_device,mount_point), log )
260                 except BootManagerException, e:
261                     log.write( "Unable to mount, trying next partition\n" )
262                     continue
263
264                 conf_file_path= "%s/%s" % (mount_point,NEW_CONF_FILE_NAME)
265
266                 log.write( "Checking for existence of %s\n" % conf_file_path )
267                 if os.access( conf_file_path, os.R_OK ):
268                     try:
269                         conf_file= file(conf_file_path,"r")
270                         conf_file_contents= conf_file.read()
271                         conf_file.close()
272                         found_file= 1
273                         log.write( "Read in contents of file %s\n" % \
274                                    conf_file_path )
275
276                         if __parse_configuration_file( vars, log, \
277                                                        conf_file_contents):
278                             parsed_file= 1
279                     except IOError, e:
280                         log.write( "Unable to read file %s\n" % conf_file_path )
281
282                 utils.sysexec_noerr( "umount %s" % mount_point, log )
283                 if found_file:
284                     if parsed_file:
285                         return 1
286                     else:
287                         raise BootManagerException( \
288                             "Found configuration file plnode.txt " \
289                             "on floppy, but was unable to parse it.")
290
291
292             
293     # 3. check standard floppy disk for old file name planet.cnf
294     log.write( "Checking standard floppy disk for planet.cnf file " \
295                "(from earlier.\n" )
296
297     if old_conf_file_contents:
298         if __parse_configuration_file( vars, log, old_conf_file_contents):
299             return 1
300         else:
301             raise BootManagerException( "Found configuration file planet.cnf " \
302                                         "on floppy, but was unable to parse it." )
303
304
305     # 4. check for plnode.txt in /usr/boot (mounted already)
306     log.write( "Checking /usr/boot (cd) for plnode.txt file.\n" )
307     
308     conf_file_path= "/usr/boot/%s" % NEW_CONF_FILE_NAME
309
310     log.write( "Checking for existence of %s\n" % conf_file_path )
311     if os.access(conf_file_path,os.R_OK):
312         try:
313             conf_file= file(conf_file_path,"r")
314             conf_file_contents= conf_file.read()
315             conf_file.close()
316             log.write( "Read in contents of file %s\n" % conf_file_path )
317         except IOError, e:
318             log.write( "Unable to read file %s\n" % conf_file_path )
319             pass
320     
321         if __parse_configuration_file( vars, log, conf_file_contents):            
322             return 1
323         else:
324             raise BootManagerException( "Found configuration file plnode.txt " \
325                                         "in /usr/boot, but was unable to parse it.")
326
327
328
329     # 5. check for plnode.txt in /usr (mounted already)
330     log.write( "Checking /usr (cd) for plnode.txt file.\n" )
331     
332     conf_file_path= "/usr/%s" % NEW_CONF_FILE_NAME
333
334     log.write( "Checking for existence of %s\n" % conf_file_path )
335     if os.access(conf_file_path,os.R_OK):
336         try:
337             conf_file= file(conf_file_path,"r")
338             conf_file_contents= conf_file.read()
339             conf_file.close()
340             log.write( "Read in contents of file %s\n" % conf_file_path )
341         except IOError, e:
342             log.write( "Unable to read file %s\n" % conf_file_path )
343             pass    
344     
345         if __parse_configuration_file( vars, log, conf_file_contents):            
346             return 1
347         else:
348             raise BootManagerException( "Found configuration file plnode.txt " \
349                                         "in /usr, but was unable to parse it.")
350
351
352     raise BootManagerException, "Unable to find and read a node configuration file."
353     
354
355
356
357 def __parse_configuration_file( vars, log, file_contents ):
358     """
359     parse a configuration file, set keys in var NETWORK_SETTINGS
360     in vars (see comment for function ReadNodeConfiguration). this
361     also reads the mac address from the machine if successful parsing
362     of the configuration file is completed.
363     """
364
365     BOOT_CD_VERSION= vars["BOOT_CD_VERSION"]
366     SUPPORT_FILE_DIR= vars["SUPPORT_FILE_DIR"]
367     NETWORK_SETTINGS= vars["NETWORK_SETTINGS"]
368     
369     if file_contents is None:
370         log.write( "__parse_configuration_file called with no file contents\n" )
371         return 0
372     
373     try:
374         line_num= 0
375         for line in file_contents.split("\n"):
376
377             line_num = line_num + 1
378             
379             # if its a comment or a whitespace line, ignore
380             if line[:1] == "#" or string.strip(line) == "":
381                 continue
382
383             # file is setup as name="value" pairs
384             parts= string.split(line,"=")
385             if len(parts) != 2:
386                 log.write( "Invalid line %d in configuration file:\n" % line_num )
387                 log.write( line + "\n" )
388                 return 0
389
390             name= string.strip(parts[0])
391             value= string.strip(parts[1])
392
393             # make sure value starts and ends with
394             # single or double quotes
395             quotes= value[0] + value[len(value)-1]
396             if quotes != "''" and quotes != '""':
397                 log.write( "Invalid line %d in configuration file:\n" % line_num )
398                 log.write( line + "\n" )
399                 return 0
400
401             # get rid of the quotes around the value
402             value= string.strip(value[1:len(value)-1])
403
404             if name == "NODE_ID":
405                 try:
406                     vars['NODE_ID']= int(value)
407                     vars['WAS_NODE_ID_IN_CONF']= 1
408                 except ValueError, e:
409                     log.write( "Non-numeric node_id in configuration file.\n" )
410                     return 0
411
412             if name == "NODE_KEY":
413                 vars['NODE_KEY']= value
414                 vars['WAS_NODE_KEY_IN_CONF']= 1
415
416             if name == "IP_METHOD":
417                 value= string.lower(value)
418                 if value != "static" and value != "dhcp":
419                     log.write( "Invalid IP_METHOD in configuration file:\n" )
420                     log.write( line + "\n" )
421                     return 0
422                 NETWORK_SETTINGS['method']= value.strip()
423
424             if name == "IP_ADDRESS":
425                 NETWORK_SETTINGS['ip']= value.strip()
426
427             if name == "IP_GATEWAY":
428                 NETWORK_SETTINGS['gateway']= value.strip()
429
430             if name == "IP_NETMASK":
431                 NETWORK_SETTINGS['netmask']= value.strip()
432
433             if name == "IP_NETADDR":
434                 NETWORK_SETTINGS['network']= value.strip()
435
436             if name == "IP_BROADCASTADDR":
437                 NETWORK_SETTINGS['broadcast']= value.strip()
438
439             if name == "IP_DNS1":
440                 NETWORK_SETTINGS['dns1']= value.strip()
441
442             if name == "IP_DNS2":
443                 NETWORK_SETTINGS['dns2']= value.strip()
444
445             if name == "HOST_NAME":
446                 NETWORK_SETTINGS['hostname']= string.lower(value)
447
448             if name == "DOMAIN_NAME":
449                 NETWORK_SETTINGS['domainname']= string.lower(value)
450
451             if name == "NET_DEVICE":
452                 NETWORK_SETTINGS['mac']= string.upper(value)
453                 
454
455     except IndexError, e:
456         log.write( "Unable to parse configuration file\n" )
457         return 0
458
459     # now if we are set to dhcp, clear out any fields
460     # that don't make sense
461     if NETWORK_SETTINGS["method"] == "dhcp":
462         NETWORK_SETTINGS["ip"]= ""
463         NETWORK_SETTINGS["gateway"]= ""     
464         NETWORK_SETTINGS["netmask"]= ""
465         NETWORK_SETTINGS["network"]= ""
466         NETWORK_SETTINGS["broadcast"]= ""
467         NETWORK_SETTINGS["dns1"]= ""
468         NETWORK_SETTINGS["dns2"]= ""
469
470     log.write("Successfully read and parsed node configuration file.\n" )
471
472     # if the mac wasn't specified, read it in from the system.
473     if NETWORK_SETTINGS["mac"] == "":
474         device= "eth0"
475         mac_addr= utils.get_mac_from_interface(device)
476
477         if mac_addr is None:
478             log.write( "Could not get mac address for device eth0.\n" )
479             return 0
480
481         NETWORK_SETTINGS["mac"]= string.upper(mac_addr)
482
483         log.write( "Got mac address %s for device %s\n" %
484                    (NETWORK_SETTINGS["mac"],device) )
485         
486
487     # now, if the conf file didn't contain a node id, post the mac address
488     # to plc to get the node_id value
489     if vars['NODE_ID'] is None or vars['NODE_ID'] == 0:
490         log.write( "Configuration file does not contain the node_id value.\n" )
491         log.write( "Querying PLC for node_id.\n" )
492
493         bs_request= BootServerRequest.BootServerRequest()
494         
495         postVars= {"mac_addr" : NETWORK_SETTINGS["mac"]}
496         result= bs_request.DownloadFile( "%s/getnodeid.php" %
497                                          SUPPORT_FILE_DIR,
498                                          None, postVars, 1, 1,
499                                          "/tmp/node_id")
500         if result == 0:
501             log.write( "Unable to make request to get node_id.\n" )
502             return 0
503
504         try:
505             node_id_file= file("/tmp/node_id","r")
506             node_id= string.strip(node_id_file.read())
507             node_id_file.close()
508         except IOError:
509             log.write( "Unable to read node_id from /tmp/node_id\n" )
510             return 0
511
512         try:
513             node_id= int(string.strip(node_id))
514         except ValueError:
515             log.write( "Got node_id from PLC, but not numeric: %s" % str(node_id) )
516             return 0
517
518         if node_id == -1:
519             log.write( "Got node_id, but it returned -1\n\n" )
520
521             log.write( "------------------------------------------------------\n" )
522             log.write( "This indicates that this node could not be identified\n" )
523             log.write( "by PLC. You will need to add the node to your site,\n" )
524             log.write( "and regenerate the network configuration file.\n" )
525             log.write( "See the Technical Contact guide for node setup\n" )
526             log.write( "procedures.\n\n" )
527             log.write( "Boot process canceled until this is completed.\n" )
528             log.write( "------------------------------------------------------\n" )
529             
530             cancel_boot_flag= "/tmp/CANCEL_BOOT"
531             # this will make the initial script stop requesting scripts from PLC
532             utils.sysexec( "touch %s" % cancel_boot_flag, log )
533
534             return 0
535
536         log.write( "Got node_id from PLC: %s\n" % str(node_id) )
537         vars['NODE_ID']= node_id
538
539
540
541     if vars['NODE_KEY'] is None or vars['NODE_KEY'] == "":
542         log.write( "Configuration file does not contain a node_key value.\n" )
543         log.write( "Using boot nonce instead.\n" )
544
545         # 3.x cds stored the file in /tmp/nonce in ascii form, so they
546         # can be read and used directly. 2.x cds stored in the same place
547         # but in binary form, so we need to convert it to ascii the same
548         # way the old boot scripts did so it matches whats in the db
549         # (php uses bin2hex, 
550         if BOOT_CD_VERSION[0] == 2:
551             read_mode= "rb"
552         else:
553             read_mode= "r"
554             
555         try:
556             nonce_file= file("/tmp/nonce",read_mode)
557             nonce= nonce_file.read()
558             nonce_file.close()
559         except IOError:
560             log.write( "Unable to read nonce from /tmp/nonce\n" )
561             return 0
562
563         if BOOT_CD_VERSION[0] == 2:
564             nonce= nonce.encode('hex')
565
566             # there is this nice bug in the php that currently accepts the
567             # nonce for the old scripts, in that if the nonce contains
568             # null chars (2.x cds sent as binary), then
569             # the nonce is truncated. so, do the same here, truncate the nonce
570             # at the first null ('00'). This could leave us with an empty string.
571             nonce_len= len(nonce)
572             for byte_index in range(0,nonce_len,2):
573                 if nonce[byte_index:byte_index+2] == '00':
574                     nonce= nonce[:byte_index]
575                     break
576         else:
577             nonce= string.strip(nonce)
578
579         log.write( "Read nonce, using as key.\n" )
580         vars['NODE_KEY']= nonce
581         
582         
583     # at this point, we've read the network configuration file.
584     # if we were setup using dhcp, get this system's current ip
585     # address and update the vars key ip, because it
586     # is needed for future api calls.
587
588     # at the same time, we can check to make sure that the hostname
589     # in the configuration file matches the ip address. if it fails
590     # notify the owners
591
592     hostname= NETWORK_SETTINGS['hostname'] + "." + \
593               NETWORK_SETTINGS['domainname']
594
595     # set to 0 if any part of the hostname resolution check fails
596     hostname_resolve_ok= 1
597
598     # set to 0 if the above fails, and, we are using dhcp in which
599     # case we don't know the ip of this machine (without having to
600     # parse ifconfig or something). In that case, we won't be able
601     # to make api calls, so printing a message to the screen will
602     # have to suffice.
603     can_make_api_call= 1
604
605     log.write( "Checking that hostname %s resolves\n" % hostname )
606
607     # try a regular dns lookup first
608     try:
609         resolved_node_ip= socket.gethostbyname(hostname)
610     except socket.gaierror, e:
611         hostname_resolve_ok= 0
612         
613
614     if NETWORK_SETTINGS['method'] == "dhcp":
615         if hostname_resolve_ok:
616             NETWORK_SETTINGS['ip']= resolved_node_ip
617             node_ip= resolved_node_ip
618         else:
619             can_make_api_call= 0
620     else:
621         node_ip= NETWORK_SETTINGS['ip']
622
623     # make sure the dns lookup matches what the configuration file says
624     if hostname_resolve_ok:
625         if node_ip != resolved_node_ip:
626             log.write( "Hostname %s does not resolve to %s, but %s:\n" % \
627                        (hostname,node_ip,resolved_node_ip) )
628             hostname_resolve_ok= 0
629         else:
630             log.write( "Hostname %s correctly resolves to %s:\n" %
631                        (hostname,node_ip) )
632
633         
634     vars["NETWORK_SETTINGS"]= NETWORK_SETTINGS
635
636     if not hostname_resolve_ok:
637         log.write( "Hostname does not resolve correctly, will not continue.\n" )
638
639         StartDebug.Run( vars, log )
640
641         if can_make_api_call:
642             log.write( "Notifying contacts of problem.\n" )
643
644             vars['BOOT_STATE']= 'dbg'
645             vars['STATE_CHANGE_NOTIFY']= 1
646             vars['STATE_CHANGE_NOTIFY_MESSAGE']= \
647                                      notify_messages.MSG_HOSTNAME_NOT_RESOLVE
648             
649             UpdateBootStateWithPLC.Run( vars, log )
650                     
651         log.write( "\n\n" )
652         log.write( "The hostname and/or ip in the network configuration\n" )
653         log.write( "file do not resolve and match.\n" )
654         log.write( "Please make sure the hostname set in the network\n" )
655         log.write( "configuration file resolves to the ip also specified\n" )
656         log.write( "there.\n\n" )
657         log.write( "Debug mode is being started on this cd. When the above\n" )
658         log.write( "is corrected, reboot the machine to try again.\n" )
659         
660         raise BootManagerException, \
661               "Configured node hostname does not resolve."
662     
663     return 1