미리 정의된 매크로
매크로는 무인 파일이나 설치 후 스크립트에 가변 데이터(구성 설정)를 추가할 수 있는 기능을 제공합니다. Lenovo XClarity Administrator에서는 사용할 수 있는 미리 정의된 구성 설정 세트를 제공합니다.
미리 정의된 매크로를 무인 또는 설치 후 스크립트 파일에 삽입하려면, 미리 정의 된 매크로에 대해 "predefined"를 매크로 앞에 붙이고 마침표를 사용하여 중첩된 오브젝트를 구분한 다음 매크로 이름을 해시 기호(#)로 묶습니다(예, # predefined.globalSettings.ipAssignment#).
미리 정의된 각 매크로의 값은 XClarity Administrator 인스턴스에 따라 다릅니다. 예를 들어, 필드에서 IP 모드를 지정할 수 있습니다. OS 배포 중에 사용자 입력 값이 수집되면, 값이 미리 정의된 매크로 #predefined.globalSettings.ipAssignment#에 의해 미리 정의된 구성 설정과 ipAssignment 오브젝트 이름의 구성 설정 JSON 파일의 인스턴스에 표시됩니다.
다음 표에서는 XClarity Administrator에서 사용할 수 있는 미리 정의된 매크로(구성 설정)를 나열합니다.
| 매크로 이름 | 유형 | 설명 | ||||
|---|---|---|---|---|---|---|
| predefined | Object | 모든 미리 정의된 OS 배포 설정에 대한 정보 | ||||
| globalSettings | Object | 전역 OS 배포 설정에 대한 정보입니다. | ||||
| credentials | 오브젝트 배열 | 사용자 자격 증명에 대한 정보 | ||||
| name | String | |||||
| type | String | 운영 체제 유형. 이는 다음 값 중 하나입니다.
| ||||
| ipAssignment | String | 운영 체제 배포를 위한 호스트 네트워크 설정 옵션. 이는 다음 값 중 하나입니다.
| ||||
| isVLANMode | String | VLAN 모드 사용 여부를 나타냅니다. 이는 다음 값 중 하나입니다.
| ||||
| hostPlatforms | Object | 호스트 플랫폼의 배포 설정 | ||||
| licenseKey | String | Microsoft Windows 또는 VMware ESXi에 사용할 라이센스 키. 라이센스 키가 없으면 이 필드를 null로 설정할 수 있습니다. | ||||
| networkSettings | Array | 네트워크 설정에 대한 정보 | ||||
| dns1 | String | 운영 체제가 배포된 후 호스트 서버에 사용할 기본 DNS 서버 | ||||
| dns2 | String | 운영 체제가 배포된 후 호스트 서버에 사용할 대체 DNS 서버 | ||||
| gateway | String | 운영 체제가 배포된 후 호스트 서버에 사용할 게이트웨이. 전역 OS 배포 설정에서 네트워크 설정이 정적으로 설정된 경우에 사용됩니다. 팁 IP 모드를 판별하려면 | ||||
| hostname | String | 호스트 서버의 호스트 이름. 호스트 이름을 지정하지 않으면 기본 호스트 이름이 지정됩니다. | ||||
| ipAddress | String | 운영 체제가 배포된 후 호스트 서버에 사용할 IP 주소. 전역 OS 배포 설정에서 네트워크 설정이 정적으로 설정된 경우에 사용됩니다. | ||||
| mtu | Long | 운영 체제가 배포된 후 호스트에 사용할 최대 전송 단위. | ||||
| prefixLength | String | 운영 체제가 배포된 후 호스트 IP 주소에 사용할 접두사 길이. 전역 OS 배포 설정에서 네트워크 설정이 고정 IPv6로 설정된 경우에 사용됩니다. | ||||
| selectedMAC | String | IP 주소를 바인딩할 호스트 서버의 MAC 주소. 기본적으로 MAC 주소는 AUTO로 설정됩니다. 이 설정은 배포에 사용하고 구성할 수 있는 이더넷 포트를 자동으로 감지합니다. 기본적으로 감지된 첫 번째 MAC 주소(포트)가 사용됩니다. 다른 MAC 주소에서 연결이 감지되면 새로 감지된 MAC 주소를 배포에 사용하기 위해 XClarity Administrator 호스트가 자동으로 다시 시작됩니다. 및 selectedMAC은 새로 발견된 MAC 주소로 설정됩니다. 인벤터리에 MAC 주소가 있는 서버에 대해서만 VLAN 모드가 지원됩니다. AUTO가 서버에 MAC 주소만 사용가능인 경우라면 해당 서버로 운영 체제를 배포하는 데 VLAN를 사용할 수 없습니다. 팁 MAC 주소를 얻으려면 | ||||
| subnetCIDRNumber | Integer | 운영 체제가 배포된 후 사용될 호스트 서버의 서브넷 마스크입니다. 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 모드를 판별하려면 | ||||
| subnetMask | String | 운영 체제가 배포된 후 사용될 호스트 서버의 서브넷 마스크입니다. 점으로 구분된 10진수 표기법 형식입니다(예: 255.0.0.0). 전역 OS 배포 설정에서 네트워크 설정이 정적으로 설정된 경우에 사용됩니다. 팁 IP 모드를 판별하려면 | ||||
| vlanId | String | 운영 체제 VLAN 태깅에 대한 VLAN ID. 이 매개 변수는 VLAN 모드가 사용으로 설정된 경우에만 유효합니다. VLAN 모드가 사용되는지 판별하려면 GET /osdeployment/globalSettings를 사용하십시오. 중요사항 네트워크에서 작동하기 위해 VLAN 태그가 필요한 경우에만 VLAN ID를 지정하십시오. VLAN 태그 사용은 호스트 운영 체제와 | ||||
| selectedImage | String | 배포할 운영 체제 이미지의 프로필 ID. 팁 운영 체제 이미지 프로파일 ID를 얻으려면 | ||||
| storageSettings | Array | 운영 체제 이미지를 배포할 기본 스토리지 위치 | ||||
| targetDevice | String | 대상 장치. 이는 다음 값 중 하나입니다.
주 ThinkServer 서버의 경우 이 값은 항상 "localdisk"입니다. | ||||
| unattendFileId | String | 이 배포에 사용할 무인 파일의 ID | ||||
| uuid | String | 운영 체제를 배포할 호스트 서버의 UUID | ||||
| imageSettings | Object | 각 OS 이미지 및 이미지 프로필에 대한 정보 | ||||
| name | String | 운영 체제 이미지 이름 | ||||
| 프로필 | String | 이미지 프로필 이름 | ||||
| otherSettings | Object | 현재 실행 중인 OS 배포 작업과 관련된 추가 설정 | ||||
| deployDataAndSoftwareLocation | String | 추출된 소프트웨어 페이로드, 사용자 지정 파일 및 배포 데이터(예, 인증서 및 로그)의 경로 | ||||
| installRepoUrl | String | (SLES 15 이상에만 해당) 가져온 패키지 이미지의 URL 추가 기능 섹션의 media_url에 대한 사용자 지정 무인 모드에서 미리 정의된 이 매크로를 사용할 수 있습니다. 예를 들면 다음과 같습니다. | ||||
| lxcaIp | String | XClarity Administrator 인스턴스의 IP 주소 | ||||
| lxcaRelease | String | XClarity Administrator 릴리스(예, 2.0.0) | ||||
| jobId | String | 현재 실행 중인 OS 배포 작업의 ID | ||||
| ntpServer | String | XClarity Administrator와 연결된 NTP 서버 | ||||
| statusSettings | Object | OS 배포 상태 설정 | ||||
| urlStatus | String | XClarity Administrator에서 상태를 보고하기 위해 사용하는 HTTPS URL(포트 포함) | ||||
| certLocation | String | 처음 부팅할 때 호스트 OS에서 urlStatus 웹 서비스에 액세스하는 데 필요한 인증서가 포함된 폴더 | ||||
| sdkLocation | String | XClarity Administrator에 액세스하기 위해 XClarity Administrator에서 제공하는 도움 스크립트 및 인터페이스의 위치 | ||||
| timezone | String | XClarity Administrator에 대해 설정된 표준 시간대(예, America/New_York) | ||||
| unattendSettings | Object | 무인 파일을 채우는 데 사용되는 설정. 이 값은 XClarity Administrator의 버전에 따라 다릅니다. | ||||
| networkConfig | String | (ESXi 및 RHEL만 해당) 무인 설치 시 사용할 XClarity Administrator의 미리 정의된 내용. 이는 운영 체제에 대한 네트워크 설정을 구성합니다. | ||||
| preinstallConfig | String | 설치 전 무인 시간에 사용할 XClarity Administrator의 미리 정의된 내용. 여기에는 설치 전 상태가 포함됩니다.
주의 이 매크로를 사용자 지정 무인 파일에 포함시키는 것이 좋습니다. 무인 파일에서 1라인 뒤(<xml> 태그 뒤)의 아무 위치에나 매크로를 둘 수 있습니다. | ||||
| postinstallConfig | String | 서버를 처음 구성하고 부팅한 후 사용할 XClarity Administrator의 미리 정의된 내용. 여기에는 설치 후 상태가 포함됩니다.
주의 이 매크로를 사용자 지정 무인 파일에 포함시키는 것이 좋습니다. 무인 파일에서 1라인 뒤(<xml> 태그 뒤)의 아무 위치에나 매크로를 둘 수 있습니다. | ||||
| reportWorkloadNotComplete | String | 이 매크로가 있으면 postinstallConfig 매크로는 OS 설치 완료됨(17) 상태를 보고하지 않습니다. 사용자 지정 프로필은 완료를 보고해야 합니다. | ||||
| storageConfig | String | (ESXi 및 RHEL만 해당) 무인 설치 시 사용할 XClarity Administrator의 미리 정의된 내용. 이는 운영 체제에 대한 스토리지 설정을 구성합니다. | ||||