หน้านี้ได้รับการแปลโดย Cloud Translation API

อัปเดต Apigee Edge 4.51.00 หรือ 4.52.00 หรือ 4.52.01 เป็น 4.52.02

Apigee รองรับการอัปเกรด Edge สำหรับ Private Cloud จากเวอร์ชัน 4.51.00, 4.52.00 หรือ 4.52.01 เป็นเวอร์ชัน 4.52.02 โดยตรง หน้านี้จะอธิบายวิธีอัปเกรดดังกล่าว

ข้อควรระวัง: Edge for Private Cloud 4.52.02 มีการอัปเกรด Cassandra เป็นเวอร์ชันหลัก โปรดใช้ความระมัดระวังเมื่ออัปเกรด Cassandra เนื่องจากฐานข้อมูลจะจัดเก็บข้อมูลที่สําคัญต่อการทํางานของ Apigee โปรดทดสอบการอัปเกรดนี้อย่างละเอียดในสภาพแวดล้อมที่ต่ำกว่าก่อนที่จะนำไปใช้กับเวอร์ชันที่ใช้งานจริง นอกจากนี้ โปรดทําตามทุกขั้นตอนอย่างถูกต้องเพื่อให้การอัปเกรดเป็นไปอย่างราบรื่น

ข้อควรระวัง: เนื่องจาก Edge for Private Cloud 4.52.02 มีการอัปเกรดที่สำคัญสำหรับเวอร์ชัน Cassandra เราจึงไม่แนะนำให้ทำการอัปเกรดนี้ทีละศูนย์ข้อมูล ขั้นตอนการอัปเกรดที่ระบุไว้ในเอกสารนี้และการยืนยันที่ดำเนินการ (เช่น ไม่ส่งผลกระทบต่อการเข้าชมพร็อกซีรันไทม์) ขึ้นอยู่กับการสมมติว่าทำตามขั้นตอนการอัปเกรดตามที่ระบุไว้ในเอกสาร นั่นคืออัปเกรดคลัสเตอร์ Cassandra ในศูนย์ข้อมูลทั้งหมดก่อน ตามด้วยการอัปเกรดโหนดแอปพลิเคชัน เช่น edge-management-server, edge-message-processor ฯลฯ

ผู้ที่จะอัปเดตได้

บุคคลที่ทำการอัปเดตควรเป็นคนเดียวกับที่ติดตั้ง Edge ไว้ตั้งแต่แรก หรือเป็นบุคคลที่เรียกใช้ในฐานะรูท

หลังจากติดตั้ง RPM ของ Edge แล้ว ทุกคนจะกำหนดค่า RPM ได้

คอมโพเนนต์ที่ต้องอัปเดต

คุณต้องอัปเดตคอมโพเนนต์ Edge ทั้งหมด Edge ไม่รองรับการตั้งค่าที่มีคอมโพเนนต์จากหลายเวอร์ชัน

อัปเดตข้อกําหนดเบื้องต้น

ตรวจสอบว่าคุณมีคุณสมบัติตามข้อกําหนดเบื้องต้นต่อไปนี้ก่อนอัปเกรด Apigee Edge

สํารองข้อมูลโหนดทั้งหมด
ก่อนอัปเดต เราขอแนะนําให้สํารองข้อมูลโหนดทั้งหมดอย่างสมบูรณ์เพื่อความปลอดภัย ใช้ขั้นตอนสำหรับ Edge เวอร์ชันปัจจุบันเพื่อทำการสำรองข้อมูล
ซึ่งจะช่วยให้คุณมีแผนสำรองในกรณีที่การอัปเดตเป็นเวอร์ชันใหม่ไม่ทำงานอย่างถูกต้อง ดูข้อมูลเพิ่มเติมเกี่ยวกับการสำรองข้อมูลได้ที่การสำรองและกู้คืนข้อมูล
ตรวจสอบว่า Edge ทำงานอยู่
ตรวจสอบว่า Edge ทำงานอยู่ในระหว่างกระบวนการอัปเดตโดยใช้คำสั่งต่อไปนี้
```
/opt/apigee/apigee-service/bin/apigee-all status
```
ตรวจสอบว่ากลยุทธ์การบีบอัดข้อมูลของ Cassandra เป็น LeveledCompactionStrategy
ทําการเปลี่ยนแปลงที่จําเป็นกับกลยุทธ์การบีบอัดข้อมูลของ Cassandra โดยขึ้นอยู่กับเวอร์ชันปัจจุบัน ทำตามขั้นตอนด้านล่าง แล้วกลับไปที่ขั้นตอนการอัปเกรดหลัก
- หากคุณจะอัปเกรดจากเวอร์ชัน 4.51.00 โปรดดูเอกสารกลยุทธ์การบีบอัดข้อมูลของ Cassandra สำหรับ v4.51.00
- หากคุณอัปเกรดจากเวอร์ชัน 4.52.00 โปรดดูเอกสารกลยุทธ์การบีบอัด Cassandra สำหรับ v4.52.00
- หากคุณจะอัปเกรดจากเวอร์ชัน 4.52.01 โปรดดูเอกสารกลยุทธ์การบีบอัด Cassandra สำหรับ v4.52.01

ขั้นตอนพิเศษที่ควรพิจารณาสำหรับการอัปเกรด

หากต้องการอัปเกรดเป็น Edge for Private Cloud 4.52.02 ให้ลองทำตามขั้นตอนเฉพาะสำหรับการอัปเกรดซอฟต์แวร์บางรายการ ขั้นตอนที่จำเป็นจะขึ้นอยู่กับเวอร์ชันปัจจุบันของคุณ โปรดดูตารางด้านล่างสำหรับซอฟต์แวร์ต่างๆ ที่ต้องดำเนินการเพิ่มเติม และทําตามวิธีการโดยละเอียดของแต่ละรายการ หลังจากทํางานที่จำเป็นเสร็จแล้ว ให้กลับไปที่ขั้นตอนการอัปเกรดหลักเพื่อดําเนินการอัปเกรดต่อ

เวอร์ชันปัจจุบัน	ซอฟต์แวร์ที่ต้องดำเนินการตามขั้นตอนพิเศษเพื่ออัปเกรดเป็น 4.52.02	ข้อมูลอ้างอิง
4.52.01	Cassandra	เปลี่ยนกลยุทธ์การบีบอัด Cassandra
4.52.00	Cassandra, Zookeeper, Qpid	เปลี่ยนกลยุทธ์การบีบอัด Cassandra
4.51.00	Cassandra, Zookeeper, Qpid, Postgres	เปลี่ยนกลยุทธ์การบีบอัด Cassandra

หลังจากทำตามขั้นตอนที่จำเป็นตามเวอร์ชันแล้ว ให้กลับไปที่ขั้นตอนการอัปเกรดหลักเพื่อดำเนินการต่อ

การนำไปใช้งานการตั้งค่าที่พักโดยอัตโนมัติ

หากคุณตั้งค่าพร็อพเพอร์ตี้โดยการแก้ไขไฟล์ .properties ใน /opt/apigee/customer/application ระบบจะเก็บค่าเหล่านี้ไว้ในการอัปเดต

ต้องอัปเกรดเป็น Cassandra 3.11.16

