설치/업그레이드 스크립트는 지원되는 명령이 포함된 텍스트 파일(예: ks.cfg)입니다.
스크립트의 명령 섹션에는 ESXi 설치 옵션이 포함되어 있습니다. 이 섹션은 필수이며 스크립트에 가장 먼저 나타나야 합니다.
boot.cfg 파일 정보
부트 로더 구성 파일 boot.cfg는 mboot.c32 또는 mboot.efi 부트 로더가 ESXi 설치에 사용하는 커널, 커널 옵션 및 부팅 모듈을 지정합니다.
boot.cfg 파일은 ESXi 설치 관리자에 제공됩니다. boot.cfg 파일의 kernelopt 줄을 수정하여 설치 스크립트의 위치를 지정하거나 기타 부팅 옵션을 전달할 수 있습니다.
# boot.cfg -- mboot configuration file # # Any line preceded with '#' is a comment. title=STRING prefix=DIRPATH kernel=FILEPATH kernelopt=STRING modules=FILEPATH1 --- FILEPATH2... --- FILEPATHn # Any other line must remain unchanged.
boot.cfg에 있는 명령은 부트 로더를 구성합니다.
명령 | 설명 |
---|---|
title=STRING |
부트 로더의 제목을 STRING 으로 설정합니다. |
prefix=STRING |
(선택 사항) / 또는 http://로 시작하지 않는 kernel= 및 modules= 명령에서 모든 FILEPATH 앞에 DIRPATH/ 를 추가합니다. |
kernel=FILEPATH |
커널 경로를 FILEPATH 로 설정합니다. |
kernelopt=STRING |
커널 부팅 옵션에 STRING 을 추가합니다. |
modules=FILEPATH1 --- FILEPATH2... --- FILEPATHn |
로드할 모듈을 하이픈 세 개(--- )로 구분하여 나열합니다. |
사용자 지정 설치 또는 업그레이드 스크립트가 포함된 설치 관리자 ISO 이미지 생성 및 ESXi 설치 관리자를 네트워킹 부팅의 내용을 참조하십시오.
설치 또는 업그레이드 스크립트를 지원하는 위치
스크립트로 작성된 설치 및 업그레이드에서는 ESXi 설치 관리자가 kickstart 파일이라고도 하는 설치 또는 업그레이드 스크립트를 여러 위치에서 액세스할 수 있습니다.
다음 위치에서 설치 또는 업그레이드 스크립트를 사용할 수 있습니다.
- CD/DVD. 사용자 지정 설치 또는 업그레이드 스크립트가 포함된 설치 관리자 ISO 이미지 생성를 참조하십시오.
- USB 플래시 드라이브. ESXi 설치 스크립트 또는 업그레이드 스크립트를 저장하는 USB 플래시 드라이브 생성를 참조하십시오.
- 다음 프로토콜을 사용하여 액세스할 수 있는 네트워크 위치: NFS, HTTP, HTTPS, FTP
설치 또는 업그레이드 스크립트 경로
설치 또는 업그레이드 스크립트에 대한 경로를 지정할 수 있습니다.
ks=http://XXX.XXX.XXX.XXX/kickstart/KS.CFG는 ESXi 설치 스크립트에 대한 경로이며, 여기서 XXX.XXX.XXX.XXX는 스크립트가 있는 시스템의 IP 주소입니다. 스크립트를 사용한 ESXi 설치를 참조하십시오.
대화형 설치에서 설치 스크립트를 시작하려면 ks= 옵션을 수동으로 입력합니다. 부팅 옵션을 입력하여 설치 또는 업그레이드 스크립트 실행를 참조하십시오.
설치 및 업그레이드 스크립트 명령
기본 설치 또는 업그레이드 스크립트를 수정하거나 사용자 고유의 스크립트를 생성하려면 지원되는 명령을 사용하십시오. 설치 관리자를 부팅할 때 부팅 명령과 함께 지정하는 설치 스크립트에서 지원되는 명령을 사용합니다.
ESXi를 설치하거나 업그레이드할 디스크를 결정하려면 설치 스크립트에 다음 명령 중 하나가 필요합니다. install, upgrade 또는 installorupgrade. install 명령은 기본 파티션을 생성합니다. 여기에는 다른 파티션을 생성한 후 남은 모든 사용 가능한 공간을 차지하는 VMFS 데이터스토어가 포함됩니다.
vSphere 8.0에서는 시스템에서 DPU(데이터 처리 장치)를 지원하는 경우 항상 호스트의 ESXi와 함께 DPU의 ESXi 설치, 재설치 또는 업그레이드를 고려하십시오. DPU에서 ESXi 업데이트 및 업그레이드는 대화형 또는 스크립트 방식으로 수행할 수 없으며 vSphere Lifecycle Manager만 사용할 수 있습니다.
accepteula 또는 vmaccepteula(필수)
ESXi 라이센스 계약을 수락합니다.
clearpart(선택 사항)
디스크에서 모든 기존 파티션을 지웁니다. install 명령을 지정해야 합니다. 기존 스크립트에서 clearpart 명령을 주의하여 편집하십시오.
- --drives=
- 지정된 드라이브에서 파티션을 제거합니다.
- --alldrives
-
--drives=
요구 사항을 무시하고 모든 드라이브에서 파티션을 지울 수 있도록 허용합니다. - --ignoredrives=
-
지정된 드라이브를 제외한 모든 드라이브에서 파티션을 제거합니다.
--drives=
또는--alldrives
플래그를 지정한 경우를 제외하고 필수입니다. - --overwritevmfs
- 지정된 드라이브에 대한 VMFS 파티션 덮어쓰기를 허용합니다. 기본적으로 VMFS 파티션 덮어쓰기는 허용되지 않습니다.
- --firstdisk=
-
disk-type1
-
[disk-type2,...]
dryrun(선택 사항)
설치 스크립트를 구문 분석하고 검사합니다. 설치는 수행하지 않습니다.
install
새로운 설치임을 지정합니다. ESXi를 설치하거나 업그레이드할 디스크를 결정하려면 install, upgrade 또는 installorupgrade 명령이 필요합니다.
- --disk= or --drive=
-
파티션할 디스크를 지정합니다. 명령
--disk=diskname
에서 diskname은 ESXi의 전체 디스크 파일 시스템 경로 또는 디스크 이름일 수 있습니다. 예를 들면 다음과 같습니다.- 디스크 이름:
--disk=naa.6d09466044143600247aee55ca2a6405
또는 - 디바이스 경로:
--disk=/vmfs/devices/disks/mpx.vmhba1:C0:T0:L0
허용되는 디스크 이름 형식에 대해서는 디스크 디바이스 이름의 내용을 참조하십시오.
- 디스크 이름:
- --firstdisk=
- disk-type1,
- [ disk-type2,...]
-
참고: vSphere 시스템의 버전이 8.0 업데이트 3 이전이고 DPU가 있는 경우 PCI 슬롯도 지정해야 합니다(
install --firstdisk --overwritevmfs --dpupcislots=<PCIeSlotID>
). 버전 8.0 업데이트 3 이상의 시스템에서는 dpupcislots 매개 변수가 더 이상 사용되지 않습니다. - --ignoressd
- 파티셔닝할 수 있는 적격 디스크에서 솔리드 상태 디스크를 제외합니다. 이 옵션은 install 명령 및 --firstdisk 옵션과 함께 사용할 수 있습니다. 이 옵션은 --firstdisk 옵션보다 우선합니다. 이 옵션은 --drive 또는 --disk 옵션, 그리고 upgrade 및 installorupgrade 명령과 함께 사용할 수 없습니다. 자동 파티셔닝 중에 SSD가 포맷되지 않도록 방지하는 방법에 대한 자세한 내용은 " vSphere 스토리지" 설명서를 참조하십시오.
- --overwritevsan
-
ESXi를
vSAN 디스크 그룹에 속하는 SSD 또는 HDD(자기) 디스크에 설치하는 경우
--overwritevsan 옵션을 사용해야 합니다. 이 옵션을 사용할 때 선택한 디스크에
vSAN 파티션이 없으면 설치에 실패합니다.
ESXi를
vSAN 디스크 그룹에 속하는 디스크에 설치하는 경우 선택하는 디스크에 따라 다음과 같이 결과가 달라집니다.
- SSD를 선택하는 경우 SSD 및 동일한 디스크 그룹의 모든 기본 HDD가 지워집니다.
- HDD를 선택하는 경우 디스크 그룹 크기가 2보다 크면 선택한 HDD만 지워집니다.
- HDD 디스크를 선택하는 경우 디스크 그룹 크기가 2 이하이면 SSD 및 선택한 HDD가 지워집니다.
vSAN 디스크 그룹 관리에 대한 자세한 내용은 "vSphere 스토리지" 설명서를 참조하십시오.
- --overwritevmfs
- 설치하기 전에 디스크의 기존 VMFS 데이터스토어를 덮어쓰려면 필요합니다.
- --preservevmfs
- 설치하는 동안 디스크에 기존 VMFS 데이터스토어를 보존합니다.
- --novmfsondisk
- 이 디스크에 VMFS 파티션이 생성되지 않도록 차단합니다. 디스크에 VMFS 파티션이 있는 경우 --overwritevmfs와 함께 사용해야 합니다.
- --systemdisk
- USB 또는 SD 디바이스를 사용하는 경우 systemDisk는 ESX-OSData 파티션을 설치할 로컬 영구 디스크를 지정합니다. 예를 들어 install --firstdisk = usb --systemDisk=<diskID>입니다. 결과적으로 부트 뱅크 파티션은 USB 디바이스에 배치되고 OSData 파티션은 systemDisk 매개 변수에 지정된 디스크에 배치됩니다.
- --repartitionsystemdisk
- USB 또는 SD 디바이스를 사용하고 systemDisk 매개 변수로 지정한 로컬 디스크가 비어 있지 않거나 데이터스토어가 포함된 경우 repartitionSystemDisk를 사용하여 영구 디스크를 사용하기 전에 다시 분할할 수 있습니다.
- --forceunsupportedinstall
-
더 이상 사용되지 않는 CPU의 설치를 차단합니다.
installorupgrade
ESXi를 설치하거나 업그레이드할 디스크를 결정하려면 install, upgrade 또는 installorupgrade 명령이 필요합니다.
- --disk= or --drive=
-
파티션할 디스크를 지정합니다.
--disk=diskname
명령에서 diskname은 ESXi의 전체 디스크 파일 시스템 경로 또는 디스크 이름일 수 있습니다. 예를 들면 다음과 같습니다.- 디스크 이름:
--disk=naa.6d09466044143600247aee55ca2a6405
또는 - 디바이스 경로:
--disk=/vmfs/devices/disks/mpx.vmhba1:C0:T0:L0
허용되는 디스크 이름 형식에 대해서는 디스크 디바이스 이름의 내용을 참조하십시오.
- 디스크 이름:
- --firstdisk=
- disk-type1,
- [ disk-type2,...]
-
참고: vSphere 시스템의 버전이 8.0 업데이트 3 이전이고 DPU가 있는 경우 PCI 슬롯도 지정해야 합니다(
install --firstdisk --overwritevmfs --dpupcislots=<PCIeSlotID>
). 버전 8.0 업데이트 3 이상의 시스템에서는 dpupcislots 매개 변수가 더 이상 사용되지 않습니다. - --overwritevsan
-
ESXi를
vSAN 디스크 그룹에 속하는 SSD 또는 HDD(자기) 디스크에 설치하는 경우
--overwritevsan 옵션을 사용해야 합니다. 이 옵션을 사용할 때 선택한 디스크에
vSAN 파티션이 없으면 설치에 실패합니다.
ESXi를
vSAN 디스크 그룹에 속하는 디스크에 설치하는 경우 선택하는 디스크에 따라 다음과 같이 결과가 달라집니다.
- SSD를 선택하는 경우 SSD 및 동일한 디스크 그룹의 모든 기본 HDD가 지워집니다.
- HDD를 선택하는 경우 디스크 그룹 크기가 2보다 크면 선택한 HDD만 지워집니다.
- HDD 디스크를 선택하는 경우 디스크 그룹 크기가 2 이하이면 SSD 및 선택한 HDD가 지워집니다.
vSAN 디스크 그룹 관리에 대한 자세한 내용은 "vSphere 스토리지" 설명서를 참조하십시오.
- --overwritevmfs
-
디스크에 VMFS 파티션이 존재하지만 ESX 또는 ESXi 설치가 존재하지 않는 경우 ESXi를 설치합니다. 디스크에 VMFS 파티션만 존재하고 ESX 또는 ESXi 설치가 누락된 경우 이 옵션을 지정하지 않으면 설치 관리자에서 오류가 발생합니다.
keyboard(선택 사항)
시스템의 키보드 유형을 설정합니다.
- keyboardType
-
선택한 키보드 유형에 대한 키보드 맵을 지정합니다.
keyboardType은 다음 유형 중 하나여야 합니다.
- 벨기에어
- 브라질어
- 크로아티아어
- 체코슬로바키아어
- 덴마크어
- 에스토니아어
- 핀란드어
- 프랑스어
- 독일어
- 그리스어
- 아이슬란드어
- 이탈리아어
- 일본어
- 라틴 아메리카어
- 노르웨이어
- 폴란드어
- 포르투갈어
- 러시아어
- 슬로베니아어
- 스페인어
- 스웨덴어
- 프랑스어(스위스)
- 독일어(스위스)
- 터키어
- 우크라이나어
- 영국 영어
- 영어(기본값)
- 영어(Dvorak)
serialnum 또는 vmserialnum(선택 사항)
이 명령은 ESXi 버전 5.1 이상에서 지원됩니다. 라이센싱을 구성합니다. 포함되지 않은 경우 ESXi가 평가 모드로 설치됩니다.
- --esx=<license-key>
-
사용할 vSphere 라이센스 키를 지정합니다. 형식은 5자로 구성된 그룹 5개(XXXXX-XXXXX-XXXXX-XXXXX-XXXXX)입니다.
network(선택 사항)
시스템의 네트워크 주소를 지정합니다.
- --bootproto=[dhcp|static]
-
네트워크 설정을 DHCP에서 가져올지, 수동으로 설정할지를 지정합니다.
- --device=
-
네트워크 카드의 MAC 주소 또는 디바이스 이름을
vmnic0
에서와 같이vmnicNN
형식으로 지정합니다. 이 옵션은 가상 스위치의 업링크 디바이스를 나타냅니다. - --ip=
-
설치할 시스템의 IP 주소를
xxx.xxx.xxx.xxx
형식으로 설정합니다. --bootproto=static 옵션이 있는 경우 필수이며 그 외의 경우는 무시됩니다. - --gateway=
-
기본 게이트웨이를
xxx.xxx.xxx.xxx
형식의 IP 주소로 지정합니다. --bootproto=static 옵션과 함께 사용합니다. - --nameserver=
-
기본 이름 서버를 IP 주소로 지정합니다.
--bootproto=static
옵션과 함께 사용합니다. DNS를 사용하지 않는 경우에는 이 옵션을 생략하십시오.--nameserver
옵션에서는 IP 주소 두 개를 허용합니다. 예:--nameserver="10.126.87.104[,10.126.87.120]"
- --netmask=
-
설치된 시스템의 서브넷 마스크를
255.xxx.xxx.xxx
형식으로 지정합니다.--bootproto=static
옵션과 함께 사용합니다. - --hostname=
- 설치된 시스템의 호스트 이름을 지정합니다.
- --vlanid= vlanid
-
시스템이 속한 VLAN을 지정합니다.
--bootproto=dhcp 또는
--bootproto=static
옵션과 함께 사용합니다. 1에서 4096 사이의 정수로 설정합니다. - --addvmportgroup=(0|1)
- 가상 시스템에 사용되는 VM 네트워크 포트 그룹을 추가할지 여부를 지정합니다. 기본값은 1입니다.
paranoid(선택 사항)
경고 메시지를 통해 설치를 중단하게 만듭니다. 이 명령을 생략하면 주의 메시지가 기록됩니다.
part 또는 partition(선택 사항)
시스템에 추가 VMFS 데이터스토어를 생성합니다. 디스크당 데이터스토어 하나만 생성할 수 있습니다. install 명령과 동일한 디스크에 사용할 수 없습니다. 디스크당 파티션 하나만 지정할 수 있으며 파티션은 VMFS 파티션이어야 합니다
- datastore name
- 파티션을 마운트할 위치를 지정합니다.
- --ondisk= or --ondrive=
- 파티션을 생성할 디스크 또는 드라이브를 지정합니다.
- --onfirstdisk=
- disk-type1,
- [ disk-type2,...]
-
참고: vSphere 시스템의 버전이 8.0 업데이트 3 이전이고 DPU가 있는 경우 PCI 슬롯도 지정해야 합니다(첫 번째 찾은 적격 디스크를 파티셔닝합니다. 기본적으로 적격 디스크는 다음과 같은 순서로 설정됩니다.
install --firstdisk --overwritevmfs --dpupcislots=<PCIeSlotID>
). 버전 8.0 업데이트 3 이상의 시스템에서는 dpupcislots 매개 변수가 더 이상 사용되지 않습니다.- 로컬에 연결된 스토리지(local)
- 네트워크 스토리지(remote)
인수에 추가된 쉼표 구분 목록을 사용하여 디스크 순서를 변경할 수 있습니다. 필터 목록을 지정하면 기본 설정이 재정의됩니다. 필터를 조합하여 특정 디스크(ESX가 설치되어 있는 첫 번째 디스크의 경우 esx 포함), 모델 및 벤더 정보 또는 VMkernel 디바이스 드라이버의 이름을 지정할 수 있습니다. 예를 들어 모델 이름이 ST3120814A인 디스크와 mptsas 드라이버를 사용하는 디스크를 일반 로컬 디스크보다 선호하는 경우 --onfirstdisk=ST3120814A,mptsas,local 인수를 사용합니다. ESXi 이미지가 포함된 로컬 스토리지의 경우 localesx를 사용하거나 ESXi 이미지가 포함된 원격 스토리지의 경우 remoteesx를 사용할 수 있습니다.
reboot(선택 사항)
스크립트로 작성된 설치가 완료된 후 시스템을 재부팅합니다.
- <--noeject>
- 설치 후 CD를 꺼내지 않습니다.
rootpw(필수)
시스템의 루트 암호를 설정합니다.
- --iscrypted
- 암호를 암호화하도록 지정합니다.
- password
- 암호 값을 지정합니다.
업그레이드
ESXi를 설치하거나 업그레이드할 디스크를 결정하려면 install, upgrade 또는 installorupgrade 명령이 필요합니다.
- --disk= or --drive=
-
파티션할 디스크를 지정합니다. 명령
--disk=diskname
에서 diskname은 ESXi의 전체 디스크 파일 시스템 경로 또는 디스크 이름일 수 있습니다. 예를 들면 다음과 같습니다.- 디스크 이름:
--disk=naa.6d09466044143600247aee55ca2a6405
또는 - 디바이스 경로:
--disk=/vmfs/devices/disks/mpx.vmhba1:C0:T0:L0
허용되는 디스크 이름 형식에 대해서는 디스크 디바이스 이름의 내용을 참조하십시오.
- 디스크 이름:
- --firstdisk=
- disk-type1,
- [ disk-type2,...]
-
첫 번째 찾은 적격 디스크를 파티셔닝합니다. 기본적으로 적격 디스크는 다음과 같은 순서로 설정됩니다.
- 로컬에 연결된 스토리지(local)
- 네트워크 스토리지(remote)
인수에 추가된 쉼표 구분 목록을 사용하여 디스크 순서를 변경할 수 있습니다. 필터 목록을 지정하면 기본 설정이 재정의됩니다. 필터를 조합하여 특정 디스크(ESX가 설치되어 있는 첫 번째 디스크의 경우 esx 포함), 모델 및 벤더 정보 또는 VMkernel 디바이스 드라이버의 이름을 지정할 수 있습니다. 예를 들어 모델 이름이 ST3120814A인 디스크와 mptsas 드라이버를 사용하는 디스크를 일반 로컬 디스크보다 선호하는 경우 --firstdisk=ST3120814A,mptsas,local 인수를 사용합니다. ESXi 이미지가 포함된 로컬 스토리지의 경우 localesx를 사용하거나 ESXi 이미지가 포함된 원격 스토리지의 경우 remoteesx를 사용할 수 있습니다.
%include 또는 include(선택 사항)
구문 분석할 다른 설치 스크립트를 지정합니다. 이 명령은 여러 줄 명령과 유사하게 처리되지만 인수는 하나만 인식합니다.
- filename
- 예: %include part.cfg
%pre(선택 사항)
kickstart 구성을 평가하기 전에 실행할 스크립트를 지정합니다. 예를 들어 이 명령을 사용하여 kickstart 파일에 포함될 파일을 생성할 수 있습니다.
- --interpreter
- =[python|busybox]
- 사용할 인터프리터를 지정합니다. 기본값은 busybox입니다.
%post(선택 사항)
패키지 설치가 완료된 후 지정된 스크립트를 실행합니다. %post 섹션을 여러 개 지정한 경우 설치 스크립트에 나타나는 순서대로 실행됩니다.
- --interpreter
- =[python|busybox]
- 사용할 인터프리터를 지정합니다. 기본값은 busybox입니다.
- --timeout=secs
- 스크립트 실행 시간 초과를 지정합니다. 스크립트가 이 시간이 초과될 때까지 완료되지 않으면 강제로 중지됩니다.
- --ignorefailure
- =[true|false]
- true이면 %post 스크립트가 오류와 함께 중지된 경우에도 설치가 성공한 것으로 간주됩니다.
%firstboot
첫 번째 부팅 중에만 실행되는 init 스크립트를 생성합니다. 이후의 부팅에는 이 스크립트가 영향을 미치지 않습니다. %firstboot 섹션을 여러 개 지정한 경우 kickstart 파일에 나타나는 순서대로 실행됩니다.
- --interpreter
- =[python|busybox]