Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

การอัปเกรดระบบปฏิบัติการทีละโหนดสำหรับ Apigee Edge สำหรับ Private Cloud

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X info

เอกสารนี้อธิบายวิธีการอัปเกรดระบบปฏิบัติการ (OS) ของเซิร์ฟเวอร์ในคลัสเตอร์ Apigee Edge สำหรับ Private Cloud อีกวิธีหนึ่ง แทนที่จะตั้งค่าศูนย์ข้อมูลคู่ขนานใหม่ทั้งหมด วิธีการแบบทีละโหนดนี้ช่วยให้คุณอัปเกรดระบบปฏิบัติการได้ในที่เดียว ทีละเครื่อง/โหนด

ข้อควรระวัง: เราขอแนะนำอย่างยิ่งให้คุณทดสอบกระบวนการแทนที่เหล่านี้ในสภาพแวดล้อมที่ต่ำกว่าก่อนที่จะดำเนินการต่อในสภาพแวดล้อมฮาร์ดแวร์และซอฟต์แวร์ อย่อัปเกรดเวอร์ชัน Apigee และอัปเกรดเวอร์ชันหลักของระบบปฏิบัติการพร้อมกัน

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

ความเข้ากันได้

ก่อนเริ่มการอัปเกรดระบบปฏิบัติการทีละโหนด ให้ตรวจสอบว่า Apigee Edge สำหรับ Private Cloud เวอร์ชันปัจจุบันรองรับระบบปฏิบัติการเวอร์ชันเป้าหมาย โปรดดูเมทริกซ์ความเข้ากันได้ของระบบปฏิบัติการเพื่อตรวจสอบ

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

ก่อนที่จะเริ่มอัปเกรดโหนดทีละโหนด โปรดตรวจสอบว่าคุณได้ทำงานต่อไปนี้เสร็จแล้ว

สำรองข้อมูลโหนดทั้งหมด

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

ตรวจสอบว่า Edge ทำงานอยู่

ตรวจสอบว่า Edge ทำงานอยู่ระหว่างกระบวนการอัปเดตโดยใช้คำสั่งต่อไปนี้

/opt/apigee/apigee-service/bin/apigee-all status

ลำดับการเปลี่ยนโหนด

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

Cassandra
Zookeeper
Postgres
LDAP
Qpid
Message-Processor
เราเตอร์
เซิร์ฟเวอร์การจัดการ
UI/UE
SSO

สถานการณ์สมมติเพิ่มเติม

เมื่ออัปเกรดระบบปฏิบัติการทีละโหนด หากมีการกำหนดค่าต่อไปนี้ในการตั้งค่าที่มีอยู่ โปรดทำตามขั้นตอนเพิ่มเติมเหล่านี้

apigee-mtls - หากเปิดใช้ apigee-mtls ระบบจะไม่รองรับการอัปเกรดระบบปฏิบัติการแบบทีละโหนด (การอัปเกรดแบบต่อเนื่อง) สำหรับการตั้งค่านี้ หากต้องการอัปเกรด โปรดทำตามคู่มือการอัปเกรด apigee-mtls

Cassandra

เมื่อแทนที่ Cassandra ให้พิจารณาแทนที่โหนดที่ไม่ใช่ Seed ก่อน ตามด้วยโหนด Seed

กรณีพิเศษที่ต้องพิจารณาสำหรับ Cassandra มีดังนี้

Native-mTLS ของ Cassandra - หากเปิดใช้และบังคับใช้ native-mTLS ให้ยกเลิกการบังคับใช้ในโหนดที่เปิดใช้ mTLS โดยตั้งค่า conf_cassandra_client_encryption_optional=true ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบเกี่ยวกับ mTLS ดั้งเดิม
เปิดใช้การเข้ารหัสระหว่างโหนดของ Cassandra - โปรดดูเปิดใช้การเข้ารหัสระหว่างโหนดของ Cassandra เพื่อให้แน่ใจว่าใบรับรองของโหนด Cassandra ที่มีอยู่รวมอยู่ใน Truststore ของโหนดที่เพิ่งแทนที่ และในทางกลับกัน

ขั้นตอนในการแทนที่โหนด Cassandra มีดังนี้

สำรองข้อมูลโหนดโดยการถ่ายภาพรวมของเครื่องเสมือน (หากเป็นไปได้) และสำรองข้อมูล Apigee สำหรับ Cassandra ในทุกโหนดโดยใช้คำสั่งต่อไปนี้
```
apigee-service apigee-cassandra backup
```
จัดหาโหนดใหม่ด้วยระบบปฏิบัติการที่อัปเกรดแล้ว
ใช้ข้อกำหนดเบื้องต้นเฉพาะระบบปฏิบัติการ
ดาวน์โหลดและเรียกใช้ไฟล์ Edge เพื่อติดตั้งยูทิลิตี apigee-service การเริ่มต้นของ Apigee เวอร์ชันที่ใช้งาน ให้run bootstrap เพื่อรับ apigee-service และติดตั้ง apigee-setup
หมายเหตุ: ตรวจสอบว่าโหนดใหม่ไม่มีไดเรกทอรีข้อมูลในเส้นทางของไดเรกทอรีข้อมูล apigee-cassandra

