Документация DCImanager 5

Макросы шаблонов ОС

В статье описаны макросы, которые можно использовать в конфигурационных файлах установки ОС. Значения всех параметров можно увидеть в логе панели управления (по умолчанию /usr/local/mgr5/var/dcimgr.log) при включённом уровне логирования "Debug".


($AFTER_INSTALL_SCRIPT_HTTP) — URL-адрес для получения скрипта, который запускается после установки ОС, по протоколу HTTP;

($AFTER_INSTALL_SCRIPT_HTTPS) — URL-адрес для получения скрипта, который запускается после установки ОС, по протоколу HTTPS;

($AUTH_ID) — уникальный идентификатор текущей операции;

($CGI_IPMI_CHECK) — CGI, который проверяет доступность IPMI после его настройки. Используется в шаблонах диагностики;

($CGI_MGR_URLv4) — URL-адрес CGI с использованием IPv4-адреса;

($CGI_MGR_URLv6) — URL-адрес CGI с использованием IPv6-адреса;

($CLEAR_HDD) — очистка жёстких дисков. Используется в шаблонах диагностики:

  • "YES" — выполнять;
  • любое другое значение — не выполнять.

($DCIMINI_URL) — URL-адрес DCImini. Указывается для шаблонов диагностики, восстановления и поиска серверов;

($FINISH) — URL-адрес, который вызывается по завершении установки ОС;

($FINISHv4) — URL-адрес, который вызывается по завершении установки ОС с использованием протокола IPv4;

($FINISHv6) — URL-адрес, который вызывается по завершении установки ОС с использованием протокола IPv6;

($FULL_HDD_CLEAR) — полная очистка жёстких дисков. Используется в шаблонах диагностики:

  • "YES" — выполнять;
  • любое другое значение — не выполнять.

($GATEWAY) — шлюз по умолчанию;

($GATEWAYv4) — шлюз по умолчанию для IPv4;

($GATEWAYv6) — шлюз по умолчанию для IPv6;

($HAS_RECIPE) — используется ли рецепт для установки ОС. Может принимать значения:

  • 0 — для установки не используется рецепт;
  • 1 — для установки используется рецепт. 

($HDD_RAID) — тип программного RAID для настройки. Используется в шаблонах, поддерживающих RAID-массивы:

  • no_raid — не настраивать RAID;
  • raid_0;
  • raid_1;
  • raid_5;
  • raid_10.

($HOSTNAME) — имя хоста;

($HTTPPROXY) — HTTP-proxy. Используется для кэширования пакетов при установке ОС;

($HTTPPROXYv4) — HTTP-proxy для IPv4. Используется для кэширования пакетов при установке ОС;

($HTTPPROXYv6) — HTTP-proxy для IPv6. Используется для кэширования пакетов при установке ОС;

($INITRD) — файловая система. Используется для PXE-загрузки;

($IP) — основной IP-адрес;

($IPv4) — IPv4-адрес;

($IPv4ALIASES) — дополнительные IPv4-адреса. Указываются через пробел;

($IPv6) — IPv6-адрес;

($IPv6ALIASES) — дополнительные IPv6-адреса. Указываются через пробел;

($KERNEL) — ядро ОС. Используется для PXE-загрузки;

($LOCATIONIP) — IP-адрес локации;

($MGR_IP) — основной IP-адрес панели управления;

($MGR_IPv4) — IPv4 адрес панели управления;

($MGR_IPv6) — IPv6 адрес панели управления;

($MGR_NAME) — краткое название панели управления:

  • vmmgr — VMmanager;
  • dcimgr — DCImanager.

($MGR_URL) — URL-адрес панели управления;

($MGR_URLv4) — URL-адрес панели управления по IPv4;

($MGR_URLv6) — URL-адрес панели управления по IPv6;

($MGR_VERSION) — версия панели управления;

($MIRROR) — зеркало репозитория ОС;

($NAMESERVER) — основной DNS-сервер;

($NAMESERVERS) — DNS-серверы;

($NAMESERVERv4) — DNS-сервер для IPv4;

($NAMESERVERv6) — DNS-сервер для IPv6;

