Структура базы данных

В статье описана структура MySQL базы данных VMmanager.

Имя базы данных по умолчанию — "vmmgr". Поле id в каждой таблице — внешний ключ. Для булевых полей возможные значения — "on" и "off".

Обратите внимание!

Для применения настроек после изменения базы данных перезапустите панель управления с помощью команды:

/usr/local/mgr5/sbin/mgrctl -m vmmgr exit

Пользователи

user

Таблица пользователей.
Описание пользователей в Управление → Пользователи.

id — идентификатор записи;
name — логин;
password — хэш пароля;
enabled — состояние:
- on — активный пользователь;
- off — выключенный пользователь.
allowcreatevm — опция создания виртуальных машин:
- on — опция включена;
- off — опция выключена.
isolimitnum — ограничение по количеству ISO-образов. "0", если не указано;
isolimitsize — ограничение по объёму ISO-образов. "0", если не указано;
vm_limit — ограничение на количество виртуальных машин.

totp

Таблица данных для двухфакторной аутентификации.
Описание данных в Настройки → Настройки пользователя → Двухэтапная аутентификация.

id — идентификатор записи;
user — наименование пользователя;
login — логин пользователя;
secret — уникальный ключ для генерации временного пароля.

Управление персональными данными

core_gdpr_doc

Таблица условий использования панели управления.
Описание условий в Управление персональными данными → Условия использования.

id — идентификатор записи;
name — наименование документа;
type — тип условия. Ссылка на таблицу core_gdpr_doc_type:
- 1 — политика конфиденциальности;
- 2 — пользовательское соглашение.
url — ссылка на документ;
desc_conditions — описание условия;
entry_date — дата вступления в силу;
change_date — дата изменений.
locale — локализация:
- ua — украинский;
- pt — португальский;
- nl — голландский;
- en — английский;
- de — немецкий;
- ru — русский.
need_agree — опция Обязательное согласие:
- on — опция включена;
- off — опция выключена.
show_after_auth — опция Отображать после авторизации:
- on — опция включена;
- off — опция выключена.
show_in_warnings — опция Отображать в предупреждениях:
- on — опция включена;
- off — опция выключена.
status — статус:
- 0 — Активен;
- 1 — Неактивен.

core_gdpr_doc_type

Таблица типов условий использования.

id — идентификатор записи;
name — тип условия использования:
- 1 — политика конфиденциальности;
- 2 — пользовательское соглашение.

core_gdpr_journal

Таблица записей в журнале согласий с условиями использования.
Описание записей в Управление персональными данными → Журнал.

id — идентификатор записи.
action_object — объект действия. Ссылка на таблицу core_gdpr_doc:
- 1 — политика конфиденциальности;
- 2 — пользовательское соглашение.
username — пользователь;
action_type — действие. Ссылка на таблицу core_gdpr_doc:
- 0 — согласие;
- 1 — отказ.
ip — IP-адрес пользователя, с которого было произведено действие;
action_date — дата действия.

core_gdpr_processed_doc

Таблица актуальных согласий и отказов пользователей с условиями использования.

id — идентификатор записи;
doc — идентификатор документа. Ссылка на таблицу core_gdpr_doc;
username — пользователь;
accepted — действие:
- on — согласие;
- off — отказ.

history_core_gdpr_doc

Таблица изменений условий использования.
Описание записей в Управление персональными данными → Условия использования → кнопка История.

reference — идентификатор условия использования. Ссылка на таблицу core_gdpr_doc;
username — пользователь;
request_ip — IP-адрес;
request_action — действие, которое привело к изменению;
fromdate — время предыдущего изменения;
changedate — время изменения;
changedfields — список изменённых полей;
name — предыдущее наименование документа;
name_new — наименование документа;
type — предыдущий тип условия;
type_new — тип условия;
url — предыдущая ссылка на документ;
url_new — ссылка на документ;
desc_condition — предыдущее описание условия;
desc_condition_new — описание условия;
entry_date — предыдущая дата вступления в силу;
entry_date_new — дата вступления в силу;
change_date — предыдущая дата изменений;
change_date_new — дата изменений;
locale — предыдущая локализация;
locale_new — локализация;
need_agree — предыдущее состояние опции Обязательное согласие;
need_agree_new — состояние опции Обязательное согласие;
show_after_auth — предыдущее состояние опции Отображать после авторизации;
show_after_auth_new — состояние опции Отображать после авторизации;
show_in_warnings — предыдущее состояние опции Отображать в предупреждениях;
show_in_warnings_new — состояние опции Отображать в предупреждениях;
status — предыдущий статус;
status_new — статус.

