본문으로 건너뛰기

미리 정의된 매크로

매크로는 무인 파일이나 설치 후 스크립트에 가변 데이터(구성 설정)를 추가할 수 있는 기능을 제공합니다. Lenovo XClarity Administrator에서는 사용할 수 있는 미리 정의된 구성 설정 세트를 제공합니다.

미리 정의된 매크로를 무인 또는 설치 후 스크립트 파일에 삽입하려면, 미리 정의 된 매크로에 대해 "predefined"를 매크로 앞에 붙이고 마침표를 사용하여 중첩된 오브젝트를 구분한 다음 매크로 이름을 해시 기호(#)로 묶습니다(예, # predefined.globalSettings.ipAssignment#).

미리 정의된 각 매크로의 값은 XClarity Administrator 인스턴스에 따라 다릅니다. 예를 들어, OS 이미지 배포 > 전역 설정 > IP 할당 필드에서 IP 모드를 지정할 수 있습니다. OS 배포 중에 사용자 입력 값이 수집되면, 값이 미리 정의된 매크로 #predefined.globalSettings.ipAssignment#에 의해 미리 정의된 구성 설정과 ipAssignment 오브젝트 이름의 구성 설정 JSON 파일의 인스턴스에 표시됩니다.

다음 표에서는 XClarity Administrator에서 사용할 수 있는 미리 정의된 매크로(구성 설정)를 나열합니다.

매크로 이름유형설명
predefinedObject모든 미리 정의된 OS 배포 설정에 대한 정보
 globalSettingsObject전역 OS 배포 설정에 대한 정보입니다.
  credentials오브젝트 배열사용자 자격 증명에 대한 정보
   nameString 
   typeString운영 체제 유형. 이는 다음 값 중 하나입니다.
  • ESXi
  • LINUX
  • WINDOWS
  ipAssignmentString운영 체제 배포를 위한 호스트 네트워크 설정 옵션. 이는 다음 값 중 하나입니다.
  • dhcpv4
  • staticv4
  • staticv6
  isVLANModeStringVLAN 모드 사용 여부를 나타냅니다. 이는 다음 값 중 하나입니다.
  • true. VLAN 모드가 사용됩니다.
  • false. VLAN 모드가 사용되지 않습니다.
 hostPlatformsObject호스트 플랫폼의 배포 설정
  licenseKeyStringMicrosoft Windows 또는 VMware ESXi에 사용할 라이센스 키. 라이센스 키가 없으면 이 필드를 null로 설정할 수 있습니다.
  networkSettingsArray네트워크 설정에 대한 정보
   dns1String운영 체제가 배포된 후 호스트 서버에 사용할 기본 DNS 서버
   dns2String운영 체제가 배포된 후 호스트 서버에 사용할 대체 DNS 서버
   gatewayString운영 체제가 배포된 후 호스트 서버에 사용할 게이트웨이. 전역 OS 배포 설정에서 네트워크 설정이 정적으로 설정된 경우에 사용됩니다.
IP 모드를 판별하려면 GET /osdeployment/globalSettings를 사용하십시오.
   hostnameString호스트 서버의 호스트 이름. 호스트 이름을 지정하지 않으면 기본 호스트 이름이 지정됩니다.
   ipAddressString운영 체제가 배포된 후 호스트 서버에 사용할 IP 주소. 전역 OS 배포 설정에서 네트워크 설정이 정적으로 설정된 경우에 사용됩니다.
   mtuLong운영 체제가 배포된 후 호스트에 사용할 최대 전송 단위.
   prefixLengthString운영 체제가 배포된 후 호스트 IP 주소에 사용할 접두사 길이. 전역 OS 배포 설정에서 네트워크 설정이 고정 IPv6로 설정된 경우에 사용됩니다.
   selectedMACStringIP 주소를 바인딩할 호스트 서버의 MAC 주소.

기본적으로 MAC 주소는 AUTO로 설정됩니다. 이 설정은 배포에 사용하고 구성할 수 있는 이더넷 포트를 자동으로 감지합니다. 기본적으로 감지된 첫 번째 MAC 주소(포트)가 사용됩니다. 다른 MAC 주소에서 연결이 감지되면 새로 감지된 MAC 주소를 배포에 사용하기 위해 XClarity Administrator 호스트가 자동으로 다시 시작됩니다. 및 selectedMAC은 새로 발견된 MAC 주소로 설정됩니다.

인벤터리에 MAC 주소가 있는 서버에 대해서만 VLAN 모드가 지원됩니다. AUTO가 서버에 MAC 주소만 사용가능인 경우라면 해당 서버로 운영 체제를 배포하는 데 VLAN를 사용할 수 없습니다.

MAC 주소를 얻으려면 GET /hostPlatforms에서 macaddress 응답 속성을 사용하십시오.
   subnetCIDRNumberInteger운영 체제가 배포된 후 사용될 호스트 서버의 서브넷 마스크입니다. CIDR(Classless Inter-Domain Routing) 형식입니다. 전역 OS 배포 설정에서 네트워크 설정이 정적으로 설정된 경우에 사용됩니다.

CIDR 번호는 일반적으로 슬래시 "/"로 시작하고 IP 주소 뒤에 옵니다. 예를 들어, 서브넷 마스크가 255.0.0.0(8개의 네트워크 비트 포함)인 IP 주소 131.10.55.70은 131.10.55.70 /8로 표시됩니다. 자세한 정보는 CIDR 표기법 튜토리얼 웹 페이지의 내용을 참조하십시오.

IP 모드를 판별하려면 GET /osdeployment/globalSettings를 사용하십시오.
   subnetMaskString운영 체제가 배포된 후 사용될 호스트 서버의 서브넷 마스크입니다. 점으로 구분된 10진수 표기법 형식입니다(예: 255.0.0.0). 전역 OS 배포 설정에서 네트워크 설정이 정적으로 설정된 경우에 사용됩니다.
IP 모드를 판별하려면 GET /osdeployment/globalSettings를 사용하십시오.
   vlanIdString운영 체제 VLAN 태깅에 대한 VLAN ID.

이 매개 변수는 VLAN 모드가 사용으로 설정된 경우에만 유효합니다. VLAN 모드가 사용되는지 판별하려면 GET /osdeployment/globalSettings를 사용하십시오.

중요사항
네트워크에서 작동하기 위해 VLAN 태그가 필요한 경우에만 VLAN ID를 지정하십시오. VLAN 태그 사용은 호스트 운영 체제와 XClarity Administrator 사이의 네트워크 라우팅에 영향을 미칠 수 있습니다.
  selectedImageString배포할 운영 체제 이미지의 프로필 ID.
운영 체제 이미지 프로필 ID를 얻으려면 GET /hostPlatforms에서 availableImages 응답 속성을 사용하십시오.
  storageSettingsArray운영 체제 이미지를 배포할 기본 스토리지 위치
   targetDeviceString대상 장치. 이는 다음 값 중 하나입니다.
  • localdisk. 로컬 디스크 드라이브. 관리되는 서버에서 처음에 열거된 로컬 드라이브를 사용합니다.
  • M.2 드라이브. M.2 드라이브. 관리되는 서버에서 처음에 열거된 M.2 드라이브를 사용합니다.
  • usbdisk. 내장 USB 하이퍼바이저. 이 위치는 VMware ESXi 이미지가 관리되는 서버에 배포되는 경우에만 적용됩니다. 2개의 하이퍼바이저 키가 관리되는 서버에 설치되어 있는 경우 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). iSCSI 타겟이 하나만 구성된 경우 IQN 지정은 선택 사항이나, IQN를 지정하지 않으면 OSDN에 대해 처음 감지된 iSCSI 타겟이 선택됩니다. 지정된 경우 정확히 일치합니다.