แสดงรายการโหนดเริ่มต้น

apigee-service apigee-cassandra configure -search conf_cassandra_seeds

อัปเดตไฟล์การกำหนดค่าโดยเปลี่ยน IP ของโหนด Cassandra ที่มีอยู่และแทนที่ด้วยที่อยู่ IP ของโหนดใหม่
หมายเหตุ: ตรวจสอบว่าลำดับของที่อยู่ IP ที่จะแทนที่ยังคงอยู่ เช่น หากแทนที่ IP2 ด้วย IP4

CASS_HOSTS ที่มีอยู่
```
CASS_HOSTS="$IP1 $IP2 $IP3"
```
CASS_HOSTS ที่อัปเดตใหม่
```
CASS_HOSTS="$IP1 $IP4 $IP3"
```
กำหนดค่าโหนดที่มีอยู่บนคลัสเตอร์ใหม่ด้วย IP ของโหนด Cassandra ใหม่ที่อัปเดตแล้ว (ยกเว้นโหนดที่จะแทนที่) โปรดใช้ข้อมูลอ้างอิงไฟล์การกำหนดค่า
```
/opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
```
หยุดและยกเลิกการลงทะเบียน Cassandra ในโหนดเก่าโดยทำดังนี้
1. หยุด Cassandra ในโหนดที่จะแทนที่
```
apigee-service apigee-cassandra stop
```
2. แสดงรายการ UUID ของโหนด Cassandra ที่จะเลิกใช้งาน (หากมีศูนย์ข้อมูลหลายแห่ง ให้พิจารณาตามนั้น)
```
apigee-adminapi.sh servers list -r dc-1 -p central -t application-datastore --admin AdminEmailID --pwd 'AdminPassword' --host localhost
```
3. ยกเลิกการลงทะเบียนประเภทที่เก็บข้อมูลที่เชื่อมโยงกับ UUID ของ Cassandra ที่มีอยู่
```
curl -u AdminEmailID:'AdminPassword' -X POST http://MS_IP:8080/v1/servers -d "type=cache-datastore&type=user-settings-datastore&type=scheduler-datastore&type=audit-datastore&type=apimodel-datastore&type=application-datastore&type=edgenotification-datastore&type=identityzone-datastore&type=auth-datastore&region=dc-1&pod=central&uuid=old_cassandra_uuid&action=remove"
```
4. ลบเซิร์ฟเวอร์
  หมายเหตุ: อย่าเรียกใช้ขั้นตอนนี้หาก Cassandra และคอมโพเนนต์ Edge อื่นๆ เช่น management-server อยู่ในโหนดเดียวกัน กรณีนี้อาจเกิดขึ้นหากการกำหนดค่าของคุณใช้การตั้งค่า Apigee มาตรฐานแบบ 5 โหนด
```
curl -u AdminEmailID:AdminPassword -X DELETE http://MS_IP:8080/v1/servers/old_cassandra_uuid
```
เตรียมโหนดใหม่สำหรับโฮสต์ apigee-cassandra เพิ่มบรรทัดต่อไปนี้ลงในไฟล์ cassandra.properties ในส่วน /opt/apigee/customer/application/cassandra.properties (สร้างหากยังไม่มี) ในโหนด Cassandra ใหม่
```
conf_jvm_options_custom_settings=-Dcassandra.replace_address=IPOfOldCassandraNode -Dcassandra.allow_unsafe_replace=true
```
ยืนยันว่าได้ตั้งค่าเจ้าของและกลุ่มเป็น apigee:apigee ในไฟล์ cassandra.properties หากจำเป็น ให้ใช้คำสั่งต่อไปนี้เพื่ออัปเดตเจ้าของและกลุ่ม
```
chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
```
ติดตั้ง Cassandra และเรียกใช้การตั้งค่าในโหนดที่เพิ่งเพิ่ม
```
apigee-service apigee-cassandra install
```
```
apigee-service apigee-cassandra setup -f updatedConfigFile
```
หลังจากตั้งค่าโหนดใหม่แล้ว ให้นำการกำหนดค่าเพิ่มเติมที่เพิ่มลงใน /opt/apigee/customer/application/cassandra.properties ออก แล้วรีสตาร์ท apigee-cassandra
```
conf_jvm_options_custom_settings=-Dcassandra.replace_address=IPOfOldCassandraNode -Dcassandra.allow_unsafe_replace=true
```
```
apigee-service apigee-cassandra restart
```
ตรวจสอบสถานะของโหนดใหม่ที่แทนที่
```
apigee-service apigee-cassandra status
```
```
/opt/apigee/apigee-cassandra/bin/nodetool status
```
สร้างโหนดใหม่ที่เพิ่มลงในคลัสเตอร์อีกครั้ง
```
/opt/apigee/apigee-cassandra/bin/nodetool rebuild -dc dc-1
```
ตั้งค่าโหนดที่มีอยู่ของเซิร์ฟเวอร์ Router, Message-Processor, Qpid, Postgres และ Management ตามลำดับอีกครั้งโดยการอัปเดต IP ของโหนด Cassandra ใหม่ในไฟล์การกำหนดค่า
```
/opt/apigee/apigee-setup/bin/setup.sh -p r|mp|qs|ps|ms|mo -f updatedConfigFile
```
หมายเหตุ: หากเราเตอร์และ Message Processor อยู่ในโหนดเดียวกัน ให้ใช้ -p rmp
นำ/ถอนการติดตั้ง Cassandra ออกจากโหนดที่เก่ากว่า
```
apigee-service apigee-cassandra uninstall
```
ทำซ้ำสำหรับโหนด Cassandra อื่นๆ ในคลัสเตอร์