Виртуальные машины

vm

id — идентификатор записи;
name — наименование;
name_idn — наименование в пользовательской кодировке;
hostnode — идентификатор узла кластера. Ссылка на таблицу hostnode;
ip — основной IPv4-адрес;
ip6 — основной IPv6-адрес;
domain — домен;
domain_idn — домен в пользовательской кодировке;
mem — оперативная память;
vcpu — количество процессоров;
cputune — вес CPU;
vsize — размер основного диска;
user — идентификатор владельца виртуальной машины. Ссылка на таблицу user;
vmi — идентификатор операционный системы. Указывается в формате "Репозиторий шаблона ОС + Наименования шаблона ОС";
state — состояние:
- running — включена;
- down — выключена.
osinstalled — флаг установки ОС:
- on — ОС установлена;
- off — ОС не установлена.
imported — флаг импорта виртуальной машины:
- on — виртуальная машина была импортирована;
- off — виртуальная машина не была импортирована.
opkey — уникальный идентификатор для использования в служебных целях;
crpassword — хэш пароля суперпользователя;
needrebootcount — количество необходимых перезагрузок;
needreboot — флаг необходимости перезагрузки:
- on — требуется перезагрузка;
- off — не требуется перезагрузка.
needrebootreason — причина необходимости перезагрузки:
- admdown — выключена администратором;
- net_mac — изменён MAC-адрес виртуальной машины;
- net_iface — необходимо применить изменения в сетевых интерфейсах;
vmnote — примечания администратора;
vmnoteu — примечения пользователя;
tempipv4 — временный IPv4-адрес;
migrate — флаг процесса миграции виртуальной машины;
- on — виртуальная машина мигрирует;
- off — виртуальная машина не мигрирует.
migrate_info — наименование кластера, на который мигрирует виртуальная машина. "NULL", если виртуальная машина не находится в процессе миграции;
sshpubkey — публичные SSH-ключи;
installmem — минимально-необходимое количество оперативной памяти для установки выбранной ОС. "NULL", если не указано;
domainxml — XML-описание виртуальной машины;
inbound — ограничение входящего трафика. Указывается в KiB/sec;
outbound — ограничение исходящего трафика. Указывается в KiB/sec;
blocked — флаг блокировки виртуальной машины от деструктивных действий:
- on — виртуальная машина заблокирована;
- off — виртуальная машина не заблокирована.
blkiotune — вес использования подсистемы ввода/вывода (I/O);
allowspoof — флаг отключения антиспуфинга:

- on — антиспуфинг отключён;
- off — антиспуфинг включён.

knownboottime — время последней загрузки системы;
reinstalltime — время начала последней переустановки системы;
reboottime — время начала последней перезагрузки системы;
clock_offset — способ синхронизации времени с часами сервера:
- utc — всемирное координированное время (UTC);
- localtime — синхронизировано с узлом.
lastmigratestartdate — время начала последней миграции;
installinforequested — флаг необходимости файла преконфигурации (kickstart или preseed) для установки ОС;
ip_history — последний присвоенный виртуальной машине IP-адрес;
osname — наименование ОС;

recipe — наименование исполняемого файла рецепта;
recipe_run — флаг установки рецепта:
- on — рецепт устанавливается;
- off — рецепт не устанавливается.

snapshot_limit — ограничение на количество снимков;
down_reason — причина остановки виртуальной машины:
- admdown — остановлена администратором.
cpu_mode — режим эмуляции процессора:
- NULL — по умолчанию;
- host-model;
- host-passthrough;
- custom — пользовательский.
custom_cpu — модель процессора;
custom_cpu_features — перечень возможностей процессора;

interface

Таблица сетевых интерфейсов виртуальных машин.
Описание Управление → Виртуальные машины → кнопка Интерфейсы.

