เข้าสู่ระบบนัดหมายรับฟังข้อมูลสรุป (or นัดหมายพูดคุยกับทีมงาน)

บทที่ 2.7

การติดตั้งรุ่น Enterprise และการเปิดใช้ใบอนุญาต

สิ่งที่เปลี่ยนแปลงเมื่อคุณติดตั้งรุ่น Enterprise วิธีขอใบอนุญาตจากบัญชี Adverant ของคุณ สามวิธีในการนำเข้าใบอนุญาตพร้อมรหัสการปฏิเสธทั้งหมด และวิธีที่ Harrow Port Authority ย้ายระบบนำร่องรุ่น Community ไปเป็นรุ่น Enterprise ในที่เดิมโดยไม่สูญเสียข้อมูลใดๆ

หน้านี้แปลโดย AI จากต้นฉบับภาษาอังกฤษ หากมีส่วนใดไม่ชัดเจน โปรดอ้างอิงจากหน้าภาษาอังกฤษ อ่านหน้านี้เป็นภาษาอังกฤษ

ใช้เวลาอ่าน 17 นาที

การติดตั้งรุ่น Enterprise ประกอบด้วยสองส่วน ซึ่งมาจากคนละช่องทาง อิมเมจสำหรับรุ่น Enterprise จะมาพร้อมกับชาร์ตของรุ่น Enterprise ซึ่งดึงข้อมูลด้วยโทเค็นสำหรับดึงข้อมูล (pull token) ส่วนใบอนุญาตใช้งานจะมาในรูปแบบไฟล์ที่ลงนามแล้วจากบัญชี Adverant ของคุณ และคุณต้องนำเข้าสู่ระบบที่กำลังทำงานอยู่ ทั้งสองส่วนนี้ไม่สามารถทำงานแยกกันได้: อิมเมจที่ไม่มีใบอนุญาตใช้งานจะทำงานในระดับพื้นฐานของรุ่น Community และใบอนุญาตใช้งานที่ไม่มีอิมเมจของรุ่น Enterprise ก็จะไม่มีฟีเจอร์ใดๆ ให้เปิดใช้งาน

ที่ Harrow Port Authority เราดำเนินการตามลำดับดังกล่าว หกสัปดาห์หลังจากการนำร่องรุ่น Community ในบทที่ 2.6 การติดตั้งรุ่น Community บน Kubernetes การอัปเกรดเป็นชาร์ตของรุ่น Enterprise ใช้เวลาหนึ่งรอบการบำรุงรักษา ส่วนการนำเข้าใบอนุญาตใช้งานใช้เวลาสองนาที บทนี้ครอบคลุมทั้งสองส่วน โดยเริ่มจากการติดตั้งใหม่ทั้งหมด และจบด้วยการย้ายระบบรุ่น Community ที่มีอยู่เดิมในที่เดิม

เส้นทางคู่ขนานสองเส้นที่มุ่งเข้าสู่กล่องเดียวกันทางด้านขวาซึ่งมีป้ายกำกับว่า "การติดตั้งรุ่น Enterprise" เส้นทางด้านบน: "บัญชี Adverant: Downloads" นำไปสู่ "ชาร์ตรุ่น Enterprise และไฟล์ล็อกอิมเมจ" จากนั้นไปที่ "helm install หรือ helm upgrade, edition: enterprise" โดยมีกล่องด้านข้าง "โทเค็นสำหรับดึงข้อมูลบนทุกโหนด" เชื่อมต่ออยู่ เส้นทางด้านล่าง: "บัญชี Adverant: Deployments" นำไปสู่ "ไฟล์ใบอนุญาตใช้งานที่ลงนามแล้ว" จากนั้นไปที่ "นำเข้าสู่ระบบที่กำลังทำงานอยู่" ทั้งสองเส้นทางมาบรรจบกันที่กล่องด้านขวา ใต้กล่องมีคำบรรยายเขียนว่า "อิมเมจที่ไม่มีใบอนุญาตใช้งานจะทำงานในระดับพื้นฐานของรุ่น Community"
สองส่วนของการติดตั้งรุ่น Enterprise และที่มาของแต่ละส่วน

สิ่งที่แตกต่างจากรุ่น Community

ค่าสองค่า และชาร์ตที่อ่านค่าเหล่านั้น

# harrow-values.yaml (Helm values, Enterprise: only these two keys change)
edition: enterprise
enterprise:
  enabled: true

ส่วนอื่นๆ ทั้งหมดในไฟล์ values จะคงเดิมทุกประการ โดยเฉพาะอย่างยิ่งชื่อการติดตั้งและผู้ดูแลระบบ (custodians) คีย์ทั้งสองจะต้องสอดคล้องกัน และชาร์ตจะปฏิเสธ edition: enterprise ร่วมกับ enterprise.enabled: false หรือในทางกลับกัน