Apigee Edge สําหรับ Private Cloud 4.52.02 มีการอัปเกรด Cassandra เป็นเวอร์ชัน 3.11.16 Cassandra เป็นคอมโพเนนต์สําคัญของ Apigee และการอัปเกรดนี้ยังรวมถึงการอัปเดตซอฟต์แวร์ไดรเวอร์ในรันไทม์และคอมโพเนนต์การจัดการต่างๆ ที่ใช้ในการค้นหาและเขียนลงใน Cassandra ด้วย

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

หมายเหตุ: Cassandra 3.X ไม่รองรับเครื่องมือ cassandra-cli อีกต่อไปและเครื่องมือดังกล่าวไม่พร้อมให้บริการแก่คุณ

การย้อนกลับระดับสูง

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

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

โปรดดูรายละเอียดเพิ่มเติมที่ส่วนเปลี่ยนกลับการอัปเดต Cassandra 3.11.16

การจัดทำเอกสารประกอบ API ในพอร์ทัลสําหรับนักพัฒนาแอป

พอร์ทัลนักพัฒนาซอฟต์แวร์ Drupal ของ Apigee มีฟีเจอร์ต่างๆ สำหรับการเขียนเอกสารประกอบ API แม้ว่าเราจะแนะนำให้เลิกใช้พอร์ทัลนักพัฒนาซอฟต์แวร์ที่ใช้ Drupal 7 แต่หากคุณยังคงใช้พอร์ทัลดังกล่าวและใช้ประโยชน์จากฟีเจอร์ SmartDocs เอกสาร การใช้ SmartDocs API จะมีผลกับคุณ หากคุณใช้พอร์ทัลนักพัฒนาซอฟต์แวร์เวอร์ชันใหม่ การอัปเกรดนี้จะไม่ส่งผลต่อเอกสารประกอบ API ของคุณ

เมื่อคุณอัปเกรด Apigee เป็นเวอร์ชัน 4.52.02 ระบบจะไม่ย้ายข้อมูลโมเดล API ที่สร้างขึ้นโดยใช้ฟีเจอร์ SmartDocs ของพอร์ทัลนักพัฒนาซอฟต์แวร์ Drupal 7 ไปยังเวอร์ชันใหม่โดยอัตโนมัติ คุณจะต้องส่งออกแต่ละรูปแบบด้วยตนเองโดยใช้พอร์ทัลนักพัฒนาแอปและนําเข้าอีกครั้งหลังจากการอัปเกรดเสร็จสมบูรณ์

คําศัพท์ที่ใช้ในส่วนต่อไปนี้

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

การจัดการ: การจัดการรวมถึงการดูแลระบบ Apigee Edge ซึ่งรวมถึงแต่ไม่จํากัดเพียงการติดตั้งใช้งาน การแก้ไขแอป ผลิตภัณฑ์ เซิร์ฟเวอร์เป้าหมาย คีย์สโตร์ ฯลฯ API การจัดการทั้งหมด (และไคลเอ็นต์ เช่น UI ของ Apigee และพอร์ทัลนักพัฒนาแอป) จะรวมอยู่ในขอบเขตนี้

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

ขั้นตอนที่ 0: สถานะเริ่มต้น

Cassandra ใน Apigee ที่ใช้เวอร์ชัน 2.1.22
คอมโพเนนต์ของ Edge for Private Cloud 4.52.02

เซิร์ฟเวอร์การจัดการที่สื่อสารกับ Cassandra ผ่านโปรโตคอล Thrift เวอร์ชันเก่า
เซิร์ฟเวอร์รันไทม์ (โปรแกรมประมวลผลข้อความและเราเตอร์) ที่สื่อสารกับ Cassandra ผ่านโปรโตคอล Thrift เวอร์ชันเก่า

สถานะรันไทม์ในขั้นตอนนี้	สถานะการจัดการในขั้นตอนนี้
รันไทม์ทํางานได้เต็มรูปแบบ	การจัดการทํางานได้เต็มรูปแบบ

ขั้นตอนที่ 1: เตรียมพร้อมสำหรับการอัปเกรด

ขั้นตอนด้านล่างนี้นอกเหนือจากไฟล์มาตรฐานที่คุณสร้างโดยทั่วไป เช่น ไฟล์การกําหนดค่ามาตรฐานของ Apigee เพื่อเปิดใช้การอัปเกรดคอมโพเนนต์

เปลี่ยน Cassandra ให้ใช้ LeveledCompactionStrategy
สำรองข้อมูล Cassandra โดยใช้ Apigee
ถ่ายภาพหน้าจอ VM ของโหนด Cassandra (หากเป็นไปได้)
สร้างไฟล์การกําหนดค่าการอัปเกรด Cassandra ในโหนด Cassandra แต่ละโหนดที่ /opt/apigee/apigee-cassandra/cass_upgrade.conf โดยมีเนื้อหาดังต่อไปนี้
```
# IP Address of node
HOSTIP=10.0.0.1

# Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_USERNAME=<cassuser>

# Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_PASSWORD=<casspass>

# Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
CASS_PORT=9160

# Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
CASS_CQL_PORT=9042

# Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
# Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
CASS_TMP_DIR=/tmp/cass_upgrade_scripts
    
```
หากสร้างไฟล์ที่ /opt/apigee/apigee-cassandra/cass_upgrade.conf ไม่ได้ ให้สร้างไฟล์ /opt/silent.conf ที่มีเนื้อหาเดียวกันในแต่ละโหนด Cassandra
ข้อควรระวัง: โปรแกรมติดตั้งการอัปเกรดของ Apigee จะค้นหาไฟล์ในตำแหน่งที่ระบุไว้ข้างต้น หากไฟล์ไม่อยู่ในตำแหน่งใดตำแหน่งหนึ่งที่ระบุไว้ข้างต้น การอัปเกรดจะไม่สำเร็จพร้อมแสดงข้อความดังต่อไปนี้
```
could not read env location: '/opt/apigee/apigee-cassandra/cass_upgrade.conf'
file does not exist or cannot be sourced
could not read env location: '/opt/silent.conf'
file does not exist or cannot be sourced
```
ในกรณีนี้ การอัปเกรดจะล้มเหลว แต่บริการ Cassandra ในโหนดมีแนวโน้มที่จะอยู่ในสถานะหยุดทำงาน คุณสามารถเริ่มบริการ Cassandra ได้ตามปกติและลองอัปเกรดอีกครั้งโดยวางไฟล์การกําหนดค่าไว้ในตําแหน่งใดก็ได้ตามที่คาดไว้ นอกจากนี้ หากพบไฟล์แต่การกําหนดค่าที่ระบุไม่ถูกต้อง (เช่น ข้อมูลเข้าสู่ระบบ Cassandra ไม่ถูกต้อง) การอัปเกรดจะล้มเหลวโดยมีข้อผิดพลาดดังต่อไปนี้
```
Error in PREIN scriptlet in rpm package apigee-cassandra-X.XX.XX-X.X.XXXX.noarch
```
ในกรณีนี้ ให้เริ่มบริการ Cassandra ในทำนองเดียวกันหากหยุดทำงานเมื่อการอัปเกรดไม่สำเร็จ แล้วลองอัปเกรดอีกครั้งหลังจากแก้ไขการกําหนดค่าในไฟล์