ผู้ดูแลสวนสัตว์

ดูขั้นตอนด้านล่างเพื่อแทนที่โหนด Zookeeper ลองเปลี่ยนโหนดติดตามก่อน แล้วจึงเปลี่ยนโหนดผู้นำ เพื่อให้มั่นใจว่ากลุ่มจะยังคงมีจำนวนโหนดขั้นต่ำที่จำเป็น

สำรองข้อมูลโหนดโดยการถ่ายภาพรวมของเครื่องเสมือน (หากเป็นไปได้) และสำรองข้อมูล Apigee สำหรับ Zookeeper ในทุกโหนด
หยุดและถอนการติดตั้ง Zookeeper ในโหนดที่มีอยู่
```
apigee-service apigee-zookeeper stop
```
```
apigee-service apigee-zookeeper uninstall
```
จัดหาโหนดใหม่ด้วยระบบปฏิบัติการที่อัปเกรดแล้ว
ใช้ข้อกำหนดเบื้องต้นเฉพาะระบบปฏิบัติการ
ดาวน์โหลด Bootstrap ของ Apigee เวอร์ชันที่ใช้งานอยู่ เรียกใช้ Bootstrap เพื่อรับ apigee-service และติดตั้ง apigee-setup
อัปเดตไฟล์การกำหนดค่าโดยนำที่อยู่ IP ของโหนดที่ล้าสมัย/ถูกลบออก แล้วแทนที่ด้วยที่อยู่ IP ของโหนดใหม่สำหรับ Zookeeper ดูรายละเอียดเพิ่มเติมได้ที่การอ้างอิงไฟล์การกำหนดค่า
หมายเหตุ: ตรวจสอบว่าลำดับของ IP ที่จะแทนที่ยังคงเหมือนเดิม เช่น หากแทนที่ IP2 ด้วย IP4

การกำหนดค่า ZK ที่มีอยู่
```
ZK_HOSTS="$IP1 $IP2 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
    
```
อัปเดตการกำหนดค่า ZK แล้ว
```
ZK_HOSTS="$IP1 $IP4 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP4 $IP3"
    
```
ติดตั้ง ตั้งค่า และเริ่ม Zookeeper ในโหนดใหม่โดยใช้ไฟล์การกำหนดค่าที่อัปเดตแล้ว
```
/opt/apigee/apigee-setup/bin/setup.sh -p zk -f updatedConfigFile
```
ทำการเปลี่ยนแปลงโหนด Zookeeper ที่มีอยู่ด้วย updatedConfigFile ดังนี้
```
/opt/apigee/apigee-setup/bin/setup.sh -p zk -f updatedConfigFile
```
ตั้งค่าโหนดที่มีอยู่ของเซิร์ฟเวอร์ Router, Message-Processor, Qpid, Postgres และ Management อีกครั้งโดยอัปเดต IP ของโหนด Zookeeper ใหม่ในไฟล์การกำหนดค่า
```
/opt/apigee/apigee-setup/bin/setup.sh -p r|mp|qs|ps|ms|mo -f updatedConfigFile
```
หมายเหตุ: หากเราเตอร์และ Message Processor อยู่ในโหนดเดียวกัน ให้ใช้ -p rmp
ทำซ้ำสำหรับโหนด Zookeeper ทั้งหมด

Postgres

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

แทนที่โหนดสแตนด์บายที่มีอยู่ด้วยระบบปฏิบัติการเป้าหมาย
เลื่อนระดับโหนดสแตนด์บายใหม่เป็นโหนดหลัก
เลิกใช้งานมาสเตอร์เก่า
แทนที่โหนดสแตนด์บายเพิ่มเติมต่อไป

ก่อนเริ่มการแทนที่ ขอแนะนำให้หยุด edge-qpid-server เพื่อลดการสูญเสียข้อความการวิเคราะห์ที่อาจเกิดขึ้น