นอกจากนี้ รุ่น (edition) จะต้องสอดคล้องกับไฟล์ล็อกอิมเมจของชาร์ตด้วย แพ็กเกจชาร์ตแต่ละรายการจะมีไฟล์ล็อกสำหรับรุ่นเดียว และไฟล์ล็อกของรุ่น Enterprise จะแสดงรายการอิมเมจของรุ่น Community รวมกับบิลด์ของรุ่น Enterprise หากชี้ไฟล์ values ของรุ่น Enterprise ไปที่ชาร์ตของรุ่น Community การเรนเดอร์จะหยุดทำงานพร้อมแสดง files/images.lock.json is the community lock; this install is edition enterprise ดังนั้น การติดตั้งรุ่น Enterprise จึงต้องใช้ชาร์ตของรุ่น Enterprise

ชาร์ตและบันเดิลของรุ่น Enterprise อยู่ในหน้า Downloads ของบัญชี Adverant ของคุณ ซึ่งจะสอดคล้องกับใบอนุญาตใช้งานของคุณ ไฟล์ชาร์ตมีชื่อเดียวกับของรุ่น Community คือ nexus-1.0.0-alpha.1.tgz ดังนั้นควรแยกเก็บทั้งสองไฟล์ไว้ในคนละโฟลเดอร์ ให้ตรวจสอบไฟล์ตามที่บทที่ 2.4 การรับและการตรวจสอบรีลีส ได้อธิบายไว้ทุกประการ โดยเทียบกับคีย์ของรีลีสที่คุณได้ตรวจสอบลายนิ้วมือ (fingerprint) แล้ว:

nexusctl verify enterprise/nexus-1.0.0-alpha.1.tgz
tar -xzf enterprise/nexus-1.0.0-alpha.1.tgz -C enterprise
jq -r '.version, .edition' enterprise/nexus/files/images.lock.json
1.0.0-alpha.1
enterprise

จากนั้น ให้รันลูปตรวจสอบลายเซ็นจากบทที่ 2.4 การรับและการตรวจสอบรีลีส บน enterprise/nexus/files/images.lock.json ขั้นตอนนี้จะครอบคลุมทั้งอิมเมจของรุ่น Enterprise และอิมเมจที่ใช้ร่วมกัน

โทเค็นสำหรับดึงข้อมูล (Pull token)

อิมเมจของรุ่น Community เป็นสาธารณะ แต่อิมเมจของรุ่น Enterprise ต้องใช้โทเค็นสำหรับดึงข้อมูลจากหน้า Pull tokens and install commands ในบัญชีของคุณ ซึ่งกำหนดค่าไว้สำหรับคอนเทนเนอร์รันไทม์ของโหนดตามที่แสดงในบทที่ 2.4 การรับและการตรวจสอบรีลีส ขั้นตอนที่ 3 สำหรับ k3s ค่าดังกล่าวคือรายการ configs สำหรับ registry.adverant.ai ใน /etc/rancher/k3s/registries.yaml บนทุกโหนด

สร้างโทเค็นหนึ่งรายการต่อหนึ่งคลัสเตอร์ และกำหนดวันหมดอายุที่คุณจะสังเกตเห็นได้ เมื่อโทเค็นหมดอายุ พอดที่กำลังทำงานอยู่จะทำงานต่อไปได้ แต่พอดที่ถูกจัดตารางงานใหม่ไปยังโหนดที่ยังไม่มีอิมเมจดังกล่าวจะไม่สามารถดึงอิมเมจได้ เราได้ระบุวันหมดอายุของโทเค็นไว้ในปฏิทินเดียวกันกับวันหมดอายุของใบรับรอง

การติดตั้งรุ่น Enterprise ใหม่ทั้งหมด

หากคุณกำลังติดตั้งรุ่น Enterprise ตั้งแต่เริ่มต้น ให้ปฏิบัติตามบทที่ 2.6 การติดตั้งรุ่น Community บน Kubernetes ทีละขั้นตอน โดยมีข้อแตกต่างสามประการดังนี้:

  1. ใส่โทเค็นสำหรับดึงข้อมูลบนทุกโหนดก่อนขั้นตอนที่ 6

  2. ใช้ค่าของรุ่น Enterprise (คีย์สองตัวด้านบน) ในขั้นตอนที่ 4

  3. ในขั้นตอนที่ 6 ให้ติดตั้งจากไฟล์ชาร์ตของรุ่น Enterprise ที่คุณดาวน์โหลดมา:

    helm install nexus enterprise/nexus-1.0.0-alpha.1.tgz \
      --namespace nexus -f harrow-values.yaml --timeout 45m

ทุกขั้นตอนหลังจากคำสั่งติดตั้งจะเหมือนกับในบทที่ 2.6 การติดตั้งรุ่น Community บน Kubernetes รวมถึงกฎเกี่ยวกับ --wait: ห้ามใช้คำสั่งนี้ หากคุณติดตั้งด้วย nexusctl แทน ให้เพิ่ม --edition enterprise ลงในคำสั่ง:

nexusctl install --context harrow-prod --values harrow-values.yaml --edition enterprise

เมื่อเวิร์กโหลดทุกรายการพร้อมทำงานแล้ว ให้ดำเนินการรันครั้งแรกตามบทที่ 2.12 การรันครั้งแรก ใบอนุญาตใช้งานเป็นหนึ่งในหกสิ่งที่คอนโซลแสดงรายการไว้ก่อนที่ใครจะลงชื่อเข้าใช้ จนกว่าจะมีการนำเข้าใบอนุญาต ระบบที่ติดตั้งจะทำงานในระดับพื้นฐานของรุ่น Community และพื้นที่ใช้งานของรุ่น Enterprise ทุกส่วนจะแสดงเป็นสีเทาพร้อมสัญลักษณ์รูปกุญแจล็อก

การขอใบอนุญาต

ใบอนุญาตใช้งานจาก Adverant จะออกให้กับข้อมูลประจำตัวของการติดตั้งหนึ่งรายการ ซึ่งเป็นข้อมูลที่ที่เก็บคีย์สร้างขึ้นภายใต้ keys.installationName ณ เวลาที่ติดตั้ง ดังนั้น บัญชีจึงต้องทราบว่าคุณหมายถึงการติดตั้งรายการใดก่อนที่จะสามารถออกใบอนุญาตให้ได้

  1. ลงชื่อเข้าใช้บัญชี Adverant ของคุณที่ https://account.adverant.ai
  2. ในระบบที่ติดตั้ง ให้เปิด This installation จากนั้นเลือก Licence หน้าจอจะแสดงรหัสแบบใช้ครั้งเดียวและลายนิ้วมือของการติดตั้ง
  3. ในบัญชีของคุณ ให้เปิด Claim a deployment แล้วป้อนรหัสดังกล่าว จากนั้นเปรียบเทียบลายนิ้วมือที่บัญชีได้รับกับลายนิ้วมือที่ระบบที่ติดตั้งแสดงขึ้น ทีละกลุ่ม โดยทุกกลุ่มจะต้องตรงกัน
  4. กดปุ่มอ้างสิทธิ์ (claim) การติดตั้งดังกล่าวจะเข้าร่วมในส่วน Deployments ของบัญชีคุณ พร้อมแสดงเวอร์ชันและสถานะใบอนุญาตใช้งาน
  5. Adverant จะออกใบอนุญาตใช้งานสำหรับการติดตั้งนั้น ให้ดาวน์โหลดไฟล์จากบัญชีของคุณ ซึ่งไฟล์จะถูกตั้งชื่อตามรหัสใบอนุญาตใช้งาน คือ <licence-id>.json

รหัสอ้างสิทธิ์สามารถใช้ได้เพียงครั้งเดียวและภายในระยะเวลาสั้นๆ หากหมดเวลา บัญชีจะปฏิเสธรหัสพร้อมแสดง CLAIM_CODE_EXPIRED และระบบที่ติดตั้งจะแสดงรหัสใหม่ขึ้นมา

การอ้างสิทธิ์ดีพลอยเมนต์
การอ้างสิทธิ์ดีพลอยเมนต์
การอ้างสิทธิ์ดีพลอยเมนต์ในบัญชี Adverant เริ่มจากการป้อนรหัสแบบใช้ครั้งเดียวก่อน จากนั้นจึงเปรียบเทียบลายนิ้วมือเป็นกลุ่ม กลุ่มละสี่ตัวอักษร เพื่อไม่ให้มีใครสามารถอ้างสิทธิ์การติดตั้งที่ตนไม่ได้ยืนอยู่หน้าเครื่องได้

มีอีกสองช่องทางที่สามารถทำได้ ซึ่งบทที่ 2.13 ใบอนุญาตใช้งาน ได้อธิบายทั้งสองช่องทางไว้อย่างครบถ้วน อุปกรณ์สำเร็จรูป (appliances) และชุดอุปกรณ์เอดจ์ (edge kits) ไม่มีหน้าจอสำหรับแสดงรหัส จึงต้องอ้างสิทธิ์ด้วยคีย์อ้างสิทธิ์ที่พิมพ์อยู่บนกล่อง โดยพิมพ์ลงในหน้า Enter a claim key หรืออ่านจากไฟล์คำสั่งซื้อของผู้ผลิต ส่วนการติดตั้งที่ไม่มีช่องทางเชื่อมต่อออกภายนอกจะใช้การแลกเปลี่ยนแบบออฟไลน์ (Offline exchange): ระบบจะสร้างไฟล์คำขอใบอนุญาตใช้งานที่ลงนามแล้ว คุณนำไฟล์นั้นไปยังบัญชีของคุณ และนำไฟล์ใบอนุญาตใช้งานกลับมา ระบบจะสร้างรายงานการใช้งานที่ลงนามแล้วด้วยวิธีเดียวกันนี้ปีละครั้ง ทุกไฟล์ในการแลกเปลี่ยนจะถูกลงนาม ดังนั้นไฟล์ที่ถูกแก้ไขระหว่างทางจะถูกปฏิเสธ พร้อมแสดง LICENCE_REQUEST_SIGNATURE_INVALID สำหรับไฟล์คำขอ และ USAGE_FILE_SIGNATURE_INVALID สำหรับไฟล์รายงานการใช้งาน

