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

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

ใครอัปเดตได้บ้าง

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

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

คุณต้องอัปเดตคอมโพเนนต์ใดบ้าง

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

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

โปรดตรวจสอบข้อกำหนดเบื้องต้นต่อไปนี้ก่อนอัปเกรด Apigee Edge

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

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

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

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

การเผยแพร่การตั้งค่าพร็อพเพอร์ตี้โดยอัตโนมัติ

หากคุณตั้งค่าพร็อพเพอร์ตี้ใดๆ ด้วยการแก้ไขไฟล์ .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 จะอัปเกรดโหนดทีละรายการ ทันทีที่โหนดได้รับการอัปเดต การเปลี่ยนแปลงสคีมาบางอย่างจะมีผลซึ่งย้อนกลับโดยตรงไม่ได้ อ่านส่วนบน Rollback อย่างละเอียด เนื่องจากอาจใช้เทคนิคที่แตกต่างกันได้โดยขึ้นอยู่กับจำนวนคลัสเตอร์ที่อัปเกรดแล้ว

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

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

Documenting API ในพอร์ทัลนักพัฒนาซอฟต์แวร์

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

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

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

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

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

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

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

Cassandra ใน Apigee ที่ใช้เวอร์ชัน 2.1.22
คอมโพเนนต์ Edge สำหรับ Private Cloud 4.52.02:

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

สถานะรันไทม์ในขั้นตอนนี้	สถานะการจัดการในขั้นตอนนี้
รันไทม์ทำงานได้อย่างสมบูรณ์	การจัดการทำงานได้อย่างสมบูรณ์

ขั้นตอนที่ 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 หากหยุดดำเนินการเมื่ออัปเกรดไม่สำเร็จ และลองอัปเกรดอีกครั้งหลังจากแก้ไขการตั้งค่าในไฟล์แล้ว

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

ขั้นตอนที่ 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 ก่อนอัปเกรดคลัสเตอร์ Cassandra ทั้งหมด การอัปเกรดเซิร์ฟเวอร์การจัดการ Edge จะล้มเหลว และบริการ EDGE-management-server จะปฏิเสธที่จะเริ่มต้น

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

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

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

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

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

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

สถานะรันไทม์	สถานะการจัดการ
รันไทม์ทำงานได้อย่างสมบูรณ์	การจัดการทำงานได้อย่างสมบูรณ์

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

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

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

สถานะรันไทม์	สถานะการจัดการ
รันไทม์ทำงานได้อย่างสมบูรณ์	การจัดการทำงานได้อย่างสมบูรณ์

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

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

ในขั้นตอนนี้ หากคุณกำลังอัปเกรดจากเวอร์ชันก่อนหน้า Edge สำหรับ 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

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

สถานะรันไทม์	สถานะการจัดการ
รันไทม์ทำงานได้อย่างสมบูรณ์	การจัดการทำงานได้อย่างสมบูรณ์

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

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

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

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

หากคุณอัปเกรดจาก Edge for Private Cloud 4.51.00 เป็น 4.52.02 คุณต้องทำตามขั้นตอนเพื่ออัปเกรด Postgres แม้ว่า Edge สำหรับ 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 ใหม่

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

ติดตั้ง Edge UI

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

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

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

อัปเดต Edge UI

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

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

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

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

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

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

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