apigee-service edge-qpid-server stop

สแตนด์บาย

รับ UUID ของโหนด edge-postgres-server
```
curl http://pg_standby_ip:8084/v1/servers/self
```

หยุด Postgres

apigee-service edge-postgres-server stop

apigee-service apigee-postgresql stop

นำสแตนด์บาย Postgres ที่มีอยู่ออกจากกลุ่มการวิเคราะห์โดยทำตามขั้นตอนเหล่านี้
ถอนการติดตั้ง apigee-postgres และ postgres-server โดยทำดังนี้
```
apigee-service edge-postgres-server uninstall
```
```
apigee-service apigee-postgresql uninstall
```
จัดหาโหนดใหม่ด้วยระบบปฏิบัติการที่อัปเกรดแล้ว
ใช้ข้อกำหนดเบื้องต้นเฉพาะระบบปฏิบัติการ
ดาวน์โหลด Bootstrap ของ Apigee เวอร์ชันที่ใช้งานอยู่ เรียกใช้ Bootstrap เพื่อรับ apigee-service และติดตั้ง apigee-setup
ตั้งค่าการจำลองแบบต้นแบบ-สแตนด์บายในต้นแบบที่มีอยู่โดยการอัปเดตไฟล์การกำหนดค่าด้วย EXISTING_PG_MASTER_IP และ NEW_PG_STANDBY_IP ดูรายละเอียดเพิ่มเติมได้ที่ข้อมูลอ้างอิงไฟล์การกำหนดค่า
```
PG_MASTER=EXISTING_PG_MASTER_IP
```
```
PG_STANDBY=NEW_PG_STANDBY_IP
```
```
apigee-service apigee-postgresql setup-replication-on-master -f updatedConfigFile
```
ติดตั้ง ตั้งค่า และเริ่ม Postgres ด้วยการกำหนดค่าหลัก-สแตนด์บายในโหนดสแตนด์บายใหม่
```
PG_MASTER=EXISTING_PG_MASTER_IP
```
```
PG_STANDBY=NEW_PG_STANDBY_IP
```
```
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f updatedConfigFile
```
ตรวจสอบการตั้งค่าสแตนด์บาย
```
apigee-service apigee-postgresql postgres-check-standby
```

Master

รับ UUID ของโหนดมาสเตอร์ Postgres ที่มีอยู่
```
curl http://pg_ip:8084/v1/servers/self
```
เลื่อนระดับโหนดสแตนด์บายของระบบปฏิบัติการที่อัปเกรดใหม่ให้เป็นโหนดหลัก

หยุด Postgres ในมาสเตอร์ที่มีอยู่

apigee-service apigee-postgresql stop

apigee-service edge-postgres-server stop

เลื่อนระดับโหนดสแตนด์บายใหม่เป็นโหนดหลัก
```
apigee-service apigee-postgresql promote-standby-to-master EXISTING_PG_MASTER_IP
```
นำโหนดหลักเก่าออกจากกลุ่มการวิเคราะห์และกลุ่มผู้บริโภค
เพิ่มโหนดหลักใหม่ลงในกลุ่มข้อมูลวิเคราะห์และกลุ่มผู้บริโภค
หากใช้การสร้างรายได้ ให้อัปเดตโหนดมาสเตอร์ Postgres ใหม่และทำตามขั้นตอนต่อไปนี้
เมื่อเปลี่ยนโหนดหลักแล้ว คุณจะเริ่ม edge-qpid-server ด้วยการกำหนดค่าโหนดหลักที่อัปเดตแล้วได้โดยทำดังนี้
```
apigee-service edge-qpid-server start
```
หากคุณใช้การสร้างรายได้ ให้รีสตาร์ท Management Server และ Message Processor ด้วย โดยทำดังนี้
```
apigee-service edge-management-server restart
```
หยุดและถอนการติดตั้ง apigee-postgres และ postgres-server ในมาสเตอร์เครื่องเก่า
```
apigee-service edge-postgres-server uninstall
```
```
apigee-service apigee-postgresql uninstall
```

การเพิ่มสแตนด์บายใหม่