การแลกเปลี่ยนแบบออฟไลน์
การแลกเปลี่ยนแบบออฟไลน์
การแลกเปลี่ยนแบบออฟไลน์ในบัญชี Adverant ไฟล์ที่ลงนามแล้วจะถูกนำไปด้วยตนเองทั้งขาไปและขากลับ และไฟล์ที่ถูกแก้ไขระหว่างทางจะถูกปฏิเสธโดยระบุชื่อ

ข้อมูลที่อยู่ในไฟล์ใบอนุญาตใช้งาน

ใบอนุญาตใช้งานเป็นเอกสาร JSON ในรูปแบบ nexus-licence/v1 ที่ลงนามสองครั้งโดย Adverant ด้วยคีย์สองชุดที่เป็นอิสระต่อกัน คุณไม่จำเป็นต้องอ่านไฟล์นี้ แต่การทราบว่ามีข้อมูลใดอยู่ในนั้นบ้างจะช่วยได้เมื่อมีคนถามว่าคุณได้ซื้ออะไรมา

ฟิลด์ ความหมายของข้อมูล
licence_id รหัสของใบอนุญาตใช้งานเอง ซึ่งเป็น UUID (ตัวระบุที่ไม่ซ้ำกันในระดับสากล) ตัวพิมพ์เล็ก
type alpha, evaluation หรือ commercial
licensee ชื่อองค์กรและรหัสลูกค้า Adverant
scope การติดตั้งที่ใบอนุญาตนี้ระบุถึง และองค์กรใดๆ ที่ระบุไว้ในการให้สิทธิ์
edition enterprise
grants กลุ่มฟีเจอร์ที่ปลดล็อก โดยแต่ละกลุ่มอาจมีผลกับทั้งการติดตั้งหรือเฉพาะองค์กรที่ระบุชื่อ
add_ons และ domain_packs ความสามารถที่ได้รับอนุญาตแยกต่างหาก ซึ่งแพ็กเกจ Logistics and maritime เป็นหนึ่งในนั้น
metric วิธีการนับจำนวนใบอนุญาตใช้งาน เช่น named-seat, per-core หรือ per-environment และจำนวนที่ได้รับ
term starts_on, ends_on รวมถึงจำนวนวันของการแจ้งเตือนและระยะเวลาผ่อนผัน
matrix เวอร์ชันของตารางเปรียบเทียบรุ่น (edition matrix) ที่ใช้เป็นเกณฑ์ในการเขียนใบอนุญาตนี้
signatures ลายเซ็นทั้งสองของ Adverant

ใบอนุญาตใช้งานเพื่อการประเมินผลจะมีอายุสูงสุด 30 วัน สำหรับผู้ใช้งานที่ระบุชื่อสูงสุดห้าคน โดยไม่มีระยะเวลาผ่อนผัน ส่วนใบอนุญาตใช้งานเชิงพาณิชย์จะแจ้งเตือนล่วงหน้า 30 วันก่อนหมดอายุ และให้ระยะเวลาผ่อนผัน 30 วันเป็นค่าเริ่มต้น สิ่งที่จะเกิดขึ้นในแต่ละขั้นของลำดับขั้นดังกล่าวอธิบายไว้ในบทที่ 2.13 ใบอนุญาตใช้งาน

ลายเซ็นจะครอบคลุมเอกสารตามรูปแบบที่ Adverant สร้างขึ้น ให้ส่งไฟล์ตามที่คุณได้รับมาทุกประการ อย่าเปิดไฟล์ในโปรแกรมแก้ไขข้อความที่อาจจัดรูปแบบไฟล์ใหม่

การนำเข้าใบอนุญาต

เฉพาะผู้ดูแลระบบการติดตั้งเท่านั้นที่สามารถนำเข้าใบอนุญาตใช้งานได้ ซึ่งได้แก่ เจ้าของหรือผู้ดูแลระบบขององค์กรทั้งหมดที่เป็นเจ้าของการติดตั้งนั้น ในขณะที่ลงชื่อเข้าใช้ระบบอยู่ ผู้ดูแลแพลตฟอร์มที่มีสิทธิ์เต็มรูปแบบก็สามารถนำเข้าได้เช่นกัน ใบอนุญาตใช้งานจะไม่เป็นค่าในชาร์ตหรือไฟล์ที่เมาท์เข้าไปในพอดโดยเด็ดขาด แต่จะถูกส่งไปยังบริการลงชื่อเข้าใช้ nexus-auth ซึ่งจะตรวจสอบไฟล์แบบออฟไลน์เทียบกับรูทความน่าเชื่อถือ (trust roots) ที่ฝังอยู่ในอิมเมจของตัวเอง และบันทึกข้อมูลภายในทรานแซกชันเดียว คุณสามารถนำเข้าได้สามวิธี ซึ่งทั้งหมดจะไปสิ้นสุดที่เดียวกัน

