Edge for Private Cloud v4.18.01
Edge เวอร์ชันใดบ้างที่คุณสามารถอัปเดตเป็น 4.18.01 ได้
คุณอัปเดต Apigee Edge เวอร์ชัน 4.17.0x ได้โดยใช้ขั้นตอนนี้
หากคุณมี Edge เวอร์ชันก่อน 4.16.01 คุณต้องย้ายข้อมูลไปยังเวอร์ชัน 4.16.01.x ก่อน แล้วจึงอัปเดตเป็นเวอร์ชัน 4.18.01
ผู้ที่ทำการอัปเดตได้
ผู้ใช้ที่เรียกใช้การอัปเดตควรเป็นผู้ใช้รายเดียวกับที่ติดตั้ง Edge ไว้ตั้งแต่แรก หรือผู้ใช้ที่เรียกใช้ในฐานะรูท
หลังจากติดตั้ง Edge RPM แล้ว ผู้ใช้ทุกคนจะกำหนดค่าได้
องค์ประกอบใดบ้างที่ต้องอัปเดต
คุณต้องอัปเดตคอมโพเนนต์ Edge ทั้งหมด Edge ไม่รองรับการตั้งค่าที่มีคอมโพเนนต์จากหลายเวอร์ชัน
รักษาความเข้ากันได้
เมื่ออัปเกรด Apigee Edge สำหรับ Private Cloud เป็น 4.18.01 คุณต้องตรวจสอบว่าการติดตั้งใช้งานที่ได้จะอ้างอิงเฉพาะพร็อพเพอร์ตี้ที่รองรับในไฟล์การกำหนดค่าเท่านั้น
| พร็อพเพอร์ตี้ | ตำแหน่ง | คำอธิบาย |
|---|---|---|
conf_load_balancing_load.balancing. |
router.properties |
นำพร็อพเพอร์ตี้นี้ออกจากไฟล์ router.properties หากต้องการตั้งค่าตัวเลือกการลองใหม่ใน 4.18.01 ให้ใช้พร็อพเพอร์ตี้การกำหนดค่าโฮสต์เสมือน |
การเผยแพร่การตั้งค่าพร็อพเพอร์ตี้โดยอัตโนมัติ
หากคุณตั้งค่าพร็อพเพอร์ตี้ใดๆ โดยแก้ไขไฟล์ .properties ใน /opt/apigee/customer/application ระบบจะเก็บค่าเหล่านี้ไว้ในการอัปเดต
ต้องเพิ่มพารามิเตอร์การกำหนดค่า SMTPMAILFROM
Edge 4.17.05 ได้เพิ่มพารามิเตอร์ใหม่ที่จำเป็นลงในไฟล์การกำหนดค่าที่ใช้เมื่อคุณเปิดใช้เซิร์ฟเวอร์ SMTP หากอัปเดตจาก 4.17.01 คุณต้องตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่าเมื่อเปิดใช้เซิร์ฟเวอร์ SMTP
API BaaS เวอร์ชัน 4.17.09 ยังเพิ่มการรองรับพร็อพเพอร์ตี้ SMTPMAILFROM ด้วย เมื่ออัปเดต API BaaS จาก 4.17.01 หรือ 4.17.05 คุณต้องตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่า
พารามิเตอร์นี้มีรูปแบบดังนี้
SMTPMAILFROM="My Company <myco@company.com>"
ต้องอัปเกรดเป็น Postgres 9.6
Edge เวอร์ชันนี้มีการอัปเกรดเป็น Postgres 9.6 ในการอัปเกรดดังกล่าว ระบบจะย้ายข้อมูล Postgres ทั้งหมดไปยัง Postgres 9.6
ระบบการผลิต Edge ส่วนใหญ่ใช้โหนด Postgres 2 โหนดที่กำหนดค่าสำหรับการจำลองแบบ Master-Standby ในระหว่างกระบวนการอัปเดต ขณะที่โหนด Postgres หยุดทำงานเพื่ออัปเดต ระบบจะยังคงเขียนข้อมูลวิเคราะห์ลงในโหนด Qpid หลังจากอัปเดตโหนด Postgres และกลับมาออนไลน์แล้ว ระบบจะพุชข้อมูลวิเคราะห์ไปยังโหนด Postgres
วิธีอัปเดต Postgres จะขึ้นอยู่กับวิธีที่คุณกำหนดค่าพื้นที่เก็บข้อมูลสำหรับโหนด Postgres ดังนี้
- หากใช้ที่เก็บข้อมูลในเครื่องสำหรับโหนด Postgres คุณต้องติดตั้งโหนดสแตนด์บาย Postgres ใหม่ตลอดระยะเวลาการอัปเกรด หลังจากอัปเกรดเสร็จแล้ว คุณสามารถเลิกใช้งานโหนดสแตนด์บาย Postgres ใหม่ได้
คุณต้องมีโหนดสแตนด์บาย Postgres เพิ่มเติมหากต้องย้อนกลับการอัปเดตไม่ว่าด้วยเหตุผลใดก็ตาม หากคุณต้องย้อนกลับการอัปเดต โหนดสแตนด์บาย Postgres ใหม่จะกลายเป็นโหนด Postgres หลักหลังจากการย้อนกลับ ดังนั้นเมื่อติดตั้งโหนดสแตนด์บาย Postgres ใหม่ โหนดดังกล่าวควรอยู่ในโหนดที่ตรงตามข้อกำหนดด้านฮาร์ดแวร์ทั้งหมดของเซิร์ฟเวอร์ Postgres ตามที่กำหนดไว้ในข้อกำหนดในการติดตั้ง Edge
ในการติดตั้ง Edge แบบ 1 โหนดและ 2 โหนด โทโพโลยีที่ใช้สำหรับการสร้างต้นแบบและการทดสอบ คุณจะมีโหนด Postgres เพียงโหนดเดียว คุณสามารถอัปเดตโหนด Postgres เหล่านี้ได้โดยตรงโดยไม่ต้องสร้างโหนด Postgres ใหม่ - หากคุณใช้พื้นที่เก็บข้อมูลเครือข่ายสำหรับโหนด Postgres ตามที่ Apigee แนะนำ คุณไม่จำเป็นต้องติดตั้งโหนด Postgres ใหม่ ในขั้นตอนด้านล่าง คุณสามารถข้ามขั้นตอนที่ระบุให้ติดตั้งและเลิกใช้งานโหนดสแตนด์บาย Postgres ใหม่ในภายหลังได้
ก่อนเริ่มกระบวนการอัปเดต ให้ถ่ายภาพสแนปชอตเครือข่ายของที่เก็บข้อมูลที่ Postgres ใช้ จากนั้น หากเกิดข้อผิดพลาดระหว่างการอัปเดตและคุณจำเป็นต้องย้อนกลับ คุณสามารถกู้คืนโหนด Postgres จากสแนปชอตนั้นได้
การติดตั้งโหนดสแตนด์บาย Postgres ใหม่
ขั้นตอนนี้จะสร้างเซิร์ฟเวอร์สแตนด์บาย Postgres ในโหนดใหม่ ตรวจสอบว่าคุณติดตั้งเซิร์ฟเวอร์สแตนด์บาย Postgres ใหม่สำหรับ Edge เวอร์ชันที่มีอยู่ (4.17.0x) ไม่ใช่สำหรับเวอร์ชัน 4.18.01
หากต้องการติดตั้ง ให้ใช้ไฟล์การกำหนดค่าเดียวกับที่ใช้ติดตั้ง Edge เวอร์ชันปัจจุบัน
วิธีสร้างโหนดสแตนด์บาย Postgres ใหม่
- ใน Postgres Master ปัจจุบัน ให้แก้ไขไฟล์
/opt/apigee/customer/application/postgresql.propertiesเพื่อตั้งค่าโทเค็นต่อไปนี้conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust
โดย existing_slave_ip คือที่อยู่ IP ของเซิร์ฟเวอร์สแตนด์บาย Postgres ปัจจุบัน และ new_slave_ip คือที่อยู่ IP ของโหนดสแตนด์บายใหม่
หากไม่มีไฟล์
postgresql.propertiesให้สร้างไฟล์และใช้chownเพื่อให้สิทธิ์เข้าถึงแก่ผู้ใช้apigeeดังตัวอย่างต่อไปนี้chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
- รีสตาร์ท apigee-postgresql ใน Postgres Master โดยทำดังนี้
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
- ยืนยันว่าได้เพิ่มโหนดสแตนด์บายใหม่แล้วโดยดูไฟล์
/opt/apigee/apigee-postgresql/conf/pg_hba.confในมาสเตอร์ คุณควรเห็นบรรทัดต่อไปนี้ในไฟล์นั้นhost replication apigee existing_slave_ip/32 trust host replication apigee new_slave_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 ตามที่อธิบายไว้ในติดตั้งยูทิลิตี apigee-setup ของ Edge
- ดาวน์โหลดไฟล์ Edge bootstrap_4.17.0x.sh (โดยที่ 4.17.0x คือ 4.17.01, 4.17.05 หรือ 4.17.09) ไปยัง
/tmp/bootstrap_4.17.0x.shโดยทำดังนี้curl https://software.apigee.com/bootstrap_4.17.0x.sh -o /tmp/bootstrap_4.17.0x.sh
- ติดตั้งยูทิลิตี Edge
apigee-serviceและทรัพยากร Dependency ดังนี้sudo bash /tmp/bootstrap_4.17.0x.sh apigeeuser=uName apigeepassword=pWord
- ใช้
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 ทำงานอยู่:
> /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_slave_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_slave_ip/32 trust - ลบ UUID ของโหนดสแตนด์บายออกจาก ZooKeeper โดยทำการเรียก API การจัดการ Edge ต่อไปนี้ในโหนดเซิร์ฟเวอร์การจัดการ:
> curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>
ข้อกำหนดเบื้องต้นในการอัปเดต
โปรดดำเนินการตามข้อกำหนดเบื้องต้นต่อไปนี้ก่อนอัปเกรด Apigee Edge
- สำรองข้อมูลโหนดทั้งหมด
ก่อนอัปเดต เราขอแนะนำให้สำรองข้อมูลโหนดทั้งหมดให้เสร็จสมบูรณ์เพื่อความปลอดภัย ใช้ขั้นตอนสำหรับ Edge เวอร์ชันปัจจุบันเพื่อสำรองข้อมูล
ซึ่งจะช่วยให้คุณมีแผนสำรองในกรณีที่การอัปเดตเป็นเวอร์ชันใหม่ทำงานไม่ถูกต้อง ดูข้อมูลเพิ่มเติมเกี่ยวกับการสำรองข้อมูลได้ที่การสำรองและกู้คืนข้อมูล - ตรวจสอบว่า Edge ทำงานอยู่
ตรวจสอบว่า Edge ทำงานอยู่ระหว่างกระบวนการอัปเดตโดยใช้คำสั่งต่อไปนี้
> /opt/apigee/apigee-service/bin/apigee-all status
การจัดการการอัปเดตที่ไม่สำเร็จ
ในกรณีที่อัปเดตไม่สำเร็จ คุณสามารถลองแก้ไขปัญหา แล้วเรียกใช้ update.sh อีกครั้ง คุณสามารถเรียกใช้การอัปเดตได้หลายครั้ง และระบบจะอัปเดตต่อจากที่ค้างไว้ล่าสุด
หากความล้มเหลวดังกล่าวทำให้คุณต้องย้อนกลับการอัปเดตเป็นเวอร์ชันก่อนหน้า โปรดดูข้อมูลเพิ่มเติมที่หัวข้อกระบวนการย้อนกลับเป็นเวอร์ชัน 4.18.01
กำลังบันทึกข้อมูลการอัปเดต
โดยค่าเริ่มต้น ยูทิลิตี update.sh จะเขียนข้อมูลบันทึกไปยังตำแหน่งต่อไปนี้
/opt/apigee/var/log/apigee-setup/update.log
หากผู้ใช้ที่เรียกใช้ยูทิลิตี update.sh ไม่มีสิทธิ์เข้าถึงไดเรกทอรีดังกล่าว ระบบจะเขียนบันทึกลงในไดเรกทอรี /tmp เป็นไฟล์ชื่อ update_username.log
หากผู้ใช้ไม่มีสิทธิ์เข้าถึง /tmp ยูทิลิตี update.sh จะทำงานไม่สำเร็จ
การอัปเดตโดยไม่มีช่วงพัก
การอัปเดตแบบไม่มีช่วงเวลาหยุดทำงานหรือการอัปเดตทีละส่วนช่วยให้คุณอัปเดตการติดตั้ง Edge ได้โดยไม่ต้องปิด Edge
การอัปเดตแบบไม่มีช่วงพักการทำงานจะทำได้เฉพาะกับการกำหนดค่าแบบ 5 โหนดขึ้นไปเท่านั้น
กุญแจสำคัญในการอัปเกรดโดยไม่มีช่วงเวลาที่ระบบหยุดทำงานคือการนำเราเตอร์แต่ละตัวออกจากตัวจัดสรรภาระงานทีละตัว จากนั้นคุณอัปเดตเราเตอร์และคอมโพเนนต์อื่นๆ ในเครื่องเดียวกับเราเตอร์ แล้วเพิ่มเราเตอร์กลับไปยังตัวจัดสรรภาระงาน
- อัปเดตเครื่องตามลำดับที่ถูกต้องสำหรับการติดตั้งตามที่อธิบายไว้ด้านล่างใน "ลำดับการอัปเดตเครื่อง"
- เมื่อถึงเวลาอัปเดตเราเตอร์ ให้เลือกเราเตอร์ใดก็ได้และทำให้เข้าถึงไม่ได้ตามที่อธิบายไว้ในการเปิด/ปิดใช้ความสามารถในการเข้าถึงเซิร์ฟเวอร์ (Message Processor/เราเตอร์)
- อัปเดตเราเตอร์ที่เลือกและคอมโพเนนต์ Edge อื่นๆ ทั้งหมดในเครื่องเดียวกับเราเตอร์ การกำหนดค่า Edge ทั้งหมดจะแสดงเราเตอร์และ Message Processor ในโหนดเดียวกัน
- ทำให้เราเตอร์เข้าถึงได้อีกครั้ง
- ทำซ้ำขั้นตอนที่ 2 ถึง 4 สำหรับเราเตอร์ที่เหลือ
- ดำเนินการอัปเดตต่อสำหรับเครื่องที่เหลือในการติดตั้ง
โปรดดำเนินการต่อไปนี้ก่อน/หลังการอัปเดต
- ในโหนดเราเตอร์และ Message Processor แบบรวม ให้ทำดังนี้
- ก่อนอัปเดต ให้ทำดังนี้
- ทำให้เราเตอร์เข้าถึงไม่ได้
- ทำให้ Message Processor เข้าถึงไม่ได้
- หลังการอัปเดต - ดำเนินการต่อไปนี้
- ทำให้ Message Processor เข้าถึงได้
- ตรวจสอบว่าเราเตอร์เข้าถึงได้
- ก่อนอัปเดต ให้ทำดังนี้
- ในโหนดเราเตอร์เดียว ให้ทำดังนี้
- ก่อนอัปเดต ให้ทำให้เราเตอร์เข้าถึงไม่ได้
- หลังจากอัปเดตแล้ว ให้ตรวจสอบว่าเราเตอร์เข้าถึงได้
- ในโหนด Message Processor เดียว ให้ทำดังนี้
- ก่อนอัปเดต ให้ทำให้ Message Processor เข้าถึงไม่ได้
- หลังจากอัปเดตแล้ว ให้ทำให้ Message Processor เข้าถึงได้
การใช้ไฟล์การกำหนดค่าแบบไม่มีการโต้ตอบ
คุณต้องส่งไฟล์การกำหนดค่าแบบไม่มีการโต้ตอบไปยังคำสั่งอัปเดต ไฟล์การกำหนดค่าแบบไม่โต้ตอบควรเป็นไฟล์เดียวกับที่คุณใช้ติดตั้ง Edge 4.17.0x
ขั้นตอนการอัปเดตเป็น 4.18.01 ในโหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก
ใช้ขั้นตอนต่อไปนี้เพื่ออัปเดตคอมโพเนนต์ Edge ในโหนด
- หากคุณใช้การจำลองแบบ Postgres Master-Standby กับพื้นที่เก็บข้อมูลในเครื่อง ให้ติดตั้งโหนดสแตนด์บาย Postgres ใหม่ตามที่อธิบายไว้ข้างต้นในหัวข้อการติดตั้งโหนดสแตนด์บาย Postgres ใหม่
หากใช้พื้นที่เก็บข้อมูลเครือข่าย คุณไม่จำเป็นต้องติดตั้งโหนดใหม่ แต่ให้จับภาพสแนปชอตเครือข่ายของที่เก็บข้อมูลที่ Postgres ใช้แทน ดูข้อมูลเพิ่มเติมได้ที่การอัปเกรดที่จำเป็นเป็น Postgres 9.6 - หากมี ให้ปิดใช้งานงาน CRON ที่กำหนดค่าให้ดำเนินการซ่อมแซมใน Cassandra จนกว่าการอัปเดตจะเสร็จสมบูรณ์
- เข้าสู่ระบบโหนดในฐานะรูทเพื่อติดตั้ง Edge RPM
หมายเหตุ: แม้ว่าการติดตั้ง RPM จะต้องใช้สิทธิ์เข้าถึงระดับรูท แต่คุณสามารถกำหนดค่า Edge ได้โดยไม่ต้องใช้สิทธิ์เข้าถึงระดับรูท - ติดตั้ง yum-utils และ yum-plugin-priorities:
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities - ปิดใช้ SELinux ตามที่อธิบายไว้ในติดตั้งยูทิลิตี apigee-setup ของ Edge
- หากติดตั้งใน Oracle 7.x ให้เรียกใช้คำสั่งต่อไปนี้
> sudo yum-config-manager --enable ol7_optional_latest - หากติดตั้งใน AWS ให้เรียกใช้คำสั่ง yum-configure-manager ต่อไปนี้
> yum update rh-amazon-rhui-client.noarch
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional - ดาวน์โหลดไฟล์ Edge 4.18.01 bootstrap_4.18.01.sh ไปยัง /tmp/bootstrap_4.18.01.sh:
> curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh - ติดตั้งยูทิลิตี apigee-service ของ Edge 4.18.01 และทรัพยากร Dependency ดังนี้
> sudo bash /tmp/bootstrap_4.18.01.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 ด้วยตนเอง - ใช้ 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 - เรียกใช้ยูทิลิตีการอัปเดตในโหนดตามลำดับที่อธิบายไว้ด้านล่างใน "ลำดับการอัปเดตเครื่อง" ด้านล่าง
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
ข้อกำหนดเดียวในไฟล์การกำหนดค่าคือไฟล์การกำหนดค่าต้องเข้าถึงได้หรืออ่านได้โดยผู้ใช้ "apigee"
ใช้ตัวเลือก "-c" เพื่อระบุคอมโพเนนต์ที่จะอัปเดต รายการคอมโพเนนต์ที่เป็นไปได้มีดังนี้
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =คอมโพเนนต์ Edge ทั้งหมดยกเว้น Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres Server
ui = Edge UI
all = อัปเดตคอมโพเนนต์ทั้งหมดในเครื่อง (ใช้สำหรับโปรไฟล์การติดตั้ง Edge aio หรือโปรไฟล์การติดตั้ง API BaaS asa เท่านั้น)
e = ElasticSearch
b = API BaaS Stack
p = API BaaS Portal
ebp = ElasticSearch, API BaaS Stack และ API BaaS Portal ในโหนดเดียวกัน - ทดสอบการอัปเดตโดยเรียกใช้ยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการตามที่อธิบายไว้ในทดสอบการติดตั้ง
- หากคุณติดตั้งโหนดสแตนด์บาย Postgres ใหม่ ให้เลิกใช้งานโหนดตามที่อธิบายไว้ข้างต้นในหัวข้อการเลิกใช้งานโหนด Postgres
หากใช้พื้นที่เก็บข้อมูลเครือข่าย คุณไม่จำเป็นต้องติดตั้งโหนดใหม่ ดูข้อมูลเพิ่มเติมได้ที่การอัปเกรดที่จำเป็นเป็น Postgres 9.6
หากต้องการย้อนกลับการอัปเดตในภายหลัง ให้ใช้ขั้นตอนที่อธิบายไว้ใน 4.18.01 Rollback Process
ขั้นตอนการอัปเดตเป็น 4.18.01 จากที่เก็บในเครื่อง
หากโหนด Edge อยู่หลังไฟร์วอลล์ หรือถูกห้ามไม่ให้เข้าถึงที่เก็บ Apigee ผ่านอินเทอร์เน็ตด้วยวิธีอื่น คุณสามารถทำการอัปเดตจากที่เก็บในเครื่องหรือมิเรอร์ของที่เก็บ Apigee ได้
หลังจากสร้างที่เก็บ Edge ในเครื่องแล้ว คุณจะมี 2 ตัวเลือกในการอัปเดต Edge จากที่เก็บในเครื่อง ดังนี้
- สร้างไฟล์ .tar ของที่เก็บ คัดลอกไฟล์ .tar ไปยังโหนด แล้วอัปเดต Edge จากไฟล์ .tar
- ติดตั้งเว็บเซิร์ฟเวอร์ในโหนดที่มีที่เก็บในเครื่องเพื่อให้โหนดอื่นๆ เข้าถึงได้ Apigee มีเว็บเซิร์ฟเวอร์ Nginx ให้คุณใช้ หรือคุณจะใช้เว็บเซิร์ฟเวอร์ของคุณเองก็ได้
วิธีอัปเดตจากที่เก็บ 4.18.01 ในเครื่อง
- หากคุณใช้การจำลองแบบ Postgres Master-Standby อยู่ ให้ติดตั้งโหนดสแตนด์บาย Postgres ใหม่ตามที่อธิบายไว้ข้างต้นในหัวข้อการติดตั้งโหนดสแตนด์บาย Postgres ใหม่
หากใช้พื้นที่เก็บข้อมูลเครือข่าย คุณไม่จำเป็นต้องติดตั้งโหนดใหม่ แต่ให้จับภาพสแนปชอตเครือข่ายของที่เก็บข้อมูลที่ Postgres ใช้แทน ดูข้อมูลเพิ่มเติมได้ที่การอัปเกรดที่จำเป็นเป็น Postgres 9.6 - สร้างที่เก็บ 4.18.01 ในเครื่องตามที่อธิบายไว้ใน "สร้างที่เก็บ Apigee ในเครื่อง" ที่หัวข้อติดตั้งยูทิลิตี apigee-setup ของ Edge
หมายเหตุ: หากมีที่เก็บ 4.17.0x อยู่แล้ว คุณสามารถเพิ่มที่เก็บ 4.18.01 ลงในที่เก็บดังกล่าวได้ตามที่อธิบายไว้ใน "อัปเดตที่เก็บ Apigee ในเครื่อง" ที่หัวข้อติดตั้งยูทิลิตี apigee-setup ของ Edge -
วิธีติดตั้ง apigee-service จากไฟล์ .tar
- ในโหนดที่มีที่เก็บในเครื่อง ให้ใช้คำสั่งต่อไปนี้เพื่อจัดแพ็กเกจที่เก็บในเครื่องเป็นไฟล์ .tar ไฟล์เดียวชื่อ /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package - คัดลอกไฟล์ .tar ไปยังโหนดที่ต้องการอัปเดต Edge เช่น คัดลอกไปยังไดเรกทอรี /tmp ในโหนดใหม่
- ในโหนดใหม่ ให้ Untar ไฟล์ไปยังไดเรกทอรี /tmp:
> tar -xzf apigee-4.18.01.tar.gz
คำสั่งนี้จะสร้างไดเรกทอรีใหม่ชื่อ repos ในไดเรกทอรีที่มีไฟล์ .tar เช่น /tmp/repos - ติดตั้งยูทิลิตี apigee-service ของ Edge และทรัพยากร Dependency จาก /tmp/repos:
> sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
โปรดทราบว่าคุณต้องใส่เส้นทางไปยังไดเรกทอรี repos ในคำสั่งนี้
- ในโหนดที่มีที่เก็บในเครื่อง ให้ใช้คำสั่งต่อไปนี้เพื่อจัดแพ็กเกจที่เก็บในเครื่องเป็นไฟล์ .tar ไฟล์เดียวชื่อ /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz
-
วิธีติดตั้ง apigee-service โดยใช้เว็บเซิร์ฟเวอร์ Nginx
- กำหนดค่าเว็บเซิร์ฟเวอร์ Nginx ตามที่อธิบายไว้ใน "ติดตั้งจากที่เก็บโดยใช้เว็บเซิร์ฟเวอร์ Nginx" ที่หัวข้อติดตั้งยูทิลิตี apigee-setup ของ Edge
- ในโหนดระยะไกล ให้ดาวน์โหลดไฟล์ Edge bootstrap_4.18.01.sh ไปยัง /tmp/bootstrap_4.18.01.sh:
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณตั้งค่าไว้ด้านบนสำหรับที่เก็บ และ remoteRepo คือที่อยู่ IP หรือชื่อ DNS ของโหนดที่เก็บ - ในโหนดระยะไกล ให้ติดตั้งยูทิลิตี apigee-service ของ Edge และทรัพยากร Dependency ดังนี้
> sudo bash /tmp/bootstrap_4.18.01.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 - เรียกใช้ยูทิลิตีการอัปเดตในโหนดตามลำดับที่อธิบายไว้ด้านล่างในส่วน "ลำดับการอัปเดตเครื่อง"
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
ข้อกำหนดเดียวในไฟล์การกำหนดค่าคือไฟล์การกำหนดค่าต้องเข้าถึงได้หรืออ่านได้โดยผู้ใช้ "apigee"
ใช้ตัวเลือก "-c" เพื่อระบุคอมโพเนนต์ที่จะอัปเดต รายการคอมโพเนนต์ที่เป็นไปได้มีดังนี้
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =คอมโพเนนต์ Edge ทั้งหมดยกเว้น Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres Server
ui = Edge UI
all = อัปเดตคอมโพเนนต์ทั้งหมดในเครื่อง (ใช้สำหรับโปรไฟล์การติดตั้ง Edge aio หรือโปรไฟล์การติดตั้ง API BaaS asa เท่านั้น)
e = ElasticSearch
b = API BaaS Stack
p = API BaaS Portal
ebp = ElasticSearch, API BaaS Stack และ API BaaS Portal ในโหนดเดียวกัน - ทดสอบการอัปเดตโดยเรียกใช้ยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการตามที่อธิบายไว้ในทดสอบการติดตั้ง
- หากคุณติดตั้งโหนดสแตนด์บาย Postgres ใหม่ ให้เลิกใช้งานโหนดตามที่อธิบายไว้ข้างต้นในหัวข้อการเลิกใช้งานโหนด Postgres
หากใช้พื้นที่เก็บข้อมูลเครือข่าย คุณไม่จำเป็นต้องติดตั้งโหนดใหม่ ดูข้อมูลเพิ่มเติมได้ที่การอัปเกรดที่จำเป็นเป็น Postgres 9.6
หากต้องการย้อนกลับการอัปเดตในภายหลัง ให้ใช้ขั้นตอนที่อธิบายไว้ใน 4.18.01 Rollback Process
ลำดับการอัปเดตเครื่อง
ลำดับที่คุณอัปเดตเครื่องในการติดตั้ง Edge เป็นสิ่งสำคัญ ข้อควรพิจารณาที่สำคัญที่สุดในการอัปเดตมีดังนี้
- คุณต้องอัปเดตโหนด Cassandra และ ZooKeeper ทั้งหมดก่อนที่จะอัปเดตโหนดอื่นๆ
- สำหรับเครื่องที่มีคอมโพเนนต์ Edge หลายรายการ (Management Server, Message Processor, Router, QPID Server แต่ไม่ใช่ Postgres Server) ให้ใช้ตัวเลือก "-c edge" เพื่ออัปเดตคอมโพเนนต์ทั้งหมดพร้อมกัน
- หากขั้นตอนระบุว่าควรดำเนินการในเครื่องหลายเครื่อง ให้ดำเนินการตามลำดับเครื่องที่ระบุ
- ไม่มีขั้นตอนแยกต่างหากในการอัปเดตการสร้างรายได้ ระบบจะอัปเดตเมื่อคุณระบุตัวเลือก "-c edge"
สำหรับการติดตั้งแบบสแตนด์อโลน 1 โฮสต์
- หากคุณอัปเดตจาก 4.17.01 ให้ตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่าหากคุณเปิดใช้ SMTP ใน Edge พารามิเตอร์นี้มีรูปแบบดังนี้
SMTPMAILFROM="My Company <myco@company.com>" - อัปเดต Cassandra และ ZooKeeper:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - อัปเดต Qpid:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - อัปเดต LDAP:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - หยุดเซิร์ฟเวอร์ Postgres, เซิร์ฟเวอร์ Qpid และ PostgreSQL:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - อัปเดต postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - อัปเดตฐานข้อมูล Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - อัปเดตคอมโพเนนต์ Edge ที่เหลือ:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - อัปเดต Edge UI:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
สำหรับการติดตั้งแบบสแตนด์อโลน 2 โฮสต์
ดูรายการโทโพโลยี Edge และหมายเลขโหนดได้ที่โทโพโลยีการติดตั้ง
- หากคุณอัปเดตจาก 4.17.01 ให้ตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่าหากคุณเปิดใช้ SMTP ใน Edge พารามิเตอร์นี้มีรูปแบบดังนี้
SMTPMAILFROM="My Company <myco@company.com>" - อัปเดต Cassandra และ ZooKeeper ในเครื่องที่ 1:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - อัปเดต Qpid ในเครื่องที่ 2:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - อัปเดต LDAP ในเครื่องที่ 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - อัปเดตคอมโพเนนต์ Edge ในเครื่องที่ 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 - อัปเดต postgresql ในเครื่อง 2 โดยทำดังนี้
- หยุดเซิร์ฟเวอร์ Postgres, เซิร์ฟเวอร์ Qpid และ postgresql:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - อัปเดต postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - อัปเดตฐานข้อมูล Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - อัปเดตคอมโพเนนต์ Edge ในเครื่องที่ 2:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- หยุดเซิร์ฟเวอร์ Postgres, เซิร์ฟเวอร์ Qpid และ postgresql:
สำหรับการติดตั้งแบบคลัสเตอร์ 5 โฮสต์
ดูรายการโทโพโลยี Edge และหมายเลขโหนดได้ที่โทโพโลยีการติดตั้ง
- หากคุณอัปเดตจาก 4.17.01 ให้ตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่าหากคุณเปิดใช้ SMTP ใน Edge พารามิเตอร์นี้มีรูปแบบดังนี้
SMTPMAILFROM="My Company <myco@company.com>" - ตรวจสอบว่าคุณได้ติดตั้งโหนดสแตนด์บาย Postgres ใหม่ตามที่อธิบายไว้ข้างต้นในการติดตั้งโหนดสแตนด์บาย Postgres ใหม่
หากใช้พื้นที่เก็บข้อมูลเครือข่าย คุณไม่จำเป็นต้องติดตั้งโหนดใหม่ แต่ให้จับภาพสแนปชอตเครือข่ายของที่เก็บข้อมูลที่ Postgres ใช้แทน ดูข้อมูลเพิ่มเติมได้ที่การอัปเกรดที่จำเป็นเป็น Postgres 9.6 - อัปเดต Cassandra และ ZooKeeper ในเครื่อง 1, 2 และ 3:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - อัปเดต Qpid ในเครื่อง 4 และ 5:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - อัปเดต LDAP ในเครื่องที่ 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - อัปเดตคอมโพเนนต์ Edge ในเครื่อง 1, 2, 3:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - อัปเดต UI ในเครื่องที่ 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile -
??อัปเดตเครื่อง 4 และ 5:
- หยุดเซิร์ฟเวอร์ Postgres และเซิร์ฟเวอร์ Qpid ในเครื่อง 4:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop - หยุดเซิร์ฟเวอร์ Postgres, เซิร์ฟเวอร์ Qpid และ postgresql ในเครื่อง 5:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - หากติดตั้งไว้ ให้หยุดเซิร์ฟเวอร์ Postgres และ postgresql ในโหนดสแตนด์บายใหม่ที่คุณเพิ่มไว้สำหรับการย้อนกลับ
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - อัปเดต postgresql ในเครื่อง 4:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - อัปเดตฐานข้อมูล Postgres ในเครื่อง 4 (Postgres Master เท่านั้น):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - อัปเดต postgresql ในเครื่อง 5:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - เริ่มเซิร์ฟเวอร์ Postgres และเซิร์ฟเวอร์ Qpid ในเครื่อง 4 และ 5:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start - กำหนดค่า Postgres เป็นโหนดสแตนด์บายโดยเรียกใช้คำสั่งต่อไปนี้ในเครื่อง 5:
> cd /opt/apigee/data/apigee-postgresql/pgdata
> rm -rf *
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile - ยืนยันสถานะการจำลองโดยเรียกใช้สคริปต์ต่อไปนี้บนเซิร์ฟเวอร์ทั้ง 2 เครื่อง ระบบควรแสดงผลลัพธ์ที่เหมือนกันในทั้ง 2 เซิร์ฟเวอร์เพื่อให้แน่ใจว่าการจำลองสำเร็จ:
ในเครื่อง 4 ซึ่งเป็นโหนดหลัก ให้เรียกใช้คำสั่งต่อไปนี้
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
ตรวจสอบว่าระบบระบุว่าเป็นโหนดหลัก
ในเครื่องที่ 5 ซึ่งเป็นโหนดสแตนด์บาย ให้ทำดังนี้
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
ตรวจสอบว่ามีข้อความระบุว่าเป็นโหนดสแตนด์บาย
- หยุดเซิร์ฟเวอร์ Postgres และเซิร์ฟเวอร์ Qpid ในเครื่อง 4:
- อัปเดตคอมโพเนนต์ Edge ในเครื่อง 4, 5:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - ตรวจสอบว่าคุณได้เลิกใช้งานโหนดสแตนด์บายใหม่โดยใช้ขั้นตอนข้างต้นในการเลิกใช้งานโหนด Postgres
หากใช้พื้นที่เก็บข้อมูลเครือข่าย คุณไม่จำเป็นต้องติดตั้งโหนดใหม่ ดูข้อมูลเพิ่มเติมได้ที่การอัปเกรดที่จำเป็นเป็น Postgres 9.6
สำหรับการติดตั้งแบบคลัสเตอร์ 9 โฮสต์
ดูรายการโทโพโลยี Edge และหมายเลขโหนดได้ที่โทโพโลยีการติดตั้ง
- หากคุณอัปเดตจาก 4.17.01 ให้ตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่าหากคุณเปิดใช้ SMTP ใน Edge พารามิเตอร์นี้มีรูปแบบดังนี้
SMTPMAILFROM="My Company <myco@company.com>" - ตรวจสอบว่าคุณได้ติดตั้งโหนดสแตนด์บาย Postgres ใหม่ตามที่อธิบายไว้ข้างต้นในการติดตั้งโหนดสแตนด์บาย Postgres ใหม่
หากใช้พื้นที่เก็บข้อมูลเครือข่าย คุณไม่จำเป็นต้องติดตั้งโหนดใหม่ แต่ให้จับภาพสแนปชอตเครือข่ายของที่เก็บข้อมูลที่ Postgres ใช้แทน ดูข้อมูลเพิ่มเติมได้ที่การอัปเกรดที่จำเป็นเป็น Postgres 9.6 - อัปเดต 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 - อัปเดต LDAP ในเครื่องที่ 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - อัปเดตคอมโพเนนต์ Edge ในเครื่อง 6, 7, 1, 4 และ 5 ตามลำดับ:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - อัปเดต UI ในเครื่อง 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile? - อัปเดตเครื่อง 8 และ 9 ดังนี้
- หยุดเซิร์ฟเวอร์ Postgres ในเครื่อง 8:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop - หยุดเซิร์ฟเวอร์ Postgres และ postgresql ในเครื่อง 9:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - หยุดเซิร์ฟเวอร์ Qpid ในเครื่อง 6 และ 7:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop - หากติดตั้งไว้ ให้หยุดเซิร์ฟเวอร์ Postgres และ postgresql ในโหนดสแตนด์บายใหม่ที่คุณเพิ่มไว้สำหรับการย้อนกลับ
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - อัปเดต postgresql ในเครื่อง 8:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - อัปเดตฐานข้อมูล Postgres ในเครื่อง 8 (Postgres Master เท่านั้น):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - อัปเดต postgresql ในเครื่อง 9:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - เริ่มเซิร์ฟเวอร์ Postgres บนเครื่อง 8 และ 9:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start - เริ่มเซิร์ฟเวอร์ Qpid ในเครื่อง 6 และ 7:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start - กำหนดค่า Postgres เป็นโหนดสแตนด์บายโดยเรียกใช้คำสั่งต่อไปนี้ในเครื่อง 9:
> cd /opt/apigee/data/apigee-postgresql/pgdata
> rm -rf *
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile - ยืนยันสถานะการจำลองโดยเรียกใช้สคริปต์ต่อไปนี้บนเซิร์ฟเวอร์ทั้ง 2 เครื่อง ระบบควรแสดงผลลัพธ์ที่เหมือนกันในทั้ง 2 เซิร์ฟเวอร์เพื่อให้แน่ใจว่าการจำลองสำเร็จ:
ในเครื่อง 8 ซึ่งเป็นโหนดหลัก ให้เรียกใช้:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
ตรวจสอบว่าระบบระบุว่าเป็นโหนดหลัก
ในเครื่องที่ 9 ซึ่งเป็นโหนดสแตนด์บาย ให้ทำดังนี้
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
ตรวจสอบว่ามีข้อความระบุว่าเป็นโหนดสแตนด์บาย
- หยุดเซิร์ฟเวอร์ Postgres ในเครื่อง 8:
- อัปเดตคอมโพเนนต์ Edge ในเครื่อง 8 และ 9:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - ตรวจสอบว่าคุณได้เลิกใช้งานโหนดสแตนด์บายใหม่โดยใช้ขั้นตอนข้างต้นในการเลิกใช้งานโหนด Postgres
หากใช้พื้นที่เก็บข้อมูลเครือข่าย คุณไม่จำเป็นต้องติดตั้งโหนดใหม่ ดูข้อมูลเพิ่มเติมได้ที่การอัปเกรดที่จำเป็นเป็น Postgres 9.6
สำหรับการติดตั้งแบบคลัสเตอร์ 13 โฮสต์
ดูรายการโทโพโลยี Edge และหมายเลขโหนดได้ที่โทโพโลยีการติดตั้ง
- หากคุณอัปเดตจาก 4.17.01 ให้ตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่าหากคุณเปิดใช้ SMTP ใน Edge พารามิเตอร์นี้มีรูปแบบดังนี้
SMTPMAILFROM="My Company <myco@company.com>" - ตรวจสอบว่าคุณได้ติดตั้งโหนดสแตนด์บาย Postgres ใหม่ตามที่อธิบายไว้ข้างต้นในการติดตั้งโหนดสแตนด์บาย Postgres ใหม่
หากใช้พื้นที่เก็บข้อมูลเครือข่าย คุณไม่จำเป็นต้องติดตั้งโหนดใหม่ แต่ให้จับภาพสแนปชอตเครือข่ายของที่เก็บข้อมูลที่ Postgres ใช้แทน ดูข้อมูลเพิ่มเติมได้ที่การอัปเกรดที่จำเป็นเป็น Postgres 9.6 - อัปเดต 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 - อัปเดต LDAP ในเครื่อง 4 และ 5:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - อัปเดตคอมโพเนนต์ Edge ในเครื่อง 12, 13, 6, 7, 10 และ 11 ตามลำดับต่อไปนี้
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - อัปเดต UI ในเครื่อง 6 และ 7:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile?? - อัปเดตเครื่อง 8 และ 9 ดังนี้
- หยุดเซิร์ฟเวอร์ Postgres ในเครื่อง 8:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop - หยุดเซิร์ฟเวอร์ Postgres และ postgresql ในเครื่อง 9:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - หยุดเซิร์ฟเวอร์ Qpid ในเครื่อง 12 และ 13:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop - หากติดตั้งไว้ ให้หยุดเซิร์ฟเวอร์ Postgres และ postgresql ในโหนดสแตนด์บายใหม่ที่คุณเพิ่มไว้สำหรับการย้อนกลับ
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - อัปเดต postgresql ในเครื่อง 8:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - อัปเดตฐานข้อมูล Postgres ในเครื่อง 8 (Postgres Master เท่านั้น):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - อัปเดต postgresql ในเครื่อง 9:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - เริ่มเซิร์ฟเวอร์ Postgres ในเครื่อง 8 และ 9:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start - เริ่มเซิร์ฟเวอร์ Qpid บนเครื่อง 12 และ 13:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start - กำหนดค่า Postgres เป็นโหนดสแตนด์บายโดยเรียกใช้คำสั่งต่อไปนี้ในเครื่อง 9:
> cd /opt/apigee/data/apigee-postgresql/pgdata
> rm -rf *
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile - ยืนยันสถานะการจำลองโดยเรียกใช้สคริปต์ต่อไปนี้บนเซิร์ฟเวอร์ทั้ง 2 เครื่อง ระบบควรแสดงผลลัพธ์ที่เหมือนกันในทั้ง 2 เซิร์ฟเวอร์เพื่อให้แน่ใจว่าการจำลองสำเร็จ:
ในเครื่อง 8 ซึ่งเป็นโหนดหลัก ให้เรียกใช้:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
ตรวจสอบว่าระบบระบุว่าเป็นโหนดหลัก
ในเครื่องที่ 9 ซึ่งเป็นโหนดสแตนด์บาย ให้ทำดังนี้
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
ตรวจสอบว่ามีข้อความระบุว่าเป็นโหนดสแตนด์บาย
- หยุดเซิร์ฟเวอร์ Postgres ในเครื่อง 8:
- อัปเดตคอมโพเนนต์ Edge ในเครื่อง 8 และ 9:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile?? - ตรวจสอบว่าคุณได้เลิกใช้งานโหนดสแตนด์บายใหม่โดยใช้ขั้นตอนข้างต้นในการเลิกใช้งานโหนด Postgres
หากใช้พื้นที่เก็บข้อมูลเครือข่าย คุณไม่จำเป็นต้องติดตั้งโหนดใหม่ ดูข้อมูลเพิ่มเติมได้ที่การอัปเกรดที่จำเป็นเป็น Postgres 9.6
สำหรับการติดตั้งแบบคลัสเตอร์ที่มีโฮสต์ 12 ราย
ดูรายการโทโพโลยี Edge และหมายเลขโหนดได้ที่โทโพโลยีการติดตั้ง
- หากคุณอัปเดตจาก 4.17.01 ให้ตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่าหากคุณเปิดใช้ SMTP ใน Edge พารามิเตอร์นี้มีรูปแบบดังนี้
SMTPMAILFROM="My Company <myco@company.com>" - ตรวจสอบว่าคุณได้ติดตั้งโหนดสแตนด์บาย Postgres ใหม่ตามที่อธิบายไว้ข้างต้นในการติดตั้งโหนดสแตนด์บาย Postgres ใหม่
หากใช้พื้นที่เก็บข้อมูลเครือข่าย คุณไม่จำเป็นต้องติดตั้งโหนดใหม่ แต่ให้จับภาพสแนปชอตเครือข่ายของที่เก็บข้อมูลที่ Postgres ใช้แทน ดูข้อมูลเพิ่มเติมได้ที่การอัปเกรดที่จำเป็นเป็น Postgres 9.6 - อัปเดต 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 - ทำขั้นตอนที่ 1 ซ้ำในเครื่องที่ 5
- อัปเดต qpidd ในเครื่อง 4:
- เครื่อง 10, 11 ในศูนย์ข้อมูล 2
- อัปเดต qpidd ในเครื่อง 10:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - ทำขั้นตอนที่ 1 ซ้ำในเครื่อง 11
- อัปเดต qpidd ในเครื่อง 10:
- เครื่อง 4, 5 ในศูนย์ข้อมูล 1
- อัปเดต LDAP:
- เครื่องที่ 1 ในศูนย์ข้อมูลที่ 1
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - เครื่องที่ 7 ในศูนย์ข้อมูล 2
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- เครื่องที่ 1 ในศูนย์ข้อมูลที่ 1
- อัปเดตคอมโพเนนต์ Edge โดยทำดังนี้
- เครื่อง 4, 5, 1, 2, 3 ในศูนย์ข้อมูล 1
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - เครื่อง 10, 11, 7, 8, 9 ในศูนย์ข้อมูล 2
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- เครื่อง 4, 5, 1, 2, 3 ในศูนย์ข้อมูล 1
- อัปเดต UI:
- เครื่องที่ 1 ในศูนย์ข้อมูลที่ 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - เครื่องที่ 7 ในศูนย์ข้อมูล 2:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- เครื่องที่ 1 ในศูนย์ข้อมูลที่ 1:
-
?อัปเดตเครื่อง 6 ในศูนย์ข้อมูล 1 และเครื่อง 12 ในศูนย์ข้อมูล 2
- หยุดเซิร์ฟเวอร์ Postgres ในเครื่อง 6:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop - หยุดเซิร์ฟเวอร์ Postgres และ postgresql ในเครื่อง 12:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - หยุดเซิร์ฟเวอร์ Qpid ในเครื่อง 4, 5, 10 และ 11:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop - หากติดตั้งไว้ ให้หยุดเซิร์ฟเวอร์ Postgres และ postgresql ในโหนดสแตนด์บายใหม่ที่คุณเพิ่มไว้สำหรับการย้อนกลับ
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop - อัปเดต postgresql ในเครื่อง 6:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - อัปเดตฐานข้อมูล Postgres ในเครื่อง 6 (Postgres Master เท่านั้น):
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade - อัปเดต postgresql ในเครื่อง 12:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - เริ่มเซิร์ฟเวอร์ Postgres บนเครื่อง 6 และ 12:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start - เริ่มเซิร์ฟเวอร์ Qpid บนเครื่อง 4, 5, 10 และ 11:
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start - กำหนดค่า Postgres เป็นโหนดสแตนด์บายโดยเรียกใช้คำสั่งต่อไปนี้ในเครื่อง 12:
> cd /opt/apigee/data/apigee-postgresql/pgdata
> rm -rf *
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile - ยืนยันสถานะการจำลองโดยเรียกใช้สคริปต์ต่อไปนี้บนเซิร์ฟเวอร์ทั้ง 2 เครื่อง ระบบควรแสดงผลลัพธ์ที่เหมือนกันในทั้ง 2 เซิร์ฟเวอร์เพื่อให้แน่ใจว่าการจำลองเสร็จสมบูรณ์
ในเครื่อง 6 ซึ่งเป็นโหนดหลัก ให้เรียกใช้คำสั่งต่อไปนี้
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
ตรวจสอบว่าระบบระบุว่าเป็นโหนดหลัก
ในเครื่อง 12 ซึ่งเป็นโหนดสแตนด์บาย ให้ทำดังนี้
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
ตรวจสอบว่ามีข้อความระบุว่าเป็นโหนดสแตนด์บาย
- หยุดเซิร์ฟเวอร์ Postgres ในเครื่อง 6:
- อัปเดตคอมโพเนนต์ Edge ในเครื่อง 6 และ 12:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - ตรวจสอบว่าคุณได้เลิกใช้งานโหนดสแตนด์บายใหม่โดยใช้ขั้นตอนข้างต้นในการเลิกใช้งานโหนด Postgres
หากใช้พื้นที่เก็บข้อมูลเครือข่าย คุณไม่จำเป็นต้องติดตั้งโหนดใหม่ ดูข้อมูลเพิ่มเติมได้ที่การอัปเกรดที่จำเป็นเป็น Postgres 9.6
สำหรับการติดตั้ง API BaaS แบบ 7 โฮสต์
- ตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่า พารามิเตอร์นี้มีรูปแบบดังนี้
SMTPMAILFROM="My Company <myco@company.com>" - อัปเดต Cassandra ในเครื่อง 5, 6 และ 7:
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile -
อัปเดต ElasticSearch และ API BaaS Stack ในเครื่อง 1, 2 และ 3:
> /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile - อัปเดตพอร์ทัล API BaaS ในเครื่อง 4:
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
สำหรับการติดตั้ง API BaaS แบบ 10 โฮสต์
- ตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่า พารามิเตอร์นี้มีรูปแบบดังนี้
SMTPMAILFROM="My Company <myco@company.com>" - อัปเดต Cassandra ในเครื่อง 8, 9 และ 10:
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile - อัปเดต ElasticSearch ในเครื่อง 1, 2 และ 3:
> /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile - อัปเดตสแต็ก API BaaS ในเครื่อง 4, 5 และ 6:
> /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile - อัปเดตพอร์ทัล API BaaS ในเครื่อง 7:
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
สำหรับการติดตั้ง API Baas ในศูนย์ข้อมูล 2 แห่ง
ขั้นตอนนี้กำหนดให้คุณต้องอัปเดตโหนด Cassandra ในศูนย์ข้อมูลทั้ง 2 แห่ง หากคุณแชร์โหนด Cassandra เหล่านั้นกับ Edge โดยปกติแล้วคุณจะอัปเดตโหนดเหล่านั้นเป็นส่วนหนึ่งของการอัปเดต Edge
- ตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่า พารามิเตอร์นี้มีรูปแบบดังนี้
SMTPMAILFROM="My Company <myco@company.com>" - อัปเดตคีย์สเปซ Cassandra ด้วยปัจจัยการจำลองที่ถูกต้องสำหรับศูนย์ข้อมูลทั้ง 2 แห่ง คุณต้องทำขั้นตอนนี้เพียงครั้งเดียวในเซิร์ฟเวอร์ Cassandra ในศูนย์ข้อมูลใดศูนย์ข้อมูลหนึ่ง ดังนี้
หมายเหตุ: คำสั่งด้านล่างทั้งหมดจะตั้งค่าปัจจัยการจำลองเป็น "3" ซึ่งหมายถึงโหนด Cassandra 3 โหนดในคลัสเตอร์ แก้ไขค่านี้ตามความจำเป็นสำหรับการติดตั้ง- เริ่มยูทิลิตี Cassandra cqlsh:
> /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP - เรียกใช้คำสั่ง CQL ต่อไปนี้ที่พรอมต์ "cqlsh>" เพื่อตั้งค่าระดับการจำลองสำหรับคีย์สเปซ Cassandra
- cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
- cqlsh> ALTER KEYSPACE "Apigee_Baas" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
- cqlsh> ALTER KEYSPACE "Apigee_Baas_Locks" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
- cqlsh> ALTER KEYSPACE "system_traces" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
- cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
- ดูคีย์สเปซโดยใช้คำสั่งต่อไปนี้
cqlsh> select * from system.schema_keyspaces; - ออกจาก cqlsh:
cqlsh> exit
- เริ่มยูทิลิตี Cassandra cqlsh:
- (เฉพาะในกรณีที่คุณไม่ได้อัปเดต Cassandra เป็นส่วนหนึ่งของการอัปเดต Edge) อัปเดตโหนด Cassandra ในศูนย์ข้อมูล 1 ทีละเครื่อง:
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile - (เฉพาะในกรณีที่คุณไม่ได้อัปเดต Cassandra เป็นส่วนหนึ่งของการอัปเดต Edge) อัปเดตโหนด Cassandra ในศูนย์ข้อมูล 2 ทีละเครื่อง:
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile - อัปเดต ElasticSearch ในเครื่องในศูนย์ข้อมูล 1 ทีละเครื่อง:
> /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile - อัปเดต ElasticSearch ในเครื่องในศูนย์ข้อมูล 2 ทีละเครื่อง:
> /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile - อัปเดตสแต็ก API BaaS ในเครื่องในศูนย์ข้อมูล 1 ทีละเครื่อง:
> /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile - อัปเดต API BaaS Stack ในเครื่องในศูนย์ข้อมูล 2 ทีละเครื่อง:
> /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile - อัปเดตพอร์ทัล API BaaS ในเครื่องในศูนย์ข้อมูล 1 ทีละเครื่อง:
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile - อัปเดตพอร์ทัล API BaaS ในเครื่องในศูนย์ข้อมูล 2 ทีละเครื่อง:
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile - อัปเดตค่าคีย์สเปซ BaaS ต้องตั้งค่าคีย์สเปซเหล่านี้สำหรับการจำลองแบบ ณ เวลาติดตั้ง แต่ไม่จำเป็นต้องตั้งค่า ณ รันไทม์ การนำการจำลองออกยังช่วยประหยัดหน่วยความจำ Cassandra ด้วย
คุณต้องทำขั้นตอนนี้เพียงครั้งเดียวในเซิร์ฟเวอร์ Cassandra ในศูนย์ข้อมูลใดศูนย์ข้อมูลหนึ่ง ดังนี้- เริ่มยูทิลิตี Cassandra cqlsh:
> /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP - เรียกใช้คำสั่ง CQL ต่อไปนี้เพื่อตั้งค่าระดับการจำลองสำหรับคีย์สเปซ Cassandra
- cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3' };
- cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-2': '3' };
- ดูคีย์สเปซโดยใช้คำสั่งต่อไปนี้
cqlsh> select * from system.schema_keyspaces; - ออกจาก cqlsh:
cqlsh> exit
- เริ่มยูทิลิตี Cassandra cqlsh:
สำหรับการติดตั้งที่ไม่ได้มาตรฐาน
หากคุณมีการติดตั้งที่ไม่ได้มาตรฐาน ให้อัปเดตคอมโพเนนต์ Edge ตามลำดับต่อไปนี้
- ZooKeeper
- Cassandra
- qpidd, ps
- LDAP
- Edge หมายถึงโปรไฟล์ "-c edge" ในโหนดทั้งหมดตามลำดับ ได้แก่ โหนดที่มีเซิร์ฟเวอร์ Qpid, เซิร์ฟเวอร์ Postgres, Management Server, Message Processor และเราเตอร์
หมายเหตุ: หากโหนดมีทั้งเซิร์ฟเวอร์ Qpid และเซิร์ฟเวอร์ Postgres ติดตั้งอยู่ ให้เรียกใช้ขั้นตอนโปรไฟล์ "-c edge" - Edge UI