จัดหาโหนดใหม่ด้วยระบบปฏิบัติการที่อัปเกรดแล้ว
ใช้ข้อกำหนดเบื้องต้นเฉพาะระบบปฏิบัติการ
ดาวน์โหลด Bootstrap ของ Apigee เวอร์ชันที่ใช้งานอยู่ เรียกใช้ Bootstrap เพื่อรับ apigee-service และติดตั้ง apigee-setup
ตั้งค่าการจำลองแบบหลัก-สแตนด์บายโดยใช้ IP หลักใหม่และ IP ของโหนดสแตนด์บายใหม่ในไฟล์การกำหนดค่าของโหนดหลักใหม่และโหนดสแตนด์บายใหม่ ดูรายละเอียดเพิ่มเติมได้ที่ข้อมูลอ้างอิงไฟล์การกำหนดค่า
```
apigee-service apigee-postgresql setup-replication-on-master -f updatedConfigFile
```
ติดตั้งและตั้งค่าในโหนดสแตนด์บายใหม่
```
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f updatedConfigFile
```
เพิ่มสแตนด์บายใหม่ลงในกลุ่มการวิเคราะห์โดยทำตามขั้นตอนการตั้งค่ามาสเตอร์-สแตนด์บาย
หมายเหตุ: ขณะเพิ่มโหนดสแตนด์บายใหม่ลงในกลุ่มการวิเคราะห์ โปรดตรวจสอบว่าได้นำ Postgres ที่มีอยู่ออกก่อน แล้วจึงเพิ่มกลับพร้อมกับสแตนด์บาย

LDAP

การแทนที่โหนด LDAP จะทำให้เซิร์ฟเวอร์การจัดการหยุดทำงาน และ API การจัดการใดๆ จะถือว่าไม่พร้อมใช้งานในช่วงเวลาที่มีการแทนที่โหนดนี้

หยุดเซิร์ฟเวอร์การจัดการในโหนดทั้งหมด
```
apigee-service edge-management-server stop
```
การเลิกใช้งานโหนด LDAP ที่มีอยู่
หมายเหตุ: หากใช้เวอร์ชัน 4.53.01 ขึ้นไป โปรดใช้ mdb ในการกำหนดค่า LDAP หากใช้เวอร์ชัน 4.53.00 หรือต่ำกว่า ให้ตรวจสอบว่าได้ใช้ bdb ในการกำหนดค่า LDAP
1. ทำการสำรองข้อมูล/สแนปชอตระดับ VM ของโหนด LDAP
2. ก่อนหยุด LDAP ให้บันทึกจำนวนข้อมูล LDAP ซึ่งสามารถยืนยันได้ในภายหลัง เช่น
```
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" -D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w Secret123 | wc -l
```
3. สำหรับการตั้งค่าแบบแอ็กทีฟ-พาสซีฟ ให้ทำดังนี้
  1. เปลี่ยนสถานะจาก "ไม่ได้ใช้งาน" เป็น "ใช้งาน" โดยเพิ่มไฟล์ mark_writable.ldif ในโหนดที่ไม่ได้ใช้งานที่มีเนื้อหาต่อไปนี้
```
dn: olcDatabase={2}bdb,cn=config
changetype: modify
replace: olcReadOnly
olcReadOnly: FALSE
```
  2. เรียกใช้คำสั่งต่อไปนี้ในโหนดแบบพาสซีฟเพื่อให้โหนดทำงาน
```
ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_writable.ldif
```
  3. ทำตามขั้นตอนที่ ง) ต่อไปสำหรับ Active-Active เพื่อเลิกใช้งานโหนด
4. ในการตั้งค่า LDAP แบบ Active-Active ให้หยุดการจำลองแบบระหว่างโหนด LDAP ทั้ง 2 โหนดและอัปเดตการกำหนดค่า ทำตามขั้นตอนที่ระบุไว้ในเอกสารการเลิกใช้งาน LDAP
5. หยุดและสำรองข้อมูล LDAP แล้วถอนการติดตั้งโหนด LDAP ที่มีอยู่ (ข้ามไปสำหรับการตั้งค่าแบบ Active-Active หากดำเนินการแล้ว)
```
apigee-service apigee-openldap stop
```
```
apigee-service apigee-openldap backup
```
```
apigee-service apigee-openldap uninstall
```
จัดหาโหนดใหม่ด้วยระบบปฏิบัติการที่อัปเกรดแล้ว
ใช้ข้อกำหนดเบื้องต้นเฉพาะระบบปฏิบัติการ
ดาวน์โหลด Bootstrap ของ Apigee เวอร์ชันที่ใช้งานอยู่ เรียกใช้ Bootstrap เพื่อรับ apigee-service และติดตั้ง apigee-setup
ตั้งค่าโหนด LDAP ใหม่
1. อัปเดต configFile สำหรับโหนดใหม่ตามการตั้งค่า โดยคุณสามารถดูข้อมูลอ้างอิงไฟล์การกำหนดค่า Edge สำหรับการตั้งค่าที่ใช้งานอยู่เท่านั้นหรือการตั้งค่าที่ใช้งานอยู่-ใช้งานอยู่ได้ดังนี้
  - LDAP_TYPE
  - LDAP_PEER
  - LDAP_SID
  - USE_LDAP_REMOTE_HOST=y/n
    หมายเหตุ: ตั้งค่า USE_LDAP_REMOTE_HOST เป็น "y" หรือ "n" โดยขึ้นอยู่กับว่าได้กำหนดค่า LDAP ในโหนดเดียวกับเซิร์ฟเวอร์การจัดการหรือไม่
