1 #!/usr/bin/env /usr/bin/plcsh
3 # Bootstraps the PLC database with a default administrator account and
4 # a default site, defines default slice attribute types, and
5 # creates/updates default system slices.
7 # Mark Huang <mlhuang@cs.princeton.edu>
8 # Copyright (C) 2006 The Trustees of Princeton University
13 from plc_config import PLCConfiguration
17 cfg = PLCConfiguration()
19 variables = cfg.variables()
21 # Load variables into dictionaries
22 for category_id, (category, variablelist) in variables.iteritems():
23 globals()[category_id] = dict(zip(variablelist.keys(),
24 [variable['value'] for variable in variablelist.values()]))
26 # Create/update the default administrator account (should be
28 admin = { 'person_id': 2,
29 'first_name': "Default",
30 'last_name': "Administrator",
31 'email': plc['root_user'],
32 'password': plc['root_password'] }
33 persons = GetPersons([admin['person_id']])
35 person_id = AddPerson(admin)
36 if person_id != admin['person_id']:
37 # Huh? Someone deleted the account manually from the database.
38 DeletePerson(person_id)
39 raise Exception, "Someone deleted the \"%s %s\" account from the database!" % \
40 (admin['first_name'], admin['last_name'])
41 UpdatePerson(person_id, { 'enabled': True })
43 person_id = persons[0]['person_id']
44 UpdatePerson(person_id, admin)
46 # Create/update the default site (should be site_id 1)
47 if plc_www['port'] == '80':
48 url = "http://" + plc_www['host'] + "/"
49 elif plc_www['port'] == '443':
50 url = "https://" + plc_www['host'] + "/"
52 url = "http://" + plc_www['host'] + ":" + plc_www['port'] + "/"
53 site = { 'site_id': 1,
54 'name': plc['name'] + " Central",
55 'abbreviated_name': plc['name'],
56 'login_base': plc['slice_prefix'],
61 sites = GetSites([site['site_id']])
63 site_id = AddSite(site['name'], site['abbreviated_name'], site['login_base'], site)
64 if site_id != site['site_id']:
66 raise Exception, "Someone deleted the \"%s\" site from the database!" % \
70 # Must call UpdateSite() even after AddSite() to update max_slices
71 site_id = sites[0]['site_id']
72 UpdateSite(site_id, site)
74 # The default administrator account must be associated with a site
76 AddPersonToSite(admin['person_id'], site['site_id'])
77 SetPersonPrimarySite(admin['person_id'], site['site_id'])
79 # Grant admin and PI roles to the default administrator account
80 AddRoleToPerson(10, admin['person_id'])
81 AddRoleToPerson(20, admin['person_id'])
83 # Setup default PlanetLabConf entries
84 default_conf_files = [
87 'source': 'PlanetLabConf/ntp.conf.php',
88 'dest': '/etc/ntp.conf',
89 'file_permissions': '644',
93 'postinstall_cmd': '/etc/rc.d/init.d/ntpd restart',
95 'ignore_cmd_errors': False,
96 'always_update': False},
98 'source': 'PlanetLabConf/ntp/step-tickers.php',
99 'dest': '/etc/ntp/step-tickers',
100 'file_permissions': '644',
101 'file_owner': 'root',
102 'file_group': 'root',
103 'preinstall_cmd': '',
104 'postinstall_cmd': '/etc/rc.d/init.d/ntpd restart',
106 'ignore_cmd_errors': False,
107 'always_update': False},
109 # SSH server configuration
111 'source': 'PlanetLabConf/sshd_config',
112 'dest': '/etc/ssh/sshd_config',
113 'file_permissions': '600',
114 'file_owner': 'root',
115 'file_group': 'root',
116 'preinstall_cmd': '',
117 'postinstall_cmd': '/etc/init.d/sshd restart',
119 'ignore_cmd_errors': False,
120 'always_update': False},
122 # Administrative SSH keys
124 'source': 'PlanetLabConf/keys.php?root',
125 'dest': '/root/.ssh/authorized_keys',
126 'file_permissions': '644',
127 'file_owner': 'root',
128 'file_group': 'root',
129 'preinstall_cmd': '',
130 'postinstall_cmd': '/bin/chmod 700 /root/.ssh',
132 'ignore_cmd_errors': False,
133 'always_update': False},
135 'source': 'PlanetLabConf/keys.php?site_admin',
136 'dest': '/home/site_admin/.ssh/authorized_keys',
137 'file_permissions': '644',
138 'file_owner': 'site_admin',
139 'file_group': 'site_admin',
140 'preinstall_cmd': 'grep -q site_admin /etc/passwd',
141 'postinstall_cmd': '/bin/chmod 700 /home/site_admin/.ssh',
143 'ignore_cmd_errors': False,
144 'always_update': False},
146 'source': 'PlanetLabConf/keys.php?role=admin',
147 'dest': '/home/pl_admin/.ssh/authorized_keys',
148 'file_permissions': '644',
149 'file_owner': 'pl_admin',
150 'file_group': 'pl_admin',
151 'preinstall_cmd': 'grep -q pl_admin /etc/passwd',
152 'postinstall_cmd': '/bin/chmod 700 /home/pl_admin/.ssh',
154 'ignore_cmd_errors': False,
155 'always_update': False},
157 # Log rotation configuration
159 'source': 'PlanetLabConf/logrotate.conf',
160 'dest': '/etc/logrotate.conf',
161 'file_permissions': '644',
162 'file_owner': 'root',
163 'file_group': 'root',
164 'preinstall_cmd': '',
165 'postinstall_cmd': '',
167 'ignore_cmd_errors': False,
168 'always_update': False},
170 # updatedb/locate nightly cron job
172 'source': 'PlanetLabConf/slocate.cron',
173 'dest': '/etc/cron.daily/slocate.cron',
174 'file_permissions': '755',
175 'file_owner': 'root',
176 'file_group': 'root',
177 'preinstall_cmd': '',
178 'postinstall_cmd': '',
180 'ignore_cmd_errors': False,
181 'always_update': False},
185 'source': 'PlanetLabConf/yum.conf.php?gpgcheck=1',
186 'dest': '/etc/yum.conf',
187 'file_permissions': '644',
188 'file_owner': 'root',
189 'file_group': 'root',
190 'preinstall_cmd': '',
191 'postinstall_cmd': '',
193 'ignore_cmd_errors': False,
194 'always_update': False},
196 'source': 'PlanetLabConf/delete-rpm-list-production',
197 'dest': '/etc/planetlab/delete-rpm-list',
198 'file_permissions': '644',
199 'file_owner': 'root',
200 'file_group': 'root',
201 'preinstall_cmd': '',
202 'postinstall_cmd': '',
204 'ignore_cmd_errors': False,
205 'always_update': False},
209 'source': 'PlanetLabConf/get_plc_config.php',
210 'dest': '/etc/planetlab/plc_config',
211 'file_permissions': '644',
212 'file_owner': 'root',
213 'file_group': 'root',
214 'preinstall_cmd': '',
215 'postinstall_cmd': '',
217 'ignore_cmd_errors': False,
218 'always_update': False},
220 'source': 'PlanetLabConf/get_plc_config.php?python',
221 'dest': '/etc/planetlab/plc_config.py',
222 'file_permissions': '644',
223 'file_owner': 'root',
224 'file_group': 'root',
225 'preinstall_cmd': '',
226 'postinstall_cmd': '',
228 'ignore_cmd_errors': False,
229 'always_update': False},
231 'source': 'PlanetLabConf/get_plc_config.php?perl',
232 'dest': '/etc/planetlab/plc_config.pl',
233 'file_permissions': '644',
234 'file_owner': 'root',
235 'file_group': 'root',
236 'preinstall_cmd': '',
237 'postinstall_cmd': '',
239 'ignore_cmd_errors': False,
240 'always_update': False},
242 'source': 'PlanetLabConf/get_plc_config.php?php',
243 'dest': '/etc/planetlab/php/plc_config.php',
244 'file_permissions': '644',
245 'file_owner': 'root',
246 'file_group': 'root',
247 'preinstall_cmd': '',
248 'postinstall_cmd': '',
250 'ignore_cmd_errors': False,
251 'always_update': False},
253 # XXX Required for old Node Manager
254 # Node Manager configuration
256 'source': 'PlanetLabConf/pl_nm.conf',
257 'dest': '/etc/planetlab/pl_nm.conf',
258 'file_permissions': '644',
259 'file_owner': 'root',
260 'file_group': 'root',
261 'preinstall_cmd': '',
262 'postinstall_cmd': '/etc/init.d/pl_nm restart',
264 'ignore_cmd_errors': False,
265 'always_update': False},
267 'source': 'PlanetLabConf/RootResources/plc_slice_pool.php',
268 'dest': '/home/pl_nm/RootResources/plc_slice_pool',
269 'file_permissions': '644',
270 'file_owner': 'pl_nm',
271 'file_group': 'pl_nm',
272 'preinstall_cmd': '',
273 'postinstall_cmd': '',
275 'ignore_cmd_errors': False,
276 'always_update': False},
278 'source': 'PlanetLabConf/RootResources/pl_conf.py',
279 'dest': '/home/pl_nm/RootResources/pl_conf',
280 'file_permissions': '644',
281 'file_owner': 'pl_nm',
282 'file_group': 'pl_nm',
283 'preinstall_cmd': '',
284 'postinstall_cmd': '/etc/init.d/pl_nm restart',
286 'ignore_cmd_errors': False,
287 'always_update': False},
289 'source': 'PlanetLabConf/RootResources/pl_netflow.py',
290 'dest': '/home/pl_nm/RootResources/pl_netflow',
291 'file_permissions': '644',
292 'file_owner': 'pl_nm',
293 'file_group': 'pl_nm',
294 'preinstall_cmd': '',
295 'postinstall_cmd': '',
297 'ignore_cmd_errors': False,
298 'always_update': False},
300 # XXX Required for old Node Manager
301 # Proper configuration
303 'source': 'PlanetLabConf/propd.conf',
304 'dest': '/etc/proper/propd.conf',
305 'file_permissions': '644',
306 'file_owner': 'root',
307 'file_group': 'root',
308 'preinstall_cmd': '',
309 'postinstall_cmd': '/etc/init.d/proper restart',
311 'ignore_cmd_errors': True,
312 'always_update': False},
314 # XXX Required for old Node Manager
317 'source': 'PlanetLabConf/bwlimit.php',
318 'dest': '/etc/planetlab/bwcap',
319 'file_permissions': '644',
320 'file_owner': 'root',
321 'file_group': 'root',
322 'preinstall_cmd': '',
323 'postinstall_cmd': '/etc/init.d/pl_nm restart',
325 'ignore_cmd_errors': True,
326 'always_update': False},
330 'source': 'PlanetLabConf/proxies.php',
331 'dest': '/etc/planetlab/proxies',
332 'file_permissions': '644',
333 'file_owner': 'root',
334 'file_group': 'root',
335 'preinstall_cmd': '',
336 'postinstall_cmd': '',
338 'ignore_cmd_errors': False,
339 'always_update': False},
341 # Firewall configuration
343 'source': 'PlanetLabConf/iptables',
344 'dest': '/etc/sysconfig/iptables',
345 'file_permissions': '600',
346 'file_owner': 'root',
347 'file_group': 'root',
348 'preinstall_cmd': '',
349 'postinstall_cmd': '',
351 'ignore_cmd_errors': False,
352 'always_update': False},
354 'source': 'PlanetLabConf/blacklist.php',
355 'dest': '/etc/planetlab/blacklist',
356 'file_permissions': '600',
357 'file_owner': 'root',
358 'file_group': 'root',
359 'preinstall_cmd': '',
360 'postinstall_cmd': '/sbin/iptables-restore --noflush < /etc/planetlab/blacklist',
362 'ignore_cmd_errors': True,
363 'always_update': False},
367 'source': 'PlanetLabConf/issue.php',
368 'dest': '/etc/issue',
369 'file_permissions': '644',
370 'file_owner': 'root',
371 'file_group': 'root',
372 'preinstall_cmd': '',
373 'postinstall_cmd': '',
375 'ignore_cmd_errors': False,
376 'always_update': False},
380 'source': 'PlanetLabConf/sysctl.php',
381 'dest': '/etc/sysctl.conf',
382 'file_permissions': '644',
383 'file_owner': 'root',
384 'file_group': 'root',
385 'preinstall_cmd': '',
386 'postinstall_cmd': '/sbin/sysctl -e -p /etc/sysctl.conf',
388 'ignore_cmd_errors': False,
389 'always_update': False},
391 # Sendmail configuration
393 'source': 'PlanetLabConf/sendmail.mc',
394 'dest': '/etc/mail/sendmail.mc',
395 'file_permissions': '644',
396 'file_owner': 'root',
397 'file_group': 'root',
398 'preinstall_cmd': '',
399 'postinstall_cmd': '',
401 'ignore_cmd_errors': False,
402 'always_update': False},
404 'source': 'PlanetLabConf/sendmail.cf',
405 'dest': '/etc/mail/sendmail.cf',
406 'file_permissions': '644',
407 'file_owner': 'root',
408 'file_group': 'root',
409 'preinstall_cmd': '',
410 'postinstall_cmd': 'service sendmail restart',
412 'ignore_cmd_errors': False,
413 'always_update': False},
417 'source': 'PlanetLabConf/RPM-GPG-KEY-fedora',
418 'dest': '/etc/pki/rpm-gpg/RPM-GPG-KEY-fedora',
419 'file_permissions': '644',
420 'file_owner': 'root',
421 'file_group': 'root',
422 'preinstall_cmd': '',
423 'postinstall_cmd': 'rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-fedora',
425 'ignore_cmd_errors': False,
426 'always_update': False},
428 'source': 'PlanetLabConf/get_gpg_key.php',
429 'dest': '/etc/pki/rpm-gpg/RPM-GPG-KEY-planetlab',
430 'file_permissions': '644',
431 'file_owner': 'root',
432 'file_group': 'root',
433 'preinstall_cmd': '',
434 'postinstall_cmd': 'rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-planetlab',
436 'ignore_cmd_errors': False,
437 'always_update': False},
439 # Ping of death configuration
441 'source': 'PlanetLabConf/ipod.conf.php',
442 'dest': '/etc/ipod.conf',
443 'file_permissions': '644',
444 'file_owner': 'root',
445 'file_group': 'root',
446 'preinstall_cmd': '',
447 'postinstall_cmd': '',
449 'ignore_cmd_errors': False,
450 'always_update': False},
454 'source': 'PlanetLabConf/sudoers',
455 'dest': '/etc/sudoers',
456 'file_permissions': '440',
457 'file_owner': 'root',
458 'file_group': 'root',
459 'preinstall_cmd': '',
460 'postinstall_cmd': '/usr/sbin/visudo -c',
462 'ignore_cmd_errors': False,
463 'always_update': False}
466 # Get list of existing (enabled, global) files
467 conf_files = GetConfFiles()
468 conf_files = filter(lambda conf_file: conf_file['enabled'] and \
469 not conf_file['node_ids'] and \
470 not conf_file['nodegroup_ids'],
472 dests = [conf_file['dest'] for conf_file in conf_files]
473 conf_files = dict(zip(dests, conf_files))
475 # Create/update default PlanetLabConf entries
476 for default_conf_file in default_conf_files:
477 if default_conf_file['dest'] not in dests:
478 AddConfFile(default_conf_file)
480 conf_file = conf_files[default_conf_file['dest']]
481 UpdateConfFile(conf_file['conf_file_id'], default_conf_file)
483 # Setup default slice attribute types
484 default_attribute_types = [
485 # Slice type (only vserver is supported)
487 'description': "Type of slice (e.g. vserver)",
492 'description': "Is a default system slice (1) or not (0 or unset)",
495 # Slice enabled (1) or suspended (0)
497 'description': "Slice enabled (1 or unset) or suspended (0)",
500 # Slice reference image
502 'description': "Reference image",
505 # Slice initialization script
506 {'name': "initscript",
507 'description': "Slice initialization script",
512 'description': "Minimum CPU share (ms/s)",
514 {'name': "cpu_share",
515 'description': "Number of CPU shares",
519 {'name': "net_min_rate",
520 'description': "Minimum bandwidth (kbps)",
522 {'name': "net_max_rate",
523 'description': "Maximum bandwidth (kbps)",
525 {'name': "net_i2_min_rate",
526 'description': "Minimum bandwidth over I2 routes (kbps)",
528 {'name': "net_i2_max_rate",
529 'description': "Maximum bandwidth over I2 routes (kbps)",
531 {'name': "net_max_kbyte",
532 'description': "Maximum daily network Tx KByte limit.",
534 {'name': "net_thresh_kbyte",
535 'description': "KByte limit before warning and throttling.",
537 {'name': "net_i2_max_kbyte",
538 'description': "Maximum daily network Tx KByte limit to I2 hosts.",
540 {'name': "net_i2_thresh_kbyte",
541 'description': "KByte limit to I2 hosts before warning and throttling.",
543 {'name': "net_share",
544 'description': "Number of bandwidth shares",
546 {'name': "net_i2_share",
547 'description': "Number of bandwidth shares over I2 routes",
552 'description': "Disk quota (1k disk blocks)",
556 {'name': "proper_op",
557 'description': "Proper operation (e.g. bind_socket)",
560 # XXX Required for old Node Manager
561 # Special attributes applicable to Slice Creation Service (pl_conf) slice
562 {'name': "plc_slice_type",
563 'description': "Type of slice rspec to be created",
565 {'name': "plc_agent_version",
566 'description': "Version of PLC agent (slice creation service) software to be deployed",
568 {'name': "plc_ticket_pubkey",
569 'description': "Public key used to verify PLC-signed tickets",
573 # Get list of existing attribute types
574 attribute_types = GetSliceAttributeTypes()
575 attribute_types = [attribute_type['name'] for attribute_type in attribute_types]
577 # Create/update default slice attribute types
578 for default_attribute_type in default_attribute_types:
579 if default_attribute_type['name'] not in attribute_types:
580 AddSliceAttributeType(default_attribute_type)
582 UpdateSliceAttributeType(default_attribute_type['name'], default_attribute_type)
584 # Create/update system slices
586 # XXX Required for old Node Manager
588 'description': "PlanetLab Slice Creation Service (SCS)",
590 'instantiation': "plc-instantiated",
592 'expires': sys.maxint,
593 'attributes': [('plc_slice_type', "VServerSlice"),
594 ('plc_agent_version', "1.0"),
595 ('plc_ticket_pubkey', "")]},
597 # XXX Required for old Node Manager
598 {'name': "pl_conf_vserverslice",
599 'description': "Default attributes for vserver slices",
601 'instantiation': "plc-instantiated",
603 'expires': sys.maxint,
604 'attributes': [('cpu_share', "32"),
605 ('plc_slice_type', "VServerSlice"),
606 ('disk_max', "5000000")]},
610 {'name': plc['slice_prefix'] + "_netflow",
611 'description': "PlanetFlow Traffic Auditing Service",
613 'instantiation': "plc-instantiated",
615 'expires': sys.maxint,
616 'attributes': [('system', "1"),
617 ('vref', "planetflow"),
618 ('proper_op', "open file=/etc/passwd, flags=r"),
619 ('proper_op', "create_socket"),
620 ('proper_op', "bind_socket")]},
623 ### xxx - to review once new node manager rolls out
624 # if PLC_SLICE_PREFIX is left to default - this is meant for the public PL only
625 if plc['slice_prefix'] == 'pl':
626 # create both legacy slices together with netflow through default_slices
627 default_slices += legacy_slices
629 # we use another slice prefix : disable legacy slices if already created
630 for legacy_slice in legacy_slices:
632 DeleteSlice(legacy_slice['name'])
636 for default_slice in default_slices:
637 slices = GetSlices([default_slice['name']])
640 UpdateSlice(slice['slice_id'], default_slice)
642 AddSlice(default_slice)
643 slice = GetSlices([default_slice['name']])[0]
645 # Create/update all attributes
646 slice_attributes = []
647 if slice['slice_attribute_ids']:
648 # Delete unknown attributes
649 for slice_attribute in GetSliceAttributes(slice['slice_attribute_ids']):
650 if (slice_attribute['name'], slice_attribute['value']) \
651 not in default_slice['attributes']:
652 DeleteSliceAttribute(slice_attribute['slice_attribute_id'])
654 slice_attributes.append((slice_attribute['name'], slice_attribute['value']))
656 for (name, value) in default_slice['attributes']:
657 if (name, value) not in slice_attributes:
658 AddSliceAttribute(slice['name'], name, value)
661 Once the node meets these requirements, please reinitiate the install
664 https://%(PLC_WWW_HOST)s:%(PLC_WWW_SSL_PORT)d/db/nodes/?id=%(node_id)d
666 Update the BootState to 'Reinstall', then reboot the node.
668 If you have already performed this step and are still receiving this
669 message, please reply so that we may investigate the problem.
672 # Load default message templates
673 message_templates = [
674 {'message_id': 'Verify account',
675 'subject': "Verify account registration",
677 Please verify that you registered for a %(PLC_NAME)s account with the
678 username %(email)s by visiting:
680 https://%(PLC_WWW_HOST)s:%(PLC_WWW_SSL_PORT)d/db/persons/register.php?id=%(person_id)d&key=%(verification_key)s
682 If you did not register for a %(PLC_NAME)s account, please ignore this
683 message, or contact %(PLC_NAME)s Support <%(PLC_MAIL_SUPPORT_ADDRESS)s>.
687 {'message_id': 'New PI account',
688 'subject': "New PI account registration from %(first_name)s %(last_name)s <%(email)s> at %(site_name)s",
690 %(first_name)s %(last_name)s <%(email)s> has signed up for a new
691 %(PLC_NAME)s account at %(site_name)s and has requested a PI role. PIs
692 are responsible for enabling user accounts, creating slices, and
693 ensuring that all users abide by the %(PLC_NAME)s Acceptable Use
696 Only %(PLC_NAME)s administrators may enable new PI accounts. If you
697 are a PI at %(site_name)s, please respond and indicate whether this
698 registration is acceptable.
700 To view the request, visit:
702 https://%(PLC_WWW_HOST)s:%(PLC_WWW_SSL_PORT)d/db/persons/index.php?id=%(person_id)d
706 {'message_id': 'New account',
707 'subject': "New account registration from %(first_name)s %(last_name)s <%(email)s> at %(site_name)s",
709 %(first_name)s %(last_name)s <%(email)s> has signed up for a new
710 %(PLC_NAME)s account at %(site_name)s and has requested the following
713 To deny the request or enable the account, visit:
715 https://%(PLC_WWW_HOST)s:%(PLC_WWW_SSL_PORT)d/db/persons/index.php?id=%(person_id)d
719 {'message_id': 'Password reset requested',
720 'subject': "Password reset requested",
722 Someone has requested that the password of your %(PLC_NAME)s account
723 %(email)s be reset. If this person was you, you may continue with the
726 https://%(PLC_WWW_HOST)s:%(PLC_WWW_SSL_PORT)d/db/persons/reset_password.php?id=%(person_id)d&key=%(verification_key)s
728 If you did not request that your password be reset, please contact
729 %(PLC_NAME)s Support <%(PLC_MAIL_SUPPORT_ADDRESS)s>. Do not quote or
730 otherwise include any of this text in any correspondence.
734 {'message_id': 'Password reset',
735 'subject': "Password reset",
737 The password of your %(PLC_NAME)s account %(email)s has been
738 temporarily reset to:
742 Please change it at as soon as possible by visiting:
744 https://%(PLC_WWW_HOST)s:%(PLC_WWW_SSL_PORT)d/db/persons/index.php?id=%(person_id)d
746 If you did not request that your password be reset, please contact
747 %(PLC_NAME)s Support <%(PLC_MAIL_SUPPORT_ADDRESS)s>. Do not quote or
748 otherwise include any of this text in any correspondence.
752 # Boot Manager messages
753 {'message_id': "installfinished",
754 'subject': "%(hostname)s completed installation",
756 %(hostname)s just completed installation.
758 The node should be usable in a couple of minutes if installation was
763 {'message_id': "insufficientdisk",
764 'subject': "%(hostname)s does not have sufficient disk space",
766 %(hostname)s failed to boot because it does not have sufficent disk
767 space, or because its disk controller was not recognized.
769 Please replace the current disk or disk controller or install
770 additional disks to meet the current hardware requirements.
774 {'message_id': "insufficientmemory",
775 'subject': "%(hostname)s does not have sufficient memory",
777 %(hostname)s failed to boot because it does not have sufficent
780 Please install additional memory to meet the current hardware
785 {'message_id': "authfail",
786 'subject': "%(hostname)s failed to authenticate",
789 %(hostname)s failed to authenticate for the following reason:
793 The most common reason for authentication failure is that the
794 authentication key stored in the node configuration file, does not
795 match the key on record.
797 There are two possible steps to resolve the problem.
799 1. If you have used an All-in-one BootCD that includes the plnode.txt file,
800 then please check your machine for any old boot media, either in the
801 floppy drive, or on a USB stick. It is likely that an old configuration
802 is being used instead of the new configuration stored on the BootCD.
804 2. If you are using Generic BootCD image, then regenerate the node
805 configuration file by visiting:
807 https://%(PLC_WWW_HOST)s:%(PLC_WWW_SSL_PORT)d/db/nodes/?id=%(node_id)d
809 Under 'Download', follow the 'Download plnode.txt file for %(hostname)s'
810 option, and save the downloaded file as plnode.txt on either a floppy
811 disk or a USB flash drive. Be sure the 'Boot State' is set to 'Boot',
812 and, then reboot the node.
814 If you have already performed this step and are still receiving this
815 message, please reply so that we can help investigate the problem.
819 {'message_id': "notinstalled",
820 'subject': "%(hostname)s is not installed",
823 %(hostname)s failed to boot because it has either never been
824 installed, or the installation is corrupt.
826 Please check if the hard drive has failed, and replace it if so. After
829 https://%(PLC_WWW_HOST)s:%(PLC_WWW_SSL_PORT)d/db/nodes/?id=%(node_id)d
831 Change the 'Boot State' to 'Reinstall', and then reboot the node.
833 If you have already performed this step and are still receiving this
834 message, please reply so that we may investigate the problem.
838 {'message_id': "hostnamenotresolve",
839 'subject': "%(hostname)s does not resolve",
842 %(hostname)s failed to boot because its hostname does not resolve, or
843 does resolve but does not match its configured IP address.
845 Please check the network settings for the node, especially its
846 hostname, IP address, and DNS servers, by visiting:
848 https://%(PLC_WWW_HOST)s:%(PLC_WWW_SSL_PORT)d/db/nodes/?id=%(node_id)d
850 Correct any errors, and change the 'Boot State' to 'Reinstall', and then
853 If you have already performed this step and are still receiving this
854 message, please reply so that we may investigate the problem.
858 # XXX N.B. I don't think these are necessary, since there's no
859 # way that the Boot Manager would even be able to contact the
860 # API to send these messages.
862 {'message_id': "noconfig",
863 'subject': "%(hostname)s does not have a configuration file",
865 %(hostname)s failed to boot because it could not find a PlanetLab
866 configuration file. To create this file, visit:
868 https://%(PLC_WWW_HOST)s:%(PLC_WWW_SSL_PORT)d/db/nodes/?id=%(node_id)d
870 Click the Configuration File link, and save the downloaded file as
871 plnode.txt on either a floppy disk or a USB flash drive. Change the
872 'Boot State' to 'Reinstall', and then reboot the node.
874 If you have already performed this step and are still receiving this
875 message, please reply so that we may investigate the problem.
879 {'message_id': "nodetectednetwork",
880 'subject': "%(hostname)s has unsupported network hardware",
884 %(hostname)s failed to boot because it has network hardware that is
885 unsupported by the current production kernel. If it has booted
886 successfully in the past, please try re-installing it by visiting:
888 https://%(PLC_WWW_HOST)s:%(PLC_WWW_SSL_PORT)d/db/nodes/?id=%(node_id)d
890 Change the 'Boot State' to 'Reinstall', and then reboot the node.
892 If you have already performed this step and are still receiving this
893 message, please reply so that we may investigate the problem.
898 for template in message_templates:
899 messages = GetMessages([template['message_id']])
903 if __name__ == '__main__':