ThinkServer 서버의 경우 이 값은 항상 localdisk입니다.
  unattendFileIdString이 배포에 사용할 무인 파일의 ID
  uuidString운영 체제를 배포할 호스트 서버의 UUID
 imageSettingsObject각 OS 이미지 및 이미지 프로필에 대한 정보
  nameString운영 체제 이미지 이름
  프로필String이미지 프로필 이름
 otherSettingsObject현재 실행 중인 OS 배포 작업과 관련된 추가 설정
  deployDataAndSoftwareLocationString추출된 소프트웨어 페이로드, 사용자 지정 파일 및 배포 데이터(예, 인증서 및 로그)의 경로
  installRepoUrlString(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>
  lxcaIpStringXClarity Administrator 인스턴스의 IP 주소
  lxcaReleaseStringXClarity Administrator 릴리스(예, 2.0.0)
  jobIdString현재 실행 중인 OS 배포 작업의 ID
  ntpServerStringXClarity Administrator와 연결된 NTP 서버
  statusSettingsObjectOS 배포 상태 설정
   urlStatusStringXClarity Administrator에서 상태를 보고하기 위해 사용하는 HTTPS URL(포트 포함)
   certLocationString처음 부팅할 때 호스트 OS에서 urlStatus 웹 서비스에 액세스하는 데 필요한 인증서가 포함된 폴더
   sdkLocationStringXClarity Administrator에 액세스하기 위해 XClarity Administrator에서 제공하는 도움 스크립트 및 인터페이스의 위치
  timezoneStringXClarity Administrator에 대해 설정된 표준 시간대(예, America/New_York)
 unattendSettingsObject무인 파일을 채우는 데 사용되는 설정. 이 값은 XClarity Administrator의 버전에 따라 다릅니다.
  networkConfigString(ESXi 및 RHEL만 해당) 무인 설치 시 사용할 XClarity Administrator의 미리 정의된 내용. 이는 운영 체제에 대한 네트워크 설정을 구성합니다.
  preinstallConfigString설치 전 무인 시간에 사용할 XClarity Administrator의 미리 정의된 내용. 여기에는 설치 전 상태가 포함됩니다.
  • ESXi 및 RHEL의 경우, %pre 설치 전 스크립트 훅을 사용합니다.

  • SLES의 경우 <scripts> 설치 전 스크립트 훅을 사용합니다.

주의
이 매크로를 사용자 지정 무인 파일에 포함시키는 것이 좋습니다. 무인 파일에서 1라인 뒤(<xml> 태그 뒤)의 아무 위치에나 매크로를 둘 수 있습니다.
  postinstallConfigString서버를 처음 구성하고 부팅한 후 사용할 XClarity Administrator의 미리 정의된 내용. 여기에는 설치 후 상태가 포함됩니다.
  • ESXi 및 RHEL의 경우, %post 설치 후 스크립트 훅을 사용합니다.

  • SLES의 경우 <scripts> 설치 후 스크립트 훅을 사용합니다.

  • Windows의 경우 "설정 특수화" 섹션을 사용합니다.

주의
이 매크로를 사용자 지정 무인 파일에 포함시키는 것이 좋습니다. 무인 파일에서 1라인 뒤(<xml> 태그 뒤)의 아무 위치에나 매크로를 둘 수 있습니다.
  reportWorkloadNotCompleteString이 매크로가 있으면 postinstallConfig 매크로는 OS 설치 완료됨(17) 상태를 보고하지 않습니다. 사용자 지정 프로필은 완료를 보고해야 합니다.
  storageConfigString(ESXi 및 RHEL만 해당) 무인 설치 시 사용할 XClarity Administrator의 미리 정의된 내용. 이는 운영 체제에 대한 스토리지 설정을 구성합니다.