2. ตั้งค่าและเริ่ม LDAP ในโหนดใหม่ด้วย updatedConfigFile โดยทำดังนี้
```
/opt/apigee/apigee-setup/bin/setup.sh -p ld -f updatedConfigFile
```
3. สำรองข้อมูล LDAP จากโหนดเก่า (หากข้ามการตั้งค่า Active-Active ได้) ดังนี้
  1. สร้างข้อมูลสำรองตัวอย่างในโหนดใหม่เพื่อให้ระบบสร้างโฟลเดอร์/เส้นทางสำรองเริ่มต้น
```
apigee-service apigee-openldap backup
```
  2. ย้ายข้อมูลที่สำรองไว้จากโหนดเก่าไปยังโฟลเดอร์สำรองที่สร้างขึ้น
  3. หยุด apigee-openldap ก่อนกู้คืนข้อมูล
```
apigee-service apigee-openldap stop
```
  4. กู้คืนข้อมูลสำรองที่นำมาจากโหนดรุ่นเก่า
```
apigee-service apigee-openldap restore backup_file
```
    เช่น
```
apigee-service apigee-openldap restore 2026.02.09,10.28.20
```
ทำซ้ำสำหรับโหนด LDAP อื่นๆ (หากเป็นแบบใช้งานพร้อมกัน)
ตั้งค่าใหม่และเริ่มเซิร์ฟเวอร์การจัดการด้วยการกำหนดค่าโฮสต์ LDAP ที่อัปเดตแล้ว
```
/opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
```
ตั้งค่าและเริ่มใช้ SSO อีกครั้ง (หากมี)
```
apigee-service apigee-sso setup -f updatedConfigFile
```
```
apigee-service apigee-sso restart
```
(ไม่บังคับ) กำหนดค่า Active Directory ที่ 2 เป็นแบบอ่านอย่างเดียวโดยทำตามขั้นตอนในเอกสารประกอบ

Qpid

หากต้องการแทนที่โหนด Qpid ที่มีอยู่ด้วยโหนด OS ที่อัปเกรดแล้ว เราต้องตรวจสอบขั้นตอนต่อไปนี้

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

การเลิกใช้งานโหนดที่มีอยู่ เราได้ระบุมาตรการเพิ่มเติมไว้ด้านล่างเพื่อให้มั่นใจว่าข้อความจะไม่สูญหาย

หยุด Qpid Broker
```
apigee-service apigee-qpidd stop
```
บล็อกการรับส่งข้อมูลขาเข้าในพอร์ต 5672 จาก Message Processor ทั้งหมด
```
iptables -A INPUT -p tcp --dport 5672 -s MP_IP -j DROP
```
เริ่ม Qpid Broker อีกครั้งเพื่อล้างข้อความที่มีอยู่
```
apigee-service apigee-qpidd start
```
ตรวจสอบว่าข้อความทั้งหมดในคิวถูกส่งไปยังผู้ใช้แล้วก่อนที่จะเริ่มเลิกใช้งาน
รับ UUID ของโหนด edge-qpid-server
```
curl http://qpid_node_ip:8083/v1/servers/self
```
ทำตามขั้นตอนการเลิกใช้งานหรือนำ Qpid ออกจากข้อมูลวิเคราะห์สำหรับ apigee-qpidd และ edge-qpid-server

หยุดและถอนการติดตั้งทั้ง apigee-qpidd และ edge-qpid-server โดยทำดังนี้

apigee-service apigee-qpidd stop

apigee-service edge-qpid-server stop

apigee-service apigee-qpidd uninstall

apigee-service edge-qpid-server uninstall

เพิ่มโหนดใหม่

จัดหาโหนดใหม่ด้วยระบบปฏิบัติการที่อัปเกรดแล้ว
ใช้ข้อกำหนดเบื้องต้นเฉพาะระบบปฏิบัติการ
ดาวน์โหลด Bootstrap ของ Apigee เวอร์ชันที่ใช้งานอยู่ เรียกใช้ Bootstrap เพื่อรับ apigee-service และติดตั้ง apigee-setup
ตั้งค่าและเรียกใช้บริการ Qpid ในโหนดใหม่ แล้วเพิ่มบริการเหล่านี้ลงในกลุ่มผู้ใช้โดยทำตามขั้นตอนเหล่านี้ ลองทำตามขั้นตอนเดียวกันเพื่อเพิ่มกลุ่มอื่นๆ เช่น กลุ่มสำหรับการสร้างรายได้
หากเปิดใช้บริการการสร้างรายได้ ให้รีสตาร์ท Management Server และ Message Processor
```
apigee-service edge-management-server restart
```
```
apigee-service edge-message-processor restart
```
ทำซ้ำในโหนด Qpid ทั้งหมด

Message-processor

