Перейти к основному содержимому

Заранее определенные макросы

Макросы предоставляют возможность добавить переменные данные (параметры конфигурации) в файл автоматической установки или послеустановочный скрипт. Lenovo XClarity Administrator предоставляет набор заранее определенных параметров, которые можно использовать.

Чтобы добавить заранее определенные макросы в файл автоматической установки или послеустановочный скрипт, добавьте в качестве префикса макроса predefined для заранее определенных макросов, разделите вложенные объекты с помощью точки и заключите имя макроса в символы «решетки» (#), например #predefined.globalSettings.ipAssignment#.

Значение для каждого заранее определенного макроса отличается в зависимости от экземпляра XClarity Administrator. Например, выбрав Развертывание образов ОС > Глобальные параметры > Назначение IP-адресов, можно задать режим назначения IP-адресов. После получения введенного пользователем значения во время развертывания ОС это значение представляется в заранее определенных параметрах конфигурации заранее определенным макросом #predefined.globalSettings.ipAssignment# и в экземпляре JSON-файла параметров конфигурации под именем объекта ipAssignment.

В следующей таблице перечислены заранее определенные макросы (параметры конфигурации), доступные в XClarity Administrator.

Имя макросаТипОписание
predefinedОбъектСведения обо всех заранее определенных параметрах развертывания ОС
 globalSettingsОбъектСведения о глобальных параметрах развертывания ОС.
  activeDirectoryМассив объектов(Только для Windows) Сведения об Active Directory
   domainNameСтрокаДоменное имя службы Windows Active Directory
  credentialsМассив объектовСведения об учетных данных пользователей
   nameСтрока 
   plaintextPasswordСтрока(Только для Windows) Пароль в виде обычного текста для учетных данных ОС Windows
   typeСтрокаТип операционной системы. Может иметь одно из следующих значений.
  • ESXi
  • LINUX
  • WINDOWS
  ipAssignmentСтрокаРежим задания сетевых параметров хоста при развертывании операционной системы. Может иметь одно из следующих значений.
  • dhcpv4
  • staticv4
  • staticv6
  isVLANModeСтрокаУказывает, используется ли режим VLAN. Может иметь одно из следующих значений.
  • true. Режим VLAN используется.
  • false. Режим VLAN не используется.
 hostPlatformsОбъектПараметры развертывания с платформ хостов
  licenseKeyСтрокаЛицензионный ключ, который будет использоваться для Microsoft Windows и VMware ESXi. При отсутствии лицензионного ключа можно задать для этого поля значение null.
  networkSettingsМассивСведения о сетевых параметрах
   dns1СтрокаПредпочитаемый сервер DNS для сервера хоста, который будет использоваться после развертывания операционной системы
   dns2СтрокаАльтернативный сервер DNS для сервера хоста, который будет использоваться после развертывания операционной системы
   gatewayСтрокаШлюз сервера хоста, который будет использоваться после развертывания операционной системы. Этот параметр используется, если в глобальных параметрах развертывания ОС для сетевых параметров задан статический режим.
Совет
Чтобы определить режим IP, используйте GET /osdeployment/globalSettings.
   hostnameСтрокаИмя хоста сервера хоста. Если имя хоста не указано, назначается имя хоста по умолчанию.
   ipAddressСтрокаIP-адрес сервера хоста, который будет использоваться после развертывания операционной системы. Этот параметр используется, если в глобальных параметрах развертывания ОС для сетевых параметров задан статический режим.
   mtuДлинное целоеМаксимальный передаваемый блок данных хоста, который будет использоваться после развертывания операционной системы.
   prefixLengthСтрокаДлина префикса IP-адреса хоста, которая будет использоваться после развертывания операционной системы. Этот параметр используется, если в глобальных параметрах развертывания ОС для сетевых параметров задан статический режим IPv6.
   selectedMACСтрокаMAC-адрес сервера хоста, к которому необходимо привязать IP-адрес.

MAC-адрес имеет значение AUTO по умолчанию. Этот параметр автоматически обнаруживает порты Ethernet, которые можно настроить и использовать для развертывания. По умолчанию используется первый обнаруженный MAC-адрес (порт). Если обнаружено подключение на другом MAC-адресе, хост XClarity Administrator автоматически перезапускается, чтобы использовать новый обнаруженный MAC-адрес для развертывания и для параметра selectedMAC устанавливается значение недавно обнаруженного MAC-адреса.

Режим VLAN поддерживается только для серверов, которые имеют MAC-адреса в инвентаре. Если AUTO — единственный MAC-адрес, доступный для сервера, использовать виртуальные локальные сети для развертывания операционных систем на этом сервере невозможно.

Совет
Чтобы получить MAC-адрес, используйте свойство ответа macaddress в GET /hostPlatforms.
   subnetCIDRNumberЦелое числоМаска подсети хост-сервера, которая будет использоваться после развертывания операционной системы, в формате бесклассовой междоменной маршрутизации (CIDR). Этот параметр используется, если в глобальных параметрах развертывания ОС для сетевых параметров задан статический режим.

Перед номером CIDR обычно стоит косая черта «/», а после — указывается IP-адрес. Например, IP-адрес 131.10.55.70 с маской подсети 255.0.0.0 (которая имеет 8 сетевых битов) будет представлен как 131.10.55.70 /8. Дополнительные сведения см. в разделе Веб-страница учебника по нотации CIDR.

Совет
Чтобы определить режим IP, используйте GET /osdeployment/globalSettings.
   subnetMaskСтрокаМаска подсети сервера хоста, которая будет использоваться после развертывания операционной системы, в десятичном представлении адреса с точками (например, 255.0.0.0). Этот параметр используется, если в глобальных параметрах развертывания ОС для сетевых параметров задан статический режим.
Совет
Чтобы определить режим IP, используйте GET /osdeployment/globalSettings.
   vlanIdСтрокаИдентификатор VLAN для добавления меток виртуальной локальной сети операционной системы.

Этот параметр используется, только если включен режим VLAN. Чтобы определить, включен ли режим VLAN, используйте GET /osdeployment/globalSettings).