หมายเหตุ: โทโพโลยีแบบ all-in-one (AIO) และสแตนด์อโลน (2 โหนด) ของ Edge ออกแบบมาเพื่อการเริ่มต้นใช้งานและการสร้างต้นแบบ ไม่ใช่เวอร์ชันที่ใช้งานจริง ดังนั้นจึงไม่มีกระบวนการย้อนกลับสำหรับโทโพโลยีแบบ all-in-one (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 โหนดขึ้นไปเท่านั้น

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

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

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

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

ใช้ไฟล์การกำหนดค่าที่ผู้ใช้ไม่ต้องดำเนินการ

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

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

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

หากมี ให้ปิดใช้งาน cron ที่กำหนดค่าไว้เพื่อดำเนินการซ่อมแซมใน Cassandra จนกว่าการอัปเดตจะเสร็จสมบูรณ์
เข้าสู่ระบบโหนดในฐานะรูทเพื่อติดตั้ง Edge RPM
หมายเหตุ: แม้ว่าการติดตั้ง 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 ของ 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. ดาวน์โหลดไฟล์ Edge bootstrap_4.52.02.sh ไปยัง /tmp/bootstrap_4.52.02.sh:
```
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
```
2. ติดตั้งยูทิลิตีและการอ้างอิง 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: คาสซานดรา
    - edge: คอมโพเนนต์ Edge ทั้งหมดยกเว้น Edge UI ได้แก่ เซิร์ฟเวอร์การจัดการ, ตัวประมวลผลข้อความ, เราเตอร์, เซิร์ฟเวอร์ QPID, เซิร์ฟเวอร์ Postgres
    - ldap: OpenLDAP
    - ps: Postgresql
    - qpid: qpidd
    - sso: SSO ของ Apigee (หากติดตั้ง SSO ไว้)
    - ue: UI ของ Edge ใหม่
    - ui: UI ของ Edge แบบคลาสสิก
    - zk: Zookeeper
  - configFile เป็นไฟล์การกำหนดค่าเดียวกับที่คุณใช้กำหนดคอมโพเนนต์ Edge ระหว่างการติดตั้ง 4.50.00 หรือ 4.51.00
  คุณเรียกใช้ update.sh กับคอมโพเนนต์ทั้งหมดได้โดยการตั้งค่า component เป็น "ทั้งหมด" แต่เฉพาะเมื่อคุณมีโปรไฟล์การติดตั้ง Edge all-in-one (AIO) เท่านั้น เช่น
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
```
7. รีสตาร์ทคอมโพเนนต์ Edge UI บนโหนดทั้งหมดที่เรียกใช้คอมโพเนนต์ดังกล่าว หากยังไม่ได้ดำเนินการ ให้ทำดังนี้
```
/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 ของ Edge
หมายเหตุ: หากมีที่เก็บอยู่แล้ว คุณจะเพิ่มที่เก็บเวอร์ชัน 4.52.02 ได้ตามที่อธิบายไว้ใน "อัปเดตที่เก็บ Apigee ในเครื่อง" ที่ติดตั้งยูทิลิตีการตั้งค่า Apigee ของ 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. ติดตั้งยูทิลิตี Edge apigee-service และทรัพยากร Dependency จาก /tmp/repos:
```
sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
  คุณจะเห็นว่าใส่เส้นทางไปยังไดเรกทอรี repos ในคำสั่งนี้
วิธีติดตั้ง apigee-service โดยใช้เว็บเซิร์ฟเวอร์ Nginx
1. กำหนดค่าเว็บเซิร์ฟเวอร์ Nginx ตามที่อธิบายไว้ใน "ติดตั้งจากที่เก็บโดยใช้เว็บเซิร์ฟเวอร์ Nginx" ที่ติดตั้งยูทิลิตีการตั้งค่า Apigee ของ Edge
2. ในโหนดระยะไกล ให้ดาวน์โหลดไฟล์ Edge bootstrap_4.52.02.sh ไปยัง /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. ในโหนดระยะไกล ให้ติดตั้งยูทิลิตีและการอ้างอิง Edge apigee-setup:
```
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: คาสซานดรา
  - edge: คอมโพเนนต์ Edge ทั้งหมดยกเว้น Edge UI ได้แก่ เซิร์ฟเวอร์การจัดการ, ตัวประมวลผลข้อความ, เราเตอร์, เซิร์ฟเวอร์ QPID, เซิร์ฟเวอร์ Postgres
  - ldap: OpenLDAP
  - ps: Postgresql
  - qpid: qpidd
  - sso: SSO ของ Apigee (หากติดตั้ง SSO ไว้)
  - UI ของ Edge ใหม่ ue รายการ
  - ui: UI ของ Edge แบบคลาสสิก
  - zk: Zookeeper
- configFile เป็นไฟล์การกำหนดค่าเดียวกับที่คุณใช้กำหนดคอมโพเนนต์ Edge ระหว่างการติดตั้ง 4.50.00 หรือ 4.51.00
  หมายเหตุ: ผู้ใช้ "apigee" ต้องอ่านไฟล์การกำหนดค่าได้ หากต้องการเปลี่ยนเจ้าของ ให้ใช้คำสั่งต่อไปนี้
```
chown apigee:apigee configFile
```
คุณเรียกใช้ update.sh กับคอมโพเนนต์ทั้งหมดได้โดยการตั้งค่า component เป็น "ทั้งหมด" แต่เฉพาะเมื่อคุณมีโปรไฟล์การติดตั้ง Edge all-in-one (AIO) เท่านั้น เช่น
```
/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 โหนดเป็น 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 โหนด

โปรดดูโทโพโลยีการติดตั้งสำหรับรายการ Topologies ของ 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
```
(หากคุณติดตั้ง SSO ของ Apigee) ให้อัปเดต Apigee SSO ในเครื่อง 1 โดยทำดังนี้
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
โดยที่ sso_config_file คือไฟล์การกำหนดค่าที่คุณสร้างขึ้นเมื่อติดตั้ง SSO
รีสตาร์ทคอมโพเนนต์ Edge UI ในเครื่อง 1:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```

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

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

โปรดดูโทโพโลยีการติดตั้งสำหรับรายการ Topologies ของ 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

อัปเดต Edge UI ดังนี้
- UI คลาสสิก: หากคุณใช้ UI คลาสสิก ให้อัปเดตคอมโพเนนต์ ui ในเครื่อง 1 ตามตัวอย่างต่อไปนี้
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
- EDGE UI ใหม่: หากคุณติดตั้ง Edge UI ใหม่ ให้อัปเดตคอมโพเนนต์ 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
```
(หากคุณติดตั้ง SSO ของ Apigee) ให้อัปเดต 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
```
- Edge UI ใหม่: หากคุณติดตั้ง EDGE UI ใหม่ ให้รีสตาร์ท คอมโพเนนต์ edge-management-ui ในเครื่องที่เหมาะสม (อาจไม่ใช่เครื่อง 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

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

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

โปรดดูโทโพโลยีการติดตั้งสำหรับรายการ Topologies ของ 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
```
(หากคุณติดตั้ง SSO ของ Apigee) ให้อัปเดต 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
```
- Edge UI ใหม่: หากคุณติดตั้ง EDGE UI ใหม่ ให้รีสตาร์ท คอมโพเนนต์ edge-management-ui ในเครื่องที่เหมาะสม (อาจไม่ใช่เครื่อง 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

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

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

โปรดดูโทโพโลยีการติดตั้งสำหรับรายการ Topologies ของ 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
```
(หากคุณติดตั้ง SSO ของ Apigee) ให้อัปเดต 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
```
- EDGE UI ใหม่: หากคุณติดตั้ง Edge UI ใหม่ ให้รีสตาร์ทคอมโพเนนต์ edge-management-ui ในเครื่อง 6 และ 7:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

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

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

โปรดดูโทโพโลยีการติดตั้งสำหรับรายการ Topologies ของ Edge และหมายเลขโหนด

อัปเดต Cassandra และ ZooKeeper ดังนี้
1. บนเครื่อง 1, 2 และ 3 ในศูนย์ข้อมูลที่ 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```
2. บนเครื่อง 7, 8 และ 9 ใน Data Center 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 ใน Data Center 2
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
อัปเดต qpidd ดังนี้
1. เครื่อง 4, 5 ใน Data Center 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 ใน Data Center 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
```
(หากคุณติดตั้ง SSO ของ Apigee) ให้อัปเดต SSO ของ Apigee ดังนี้
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
```
รีสตาร์ทคอมโพเนนต์ Edge UI ใหม่ (edge-management-ui) หรือ Edge UI แบบคลาสสิก (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 Server, เซิร์ฟเวอร์การจัดการ, ตัวประมวลผลข้อความ และเราเตอร์
หมายเหตุ: หากโหนดมีทั้ง Qpid Server และ Edge Postgres Server ให้เรียกใช้ขั้นตอนโปรไฟล์ "-c edge"
Qpidd
Edge UI (คลาสสิกหรือใหม่)
apigee-adminapi
SSO ของ Apigee

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