Merge branch 'MDL-25708' of git://github.com/stronk7/moodle
[moodle.git] / lib / db / upgradelib.php
1 <?php
3 // This file is part of Moodle - http://moodle.org/
4 //
5 // Moodle is free software: you can redistribute it and/or modify
6 // it under the terms of the GNU General Public License as published by
7 // the Free Software Foundation, either version 3 of the License, or
8 // (at your option) any later version.
9 //
10 // Moodle is distributed in the hope that it will be useful,
11 // but WITHOUT ANY WARRANTY; without even the implied warranty of
12 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13 // GNU General Public License for more details.
14 //
15 // You should have received a copy of the GNU General Public License
16 // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
18 /**
19  * Upgrade helper functions
20  *
21  * This file is used for special upgrade functions - for example groups and gradebook.
22  * These functions must use SQL and database related functions only- no other Moodle API,
23  * because it might depend on db structures that are not yet present during upgrade.
24  * (Do not use functions from accesslib.php, grades classes or group functions at all!)
25  *
26  * @package    core
27  * @subpackage admin
28  * @copyright  2007 Petr Skoda (http://skodak.org)
29  * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
30  */
32 defined('MOODLE_INTERNAL') || die();
34 function upgrade_fix_category_depths() {
35     global $CFG, $DB;
37     // first fix incorrect parents
38     $sql = "SELECT c.id
39               FROM {course_categories} c
40              WHERE c.parent > 0 AND c.parent NOT IN (SELECT pc.id FROM {course_categories} pc)";
41     $rs = $DB->get_recordset_sql($sql);
42     foreach ($rs as $cat) {
43         $cat->depth  = 1;
44         $cat->path   = '/'.$cat->id;
45         $cat->parent = 0;
46         $DB->update_record('course_categories', $cat);
47     }
48     $rs->close();
50     // now add path and depth to top level categories
51     $sql = "UPDATE {course_categories}
52                SET depth = 1, path = ".$DB->sql_concat("'/'", "id")."
53              WHERE parent = 0";
54     $DB->execute($sql);
56     // now fix all other levels - slow but works in all supported dbs
57     $parentdepth = 1;
58     while ($DB->record_exists('course_categories', array('depth'=>0))) {
59         $sql = "SELECT c.id, pc.path
60                   FROM {course_categories} c, {course_categories} pc
61                  WHERE c.parent=pc.id AND c.depth=0 AND pc.depth=?";
62         $rs = $DB->get_recordset_sql($sql, array($parentdepth));
63         foreach ($rs as $cat) {
64             $cat->depth = $parentdepth+1;
65             $cat->path  = $cat->path.'/'.$cat->id;
66             $DB->update_record('course_categories', $cat);
67         }
68         $rs->close();
69         $parentdepth++;
70         if ($parentdepth > 100) {
71             //something must have gone wrong - nobody can have more than 100 levels of categories, right?
72             debugging('Unknown error fixing category depths');
73             break;
74         }
75     }
76 }
78 /**
79  * Moves all course files except the moddata to new file storage
80  *
81  * Unfortunately this function uses core file related functions - it might be necessary to tweak it if something changes there :-(
82  */
83 function upgrade_migrate_files_courses() {
84     global $DB, $CFG;
85     require_once($CFG->libdir.'/filelib.php');
87     set_config('upgradenewfilemirgation', 1);
89     $count = $DB->count_records('course');
90     $pbar = new progress_bar('migratecoursefiles', 500, true);
92     $rs = $DB->get_recordset('course');
93     $i = 0;
94     foreach ($rs as $course) {
95         $i++;
96         upgrade_set_timeout(60*5); // set up timeout, may also abort execution
97         $context = get_context_instance(CONTEXT_COURSE, $course->id);
98         upgrade_migrate_files_course($context, '/', true);
99         $pbar->update($i, $count, "Migrated course files - course $i/$count.");
100     }
101     $rs->close();
103     return true;
106 /**
107  * Moodle 2.0dev was using xx/xx/xx file pool directory structure, this migrates the existing files to xx/xx.
108  * This will not be executed in production upgrades...
109  * @return void
110  */
111 function upgrade_simplify_overkill_pool_structure() {
112     global $CFG, $OUTPUT;
114     if (isset($CFG->upgradenewfilemirgation)) {
115         // newer upgrade, directory structure is in the form xx/xx already
116         unset_config('upgradenewfilemirgation');
117         return;
118     }
120     $filedir = $CFG->dataroot.'/filedir'; // hardcoded hack, do not use elsewhere!!
122     echo $OUTPUT->notification("Changing file pool directory structure, this may take a while...", 'notifysuccess');
124     $dir_l1 = new DirectoryIterator($filedir);
125     foreach ($dir_l1 as $d1) {
126         if ($d1->isDot() or $d1->isLink() or !$d1->isDir()) {
127             continue;
128         }
129         $name1 = $d1->getFilename();
130         if (strlen($name1) != 2) {
131             continue; //weird
132         }
133         $dir_l2 = new DirectoryIterator("$filedir/$name1");
134         foreach ($dir_l2 as $d2) {
135             if ($d2->isDot() or $d2->isLink() or !$d2->isDir()) {
136                 continue;
137             }
138             $name2 = $d2->getFilename();
139             if (strlen($name2) != 2) {
140                 continue; //weird
141             }
142             $dir_l3 = new DirectoryIterator("$filedir/$name1/$name2");
143             foreach ($dir_l3 as $d3) {
144                 if ($d3->isDot() or $d3->isLink() or !$d3->isDir()) {
145                     continue;
146                 }
147                 $name3 = $d3->getFilename();
148                 if (strlen($name3) != 2) {
149                     continue; //weird
150                 }
151                 $dir_l4 = new DirectoryIterator("$filedir/$name1/$name2/$name3");
152                 foreach ($dir_l4 as $d4) {
153                     if (!$d4->isFile()) {
154                         continue; //. or ..
155                     }
156                     upgrade_set_timeout(60*5); // set up timeout, may also abort execution
157                     $newfile = "$filedir/$name1/$name2/".$d4->getFilename();
158                     $oldfile = "$filedir/$name1/$name2/$name3/".$d4->getFilename();
159                     if (!file_exists($newfile)) {
160                         rename($oldfile, $newfile);
161                     }
162                 }
163                 unset($d4);
164                 unset($dir_l4);
165                 rmdir("$filedir/$name1/$name2/$name3");
166             }
167             unset($d3);
168             unset($dir_l3); // release file handles
169         }
170         unset($d2);
171         unset($dir_l2); // release file handles
172     }
175 /**
176  * Internal function - do not use directly
177  */
178 function upgrade_migrate_user_icons() {
179     global $CFG, $OUTPUT, $DB;
181     $fs = get_file_storage();
183     $icon = array('component'=>'user', 'filearea'=>'icon', 'itemid'=>0, 'filepath'=>'/');
185     $count = $DB->count_records('user', array('picture'=>1, 'deleted'=>0));
186     $pbar = new progress_bar('migrateusericons', 500, true);
188     $rs = $DB->get_recordset('user', array('picture'=>1, 'deleted'=>0), 'id ASC', 'id, picture');
189     $i = 0;
190     foreach ($rs as $user) {
191         $i++;
192         upgrade_set_timeout(60); /// Give upgrade at least 60 more seconds
193         $pbar->update($i, $count, "Migrated user icons $i/$count.");
195         $context = get_context_instance(CONTEXT_USER, $user->id);
197         if ($fs->file_exists($context->id, 'user', 'icon', 0, '/', 'f1.jpg')) {
198             // already converted!
199             continue;
200         }
202         $level1 = floor($user->id / 1000) * 1000;
203         $userdir = "$CFG->dataroot/user/$level1/$user->id";
204         if (!file_exists("$userdir/f1.jpg") or !file_exists("$userdir/f2.jpg")) {
205             $userdir = "$CFG->dataroot/users/$user->id";
206             if (!file_exists("$userdir/f1.jpg") or !file_exists("$userdir/f2.jpg")) {
207                 // no image found, sorry
208                 $user->picture = 0;
209                 $DB->update_record('user', $user);
210                 continue;
211             }
212         }
214         $icon['contextid'] = $context->id;
215         $icon['filename']  = 'f1.jpg';
216         $fs->create_file_from_pathname($icon, "$userdir/f1.jpg");
217         $icon['filename']  = 'f2.jpg';
218         $fs->create_file_from_pathname($icon, "$userdir/f2.jpg");
219     }
220     $rs->close();
222     // purge all old user image dirs
223     remove_dir("$CFG->dataroot/user");
224     remove_dir("$CFG->dataroot/users");
227 /**
228  * Internal function - do not use directly
229  */
230 function upgrade_migrate_group_icons() {
231     global $CFG, $OUTPUT, $DB;
233     $fs = get_file_storage();
235     $icon = array('component'=>'group', 'filearea'=>'icon', 'filepath'=>'/');
237     $count = $DB->count_records('groups', array('picture'=>1));
238     $pbar = new progress_bar('migrategroupfiles', 500, true);
240     $rs = $DB->get_recordset('groups', array('picture'=>1), 'courseid ASC', 'id, picture, courseid');
241     $i = 0;
242     foreach ($rs as $group) {
243         $i++;
244         upgrade_set_timeout(60); /// Give upgrade at least 60 more seconds
245         $pbar->update($i, $count, "Migrated group icons  $i/$count.");
247         $context = get_context_instance(CONTEXT_COURSE, $group->courseid);
249         if ($fs->file_exists($context->id, 'group', 'icon', $group->id, '/', 'f1.jpg')) {
250             // already converted!
251             continue;
252         }
254         $groupdir = "$CFG->dataroot/groups/$group->id";
255         if (!file_exists("$groupdir/f1.jpg") or !file_exists("$groupdir/f2.jpg")) {
256             // no image found, sorry
257             $group->picture = 0;
258             $DB->update_record('groups', $group);
259             continue;
260         }
262         $icon['contextid'] = $context->id;
263         $icon['itemid']    = $group->id;
264         $icon['filename']  = 'f1.jpg';
265         $fs->create_file_from_pathname($icon, "$groupdir/f1.jpg");
266         $icon['filename']  = 'f2.jpg';
267         $fs->create_file_from_pathname($icon, "$groupdir/f2.jpg");
268     }
269     $rs->close();
271     // purge all old group image dirs
272     remove_dir("$CFG->dataroot/groups");
275 /**
276  * Internal function - do not use directly
277  */
278 function upgrade_migrate_files_course($context, $path, $delete) {
279     global $CFG, $OUTPUT;
281     $fullpathname = $CFG->dataroot.'/'.$context->instanceid.$path;
282     if (!file_exists($fullpathname)) {
283         return;
284     }
285     $items = new DirectoryIterator($fullpathname);
286     $fs = get_file_storage();
288     $textlib = textlib_get_instance();
290     foreach ($items as $item) {
291         if ($item->isDot()) {
292             continue;
293         }
295         if ($item->isLink()) {
296             // do not delete symbolic links or its children
297             $delete_this = false;
298         } else {
299             $delete_this = $delete;
300         }
302         if (strpos($path, '/backupdata/') === 0) {
303             $component = 'backup';
304             $filearea  = 'course';
305             $filepath  = substr($path, strlen('/backupdata'));
306         } else {
307             $component = 'course';
308             $filearea  = 'legacy';
309             $filepath  = $path;
310         }
312         if ($item->isFile()) {
313             if (!$item->isReadable()) {
314                 echo $OUTPUT->notification(" File not readable, skipping: ".$fullpathname.$item->getFilename());
315                 continue;
316             }
318             $filepath = clean_param($filepath, PARAM_PATH);
319             $filename = clean_param($item->getFilename(), PARAM_FILE);
321             if ($filename === '') {
322                 //unsupported chars, sorry
323                 continue;
324             }
326             if ($textlib->strlen($filepath) > 255) {
327                 echo $OUTPUT->notification(" File path longer than 255 chars, skipping: ".$fullpathname.$item->getFilename());
328                 continue;
329             }
331             if (!$fs->file_exists($context->id, $component, $filearea, '0', $filepath, $filename)) {
332                 $file_record = array('contextid'=>$context->id, 'component'=>$component, 'filearea'=>$filearea, 'itemid'=>0, 'filepath'=>$filepath, 'filename'=>$filename,
333                                      'timecreated'=>$item->getCTime(), 'timemodified'=>$item->getMTime());
334                 if ($fs->create_file_from_pathname($file_record, $fullpathname.$item->getFilename())) {
335                     if ($delete_this) {
336                         @unlink($fullpathname.$item->getFilename());
337                     }
338                 }
339             }
341         } else {
342             if ($path == '/' and $item->getFilename() == 'moddata') {
343                 continue; // modules are responsible
344             }
346             $dirname = clean_param($item->getFilename(), PARAM_PATH);
347             if ($dirname === '') {
348                 //unsupported chars, sorry
349                 continue;
350             }
351             $filepath = ($filepath.$dirname.'/');
352             if ($filepath !== '/backupdata/') {
353                 $fs->create_directory($context->id, $component, $filearea, 0, $filepath);
354             }
356             //migrate recursively all subdirectories
357             upgrade_migrate_files_course($context, $path.$item->getFilename().'/', $delete_this);
358             if ($delete_this) {
359                 // delete dir if empty
360                 @rmdir($fullpathname.$item->getFilename());
361             }
362         }
363     }
364     unset($items); //release file handles
367 /**
368  * Moves all block attachments
369  *
370  * Unfortunately this function uses core file related functions - it might be necessary to tweak it if something changes there :-(
371  */
372 function upgrade_migrate_files_blog() {
373     global $DB, $CFG, $OUTPUT;
375     $fs = get_file_storage();
377     $count = $DB->count_records_select('post', "module='blog' AND attachment IS NOT NULL AND attachment <> '1'");
379     $rs = $DB->get_recordset_select('post', "module='blog' AND attachment IS NOT NULL AND attachment <> '1'");
381     if ($rs->valid()) {
383         upgrade_set_timeout(60*20); // set up timeout, may also abort execution
385         $pbar = new progress_bar('migrateblogfiles', 500, true);
387         $i = 0;
388         foreach ($rs as $entry) {
389             $i++;
390             $pathname = "$CFG->dataroot/blog/attachments/$entry->id/$entry->attachment";
391             if (!file_exists($pathname)) {
392                 $entry->attachment = NULL;
393                 $DB->update_record('post', $entry);
394                 continue;
395             }
397             $filename = clean_param($entry->attachment, PARAM_FILE);
398             if ($filename === '') {
399                 // weird file name, ignore it
400                 $entry->attachment = NULL;
401                 $DB->update_record('post', $entry);
402                 continue;
403             }
405             if (!is_readable($pathname)) {
406                 echo $OUTPUT->notification(" File not readable, skipping: ".$pathname);
407                 continue;
408             }
410             if (!$fs->file_exists(SYSCONTEXTID, 'blog', 'attachment', $entry->id, '/', $filename)) {
411                 $file_record = array('contextid'=>SYSCONTEXTID, 'component'=>'blog', 'filearea'=>'attachment', 'itemid'=>$entry->id, 'filepath'=>'/', 'filename'=>$filename,
412                                      'timecreated'=>filectime($pathname), 'timemodified'=>filemtime($pathname), 'userid'=>$entry->userid);
413                 $fs->create_file_from_pathname($file_record, $pathname);
414             }
415             @unlink($pathname);
416             @rmdir("$CFG->dataroot/blog/attachments/$entry->id/");
418             $entry->attachment = 1; // file name not needed there anymore
419             $DB->update_record('post', $entry);
420             $pbar->update($i, $count, "Migrated blog attachments - $i/$count.");
421         }
422     }
423     $rs->close();
425     @rmdir("$CFG->dataroot/blog/attachments/");
426     @rmdir("$CFG->dataroot/blog/");
429 /**
430  * This function will fix the status of the localhost/all records in the mnet_host table
431  * checking they exist and adding them if missing + redefine CFG->mnet_localhost_id  and
432  * CFG->mnet_all_hosts_id if needed + update all the users having non-existent mnethostid
433  * to correct CFG->mnet_localhost_id
434  *
435  * Implemented because, at some point, specially in old installations upgraded along
436  * multiple versions, sometimes the stuff above has ended being inconsistent, causing
437  * problems here and there (noticeably in backup/restore). MDL-16879
438  */
439 function upgrade_fix_incorrect_mnethostids() {
441     global $CFG, $DB;
443 /// Get current $CFG/mnet_host records
444     $old_mnet_localhost_id = !empty($CFG->mnet_localhost_id) ? $CFG->mnet_localhost_id : 0;
445     $old_mnet_all_hosts_id = !empty($CFG->mnet_all_hosts_id) ? $CFG->mnet_all_hosts_id : 0;
447     $current_mnet_localhost_host = $DB->get_record('mnet_host', array('wwwroot' => $CFG->wwwroot)); /// By wwwroot
448     $current_mnet_all_hosts_host = $DB->get_record_select('mnet_host', $DB->sql_isempty('mnet_host', 'wwwroot', false, false)); /// By empty wwwroot
450     if (!$moodleapplicationid = $DB->get_field('mnet_application', 'id', array('name' => 'moodle'))) {
451         $m = (object)array(
452             'name'              => 'moodle',
453             'display_name'      => 'Moodle',
454             'xmlrpc_server_url' => '/mnet/xmlrpc/server.php',
455             'sso_land_url'      => '/auth/mnet/land.php',
456             'sso_jump_url'      => '/auth/mnet/jump.php',
457         );
458         $moodleapplicationid = $DB->insert_record('mnet_application', $m);
459     }
461 /// Create localhost_host if necessary (pretty improbable but better to be 100% in the safe side)
462 /// Code stolen from mnet_environment->init
463     if (!$current_mnet_localhost_host) {
464         $current_mnet_localhost_host                     = new stdClass();
465         $current_mnet_localhost_host->wwwroot            = $CFG->wwwroot;
466         $current_mnet_localhost_host->ip_address         = '';
467         $current_mnet_localhost_host->public_key         = '';
468         $current_mnet_localhost_host->public_key_expires = 0;
469         $current_mnet_localhost_host->last_connect_time  = 0;
470         $current_mnet_localhost_host->last_log_id        = 0;
471         $current_mnet_localhost_host->deleted            = 0;
472         $current_mnet_localhost_host->name               = '';
473         $current_mnet_localhost_host->applicationid      = $moodleapplicationid;
474     /// Get the ip of the server
475         if (empty($_SERVER['SERVER_ADDR'])) {
476         /// SERVER_ADDR is only returned by Apache-like webservers
477             $count = preg_match("@^(?:http[s]?://)?([A-Z0-9\-\.]+).*@i", $current_mnet_localhost_host->wwwroot, $matches);
478             $my_hostname = $count > 0 ? $matches[1] : false;
479             $my_ip       = gethostbyname($my_hostname);  // Returns unmodified hostname on failure. DOH!
480             if ($my_ip == $my_hostname) {
481                 $current_mnet_localhost_host->ip_address = 'UNKNOWN';
482             } else {
483                 $current_mnet_localhost_host->ip_address = $my_ip;
484             }
485         } else {
486             $current_mnet_localhost_host->ip_address = $_SERVER['SERVER_ADDR'];
487         }
488         $current_mnet_localhost_host->id = $DB->insert_record('mnet_host', $current_mnet_localhost_host, true);
489     }
491 /// Create all_hosts_host if necessary (pretty improbable but better to be 100% in the safe side)
492 /// Code stolen from mnet_environment->init
493     if (!$current_mnet_all_hosts_host) {
494         $current_mnet_all_hosts_host                     = new stdClass();
495         $current_mnet_all_hosts_host->wwwroot            = '';
496         $current_mnet_all_hosts_host->ip_address         = '';
497         $current_mnet_all_hosts_host->public_key         = '';
498         $current_mnet_all_hosts_host->public_key_expires = 0;
499         $current_mnet_all_hosts_host->last_connect_time  = 0;
500         $current_mnet_all_hosts_host->last_log_id        = 0;
501         $current_mnet_all_hosts_host->deleted            = 0;
502         $current_mnet_all_hosts_host->name               = 'All Hosts';
503         $current_mnet_all_hosts_host->applicationid      = $moodleapplicationid;
504         $current_mnet_all_hosts_host->id                 = $DB->insert_record('mnet_host', $current_mnet_all_hosts_host, true);
505     }
507 /// Compare old_mnet_localhost_id and current_mnet_localhost_host
509     if ($old_mnet_localhost_id != $current_mnet_localhost_host->id) { /// Different = problems
510     /// Update $CFG->mnet_localhost_id to correct value
511         set_config('mnet_localhost_id', $current_mnet_localhost_host->id);
513     /// Delete $old_mnet_localhost_id if exists (users will be assigned to new one below)
514         $DB->delete_records('mnet_host', array('id' => $old_mnet_localhost_id));
515     }
517 /// Compare old_mnet_all_hosts_id and current_mnet_all_hosts_host
519     if ($old_mnet_all_hosts_id != $current_mnet_all_hosts_host->id) { /// Different = problems
520     /// Update $CFG->mnet_localhost_id to correct value
521         set_config('mnet_all_hosts_id', $current_mnet_all_hosts_host->id);
523     /// Delete $old_mnet_all_hosts_id if exists
524         $DB->delete_records('mnet_host', array('id' => $old_mnet_all_hosts_id));
525     }
527 /// Finally, update all the incorrect user->mnethostid to the correct CFG->mnet_localhost_id, preventing UIX dupes
528     $hosts = $DB->get_records_menu('mnet_host', null, '', 'id, id AS id2');
529     list($in_sql, $in_params) = $DB->get_in_or_equal($hosts, SQL_PARAMS_QM, null, false);
531     $sql = "SELECT id
532             FROM {user} u1
533             WHERE u1.mnethostid $in_sql
534               AND NOT EXISTS (
535                   SELECT 'x'
536                     FROM {user} u2
537                    WHERE u2.username = u1.username
538                      AND u2.mnethostid = ?)";
540     $params = array_merge($in_params, array($current_mnet_localhost_host->id));
542     $rs = $DB->get_recordset_sql($sql, $params);
543     foreach ($rs as $rec) {
544         $DB->set_field('user', 'mnethostid', $current_mnet_localhost_host->id, array('id' => $rec->id));
545         upgrade_set_timeout(60); /// Give upgrade at least 60 more seconds
546     }
547     $rs->close();
549     // fix up any host records that have incorrect ids
550     $DB->set_field_select('mnet_host', 'applicationid', $moodleapplicationid, 'id = ? or id = ?', array($current_mnet_localhost_host->id, $current_mnet_all_hosts_host->id));
554 /**
555  * This function is used as part of the great navigation upgrade of 20090828
556  * It is used to clean up contexts that are unique to a blocks that are about
557  * to be removed.
558  *
559  *
560  * Look at {@link blocklib.php::blocks_delete_instance()} the function from
561  * which I based this code. It is important to mention one very important fact
562  * before doing this I checked that the blocks did not override the
563  * {@link block_base::instance_delete()} method. Should this function ever
564  * be repeated check this again
565  *
566  * @link lib/db/upgrade.php
567  *
568  * @since navigation upgrade 20090828
569  * @param array $contextidarray An array of block instance context ids
570  * @return void
571  */
572 function upgrade_cleanup_unwanted_block_contexts($contextidarray) {
573     global $DB;
575     if (!is_array($contextidarray) || count($contextidarray)===0) {
576         // Ummmm no instances?
577         return;
578     }
580     $contextidstring = join(',', $contextidarray);
582     $blockcontexts = $DB->get_recordset_select('context', 'contextlevel = '.CONTEXT_BLOCK.' AND id IN ('.$contextidstring.')', array(), '', 'id, contextlevel');
583     $blockcontextids = array();
584     foreach ($blockcontexts as $blockcontext) {
585         $blockcontextids[] = $blockcontext->id;
586     }
588     if (count($blockcontextids)===0) {
589         // None of the instances have unique contexts
590         return;
591     }
593     $blockcontextidsstring = join(',', $blockcontextids);
595     $DB->delete_records_select('role_assignments', 'contextid IN ('.$blockcontextidsstring.')');
596     $DB->delete_records_select('role_capabilities', 'contextid IN ('.$blockcontextidsstring.')');
597     $DB->delete_records_select('role_names', 'contextid IN ('.$blockcontextidsstring.')');
598     $DB->delete_records_select('context', 'id IN ('.$blockcontextidsstring.')');
601 /**
602  * This function is used to establish the automated backup settings using the
603  * original scheduled backup settings.
604  *
605  * @since 2010111000
606  */
607 function update_fix_automated_backup_config() {
608     $mappings = array(
609         // Old setting      => new setting
610         'backup_sche_active'            => 'backup_auto_active',
611         'backup_sche_hour'              => 'backup_auto_hour',
612         'backup_sche_minute'            => 'backup_auto_minute',
613         'backup_sche_destination'       => 'backup_auto_destination',
614         'backup_sche_keep'              => 'backup_auto_keep',
615         'backup_sche_userfiles'         => 'backup_auto_user_files',
616         'backup_sche_modules'           => 'backup_auto_activities',
617         'backup_sche_logs'              => 'backup_auto_logs',
618         'backup_sche_messages'          => 'backup_auto_messages',
619         'backup_sche_blocks'            => 'backup_auto_blocks',
620         'backup_sche_weekdays'          => 'backup_auto_weekdays',
621         'backup_sche_users'             => 'backup_auto_users',
622         'backup_sche_blogs'             => 'backup_auto_blogs',
623         'backup_sche_coursefiles'       => null,
624         'backup_sche_sitefiles'         => null,
625         'backup_sche_withuserdata'      => null,
626         'backup_sche_metacourse'        => null,
627         'backup_sche_running'           => null,
628     );
630     $oldconfig = get_config('backup');
631     foreach ($mappings as $oldsetting=>$newsetting) {
632         if (!isset($oldconfig->$oldsetting)) {
633             continue;
634         }
635         if ($newsetting !== null) {
636             $oldvalue = $oldconfig->$oldsetting;
637             set_config($newsetting, $oldvalue, 'backup');
638         }
639         unset_config($oldsetting, 'backup');
640     }
642     unset_config('backup_sche_gradebook_history');
643     unset_config('disablescheduleddbackups');