รับ UUID ของโหนด edge-message-processor
```
curl http://mp_ip:8082/v1/servers/self
```
เลิกใช้งานและถอนการติดตั้งโหนด Message Processor
หากเปิดใช้บริการการสร้างรายได้ ให้ถอนการติดตั้ง edge-mint-message-processor
วิธีถอนการติดตั้ง Message Processor
```
apigee-service edge-message-processor uninstall
```
จัดหาโหนดใหม่ด้วยระบบปฏิบัติการที่อัปเกรดแล้ว
ใช้ข้อกำหนดเบื้องต้นเฉพาะระบบปฏิบัติการ
ดาวน์โหลด Bootstrap ของ Apigee เวอร์ชันที่ใช้งานอยู่ เรียกใช้ Bootstrap เพื่อรับ apigee-service และติดตั้ง apigee-setup
เพิ่ม ตั้งค่า และเริ่ม Message Processor ไปยังคลัสเตอร์โดยทำตามขั้นตอน
หากเปิดใช้การสร้างรายได้ ให้ตั้งค่าบริการการสร้างรายได้พร้อมกับ Message Processor ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบต่อไปนี้

เราเตอร์

รับ UUID ของโหนด edge-router
```
curl http://router_ip:8081/v1/servers/self
```
ปิดใช้ความสามารถในการเข้าถึงและยืนยันว่าเข้าถึงได้หรือไม่
```
iptables -A INPUT -i eth0 -p tcp --dport 15999 -j REJECT
```
```
curl -vvv -X GET http://router_ip:15999/v1/servers/self/reachable
```
เลิกใช้งานและถอนการติดตั้งโหนดเราเตอร์
ถอนการติดตั้งเราเตอร์
```
apigee-service edge-router uninstall
```
จัดหาโหนดใหม่ด้วยระบบปฏิบัติการที่อัปเกรดแล้ว
ใช้ข้อกำหนดเบื้องต้นเฉพาะระบบปฏิบัติการ
ดาวน์โหลด Bootstrap ของ Apigee เวอร์ชันที่ใช้งานอยู่ เรียกใช้ Bootstrap เพื่อรับ apigee-service และติดตั้ง apigee-setup
เพิ่ม ตั้งค่า และเริ่มเราเตอร์ไปยังคลัสเตอร์

เซิร์ฟเวอร์การจัดการ

เซิร์ฟเวอร์การจัดการเดียวเท่านั้น

จัดหาโหนดใหม่ด้วยระบบปฏิบัติการที่อัปเกรดแล้ว
ใช้ข้อกำหนดเบื้องต้นเฉพาะระบบปฏิบัติการ
ดาวน์โหลด Bootstrap ของ Apigee เวอร์ชันที่ใช้งานอยู่ เรียกใช้ Bootstrap เพื่อรับ apigee-service และติดตั้ง apigee-setup
เพิ่มเซิร์ฟเวอร์การจัดการโดยใช้ IP และไฟล์การกำหนดค่าที่อัปเดตแล้ว ซึ่งดูได้จากที่นี่ แล้วเรียกใช้คำสั่งการตั้งค่า
```
/opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
```
ตั้งค่าใหม่และรีสตาร์ท UI ด้วยการกำหนดค่า IP การจัดการใหม่
```
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
```
ตั้งค่า SSO อีกครั้งด้วยการกำหนดค่า IP การจัดการใหม่ (หากมี)
```
/opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
```
ตั้งค่า UI (UE) ใหม่ด้วยการกำหนดค่า IP การจัดการใหม่ (หากมี)
```
/opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile
```
หากเปิดใช้การสร้างรายได้แล้ว ให้ทำดังนี้
1. ตั้งค่าการสร้างรายได้ MS ใหม่ด้วยการกำหนดค่า IP การจัดการใหม่ (หากมี) โดยดูเอกสารประกอบการกำหนดค่าการสร้างรายได้
```
/opt/apigee/apigee-setup/bin/setup.sh -p mo -f updatedConfigFile
```
2. รีสตาร์ทเซิร์ฟเวอร์การจัดการ
```
apigee-service edge-management-server restart
```
เลิกใช้งานเซิร์ฟเวอร์การจัดการในโหนดที่มีอยู่/เก่าโดยทำตามขั้นตอน
หากเปิดใช้การสร้างรายได้ ให้นำ UUID ของเซิร์ฟเวอร์การจัดการออกจากกลุ่มข้อมูลวิเคราะห์ ตัวอย่าง
```
curl -v -u AdminEmail:AdminPassword -X DELETE "http://localhost:8080/v1/analytics/groups/ax/mint_axgroup/servers?uuid=MS_UUID&type=consumer-server"
```
ถอนการติดตั้งเซิร์ฟเวอร์การจัดการการสร้างรายได้
```
apigee-service edge-mint-management-server uninstall
```

เซิร์ฟเวอร์การจัดการหลายเซิร์ฟเวอร์

