+ updated tech guide url to go directly to NodeInstallation
[monitor.git] / 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.7 2007/06/29 12:42:22 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 recent BootCD is installed in the machine (Version 3.0 or greater).  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.
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/local/planetlab/bin/pl-ps
32
33 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:
34
35     https://www.planet-lab.org/doc/guides/tech#NodeInstallation
36
37 If after following these directions and finding your machine reported by CoMon, 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 Thank you for your help,
40   -- PlanetLab Central (support@planet-lab.org)
41 """)
42
43         newdown_two=("""PlanetLab node(s) down: %(loginbase)s""", 
44 """
45 Hello,
46
47 As part of PlanetLab node monitoring, we noticed the following nodes were down at your site:
48
49 %(hostname_list)s 
50 We're writing again because our previous correspondence 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.
51
52 To help, please confirm that a recent BootCD is installed in the machine (Version 3.0 or greater).  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.
53
54         http://summer.cs.princeton.edu/status/tabulator.cgi?table=nodes/table_%(hostname)s&limit=50
55
56 If the machine has booted successfully, you may check it more quickly by logging in with your site_admin account, and running:
57
58     sudo /usr/local/planetlab/bin/pl-ps
59
60 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:
61
62     https://www.planet-lab.org/doc/guides/tech#NodeInstallation
63
64 If after following these directions and finding your machine reported by CoMon, 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.
65
66 Thank you for your help,
67   -- PlanetLab Central (support@planet-lab.org)
68 """)
69
70         newdown_three=("""PlanetLab node(s) down: %(loginbase)s""", 
71 """
72 Hello,
73
74 As part of PlanetLab node monitoring, we noticed the following nodes were down at your site:
75
76 %(hostname_list)s 
77 We understand that machine maintenance can take time.  We're writing again because our previous correspondence has 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.
78
79 To help, please confirm that a recent BootCD is installed in the machine (Version 3.0 or greater).  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.
80
81         http://summer.cs.princeton.edu/status/tabulator.cgi?table=nodes/table_%(hostname)s&limit=50
82
83 If the machine has booted successfully, you may check it more quickly by logging in with your site_admin account, and running:
84
85     sudo /usr/local/planetlab/bin/pl-ps
86
87 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:
88
89     https://www.planet-lab.org/doc/guides/tech#NodeInstallation
90
91 If after following these directions and finding your machine reported by CoMon, 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.
92
93 Thank you for your help,
94   -- PlanetLab Central (support@planet-lab.org)
95 """)
96
97         newbootcd_one=(""" Planetlab nodes need a new BootCD: %(loginbase)s""", # : %(hostname)s""", 
98 """As part of PlanetLab node monitoring, we noticed the following nodes have an out-dated BootCD: 
99
100 %(hostname_list)s  
101 This usually implies that you need to update both the BootCD and regenerate the plnode.txt file stored on the read-only media (Either floppy disk or write-protected USB stick).
102
103 To check the status of these and any other machines that you manage please visit:
104
105     http://comon.cs.princeton.edu/status
106
107 Instructions to perform the steps necessary for a BootCD upgrade are available in the Technical Contact's Guide.
108
109     https://www.planet-lab.org/doc/guides/tech#NodeInstallation
110
111 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.  
112
113 Thank you for your help,
114   -- PlanetLab Central (support@planet-lab.org)
115 """)
116         newbootcd_two=(""" Planetlab nodes need a new BootCD: %(loginbase)s""", # : %(hostname)s""", 
117 """As part of PlanetLab node monitoring, we noticed the following nodes have an out-dated BootCD: 
118
119 %(hostname_list)s  
120 This usually implies that you need to update both the BootCD and regenerate the plnode.txt file stored on the read-only media (Either floppy disk or write-protected USB stick).
121
122 We're writing again because our previous correspondence 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.
123
124 To check the status of these and any other machines that you manage please visit:
125
126     http://comon.cs.princeton.edu/status
127
128 Instructions to perform the steps necessary for a BootCD upgrade are available in the Technical Contact's Guide.
129
130     https://www.planet-lab.org/doc/guides/tech#NodeInstallation
131
132 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.  
133
134 Thank you for your help,
135   -- PlanetLab Central (support@planet-lab.org)
136 """)
137         newbootcd_three=(""" Planetlab nodes need a new BootCD: %(loginbase)s""", # : %(hostname)s""", 
138 """As part of PlanetLab node monitoring, we noticed the following nodes have an out-dated BootCD: 
139
140 %(hostname_list)s  
141 This usually implies that you need to update both the BootCD and regenerate the plnode.txt file stored on the read-only media (Either floppy disk or write-protected USB stick).
142
143 We understand that machine maintenance can take time.  We're writing again because our previous correspondence has 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.
144
145 To check the status of these and any other machines that you manage please visit:
146
147     http://comon.cs.princeton.edu/status
148
149 Instructions to perform the steps necessary for a BootCD upgrade are available in the Technical Contact's Guide.
150
151     https://www.planet-lab.org/doc/guides/tech#NodeInstallation
152
153 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.  
154
155 Thank you for your help,
156   -- PlanetLab Central (support@planet-lab.org)
157 """)
158         newdown=[newdown_one, newdown_two, newdown_three]
159         newbootcd=[newbootcd_one, newbootcd_two, newbootcd_three]
160
161         down=("""PlanetLab node %(hostname)s down.""", """As part of PlanetLab node monitoring, we noticed %(hostname)s has been down for %(days)s days.
162
163 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.
164
165 http://summer.cs.princeton.edu/status/tabulator.cgi?table=table_nodeviewshort&select='address==%(hostbyteorder)s'
166
167 http://www.planet-lab.org/db/sites/index.php?id=%(site_id)d
168
169 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. 
170
171 Thanks.
172
173
174   -- PlanetLab Central (support@planet-lab.org)
175 """)
176
177         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.  
178
179 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.
180
181 http://summer.cs.princeton.edu/status/tabulator.cgi?table=table_nodeviewshort&select='address==%(hostbyteorder)s'
182
183 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. 
184
185 Thank you for your help,
186   -- PlanetLab Central (support@planet-lab.org)
187 """)
188
189         planet_cnf=(""" Planetlab node %(hostname)s needs an updated configuration file""", """As part of PlanetLab node monitoring, we noticed %(hostname)s has an out-dated planet.cnf file with no NODE_ID.  This can happen after an upgrade and requires your assistance in correcting.  All that is needed is to visit:
190
191         https://www.planet-lab.org/db/nodes/index.php?id=%(node_id)d
192
193 And follow the "Download conf file" link to generate a new configuration file for each node.  Copy this file to the appropriate read-only media, either floppy or USB stick, and reboot the machines.
194
195 There's no need to respond to this message if you're able to update the configuration files 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. 
196
197 Thank you for your help,
198   -- PlanetLab Central (support@planet-lab.org)
199 """)
200
201         bootcd=(""" Planetlab node %(hostname)s needs a new BootCD""", 
202 """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).
203
204 Instructions to perform the steps necessary for a BootCD upgrade are available in the Technical Contact Guide.
205     https://www.planet-lab.org/doc/guides/tech#NodeInstallation
206
207 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. 
208
209 Thanks you for your help,
210   -- PlanetLab Central (support@planet-lab.org)
211 """)
212
213         ssh=("""Planetlab node %(hostname)s down.""", """As part of PlanetLab node monitoring, we noticed node %(hostname)s is not available for ssh.
214
215 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.
216
217 http://summer.cs.princeton.edu/status/tabulator.cgi?table=table_nodeviewshort&select='address==%(hostbyteorder)s'
218
219 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. 
220
221 Thanks.
222
223
224   -- PlanetLab Central (support@planet-lab.org)
225 """)
226
227
228         dns=("""Planetlab node %(hostname)s down.""", """As part of PlanetLab node monitoring, we noticed the DNS servers used by  %(hostname)s are not responding to queries.
229
230 Please verify the DNS information used by the node is correct.  You can find directions on how to update the node's network information on the PlanetLab Technical Contacts Guid (http://www.planet-lab.org/doc/TechsGuide.php#id268898).
231
232 Thanks.
233
234   -- PlanetLab Central (support@planet-lab.org)
235 """)
236
237
238         filerw=("""Planetlab node %(hostname)s has a bad disk.""", """As part of PlanetLab node monitoring, we noticed %(hostname)s has a read-only filesystem.
239
240 Please verify the integrity of the disk and email the site if a replacement is needed. 
241
242 Thanks.
243
244   -- PlanetLab Central (support@planet-lab.org)
245 """)
246
247
248         clock_drift=("""Planetlab node %(hostname)s and NTP.""", """As part of PlanetLab node monitoring, we noticed %(hostname)s cannot reach our NTP server.
249
250 Please verify that the NTP port (tcp/123) is not blocked by your site. 
251
252 Thanks.
253
254   -- PlanetLab Central (support@planet-lab.org)
255 """)
256
257   
258
259         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.  
260
261 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.
262
263
264   -- PlanetLab Central (support@planet-lab.org)
265 """)
266
267
268         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.  
269
270 All %(loginbase)s slices are now suspended.  
271
272
273   -- PlanetLab Central (support@planet-lab.org)
274 """)
275
276
277         pcu_broken=("""%(hostname)s failed to reinstall""","""Hello,
278
279    %(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? 
280
281
282 Thanks.
283
284 -- PlanetLab Central (support@planet-lab.org)
285 """)
286
287
288         no_pcu=("""Hello,
289
290 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  
291
292 Thanks.
293
294 -- PlanetLab Central (support@planet-lab.org)
295 """)
296