หากคุณใช้ฟีเจอร์ SmartDocs ของพอร์ทัลนักพัฒนาแอป Apigee Drupal 7 ให้ส่งออกโมเดลแต่ละรายการโดยดาวน์โหลดในรูปแบบ JSON จาก UI ของพอร์ทัลนักพัฒนาแอป คุณจะต้องนำเข้าโมเดลเหล่านี้กลับไปยัง Apigee หลังจากที่อัปเดตเซิร์ฟเวอร์การจัดการแล้ว
ตรวจสอบว่าพอร์ต 9160 และ 9042 เข้าถึงได้จากคอมโพเนนต์ Edge for Private Cloud 4.52.02 ทั้งหมดไปยังโหนด Cassandra หากยังไม่มี ดูข้อมูลเพิ่มเติมได้ที่ข้อกำหนดเกี่ยวกับพอร์ต

ข้อควรระวัง: ขั้นตอนเหล่านี้มีความสำคัญอย่างยิ่งสำหรับการอัปเกรด Cassandra เป็นเวอร์ชัน 3 เพื่อให้มั่นใจว่าข้อมูลจะสูญหายน้อยที่สุดหากจำเป็นต้องมีการย้อนกลับ และเพื่อป้องกันไม่ให้ข้อมูลสูญหายหลังการอัปเกรด เช่น เอกสารประกอบ API ใน SmartDocs คุณต้องทําตามขั้นตอนเหล่านี้อย่างละเอียดและอย่าข้ามขั้นตอนใดขั้นตอนหนึ่ง

ขั้นตอนที่ 2: อัปเกรดโหนด Cassandra ทั้งหมด

