r2666 - introduced LDAPCache table (ticket:193)
[racktables] / upgrade.php
1 <?php
2
3 $relnotes = array
4 (
5 '0.17.0' => "This release requires changes to the configuration file. " .
6 "Move inc/secret.php to local/secret.php and add the following to the file:<br><br>" .
7 "\$user_auth_src = 'database';<br>\$require_valid_user = TRUE;<br><br>" .
8 "(and adjust to your needs, if necessary)<br>" .
9 "Another change is the addition of support for file uploads. Files are stored<br>" .
10 "in the database. There are several settings in php.ini which you may need to modify:<br>" .
11 "<ul><li>file_uploads - needs to be On</li>" .
12 "<li>upload_max_filesize - max size for uploaded files</li>" .
13 "<li>post_max_size - max size of all form data submitted via POST (including files)</li></ul><br>" .
14 "User accounts used to have 'enabled' flag, which allowed individual blocking and<br>" .
15 "unblocking of each. This flag was dropped in favor of existing mean of access<br>" .
16 "setup (RackCode). An unconditional denying rule is automatically added into RackCode<br>" .
17 "for such blocked account, so the effective security policy remains the same.<br>",
18 );
19
20 // At the moment we assume, that for any two releases we can
21 // sequentally execute all batches, that separate them, and
22 // nothing will break. If this changes one day, the function
23 // below will have to generate smarter upgrade paths, while
24 // the upper layer will remain the same.
25 // Returning an empty array means that no upgrade is necessary.
26 // Returning NULL indicates an error.
27 function getDBUpgradePath ($v1, $v2)
28 {
29 $versionhistory = array
30 (
31 '0.16.4',
32 '0.16.5',
33 '0.16.6',
34 '0.17.0',
35 );
36 if (!in_array ($v1, $versionhistory) or !in_array ($v2, $versionhistory))
37 return NULL;
38 $skip = TRUE;
39 $path = NULL;
40 // Now collect all versions > $v1 and <= $v2
41 foreach ($versionhistory as $v)
42 {
43 if ($skip and $v == $v1)
44 {
45 $skip = FALSE;
46 $path = array();
47 continue;
48 }
49 if ($skip)
50 continue;
51 $path[] = $v;
52 if ($v == $v2)
53 break;
54 }
55 return $path;
56 }
57
58 // Upgrade batches are named exactly as the release where they first appear.
59 // That is simple, but seems sufficient for beginning.
60 function executeUpgradeBatch ($batchid)
61 {
62 $query = array();
63 global $dbxlink;
64 switch ($batchid)
65 {
66 case '0.16.5':
67 $query[] = "INSERT INTO `Config` (varname, varvalue, vartype, emptyok, is_hidden, description) VALUES ('IPV4_TREE_SHOW_USAGE','yes','string','no','no','Show address usage in IPv4 tree')";
68 $query[] = "update Config set varvalue = '0.16.5' where varname = 'DB_VERSION'";
69 break;
70 case '0.16.6':
71 $query[] = "update Config set varvalue = '0.16.6' where varname = 'DB_VERSION'";
72 break;
73 case '0.17.0':
74 // create tables for storing files (requires InnoDB support)
75 if (!isInnoDBSupported ())
76 {
77 showError ("Cannot upgrade because InnoDB tables are not supported by your MySQL server. See the README for details.", __FILE__);
78 die;
79 }
80
81 $query[] = "alter table Chapter change chapter_no id int(10) unsigned NOT NULL auto_increment";
82 $query[] = "alter table Chapter change chapter_name name char(128) NOT NULL";
83 $query[] = "alter table Chapter drop key chapter_name";
84 $query[] = "alter table Chapter add UNIQUE KEY name (name)";
85 $query[] = "alter table Attribute change attr_id id int(10) unsigned NOT NULL auto_increment";
86 $query[] = "alter table Attribute change attr_type type enum('string','uint','float','dict') default NULL";
87 $query[] = "alter table Attribute change attr_name name char(64) default NULL";
88 $query[] = "alter table Attribute drop key attr_name";
89 $query[] = "alter table Attribute add UNIQUE KEY name (name)";
90 $query[] = "alter table AttributeMap change chapter_no chapter_id int(10) unsigned NOT NULL";
91 $query[] = "alter table Dictionary change chapter_no chapter_id int(10) unsigned NOT NULL";
92 // Many dictionary changes were made... remove all dictvendor entries and install fresh.
93 // Take care not to erase locally added records. 0.16.x ends with max key 797
94 $query[] = 'DELETE FROM Dictionary WHERE ((chapter_id BETWEEN 11 AND 14) or (chapter_id BETWEEN 16 AND 19) ' .
95 'or (chapter_id BETWEEN 21 AND 24)) and dict_key <= 797';
96 $f = fopen ("install/init-dictvendors.sql", 'r');
97 if ($f === FALSE)
98 {
99 showError ("Failed to open install/init-dictvendors.sql for reading");
100 die;
101 }
102 $longq = '';
103 while (!feof ($f))
104 {
105 $line = fgets ($f);
106 if (ereg ('^--', $line))
107 continue;
108 $longq .= $line;
109 }
110 fclose ($f);
111 foreach (explode (";\n", $longq) as $dict_query)
112 {
113 if (empty ($dict_query))
114 continue;
115 $query[] = $dict_query;
116 }
117
118 // schema changes for file management
119 $query[] = "
120 CREATE TABLE `File` (
121 `id` int(10) unsigned NOT NULL auto_increment,
122 `name` char(255) NOT NULL,
123 `type` char(255) NOT NULL,
124 `size` int(10) unsigned NOT NULL,
125 `ctime` datetime NOT NULL,
126 `mtime` datetime NOT NULL,
127 `atime` datetime NOT NULL,
128 `contents` longblob NOT NULL,
129 `comment` text,
130 PRIMARY KEY (`id`),
131 UNIQUE KEY `name` (`name`)
132 ) ENGINE=InnoDB";
133 $query[] = "
134 CREATE TABLE `FileLink` (
135 `id` int(10) unsigned NOT NULL auto_increment,
136 `file_id` int(10) unsigned NOT NULL,
137 `entity_type` enum('ipv4net','ipv4rspool','ipv4vs','object','rack','user') NOT NULL default 'object',
138 `entity_id` int(10) NOT NULL,
139 PRIMARY KEY (`id`),
140 UNIQUE KEY `FileLink-unique` (`file_id`,`entity_type`,`entity_id`),
141 KEY `FileLink-file_id` (`file_id`),
142 CONSTRAINT `FileLink-File_fkey` FOREIGN KEY (`file_id`) REFERENCES `File` (`id`) ON DELETE CASCADE ON UPDATE CASCADE
143 ) ENGINE=InnoDB";
144 $query[] = "ALTER TABLE TagStorage MODIFY COLUMN target_realm enum('file','ipv4net','ipv4rspool','ipv4vs','object','rack','user') NOT NULL default 'object'";
145
146 // add network security as an object type
147 $query[] = "INSERT INTO `Chapter` (`id`, `sticky`, `name`) VALUES (24,'no','network security models')";
148 $query[] = "INSERT INTO `AttributeMap` (`objtype_id`, `attr_id`, `chapter_id`) VALUES (798,1,0)";
149 $query[] = "INSERT INTO `AttributeMap` (`objtype_id`, `attr_id`, `chapter_id`) VALUES (798,2,24)";
150 $query[] = "INSERT INTO `AttributeMap` (`objtype_id`, `attr_id`, `chapter_id`) VALUES (798,3,0)";
151 $query[] = "INSERT INTO `AttributeMap` (`objtype_id`, `attr_id`, `chapter_id`) VALUES (798,5,0)";
152 $query[] = "INSERT INTO `AttributeMap` (`objtype_id`, `attr_id`, `chapter_id`) VALUES (798,14,0)";
153 $query[] = "INSERT INTO `AttributeMap` (`objtype_id`, `attr_id`, `chapter_id`) VALUES (798,16,0)";
154 $query[] = "INSERT INTO `AttributeMap` (`objtype_id`, `attr_id`, `chapter_id`) VALUES (798,17,0)";
155 $query[] = "INSERT INTO `AttributeMap` (`objtype_id`, `attr_id`, `chapter_id`) VALUES (798,18,0)";
156 $query[] = "INSERT INTO `AttributeMap` (`objtype_id`, `attr_id`, `chapter_id`) VALUES (798,20,0)";
157 $query[] = "INSERT INTO `AttributeMap` (`objtype_id`, `attr_id`, `chapter_id`) VALUES (798,21,0)";
158 $query[] = "INSERT INTO `AttributeMap` (`objtype_id`, `attr_id`, `chapter_id`) VALUES (798,22,0)";
159 $query[] = "INSERT INTO `AttributeMap` (`objtype_id`, `attr_id`, `chapter_id`) VALUES (798,24,0)";
160 $query[] = "UPDATE Dictionary SET dict_value = 'Network switch' WHERE dict_key = 8";
161 $query[] = 'alter table IPBonds rename to IPv4Allocation';
162 $query[] = 'alter table PortForwarding rename to IPv4NAT';
163 $query[] = 'alter table IPRanges rename to IPv4Network';
164 $query[] = 'alter table IPAddress rename to IPv4Address';
165 $query[] = 'alter table IPLoadBalancer rename to IPv4LB';
166 $query[] = 'alter table IPRSPool rename to IPv4RSPool';
167 $query[] = 'alter table IPRealServer rename to IPv4RS';
168 $query[] = 'alter table IPVirtualService rename to IPv4VS';
169 $query[] = "alter table TagStorage change column target_realm entity_realm enum('file','ipv4net','ipv4vs','ipv4rspool','object','rack','user') NOT NULL default 'object'";
170 $query[] = 'alter table TagStorage change column target_id entity_id int(10) unsigned NOT NULL';
171 $query[] = 'alter table TagStorage drop key entity_tag';
172 $query[] = 'alter table TagStorage drop key target_id';
173 $query[] = 'alter table TagStorage add UNIQUE KEY `entity_tag` (`entity_realm`,`entity_id`,`tag_id`)';
174 $query[] = 'alter table TagStorage add KEY `entity_id` (`entity_id`)';
175 $query[] = "INSERT INTO `Config` (varname, varvalue, vartype, emptyok, is_hidden, description) VALUES ('PREVIEW_TEXT_MAXCHARS','10240','uint','yes','no','Max chars for text file preview')";
176 $query[] = "INSERT INTO `Config` (varname, varvalue, vartype, emptyok, is_hidden, description) VALUES ('PREVIEW_TEXT_ROWS','25','uint','yes','no','Rows for text file preview')";
177 $query[] = "INSERT INTO `Config` (varname, varvalue, vartype, emptyok, is_hidden, description) VALUES ('PREVIEW_TEXT_COLS','80','uint','yes','no','Columns for text file preview')";
178 $query[] = "INSERT INTO `Config` (varname, varvalue, vartype, emptyok, is_hidden, description) VALUES ('PREVIEW_IMAGE_MAXPXS','320','uint','yes','no','Max pixels per axis for image file preview')";
179 $query[] = "INSERT INTO `Config` (varname, varvalue, vartype, emptyok, is_hidden, description) VALUES ('VENDOR_SIEVE','','string','yes','no','Vendor sieve configuration')";
180 $query[] = "INSERT INTO `Config` (varname, varvalue, vartype, emptyok, is_hidden, description) VALUES ('IPV4LB_LISTSRC','{$typeid_4}','string','yes','no','List source: IPv4 load balancers')";
181 $query[] = "INSERT INTO `Config` (varname, varvalue, vartype, emptyok, is_hidden, description) VALUES ('IPV4OBJ_LISTSRC','{$typeid_4} or {$typeid_7} or {$typeid_8} or {$typeid_12} or {$typeid_445} or {$typeid_447}','string','yes','no','List source: IPv4-enabled objects')";
182 $query[] = "INSERT INTO `Config` (varname, varvalue, vartype, emptyok, is_hidden, description) VALUES ('IPV4NAT_LISTSRC','{$typeid_4} or {$typeid_7} or {$typeid_8}','string','yes','no','List source: IPv4 NAT performers')";
183 $query[] = "INSERT INTO `Config` (varname, varvalue, vartype, emptyok, is_hidden, description) VALUES ('ASSETWARN_LISTSRC','{$typeid_4} or {$typeid_7} or {$typeid_8}','string','yes','no','List source: object, for which asset tag should be set')";
184 $query[] = "INSERT INTO `Config` (varname, varvalue, vartype, emptyok, is_hidden, description) VALUES ('NAMEWARN_LISTSRC','{$typeid_4} or {$typeid_7} or {$typeid_8}','string','yes','no','List source: object, for which common name should be set')";
185 $query[] = "INSERT INTO `Config` (varname, varvalue, vartype, emptyok, is_hidden, description) VALUES ('RACKS_PER_ROW','12','unit','yes','no','Racks per row')";
186 $query[] = "delete from Config where varname = 'USER_AUTH_SRC'";
187 $query[] = "delete from Config where varname = 'COOKIE_TTL'";
188 $query[] = "delete from Config where varname = 'rtwidth_0'";
189 $query[] = "delete from Config where varname = 'rtwidth_1'";
190 $query[] = "delete from Config where varname = 'rtwidth_2'";
191 $query[] = "delete from Config where varname = 'NAMEFUL_OBJTYPES'";
192 $query[] = "delete from Config where varname = 'REQUIRE_ASSET_TAG_FOR'";
193 $query[] = "delete from Config where varname = 'IPV4_PERFORMERS'";
194 $query[] = "delete from Config where varname = 'NATV4_PERFORMERS'";
195 $query[] = "alter table TagTree add column valid_realm set('file','ipv4net','ipv4vs','ipv4rspool','object','rack','user') not null default 'file,ipv4net,ipv4vs,ipv4rspool,object,rack,user' after parent_id";
196 $result = $dbxlink->query ("select user_id, user_name, user_realname from UserAccount where user_enabled = 'no'");
197 while ($row = $result->fetch (PDO::FETCH_ASSOC))
198 $query[] = "update Script set script_text = concat('deny {\$userid_${row['user_id']}} # ${row['user_name']} (${row['user_realname']})\n', script_text) where script_name = 'RackCode'";
199 $query[] = "update Script set script_text = NULL where script_name = 'RackCodeCache'";
200 unset ($result);
201 $query[] = "alter table UserAccount drop column user_enabled";
202
203 $query[] = "CREATE TABLE RackRow ( id int(10) unsigned NOT NULL auto_increment, name char(255) NOT NULL, PRIMARY KEY (`id`) ) ENGINE=MyISAM";
204
205 $result = $dbxlink->query ("select dict_key, dict_value from Dictionary where chapter_no = 3");
206 while($row = $result->fetch(PDO::FETCH_NUM))
207 {
208 $query[] = "insert into RackRow set id=${row[0]}, name='${row[1]}'";
209 }
210 $query[] = "delete from Dictionary where chapter_id = 3";
211 $query[] = "
212 CREATE TABLE `LDAPCache` (
213 `presented_username` char(64) NOT NULL,
214 `successful_hash` char(40) NOT NULL,
215 `first_success` timestamp NOT NULL default CURRENT_TIMESTAMP,
216 `last_retry` timestamp NOT NULL default '0000-00-00 00:00:00',
217 `displayed_name` char(128) default NULL,
218 `memberof` text,
219 UNIQUE KEY `presented_username` (`presented_username`),
220 KEY `scanidx` (`presented_username`,`successful_hash`)
221 ) ENGINE=InnoDB;";
222
223 $query[] = "UPDATE Config SET varvalue = '0.17.0' WHERE varname = 'DB_VERSION'";
224
225 break;
226 default:
227 showError ("executeUpgradeBatch () failed, because batch '${batchid}' isn't defined", __FILE__);
228 die;
229 break;
230 }
231 $failures = array();
232 echo "<tr><th>Executing batch '${batchid}'</th><td>";
233 foreach ($query as $q)
234 {
235 $result = $dbxlink->query ($q);
236 if ($result == NULL)
237 {
238 $errorInfo = $dbxlink->errorInfo();
239 $failures[] = array ($q, $errorInfo[2]);
240 }
241 }
242 if (!count ($failures))
243 echo "<strong><font color=green>done</font></strong>";
244 else
245 {
246 echo "<strong><font color=red>The following queries failed:</font></strong><br><pre>";
247 foreach ($failures as $f)
248 {
249 list ($q, $i) = $f;
250 echo "${q} -- ${i}\n";
251 }
252 echo "</pre>";
253 }
254 echo '</td></tr>';
255 }
256
257 // ******************************************************************
258 //
259 // Execution starts here
260 //
261 // ******************************************************************
262
263 $root = (empty($_SERVER['HTTPS']) or $_SERVER['HTTPS'] == 'off') ? 'http://' : 'https://';
264 $root .= isset ($_SERVER['HTTP_HOST']) ? $_SERVER['HTTP_HOST'] : ($_SERVER['SERVER_NAME'].($_SERVER['SERVER_PORT']=='80'?'':$_SERVER['SERVER_PORT']));
265 $root .= strtr (dirname ($_SERVER['PHP_SELF']), '\\', '/');
266 if (substr ($root, -1) != '/')
267 $root .= '/';
268
269 // The below will be necessary as long as we rely on showError()
270 require_once 'inc/interface.php';
271
272 require_once 'inc/config.php';
273 require_once 'inc/database.php';
274 if (file_exists ('local/secret.php'))
275 require_once 'local/secret.php';
276 else
277 die ("Database connection parameters are read from local/secret.php file, " .
278 "which cannot be found.\nCopy provided config/secret-sample.php to " .
279 "local/secret.php and modify to your setup.\n\nThen reload the page.");
280
281 try
282 {
283 $dbxlink = new PDO ($pdo_dsn, $db_username, $db_password);
284 }
285 catch (PDOException $e)
286 {
287 die ("Database connection failed:\n\n" . $e->getMessage());
288 }
289
290 // Now we need to be sure that the current user is the administrator.
291 // The rest doesn't matter within this context.
292
293 function authenticate_admin ($username, $password)
294 {
295 global $dbxlink;
296 $hash = sha1 ($password);
297 $query = "select count(*) from UserAccount where user_id = 1 and user_name = '${username}' and user_password_hash = '${hash}'";
298 if (($result = $dbxlink->query ($query)) == NULL)
299 die ('SQL query failed in ' . __FUNCTION__);
300 $rows = $result->fetchAll (PDO::FETCH_NUM);
301 return $rows[0][0] == 1;
302 }
303
304 switch ($user_auth_src)
305 {
306 case 'database':
307 case 'ldap': // authenticate against DB as well
308 if
309 (
310 !isset ($_SERVER['PHP_AUTH_USER']) or
311 !strlen ($_SERVER['PHP_AUTH_USER']) or
312 !isset ($_SERVER['PHP_AUTH_PW']) or
313 !strlen ($_SERVER['PHP_AUTH_PW']) or
314 !authenticate_admin (escapeString ($_SERVER['PHP_AUTH_USER']), escapeString ($_SERVER['PHP_AUTH_PW']))
315 )
316 {
317 header ('WWW-Authenticate: Basic realm="RackTables upgrade"');
318 header ('HTTP/1.0 401 Unauthorized');
319 showError ('You must be authenticated as an administrator to complete the upgrade.', __FILE__);
320 die;
321 }
322 break; // cleared
323 case 'httpd':
324 if
325 (
326 !isset ($_SERVER['REMOTE_USER']) or
327 !strlen ($_SERVER['REMOTE_USER'])
328 )
329 {
330 showError ('System misconfiguration. The web-server didn\'t authenticate the user, although ought to do.');
331 die;
332 }
333 break; // cleared
334 default:
335 showError ('authentication source misconfiguration', __FILE__);
336 die;
337 }
338
339 $dbver = getDatabaseVersion();
340 echo '<table border=1>';
341 echo "<tr><th>Current status</th><td>Data version: ${dbver}<br>Code version: " . CODE_VERSION . "</td></tr>\n";
342
343 $path = getDBUpgradePath ($dbver, CODE_VERSION);
344 if ($path === NULL)
345 {
346 echo "<tr><th>Upgrade path</th><td><font color=red>not found</font></td></tr>\n";
347 echo "<tr><th>Summary</th><td>Check README for more information.</td></tr>\n";
348 }
349 else
350 {
351 if (!count ($path))
352 echo "<tr><th>Summary</th><td>Come back later.</td></tr>\n";
353 else
354 {
355 echo "<tr><th>Upgrade path</th><td>${dbver} &rarr; " . implode (' &rarr; ', $path) . "</td></tr>\n";
356 foreach ($path as $batchid)
357 {
358 executeUpgradeBatch ($batchid);
359 if (isset ($relnotes[$batchid]))
360 echo "<tr><th>Release notes for ${batchid}</th><td>" . $relnotes[$batchid] . "</td></tr>\n";
361 }
362 echo "<tr><th>Summary</th><td>Upgrade complete, it is Ok to <a href='${root}'>enter</a> the system.</td></tr>\n";
363 }
364 }
365 echo '</table>';
366
367 ?>