]> git.stg.codes - stg.git/blob - doc/help/ch10.xml
Minor ChangeLog fix
[stg.git] / doc / help / ch10.xml
1 <chapter xml:id="ch10">
2         <title>Приложение А: конвертация БД</title>
3         <para>Для преобразования базы между любыми двумя модулями хранилища используется утилита convertor (исходный код утилиты находится в каталоге projects/convertor стандартной поставки системы). Утилита работает из каталога сборки без установки в ОС. Для сборки утилиты необходимо запустить скрипт ./build. </para>
4         <para>При запуске утилиты в качестве параметра можно передать путь к конфигурационному файлу. По умолчанию будет использован файл convertor.conf из каталога сборки. Конфигурационный файл имеет такой-же формат, что и конфигурационный файл stargazer. Глобальный параметр ModulesPath указывает местонахождение модулей хранилища. Далее следуют две секции: &lt;SourceStoreModule&gt; и &lt;DestStoreModule&gt;. Они описывают, соответственно, источник данных и их приемник. Так, например, для переноса всей информации из БД на основе файлов в БД Firebird необходимо в первой секции прописать параметры файлового хранилища, а во второй — хранилища Firebird.</para>
5         <para>Пример файла конфигурации:</para>
6 <programlisting linenumbering="unnumbered">
7 # Путь к директории, в которой находятся модули сервера
8 ModulesPath = ../stargazer/modules
9
10 ###################################################################
11 # Store module
12 # Настройки плагина работающего с БД сервера
13
14 # Второй параметр - это имя модуля без mod_ в начале и .so в конце
15 # Т.е. полное имя модуля mod_store_files.so
16 &lt;SourceStoreModule store_files&gt;
17
18     # Рабочая директория сервера, тут содержатся данные о тарифах, пользователях,
19     # администраторах и т.д.
20     WorkDir = /var/stg-test
21     
22     
23     # Владелец, группа и права доступа на файлы статистики (stat) пользователя
24     ConfOwner = root
25     ConfGroup = wheel
26     ConfMode = 600
27     
28     
29     # Владелец, группа и права доступа на файлы конфигурации (conf) пользователя
30     StatOwner = root
31     StatGroup = wheel
32     StatMode = 640
33     
34     # Владелец, группа и права доступа на лог-файлы (log) пользователя
35     UserLogOwner = root
36     UserLogGroup = wheel
37     UserLogMode = 640
38     
39 &lt;/SourceStoreModule&gt;
40     
41 &lt;DestStoreModule store_firebird&gt;
42     server = localhost
43     database = /var/stg/stargazer.fdb
44     user = stg
45     password = 123456
46 &lt;/DestStoreModule&gt;
47
48 #&lt;DestStoreModule store_mysql&gt;
49 #    # Имя пользователя БД
50 #    dbuser = stg
51 #
52 #    # Пароль пользователя БД
53 #    rootdbpass = 123456
54 #
55 #    # Имя БД на сервере
56 #    dbname = stg
57 #
58 #    # Адрес сервера БД
59 #    dbhost = localhost
60 #&lt;/DestStoreModule&gt;               
61 </programlisting>
62 </chapter>