อัปเกรดโหนด Cassandra ทั้งหมดในทุกภูมิภาคทีละโหนด เรียกใช้คำสั่งต่อไปนี้ในแต่ละโหนด
```
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
```
เมื่ออัปเดตโหนดแล้ว ให้เรียกใช้คําสั่งต่อไปนี้ในโหนดเพื่อเรียกใช้การตรวจสอบบางอย่างก่อนดําเนินการต่อ
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
```

คำสั่งข้างต้นจะแสดงผลลัพธ์ประมาณนี้

Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified

สถานะรันไทม์ในขั้นตอนนี้	สถานะการจัดการในขั้นตอนนี้
รันไทม์ทํางานได้เต็มรูปแบบ	ฟังก์ชันการจัดการต่อไปนี้จะมีประสิทธิภาพลดลงหลังจากอัปเกรด Cassandra Management API เพื่อสร้างผลิตภัณฑ์ API ที่มีสภาพแวดล้อม Management API เพื่ออัปเดตผลิตภัณฑ์ API ที่มีสภาพแวดล้อม Management API เพื่อลบองค์กร

สถานะรันไทม์ในขั้นตอนนี้

สถานะการจัดการในขั้นตอนนี้

รันไทม์ทํางานได้เต็มรูปแบบ

ฟังก์ชันการจัดการต่อไปนี้จะมีประสิทธิภาพลดลงหลังจากอัปเกรด Cassandra

หมายเหตุ: หากจะอัปเกรดจาก Edge Private Cloud 4.51.00 หรือ 4.52.00 คุณจะต้องทําตามขั้นตอนเพิ่มเติมเพื่ออัปเกรด Zookeeper ด้วย แม้ว่า Zookeeper และ Cassandra จะอยู่ในโหนดเดียวกัน แต่ขอแนะนําให้อัปเกรด Zookeeper และ Cassandra แยกกัน

คุณสามารถใช้คำสั่งต่อไปนี้ในโหนดเพื่ออัปเกรด Zookeeper

/opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile

คุณสามารถใช้คำสั่งต่อไปนี้บนโหนดเพื่ออัปเกรด Cassandra

/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

หากคุณจะอัปเกรดจาก Edge Private Cloud 4.52.01 เป็น 4.52.02 การอัปเกรด Zookeeper เป็นการอัปเกรดเล็กน้อยและสามารถดำเนินการควบคู่ไปกับ Cassandra ได้ หากต้องการอัปเกรดทั้ง Cassandra และ Zookeeper ผ่านคําสั่งเดียวบนโหนดที่ติดตั้งไว้ด้วยกัน ให้ใช้คําสั่งด้านล่าง เราขอแนะนำให้ดำเนินการนี้เฉพาะในกรณีที่คุณใช้ Zookeeper เวอร์ชัน 3.8.3 ใน Private Cloud เวอร์ชัน 4.52.01 อยู่แล้วเท่านั้น

/opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile

ข้อควรระวัง: เมื่ออัปเกรด Cassandra ครั้งใหญ่ เราขอแนะนำให้อัปเกรดคลัสเตอร์ Cassandra ทั้งหมด (ในศูนย์ข้อมูลทั้งหมด) พร้อมกัน การอัปเกรด Cassandra ครั้งใหญ่เกี่ยวข้องกับการเปลี่ยนแปลงสคีมาโดยอัตโนมัติ และสคีมาของคลัสเตอร์ Cassandra จะยังคงไม่สอดคล้องกันจนกว่าจะมีการอัปเกรดทั้งคลัสเตอร์

หากคุณพยายามอัปเกรด edge-management-server ก่อนอัปเกรดคลัสเตอร์ Cassandra ทั้งหมด การอัปเกรด edge-management-server จะดำเนินการไม่สำเร็จ และบริการ edge-management-server จะไม่เริ่มทำงาน

ขั้นตอนที่ 3: อัปเกรดโหนดการจัดการทั้งหมด

อัปเกรดโหนดการจัดการทั้งหมดในทุกภูมิภาคทีละโหนด ดังนี้

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

สถานะรันไทม์	สถานะการจัดการ
รันไทม์ทํางานได้เต็มรูปแบบ	Management API ทำงานได้น้อยลงในกรณีต่อไปนี้ ฟีเจอร์ SmartDocs ของพอร์ทัลนักพัฒนาซอฟต์แวร์ Drupal 7 ไม่แสดงข้อมูล

ขั้นตอนที่ 3ก: [ไม่บังคับ] นําเข้า SmartDocs ที่ส่งออกก่อนหน้านี้

เมื่ออัปเกรดเซิร์ฟเวอร์การจัดการทั้งหมดแล้ว คุณจะนําเข้าโมเดล SmartDocs ที่ส่งออกในขั้นตอนที่ 1 ได้ หรือจะดำเนินการในภายหลังก็ได้

สถานะรันไทม์	สถานะการจัดการ
รันไทม์ทํางานได้เต็มรูปแบบ	การจัดการทํางานได้เต็มรูปแบบ

ขั้นตอนที่ 4: อัปเกรดโหนดรันไทม์ทั้งหมด

อัปเกรดเราเตอร์และโหนดโปรแกรมประมวลผลข้อความทั้งหมดในทุกภูมิภาคทีละรายการ ดังนี้

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

สถานะรันไทม์	สถานะการจัดการ
รันไทม์ทํางานได้เต็มรูปแบบ	การจัดการทํางานได้เต็มรูปแบบ

ขั้นตอนที่ 5: อัปเกรดคอมโพเนนต์ Edge for Private Cloud 4.52.02 ที่เหลือทั้งหมด

อัปเกรดโหนด edge-qpid-server และ edge-postgres-server ที่เหลือทั้งหมดในทุกภูมิภาคทีละโหนด

ในขั้นตอนนี้ หากคุณอัปเกรดจากเวอร์ชันที่เก่ากว่า Edge for Private Cloud 4.52.01 และทำตามขั้นตอนเพิ่มเติมสำหรับการอัปเกรด Qpid หรือ Postgres ให้ทำตามขั้นตอนที่เกี่ยวข้องเพื่ออัปเกรด

สถานะรันไทม์	สถานะการจัดการ
รันไทม์ทํางานได้เต็มรูปแบบ	การจัดการทํางานได้เต็มรูปแบบ

ขั้นตอนที่ 6: ขั้นตอนหลังการอัปเกรด

เรียกใช้คําสั่งต่อไปนี้บนโหนด Cassandra แต่ละโหนดทีละรายการหลังจากการอัปเกรดเสร็จสมบูรณ์

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

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

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

ทําตามขั้นตอนที่ 3ก หากยังไม่ได้ทํา

สถานะรันไทม์	สถานะการจัดการ
รันไทม์ทํางานได้เต็มรูปแบบ	การจัดการทํางานได้เต็มรูปแบบ

ต้องอัปเกรดเป็น Zookeeper 3.8.3

แม้ว่า Edge for Private Cloud 4.52.02 จะไม่รวมการอัปเกรด Zookeeper ไว้ด้วย แต่หากคุณอัปเกรดจากเวอร์ชันที่เก่ากว่า 4.52.01 คุณต้องทำตามขั้นตอนเพื่ออัปเกรด Zookeeper

หากจะอัปเกรดจาก Edge for Private Cloud เวอร์ชัน 4.51.00 หรือ 4.52.00 โปรดดูขั้นตอนในการอัปเกรดเป็น Zookeeper 3.8.3 ที่จำเป็นเพื่ออัปเกรด Zookeeper
หากจะอัปเกรดจาก Edge for Private Cloud เวอร์ชัน 4.52.01 คุณควรใช้ Zookeeper เวอร์ชัน 3.8.3 อยู่แล้ว และไม่จำเป็นต้องทำตามขั้นตอนพิเศษใดๆ ในการอัปเกรด Zookeeper

ต้องอัปเกรดเป็น Postgres 14

หากจะอัปเกรดจาก Edge for Private Cloud 4.51.00 เป็น 4.52.02 คุณต้องทําตามขั้นตอนเพื่ออัปเกรด Postgres แม้ว่า Edge for Private Cloud 4.52.02 จะไม่รวมการอัปเกรด Postgres ก็ตาม การอัปเกรดจาก Edge for Private Cloud 4.51.00 เป็น 4.52.02 ต้องใช้ขั้นตอนการอัปเกรด Postgres เพิ่มเติม โปรดดูส่วนการอัปเกรดเป็น Postgres 14 ที่จำเป็น
หากจะอัปเกรดจาก Edge for Private Cloud 4.52.00 หรือ 4.52.01 เป็น 4.52.02 คุณไม่จําเป็นต้องทําตามขั้นตอนการอัปเกรด Postgres เพิ่มเติม

ต้องอัปเกรดเป็น Qpid J-Broker

แม้ว่า Edge for Private Cloud 4.52.02 จะไม่รวมการอัปเกรด QPID ไว้ด้วย แต่หากคุณอัปเกรดจากเวอร์ชันที่เก่ากว่า 4.52.01 คุณต้องทําตามขั้นตอนเพื่ออัปเกรด QPID

หากจะอัปเกรดจาก Edge for Private Cloud 4.51.00 หรือ 4.52.00 เป็น 4.52.02 คุณต้องทำตามขั้นตอนเพิ่มเติมในการอัปเกรด QPID โปรดดูส่วนอัปเกรด Qpid หากคุณจะอัปเกรดจากเวอร์ชัน 4.51.00 หรือ 4.52.00 เป็น 4.52.02
หากคุณจะอัปเกรดจาก Edge for Private Cloud 4.52.01 เป็น 4.52.02 คุณควรใช้ Qpid Broker เวอร์ชันล่าสุดอยู่แล้ว และไม่จำเป็นต้องทำตามขั้นตอนการอัปเกรด QPID เพิ่มเติม

UI ของ Edge เวอร์ชันใหม่

ส่วนนี้จะแสดงข้อควรพิจารณาเกี่ยวกับ UI ของ Edge ดูข้อมูลเพิ่มเติมได้ที่UI ใหม่ของ Edge สำหรับระบบคลาวด์ส่วนตัว

ติดตั้ง UI ของ Edge

หลังจากการติดตั้งครั้งแรกเสร็จสมบูรณ์แล้ว Apigee ขอแนะนำให้คุณติดตั้ง Edge UI ซึ่งเป็นอินเทอร์เฟซผู้ใช้ที่ปรับปรุงแล้วสำหรับนักพัฒนาซอฟต์แวร์และผู้ดูแลระบบของ Apigee Edge สําหรับระบบคลาวด์ส่วนตัว

โปรดทราบว่า UI ของ Edge กำหนดให้คุณปิดใช้การตรวจสอบสิทธิ์พื้นฐานและใช้ IDP เช่น SAML หรือ LDAP

ดูข้อมูลเพิ่มเติมได้ที่ติดตั้ง UI ใหม่ของ Edge

อัปเดต UI ของ Edge

หากต้องการอัปเดตคอมโพเนนต์ UI ของ Edge ให้พิจารณาเวอร์ชันของ Edge สำหรับระบบคลาวด์ส่วนตัวที่คุณอัปเกรดจาก

จาก 4.51.00 เป็น 4.52.00 (ติดตั้ง UI ใหม่ของ Edge ไว้แล้ว): ใช้วิธีการอัปเกรดในส่วนนี้สำหรับคอมโพเนนต์ edge-management-ui

อัปเดตด้วย mTLS ของ Apigee

หากต้องการอัปเดต Apigee mTLS ให้ทําตามขั้นตอนต่อไปนี้

การย้อนกลับการอัปเดต

ในกรณีที่อัปเดตไม่สำเร็จ คุณสามารถลองแก้ไขปัญหา แล้วเรียกใช้ update.sh อีกครั้ง คุณเรียกใช้การอัปเดตได้หลายครั้งและระบบจะอัปเดตต่อจากจุดที่ค้างไว้

หากการอัปเดตล้มเหลวและคุณต้องย้อนกลับไปใช้เวอร์ชันก่อนหน้า โปรดดูวิธีการโดยละเอียดที่หัวข้อเปลี่ยนกลับเป็น 4.52.00

หมายเหตุ: โทโปโลจี แบบรวมทั้งหมด (AIO) และแบบสแตนด์อโลน (2 โฮสต์) ของ Edge ได้รับการออกแบบมาเพื่อเริ่มต้นใช้งานและสร้างต้นแบบสภาพแวดล้อม ไม่ใช่สำหรับการใช้งานจริง ดังนั้นจึงไม่มีขั้นตอนการย้อนกลับสำหรับโทโปโลยี แบบรวมทั้งหมด (AIO) และแบบสแตนด์อโลน (2 โฮสต์) ในกรณีที่การอัปเดตโทโปโลยีเหล่านี้ไม่สำเร็จ และการอัปเดตอีกครั้งไม่สามารถแก้ปัญหาได้ ตัวเลือกที่ง่ายที่สุดคือการติดตั้ง 4.52.02 ใหม่

การบันทึกข้อมูลอัปเดต

โดยค่าเริ่มต้น ยูทิลิตี update.sh จะเขียนข้อมูลบันทึกไปยังตำแหน่งต่อไปนี้

/opt/apigee/var/log/apigee-setup/update.log

หากผู้เรียกใช้ยูทิลิตี update.sh ไม่มีสิทธิ์เข้าถึงไดเรกทอรีดังกล่าว ระบบจะเขียนบันทึกลงในไดเรกทอรี /tmp เป็นไฟล์ชื่อ update_username.log

หากบุคคลดังกล่าวไม่มีสิทธิ์เข้าถึง /tmp ยูทิลิตี update.sh จะใช้งานไม่ได้

การอัปเดตแบบไม่มีช่วงพัก

การอัปเดตแบบไม่มีเวลาหยุดทำงานหรือการอัปเดตแบบต่อเนื่องช่วยให้คุณอัปเดตการติดตั้ง Edge ได้โดยไม่ต้องหยุดให้บริการ Edge

การอัปเดตแบบไม่มีเวลาหยุดทำงานจะเกิดขึ้นได้เฉพาะกับการกำหนดค่าที่มีโหนด 5 โหนดขึ้นไป

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

อัปเดตเครื่องตามลำดับที่ถูกต้องสำหรับการติดตั้งตามที่อธิบายไว้ลําดับการอัปเดตเครื่อง
เมื่อถึงเวลาอัปเดตเราเตอร์ ให้เลือกเราเตอร์เครื่องใดเครื่องหนึ่งและทำให้เข้าถึงไม่ได้ ตามที่อธิบายไว้ในการเปิด/ปิดการเข้าถึงเซิร์ฟเวอร์ (Message Processor/Router)
อัปเดตเราเตอร์ที่เลือกและคอมโพเนนต์ Edge อื่นๆ ทั้งหมดในเครื่องเดียวกับเราเตอร์ การกําหนดค่า Edge ทั้งหมดจะแสดงเราเตอร์และโปรแกรมประมวลผลข้อความในโหนดเดียวกัน
ทำให้เราเตอร์เข้าถึงได้อีกครั้ง
ทำตามขั้นตอนที่ 2 ถึง 4 ซ้ำสำหรับเราเตอร์ที่เหลือ
อัปเดตเครื่องที่เหลือในการติดตั้งต่อ

โปรดดำเนินการต่อไปนี้ก่อนและหลังการอัปเดต

ในโหนดเราเตอร์และตัวประมวลผลข้อความแบบรวม
- ก่อนอัปเดต ให้ทำดังนี้
  1. ทำให้เข้าถึงเราเตอร์ไม่ได้
  2. ทำให้เข้าถึง Message Processor ไม่ได้
- หลังจากอัปเดตแล้ว ให้ทำดังนี้
  1. ทำให้ Message Processor เข้าถึงได้
  2. ทำให้เข้าถึงเราเตอร์ได้
ในโหนดเราเตอร์เดียว ให้ทำดังนี้
- ก่อนอัปเดต ให้ทำให้เราเตอร์เข้าถึงไม่ได้
- หลังจากอัปเดตแล้ว ให้ทำให้เข้าถึงเราเตอร์ได้
ในโหนด Message Processor รายการเดียว ให้ทำดังนี้
- ก่อนอัปเดต ให้ทำให้ไม่สามารถเข้าถึงโปรแกรมประมวลผลข้อความได้
- หลังจากอัปเดตแล้ว ให้ทำให้โปรแกรมประมวลผลข้อความเข้าถึงได้

ใช้ไฟล์การกําหนดค่าแบบเงียบ

คุณต้องส่งไฟล์การกําหนดค่าแบบเงียบไปยังคําสั่งอัปเดต ไฟล์การกำหนดค่าแบบเงียบควรเป็นไฟล์เดียวกับที่คุณใช้ติดตั้ง Edge 4.50.00 หรือ 4.51.00

อัปเดตเป็น 4.52.02 ในโหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก

ใช้ขั้นตอนต่อไปนี้เพื่ออัปเดตคอมโพเนนต์ Edge ในโหนด

หากมี ให้ปิดใช้งานงาน cron ที่กําหนดค่าให้ดําเนินการซ่อมใน Cassandra จนกว่าการอัปเดตจะเสร็จสมบูรณ์
เข้าสู่ระบบโหนดในฐานะรูทเพื่อติดตั้ง RPM ของ Edge
หมายเหตุ: แม้ว่าการติดตั้ง RPM จะต้องใช้สิทธิ์เข้าถึงระดับรูท แต่คุณก็กำหนดค่า Edge ได้โดยไม่ต้องมีสิทธิ์เข้าถึงระดับรูท
ติดตั้ง yum-utils และ yum-plugin-priorities โดยทำดังนี้
หมายเหตุ: หากระบบปฏิบัติการเป็น RHEL 8.0 - 8.6 ให้ข้ามขั้นตอนนี้
```
sudo yum install yum-utils
sudo yum install yum-plugin-priorities
```
ปิดใช้ SELinux ตามที่อธิบายไว้ในติดตั้งยูทิลิตี apigee-setup ของ Edge
หากติดตั้งใน Oracle 7.x ให้ใช้คำสั่งต่อไปนี้
```
sudo yum-config-manager --enable ol7_optional_latest
```

หากติดตั้งใน AWS ให้เรียกใช้คำสั่งต่อไปนี้yum-configure-manager

yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

หากคุณใช้ Edge 4.51.00 อยู่ ให้ทำดังนี้
1. ดาวน์โหลดไฟล์ bootstrap_4.52.02.sh ของ Edge ไปยัง /tmp/bootstrap_4.52.02.sh
```
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
```
2. ติดตั้งยูทิลิตีและทรัพยากร Dependency ของ Edge 4.52.02 apigee-service โดยเรียกใช้คำสั่งต่อไปนี้
```
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
```
  โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณได้รับจาก Apigee หากละเว้น pWord ระบบจะแจ้งให้คุณป้อน
  
  โดยค่าเริ่มต้น โปรแกรมติดตั้งจะตรวจสอบว่าคุณได้ติดตั้ง Java 1.8 แล้ว หากไม่ เจ้าหน้าที่จะติดตั้งให้คุณ
  
  ใช้ตัวเลือก JAVA_FIX เพื่อระบุวิธีจัดการการติดตั้ง Java JAVA_FIX จะใช้ค่าต่อไปนี้
  - I: ติดตั้ง OpenJDK 1.8 (ค่าเริ่มต้น)
  - C: ดำเนินการต่อโดยไม่ติดตั้ง Java
  - Q: ออก สำหรับตัวเลือกนี้ คุณต้องติดตั้ง Java ด้วยตนเอง
3. ใช้ apigee-service เพื่ออัปเดตยูทิลิตี apigee-setup ดังที่แสดงในตัวอย่างต่อไปนี้
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
4. อัปเดตยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการ ดังที่แสดงในตัวอย่างต่อไปนี้
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
5. อัปเดตยูทิลิตี apigee-provision ในเซิร์ฟเวอร์การจัดการ ดังที่แสดงในตัวอย่างต่อไปนี้
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
6. เรียกใช้ยูทิลิตี update ในโหนดโดยดำเนินการตามคำสั่งต่อไปนี้
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
  โดยทําตามลําดับที่อธิบายไว้ในลําดับการอัปเดตเครื่อง
  
  สถานที่:
  - component คือคอมโพเนนต์ Edge ที่จะอัปเดต ค่าที่เป็นไปได้ ได้แก่
    - cs: Cassandra
    - edge: คอมโพเนนต์ Edge ทั้งหมดยกเว้น UI ของ Edge: เซิร์ฟเวอร์การจัดการ, โปรแกรมประมวลผลข้อความ, เราเตอร์, เซิร์ฟเวอร์ QPID, เซิร์ฟเวอร์ Postgres
    - ldap: OpenLDAP
    - ps: postgresql
    - qpid: qpidd
    - sso: Apigee SSO (หากคุณติดตั้ง SSO)
    - ue: UI ของ Edge เวอร์ชันใหม่
    - ui: UI ของ Edge แบบคลาสสิก
    - zk: Zookeeper
  - configFile คือไฟล์การกําหนดค่าเดียวกับที่คุณใช้กําหนดคอมโพเนนต์ Edge ในระหว่างการติดตั้ง 4.50.00 หรือ 4.51.00
  คุณสามารถเรียกใช้ update.sh กับคอมโพเนนต์ทั้งหมดได้โดยตั้งค่า component เป็น "all" แต่ต้องมีโปรไฟล์การติดตั้งแบบ "All-in-One" (AIO) ของ Edge เท่านั้น เช่น
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
```
7. รีสตาร์ทคอมโพเนนต์ UI ของ Edge ในโหนดทั้งหมดที่ใช้อยู่ หากยังไม่ได้ดำเนินการ
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
8. ทดสอบการอัปเดตโดยเรียกใช้ยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการ ตามที่อธิบายไว้ในทดสอบการติดตั้ง