id — идентификатор записи;
vm — идентификатор виртуальной машины. Ссылка на таблицу vm;
network — идентификатор связанной сети. Ссылка на таблицу network;
mac — MAC-адрес;
model — модель сетевого устройства.

device

Таблица устройств (дисков и ISO-образов), подключённых к виртуальным машинам.

id — идентификатор записи;
vm — идентификатор виртуальной машины. Ссылка на таблицу vm;
type — тип устройств:
- 0 — жёсткий диск;
- 1 — CD-ROM.
controller — шина:
- ide;
- virtio.
info — служебная информация;
targetdev — виртуальное устройство;
filepath — путь к ISO-образу. "NULL", если жёсткий диск.

volume

Таблица виртуальных дисков.
Описание виртуальных дисков в Управление → Виртуальные машины → Диски.

id — идентификатор записи;
name — наименование;
hostnode — идентификатор узла кластера. Ссылка на таблица hostnode;
user — идентификатор пользователя. Ссылка на таблицу user;
pool — наименование хранилища диска;
size — размер диска;
voltype — тип диска:
- 0 — virtio;
- 1 — ide;
- 2 — ISO-образ.
vm — идентификатор виртуальной машины. Ссылка на таблицу vm. "NULL", если не подключён;
bus — шина. "NULL", если не подключён;
dev — устройство. "NULL", если не подключён;
device — идентификатор устройства. Ссылка на таблицу device. "NULL", если не подключён;
filepath — директория, к которой монтирован ISO-образ. "NULL", если тип диска не ISO-образ;
bootorder — порядок загрузки. "0", если не подключён;
format — формат диска:
- NULL — ISO-образ;
- raw;
- qcow2.
status — состояние.

statday

Таблица с данными о нагрузке виртуальных машин по дням.
Описание данных в Управление → Виртуальные машины → Нагрузка.

begin — время начала суток. Указывается в UNIX-формате;

vm — наименование виртуальной машины;
rx — входящий трафик. Указывается в байтах;
tx — исходящий трафик. Указывается в байтах;
prx — количество пакетов входящего трафика;
ptx — количество пакетов исходящего трафика;

cpu — процессорное время. Указывается в мс;

stathr

Таблица с данными о нагрузке виртуальных машин по часам.
Описание данных в Управление → Виртуальные машины → Нагрузка.

begin — время начала часа. Указывается в UNIX-формате;
count —
vm — наименование виртуальной машины;
rx — входящий трафик. Указывается в байтах;
tx — исходящий трафик. Указывается в байтах;
prx — количество пакетов входящего трафика;
ptx — количество пакетов исходящего трафика;

cpu — процессорное время. Указывается в мс;

bandwidthusage

Таблица использования канала связи виртуальными машинами по дням.
Описание скорости передачи в Управление → Виртуальные машины → Использование канала.

id — идентификатор записи;
vm — идентификатор виртуальной машины;
in_ch — скорость передачи входящего трафика. Указывается в Kbit/sec;
out_ch — скорость передачи исходящего трафика. Указывается в Kbit/sec;
date — время начала суток. Указывается в UNIX-формате.

vmportfilter

Таблица фильтров TCP-портов.
Описание фильтров в Управление → Виртуальные машины → Фильтр.

id — идентификатор фильтра;
vm — идентификатор виртуальной машины. Ссылка на таблицу vm;
portfirst — начало диапазона портов, к которым применяется фильтр;
portlast — конец диапазона портов, к которым применяется фильтр. Если "NULL", то фильтр примеяется к одному порту, который указан в portfirst;
start — время начала действия фильтра;
end — время окончания дейтсвия фильтра;
direction — тип фильтра:
- 0 — входящие;
- 1 — исходящие.

eventlog

Таблица изменений виртуальных машин.
Описание событий в Управление → Виртуальные машины → История.

id — идентификатор записи;
table_name — идентификатор связанной с событием таблицы;
reference_id — идентификатор записи связанной таблицы. Ссылка на связанную таблицу;
owner_name — идентификатор пользователя, которому принадлежит виртуальная машина. Ссылка на таблицу user;
user_level — уровень доступа пользователя;
event_time — время;
event_name — наименование события;
username — пользователь, инициировавший событие;
request_ip — IP-адрес пользователя или наименование службы, инициировавшей событие;
request_action — функция соответствующая событию;
params — параметры функции;
email_sent — флаг отправки уведомления по электронной почте:
- on — уведомление отправлено;
- off — уведомление не отправлено.

