2 # Copyright (c) 2004 The Trustees of Princeton University (Trustees).
4 # Faiyaz Ahmed <faiyaza@cs.princeton.edu>
6 # $Id: emailTxt.py,v 1.10 2007/08/29 17:26:50 soltesz Exp $
10 # This file contains the texts of the automatically generated
11 # emails sent to techs and PIs
16 thankyou=("""Thank you for helping maintain your PlanetLab nodes - %(loginbase)s""",
18 While monitoring your site, we noticed that the following nodes *improved*
22 Often, system administration is a thankless job, but not today. :-)
25 -- %(plc_name)s (%(support_email)s)
28 PROD- This state is the production state where the node can contact PlanetLab,
29 and install slices from users.
30 DEBUG- This state designates a node that could not boot successfully.
31 OLDBOOTCD- This state corresponds to the situation where an oldbootcd prevented
32 the normal operation of the node.
33 ERROR- This is an error state, where there is absolutely no contact
37 #############################################################################
38 #############################################################################
39 #############################################################################
41 pcumissing_notice =("""There is no PCU available to reboot %(hostname)s""",
42 """We've noticed that there is no PCU associated with %(hostname)s, so we could
43 not reboot it ourselves.
45 By taking a few moments now to register your PCU for this host, you will save
46 time in the future the next time we need to reboot this machine, because we
47 will be able to do so without disturbing you.
49 http://%(plc_hostname)s/registerwizard/index.php
51 The registration is very quick. All we need are: PCU hostname, IP, username,
52 and password. Then, choose which node to associate it with, and we will take
55 Thank you very much for your help,
56 -- %(plc_name)s (%(support_email)s)
59 pcufailed_notice =("""Could not use PCU to reboot %(hostname)s""",
61 """We tried to use the PCU registered for %(hostname)s, but for some reason
62 the host did not come back online. You may be able to learn more by visiting
65 https://%(monitor_hostname)s/monitor/pcuview?loginbase=%(loginbase)s
67 We need your help resolving this issue in a few ways:
69 1. First, we need your help rebooting %(hostname)s. Because the above PCU does
70 not appear to work, please manually reboot this machine. If it turns out
71 that there is a problem with the PCU configuration, we can help you
72 resolve that independently.
74 2. If it is possible, please correcct the above PCU problem, or let us know
75 what steps you are taking. By enabling us to take administrative actions
76 automatically without your intervention, you will save time in the future
77 the next time we need to reboot this machine, because we will be able to
78 do so without disturbing you.
80 3. If there is nothing apparently wrong with the PCU, or the mapping between
81 the PCU and the host, then there is likely a problem with our bootstrap
82 software on your machine. To help us, please make a note of any text on
83 the console and report it to mailto:%(support_email)s . An example
84 might be that the console hangs waiting for a module to unload. The last
85 reported name or any error messages on the screen would be very helpful.
87 If the PCU is up and running, but behind a firewall, please make it accessible
88 from address block 128.112.139.0/24. You can confirm that this is the address
89 space from which the %(plc_name)s servers run.
91 Thank you very much for your help,
92 -- %(plc_name)s (%(support_email)s)
95 online_notice=("""Host %(hostname)s is online""",
97 This notice is simply to let you know that:
100 is online and operational.
102 http://%(monitor_hostname)s/monitor/pcuview?loginbase=%(loginbase)s
104 Thank you very much for your help!
105 -- %(plc_name)s (%(support_email)s)
107 test_notice=("""Host %(hostname)s is testing""",
109 This notice is simply to test whether notices work.
112 Thank you very much for your help!
114 retry_bootman=("""Running BootManager on %(hostname)s""",
116 This notice is simply to let you know that:
119 appears stuck in a debug mode. To try to correct this, we're trying to rerun BootManager.py.
120 If any action is needed from you, you will recieve additional notices. Thank you!
122 down_notice=("""Host %(hostname)s is down""",
124 This notice is simply to let you know that:
127 is down, disconnected from the network and/or non-operational.
129 Please investigate, and let us know if there's anything we can do to help get
130 it back on-line. You can see more information about the current status of
133 http://%(monitor_hostname)s/monitor/pcuview?loginbase=%(loginbase)s
135 Thank you very much for your help,
136 -- %(plc_name)s (%(support_email)s)
139 clear_penalty=("""All privileges restored to site %(loginbase)s""",
141 This notice is to let you know that any privileges previously reduced at your
142 site have been restored: %(penalty_level)s.
144 All privileges are restored. You may create slices again, and if your
145 slices were disabled, please allow up to 30 minutes for them to return to
148 http://%(monitor_hostname)s/monitor/pcuview?loginbase=%(loginbase)s
150 Thank you very much for your help,
151 -- %(plc_name)s (%(support_email)s)
155 0 - no penalties applied
156 1 - site is disabled. no new slices can be created.
157 2+ - all existing slices will be disabled.
160 increase_penalty=("""Privilege reduced for site %(loginbase)s""",
162 This notice is to let you know that the privileges granted to your site as
163 a participating member of Planetlab have reduced: %(penalty_level)s.
165 Your privileges will be reduced corresponding to the legend below. To
166 restore these privileges, please return at least two machines to working
169 http://%(monitor_hostname)s/monitor/pcuview?loginbase=%(loginbase)s
171 Thank you very much for your help,
172 -- %(plc_name)s (%(support_email)s)
176 0 - no penalty applied
177 1 - site is disabled. no new slices can be created.
178 2+ - all existing slices will be disabled.
181 newbootcd_notice=("""Host %(hostname)s needs a new BootImage""", """
182 We noticed the following node has an out-dated BootImage:
186 This usually implies that you need to update the BootImage and node
187 configuration file stored on the read-only media (either the all-in-one ISO
188 CD, floppy disk, or write-protected USB stick).
190 You can do this by walking through the steps of the registration wizard, and
191 downloading a new BootImage for your machine.
193 https://%(plc_hostname)s/registerwizard/index.php
195 Thank you for your help,
196 -- %(plc_name)s (%(support_email)s)
200 newalphacd_notice=("""New Boot Images for %(hostname)s""",
201 """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.
205 To make this process as simple as possible, we have created All-in-One boot images that include the node configuration file.
207 The only step that you need to take is to choose which media you prefer, either CD ISO, or USB image for each host.
211 Instructions to burn or copy these All-in-One images to the appropriate media are available in the Technical Contact's Guide.
213 https://%(plc_hostname)s/doc/guides/bootcdsetup
215 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_email)s) 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.
217 Thank you for your help,
218 -- %(plc_name)s (%(support_email)s)
222 # TODO: need reminder versions for repeats...
223 #newdown=[newdown_one, newdown_two, newdown_three]
224 #newbootcd=[newbootcd_one, newbootcd_two, newbootcd_three]
225 #newalphacd=[newalphacd_one, newalphacd_one, newalphacd_one]
226 #newthankyou=[thankyou,thankyou,thankyou]
227 #pcuthankyou=[pcuthankyou_one,pcuthankyou_one,pcuthankyou_one]
228 #pcutonodemapping=[pcutonodemapping_one, pcutonodemapping_one, pcutonodemapping_one]
229 #pcudown=[pcudown_one, pcudown_one, pcudown_one]
231 unknownsequence_notice = ("""Unrecognized Error on PlanetLab host %(hostname)s""",
233 While trying to automatically recover this machine:
235 http://%(plc_hostname)s/db/nodes/index.php?pattern=%(hostname)s
236 https://%(monitor_hostname)s/monitor/pcuview?hostname=%(hostname)s
238 We encountered an unknown situation. Please re-code to handle, or manually intervene to repair this host.
240 Abbreviated BootManager Sequence:
244 BootManager.log output follows:
245 ---------------------------------------------------------
250 minimalhardware_notice = ("""Hardware requirements not met on PlanetLab host %(hostname)s""",
252 While trying to automatically recover this machine:
254 http://%(plc_hostname)s/db/nodes/index.php?pattern=%(hostname)s
256 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.
258 If your machine does not meet the current hardware specifications for a PlanetLab node (http://%(plc_hostname)s/hardware), please upgrade it to meet the current recommended configuration.
260 If you believe this message is an error, please email %(support_email)s explaining the problem. You may need to create an updated Boot Image that includes drivers for your hardware.
265 BootManager.log output follows:
266 ---------------------------------------------------------
270 baddisk_notice = ("""Bad Disk on PlanetLab node %(hostname)s""",
271 """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.
273 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_email)s.
277 -- %(plc_name)s (%(support_email)s)
279 The output of `dmesg` follows:
280 -------------------------------------------------------------------------
286 nodeconfig_notice=(""" Please Update Configuration file for PlanetLab node %(hostname)s""",
287 """As part of PlanetLab node monitoring, we noticed %(hostname)s has an out-dated plnode.txt file.
289 Either our boot scripts cannot find it because the boot media is corrupted, or it has no NODE_ID or a mis-matched HOSTNAME. This can happen either due to a configuration mistake at your site, with bad information entered into our database, or after a necessary software upgrade. To resolve the issue we require your assistance. All that is needed is to visit:
291 https://%(plc_hostname)s/db/nodes/index.php?pattern=%(hostname)s
293 Then double check the network settings for your host.
295 Then, select, "Download -> Download ISO image for %(hostname)s" menu. This will generate a new All-in-one BootImage file for your node. Copy this file to the appropriate read-only media, and reboot the machine.
297 There is no need to respond to this message. If you're able to update the boot image without difficulty and your node returns to normal operation, please accept our thanks. However, if there are any console messages relating to the node's failure, please report them to PlanetLab support (%(support_email)s) so we can help resolve the issue.
299 Thank you for your help,
300 -- %(plc_name)s (%(support_email)s)
303 baddns_notice=("""Planetlab node down: broken DNS configuration for %(hostname)s""",
304 """As part of PlanetLab node monitoring, we noticed the DNS servers used by the following machine(s) are not responding to queries.
308 The conseuqnece of this is that the node cannot boot correctly, and is not a functioning part of the PlanetLab network.
310 To help us return this machine to running order, please verify that the registered DNS servers in the node network configuration are correct.
314 You may update the node's network information at the link below:
316 https://%(plc_hostname)s/db/nodes/node_networks.php?id=%(interface_id)s
318 If you have any questions, please feel free to contact us at PlanetLab Support (%(support_email)s).
320 Thank you for your help,
321 -- %(plc_name)s (%(support_email)s)
324 #############################################################################
325 #############################################################################
326 #############################################################################
329 filerw=("""Planetlab node %(hostname)s has a bad disk.""", """As part of PlanetLab node monitoring, we noticed %(hostname)s has a read-only filesystem.
331 Please verify the integrity of the disk and email the site if a replacement is needed.
335 -- %(plc_name)s (%(support_email)s)
339 clock_drift=("""Planetlab node %(hostname)s and NTP.""", """As part of PlanetLab node monitoring, we noticed %(hostname)s cannot reach our NTP server.
341 Please verify that the NTP port (tcp/123) is not blocked by your site.
345 -- %(plc_name)s (%(support_email)s)