Важное замечание
Идентификатор VLAN следует указывать, только если в сети требуется метка VLAN. Использование меток VLAN может повлиять на маршрутизацию между операционной системой хоста и XClarity Administrator.
  selectedImageСтрокаИдентификатор профиля образа операционной системы для развертывания.
Совет
Чтобы получить идентификаторы профилей образов операционной системы, используйте свойство ответа availableImages в GET /hostPlatforms.
  storageSettingsМассивПредпочитаемое расположение хранилища, где требуется развернуть образы операционной системы.
   targetDeviceСтрокаЦелевое устройство. Может иметь одно из следующих значений.
  • localdisk. Локальный дисковый накопитель. Используется первый перечисленный локальный дисковый накопитель на управляемом сервере.
  • M.2drive. Диск M.2. Используется первый перечисленный диск M.2 на управляемом сервере.
  • usbdisk. Встроенный гипервизор USB. Это расположение используется только при развертывании образа VMware ESXi на управляемых серверах. Если на управляемом сервере установлены два ключа гипервизора, установщик VMware выберет для развертывания первый указанный ключ.
  • lunpluswwn=LUN@WWN. Хранилище FC SAN (например, lunpluswwn=2@50:05:07:68:05:0c:09:bb).
  • lunplusiqn=LUN@IQN. Хранилище iSCSI SAN (например, lunplusiqn=0@iqn.1990-01.com.lenovo:tgt1). Параметр IQN указывать не обязательно, если настроен только один целевой объект iSCSI. Если параметр IQN не указан, для OSDN выбирается первый обнаруженный целевой объект iSCSI. Если этот параметр указан, выбирается точное совпадение.