หากในภายหลังคุณตัดสินใจที่จะเปลี่ยนกลับการอัปเดต ให้ทำตามขั้นตอนที่อธิบายไว้ในหัวข้อเปลี่ยนกลับเป็น 4.52.02

อัปเดตเป็น 4.52.02 จากที่เก็บข้อมูลในเครื่อง

หากโหนด Edge อยู่หลังไฟร์วอลล์ หรือถูกห้ามไม่ให้เข้าถึงที่เก็บ Apigee ผ่านอินเทอร์เน็ตด้วยวิธีอื่น คุณจะอัปเดตจากที่เก็บข้อมูลในเครื่องหรือมิเรอร์ของที่เก็บ Apigee ได้

หลังจากสร้างที่เก็บข้อมูล Edge ในพื้นที่แล้ว คุณจะมี 2 ตัวเลือกในการอัปเดต Edge จากที่เก็บข้อมูลในเครื่อง ดังนี้

สร้างไฟล์ .tar ของที่เก็บ คัดลอกไฟล์ .tar ไปยังโหนด แล้วอัปเดต Edge จากไฟล์ .tar
ติดตั้งเว็บเซิร์ฟเวอร์บนโหนดที่มีที่เก็บข้อมูลในเครื่องเพื่อให้โหนดอื่นๆ เข้าถึงได้ Apigee มีเว็บเซิร์ฟเวอร์ Nginx ให้ใช้งาน หรือคุณจะใช้เว็บเซิร์ฟเวอร์ของคุณเองก็ได้