ในคอนโซล

ในระหว่างการรันครั้งแรก ให้เปิด Six things before anyone signs in จากนั้นเลือก Licence หน้า Import the licence จะรับไฟล์ใบอนุญาต: คุณสามารถลากไฟล์มาวางบนหน้าเว็บ หรือเลือกไฟล์ก็ได้ หน้าเว็บจะตรวจสอบไฟล์แบบออฟไลน์บนตัวระบบที่ติดตั้งเอง จากนั้นจะแสดงรายการกลุ่มฟีเจอร์ที่เปิดใช้งาน พร้อมระบุว่าแต่ละกลุ่มได้รับการปกป้องอย่างไรและใช้ได้ถึงเมื่อใด กลุ่มฟีเจอร์ที่ไม่ได้รวมอยู่ในใบอนุญาตใช้งานจะยังคงแสดงอยู่ในรายการแต่เป็นสีเทา

ในภายหลัง การนำเข้าแบบเดียวกันนี้คือปุ่ม Import a new licence บนหน้าใบอนุญาตใช้งานของการติดตั้ง เมื่อใบอนุญาตใช้งานหมดอายุ หน้าใบอนุญาตใช้งานที่ถูกจำกัดสิทธิ์จะแสดงปุ่ม Import a renewed licence

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

ด้วย nexusctl

nexusctl licence import <licence-id>.json

nexusctl จะส่งไฟล์โดยไม่เปลี่ยนแปลงแก้ไขไปยังช่องทางนำเข้าของการติดตั้งในฐานะผู้ดูแลระบบการติดตั้ง และรายงานสถานะของใบอนุญาตใช้งานหรือรหัสการปฏิเสธจากตารางด้านล่าง

ผ่าน API

ช่องทางนำเข้าเป็นส่วนหนึ่งของส่วนต่อประสานโปรแกรมประยุกต์ (API) ของบริการลงชื่อเข้าใช้ บนที่อยู่ hosts.auth ของคุณ เนื้อหา (body) คือเอกสารใบอนุญาตใช้งานแบบไบต์ต่อไบต์:

curl -sS -X POST https://auth.harrow.example/api/v1/installation/licence \
  -H "authorization: Bearer <admin-token>" \
  -H "content-type: application/json" \
  --data-binary @<licence-id>.json

<admin-token> คือโทเค็นการเข้าถึงของผู้ดูแลระบบการติดตั้งที่ลงชื่อเข้าใช้แล้ว ให้ใช้ --data-binary และห้ามใช้ -d โดยเด็ดขาด เนื่องจากจะตัดการขึ้นบรรทัดใหม่ออกและทำให้ไบต์ที่คุณส่งเปลี่ยนแปลงไป ช่องทางนี้ไม่รับสตริงคิวรีและไม่รับข้อมูลใดๆ ในเนื้อหานอกจากตัวเอกสาร เนื้อหาที่พยายามระบุชื่อองค์กรหรือบุคคลในระดับบนสุดจะถูกปฏิเสธก่อนที่จะมีการอ่านข้อมูลใดๆ

การนำเข้าที่สำเร็จจะตอบกลับด้วย 201 Created เมื่อตัดทอนส่วนเกินออก เนื้อหาจะมีลักษณะดังนี้:

{
  "licence": {
    "licence_id": "<licence-id>",
    "state": "licensed",
    "edition": "enterprise",
    "licensee": {"name": "Harrow Port Authority", "customer_id": "<customer-id>"},
    "term": {"starts_on": "2026-12-01", "ends_on": "2027-11-30", "warn_days": 30, "grace_days": 30},
    "groups": ["enterprise-base", "..."]
  },
  "organizations": 1,
  "tenants_without_organisation": 0
}

organizations จะนับจำนวนองค์กรในการติดตั้งนี้ที่ถือครองใบอนุญาตใช้งานอยู่ในปัจจุบัน ส่วน tenants_without_organisation จะนับจำนวนองค์กรที่ระบุชื่อไว้ในใบอนุญาตใช้งานแต่ไม่ได้อยู่ในการติดตั้งนี้

เมื่อการนำเข้าถูกปฏิเสธ