($NETMASK) — маска сети основного IP-адреса;

($NETMASK_SHORT) — маска сети в виде префикса;

($NETMASKv4) — маска сети для IPv4;

($NETMASKv6) — маска сети для IPv6;

($NFS) — путь к NFS-хранилищу, в котором содержатся файлы для операции. Указывается для шаблонов диагностики, восстановления и поиска серверов;

($NFSPATH) — полный внешний путь (включая IP-адрес) к NFS-хранилищу, в котором содержатся файлы для операции. Указывается для шаблонов диагностики, восстановления и поиска серверов;

($NO_ASKING_LABEL) — используется в шаблонах поиска серверов. На сервере, найденном при помощи поиска серверов, запускается режим восстановления. При входе на сервер доступна возможность удалённо задать стойку, юнит, серийный номер и наклейку сервера, которые будут отображаться в DCImanager. Данный макрос определяет, будет ли осуществляться запрос наклейки сервера. Значение, передаваемое макросу, зависит от наличия опции NoAskingLabel конфигурационного файла панели управления:

  • " " — запрашивать;
  • "yes" — не запрашивать.

($NO_ASKING_SERIAL_NUMBER) — используется в шаблонах поиска серверов. На сервере, найденном при помощи поиска серверов, запускается режим восстановления. При входе на сервер доступна возможность удалённо задать стойку, юнит, серийный номер и наклейку сервера, которые будут отображаться в DCImanager. Данный макрос определяет, будет ли осуществляться запрос серийного номера. Значение, передаваемое макросу, зависит от наличия опции NoAskingSerialNumber конфигурационного файла панели управления:

  • " " — запрашивать;
  • "yes" — не запрашивать.

($OSINSTALLINFO_HTTP) — URL-адрес для получения информации, необходимой для установки ОС, по протоколу HTTP;

($OSINSTALLINFO_HTTPS) — URL-адрес для получения информации, необходимой для установки ОС, по протоколу HTTPS;

($OSINSTALLINFO_HTTPSv4) — URL-адрес для получения информации, необходимой для установки ОС, с использованием протоколов HTTPS и IPv4;

($OSINSTALLINFO_HTTPv4) — URL-адрес для получения информации, необходимой для установки ОС, с использованием протоколов HTTP и IPv4;

($OSINSTALLINFO_SHORT_HTTP) — сокращённый URL-адрес для получения информации, необходимой для установки ОС, по протоколу HTTP;

($PART) — устарел. Не используется;

($PASS) — пароль root-пользователя;

($PASS_CRYPT) — хэш md5 пароля root-пользователя;

($RACKFIND_NOLOGIN) — используется в шаблонах поиска серверов. На сервере, найденном при помощи поиска серверов, запускается режим восстановления. При входе на сервер доступна возможность удалённо задать стойку, юнит, серийный номер и наклейку сервера, которые будут отображаться в DCImanager. Для упрощения этой операции в настройках модуля "Поиск серверов" доступна возможность включить опцию автоматической авторизации на сервере:

  • " " — выполнять;
  • "yes" — не выполнять.

($SHAREDIR_FILE) — URL-адрес директории, доступной по HTTP;

($SHAREDIR_FILEv4) — URL-адрес директории, доступной по HTTP при использовании протокола IPv4;

($SHAREDIR_FILEv6) — URL-адрес директории, доступной по HTTP при использовании протокола IPv6;

($SMB_PATHv4) — путь к Samba-хранилищу по протоколу IPv4. Используется при установке ОС Windows;

($SSHPUBKEYS) — список публичных SSH-ключей. Ключи добавляются в файл /root/.ssh/authorized_keys;

($TIMEZONE) — временная зона;

($TMPIPv4) — использование временного IPv4-адреса на время установки ОС:

  • "true" — использовать;
  • "false" — не использовать.

($WIN_MAC) — MAC-адрес, который используется для определения основного интерфейса сервера при установке ОС Windows.

($WINNTSETUP) — использовать утилиту WinNtSetup. Применяется только для шаблонов ОС Windows Server 2012 R2, 2016, 2019. Возможные значения:

  • "yes" — использовать.