eventlog_msg

Таблица локализованных описаний изменений виртуальных машин.
Описание событий в Управление → Виртуальные машины → История.

id — идентификатор записи;
eventlog — идентификатор события. Ссылка на таблицу eventlog;
lang — локализация:
- ua — украинский;
- pt — португальский;
- nl — голландский;
- en — английский;
- de — немецкий;
- ru — русский.
msg — локализованное описание события;
request_action_msg — локализованное описание функции.

snapshot

Таблица снимков виртуальных машин.
Опиание снимков в Управление → Виртуальные машины → Снимки.

id — идентификатор записи;
date — время создания;
vm — идентификатор виртуальной машины. Ссылка на таблицу vm;
description — описание;
name — наименование;
status — состояние;
usersnapshot — флаг пользовательского снапшота:
- on — снапшот сделан пользователем;
- off — снапшот сделан администратором.
stype — тип:
- libvirt — внутренний (qcow2);
- lvm — внешний (LVM).

unknownvm

Таблица виртуальных машин, не найденных в базе.
Описание Управление → Неизвестные VM.

id — идентификатор записи;
name — наименование;
hostnode — узел кластера;
status — состояние.

Узлы кластера

hostnode

Таблица узлов кластера.
Описание Настройки кластера → Узлы кластера.

id — идентификатор записи;
name — наименование;
ip — IP-адрес;
status — состояние:
- 0 — автоматическое размещение VM разрешено;
- 1 — автоматическое размещение VM запрещено для новых VM;
- 2 — автоматическое размещение VM запрещено для всех VM.
configuration — примечание;

uid — UID libvirt сервера. Используется, чтобы не допустить добавление одного узла кластера дважды;
cloudstate — состояние опции Разрешить облачные функции:
- on — облачные функции включены;
- off — облачные функции отключены.
vci — версия libvirt. Первая строка вывода vish -V;
ismaster — флаг, определяющий, является ли узел мастером. Для VMmanager KVM — всегда off:
- on — узел является мастером;
- off — узел не является мастером.
maxvmcount — максимальное количество VM
cpucore — количество ядер процессора;
priority — приоритет узла в очереди на запуск панели управления в случае отказа текущего мастер-узла;
corosync_status — статус corosync;
port — порт ihttpd;

online — флаг доступности узла кластера:
- on — доступен;
- off — недоступен.
version_libvirt — версия libvirt;
version_qemu — версия QEMU.

role_on_node

Таблица ролей узлов кластера.
Описание ролей в Настройки кластера → Узлы кластера → Роли.

id — идентификатор записи.
role — роль узла кластера:
- dbreplication — репликация mysql.
hostnode — идентификатор узла кластера. Ссылка на таблицу hostnode.
params — параметры.

Кластер

allocationrule

Таблица правил размещения виртуальных машин.
Описание правил в Настройки кластера → Правила размещения.

id — идентификатор записи;
priority — приоритет правила;
hostnode — узел кластера. "NULL", если все узлы кластера. В противном случае идентификатор узла кластера;
ruletype — тип признака:
- 0 — Шаблон ОС;
- 1 — Шаблон VM.
operand — операнд:
- 0 — содержит;
- 1 — не содержит.
value — значение;
action — действие:
- 0 — Добавить узел в список;
- 1 — Удалить узел из списка.
stop — опция Остановить обработку:
- on — опция включена;
- off — опция выключена.

sshpubkey

Таблица публичных SSH-ключей.
Описание Настройки кластера → SSH ключи.

id — идентификатор записи;
name — наименовние ключа;
pubkey — ключ;
owner — идентификатор пользователя. Ссылка на таблицу user.

iso

Таблица ISO-образов.
Описание образов в Управление → ISO-образы.

id — идентификатор записи;
filename — путь к ISO-образу;
name — имя образа;
user — идентификатор владельца образа. Ссылка на таблицу user;
size — размер. Указывается в байтах;
deletetime — время удаления;
shared — состояние опции Доступно всем:
- on — опция включена;
- off — опция выключена.
status — состояние:
- 0 — образ готов к работе;
- 1 — образ загружается.
description — описание.

