monitor/wrapper/emailTxt.py

   1 #
   2 # Copyright (c) 2004  The Trustees of Princeton University (Trustees).
   3 #
   4 # Faiyaz Ahmed <faiyaza@cs.princeton.edu>
   5 #
   6 # $Id: emailTxt.py,v 1.10 2007/08/29 17:26:50 soltesz Exp $
   7
   8
   9 #
  10 # This file contains the texts of the automatically generated
  11 # emails sent to techs and PIs
  12 #
  13
  14 class mailtxt:
  15
  16         newdown_one=("""PlanetLab node(s) down: %(loginbase)s""",
  17 """
  18 Hello,
  19
  20 As part of PlanetLab node monitoring, we noticed the following nodes were down at your site:
  21
  22 %(hostname_list)s
  23 We're writing because we need your help returning them to their regular operation.
  24
  25 To help, please confirm that a verison 3.0 or greater BootCD is installed in the machine.  Then, after checking that the node is properly networked, power cycle the machine.  Note that rebooting the machine may not fully resolve the problems we are seeing.  Once the machine has come back up, please visit the Comon status page to verify that your node is accessible from the network.  It may take several minutes before Comon registers your node.  Until that time, visiting the link below will return the message 'could not find requested table - probably empty'.
  26
  27         http://summer.cs.princeton.edu/status/tabulator.cgi?table=nodes/table_%(hostname)s&limit=50
  28
  29 If the machine has booted successfully, you may check it more quickly by logging in with your site_admin account, and running:
  30
  31     sudo /usr/sbin/vps ax
  32
  33 If you have a BootCD older than 3.0, you will need to create a new BootImage on CD or USB.  You can find instructions for this at the Technical Contact's Guide:
  34
  35     https://www.planet-lab.org/doc/guides/bootcdsetup
  36
  37 If after following these directions, and either logging in with your site_admin account or seeing the CoMon report of your machine, there is no need to respond to this message.  However, if there are any console messages relating to the node's failure, please report them to PlanetLab support (support@planet-lab.org) so we can help resolve the issue.   Including this message in your reply will help us coordinate our records with the actions you've taken.
  38
  39 Finally, you can track the current status of your machines using this Google Gadget:
  40
  41     http://fusion.google.com/add?source=atgs&moduleurl=http://monitor.planet-lab.org/monitor/sitemonitor.xml
  42
  43 Thank you for your help,
  44   -- PlanetLab Central (support@planet-lab.org)
  45 """)
  46
  47 #If no one responds, then after a week, we will disable your site's ability to create new slices.  Because this action will directly affect your site's registered PI, we will also CC the PI for help at that time.
  48
  49         newdown_two=("""PlanetLab node(s) down: %(loginbase)s""",
  50 """
  51 Hello,
  52
  53 As part of PlanetLab node monitoring, we noticed the following nodes were down at your site:
  54
  55 %(hostname_list)s
  56 We're writing again because our previous correspondence, sent only to the registered Technical Contact, has gone unacknowledged for at least a week, and we need your help returning these machines to their regular operation.  We understand that machine maintenance can take time.  So, while we wait for the machines to return to their regular operation slice creation has been suspended at your site.  No new slices may be created, but the existing slices and services running within them will be unaffected.
  57
  58 To help, please confirm that a verison 3.0 or greater BootCD is installed in the machine.  Then, after checking that the node is properly networked, power cycle the machine.  Note that rebooting the machine may not fully resolve the problems we are seeing.  Once the machine has come back up, please visit the Comon status page to verify that your node is accessible from the network.  It may take several minutes before Comon registers your node.  Until that time, visiting the link below will return the message 'could not find requested table - probably empty'.
  59
  60         http://summer.cs.princeton.edu/status/tabulator.cgi?table=nodes/table_%(hostname)s&limit=50
  61
  62 If the machine has booted successfully, you may check it more quickly by logging in with your site_admin account, and running:
  63
  64     sudo /usr/sbin/vps ax
  65
  66 If you have a BootCD older than 3.0, you will need to create a new Boot CD and configuration file.  You can find instructions for this at the Technical Contact's Guide:
  67
  68     https://www.planet-lab.org/doc/guides/bootcdsetup
  69
  70 If after following these directions, and either logging in with your site_admin account or seeing the CoMon report of your machine, there is no need to respond to this message.  However, if there are any console messages relating to the node's failure, please report them to PlanetLab support (support@planet-lab.org) so we can help resolve the issue.   Including this message in your reply will help us coordinate our records with the actions you've taken.
  71
  72 Finally, you can track the current status of your machines using this Google Gadget:
  73
  74     http://fusion.google.com/add?source=atgs&moduleurl=http://monitor.planet-lab.org/monitor/sitemonitor.xml
  75
  76 After another week, we will disable all slices currently running on PlanetLab.  Because this action will directly affect all users of these slices, these users will also be notified at that time.
  77
  78 Thank you for your help,
  79   -- PlanetLab Central (support@planet-lab.org)
  80 """)
  81
  82         newdown_three=("""PlanetLab node(s) down: %(loginbase)s""",
  83 """
  84 Hello,
  85
  86 As part of PlanetLab node monitoring, we noticed the following nodes were down at your site:
  87
  88 %(hostname_list)s
  89 We understand that machine maintenance can take time.  We're writing again because our previous correspondences, sent first to the registered Technical Contact then the the Site PI, have gone unacknowledged for at least two weeks, and we need your help returning these machines to their regular operation.  This is the third time attempting to contact someone in regard to these machines at your site.  So, while we wait for the machines to return to their regular operation all current slice activity will be suspended.  Current experiments will be stopped and will not be be able to start again until there is evidence that you have begun to help with the maintenance of these machines.
  90
  91 To help, please confirm that a verison 3.0 or greater BootCD is installed in the machine.  Then, after checking that the node is properly networked, power cycle the machine.  Note that rebooting the machine may not fully resolve the problems we are seeing.  Once the machine has come back up, please visit the Comon status page to verify that your node is accessible from the network.  It may take several minutes before Comon registers your node.  Until that time, visiting the link below will return the message 'could not find requested table - probably empty'.
  92
  93         http://summer.cs.princeton.edu/status/tabulator.cgi?table=nodes/table_%(hostname)s&limit=50
  94
  95 If the machine has booted successfully, you may check it more quickly by logging in with your site_admin account, and running:
  96
  97     sudo /usr/sbin/vps ax
  98
  99 If you have a BootCD older than 3.0, you will need to create a new Boot CD and configuration file.  You can find instructions for this at the Technical Contact's Guide:
 100
 101     https://www.planet-lab.org/doc/guides/bootcdsetup
 102
 103 Finally, you can track the current status of your machines using this Google Gadget:
 104
 105     http://fusion.google.com/add?source=atgs&moduleurl=http://monitor.planet-lab.org/monitor/sitemonitor.xml
 106
 107 If after following these directions, and either logging in with your site_admin account or seeing the CoMon report of your machine, there is no need to respond to this message.  However, if there are any console messages relating to the node's failure, please report them to PlanetLab support (support@planet-lab.org) so we can help resolve the issue.   Including this message in your reply will help us coordinate our records with the actions you've taken.
 108
 109 Thank you for your help,
 110   -- PlanetLab Central (support@planet-lab.org)
 111 """)
 112
 113         newbootcd_one=(""" Planetlab nodes need a new BootCD: %(loginbase)s""", # : %(hostname)s""",
 114 """As part of PlanetLab node monitoring, we noticed the following nodes have an out-dated BootCD:
 115
 116 %(hostname_list)s
 117 This usually implies that you need to update the BootCD and node configuration file stored on the read-only media (either the all-in-one ISO CD, floppy disk, or write-protected USB stick).
 118
 119 To check the status of these and any other machines that you manage please visit:
 120
 121     http://comon.cs.princeton.edu/status
 122
 123 Instructions to perform the steps necessary for a BootCD upgrade are available in the Technical Contact's Guide.
 124
 125     https://www.planet-lab.org/doc/guides/bootcdsetup
 126
 127 If your node returns to normal operation after following these directions, then there's no need to respond to this message.  However, if there are any console messages relating to the node's failure, please report them to PlanetLab support (support@planet-lab.org) so we can help resolve the issue.  Including this message in your reply will help us coordinate our records with the actions you've taken.
 128
 129 Thank you for your help,
 130   -- PlanetLab Central (support@planet-lab.org)
 131 """)
 132 #After a week, we will disable your site's ability to create new slices.  Because this action will directly affect your site's registered PI, we will also CC the PI for help at that time.
 133
 134         newbootcd_two=(""" Planetlab nodes need a new BootCD: %(loginbase)s""", # : %(hostname)s""",
 135 """As part of PlanetLab node monitoring, we noticed the following nodes have an out-dated BootCD:
 136
 137 %(hostname_list)s
 138 This usually implies that you need to update the BootCD and node configuration file stored on the read-only media (Either the all-in-one ISO CD, floppy disk, or write-protected USB stick).
 139
 140 We're writing again because our previous correspondence, sent only to the registered Technical Contact, has gone unacknowledged for at least a week, and we need your help returning these machines to their regular operation.  We understand that machine maintenance can take time.  So, while we wait for the machines to return to their regular operation, slice creation has been suspended at your site.  No new slices may be created, but the existing slices and services running within them will be unaffected.
 141
 142 To check the status of these and any other machines that you manage please visit:
 143
 144     http://comon.cs.princeton.edu/status
 145
 146 Instructions to perform the steps necessary for a BootCD upgrade are available in the Technical Contact's Guide.
 147
 148     https://www.planet-lab.org/doc/guides/bootcdsetup
 149
 150 If your node returns to normal operation after following these directions, then there's no need to respond to this message.  However, if there are any console messages relating to the node's failure, please report them to PlanetLab support (support@planet-lab.org) so we can help resolve the issue.  Including this message in your reply will help us coordinate our records with the actions you've taken.
 151
 152 After another week, we will disable all slices currently running on PlanetLab.  Because this action will directly affect all users of these slices, these users will also be notified at that time.
 153
 154 Thank you for your help,
 155   -- PlanetLab Central (support@planet-lab.org)
 156 """)
 157         newbootcd_three=(""" Planetlab nodes need a new BootCD: %(loginbase)s""", # : %(hostname)s""",
 158 """As part of PlanetLab node monitoring, we noticed the following nodes have an out-dated BootCD:
 159
 160 %(hostname_list)s
 161 This usually implies that you need to update the BootCD and node configuration file stored on the read-only media (Either the all-in-one ISO CD, floppy disk, or write-protected USB stick).
 162
 163 We understand that machine maintenance can take time.  We're writing again because our previous correspondences, sent first to the registered Technical Contact then the the Site PI, have gone unacknowledged for at least two weeks, and we need your help returning these machines to their regular operation.  This is the third time attempting to contact someone in regard to these machines at your site.  So, while we wait for the machines to return to their regular operation all current slice activity will be suspended.  Current experiments will be stopped and will not be be able to start again until there is evidence that you have begun to help with the maintenance of these machines.
 164
 165 To check the status of these and any other machines that you manage please visit:
 166
 167     http://comon.cs.princeton.edu/status
 168
 169 Instructions to perform the steps necessary for a BootCD upgrade are available in the Technical Contact's Guide.
 170
 171     https://www.planet-lab.org/doc/guides/bootcdsetup
 172
 173 If your node returns to normal operation after following these directions, then there's no need to respond to this message.  However, if there are any console messages relating to the node's failure, please report them to PlanetLab support (support@planet-lab.org) so we can help resolve the issue.  Including this message in your reply will help us coordinate our records with the actions you've taken.
 174
 175 Thank you for your help,
 176   -- PlanetLab Central (support@planet-lab.org)
 177 """)
 178         pcuthankyou_one=("""Thank you for correcting your PlanetLab node PCU - %(loginbase)s""",
 179         """
 180 While monitoring your site, we noticed that the following PCU *improved* their states:
 181
 182 %(hostname_list)s
 183 Often, system administration is a thankless job, but not today. :-)
 184
 185 Thank you!
 186   -- PlanetLab Central (support@planet-lab.org)
 187         """)
 188
 189         thankyou=("""Thank you for helping maintain your PlanetLab nodes - %(loginbase)s""",
 190         """
 191 While monitoring your site, we noticed that the following nodes *improved*
 192 their states:
 193
 194 %(hostname_list)s
 195 Often, system administration is a thankless job, but not today. :-)
 196
 197 Thank you!
 198   -- PlanetLab Central (support@planet-lab.org)
 199
 200 Legend:
 201 PROD-      This state is the production state where the node can contact PlanetLab,
 202            and install slices from users.
 203 DEBUG-     This state designates a node that could not boot successfully.
 204 OLDBOOTCD- This state corresponds to the situation where an oldbootcd prevented
 205            the normal operation of the node.
 206 ERROR-     This is an error state, where there is absolutely no contact
 207            with PlanetLab.
 208         """)
 209
 210         pcumissing_notice =("""MONTEST: No PCU available to reboot %(hostname)s""",
 211 """As part of PlanetLab node monitoring and maintenance, we noticed that there is no PCU
 212 associated with %(hostname)s, so we could not reboot it ourselves.
 213
 214 To save you time in the future, please take a moment to register the PCU functionality for
 215 your machines here:
 216
 217     http://www.planet-lab.org/db/sites/pcu.php
 218
 219 Thank you very much for your help,
 220   -- PlanetLab Central (support@planet-lab.org)
 221 """)
 222         pcufailed_notice =("""MONTEST: Could not use PCU to reboot %(hostname)s""",
 223
 224 """As part of PlanetLab node monitoring and maintenance, we tried to use the PCU
 225 registered for %(hostname)s, but could not for some reason.
 226
 227 Please help.
 228
 229 Thank you very much for your help,
 230   -- PlanetLab Central (support@planet-lab.org)
 231 """)
 232         online_notice=("""MONTEST: Host %(hostname)s is online""",
 233         """
 234 This notice is simply to let you know that:
 235     %(hostname)s
 236
 237 is online and operational.  Thank you very much for your help!
 238         """)
 239         test_notice=("""MONTEST: Host %(hostname)s is testing""",
 240         """
 241 This notice is simply to test whether notices work.
 242     %(hostname)s
 243
 244 Thank you very much for your help!
 245         """)
 246         retry_bootman=("""MONTEST: Running BootManager on %(hostname)s""",
 247         """
 248 This notice is simply to let you know that:
 249     %(hostname)s
 250
 251 appears stuck in a debug mode.  To try to correct this, we're trying to rerun BootManager.py.
 252 If any action is needed from you, you will recieve additional notices.  Thank you!
 253         """)
 254         down_notice=("""MONTEST: Host %(hostname)s is down""",
 255         """
 256 This notice is simply to let you know that:
 257     %(hostname)s
 258
 259 is down, disconnected from the network and/or non-operational.
 260
 261 Please investigate, thank you very much for your help!
 262
 263         http://monitor.planet-lab.org:8082/pcuview?loginbase=%(loginbase)s
 264         """)
 265
 266         clear_penalty=("""MONTEST: All penalties have been cleared from site %(loginbase)s""",
 267         """
 268 This notice is to let you know that any penalties previously applied to your site have
 269 been removed: %(penalty_level)s.
 270
 271 All privileges have been restored.  If your slices were disabled, please allow
 272 up to 30 minutes for them to return to enabled.
 273
 274 Legend:
 275
 276   0  - no penalties applied
 277   1  - site is disabled.  no new slices can be created.
 278   2+ - all existing slices will be disabled.
 279         """)
 280
 281         increase_penalty=("""MONTEST: Penalty increased for site %(loginbase)s""",
 282         """
 283 This notice is to let you know that the penalty applied to your site has
 284 increased: %(penalty_level)s.
 285
 286 legend:
 287
 288   0  - no penalty applied
 289   1  - site is disabled.  no new slices can be created.
 290   2+ - all existing slices will be disabled.
 291         """)
 292
 293         newbootcd_notice=("""MONTEST: Host %(hostname)s needs a new BootImage""", """
 294 As part of PlanetLab node monitoring, we noticed the following nodes have an out-dated BootCD:
 295
 296     %(hostname)s
 297
 298 This usually implies that you need to update the BootCD and node configuration file stored on the read-only media (either the all-in-one ISO CD, floppy disk, or write-protected USB stick).
 299
 300 Thank you for your help,
 301   -- PlanetLab Central (support@planet-lab.org)
 302 """)
 303
 304         nmreset =("""NM Reset at %(loginbase)s""",
 305         """
 306 Monitor restarted NM on the following machines:
 307
 308 %(hostname_list)s
 309
 310         """)
 311         pcudown_one =("""Could not use PCU to reboot %(hostname)s""",
 312
 313 """As part of PlanetLab node monitoring and maintenance, we tried to use the PCU
 314 registered below, but could not for the reasons at the link below:
 315
 316         https://monitor.planet-lab.org/cgi-bin/printbadpcus.php?id=%(pcu_id)s
 317
 318 We need your help resolving this issue in a few ways:
 319
 320  1. First, we need your help rebooting %(hostname)s.  Because the above PCU does
 321     not appear to work, please manually reboot this machine.  If it turns out that
 322     there is a problem with the PCU configuration, we can help you
 323     resolve that independently.
 324
 325  2. If there is nothing apparently wrong with the PCU, or the mapping between
 326     the PCU and the host, then there is likely a problem with our bootstrap
 327     software on your machine.  To help us, please make a note of any text on
 328     the console and report it to mailto:support@planet-lab.org .  An example
 329     might be that the console hangs waiting for a module to unload.  The last
 330     reported name or any error messages on the screen would be very helpful.
 331
 332  3. Alternately, if it is possible, please correcct the above PCU problem, or
 333     let us know what steps you are taking.  By enabling us to take administrative
 334     actions automatically from PlanetLab Central without your intervention, you
 335     can trade a small amount of time now for a time savings in the future.
 336
 337 If the PCU is up and running, but behind a firewall, please make it accessible
 338 from address block 128.112.139.0/24.  You can confirm that this is the address
 339 space from which the PlanetLab Central servers run.
 340
 341 If the above PCU is no longer in service, please delete it by visiting:
 342
 343     https://www.planet-lab.org/db/sites/pcu.php?id=%(pcu_id)s
 344
 345 and selecting 'Delete PCU'. You may then register a new PCU for your nodes.
 346
 347 Thank you very much for your help,
 348   -- PlanetLab Central (support@planet-lab.org)
 349 """)
 350         pcutonodemapping_one =("""PCU to Node mapping is incorrect for %(hostname)s""",
 351         """
 352     As part of our machine monitoring and maintenance, we tried to use the PCU
 353 registered below, and though it appears to succeed, we do not subsequently
 354 observe the associated nodes rebooting:
 355
 356     https://monitor.planet-lab.org/cgi-bin/printbadpcus.php?id=%(pcu_id)s
 357
 358 %(hostname_list)s
 359
 360 We need your help resolving this issue in two ways:
 361
 362 * First, we need your help rebooting %(hostname)s.  Because the above PCU
 363   does not appear to actually control the above Nodes, we cannot use it to
 364   reboot these machines. So, please manually reboot the machine and we can
 365   help you resolve any configuration errors with the PCU independently.
 366
 367 * Second, please check the configuration of the above PCU.  Check that the
 368   PCU is physically connected to the servers that it should be able to
 369   control.  A common mistake is that the PCU is registered for a machine,
 370   but not actually connected physically to the machine.
 371
 372 By enabling us to take administrative actions automatically from PlanetLab
 373 Central without local intervention, you can trade a small amount of time now
 374 for a time savings in the future.
 375
 376 If the above PCU is no longer in service, please delete it by visiting:
 377
 378     https://www.planet-lab.org/db/sites/pcu.php?id=%(pcu_id)s
 379
 380 and selecting 'Delete PCU'. You may then register a new PCU for your nodes.
 381
 382 Alternately, if the machines listed above are no longer in service, please
 383 delete them by visiting your sites page at:
 384
 385     https://www.planet-lab.org/
 386
 387 Thank you very much for your help,
 388   -- PlanetLab Central (support@planet-lab.org)
 389 """)
 390
 391         newalphacd_notice=("""MONTEST: New Boot Images for %(hostname)s""",
 392 """As part of PlanetLab node monitoring, we noticed that we were not able to recognize all the hardware in your machine.  This means that it is so new that it needs a new BootCD, or that it is so old that it is no longer supported.
 393
 394     %(hostname)s
 395
 396 To make this process as simple as possible, we have created All-in-One boot images that include the node configuration file.
 397
 398 The only step that you need to take is to choose which media you prefer, either CD ISO, or USB image for each host.
 399
 400 %(url_list)s
 401
 402 Instructions to burn or copy these All-in-One images to the appropriate media are available in the Technical Contact's Guide.
 403
 404     https://www.planet-lab.org/doc/guides/bootcdsetup
 405
 406 If your node returns to normal operation after following these directions, then there's no need to respond to this message.  However, if there are any console messages relating to the node's failure, please report them to PlanetLab support (support@planet-lab.org) so we can help resolve the issue.  Including this message in your reply will help us coordinate our records with the actions you've taken.
 407
 408 Thank you for your help,
 409   -- PlanetLab Central (support@planet-lab.org)
 410 """)
 411
 412         # TODO: need reminder versions for repeats...
 413         newdown=[newdown_one, newdown_two, newdown_three]
 414         newbootcd=[newbootcd_one, newbootcd_two, newbootcd_three]
 415         #newalphacd=[newalphacd_one, newalphacd_one, newalphacd_one]
 416         newthankyou=[thankyou,thankyou,thankyou]
 417         pcuthankyou=[pcuthankyou_one,pcuthankyou_one,pcuthankyou_one]
 418         NMReset=[nmreset,nmreset,nmreset]
 419         pcutonodemapping=[pcutonodemapping_one, pcutonodemapping_one, pcutonodemapping_one]
 420         pcudown=[pcudown_one, pcudown_one, pcudown_one]
 421
 422         unknownsequence_notice = ("""MONTEST: Unrecognized Error on PlanetLab host %(hostname)s""",
 423                                            """
 424 While trying to automatically recover this machine:
 425
 426     http://www.planet-lab.org/db/nodes/index.php?nodepattern=%(hostname)s
 427
 428 We encountered an unknown situation.  Please re-code to handle, or manually intervene to repair this host.
 429
 430 Abbreviated BootManager Sequence:
 431
 432     %(sequence)s
 433
 434 BootManager.log output follows:
 435 ---------------------------------------------------------
 436 %(bmlog)s
 437 """       )
 438         donation_down_one=("""PlanetLab node donation setup: %(hostname)s""",
 439         """
 440 Hello,
 441
 442 As part of PlanetLab node monitoring, we noticed the following node is registered in the PlanetLab database, but it is not completly setup and running.
 443
 444 %(hostname_list)s
 445 We are writing because we need your help completing the setup to ensure its full operation.
 446
 447 You should have received directions for the complete configuration when you contacted the donation program coordinator at PlanetLab.  For review, or if you did not receive them, you can find the latest version here:
 448
 449     https://svn.planet-lab.org/wiki/DC7800Configuration
 450
 451 It is essential that the AMT feature be configured to enable PlanetLab staff to remotely manage the machine.  The basic steps are:
 452
 453     Configure the DC7800 AMT feature  : https://www.planet-lab.org/AMT
 454     Add a PCU to your site            : https://www.planet-lab.org/db/sites/pcu.php
 455         Associate your node with the PCU  : Follow the 'My Site' link
 456         Finally, download the Boot Image  : https://www.planet-lab.org/db/nodes/index.php?nodepattern=%(hostname)s
 457         Burn Boot Image to media & Reboot your node
 458
 459 You can confirm that your machine's PCU is correctly configured by visiting the AMT
 460 port using your browser, such as:
 461
 462     http://%(hostname)s:16992/
 463
 464 If you need any clarification about the steps mentioned here, please feel free
 465 to contact us at PlanetLab Support (support@planet-lab.org).
 466
 467 Thank you for your help,
 468   -- PlanetLab Central (support@planet-lab.org)
 469 """)
 470
 471         donation_nopcu_one=("""PlanetLab node donation, PCU setup: %(hostname)s""",
 472 """
 473 Hello,
 474
 475 As part of PlanetLab node monitoring, we noticed the following node was not completely setup at your site:
 476
 477 %(hostname_list)s
 478 We are writing because we need your help completing the setup to ensure its full operation.
 479
 480 The DC7800 comes with a built-in remote management feature.  The PCU functionality on your node is not configured.  The result of this is that we are unable to remotely administer this machine.
 481
 482 You should have received directions for the complete configuration when you contacted the donation program coordinator at PlanetLab.  For review, or if you did not receive them, you can find the latest version here:
 483
 484     https://svn.planet-lab.org/wiki/DC7800Configuration
 485
 486 It is essential that the PCU be configured.  The basic steps are:
 487
 488     Configure the DC7800 AMT feature  : https://www.planet-lab.org/AMT
 489     Add a PCU to your site            : https://www.planet-lab.org/db/sites/pcu.php
 490         Associate your node with the PCU  : Follow the 'My Site' link
 491
 492 You can confirm that your machine is correctly configured by visiting the AMT
 493 port using your browser, such as:
 494
 495     http://%(hostname)s:16992/
 496
 497 If you need any clarification about the steps mentioned here, please feel free
 498 to contact us at PlanetLab Support (support@planet-lab.org).
 499
 500 Thank you for your help,
 501   -- PlanetLab Central (support@planet-lab.org)
 502 """)
 503
 504         donation_nopcu = [ donation_nopcu_one, donation_nopcu_one, donation_nopcu_one ]
 505         donation_down = [ donation_down_one, donation_down_one, donation_down_one ]
 506
 507
 508         minimalhardware_notice = ("""MONTEST: Hardware requirements not met on PlanetLab host %(hostname)s""",
 509                                            """
 510 While trying to automatically recover this machine:
 511
 512     http://www.planet-lab.org/db/nodes/index.php?nodepattern=%(hostname)s
 513
 514 We encountered an failed hardware requirement.  Please look at the log below to determine the exact nature of the failure, either Disk, CPU, Network, or Mimial RAM was not satisfied.
 515
 516 If your machine does not meet the current hardware specifications for a PlanetLab node (http://www.planet-lab.org/hardware), please upgrade it to meet the current recommended configuration.
 517
 518 If you believe this message is an error, please email support@planet-lab.org explaining the problem.  You may need to create an updated Boot Image that includes drivers for your hardware.
 519
 520 Thank you,
 521  - PlanetLab Support
 522
 523 BootManager.log output follows:
 524 ---------------------------------------------------------
 525 %(bmlog)s
 526 """       )
 527
 528         baddisk_notice = ("""MONTEST: Bad Disk on PlanetLab node %(hostname)s""",
 529                            """As part of PlanetLab node monitoring, we noticed %(hostname)s has a number of disk or media related I/O errors, that prevent it from either booting or reliably running as a PlanetLab node.
 530
 531 Please verify the integrity of the disk, and order a replacement if needed.  If you need to schedule downtime for the node, please let us know at support@planet-lab.org.
 532
 533 Thanks.
 534
 535   -- PlanetLab Central (support@planet-lab.org)
 536
 537 The output of `dmesg` follows:
 538 -------------------------------------------------------------------------
 539
 540 %(log)s
 541 """)
 542
 543         down=("""PlanetLab node %(hostname)s down.""", """As part of PlanetLab node monitoring, we noticed %(hostname)s has been down for %(days)s days.
 544
 545 Please check the node's connectivity and, if properly networked, power cycle the machine. Note that rebooting the machine may not fully resolve the problems we're seeing. Once the machine has come back up, please visit the Comon status page to verify that your node is accessible from the network.
 546
 547 http://summer.cs.princeton.edu/status/tabulator.cgi?table=table_nodeviewshort&select='address==%(hostbyteorder)s'
 548
 549 http://www.planet-lab.org/db/sites/index.php?id=%(site_id)d
 550
 551 There's no need to respond to this message if CoMon reports that your machine is accessible. However, if there are any console messages relating to the node's failure, please report them to PlanetLab support (support@planet-lab.org) so we can resolve the issue.
 552
 553 Thanks.
 554
 555
 556   -- PlanetLab Central (support@planet-lab.org)
 557 """)
 558
 559         dbg=("""Planetlab node %(hostname)s requires reboot.""", """As part of PlanetLab node monitoring, we noticed %(hostname)s is in debug mode.  This usually implies the node was rebooted unexpectedly and could not come up cleanly.
 560
 561 Please check the node's connectivity and, if properly networked, power cycle the machine. Note that rebooting the machine may not fully resolve the problems we're seeing. Once the machine has come back up, please visit the Comon status page to verify that your node is accessible from the network.
 562
 563 http://summer.cs.princeton.edu/status/tabulator.cgi?table=table_nodeviewshort&select='address==%(hostbyteorder)s'
 564
 565 There's no need to respond to this message if CoMon reports that your machine is accessible. However, if there are any console messages relating to the node's failure, please report them to PlanetLab support (support@planet-lab.org) so we can resolve the issue.
 566
 567 Thank you for your help,
 568   -- PlanetLab Central (support@planet-lab.org)
 569 """)
 570
 571         plnode_cfg=(""" Please Verify Network Configuration for PlanetLab node %(hostname)s""",
 572 """Hello,
 573
 574 As part of PlanetLab node monitoring, we noticed that %(hostname)s has a network configuration error related to DNS or hostname lookups.  Often this can happen either due local configuraiton changes, or a misconfiguration of the node's DNS servers.  To resolve the issue we require your assistance.  All that is needed is to visit:
 575
 576         https://www.planet-lab.org/db/nodes/index.php?nodepattern=%(hostname)s
 577
 578 Find the primary node network entry and confirm that the settings are correct.
 579
 580 If you use 'static' network configuration, verify that the DNS servers are correct.  If you are using 'dhcp' then you will need to confirm that the information returned for the node will allow it to perform lookups on it's own hostname.
 581
 582 If you change the network settings, then select, "Download -> Download plnode.txt file for %(hostname)s" menu.  This will generate a new configuration file for your node.  Copy this file to the appropriate read-only media, either floppy or USB stick, and reboot the machine.  If you are using an All-in-One boot image, then you will need to download the All-in-One image instead, burn it to the appropriate media (CD or USB) and reboot.
 583
 584 Please let us know if you need any assistance.
 585
 586 Thank you for your help,
 587   -- PlanetLab Central (support@planet-lab.org)
 588
 589 BootManager.log output follows:
 590 ---------------------------------------------------------
 591 %(bmlog)s
 592 """)
 593
 594         nodeconfig_notice=("""MONTEST:  Please Update Configuration file for PlanetLab node %(hostname)s""",
 595 """As part of PlanetLab node monitoring, we noticed %(hostname)s has an out-dated plnode.txt file with no NODE_ID or a mis-matched HOSTNAME.  This can happen either due to an initial configuration failure at your site, with information entered into our database, or after a software upgrade.  To resolve the issue we require your assistance.  All that is needed is to visit:
 596
 597         https://www.planet-lab.org/db/nodes/index.php?nodepattern=%(hostname)s
 598
 599 Then, select, "Download -> Download plnode.txt file for %(hostname)s" menu.  This will generate a new configuration file for your node.  Copy this file to the appropriate read-only media, either floppy or USB stick, and reboot the machine.
 600
 601 There is no need to respond to this message if you're able to update the configuration file without difficulty and your node returns to normal operation.  However, if there are any console messages relating to the node's failure, please report them to PlanetLab support (support@planet-lab.org) so we can help resolve the issue.
 602
 603 Thank you for your help,
 604   -- PlanetLab Central (support@planet-lab.org)
 605 """)
 606
 607         bootcd=(""" Planetlab node %(hostname)s needs a new BootCD""",
 608 """As part of PlanetLab node monitoring, we noticed %(hostname)s has an out-dated BootCD: "%(version)".  This usually implies that you need to update both the BootCD and regenerate the planet.cnf file stored on the read-only floppy (Or read-only USB stick that stores the content of BootCD and planet.cnf).
 609
 610 Instructions to perform the steps necessary for a BootCD upgrade are available in the Technical Contact Guide.
 611     https://www.planet-lab.org/doc/guides/tech#NodeInstallation
 612
 613 There's no need to respond to this message if you're able to follow the directions without difficulty and your node returns to normal operation. However, if there are any console messages relating to the node's failure, please report them to PlanetLab support (support@planet-lab.org) so we can help resolve the issue.
 614
 615 Thanks you for your help,
 616   -- PlanetLab Central (support@planet-lab.org)
 617 """)
 618
 619         ssh=("""Planetlab node %(hostname)s down.""", """As part of PlanetLab node monitoring, we noticed node %(hostname)s is not available for ssh.
 620
 621 Please check the node's connectivity and, if properly networked, power cycle the machine. Note that rebooting the machine may not fully resolve the problems we're seeing. Once the machine has come back up, please visit the Comon status page to verify that your node is accessible from the network.
 622
 623 http://summer.cs.princeton.edu/status/tabulator.cgi?table=table_nodeviewshort&select='address==%(hostbyteorder)s'
 624
 625 There's no need to respond to this message if CoMon reports that your machine is accessible. However, if there are any console messages relating to the node's failure, please report them to PlanetLab support (support@planet-lab.org) so we can resolve the issue.
 626
 627 Thanks.
 628
 629
 630   -- PlanetLab Central (support@planet-lab.org)
 631 """)
 632
 633
 634         baddns_notice=("""MONTEST: Planetlab node down: broken DNS configuration for %(hostname)s""",
 635 """As part of PlanetLab node monitoring, we noticed the DNS servers used by the following machine(s) are not responding to queries.
 636
 637     %(hostname)s
 638
 639 The conseuqnece of this is that the node cannot boot correctly, and is not a functioning part of the PlanetLab network.
 640
 641 To help us return this machine to running order, please verify that the registered DNS servers in the node network configuration are correct.
 642
 643 %(network_config)s
 644
 645 You may update the node's network information at the link below:
 646
 647     https://www.planet-lab.org/db/nodes/node_networks.php?id=%(nodenetwork_id)s
 648
 649 If you have any questions, please feel free to contact us at PlanetLab Support (support@planet-lab.org).
 650
 651 Thank you for your help,
 652   -- PlanetLab Central (support@planet-lab.org)
 653 """)
 654
 655
 656         filerw=("""Planetlab node %(hostname)s has a bad disk.""", """As part of PlanetLab node monitoring, we noticed %(hostname)s has a read-only filesystem.
 657
 658 Please verify the integrity of the disk and email the site if a replacement is needed.
 659
 660 Thanks.
 661
 662   -- PlanetLab Central (support@planet-lab.org)
 663 """)
 664
 665
 666         clock_drift=("""Planetlab node %(hostname)s and NTP.""", """As part of PlanetLab node monitoring, we noticed %(hostname)s cannot reach our NTP server.
 667
 668 Please verify that the NTP port (tcp/123) is not blocked by your site.
 669
 670 Thanks.
 671
 672   -- PlanetLab Central (support@planet-lab.org)
 673 """)
 674
 675
 676
 677         removedSliceCreation=("""PlanetLab slice creation/renewal suspension.""","""As part of PlanetLab node monitoring, we noticed the %(loginbase)s site has less than 2 nodes up.  We have attempted to contact the PI and Technical contacts %(times)s times and have not received a response.
 678
 679 Slice creation and renewal are now suspended for the %(loginbase)s site.  Please be aware that failure to respond will result in the automatic suspension of all running slices on PlanetLab.
 680
 681
 682   -- PlanetLab Central (support@planet-lab.org)
 683 """)
 684
 685
 686         suspendSlices=("""PlanetLab slices suspended.""","""As part of PlanetLab node monitoring, we noticed the %(loginbase)s site has less than 2 nodes up.  We have attempted to contact the PI and Technical contacts %(times)s times and have not received a response.
 687
 688 All %(loginbase)s slices are now suspended.
 689
 690
 691   -- PlanetLab Central (support@planet-lab.org)
 692 """)
 693
 694
 695         pcu_broken=("""%(hostname)s failed to reinstall""","""Hello,
 696
 697    %(hostname)s was remotely rebooted via your power control unit but has not contacted PlanetLab since. It should contact upon every boot, hence we believe that either the node has some hardware problems, is not properly connected to the power control unit, or has network connectivity issues. Could you please reboot the node and watch the console for error messages?
 698
 699
 700 Thanks.
 701
 702 -- PlanetLab Central (support@planet-lab.org)
 703 """)
 704
 705
 706         no_pcu=("""Hello,
 707
 708 We have set %(hostname)s to reinstall, but because your site does not have a power control unit, we are unable to powercycle the node.  Please
 709
 710 Thanks.
 711
 712 -- PlanetLab Central (support@planet-lab.org)
 713 """)
 714