การนำเข้าที่ถูกปฏิเสธจะไม่เปลี่ยนแปลงสิ่งใด: ไม่มีการเขียนแถวข้อมูลใหม่ และใบอนุญาตใช้งานที่มีผลบังคับใช้อยู่ (หากมี) จะยังคงเหมือนเดิมทุกประการ บันทึกการตรวจสอบ (audit log) ของการติดตั้งจะบันทึกความพยายามทุกครั้ง รวมถึงครั้งที่ถูกปฏิเสธด้วย

รหัส สถานะ ความหมาย สิ่งที่ต้องทำ
LICENCE_SIGNATURE_INVALID 422 ลายเซ็นหนึ่งในสองรายการของ Adverant หายไปหรือไม่ผ่านการตรวจสอบ ไฟล์ถูกแก้ไขหลังจากการลงนาม ขอไฟล์จาก Adverant อีกครั้ง และห้ามแก้ไขไฟล์
LICENCE_FORMAT_INVALID 422 ไฟล์นี้ไม่ใช่ใบอนุญาตใช้งานที่รีลีสนี้สามารถอ่านได้ ส่งไฟล์ตามที่ Adverant มอบให้ทุกประการ
LICENCE_ROOT_UNKNOWN 422 ไฟล์ถูกลงนามด้วยคีย์ที่การติดตั้งนี้ไม่เชื่อถือ ขอใบอนุญาตใช้งานที่ลงนามสำหรับรูทความน่าเชื่อถือของรีลีสนี้ หรือทำการอัปเกรด
LICENCE_MATRIX_MISMATCH 422 ใบอนุญาตเขียนขึ้นโดยอ้างอิงตารางเปรียบเทียบรุ่นที่รีลีสนี้ไม่อ่าน หรือให้สิทธิ์กลุ่มฟีเจอร์ที่รีลีสนี้ไม่รู้จัก ทำการอัปเกรด หรือขอใบอนุญาตใช้งานที่เขียนขึ้นสำหรับรีลีสนี้
LICENCE_OTHER_INSTALLATION 409 ใบอนุญาตออกให้กับการติดตั้งอื่น ขอใบอนุญาตใช้งานที่ออกให้กับข้อมูลประจำตัวของการติดตั้งนี้
TRANSITION_NOT_PERMITTED 409 ใบอนุญาตใช้งานที่มีรหัสนี้ถูกนำเข้าไปแล้ว ใบอนุญาตแต่ละรายการนำเข้าได้เพียงครั้งเดียว ขอใบอนุญาตใช้งานใหม่จาก Adverant หากจำเป็นต้องเปลี่ยนแปลงเงื่อนไข
LICENCE_REVOKED 403 Adverant ได้เพิกถอนใบอนุญาตใช้งานนี้แล้ว ขอใบอนุญาตใช้งานใหม่จาก Adverant
LICENCE_LOCKED 403 ระยะเวลาของใบอนุญาตใช้งานยังไม่เริ่มต้น จะใช้ระดับพื้นฐานของรุ่น Community ไปจนกว่าจะถึงเวลานั้น นำเข้าอีกครั้งในหรือหลังวันแรกของระยะเวลาใบอนุญาต
RECORD_NOT_FOUND 404 ยังไม่ได้ประกาศการติดตั้ง จึงยังไม่มีข้อมูลประจำตัวให้ใช้ตรวจสอบเปรียบเทียบ ทำขั้นตอนของผู้ดูแลระบบคนแรกให้เสร็จสิ้น (บทที่ 2.12 การรันครั้งแรก) จากนั้นจึงนำเข้า
VALIDATION_FAILED 400 ไม่สามารถอ่านเนื้อหาได้ หรือมีขนาดเกิน 1 MiB หรือมีการส่งสตริงคิวรีมาด้วย ส่งไฟล์เป็นเนื้อหาทั้งหมด โดยไม่มีคิวรี

มีอีกรหัสหนึ่งที่อาจส่งกลับมาเมื่อนำเข้าสำเร็จ โดยเป็นการแจ้งให้ทราบมากกว่าการปฏิเสธ: LICENCE_CLOCK_BEHIND_FLOOR หมายความว่านาฬิกาของการติดตั้งแสดงเวลาเร็วกว่าเวลาล่าสุดที่ระบบเคยพบเห็น ดังนั้นใบอนุญาตใช้งานจะถูกอ่านตามเวลาที่ช้ากว่านั้น การตั้งเวลานาฬิกาย้อนหลังจะไม่มีทางทำให้ใบอนุญาตใช้งานที่หมดอายุแล้วกลับมาใช้ได้อีก มีเพียงโทเค็นรีเซ็ตเวลาที่ Adverant ลงนามให้กับการติดตั้งเท่านั้นที่จะช่วยลดเวลาอ้างอิงขั้นต่ำลงได้

การย้ายรุ่น Community ไปเป็นรุ่น Enterprise ในที่เดิม