เลิกใช้งานเซิร์ฟเวอร์การจัดการเครื่องใดเครื่องหนึ่งโดยใช้เซิร์ฟเวอร์อีกเครื่องในโหนดที่มีอยู่โดยทำตามขั้นตอน
หยุดและถอนการติดตั้งเซิร์ฟเวอร์การจัดการ
```
apigee-service edge-management-server stop
```
```
apigee-service edge-management-server uninstall
```
จัดหาโหนดใหม่ด้วยระบบปฏิบัติการที่อัปเกรดแล้ว
ใช้ข้อกำหนดเบื้องต้นเฉพาะระบบปฏิบัติการ
ดาวน์โหลด Bootstrap ของ Apigee เวอร์ชันที่ใช้งานอยู่ เรียกใช้ Bootstrap เพื่อรับ apigee-service และติดตั้ง apigee-setup
เพิ่มเซิร์ฟเวอร์การจัดการโดยใช้ IP และไฟล์การกำหนดค่าที่อัปเดตแล้ว ซึ่งดูได้จากที่นี่ แล้วเรียกใช้คำสั่งการตั้งค่า
```
/opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
```
ตั้งค่าและรีสตาร์ท UI อีกครั้งด้วยการกำหนดค่า IP การจัดการที่อัปเดตแล้ว
```
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
```
(เฉพาะในกรณีที่เปิดใช้ SSO) ตั้งค่าและรีสตาร์ท SSO ด้วยการกำหนดค่า IP การจัดการที่อัปเดตแล้ว
```
/opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
```
(เฉพาะในกรณีที่เปิดใช้ UI ใหม่) ตั้งค่าและรีสตาร์ท UI ใหม่ด้วยการกำหนดค่า IP การจัดการที่อัปเดตแล้ว
```
/opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile
```
ทำซ้ำสำหรับเซิร์ฟเวอร์การจัดการอื่นๆ

UI/UE

ถ่ายข้อมูลสำรอง/สแนปชอต VM ของโหนด UI

หยุดและถอนการติดตั้ง UI

apigee-service edge-ui stop

apigee-service edge-ui uninstall

(หากใช้ UI ใหม่เท่านั้น) หยุดและถอนการติดตั้ง UI ใหม่โดยทำดังนี้
```
apigee-service edge-management-ui stop
```
```
apigee-service edge-management-ui uninstall
```
จัดหาโหนดใหม่ด้วยระบบปฏิบัติการที่อัปเกรดแล้ว
ใช้ข้อกำหนดเบื้องต้นเฉพาะระบบปฏิบัติการ
ดาวน์โหลด Bootstrap ของ Apigee เวอร์ชันที่ใช้งานอยู่ เรียกใช้ Bootstrap เพื่อรับ apigee-service และติดตั้ง apigee-setup
ตั้งค่าและเรียกใช้ edge-ui ในโหนดใหม่โดยใช้การกำหนดค่า IP ที่อัปเดตแล้ว
```
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
```
(เฉพาะในกรณีที่เปิดใช้ SSO) ตั้งค่าและเรียกใช้ SSO อีกครั้งด้วยการกำหนดค่า IP ของโหนดใหม่ใน UI ตามความเหมาะสม
```
/opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
```
(เฉพาะในกรณีที่เปิดใช้ UI ใหม่) ตั้งค่าและเรียกใช้ UI ใหม่ในโหนดใหม่ด้วยการกำหนดค่า IP ที่อัปเดตแล้ว
```
/opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile
```
```
apigee-service edge-management-ui configure-sso -f updatedConfigFile
```
```
apigee-service edge-ui configure-sso -f updatedConfigFile
```

SSO

ถ่ายข้อมูลสำรอง/สแนปชอต VM ของโหนด UI
วิธีหยุดและถอนการติดตั้ง SSO
```
apigee-service apigee-sso stop
```
```
apigee-service apigee-sso uninstall
```
จัดหาโหนดใหม่ด้วยระบบปฏิบัติการที่อัปเกรดแล้ว
ใช้ข้อกำหนดเบื้องต้นเฉพาะระบบปฏิบัติการ
ดาวน์โหลด Bootstrap ของ Apigee เวอร์ชันที่ใช้งานอยู่ เรียกใช้ Bootstrap เพื่อรับ apigee-service และติดตั้ง apigee-setup
เพิ่มการกำหนดค่าและคีย์สำหรับ SSO ตามคำแนะนำ โดยพิจารณา IP ของโหนดใหม่

ตั้งค่าและเริ่มใช้ SSO

/opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile

อัปเดตการกำหนดค่าด้วย IP ของโหนด SSO ใหม่และกำหนดค่า SSO สำหรับ UI อีกครั้ง
```
apigee-service edge-ui configure-sso -f updatedConfigFile
```
(หากใช้ UI ใหม่) เรียกใช้ configure-sso ในโหนด UI ใหม่ โดยอ้างอิงเอกสารประกอบ
```
apigee-service edge-management-ui configure-sso -f updatedConfigFile
```
```
apigee-service edge-ui configure-sso -f updatedConfigFile
```