preset

Таблица шаблонов VM.
Описание шаблонов в Настройки кластера → Шаблоны VM.

id — идентификатор записи;
name — наименование шаблона;
mem — объём оперативной памяти. Указывается в MiB;
vcpu — количество процессоров;
cputune — вес CPU;
inbound — ограничение входящего трафика. Указывается в KiB/sec;
outbound — ограничение исходящего трафика. Указывается в KiB/sec;
blkiotune — вес использования подсистемы ввода/вывода (I/O);
snapshot_limit — ограничение на количество снимков;
cpu_mode — режим эмуляции процессора:
- NULL — по умолчанию;
- host-model;
- host-passthrough;
- custom — пользовательский.
custom_cpu — модель процессора. "NULL", если режим эмуляции процессора не custom;
custom_cpu_features — перечень возможностей процессора. "NULL", если режим эмуляции процессора не custom.

presetresource

Таблица ресурсов шаблонов VM.
Описание шаблонов в Настройки кластера → Шаблоны VM → Ресурсы.

id — идентификатор записи;
preset — идентификтор шаблона VM. Ссылка на таблицу preset;
type — тип ресурса:
- 0 — сеть;
- 1 — хранилище.
metapool — идентификатор хранилища. Ссылка на таблицу metapool. "NULL", если тип ресурса "Сеть";
network — идентификатор сети. Ссылка на таблицу network. "NULL", если тип ресурса "Хранилище";
vsize — размер диска. Указывается в MiB. "NULL", если тип ресурса "Сеть";
model — модель карты. "NULL", если тип ресурса "Хранилище".

Хранилища

metapool

Таблица шаблонов хранилищ.
Описание шаблонов в Настройки кластера → Шаблоны хранилищ.

id — идентификатор записи;
name — наименование;
type — тип:
- dir — файловая система;
- logical — LVM;
- nlvm — сетевой LVM;
- iscsi — iSCSI;
- rbd — RBD;
- gluster — GlusterFS;
- netfs — NFS.

srcdirpath — директория на сетевом хранилище. Указывается только для хранилища с типом "GlusterFS". Для остальных — "NULL";
srchostname — IP-адрес или HOSTNAME сетевого хранилища;

srcvolume — имя тома на удалённом сервере. Указывается только для хранилищ с типами "GlusterFS" и "NFS". Для остальных — "NULL";

tgtpath — директория на узле кластера.
format — формат:
- raw;
- qcow2.
cache_mode — тип кэширования:
- NULL — по умолчанию;
- none;
- writethrough;
- writeback;
- directsync;
- unsafe.
qemu_aio — режим AIO:
- NULL — по умолчанию;
- threads.
reserved — зарезервировано объёма хранилища;
reserved_unit — единицы измерения зарезервированного объёма хранилища:
- 0 — проценты;
- 1 — MiB;
- 2 — GiB.
description — описание.

iscsilun

Таблица iSCSI-лунов.

id — идентификатор записи;
name — наименование луна;
iscsitarget — идентификатор таргета, в котором создаются луны. Ссылка на таблицу iscsitarget;
lunid — идентификатор луна.

iscsitarget

Таблица iSCSI-таргетов.

id — идентификатор записи;
serverip — IP-адрес сервера с таргетом;
name — наименование таргета;
targetid — идентификатор таргета;
targetdate — дата создания таргета;
rhn — доменное имя сервера с таргетом.

rbdmonitor

Таблица мониторов хранилищ Ceph RBD.

id — идентификатор записи;
metapool — идентификатор хранилища. Ссылка на таблицу metapool;
hostname — IP-адрес или доменное имя сервера;
port — порт для подключения к серверу.

rbdsecret

Таблица данных о секретах ceph-пользователей.

id — идентификатор записи;
metapool — идентификатор хранилища. Ссылка на таблицу metapool;
username — логин пользователя;
type — тип хранилища:
- ceph.
uuid — уникальный идентификатор секрета.

Импорт

remotenode

Таблица серверов и кластеров для импорта VM.
Описание серверов и кластеров в Импорт → Импорт VM.

id — идентификатор записи;
ip — IP-адрес;
type — тип подключаемого сервера:
- 0 — импорт из другого VMmanager KVM;
- 1 — импорт из libvirt.
login — имя пользователя ssh;
port — порт ssh;
mgrpath — путь к VMmanager. "NULL", если type — импорт из libvirt.

