มาโครแบบกำหนดไว้ล่วงหน้า

มาโคร ช่วยให้คุณสามารถเพิ่มข้อมูลตัวแปร (การตั้งค่าการกำหนดค่า) ให้กับไฟล์อัตโนมัติหรือสคริปต์หลังการติดตั้ง Lenovo XClarity Administrator จะให้ชุดการตั้งค่าการกำหนดค่าที่กำหนดไว้ล่วงหน้าที่คุณสามารถใช้ได้

ในการใส่มาโครแบบกำหนดไว้ล่วงหน้าในไฟล์อัตโนมัติหรือสคริปต์หลังการติดตั้ง ให้ขึ้นต้นมาโครแบบกำหนดไว้ล่วงหน้าด้วย “predefined” คั่นออบเจกต์ที่ซ้อนกันด้วยเครื่องหมายจุด และคร่อมชื่อมาโครด้วยเครื่องหมายสี่เหลี่ยม (#) ตัวอย่างเช่น #predefined.globalSettings.ipAssignment#

ค่าของมาโครแบบกำหนดไว้ล่วงหน้าแต่ละรายการจะแตกต่างกันตามอินสแตนซ์ XClarity Administrator เช่น ฟิลด์ ปรับใช้อิมเมจ OS > การตั้งค่าส่วนกลาง > การกำหนด IP ซึ่งให้คุณระบุโหมด IP ได้ หลังจากรวบรวมค่าที่ผู้ใช้ป้อนระหว่างการปรับใช้ OS แล้ว ค่านั้นจะแสดงในการตั้งค่าการกำหนดค่าแบบกำหนดไว้ล่วงหน้าโดยมาโครแบบกำหนดไว้ล่วงหน้า #predefined.globalSettings.ipAssignment# และในอินสแตนซ์ของไฟล์ JSON การตั้งค่าการกำหนดค่าภายใต้ชื่อออบเจกต์ ipAssignment

ตารางต่อไปนี้จะแสดงมาโครแบบกำหนดไว้ล่วงหน้า (การตั้งค่าการกำหนดค่า) ที่ใช้ได้ใน XClarity Administrator

ชื่อมาโคร				รุ่น	รายละเอียด
กำหนดไว้ล่วงหน้า				ออบเจกต์	ข้อมูลเกี่ยวกับการตั้งค่าการปรับใช้ OS แบบกำหนดไว้ล่วงหน้าทั้งหมด
	globalSettings			ออบเจกต์	ข้อมูลเกี่ยวกับการตั้งค่าการปรับใช้ OS ส่วนกลาง
		credentials		อาร์เรย์ของออบเจกต์	ข้อมูลเกี่ยวกับข้อมูลประจำตัวผู้ใช้
			name	สตริง
			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 สำรองสำหรับเซิร์ฟเวอร์โฮสต์ที่จะใช้หลังจากปรับใช้ระบบปฏิบัติการ
			เกตเวย์	สตริง	เกตเวย์ของเซิร์ฟเวอร์โฮสต์ที่จะใช้หลังจากปรับใช้ระบบปฏิบัติการ ซึ่งจะใช้เมื่อตั้งค่าเครือข่ายเป็นแบบคงที่ในการตั้งค่าการปรับใช้ OS ส่วนกลาง คำแนะนำ ในการดูโหมด IP ให้ใช้ GET /osdeployment/globalSettings
			ชื่อโฮสต์	สตริง	ชื่อโฮสต์สำหรับเซิร์ฟเวอร์โฮสต์ หากไม่ได้ระบุชื่อโฮสต์ ระบบจะใช้ชื่อโฮสต์ที่เป็นค่าเริ่มต้น
			ipAddress	สตริง	ที่อยู่ IP ของเซิร์ฟเวอร์โฮสต์ที่จะใช้หลังจากปรับใช้ระบบปฏิบัติการ ซึ่งจะใช้เมื่อตั้งค่าเครือข่ายเป็นแบบคงที่ในการตั้งค่าการปรับใช้ OS ส่วนกลาง
			mtu	ค่ายาว	หน่วยการส่งข้อมูลสูงสุดสำหรับโฮสต์ที่จะใช้หลังจากปรับใช้ระบบปฏิบัติการ
			prefixLength	สตริง	ความยาวคำนำหน้าของที่อยู่ IP ของโฮสต์ที่จะใช้หลังจากปรับใช้ระบบปฏิบัติการ ซึ่งจะใช้เมื่อตั้งค่าเครือข่ายเป็น IPv6 แบบคงที่ในการตั้งค่าการปรับใช้ OS ส่วนกลาง
			selectedMAC	สตริง	ที่อยู่ MAC ของเซิร์ฟเวอร์โฮสต์ที่จะผูกที่อยู่ IP ที่อยู่ MAC จะถูกตั้งค่าเป็น AUTO (อัตโนมัติ) โดยค่าเริ่มต้น การตั้งค่านี้จะตรวจหาพอร์ตอีเทอร์เน็ตที่สามารถกำหนดค่าและใช้ในการปรับใช้ได้โดยอัตโนมัติ โดยค่าเริ่มต้น ระบบจะใช้ที่อยู่ MAC (พอร์ต) แรกที่ตรวจพบ หากตรวจพบการเชื่อมต่อบนที่อยู่ MAC อื่น โฮสต์ XClarity Administrator จะรีสตาร์ทโดยอัตโนมัติเพื่อใช้ที่อยู่ MAC ที่ตรวจพบใหม่ในการปรับใช้ และจะกำหนด selectedMAC ให้กับที่อยู่ MAC ที่ตรวจพบใหม่ โหมด VLAN จะรองรับเฉพาะในเซิร์ฟเวอร์ที่มีที่อยู่ MAC ในรายการอุปกรณ์ของเซิร์ฟเวอร์ดังกล่าวเท่านั้น หาก AUTO เป็นที่อยู่ MAC ที่พร้อมใช้งานเพียงรายการเดียวสำหรับเซิร์ฟเวอร์ จะไม่สามารถใช้ VLAN เพื่อปรับใช้ระบบปฏิบัติการกับเซิร์ฟเวอร์นั้นได้ คำแนะนำ ในการรับที่อยู่ MAC ให้ใช้คุณสมบัติการตอบกลับ macaddress ใน GET /hostPlatforms
			subnetCIDRNumber	จำนวนเต็ม	ซับเน็ตมาสก์ของเซิร์ฟเวอร์โฮสต์ที่จะใช้หลังจากปรับใช้ระบบปฏิบัติการในรูปแบบ Classless Inter-Domain Routing (CIDR) ซึ่งจะใช้เมื่อตั้งค่าเครือข่ายเป็นแบบคงที่ในการตั้งค่าการปรับใช้ OS ส่วนกลาง โดยทั่วไปหมายเลข 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) ซึ่งจะใช้เมื่อตั้งค่าเครือข่ายเป็นแบบคงที่ในการตั้งค่าการปรับใช้ OS ส่วนกลาง คำแนะนำ ในการดูโหมด IP ให้ใช้ GET /osdeployment/globalSettings
			vlanId	สตริง	VLAN ID สำหรับการแท็ก VLAN ของระบบปฏิบัติการ พารามิเตอร์นี้จะใช้ได้ก็ต่อเมื่อเปิดใช้งานโหมด VLAN เพื่อดูว่าโหมด VLAN เปิดใช้งานหรือไม่ โปรดใช้ GET /osdeployment/globalSettings) สำคัญ ให้ระบุ VLAN ID เมื่อจำเป็นต้องใช้แท็ก VLAN บนเครือข่ายเท่านั้น การใช้แท็ก VLAN อาจส่งผลต่อการกำหนดเส้นทางเครือข่ายระหว่างระบบปฏิบัติการโฮสต์และ XClarity Administrator
		selectedImage		สตริง	ID โปรไฟล์ของไฟล์อิมเมจระบบปฏิบัติการที่จะปรับใช้ คำแนะนำ ในการรับ ID โปรไฟล์อิมเมจระบบปฏิบัติการ ให้ใช้คุณสมบัติการตอบกลับ 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` ระบบจะเลือกเป้าหมาย iSCSI ที่ตรวจพบเป็นรายการแรกสำหรับ OSDN หากมีการระบุและมีการจับคู่แบบตรงกันทุกประการ หมายเหตุ สำหรับเซิร์ฟเวอร์ ThinkServer ค่านี้จะเป็น localdisk เสมอ
		unattendFileId		สตริง	ID ของไฟล์แบบอัตโนมัติที่จะใช้ในการปรับใช้นี้
		uuid		สตริง	UUID ของเซิร์ฟเวอร์โฮสต์ที่จะปรับใช้ระบบปฏิบัติการ
	imageSettings			ออบเจกต์	ข้อมูลเกี่ยวกับอิมเมจ OS และโปรไฟล์อิมเมจแต่ละรายการ
		name		สตริง	ชื่อไฟล์อิมเมจระบบปฏิบัติการ
		โปรไฟล์		สตริง	ชื่อโปรไฟล์อิมเมจ
	otherSettings			ออบเจกต์	การตั้งค่าเพิ่มเติมที่เกี่ยวข้องกับงานการปรับใช้ OS ที่กำลังรันอยู่
		deployDataAndSoftwareLocation		สตริง	พาธของเพย์โหลดซอฟต์แวร์ ไฟล์แบบกำหนดเอง และข้อมูลการปรับใช้ที่ได้รับการแยก (เช่น ใบรับรองและบันทึก)
		installRepoUrl		สตริง	(SLES 15 และใหม่กว่าเท่านั้น) URL สำหรับอิมเมจแพคเกจที่นำเข้า คุณสามารถใช้มาโครแบบกำหนดไว้ล่วงหน้านี้ในไฟล์อัตโนมัติแบบกำหนดเองสำหรับ media_url ในส่วน Add-on ตัวอย่างเช่น: `<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		สตริง	ID ของงานการปรับใช้ OS ที่กำลังรันอยู่
		ntpServer		สตริง	เซิร์ฟเวอร์ NTP ที่เกี่ยวข้องกับ XClarity Administrator
		statusSettings		ออบเจกต์	การตั้งค่าสถานะการปรับใช้ OS
			urlStatus	สตริง	HTTPS URL (รวมถึงพอร์ต) ที่ XClarity Administrator ใช้ในการรายงานสถานะ
			certLocation	สตริง	โฟลเดอร์ที่มีใบรับรองที่จำเป็นสำหรับการเข้าถึงบริการบนเว็บ urlStatus จาก OS ของโฮสต์ในการบูตครั้งแรก
			sdkLocation	สตริง	ตำแหน่งของสคริปต์ตัวช่วยเหลือและอินเทอร์เฟซที่ XClarity Administrator มีให้สำหรับการเข้าถึง XClarity Administrator
		timezone		สตริง	โซนเวลาที่ตั้งค่าให้กับ XClarity Administrator (เช่น America/New_York)
	unattendSettings			ออบเจกต์	การตั้งค่าที่ใช้ใส่ข้อมูลไฟล์แบบอัตโนมัติ ค่าเหล่านี้จะแตกต่างกันไปตามเวอร์ชันของ XClarity Administrator
		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 จะไม่รายงานสถานะการติดตั้ง OS เสร็จสมบูรณ์ (17) โปรไฟล์แบบกำหนดเองต้องรายงานสถานะเสร็จสมบูรณ์
		storageConfig		สตริง	(ESXi และ RHEL เท่านั้น) เนื้อหาที่กำหนดไว้ล่วงหน้าของ XClarity Administrator สำหรับใช้ขณะติดตั้งแบบอัตโนมัติ การกำหนดค่าในการตั้งค่าที่จัดเก็บสำหรับระบบปฏิบัติการ

ส่งคำติชม