Перенос (миграция) MySQL на MS SQL Server базы Moodle

Дано: Moodle 2.8, установленный на Windows Server 2012 R2, с базой на MySQL.
Задача: перенести базу данных на СУБД Microsoft SQL Server 2014.

Процесс будет состоять из нескольких этапов:
1. Создание базы данных
2. Подготовка сервера с MSSQL.
3. Подготовка сервера с Moodle
4. Миграция базы данных
5. Настройка Moodle на работу с базой MSSQL

Если Вы хотите не перенести базу, а установить чистый Moodle на MS SQL Server, то можно сделать все те же этапы, кроме 4го.
Примечание: если на момент переноса базы Moodle сообщает о наличии новых версий, то делать обновление не рекомендуется, лучше сделать это после переноса базы. Максимум можно обновить плагины.

1. Создание базы данных
Создаем новую базу данных в MSSQL.

Обязательно ставим параметр Is Read Committed transaction ON = True (ALTER DATABASE xxxx SET READ_COMMITTED_SNAPSHOT ON).

Следующие параметры ставим только если при переносе и использовании возникли проблемы (обычно драйвер для SQL, который мы установим в шаге 3 их не требует):
- Case sensitive collation (например, Latin1_General_CS_AS)
- ANSI NULLS Enabled = True (ALTER DATABASE xxxx SET ANSI_NULLS ON)
- Quoted Identifiers Enabled = True (ALTER DATABASE xxxx SET QUOTED_IDENTIFIER ON)

Также создаем пользователя для этой базы с правами owner.

2. Подготовка сервера с MSSQL
По умолчанию, SQL Server слушает 1433 порт по TCP/IP, поэтому необходимо открыть этот порт в FireWall (Inbound Rules):

Также нужно проверить, что протокол TCP/IP включен: SQL Server Configuration Manager -> Network Configuration -> Protocols -> TCP/IP enabled

3. Подготовка сервера с Moodle
Для начала необходимо настроить PHP на работу с СУБД MS SQL Server. Можно пропустить этот шаг, если подобная настройка уже производилась ранее.

Нужно установить следующий драйвер: Microsoft Drivers for PHP for SQL Server
http://www.microsoft.com/en-us/download/details.aspx?id=20098
Если у Вас PHP версии 5.6, то скачиваем файл SQLSRV32.EXE, затем распаковываем куда-либо.

В PHP менеджере в IIS - подключаем извлеченную из скаченного файла архива библиотеку (либо добавляем  строку в php.ini):

(После этого в списке баз для конвертации в Moodle появится строка mssql)

Также устанавливаем в систему драйвер Microsoft ODBC Driver 11 for SQL Server https://www.microsoft.com/en-us/download/details.aspx?id=36434

Чтобы проверить, работает ли PHP с MSSQL, можно создать в IIS тестовый файл для проверки подключения к базе.

Тестовый PHP файл

<?php
$serverName = "SERVER"; //serverName\instanceName
$connectionInfo = array ("Database"=>"moodledb", 
"UID"=>"moodledbuser", 
"PWD"=>"moodledbpass");
$conn = sqlsrv_connect ($serverName, $connectionInfo);
if ($conn) {
     echo "Подключено успешно";
} else {
     echo "Проблемы с подключением";
     die (print_r (sqlsrv_errors(), true));
}
?>

4. Перенос базы
Теперь попробуем сделать непосредственно миграцию базы данных Moodle.
Заходим на сайт Moodle: Администрирование - Разработка - Экспериментальные возможности - Перенос базы данных:

На открывшейся странице в списке "Тип" выбираем "SQL Server":

Если пункта SQL Server нет, то делаем описанное выше (установка драйвера и т.п.) в шаге 3.

Заполняем поля соответственно созданной ранее базе данных в MSSQL и укажите префикс для создаваемых таблиц:

Чтобы начать конвертацию, нажимаем кнопку "Перенос данных". Что будет происходить: мудл создаст в новой базе свои таблицы и заполнит их данными из базы MySQL. Никаких перенастроек на текущем экземпляре Moodle не произойдет, он также продолжит работать на базе MySQL. Т.е. никаких изменений в мудл не будет, он только попытается создать базу. Поэтому если что-то при конвертации пошло не так, не стоит волноваться за работу Moodle.

Какие могут быть проблемы на данном этапе? В основном ошибки могут проявиться в таблицах сторонних компонентов, например, плагинов. Все схемы таблиц должны быть представлены в файле Moodle - install.xml, если какой-либо компонент не внес в него свои данные или было некорректное обновление, то при конвертации может появиться следующая ошибка:
Current database structure does not match all install.xml files.
Текущая структура базы данных соответствует не всем файлам install.xml.

Далее будут перечислены таблицы, которые мудл не смог сконвертировать с сообщением, например:
Таблица qtype_ddmatch_options: table is not expected

Какие варианты? Возможно стоит обновить указанные компоненты, чтобы они корректно прописались в схеме данных, а если этого сделать нельзя, то удалить их. Можно попытаться откатиться до предыдущей версии мудл и конвертировать ее.

После устранения проблемы, можно снова попробовать сделать перенос. Процесс переноса может длиться от нескольких минут до получаса. Операция переноса отчитается о созданных таблицах:

В данном отчете будут перечислены все созданные таблицы.

Также в процессе может возникнуть 500 ошибка. Большая вероятность, что сработал timeout. Желательно его увеличить на время переноса.

В итоге данной операции будет сформирована структура таблиц в базе MS SQL Server и перенесены данные.

5. Настройка Moodle на работу с базой MSSQL

Теперь нужно перенастроить конфигурационный файл Moodle на работу с новой базой. Открываем файл config.php в каталоге moodle и меняем строки:

$CFG->dbtype    = 'sqlsrv';         // тип базы
$CFG->dbhost    = 'localhost';      // localhost, если база на том же сервере, либо
                                    // Имя или IP адрес сервера
$CFG->dbname    = 'moodle';         // название базы данных
$CFG->dbuser    = 'yourusername';   // имя пользователя базы
$CFG->dbpass    = 'yourpassword';   // пароль пользователя базы
$CFG->dbpersist =  true;
$CFG->prefix    = 'tbl_';           // префикс таблиц (что задавали при переносе)

Теперь можно запускать Moodle, чтобы проверить его работу с новой базой.
Если были необходимы обновления, то обновляем плагины, а затем и сам мудл.

Если возникнут проблемы, можно в файле php.ini установить след.параметры
• mssql.textlimit = 20971520
• mssql.textsize = 20971520

См. также:

Другие инструкции по Moodle

(с) Ella S.

Если Вам понравилась статья, пожалуйста, поставьте лайк, сделайте репост или оставьте комментарий. Если у Вас есть какие-либо замечания, также пишите комментарии.