remotevm

Таблица виртуальных машин на серверах и кластерах для импорта VM.
Описание серверов и кластеров в Импорт → Импорт VM → Список VM.

id — идентификатор записи;
remoteid — идентификатор виртуальной машины на удалённом сервере;
hostip — IP-адрес узла кластера;
hostname — наименование узла кластера;
externalip — внешний IP-адрес виртуальной машины;
name — наименование виртуальной машины;
name_idn — наименование виртуальной машины в пользовательской кодировке;
istatus — состояние:
- fail — импорт виртуальной машины завершён неудачно.
remotenode — идентификатор узла кластера. Ссылка на таблицу remotenode;
mem — оперативная память. Указывается в MiB;
vsize — объём дисков;
ip — IP-адрес виртуальной машины.

vds

Таблица виртуальных машин, найденных на серверах с VDSmanager для импорта.
Описание виртуальных машин в Импорт → Импорт VDS → Список VDS.

id — идентификатор записи;
name — наименование;
ip — IP-адрес;
vdsmgr — идентификатор сервера с vdsmgr. Ссылка на таблицу vdsmgr;

vdsmgr

Таблица серверов с VDSmanager для импорта.
Описание серверов в Импорт → Импорт VDS.

id — идентификатор записи;
name — наименование;
ip — IP-адрес.

Статистика

diskday

Таблица со статистикой по дисковым операциям по суткам.

begin — время начала суток. Указывается в UNIX-формате;

vm — наименование виртуальной машины;
device — устройство, с которого получены данные;
rd — входящий трафик;
wr — исходящий трафик.

diskhr

Таблица со статистикой по дисковым операциям по часам.

begin — время начала часа. Указывается в UNIX-формате;

vm — наименование виртуальной машины;
device — устройство, с которого получены данные.

Сети

network

id — идентификатор записи;
name — наименование сети;
type — тип сети:
- bridge — мост;
- nat — NAT.
bridge — наименование сетевого моста. "NULL" для типа сети nat;
ipaddr — IP-адрес (шлюз). "NULL" для типа сети bridge;
netmask — маска сети. "NULL" для типа сети bridge;
fdev — внешний интерфейс. Значение auto соответствует автовыбору;
main — устарело. Не используется.

ip

Таблица IP-адресов, выданных виртуальным машинам.

id — идентификатор записи;
ip — IP-адрес;
owner — идентификатор виртуальной машины. Ссылка на таблицу vm;
domain — доменное имя;
gateway — адрес шлюза;
netmask — маска сети.

mac

Таблица связок MAC-адресов и IP-адресов.
Описание связок в Настройка кластера → Сети → MAC-адреса.

id — идентификатор записи;
mac — MAC-адрес;
network — идентификатор сети;
type — тип привязки:
- 0 — Наименование VM;
- 1 — IP-адрес.
value — значение;
netseq — устарело, не используется.

Уведомления

problem

Устарело, не используется.

problems

Таблица уведомлений.
Описание уведомлений в Состояние системы → Уведомления.

id — идентификатор записи;
name — тип уведомления;
owner — пользователь;
date_init — дата появления;
date_lastsolve — дата последней попытки решения проблемы;
problem_id — идентификатор уведомления;
description — описание и дополнительная информация;
level — уровень:
- 1 — ошибка;
- 2 — критическая проблема.
solved — флаг решения проблемы:
- on — проблема решена;
- off — проблема не решена.
autosolve — флаг автоматического решения проблемы:
- on — авторешение включено;
- off — авторешение выключено.
autosolve_period — период, через который осуществляются попытки решения проблемы. Указывается в минутах;
autosolve_count — количество попыток решения проблемы.

problems_desc

lang — локализация;
problems — идентификатор уведомления. Ссылка на таблицу problems;
locale_desc — локализованное описание;
title — локализованный тип уведомления.

problems_log

Таблица логов появления проблем.
Описание логов в Состояние системы → Уведомления → Лог.

id — идентификатор записи;
id_problem — идентификатор проблемы. Ссылка на таблицу problems;
date — дата появления;
owner — пользователь;
duration — продолжительность.