วิธีอัปเดตจากที่เก็บข้อมูล 4.52.02 ในพื้นที่

สร้างที่เก็บข้อมูล 4.52.02 ในพื้นที่ตามที่อธิบายไว้ใน "สร้างที่เก็บข้อมูล Apigee ในพื้นที่" ที่ ติดตั้งยูทิลิตี apigee-setup ของ Edge
หมายเหตุ: หากมีที่เก็บอยู่แล้ว คุณสามารถเพิ่มที่เก็บ 4.52.02 ลงในที่เก็บดังกล่าวได้ ตามที่อธิบายไว้ใน "อัปเดตที่เก็บ Apigee ในพื้นที่" ที่หัวข้อติดตั้งยูทิลิตี apigee-setup ของ Edge
วิธีติดตั้ง apigee-service จากไฟล์ .tar
1. ในโหนดที่มีที่เก็บข้อมูลในเครื่อง ให้ใช้คำสั่งต่อไปนี้เพื่อจัดแพ็กเกจที่เก็บข้อมูลในเครื่องเป็นไฟล์ .tar ไฟล์เดียวชื่อ /opt/apigee/data/apigee-mirror/apigee-4.52.02.tar.gz
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
2. คัดลอกไฟล์ .tar ไปยังโหนดที่ต้องการอัปเดต Edge เช่น คัดลอกไปยังไดเรกทอรี /tmp ในโหนดใหม่
3. ในโหนดใหม่ ให้แตกไฟล์ไปยังไดเรกทอรี /tmp โดยทำดังนี้
```
tar -xzf apigee-4.52.02.tar.gz
```
  คำสั่งนี้จะสร้างไดเรกทอรีใหม่ชื่อ repos ในไดเรกทอรีที่มีไฟล์ .tar เช่น /tmp/repos
4. ติดตั้งยูทิลิตี apigee-service ของ Edge และไลบรารีที่เกี่ยวข้องจาก /tmp/repos
```
sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
  โปรดทราบว่าคุณใส่เส้นทางไปยังไดเรกทอรี repos ในคําสั่งนี้
วิธีติดตั้ง apigee-service โดยใช้เว็บเซิร์ฟเวอร์ Nginx
1. กำหนดค่าเว็บเซิร์ฟเวอร์ Nginx ตามที่อธิบายไว้ใน "ติดตั้งจากรีโปโดยใช้เว็บเซิร์ฟเวอร์ Nginx" ที่หัวข้อติดตั้งยูทิลิตี apigee-setup ของ Edge
2. ในโหนดระยะไกล ให้ดาวน์โหลดไฟล์ bootstrap_4.52.02.sh ของ Edge ไปยัง /tmp/bootstrap_4.52.02.sh
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
```
  โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณตั้งไว้ก่อนหน้านี้สำหรับรีโป และ remoteRepo คือที่อยู่ IP หรือชื่อ DNS ของโหนดรีโป
3. ในโหนดระยะไกล ให้ติดตั้งยูทิลิตี apigee-setup ของ Edge และข้อกําหนดต่อไปนี้
```
sudo bash /tmp/bootstrap_4.52.02.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
  โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านของรีโป
ใช้ apigee-service เพื่ออัปเดตยูทิลิตี apigee-setup ดังที่แสดงในตัวอย่างต่อไปนี้
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
```
อัปเดตยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการ ดังที่แสดงในตัวอย่างต่อไปนี้
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
อัปเดตยูทิลิตี apigee-provision ในเซิร์ฟเวอร์การจัดการ ดังที่แสดงในตัวอย่างต่อไปนี้
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
เรียกใช้ยูทิลิตี update ในโหนดตามลำดับที่อธิบายไว้ในลำดับการอัปเดตเครื่อง
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
สถานที่:
- component คือคอมโพเนนต์ Edge ที่จะอัปเดต โดยทั่วไปแล้ว คุณจะต้องอัปเดตคอมโพเนนต์ต่อไปนี้
  - cs: Cassandra
  - edge: คอมโพเนนต์ Edge ทั้งหมดยกเว้น UI ของ Edge: เซิร์ฟเวอร์การจัดการ เครื่องประมวลผลข้อความ รูทเตอร์ เซิร์ฟเวอร์ QPID เซิร์ฟเวอร์ Postgres
  - ldap: OpenLDAP
  - ps: postgresql
  - qpid: qpidd
  - sso: Apigee SSO (หากคุณติดตั้ง SSO)
  - ue UI ของ Edge ใหม่
  - ui: UI ของ Edge แบบคลาสสิก
  - zk: Zookeeper