Прим.
Для серверов ThinkServer этот параметр всегда имеет значение localdisk.
  unattendFileIdСтрокаИдентификатор файла автоматической установки, который будет использоваться в этом развертывании
  — UUIDСтрокаUUID сервера хоста, на котором будет развернута операционная система
 imageSettingsОбъектСведения о каждом образе ОС и профиле образа
  nameСтрокаИмя образа операционной системы
  профильСтрокаИмя профиля образа
 otherSettingsОбъектДополнительные параметры, относящиеся к выполняемым в настоящее время заданиям развертывания ОС
  deployDataAndSoftwareLocationСтрокаПуть к извлеченным полезным данным программного обеспечения, пользовательским файлам и данным развертывания (например, сертификатам и журналам)
  installRepoUrlСтрока(Только SLES 15 и выше) URL-адрес для импортированного образа пакета
Этот заранее определенный макрос можно использовать в пользовательском файле автоматической установки для media_url в дополнительном разделе, например:
<add-on>
   <add_on_products config:type="list">
      <listentry>
         <media_url>#predefined.otherSettings.installRepoUrl#
         </media_url>
         <product>sle-module-basesystem</product>
         <product_dir>/Module-Basesystem</product_dir>
      </listentry>
   </add_on_products>
</add-on>
  lxcaIpСтрокаIP-адрес экземпляра XClarity Administrator
  lxcaReleaseСтрокаВыпуск XClarity Administrator (например, 2.0.0)
  jobIdСтрокаИдентификатор выполняемого в настоящее время задания развертывания ОС
  ntpServerСтрокаСервер NTP, связанный с XClarity Administrator
  statusSettingsОбъектПараметры состояния развертывания ОС
   urlStatusСтрокаURL-адрес HTTPS (включая порт), который XClarity Administrator использует для сообщения о состоянии
   certLocationСтрокаПапка, содержащая сертификаты, необходимые для доступа к веб-службе urlStatus из ОС хоста при первой загрузке
   sdkLocationСтрокаРасположение программного обеспечения XClarity Administrator, которое предоставило скрипты поддержки и интерфейсы для доступа к XClarity Administrator.
  timezoneСтрокаЧасовой пояс, заданный для XClarity Administrator (например, Америка/Нью Йорк)
 unattendSettingsОбъектПараметры, используемые для заполнения файла автоматической установки. Эти значения относятся к версии XClarity Administrator.
  osМассив объектов(Только для Windows) Сведения об ОС Windows
   installImageNameСтрокаИмя образа операционной системы, который требуется установить
  networkConfigСтрока(Только для ESXi и RHEL) Заранее определенное программным обеспечением XClarity Administrator содержимое для использования во время автоматической установки. Обеспечивает настройку сетевых параметров для операционной системы
  preinstallConfigСтрокаЗаранее определенное программным обеспечением XClarity Administrator содержимое для использования во время автоматической предварительной установки. Этот макрос содержит состояние до установки.

  • В ESXi и RHEL этот макрос использует обработчик предустановочных скриптов %pre.

  • В SLES этот макрос использует обработчик предустановочных скриптов <scripts>.

Внимание
Настоятельно рекомендуется включить этот макрос в пользовательский файл автоматической установки. Макрос можно расположить в любом месте файла автоматической установки после строки 1 (после тега <xml>).
  postinstallConfigСтрокаЗаранее определенное программным обеспечением XClarity Administrator содержимое для использования после настройки и первой загрузки сервера. Этот макрос содержит состояние после установки.

  • В ESXi и RHEL этот макрос использует обработчик послеустановочных скриптов %post.

  • В SLES этот макрос использует обработчик послеустановочных скриптов <scripts>.

  • В Windows этот макрос использует раздел «специальные параметры».

Внимание
Настоятельно рекомендуется включить этот макрос в пользовательский файл автоматической установки. Макрос можно расположить в любом месте файла автоматической установки после строки 1 (после тега <xml>).
  reportWorkloadNotCompleteСтрокаПри наличии этого макроса макрос postinstallConfig не сообщает о состоянии «Установка ОС завершена (17)». Настраиваемый профиль должен сообщать о завершении.
  storageConfigСтрока(Только для ESXi и RHEL) Заранее определенное программным обеспечением XClarity Administrator содержимое для использования во время автоматической установки. Обеспечивает настройку параметров хранилища для операционной системы.