Apigee รองรับการอัปเกรด Edge สำหรับ Private Cloud จากเวอร์ชัน 4.50.00 หรือเวอร์ชัน 4.51.00 เป็นเวอร์ชัน 4.52.00 โดยตรง หน้านี้อธิบายวิธีการอัปเกรด
ผู้ที่มีสิทธิ์ดำเนินการอัปเดต
บุคคลที่ดำเนินการอัปเดตควรเป็นบุคคลเดียวกับผู้ที่ติดตั้ง Edge ตั้งแต่ต้น หรือผู้ที่ดำเนินการในฐานะรูท
หลังจากติดตั้ง Edge RPM แล้ว ทุกคนจะกําหนดค่าได้
คอมโพเนนต์ที่ต้องอัปเดต
คุณต้องอัปเดตคอมโพเนนต์ Edge ทั้งหมด Edge ไม่รองรับการตั้งค่าที่มีคอมโพเนนต์จากหลายเวอร์ชัน
อัปเดตข้อกำหนดเบื้องต้น
โปรดตรวจสอบข้อกำหนดเบื้องต้นต่อไปนี้ก่อนอัปเกรด Apigee Edge
- สำรองข้อมูลโหนดทั้งหมด
ก่อนที่จะอัปเดต เราขอแนะนำให้คุณสำรองข้อมูลโหนดทั้งหมดให้ครบถ้วนเพื่อเหตุผลด้านความปลอดภัย ใช้ขั้นตอนสำหรับ Edge เวอร์ชันปัจจุบันเพื่อสำรองข้อมูลซึ่งจะช่วยให้คุณมีแผนสำรองได้ในกรณีที่การอัปเดตเป็นเวอร์ชันใหม่ทำงานไม่ถูกต้อง ดูข้อมูลเพิ่มเติมเกี่ยวกับการสำรองข้อมูลได้ที่การสำรองและคืนค่า
- ตรวจสอบว่า Edge ทำงานอยู่
ตรวจสอบว่า Edge ทำงานอยู่ในระหว่างขั้นตอนการอัปเดตโดยใช้คำสั่งต่อไปนี้/opt/apigee/apigee-service/bin/apigee-all status
- ตรวจสอบว่ากลยุทธ์การทำให้ Cassandra เสร็จสมบูรณ์คือ
LeveledCompactionStrategy
ตรวจสอบว่าได้ตั้งค่ากลยุทธ์ความเข้ากันได้ของ Cassandra เป็นLeveledCompactionStrategy
ตามที่อธิบายไว้ใน เปลี่ยนกลยุทธ์การคอมไพล์ของ Cassandra
การเผยแพร่การตั้งค่าพร็อพเพอร์ตี้โดยอัตโนมัติ
หากคุณตั้งค่าพร็อพเพอร์ตี้โดยแก้ไขไฟล์ .properties
ใน /opt/apigee/customer/application
การอัปเดตจะเก็บรักษาค่าเหล่านี้ไว้
ต้องอัปเกรดเป็น Zookeeper 3.8.0
Edge for Private Cloud รุ่นนี้มีการอัปเกรดเป็น Zookeeper 3.8.0 จากการอัปเกรดดังกล่าว ข้อมูล Zookeeper ทั้งหมดจะถูกย้ายไปยัง Zookeeper 3.8.0
ก่อนอัปเกรด Zookeeper โปรดอ่านคู่มือการบำรุงรักษา Zookeeper ระบบที่ใช้งานจริงของ Edge ส่วนใหญ่ใช้คลัสเตอร์ของโหนด Zookeeper กระจายอยู่ในศูนย์ข้อมูลหลายแห่ง โหนดเหล่านี้บางส่วนได้รับการกำหนดค่าเป็นผู้มีสิทธิเลือกตั้งที่เข้าร่วมการเลือกตั้งหัวหน้าผู้ดูแลสวนสัตว์ และโหนดที่เหลือได้รับการกำหนดค่าเป็นผู้สังเกตการณ์ ดูรายละเอียดเพิ่มเติมได้ที่ เกี่ยวกับผู้นำ ผู้ติดตาม ผู้โหวต และผู้สังเกตการณ์ โหนดของผู้มีสิทธิเลือกตั้ง จะเลือกผู้นำ หลังจากนั้นโหนดผู้มีสิทธิเลือกตั้งจะกลายเป็นผู้ติดตาม
ระหว่างกระบวนการอัปเดต อาจเกิดความล่าช้าชั่วขณะหรือการเขียนไปยัง Zookeeper ไม่สําเร็จเมื่อโหนดของ Leader ปิดอยู่ ซึ่งอาจส่งผลกระทบต่อการดำเนินการจัดการที่เขียนลงใน Zookeeper เช่น การดำเนินการทำให้พร็อกซีใช้งานได้ และการเปลี่ยนแปลงโครงสร้างพื้นฐานของ Apigee เช่น การเพิ่มหรือนำผู้ประมวลผลข้อความออก เป็นต้น ทั้งนี้ API แบบรันไทม์ของ Apigee จะไม่ได้รับผลกระทบจากรันไทม์ (เว้นแต่ API รันไทม์ API เหล่านี้จะเรียกใช้) ระหว่างการอัปเกรด Zookeeper ขณะที่ทำตามขั้นตอนด้านล่าง
กระบวนการอัปเกรดจะมีการสำรองข้อมูลแต่ละโหนดในระดับสูง ตามด้วยการอัปเกรดผู้สังเกตการณ์และผู้ติดตามทั้งหมด และสุดท้ายคือการอัปเกรดโหนดของผู้นำ
สำรองข้อมูล
สำรองข้อมูลโหนดทั้งหมดของ Zookeeper เพื่อใช้งานในกรณีที่ต้องย้อนกลับ โปรดทราบว่าการย้อนกลับจะคืนค่า Zookeeper เป็นสถานะเมื่อมีการสำรองข้อมูล หมายเหตุ: การทำให้ใช้งานได้หรือการเปลี่ยนแปลงโครงสร้างพื้นฐานใน Apigee ตั้งแต่มีการสำรองข้อมูล (ข้อมูลที่จัดเก็บไว้ใน Zookeeper) จะสูญหายระหว่างการกู้คืน
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup
หากคุณใช้เครื่องเสมือนและมีความสามารถนี้ ระบบอาจใช้สแนปชอตหรือข้อมูลสำรอง VM เพื่อกู้คืนหรือย้อนกลับด้วย (หากจำเป็น)
ระบุผู้นำ ผู้ติดตาม และผู้สังเกตการณ์
หมายเหตุ: คำสั่งตัวอย่างด้านล่างใช้ ยูทิลิตี nc เพื่อส่งข้อมูลไปยัง Zookeeper คุณสามารถใช้ยูทิลิตีอื่นเพื่อส่งข้อมูลไปยัง Zookeeper ได้เช่นกัน
- หากไม่ได้ติดตั้งในโหนด ZooKeeper ให้ติดตั้ง nc:
sudo yum install nc
- เรียกใช้คำสั่ง nc ต่อไปนี้ในโหนด โดยที่ 2181 คือพอร์ต ZooKeeper:
echo stat | nc localhost 2181
คุณควรเห็นเอาต์พุตดังนี้
Zookeeper version: 3.8.0-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC Clients: /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0) Latency min/avg/max: 0/0.2518/41 Received: 647228 Sent: 647339 Connections: 4 Outstanding: 0 Zxid: 0x400018b15 Mode: follower Node count: 100597
ในบรรทัด
Mode
ของเอาต์พุตสำหรับโหนด คุณควรเห็นผู้สังเกตการณ์ ผู้นำ หรือผู้ติดตาม (หมายถึงผู้โหวตที่ไม่ใช่ผู้นำ) ทั้งนี้ขึ้นอยู่กับการกำหนดค่าโหนด หมายเหตุ: ในการติดตั้ง Edge แบบสแตนด์อโลนที่มีโหนด ZooKeeper เดียว ระบบจะตั้งค่าMode
เป็นแบบสแตนด์อโลน - ทำซ้ำขั้นตอนที่ 1 และ 2 ในโหนด ZooKeeper แต่ละโหนด
อัปเกรด Zookeeper บนโหนดผู้สังเกตการณ์และโหนดผู้ติดตาม
อัปเกรด Zookeeper ในโหนดผู้สังเกตการณ์และโหนดผู้ติดตามแต่ละโหนดดังนี้
- ดาวน์โหลดและเรียกใช้ Bootstrapped ของ Edge สำหรับ Private Cloud 4.52 ตามที่อธิบายไว้ใน อัปเดตเป็น 4.52.00 บนโหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก กระบวนการอาจแตกต่างออกไปโดยขึ้นอยู่กับว่าโหนดมีการเชื่อมต่ออินเทอร์เน็ตภายนอกหรือคุณกำลังติดตั้งแบบออฟไลน์
- อัปเกรดคอมโพเนนต์ Zookeeper:
/opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
หมายเหตุ: หากโหนดเหล่านี้มีการติดตั้งคอมโพเนนต์อื่นๆ (เช่น Cassandra) คุณจะอัปเกรดได้ด้วย (เช่น โปรไฟล์ cs,zk) หรืออัปเกรดคอมโพเนนต์อื่นๆ ในภายหลังก็ได้ Apigee ขอแนะนำให้คุณอัปเกรด Zookeeper ก่อนเท่านั้นและตรวจสอบว่าคลัสเตอร์ทำงานได้อย่างถูกต้องก่อนที่จะอัปเกรดคอมโพเนนต์อื่นๆ - ทำขั้นตอนข้างต้นซ้ำกับผู้สังเกตการณ์ Zookeeper และโหนดผู้ติดตามแต่ละรายการ
ปิดผู้นำ
เมื่ออัปเกรดโหนดผู้สังเกตการณ์และผู้ติดตามทั้งหมดแล้ว ให้ปิดตัวนำ ในโหนดที่ระบุว่าเป็นผู้นำ ให้เรียกใช้คำสั่งด้านล่าง:
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
โปรดทราบว่าในระหว่างกิจกรรมนี้ ก่อนจะมีการเลือกตั้งผู้นำคนใหม่ อาจมีความล่าช้าหรือการเขียนไม่สำเร็จชั่วคราวใน Zookeeper ซึ่งอาจส่งผลต่อการดำเนินการที่เขียนลงใน Zookeeper เช่น การดำเนินการทำให้พร็อกซีใช้งานได้หรือการเปลี่ยนแปลงโครงสร้างพื้นฐานของ Apigee เช่น การเพิ่มหรือนำผู้ประมวลผลข้อความออก ฯลฯ
ยืนยันว่าได้รับเลือกผู้นำคนใหม่
ใช้ขั้นตอนในส่วนระบุผู้นำ ผู้ติดตาม และผู้สังเกตการณ์ด้านบนเพื่อยืนยันว่าผู้นำคนใหม่ได้รับเลือกจากผู้ติดตามเมื่อผู้นำปัจจุบันหยุดลงแล้ว โปรดทราบว่าผู้นำอาจได้รับเลือกในศูนย์ข้อมูลที่ต่างจากผู้นำคนปัจจุบัน
อัปเกรดผู้นำ
ทำตามขั้นตอนเดียวกับใน การอัปเกรด Zookeeper บนโหนดผู้สังเกตและผู้ติดตามด้านบน
เมื่อโหนดผู้นำเดิมได้รับการอัปเกรดแล้ว ให้ยืนยันประสิทธิภาพของคลัสเตอร์และตรวจสอบว่ามีโหนดผู้นำ
ย้อนกลับ
ในกรณีที่ต้องย้อนกลับ ให้ทำดังนี้
- ทำขั้นตอนย้อนกลับกับผู้สังเกตการณ์และผู้ติดตามก่อน
- ดาวน์โหลดและเรียกใช้ Bootstrapped ของเวอร์ชันที่คุณกำลังย้อนกลับไปยังเวอร์ชัน 4.50 หรือ 4.51 กระบวนการอาจแตกต่างกันออกไป โดยขึ้นอยู่กับว่าโหนดมีการเชื่อมต่ออินเทอร์เน็ตภายนอกหรือคุณกำลังติดตามการติดตั้งแบบออฟไลน์
- หยุด Zookeeper หากทำงานอยู่ในโหนด:
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
- ถอนการติดตั้งผู้ดูแลสวนสัตว์ที่มีอยู่:
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall
/opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>
กู้คืนข้อมูลสำรอง
โปรดดูหัวข้อกู้คืนจากข้อมูลสำรอง โปรดทราบว่าข้อมูลสำรองของ Zookeeper ที่นำมาจาก Edge เวอร์ชันก่อนหน้าสำหรับ Private Cloud เช่น 4.50 และ 4.51 ควรเข้ากันได้กับเวอร์ชันของ Zookeeper ใน Edge สำหรับ Private Cloud 4.52
ต้องอัปเกรดเป็น Postgres 14
Edge รุ่นนี้มีการอัปเกรดเป็น Postgres 14 จากการอัปเกรดดังกล่าว ระบบจะย้ายข้อมูล Postgres ทั้งหมดไปยัง Postgres 14
ระบบที่ใช้งานจริง Edge ส่วนใหญ่ใช้โหนด Postgres 2 โหนดที่กำหนดค่าไว้สำหรับการจำลองในโหมด Master- Standby ในระหว่างขั้นตอนการอัปเดต ขณะที่โหนด Postgres ไม่ทำงานเพื่อการอัปเดต แต่ข้อมูลวิเคราะห์จะยังคงเขียนไปยังโหนด Qpid หลังจากอัปเดตโหนด Postgres และกลับมาออนไลน์แล้ว ระบบจะพุชข้อมูลวิเคราะห์ไปยังโหนด Postgres
วิธีดำเนินการอัปเดต Postgres จะขึ้นอยู่กับวิธีที่คุณกำหนดค่าพื้นที่เก็บข้อมูลสำหรับโหนด Postgres ดังนี้
- หากคุณใช้พื้นที่เก็บข้อมูลในเครื่องสำหรับโหนด Postgres คุณต้องติดตั้งโหนด Postgres ใหม่ในโหมดสแตนด์บายตลอดระยะเวลาการอัปเกรด หลังจากการอัปเกรดเสร็จสมบูรณ์ คุณจะปิดใช้งานโหนด Postgres ใหม่ในโหมดสแตนด์บายได้
ต้องระบุโหนดสแตนด์บาย Postgres เพิ่มเติมหากคุณย้อนกลับการอัปเดตไม่ว่าด้วยเหตุผลใดก็ตาม หากคุณต้องย้อนกลับการอัปเดต โหนดสแตนด์บาย Postgres ใหม่จะกลายเป็นโหนด Postgres หลักหลังจากย้อนกลับ ดังนั้นเมื่อติดตั้งโหนดสแตนด์บาย Postgres ใหม่ โหนดดังกล่าวควรอยู่ในโหนดที่ตรงตามข้อกำหนดด้านฮาร์ดแวร์ทั้งหมดของเซิร์ฟเวอร์ Postgres ตามที่ระบุไว้ในข้อกำหนดการติดตั้งของ Edge
ในการกำหนดค่า 1 โหนดและ 2 โหนดของ Edge ซึ่งเป็นโทโพโลยีที่ใช้สำหรับการสร้างต้นแบบและการทดสอบ คุณมีโหนด Postgres เพียงรายการเดียวเท่านั้น คุณอัปเดตโหนด Postgres เหล่านี้ได้โดยตรงโดยไม่ต้องสร้างโหนด Postgres ใหม่
- หากใช้พื้นที่เก็บข้อมูลเครือข่ายสำหรับโหนด Postgres ตามที่ Apigee แนะนำ คุณไม่จำเป็นต้องติดตั้งโหนด Postgres ใหม่ ในขั้นตอนด้านล่าง ให้ข้ามขั้นตอนที่ระบุให้ติดตั้งและยกเลิกการทำงานของโหนด Postgres ใหม่ในโหมดสแตนด์บายในภายหลัง
ก่อนเริ่มกระบวนการอัปเดต ให้ถ่ายสแนปชอตเครือข่ายของพื้นที่เก็บข้อมูลที่ใช้โดย Postgres จากนั้น หากเกิดข้อผิดพลาดระหว่างการอัปเดตและถูกบังคับให้ย้อนกลับ คุณจะกู้คืนโหนด Postgres จากสแนปชอตนั้นได้
การติดตั้งโหนด Postgres ใหม่ในโหมดสแตนด์บาย
ขั้นตอนนี้จะสร้างเซิร์ฟเวอร์ที่สแตนด์บาย Postgres บนโหนดใหม่ ตรวจสอบว่าคุณติดตั้งเซิร์ฟเวอร์ในโหมดสแตนด์บาย Postgres ใหม่สำหรับ Edge เวอร์ชันที่มีอยู่ (4.50.00 หรือ 4.51.00) ไม่ใช่สำหรับเวอร์ชัน 4.52.00
หากต้องการติดตั้ง ให้ใช้ไฟล์การกำหนดค่าเดียวกันกับที่คุณใช้ติดตั้ง Edge เวอร์ชันปัจจุบัน
วิธีสร้างโหนด Postgres ใหม่ในโหมดสแตนด์บาย
- ในต้นแบบ Postgres ปัจจุบัน ให้แก้ไขไฟล์
/opt/apigee/customer/application/postgresql.properties
เพื่อตั้งค่าโทเค็นต่อไปนี้ หากไม่มีไฟล์นั้นอยู่ ให้สร้างไฟล์โดยทำดังนี้conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust
โดยที่ existing_standby_ip คือที่อยู่ IP ของเซิร์ฟเวอร์ในโหมดสแตนด์บาย Postgres ปัจจุบัน และ new_standby_ip คือที่อยู่ IP ของโหนดสแตนด์บายใหม่
- รีสตาร์ท
apigee-postgresql
ในต้นแบบ Postgres:/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
- ตรวจสอบว่าได้เพิ่มโหนดสแตนด์บายใหม่โดยดูไฟล์
/opt/apigee/apigee-postgresql/conf/pg_hba.conf
ในต้นแบบ คุณควรจะเห็นบรรทัดต่อไปนี้ในไฟล์นั้นhost replication apigee existing_standby_ip/32 trust host replication apigee new_standby_ip/32 trust
- ติดตั้งเซิร์ฟเวอร์ในโหมดสแตนด์บาย Postgres ใหม่โดยทำดังนี้
- แก้ไขไฟล์การกำหนดค่าที่คุณใช้ติดตั้ง Edge เวอร์ชันปัจจุบันเพื่อระบุข้อมูลต่อไปนี้
# IP address of the current master: PG_MASTER=192.168.56.103 # IP address of the new standby node PG_STANDBY=192.168.56.102
- ปิดใช้ SELinux ตามที่อธิบายไว้ในติดตั้งยูทิลิตี Edge Apigee-setup
กรณีที่ใช้ Edge 4.51.00 มีดังนี้
- ดาวน์โหลดไฟล์ Edge Bootstrap_4.51.00.sh ไปยัง
/tmp/bootstrap_4.51.00.sh
:curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
- ติดตั้งยูทิลิตี Edge
apigee-service
และทรัพยากร Dependencysudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord
กรณีที่ใช้ Edge 4.50.00 มีดังนี้
- ดาวน์โหลดไฟล์ Edge bottrap_4.50.00.sh ไปยัง
/tmp/bootstrap_4.50.00.sh
:curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
- ติดตั้งยูทิลิตี Edge
apigee-service
และทรัพยากร Dependencysudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
- ดาวน์โหลดไฟล์ Edge Bootstrap_4.51.00.sh ไปยัง
- ใช้
apigee-service
เพื่อติดตั้งยูทิลิตีapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- ติดตั้ง Postgres:
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
- ในโหนดสแตนด์บายใหม่ ให้เรียกใช้คำสั่งต่อไปนี้:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
ตรวจสอบว่าเป็นอุปกรณ์ที่สแตนด์บายอยู่
- แก้ไขไฟล์การกำหนดค่าที่คุณใช้ติดตั้ง Edge เวอร์ชันปัจจุบันเพื่อระบุข้อมูลต่อไปนี้
ทำการอัปเกรด Postgres ด้วยตัวเอง
ขั้นตอนเบื้องต้น
ก่อนทำการอัปเกรดเป็น Postgres โดยตรง ให้ทำตามขั้นตอนต่อไปนี้กับทั้งโฮสต์หลักและสแตนด์บายเพื่ออัปเดตพร็อพเพอร์ตี้ max_locks_per_transaction
ใน apigee-postgresql
- หากไม่มี ให้สร้างไฟล์
/opt/apigee/customer/application/postgresql.properties
- เปลี่ยนการเป็นเจ้าของไฟล์นี้เป็น
apigee
:sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
- เพิ่มพร็อพเพอร์ตี้ต่อไปนี้ลงในไฟล์
conf/postgresql.conf+max_locks_per_transaction=30000
- กำหนดค่า
apigee-postgresql
:apigee-service apigee-postgresql configure
- รีสตาร์ท
apigee-postgresql
:apigee-service apigee-postgresql restart
ดำเนินการอัปเกรดโดยตรง
หากต้องการอัปเกรดเป็น Postgres 14 โดยตรง ให้ทําตามขั้นตอนต่อไปนี้
- อัปเกรด Postgres บนโฮสต์หลัก
/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
- เรียกใช้คำสั่งการตั้งค่าในโฮสต์หลัก:
apigee-service apigee-postgresql setup -f /opt/silent.conf
- เรียกใช้คำสั่งกำหนดค่าบนโฮสต์หลัก:
apigee-service apigee-postgresql configure
- รีสตาร์ทโฮสต์หลัก:
apigee-service apigee-postgresql restart
- กำหนดค่าเป็นต้นแบบ:
apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
- ตรวจสอบว่าโฮสต์หลักได้เริ่มต้นแล้ว:
apigee-service apigee-postgresql wait_for_ready
- หยุดสแตนด์บาย:
apigee-service apigee-postgresql stop
- อัปเกรดโหมดสแตนด์บาย
หมายเหตุ: คุณข้ามขั้นตอนดังกล่าวได้หากมีข้อผิดพลาด/ไม่สำเร็จ
update.sh
จะพยายามเริ่มเซิร์ฟเวอร์สแตนด์บายด้วยการกำหนดค่าที่ไม่ถูกต้อง หากการติดตั้ง Postgres อัปเกรดเป็น 14 ระบบจะไม่สนใจข้อผิดพลาดนี้/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
- ตรวจสอบว่าหยุดสแตนด์บายแล้ว:
apigee-service apigee-postgresql stop
- นำการกำหนดค่าโหมดสแตนด์บายเดิมออก:
rm -rf /opt/apigee/data/apigee-postgresql/
- ตั้งค่าการจำลองในเซิร์ฟเวอร์สแตนด์บาย:
apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf
- นำบรรทัด
conf/postgresql.conf+max_locks_per_transaction=30000
ออกจากไฟล์/opt/apigee/customer/application/postgresql.properties
ทั้งในโฮสต์หลักและสแตนด์บาย มีการเพิ่มบรรทัดนี้ในขั้นตอนเบื้องต้น
หลังจากทำขั้นตอนนี้เสร็จแล้ว การสแตนด์บายจะเริ่มต้นขึ้น
การเลิกใช้งานโหนด Postgres
หลังจากการอัปเดตเสร็จสมบูรณ์ ให้เลิกใช้โหนดสแตนด์บายใหม่:
- ตรวจสอบว่า Postgres ทำงานอยู่
/opt/apigee/apigee-service/bin/apigee-all status
หาก Postgres ไม่ทำงาน ให้เริ่มต้นดังนี้
/opt/apigee/apigee-service/bin/apigee-all start
- รับ UUID ของโหนดสแตนด์บายใหม่โดยเรียกใช้คำสั่ง
curl
ต่อไปนี้บนโหนดสแตนด์บายใหม่:curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
คุณควรเห็น UUID ของโหนดที่ส่วนท้ายของเอาต์พุตในรูปแบบ
"type" : [ "postgres-server" ], "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
- หยุดโหนดสแตนด์บายใหม่โดยเรียกใช้คำสั่งต่อไปนี้บนโหนดสแตนด์บายใหม่:
/opt/apigee/apigee-service/bin/apigee-all stop
- ในโหนดหลักของ Postgres ให้แก้ไข
/opt/apigee/customer/application/postgresql.properties
เพื่อนำโหนดสแตนด์บายใหม่จากconf_pg_hba_replication.connection
:conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
- รีสตาร์ท apigee-postgresql ในต้นแบบ Postgres:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
- ตรวจสอบว่าได้นำโหนดสแตนด์บายใหม่ออกโดยดูไฟล์
/opt/apigee/apigee-postgresql/conf/pg_hba.conf
ในโหนดหลัก คุณควรเห็นเฉพาะบรรทัดต่อไปนี้ในไฟล์นั้นhost replication apigee existing_standby_ip/32 trust
- ลบ UUID ของโหนดสแตนด์บายออกจาก ZooKeeper โดยเรียกใช้ Edge Management API ในโหนด Management Server:
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid
Edge UI ใหม่
ส่วนนี้แสดงข้อควรพิจารณาเกี่ยวกับ 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
ข้อมูลการอัปเดตการบันทึก
โดยค่าเริ่มต้น ยูทิลิตี 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 สำหรับเราเตอร์ที่เหลือ
- อัปเดตต่อไปสำหรับเครื่องที่เหลือที่ติดตั้ง
ดูแลสิ่งต่อไปนี้ทั้งก่อนและหลังการอัปเดต
- ในโหนดเราเตอร์แบบรวมและโหนดตัวประมวลผลข้อความ:
- ก่อนอัปเดต ให้ดำเนินการดังนี้
- ทำให้เข้าถึงเราเตอร์ไม่ได้
- ทำให้เข้าถึงเครื่องมือประมวลผลข้อความไม่ได้
- หลังจากอัปเดตแล้ว ให้ดำเนินการดังนี้
- ทำให้ผู้ประมวลผลข้อความติดต่อได้
- ทำให้เราเตอร์เข้าถึงได้
- ก่อนอัปเดต ให้ดำเนินการดังนี้
- ในโหนดเราเตอร์เดี่ยว
- ก่อนที่จะอัปเดต ให้ทำให้เข้าถึงเราเตอร์ไม่ได้
- หลังจากอัปเดตแล้ว ให้ทำให้เราเตอร์เข้าถึงได้
- ในโหนดของผู้ประมวลผลข้อมูลข้อความเดียว:
- ก่อนอัปเดต ให้ทำให้เข้าถึงเครื่องมือประมวลผลข้อความไม่ได้
- หลังจากการอัปเดต ให้ทำให้ผู้ประมวลผลข้อความติดต่อได้
ใช้ไฟล์การกำหนดค่าเงียบ
คุณต้องส่งไฟล์การกำหนดค่าเงียบไปยังคำสั่งการอัปเดต ไฟล์การกำหนดค่าเงียบควรเป็นไฟล์เดียวกับที่คุณใช้ติดตั้ง Edge 4.50.00 หรือ 4.51.00
อัปเดตเป็นเวอร์ชัน 4.52.00 บนโหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก
ใช้กระบวนการต่อไปนี้เพื่ออัปเดตคอมโพเนนต์ Edge ในโหนด
- หากมี ให้ปิดใช้งาน
cron
ที่กำหนดค่าเพื่อดำเนินการซ่อมแซมใน Cassandra จนกว่าการอัปเดตจะเสร็จสมบูรณ์ - เข้าสู่ระบบโหนดเป็นรูทเพื่อติดตั้ง Edge RPM
- ติดตั้ง
yum-utils
และyum-plugin-priorities
ดังนี้sudo yum install yum-utils
sudo yum install yum-plugin-priorities
- ปิดใช้ SELinux ตามที่อธิบายไว้ในติดตั้งยูทิลิตี Edge Apigee-setup
- หากจะติดตั้งบน 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 มีดังนี้
- ดาวน์โหลดไฟล์ Edge
bootstrap_4.52.00.sh
ไปยัง/tmp/bootstrap_4.52.00.sh
โดยทำดังนี้curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
- ติดตั้งยูทิลิตีและทรัพยากร Dependency ของ Edge 4.52.00
apigee-service
โดยใช้คำสั่งต่อไปนี้sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord
โดย uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณได้รับจาก Apigee หากไม่ระบุ pWord ระบบจะแจ้งให้คุณป้อน
โดยค่าเริ่มต้น โปรแกรมติดตั้งจะตรวจสอบว่าคุณมี Java 1.8 ติดตั้งอยู่ หากคุณไม่ได้ทำ โปรแกรมติดตั้งจะติดตั้งให้คุณ
ใช้ตัวเลือก
JAVA_FIX
เพื่อระบุวิธีจัดการการติดตั้ง JavaJAVA_FIX
ใช้ค่าต่อไปนี้I
: ติดตั้ง OpenJDK 1.8 (ค่าเริ่มต้น)C
: ดำเนินการต่อโดยไม่ติดตั้ง JavaQ
: ออก สำหรับตัวเลือกนี้ คุณต้องติดตั้ง Java ด้วยตนเอง
- ใช้
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, เซิร์ฟเวอร์ Postgresldap
: OpenLDAPps
: Postgresqlqpid
: qpiddsso
: Apigee SSO (หากคุณติดตั้ง SSO ไว้)ue
: UI ใหม่ Edgeui
: UI ของ Edge แบบคลาสสิกzk
: ผู้ดูแลสวนสัตว์
- 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
- component เป็นคอมโพเนนต์ Edge ที่จะอัปเดต ค่าที่เป็นไปได้ ได้แก่
- รีสตาร์ทคอมโพเนนต์ Edge UI ในโหนดทั้งหมดที่เรียกใช้คอมโพเนนต์ หากยังไม่ได้ดำเนินการ ให้ทำดังนี้
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- ทดสอบการอัปเดตโดยเรียกใช้ยูทิลิตี
apigee-validate
ในเซิร์ฟเวอร์การจัดการ ตามที่อธิบายไว้ในหัวข้อทดสอบการติดตั้ง
หากคุณตัดสินใจย้อนกลับการอัปเดตในภายหลัง ให้ใช้ขั้นตอนที่อธิบายไว้ในย้อนกลับไป 4.52.00
อัปเดตจากที่เก็บในพื้นที่เป็น 4.52.00
หากโหนด Edge อยู่หลังไฟร์วอลล์ หรือไม่ได้รับอนุญาตให้เข้าถึงที่เก็บ Apigee ผ่านทางอินเทอร์เน็ตไม่ว่าในทางอื่น คุณสามารถดำเนินการอัปเดตจากที่เก็บในเครื่องหรือการมิเรอร์ของที่เก็บ Apigee ได้
หลังจากที่สร้างที่เก็บ Edge ในเครื่องแล้ว คุณจะมี 2 ตัวเลือกในการอัปเดต Edge จากที่เก็บในเครื่อง ได้แก่
- สร้างไฟล์ .tar ของที่เก็บ คัดลอกไฟล์ .tar ไปยังโหนด แล้วอัปเดต Edge จากไฟล์ .tar
- ติดตั้งเว็บเซิร์ฟเวอร์บนโหนดที่มีที่เก็บในเครื่องเพื่อให้โหนดอื่นๆ เข้าถึงได้ Apigee จึงมีเว็บเซิร์ฟเวอร์ Nginx ไว้ให้คุณใช้ หรือจะใช้เว็บเซิร์ฟเวอร์ของคุณเองก็ได้
หากต้องการอัปเดตจากที่เก็บ 4.52.00 ในเครื่อง:
- สร้างที่เก็บ 4.52.00 ในเครื่องตามที่อธิบายไว้ใน "สร้างที่เก็บ Apigee ในเครื่อง" ที่ติดตั้งยูทิลิตีการตั้งค่า Edge Apigee
- วิธีติดตั้ง apigee-service จากไฟล์ .tar
- บนโหนดที่มีที่เก็บในเครื่อง ให้ใช้คำสั่งต่อไปนี้เพื่อจัดแพ็กเกจที่เก็บในเครื่องลงในไฟล์ .tar ไฟล์เดียวที่ชื่อ
/opt/apigee/data/apigee-mirror/apigee-4.52.00.tar.gz
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- คัดลอกไฟล์ .tar ไปยังโหนดที่ต้องการอัปเดต Edge เช่น คัดลอกไปยังไดเรกทอรี
/tmp
ในโหนดใหม่ - ในโหนดใหม่ ให้ยกเลิกไฟล์ไปยังไดเรกทอรี
/tmp
:tar -xzf apigee-4.52.00.tar.gz
คำสั่งนี้จะสร้างไดเรกทอรีใหม่ที่ชื่อว่า
repos
ในไดเรกทอรีที่มีไฟล์ .tar เช่น/tmp/repos
- ติดตั้งยูทิลิตี Edge
apigee-service
และทรัพยากร Dependency จาก/tmp/repos
:sudo bash /tmp/repos/bootstrap_4.52.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
โปรดสังเกตว่าคุณใส่เส้นทางไปยังไดเรกทอรี repos ไว้ในคำสั่งนี้
- บนโหนดที่มีที่เก็บในเครื่อง ให้ใช้คำสั่งต่อไปนี้เพื่อจัดแพ็กเกจที่เก็บในเครื่องลงในไฟล์ .tar ไฟล์เดียวที่ชื่อ
- วิธีติดตั้ง Apigee-service โดยใช้เว็บเซิร์ฟเวอร์ Nginx
- กำหนดค่าเว็บเซิร์ฟเวอร์ Nginx ตามที่อธิบายไว้ใน "ติดตั้งจากที่เก็บโดยใช้เว็บเซิร์ฟเวอร์ Nginx" ที่ติดตั้งยูทิลิตี Edge apigee-setup
- ในโหนดระยะไกล ให้ดาวน์โหลดไฟล์ Edge
bootstrap_4.52.00.sh
ไปยัง/tmp/bootstrap_4.52.00.sh
:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณตั้งค่าไว้ก่อนหน้านี้สำหรับที่เก็บ และ remoteRepo คือที่อยู่ IP หรือชื่อ DNS ของโหนดที่เก็บ
- ในโหนดระยะไกล ให้ติดตั้งยูทิลิตี้ Edge
apigee-setup
และการอ้างอิง:sudo bash /tmp/bootstrap_4.52.00.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, เซิร์ฟเวอร์ Postgresldap
: OpenLDAPps
: Postgresqlqpid
: qpiddsso
: Apigee SSO (หากคุณติดตั้ง SSO ไว้)- Edge UI ใหม่
ue
ui
: UI ของ Edge แบบคลาสสิกzk
: ผู้ดูแลสวนสัตว์
- 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 /tmp/sa_silent_config
- component เป็นคอมโพเนนต์ Edge ที่จะอัปเดต โดยปกติแล้วคุณจะอัปเดตคอมโพเนนต์ต่อไปนี้
- รีสตาร์ทคอมโพเนนต์ UI ในโหนดทั้งหมดที่เรียกใช้อยู่หากยังไม่ได้ดำเนินการ:
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
- ทดสอบการอัปเดตโดยเรียกใช้ยูทิลิตี
apigee-validate
ในเซิร์ฟเวอร์การจัดการ ตามที่อธิบายไว้ในหัวข้อทดสอบการติดตั้ง
หากคุณตัดสินใจย้อนกลับการอัปเดตในภายหลัง ให้ใช้ขั้นตอนที่อธิบายไว้ในย้อนกลับไป 4.52.00
ลำดับของการอัปเดตเครื่อง
ลำดับการอัปเดตเครื่องในการติดตั้ง Edge มีความสำคัญดังนี้
- คุณต้องอัปเดตโหนด Cassandra และ ZooKeeper ทั้งหมดก่อนที่จะอัปเดตโหนดอื่นๆ
- สำหรับเครื่องที่มีคอมโพเนนต์ Edge หลายรายการ (เซิร์ฟเวอร์การจัดการ ผู้ประมวลผลข้อความ เราเตอร์ เซิร์ฟเวอร์ QPID แต่ไม่ใช่เซิร์ฟเวอร์ Postgres) ให้ใช้ตัวเลือก
-c edge
เพื่ออัปเดตทั้งหมดพร้อมกัน - หากขั้นตอนระบุว่าควรดำเนินการในเครื่องหลายเครื่อง ให้ดำเนินการตามลำดับเครื่องที่ระบุ
- เราไม่ได้มีขั้นตอนแยกต่างหากในการอัปเดตการสร้างรายได้ ระบบจะอัปเดตเมื่อคุณระบุตัวเลือก
-c edge
การอัปเกรดแบบสแตนด์อโลน 1 โหนด
วิธีอัปเกรดการกำหนดค่าแบบสแตนด์อโลน 1 โหนดเป็น 4.52.00
- อัปเดตคอมโพเนนต์ทั้งหมด:
/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
- อัปเดต Qpid และ Postgres ในเครื่อง 2:
/opt/apigee/apigee-setup/bin/update.sh -c qpid,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
- อัปเดต 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) ให้อัปเดต SSO ของ Apigee ในเครื่อง 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 โหนด
โปรดดูโทโพโลยีการติดตั้งสำหรับรายการโทโพโลยี Edge และหมายเลขโหนด
- อัปเดต Cassandra และ ZooKeeper ในเครื่องที่ 1, 2 และ 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- อัปเดต Qpid และ Postgres ในเครื่อง 4:
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
- อัปเดต Qpid และ Postgres ในเครื่อง 5:
/opt/apigee/apigee-setup/bin/update.sh -c qpid, 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
- อัปเดต 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
- UI แบบคลาสสิก: หากใช้ UI แบบคลาสสิก ให้อัปเดตคอมโพเนนต์
- (หากคุณติดตั้ง
apigee-adminapi
) อัปเดตยูทิลิตีapigee-adminapi
ในเครื่อง 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (หากคุณติดตั้ง SSO ของ Apigee) ให้อัปเดต SSO ของ Apigee ในเครื่อง 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
- UI แบบคลาสสิก: หากคุณใช้ UI แบบคลาสสิก ให้รีสตาร์ทคอมโพเนนต์
การอัปเกรดคลัสเตอร์ 9 โหนด
อัปเดตคอมโพเนนต์ต่อไปนี้สำหรับการติดตั้งคลัสเตอร์ 9 โหนด
โปรดดูโทโพโลยีการติดตั้งสำหรับรายการโทโพโลยี Edge และหมายเลขโหนด
- อัปเดต Cassandra และ ZooKeeper ในเครื่องที่ 1, 2 และ 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- อัปเดต Qpid ในเครื่อง 6 และ 7:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -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
- อัปเดต 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) ให้อัปเดต SSO ของ Apigee ในเครื่อง 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
- UI แบบคลาสสิก: หากคุณใช้ UI แบบคลาสสิก ให้รีสตาร์ทคอมโพเนนต์
การอัปเกรดคลัสเตอร์แบบ 13 โหนด
อัปเดตคอมโพเนนต์ต่อไปนี้สำหรับการติดตั้งคลัสเตอร์ 13 โหนด
โปรดดูโทโพโลยีการติดตั้งสำหรับรายการโทโพโลยี Edge และหมายเลขโหนด
- อัปเดต Cassandra และ ZooKeeper ในเครื่องที่ 1, 2 และ 3 โดยทำดังนี้
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- อัปเดต Qpid ในเครื่อง 12 และ 13:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -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
- อัปเดต 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) ให้อัปเดต SSO ของ Apigee ในเครื่อง 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
- UI แบบคลาสสิก: หากคุณใช้ UI แบบคลาสสิก ให้รีสตาร์ทคอมโพเนนต์
การอัปเกรดคลัสเตอร์ 12 โหนด
อัปเดตคอมโพเนนต์ต่อไปนี้สำหรับการติดตั้งคลัสเตอร์ 12 โหนด
โปรดดูโทโพโลยีการติดตั้งสำหรับรายการโทโพโลยี Edge และหมายเลขโหนด
- อัปเดต Cassandra และ ZooKeeper โดยทำดังนี้
- ในเครื่อง 1, 2 และ 3 ในศูนย์ข้อมูล 1:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- ในเครื่อง 7, 8 และ 9 ในศูนย์ข้อมูล 2
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- ในเครื่อง 1, 2 และ 3 ในศูนย์ข้อมูล 1:
- อัปเดต qpidd ดังนี้
- เครื่อง 4, 5 ในศูนย์ข้อมูล 1
- อัปเดต
qpidd
ในเครื่อง 4:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- อัปเดต
qpidd
ในเครื่อง 5:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- อัปเดต
- เครื่อง 10, 11 ในศูนย์ข้อมูล 2
- อัปเดต
qpidd
ในเครื่อง 10:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- อัปเดต
qpidd
ในเครื่อง 11:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- อัปเดต
- เครื่อง 4, 5 ในศูนย์ข้อมูล 1
- อัปเดต Postgres ดังนี้
- เครื่อง 6 ในศูนย์ข้อมูล 1
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- เครื่อง 12 ในศูนย์ข้อมูล 2
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- เครื่อง 6 ในศูนย์ข้อมูล 1
- อัปเดต LDAP
- เครื่อง 1 ในศูนย์ข้อมูล 1
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- เครื่อง 7 ใน Data Center 2
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- เครื่อง 1 ในศูนย์ข้อมูล 1
- อัปเดตคอมโพเนนต์ Edge ดังนี้
- เครื่อง 4, 5, 6, 1, 2, 3 ในศูนย์ข้อมูล 1
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- เครื่อง 10, 11, 12, 7, 8, 9 ในศูนย์ข้อมูล 2
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- เครื่อง 4, 5, 6, 1, 2, 3 ในศูนย์ข้อมูล 1
- อัปเดต UI ใหม่ (
ue
) หรือ UI แบบคลาสสิก (ui
) ดังนี้- เครื่อง 1 ในศูนย์ข้อมูล 1:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- เครื่อง 7 ในศูนย์ข้อมูล 2:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- เครื่อง 1 ในศูนย์ข้อมูล 1:
- (หากคุณติดตั้ง
apigee-adminapi
) อัปเดตยูทิลิตีapigee-adminapi
ดังนี้- เครื่อง 1 ในศูนย์ข้อมูล 1:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- เครื่อง 7 ในศูนย์ข้อมูล 2:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- เครื่อง 1 ในศูนย์ข้อมูล 1:
- (หากคุณติดตั้ง SSO ของ Apigee) ให้อัปเดต SSO ของ Apigee ดังนี้
- เครื่อง 1 ในศูนย์ข้อมูล 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
- เครื่อง 7 ในศูนย์ข้อมูล 2:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
โดย sso_config_file คือไฟล์การกำหนดค่าที่คุณสร้างขึ้นเมื่อติดตั้ง SSO
- เครื่อง 1 ในศูนย์ข้อมูล 1:
- รีสตาร์ทคอมโพเนนต์ 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
- qpidd, ps
- LDAP
- Edge ซึ่งหมายถึงโปรไฟล์ "-c edge" ในโหนดทั้งหมดตามลำดับ ซึ่งได้แก่ โหนดที่มีเซิร์ฟเวอร์ Qpid, เซิร์ฟเวอร์ Edge Postgres, เซิร์ฟเวอร์การจัดการ, ผู้ประมวลผลข้อความ และเราเตอร์
- Edge UI (คลาสสิกหรือใหม่)
apigee-adminapi
- SSO ของ Apigee
หลังจากอัปเดตเสร็จแล้ว อย่าลืมรีสตาร์ทคอมโพเนนต์ Edge UI ในเครื่องทุกเครื่องที่เรียกใช้คอมโพเนนต์ดังกล่าว
- ดาวน์โหลดไฟล์ Edge