- configFile คือไฟล์การกําหนดค่าเดียวกับที่คุณใช้กําหนดคอมโพเนนต์ Edge ในระหว่างการติดตั้ง 4.50.00 หรือ 4.51.00
  หมายเหตุ: ผู้ใช้ "apigee" ต้องอ่านไฟล์การกําหนดค่าได้ หากต้องการเปลี่ยนเจ้าของ ให้ใช้คำสั่งต่อไปนี้
```
chown apigee:apigee configFile
```
คุณสามารถเรียกใช้ update.sh กับคอมโพเนนต์ทั้งหมดได้โดยตั้งค่า component เป็น "all" แต่ต้องมีโปรไฟล์การติดตั้งแบบ "All-in-One" (AIO) ของ Edge เท่านั้น เช่น
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
```
รีสตาร์ทคอมโพเนนต์ UI ในโหนดทั้งหมดที่ใช้อยู่ หากยังไม่ได้ดำเนินการ
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
ทดสอบการอัปเดตโดยเรียกใช้ยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการ ตามที่อธิบายไว้ในทดสอบการติดตั้ง

ลำดับการอัปเดตเครื่อง

ลำดับที่คุณอัปเดตเครื่องในการติดตั้ง Edge มีความสำคัญ ดังนี้

คุณต้องอัปเดตโหนด Cassandra และ ZooKeeper ทั้งหมดก่อนอัปเดตโหนดอื่นๆ
สำหรับเครื่องที่มีคอมโพเนนต์ Edge หลายรายการ (เซิร์ฟเวอร์การจัดการ เครื่องประมวลผลข้อความ รูทเตอร์ เซิร์ฟเวอร์ QPID แต่ไม่ใช่เซิร์ฟเวอร์ Postgres) ให้ใช้ตัวเลือก -c edge เพื่ออัปเดตทั้งหมดพร้อมกัน
หากขั้นตอนหนึ่งระบุว่าควรดำเนินการในหลายเครื่อง ให้ดำเนินการตามลำดับเครื่องที่ระบุ
คุณไม่จำเป็นต้องอัปเดตการสร้างรายได้แยกต่างหาก ระบบจะอัปเดตเมื่อคุณระบุตัวเลือก -c edge

การอัปเกรดแบบสแตนด์อโลน 1 โหนด

วิธีอัปเกรดการกำหนดค่าแบบสแตนด์อโลน 1 โ nod เป็น 4.52.02

อัปเดตคอมโพเนนต์ทั้งหมด
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
```
(หากคุณติดตั้ง apigee-adminapi) อัปเดตยูทิลิตี apigee-adminapi
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

การอัปเกรดแบบสแตนด์อโลน 2 โหนด

อัปเดตคอมโพเนนต์ต่อไปนี้สําหรับการติดตั้งแบบสแตนด์อโลน 2 โหนด

ดูรายการโทโพโลยี Edge และจำนวนโหนดได้ที่โทโพโลยีการติดตั้ง

อัปเดต Cassandra และ ZooKeeper ในเครื่องที่ 1
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
อัปเดต Postgres ในเครื่องที่ 2
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
อัปเดต LDAP ในเครื่องที่ 1
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
อัปเดตคอมโพเนนต์ Edge ในเครื่องที่ 2 และ 1
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
อัปเดต Qpid ในเครื่องที่ 2
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
อัปเดต UI ในเครื่องที่ 1 โดยทำดังนี้
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
(หากคุณติดตั้ง apigee-adminapi) อัปเดตยูทิลิตี apigee-adminapi ในเครื่องที่ 1 โดยทำดังนี้
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(หากคุณติดตั้ง Apigee SSO) อัปเดต Apigee SSO ในเครื่องที่ 1 โดยทำดังนี้
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
โดยที่ sso_config_file คือไฟล์การกําหนดค่าที่คุณสร้างขึ้นเมื่อติดตั้ง SSO
รีสตาร์ทคอมโพเนนต์ UI ของ Edge ในเครื่องที่ 1 โดยทำดังนี้
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```

การอัปเกรด 5 โหนด

อัปเดตคอมโพเนนต์ต่อไปนี้สําหรับการติดตั้ง 5 โ nod

ดูรายการโทโพโลยี Edge และจำนวนโหนดได้ที่โทโพโลยีการติดตั้ง

อัปเดต Cassandra และ ZooKeeper ในเครื่องที่ 1, 2 และ 3
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
อัปเดต Postgres ในเครื่องที่ 4
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```

อัปเดต Postgres ในเครื่อง 5

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

อัปเดต LDAP ในเครื่องที่ 1 โดยทำดังนี้
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
อัปเดตคอมโพเนนต์ Edge ในเครื่อง 4, 5, 1, 2, 3
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
อัปเดต Qpid ในเครื่องที่ 4
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```

อัปเดต Qpid ในเครื่อง 5

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

อัปเดต UI ของ Edge โดยทำดังนี้
- UI แบบคลาสสิก: หากคุณใช้ UI แบบคลาสสิก ให้อัปเดตคอมโพเนนต์ ui ในเครื่อง 1 ดังตัวอย่างต่อไปนี้
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
- UI ของ Edge ใหม่: หากคุณติดตั้ง UI ของ Edge ใหม่ ให้อัปเดตคอมโพเนนต์ ue ในเครื่องที่เหมาะสม (อาจไม่ใช่เครื่องที่ 1) ดังนี้
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
```
(หากคุณติดตั้ง apigee-adminapi) อัปเดตยูทิลิตี apigee-adminapi ในเครื่องที่ 1 โดยทำดังนี้
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(หากคุณติดตั้ง Apigee SSO) อัปเดต Apigee SSO ในเครื่องที่ 1 โดยทำดังนี้
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
โดยที่ sso_config_file คือไฟล์การกําหนดค่าที่คุณสร้างขึ้นเมื่อติดตั้ง SSO
รีสตาร์ทคอมโพเนนต์ UI โดยทำดังนี้
- UI แบบคลาสสิก: หากคุณใช้ UI แบบคลาสสิก ให้รีสตาร์ทคอมโพเนนต์ edge-ui ในเครื่อง 1 ดังที่แสดงในตัวอย่างต่อไปนี้
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
- UI ของ Edge ใหม่: หากคุณติดตั้ง UI ของ Edge ใหม่ ให้รีสตาร์ทคอมโพเนนต์ edge-management-ui ในเครื่องที่เหมาะสม (อาจไม่ใช่เครื่องที่ 1)
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

การอัปเกรดคลัสเตอร์ 9 โหนด

อัปเดตคอมโพเนนต์ต่อไปนี้สําหรับการติดตั้งคลัสเตอร์ 9 นอต

ดูรายการโทโพโลยี Edge และจำนวนโหนดได้ที่โทโพโลยีการติดตั้ง