นี่คือสิ่งที่เราทำที่ Harrow ไม่มีการติดตั้งสิ่งใดใหม่และไม่มีการย้ายข้อมูลใดๆ: มันคือการติดตั้งเดิม ที่มีข้อมูลประจำตัวเดิมและข้อมูลเดิม เพียงแต่เปิดใช้งานฟีเจอร์ต่างๆ เพิ่มขึ้น ชื่อการติดตั้งและผู้ดูแลระบบจะคงเดิมทุกประการ ในการอัปเกรด ฮุกการดูแลระบบ (custody hook) จะตรวจสอบว่าที่เก็บคีย์ได้รับการเริ่มต้นทำงานแล้ว และจะไม่ทำอะไรอื่นอีก

  1. ใส่โทเค็นสำหรับดึงข้อมูลบนทุกโหนด และรีสตาร์ทคอนเทนเนอร์รันไทม์บนโหนดเหล่านั้น

  2. ดึงชาร์ตของรุ่น Enterprise จากหน้า Downloads แล้วตรวจสอบชาร์ตและอิมเมจตามขั้นตอนด้านบน

  3. เปลี่ยนค่าสองค่าในไฟล์ values ที่มีอยู่เดิมของคุณ: edition: enterprise และ enterprise.enabled: true อย่าเปลี่ยนสิ่งอื่นใด

  4. รันการตรวจสอบล่วงหน้า (preflight) ด้วยไฟล์ใหม่

    nexusctl preflight --context harrow-prod --values harrow-values.yaml
  5. อัปเกรดรีลีสเป็นชาร์ตของรุ่น Enterprise โดยไม่ใช้ --wait เช่นเดิม

    helm upgrade nexus enterprise/nexus-1.0.0-alpha.1.tgz \
      --namespace nexus -f harrow-values.yaml --timeout 45m

    ในการอัปเกรด ฮุกจะทำงานก่อนที่พอดใหม่จะเริ่มหมุนเวียนเปลี่ยน และแต่ละการไมเกรชันจะใช้เฉพาะไฟล์ที่ยังไม่เคยใช้มาก่อน ข้อมูลความลับ (secrets) ที่สร้างขึ้นจะถูกอ่านกลับมาจากระบบที่ติดตั้งและเก็บรักษาไว้ Helm จะจบการทำงานด้วย:

    NAME: nexus
    NAMESPACE: nexus
    STATUS: deployed
    REVISION: 2
  6. รอให้เวิร์กโหลดพร้อมทำงาน เหมือนกับในบทที่ 2.6 การติดตั้งรุ่น Community บน Kubernetes ขั้นตอนที่ 7 ทุกประการ

    kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
  7. นำเข้าใบอนุญาตใช้งาน ด้วยวิธีใดวิธีหนึ่งจากสามวิธีข้างต้น

  8. ในคอนโซล ให้เปิด This installation จากนั้นเลือก Licence แล้วเลือก Move to Enterprise หน้าเว็บจะอ่านใบอนุญาตใช้งานและแสดงสิ่งที่จะถูกดึงมาและสิ่งที่จะเปลี่ยนแปลงก่อนที่จะมีอะไรเกิดขึ้น นอกจากนี้ยังนับจำนวนบุคลากรและเนื้อหาขององค์กร และทำเครื่องหมายแต่ละรายการว่าเก็บรักษาไว้ กดปุ่ม Fetch and switch on แต่ละส่วนจะถูกตรวจสอบเทียบกับคีย์รีลีสของ Adverant ก่อนนำไปใช้งาน และกลุ่มฟีเจอร์ต่างๆ จะทยอยเปิดใช้งานทีละกลุ่ม

รอบการบำรุงรักษาของเรามีเวลาหนึ่งชั่วโมง แต่การทำงานจริงใช้เวลาประมาณยี่สิบนาที ซึ่งส่วนใหญ่เป็นการรอสคีมาในขณะที่ฮุกทำงาน บุคลากรในกลุ่มนำร่องได้ลงชื่อเข้าใช้ในเช้าวันถัดไปยังพื้นที่ทำงานเดิม โดยที่พื้นที่ใช้งานของรุ่น Enterprise ในเมนูไม่ได้เป็นสีเทาอีกต่อไป

จาก Community สู่ Enterprise
จาก Community สู่ Enterprise
การย้ายการติดตั้งรุ่น Community ไปเป็นรุ่น Enterprise หน้าเว็บจะยืนยันว่าใบอนุญาตใช้งานเป็นของแท้ และแสดงรายการสิ่งที่จะดึงมาก่อนที่จะทำการดึงข้อมูลจริง บุคลากรและไฟล์ขององค์กรจะถูกทำเครื่องหมายว่าเก็บรักษาไว้

หลังจากการนำเข้า