อัปเดต Cassandra และ ZooKeeper ในเครื่องที่ 1, 2 และ 3
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```

อัปเดต Postgres ในเครื่อง 8

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

อัปเดต Postgres ในเครื่อง 9

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

อัปเดต LDAP ในเครื่องที่ 1
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
อัปเดตคอมโพเนนต์ Edge ในเครื่อง 6, 7, 8, 9, 1, 4 และ 5 ตามลำดับดังนี้
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
อัปเดต Qpid ในเครื่อง 6 และ 7
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
อัปเดต UI ใหม่ (ue) หรือ UI แบบคลาสสิก (ui) ในเครื่องที่ 1 โดยทำดังนี้
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
(หากคุณติดตั้ง apigee-adminapi) อัปเดตยูทิลิตี apigee-adminapi ในเครื่องที่ 1 โดยทำดังนี้
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(หากคุณติดตั้ง Apigee SSO) อัปเดต Apigee SSO ในเครื่องที่ 1 โดยทำดังนี้
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
โดยที่ sso_config_file คือไฟล์การกําหนดค่าที่คุณสร้างขึ้นเมื่อติดตั้ง SSO
รีสตาร์ทคอมโพเนนต์ UI โดยทำดังนี้
- UI แบบคลาสสิก: หากคุณใช้ UI แบบคลาสสิก ให้รีสตาร์ทคอมโพเนนต์ edge-ui ในเครื่อง 1 ดังที่แสดงในตัวอย่างต่อไปนี้
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
- UI ของ Edge ใหม่: หากคุณติดตั้ง UI ของ Edge ใหม่ ให้รีสตาร์ทคอมโพเนนต์ edge-management-ui ในเครื่องที่เหมาะสม (อาจไม่ใช่เครื่องที่ 1)
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

การอัปเกรดคลัสเตอร์ 13 โหนด

อัปเดตคอมโพเนนต์ต่อไปนี้สําหรับการติดตั้งคลัสเตอร์ 13 นอต

ดูรายการโทโพโลยี Edge และจำนวนโหนดได้ที่โทโพโลยีการติดตั้ง

อัปเดต Cassandra และ ZooKeeper ในเครื่องที่ 1, 2 และ 3
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```

อัปเดต Postgres ในเครื่อง 8

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

อัปเดต Postgres ในเครื่อง 9

/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

อัปเดต LDAP ในเครื่องที่ 4 และ 5 โดยทำดังนี้
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
อัปเดตคอมโพเนนต์ Edge ในเครื่อง 12, 13, 8, 9, 6, 7, 10 และ 11 ตามลำดับ
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
อัปเดต Qpid ในเครื่อง 12 และ 13
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
อัปเดต UI ใหม่ (ue) หรือ UI แบบคลาสสิก (ui) ในเครื่องที่ 6 และ 7 โดยทำดังนี้
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
(หากคุณติดตั้ง apigee-adminapi) อัปเดตยูทิลิตี apigee-adminapi ในเครื่องที่ 6 และ 7
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(หากคุณติดตั้ง Apigee SSO) อัปเดต Apigee SSO ในเครื่องที่ 6 และ 7 โดยทำดังนี้
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
โดยที่ sso_config_file คือไฟล์การกําหนดค่าที่คุณสร้างขึ้นเมื่อติดตั้ง SSO
รีสตาร์ทคอมโพเนนต์ UI โดยทำดังนี้
- UI แบบคลาสสิก: หากคุณใช้ UI แบบคลาสสิก ให้รีสตาร์ทคอมโพเนนต์ edge-ui ในเครื่องที่ 6 และ 7 ดังที่แสดงในตัวอย่างต่อไปนี้
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
- UI ของ Edge ใหม่: หากคุณติดตั้ง UI ของ Edge ใหม่ ให้รีสตาร์ทคอมโพเนนต์ edge-management-ui ในเครื่องที่ 6 และ 7 โดยทำดังนี้
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

การอัปเกรดคลัสเตอร์ 12 โหนด

อัปเดตคอมโพเนนต์ต่อไปนี้สําหรับการติดตั้งคลัสเตอร์ 12 โหนด

ดูรายการโทโพโลยี Edge และจำนวนโหนดได้ที่โทโพโลยีการติดตั้ง

อัปเดต Cassandra และ ZooKeeper โดยทำดังนี้
1. ในเครื่อง 1, 2 และ 3 ในศูนย์ข้อมูล 1
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. ในเครื่อง 7, 8 และ 9 ในศูนย์ข้อมูล 2
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
อัปเดต Postgres
1. เครื่อง 6 ในศูนย์ข้อมูล 1
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
2. เครื่อง 12 ในศูนย์ข้อมูล 2
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
อัปเดต LDAP
1. เครื่อง 1 ในศูนย์ข้อมูล 1
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
2. เครื่อง 7 ในศูนย์ข้อมูล 2
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
อัปเดตคอมโพเนนต์ Edge โดยทำดังนี้
1. เครื่อง 4, 5, 6, 1, 2, 3 ในศูนย์ข้อมูล 1
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
2. เครื่อง 10, 11, 12, 7, 8, 9 ในศูนย์ข้อมูล 2
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
อัปเดต qpidd
1. เครื่อง 4, 5 ในศูนย์ข้อมูล 1
  1. อัปเดต qpidd ในเครื่อง 4
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
  2. อัปเดต qpidd ในเครื่อง 5
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
2. เครื่อง 10, 11 ในศูนย์ข้อมูล 2
  1. อัปเดต qpidd ในเครื่อง 10:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
  2. อัปเดต qpidd ในเครื่อง 11:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
อัปเดต UI ใหม่ (ue) หรือ UI แบบคลาสสิก (ui) โดยทำดังนี้
1. เครื่อง 1 ในศูนย์ข้อมูล 1
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
2. เครื่อง 7 ในศูนย์ข้อมูล 2
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
(หากคุณติดตั้ง apigee-adminapi) อัปเดตยูทิลิตี apigee-adminapi โดยทำดังนี้
1. เครื่อง 1 ในศูนย์ข้อมูล 1
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
2. เครื่อง 7 ในศูนย์ข้อมูล 2
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(หากคุณติดตั้ง Apigee SSO) อัปเดต Apigee SSO โดยทำดังนี้
1. เครื่อง 1 ในศูนย์ข้อมูล 1
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
2. เครื่อง 7 ในศูนย์ข้อมูล 2
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
รีสตาร์ทคอมโพเนนต์ UI ของ Edge ใหม่ (edge-management-ui) หรือ UI ของ Edge แบบคลาสสิก (edge-ui) ในเครื่องที่ 1 และ 7 โดยทำดังนี้
```
/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
```

สําหรับการกําหนดค่าที่ไม่ใช่มาตรฐาน

หากคุณมีการกำหนดค่าที่ไม่ใช่มาตรฐาน ให้อัปเดตคอมโพเนนต์ Edge ตามลำดับต่อไปนี้

ZooKeeper
Cassandra
ps
LDAP
Edge ซึ่งหมายถึงโปรไฟล์ "-c edge" ในโหนดทั้งหมดตามลําดับดังนี้ โหนดที่มีเซิร์ฟเวอร์ Qpid, เซิร์ฟเวอร์ Edge Postgres, เซิร์ฟเวอร์การจัดการ, โปรแกรมประมวลผลข้อความ และเราเตอร์
หมายเหตุ: หากโหนดติดตั้งทั้ง Qpid Server และ Edge Postgres Server ให้เรียกใช้ขั้นตอนโปรไฟล์ "-c edge"
qpidd
UI ของ Edge (แบบคลาสสิกหรือแบบใหม่)
apigee-adminapi
SSO ของ Apigee

หลังจากอัปเดตเสร็จแล้ว อย่าลืมรีสตาร์ทคอมโพเนนต์ UI ของ Edge ในเครื่องทั้งหมดที่ใช้คอมโพเนนต์ดังกล่าว