หน้าใบอนุญาตใช้งานภายใต้ This installation จะแสดงรายการกลุ่มฟีเจอร์ทุกกลุ่มในใบอนุญาตพร้อมจำนวนที่นั่งและระยะเวลา นอกจากนี้ยังระบุว่าแต่ละส่วนถูกส่งมอบอย่างไร เช่น คอมไพล์และให้สิทธิ์ใช้งานสำหรับกลุ่มของรุ่น Enterprise หรือเป็นโอเพนซอร์สสำหรับระดับพื้นฐานของรุ่น Community กลุ่มฟีเจอร์ที่อยู่นอกเหนือใบอนุญาตใช้งานจะยังคงแสดงอยู่ในรายการแต่เป็นสีเทา ผู้ดูแลระบบสามารถจำกัดขอบเขตที่กลุ่มฟีเจอร์เข้าถึงได้ภายในองค์กร แต่ไม่มีใครนอกจาก Adverant ที่สามารถขยายขอบเขตสิ่งที่ใบอนุญาตใช้งานมอบให้ได้

สถานะของใบอนุญาตใช้งานจะถูกคำนวณใหม่จากเอกสารและวันที่ทุกครั้งที่มีการอ่านข้อมูล ดังนั้นการหมดอายุจึงเกิดขึ้นได้โดยไม่ต้องมีงานที่จัดตารางเวลาไว้ ทุกคนในระบบที่ติดตั้งจะเห็นประกาศแจ้งเตือนเดียวกันในคอนโซลเมื่อใกล้ถึงวันสิ้นสุด: LICENCE_ENDS_SOON ตั้งแต่วันที่ 30 ก่อนวันสิ้นสุด จากนั้นจะเปลี่ยนเป็น LICENCE_IN_GRACE ในระหว่างระยะเวลาผ่อนผัน สมาชิกจะเห็นประกาศแจ้งเตือนและวันที่ แต่มีเพียงผู้ดูแลระบบการติดตั้งเท่านั้นที่จะเห็นตัวใบอนุญาตใช้งาน บทที่ 2.13 ใบอนุญาตใช้งาน จะครอบคลุมเรื่องการต่ออายุและลำดับขั้นของการหมดอายุ

ใบอนุญาตและสิ่งที่ปลดล็อก
ใบอนุญาตและสิ่งที่ปลดล็อก
นี่คือหน้าใบอนุญาตใช้งานของการติดตั้งรุ่น Enterprise ตัวเลขด้านบนสุดแสดงจำนวนที่นั่งและระยะเวลา ด้านล่างจะแสดงรายการกลุ่มฟีเจอร์ทุกกลุ่มพร้อมวิธีที่ได้รับการปกป้อง และกลุ่มฟีเจอร์ที่อยู่นอกเหนือใบอนุญาตใช้งานจะยังคงเป็นสีเทา

หากขั้นตอนนี้ล้มเหลว

สิ่งที่คุณเห็น สาเหตุ สิ่งที่ต้องทำ
edition=enterprise but enterprise.enabled=false: they must agree มีการเปลี่ยนคีย์เพียงตัวเดียวจากสองตัว เปลี่ยนทั้งสองตัว
files/images.lock.json is the community lock; this install is edition enterprise มีการใช้ชาร์ตของรุ่น Community ใช้ชาร์ตของรุ่น Enterprise จากหน้า Downloads
image ... is a enterprise image; a community install takes only community images ชื่ออิมเมจของรุ่น Enterprise ถูกส่งไปยังการเรนเดอร์ของรุ่น Community ตรวจสอบ edition และโฟลเดอร์ชาร์ต
เกิด ImagePullBackOff กับอิมเมจของรุ่น Enterprise หลังจากการอัปเกรด โหนดไม่มีโทเค็นสำหรับดึงข้อมูล หรือโทเค็นใช้งานไม่ได้แล้ว ตรวจสอบ registries.yaml บนโหนดนั้น หรือสร้างโทเค็นใหม่
รหัสการปฏิเสธใบอนุญาตใช้งาน ดูตารางการปฏิเสธด้านบน ปฏิบัติตามคำแนะนำในแถวนั้น ไม่มีสิ่งใดถูกเปลี่ยนแปลง

เมื่อหน้าใบอนุญาตใช้งานแสดงรุ่น Enterprise และกลุ่มฟีเจอร์ตามที่คุณคาดหวัง แสดงว่าการติดตั้งได้รับอนุญาตใช้งานเรียบร้อยแล้ว จุดถัดไปคือการรันครั้งแรกในบทที่ 2.12 การรันครั้งแรก หากคุณยังไม่ได้อ้างสิทธิ์การติดตั้ง แต่หากคุณอ้างสิทธิ์แล้ว ผู้ช่วยอัจฉริยะยังคงต้องใช้คีย์โมเดลปัญญาประดิษฐ์ (AI) ขององค์กรเองก่อนจึงจะสามารถตอบคำถามใครได้ บทที่ 2.14 ผู้ให้บริการและโมเดล AI จะแสดงวิธีการเชื่อมต่อคีย์เหล่านั้น