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

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

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

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

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

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

  1. ถ้าไม่มีการติดตั้งในโหนด ZooKeeper ให้ติดตั้ง nc: 
      sudo yum install nc
  2. เรียกใช้คำสั่ง 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 เป็นสแตนด์อโลน

  3. ทำขั้นตอนที่ 1 และ 2 ซ้ำในแต่ละโหนด ZooKeeper

อัปเกรด Zookeeper ในโหนดผู้สังเกตการณ์และผู้ติดตาม

อัปเกรด Zookeeper ในโหนดผู้สังเกตการณ์และโหนดผู้ติดตามแต่ละรายการ ดังนี้

  1. ดาวน์โหลดและเรียกใช้การเริ่มต้นระบบของ Edge for Private Cloud 4.52 ตามที่อธิบายไว้ในหัวข้ออัปเดตเป็น 4.52.00 ในโหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก กระบวนการนี้อาจแตกต่างกันไป ขึ้นอยู่กับว่าโหนดมีการเชื่อมต่ออินเทอร์เน็ตภายนอกหรือคุณกำลังติดตั้งแบบออฟไลน์
  2. อัปเกรดคอมโพเนนต์ Zookeeper โดยทำดังนี้ 
      /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
     หมายเหตุ: หากโหนดเหล่านี้มีคอมโพเนนต์อื่นติดตั้งอยู่แล้ว (เช่น Cassandra) คุณก็อัปเกรดคอมโพเนนต์ดังกล่าวได้เลย (เช่น โดยใช้โปรไฟล์ cs,zk) หรือจะอัปเกรดคอมโพเนนต์อื่นๆ ในภายหลังก็ได้ Apigee ขอแนะนําให้คุณอัปเกรด Zookeeper เท่านั้นก่อน และตรวจสอบว่าคลัสเตอร์ทํางานอย่างถูกต้องก่อนอัปเกรดคอมโพเนนต์อื่นๆ
  3. ทำตามขั้นตอนข้างต้นซ้ำในแต่ละโหนดผู้สังเกตการณ์และผู้ติดตามของ Zookeeper

ปิดเครื่องผู้นำ

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

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

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

ยืนยันว่ามีการเลือกผู้นำคนใหม่แล้ว

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

ผู้นำการอัปเกรด

ทำตามขั้นตอนเดียวกับใน การอัปเกรด Zookeeper ในโหนดผู้สังเกตการณ์และผู้ติดตามด้านบน

เมื่ออัปเกรดโหนดผู้นำเดิมแล้ว ให้ตรวจสอบสถานะคลัสเตอร์และตรวจสอบว่ามีโหนดผู้นำ

ย้อนกลับ

ในกรณีที่จำเป็นต้องย้อนกลับ

  1. ดำเนินการตามขั้นตอนการย้อนกลับกับผู้สังเกตการณ์และผู้ติดตามก่อน
  2. ดาวน์โหลดและเรียกใช้การเริ่มต้นระบบของเวอร์ชันที่จะเปลี่ยนกลับไปใช้ ซึ่งอาจเป็น 4.50 หรือ 4.51 กระบวนการนี้อาจแตกต่างกันไป ขึ้นอยู่กับว่าโหนดมีการเชื่อมต่ออินเทอร์เน็ตภายนอกหรือคุณกำลังทำการติดตั้งแบบออฟไลน์
  3. หยุด Zookeeper หากกำลังทำงานอยู่บนโหนด 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
  4. ถอนการติดตั้ง Zookeeper ที่มีอยู่: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall
  • ติดตั้ง Zookeeper ตามปกติ 
      /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>
  • เมื่อรีเซ็ตโหนดติดตามและผู้สังเกตการณ์ทั้งหมดแล้ว ให้รีเซ็ตโหนดผู้นำโดยทำตามขั้นตอนที่ 2-5 ในโหนดผู้นำ
  • หลังจากเปลี่ยนกลับโหนดทั้งหมดแล้ว ให้ตรวจสอบประสิทธิภาพของคลัสเตอร์และดูว่ามีโหนดผู้นำในคลัสเตอร์

    • คืนค่าข้อมูลสำรอง

    โปรดดูหัวข้อกู้คืนจากข้อมูลสํารอง โปรดทราบว่าการสำรองข้อมูล Zookeeper ที่มาจาก Edge for Private Cloud เวอร์ชันเก่า เช่น 4.50 และ 4.51 ควรเข้ากันได้กับ Zookeeper เวอร์ชันใน Edge for Private Cloud 4.52

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

    Edge เวอร์ชันนี้มีการอัปเกรดเป็น Postgres 14 การอัปเกรดดังกล่าวทำให้มีการย้ายข้อมูล Postgres ทั้งหมดไปยัง Postgres 14

    ระบบเวอร์ชันที่ใช้งานจริงส่วนใหญ่ของ Edge ใช้โหนด Postgres 2 โหนดที่กําหนดค่าไว้สําหรับการจําลองข้อมูลแบบมาสเตอร์สแตนด์บาย ในระหว่างขั้นตอนการอัปเดต ขณะที่โหนด 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.50.00 หรือ 4.51.00) ไม่ใช่สำหรับเวอร์ชัน 4.52.00

    หากต้องการติดตั้ง ให้ใช้ไฟล์การกําหนดค่าเดียวกับที่ใช้ติดตั้ง Edge เวอร์ชันปัจจุบัน

    วิธีสร้างโหนดสแตนด์บาย Postgres ใหม่

    1. ใน PostgreSQL Master ปัจจุบัน ให้แก้ไขไฟล์ /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 ของโหนดสแตนด์บายใหม่

    2. รีสตาร์ท apigee-postgresql ใน PostgreSQL หลักโดยทำดังนี้ 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
    3. ตรวจสอบว่าได้เพิ่มโหนดสแตนด์บายใหม่โดยการดูไฟล์ /opt/apigee/apigee-postgresql/conf/pg_hba.conf บนต้นแบบ คุณควรเห็นบรรทัดต่อไปนี้ในไฟล์นั้น 
      host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
    4. ติดตั้งเซิร์ฟเวอร์สแตนด์บาย Postgres ใหม่ โดยทำดังนี้
      1. แก้ไขไฟล์การกำหนดค่าที่คุณใช้ติดตั้ง 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
      2. ปิดใช้ SELinux ตามที่อธิบายไว้ในติดตั้งยูทิลิตี apigee-setup ของ Edge

      3. หากคุณใช้ Edge 4.51.00 อยู่ ให้ทำดังนี้

        1. ดาวน์โหลดไฟล์ bootstrap_4.51.00.sh ของ Edge ไปยัง /tmp/bootstrap_4.51.00.sh 
          curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
        2. ติดตั้งยูทิลิตีและการอ้างอิง Edge apigee-service: 
          sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

        หากคุณใช้ Edge 4.50.00 อยู่ ให้ทำดังนี้

        1. ดาวน์โหลดไฟล์ bootstrap_4.50.00.sh ของ Edge ไปยัง /tmp/bootstrap_4.50.00.sh 
          curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
        2. ติดตั้งยูทิลิตี apigee-service ของ Edge และข้อกําหนดเบื้องต้น 
          sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
      4. ใช้ apigee-service เพื่อติดตั้งยูทิลิตี apigee-setup: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      5. ติดตั้ง Postgres 
        /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
      6. ในโหนดสแตนด์บายใหม่ ให้เรียกใช้คำสั่งต่อไปนี้ 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        ยืนยันว่าอยู่ในโหมดสแตนด์บาย

    การอัปเกรด Postgres ในพื้นที่

    หมายเหตุ: คุณต้องทําขั้นตอนเบื้องต้นต่อไปนี้ก่อนดำเนินการอัปเกรด Postgres ในพื้นที่

    ขั้นตอนเบื้องต้น

    ก่อนทำการอัปเกรดในตัวสำหรับ Postgres ให้ทำตามขั้นตอนต่อไปนี้ทั้งกับโฮสต์หลักและสแตนด์บายเพื่ออัปเดตพร็อพเพอร์ตี้ max_locks_per_transaction ใน apigee-postgresql

    1. หากไม่มี ให้สร้างไฟล์ /opt/apigee/customer/application/postgresql.properties
    2. เปลี่ยนการเป็นเจ้าของไฟล์นี้ให้ apigee 
      sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
    3. เพิ่มพร็อพเพอร์ตี้ต่อไปนี้ลงในไฟล์ 
      conf/postgresql.conf+max_locks_per_transaction=30000
    4. กำหนดค่า apigee-postgresql 
      apigee-service apigee-postgresql configure
    5. รีสตาร์ท apigee-postgresql 
      apigee-service apigee-postgresql restart

    ทำการอัปเกรดในเวอร์ชันเดิม

    หากต้องการอัปเกรดที่มีอยู่เพื่ออัปเกรดเป็น Postgres 14 ให้ทำตามขั้นตอนต่อไปนี้

    1. อัปเกรด postgres ในโฮสต์หลัก 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
    2. เรียกใช้คำสั่งการตั้งค่าในโฮสต์หลัก 
      apigee-service apigee-postgresql setup -f /opt/silent.conf
    3. เรียกใช้คําสั่ง configure ในโฮสต์หลัก 
      apigee-service apigee-postgresql configure
    4. รีสตาร์ทโฮสต์หลักดังนี้ 
      apigee-service apigee-postgresql restart
    5. กำหนดค่าเป็นอุปกรณ์หลัก 
      apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
    6. ตรวจสอบว่าโฮสต์หลักเริ่มทำงานแล้ว โดยทำดังนี้ 
      apigee-service apigee-postgresql wait_for_ready
    7. วิธีหยุดโหมดสแตนด์บาย 
      apigee-service apigee-postgresql stop
    8. อัปเกรดโหมดสแตนด์บาย

      หมายเหตุ: หากขั้นตอนนี้มีข้อผิดพลาด/ดำเนินการไม่สำเร็จ คุณก็ไม่ต้องสนใจขั้นตอนนี้ update.sh จะพยายามเริ่มเซิร์ฟเวอร์สแตนด์บายด้วยการกำหนดค่าที่ไม่ถูกต้อง หากการติดตั้ง Postgres ได้รับการอัปเกรดเป็น 14 ระบบจะไม่สนใจข้อผิดพลาดดังกล่าว

      /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
    9. ตรวจสอบว่าระบบสแตนด์บายหยุดแล้ว โดยทำดังนี้ 
      apigee-service apigee-postgresql stop
    10. นำการกำหนดค่าสแตนด์บายเดิมออก โดยทำดังนี้ 
      rm -rf /opt/apigee/data/apigee-postgresql/
    11. ตั้งค่าการจำลองข้อมูลในเซิร์ฟเวอร์สแตนด์บาย 
      apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf
    12. นำบรรทัด conf/postgresql.conf+max_locks_per_transaction=30000 ออกจากไฟล์ /opt/apigee/customer/application/postgresql.properties ในทั้งโฮสต์หลักและโฮสต์สแตนด์บาย เพิ่มบรรทัดนี้ในขั้นตอนเบื้องต้น

    หลังจากทำตามขั้นตอนนี้เสร็จแล้ว ระบบจะเข้าสู่โหมดสแตนด์บายได้สําเร็จ

    การเลิกใช้งานโหนด Postgres

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

    1. ตรวจสอบว่า Postgres ทำงานอยู่ 
      /opt/apigee/apigee-service/bin/apigee-all status

      หาก Postgres ไม่ได้ทำงานอยู่ ให้เริ่มต้นดังนี้ 

      /opt/apigee/apigee-service/bin/apigee-all start
    2. รับ UUID ของโหนดสแตนด์บายใหม่โดยเรียกใช้คำสั่ง curl ต่อไปนี้ในโหนดสแตนด์บายใหม่ 
      curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

      คุณควรเห็น UUID ของโหนดที่ส่วนท้ายของเอาต์พุตในรูปแบบต่อไปนี้ 

      "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
    3. หยุดโหนดสแตนด์บายใหม่โดยเรียกใช้คำสั่งต่อไปนี้ในโหนดสแตนด์บายใหม่ 
      /opt/apigee/apigee-service/bin/apigee-all stop
    4. ในโหนดหลักของ 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
    5. รีสตาร์ท apigee-postgresql ใน PostgreSQL หลักโดยทำดังนี้ 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
    6. ตรวจสอบว่าได้นำโหนดสแตนด์บายใหม่ออกโดยดูไฟล์ /opt/apigee/apigee-postgresql/conf/pg_hba.conf บนต้นแบบ คุณควรเห็นเฉพาะบรรทัดต่อไปนี้ในไฟล์นั้น 
      host replication apigee existing_standby_ip/32 trust
    7. ลบ UUID ของโหนดสแตนด์บายออกจาก ZooKeeper โดยเรียกใช้ API การจัดการ Edge ต่อไปนี้ในโหนดเซิร์ฟเวอร์การจัดการ 
      curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

    ขั้นตอนหลังการอัปเกรดสำหรับ Postgres

    หลังจากการอัปเกรด Postgres ครั้งใหญ่ ระบบจะลบสถิติภายในของ Postgres ออก สถิติเหล่านี้ช่วยนักวางแผนการค้นหาของ Postgres ในการใช้ดัชนีและเส้นทางที่เหมาะสมที่สุดเพื่อดำเนินการค้นหา

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

    หากต้องการแก้ไขปัญหานี้ ให้เรียกใช้ ANALYZE ในตารางทั้งหมดในฐานข้อมูลบนโหนดหลัก Postgres หรือจะเรียกใช้ ANALYZE สำหรับตาราง 2-3 ตารางพร้อมกันก็ได้

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

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

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

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

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

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

    อัปเดต UI ของ Edge

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

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

    หากต้องการอัปเดต 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 ตัวขึ้นไป

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

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

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

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

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

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

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

    1. หากมี ให้ปิดใช้งานงาน cron ที่กําหนดค่าให้ดําเนินการซ่อมใน Cassandra จนกว่าการอัปเดตจะเสร็จสมบูรณ์
    2. เข้าสู่ระบบโหนดในฐานะรูทเพื่อติดตั้ง Edge RPM
    3. ติดตั้ง yum-utils และ yum-plugin-priorities โดยทำดังนี้ 
      sudo yum install yum-utils
sudo yum install yum-plugin-priorities
    4. ปิดใช้ SELinux ตามที่อธิบายไว้ในติดตั้งยูทิลิตี apigee-setup ของ Edge
    5. หากกำลังติดตั้งใน Oracle 7.x ให้ใช้คำสั่งต่อไปนี้ 
      sudo yum-config-manager --enable ol7_optional_latest
    6. หากติดตั้งใน 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

    7. หากคุณใช้ Edge 4.51.00 อยู่ ให้ทำดังนี้

      1. ดาวน์โหลดไฟล์ bootstrap_4.52.00.sh ของ Edge ไปยัง /tmp/bootstrap_4.52.00.sh 
        curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
      2. ติดตั้งยูทิลิตีและรายการที่เกี่ยวข้องของ apigee-service Edge 4.52.00 โดยดำเนินการตามคำสั่งต่อไปนี้ 
        sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord

        โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณได้รับจาก Apigee หากละเว้น pWord ระบบจะแจ้งให้คุณป้อน

        โดยค่าเริ่มต้น โปรแกรมติดตั้งจะตรวจสอบว่าคุณติดตั้ง Java 1.8 แล้ว หากไม่ ช่างติดตั้งจะติดตั้งให้คุณ

        ใช้ตัวเลือก JAVA_FIX เพื่อระบุวิธีจัดการการติดตั้ง Java JAVA_FIX จะใช้ค่าต่อไปนี้

        • I: ติดตั้ง OpenJDK 1.8 (ค่าเริ่มต้น)
        • C: ดำเนินการต่อโดยไม่ติดตั้ง Java
        • Q: ออก สำหรับตัวเลือกนี้ คุณต้องติดตั้ง Java ด้วยตนเอง
      3. ใช้ apigee-service เพื่ออัปเดตยูทิลิตี apigee-setup ดังที่แสดงในตัวอย่างต่อไปนี้ 
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      4. อัปเดตยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการ ดังที่แสดงในตัวอย่างต่อไปนี้ 
        /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
      5. อัปเดตยูทิลิตี apigee-provision ในเซิร์ฟเวอร์การจัดการ ดังที่แสดงในตัวอย่างต่อไปนี้ 
        /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
      6. เรียกใช้ยูทิลิตี update ในโหนดโดยดำเนินการตามคำสั่งต่อไปนี้ 
        /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

        โดยทําตามลําดับที่อธิบายไว้ในลําดับการอัปเดตเครื่อง

        สถานที่:

        • component คือคอมโพเนนต์ Edge ที่จะอัปเดต ค่าที่เป็นไปได้ ได้แก่
          • cs: Cassandra
          • edge: คอมโพเนนต์ Edge ทั้งหมดยกเว้น Edge UI ได้แก่ เซิร์ฟเวอร์การจัดการ, ตัวประมวลผลข้อความ, เราเตอร์, เซิร์ฟเวอร์ QPID, เซิร์ฟเวอร์ Postgres
          • ldap: OpenLDAP
          • ps: postgresql
          • qpid: qpidd
          • sso: Apigee SSO (หากคุณติดตั้ง SSO)
          • ue: UI ของ Edge เวอร์ชันใหม่
          • ui: UI ของ Edge แบบคลาสสิก
          • zk: Zookeeper
        • configFile คือไฟล์การกําหนดค่าเดียวกับที่คุณใช้กําหนดคอมโพเนนต์ Edge ในระหว่างการติดตั้ง 4.50.00 หรือ 4.51.00

        คุณสามารถเรียกใช้ update.sh กับคอมโพเนนต์ทั้งหมดได้โดยการตั้งค่า component เป็น "all" แต่ต้องมีโปรไฟล์การติดตั้งแบบ "All-in-One" (AIO) ของ Edge เท่านั้น เช่น

        /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
      7. รีสตาร์ทคอมโพเนนต์ UI ของ Edge ในโหนดทั้งหมดที่ใช้อยู่ หากยังไม่ได้ดำเนินการ 
        /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
      8. ทดสอบการอัปเดตโดยเรียกใช้ยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการ ตามที่อธิบายไว้ในทดสอบการติดตั้ง

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

      อัปเดตเป็น 4.52.00 จากที่เก็บในเครื่อง

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

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

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

      วิธีอัปเดตจากที่เก็บในเครื่อง 4.52.00

      1. สร้างที่เก็บข้อมูล 4.52.00 ในพื้นที่ตามที่อธิบายไว้ใน "สร้างที่เก็บข้อมูล Apigee ในพื้นที่" ที่ ติดตั้งยูทิลิตี apigee-setup ของ Edge
      2. วิธีติดตั้ง apigee-service จากไฟล์ .tar
        1. ในโหนดที่มีที่เก็บข้อมูลในเครื่อง ให้ใช้คำสั่งต่อไปนี้เพื่อจัดแพ็กเกจที่เก็บข้อมูลในเครื่องเป็นไฟล์ .tar ไฟล์เดียวชื่อ /opt/apigee/data/apigee-mirror/apigee-4.52.00.tar.gz 
          /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
        2. คัดลอกไฟล์ .tar ไปยังโหนดที่ต้องการอัปเดต Edge เช่น คัดลอกไปยังไดเรกทอรี /tmp ในโหนดใหม่
        3. ในโหนดใหม่ ให้ยกเลิกการอัปโหลดไฟล์ไปยังไดเรกทอรี /tmp: 
          tar -xzf apigee-4.52.00.tar.gz

          คำสั่งนี้จะสร้างไดเรกทอรีใหม่ชื่อ repos ในไดเรกทอรีที่มีไฟล์ .tar เช่น /tmp/repos

        4. ติดตั้งยูทิลิตี apigee-service ของ Edge และไลบรารีต่อไปนี้จาก /tmp/repos 
          sudo bash /tmp/repos/bootstrap_4.52.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

          โปรดทราบว่าคุณใส่เส้นทางไปยังไดเรกทอรี repos ในคำสั่งนี้

      3. วิธีติดตั้ง apigee-service โดยใช้เว็บเซิร์ฟเวอร์ Nginx
        1. กำหนดค่าเว็บเซิร์ฟเวอร์ Nginx ตามที่อธิบายไว้ใน "ติดตั้งจากที่เก็บโดยใช้เว็บเซิร์ฟเวอร์ Nginx" ที่ติดตั้งยูทิลิตี Apigee-setup ของ Edge
        2. ในโหนดระยะไกล ให้ดาวน์โหลดไฟล์ bootstrap_4.52.00.sh ของ Edge ไปยัง /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 ของโหนดที่เก็บ

        3. ในโหนดระยะไกล ให้ติดตั้งยูทิลิตี apigee-setup ของ Edge และข้อกําหนดต่อไปนี้ 
          sudo bash /tmp/bootstrap_4.52.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

          โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านของรีโป

      4. ใช้ apigee-service เพื่ออัปเดตยูทิลิตี apigee-setup ดังที่แสดงในตัวอย่างต่อไปนี้ 
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      5. อัปเดตยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการ ดังที่แสดงในตัวอย่างต่อไปนี้ 
        /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
      6. อัปเดตยูทิลิตี apigee-provision ในเซิร์ฟเวอร์การจัดการ ดังที่แสดงในตัวอย่างต่อไปนี้ 
        /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
      7. เรียกใช้ยูทิลิตี update ในโหนดตามลำดับที่อธิบายไว้ในลำดับการอัปเดตเครื่อง 
        /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

        สถานที่:

        • component คือคอมโพเนนต์ Edge ที่จะอัปเดต โดยปกติแล้วคุณจะต้องอัปเดตคอมโพเนนต์ต่อไปนี้
          • cs: Cassandra
          • edge: คอมโพเนนต์ Edge ทั้งหมดยกเว้น UI ของ Edge: เซิร์ฟเวอร์การจัดการ เครื่องประมวลผลข้อความ รูทเตอร์ เซิร์ฟเวอร์ QPID, เซิร์ฟเวอร์ Postgres
          • ldap: OpenLDAP
          • ps: postgresql
          • qpid: qpidd
          • sso: Apigee SSO (หากคุณติดตั้ง SSO)
          • ue UI ของ Edge ใหม่
          • ui: UI ของ Edge แบบคลาสสิก
          • zk: Zookeeper
        • configFile เป็นไฟล์การกำหนดค่าเดียวกันกับที่คุณใช้เพื่อกำหนดคอมโพเนนต์ Edge ระหว่างการติดตั้ง 4.50.00 หรือ 4.51.00

        คุณสามารถเรียกใช้ update.sh กับคอมโพเนนต์ทั้งหมดได้โดยตั้งค่า component เป็น "all" แต่ต้องมีโปรไฟล์การติดตั้งแบบ "All-in-One" (AIO) ของ Edge เท่านั้น เช่น

        /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
      8. รีสตาร์ทคอมโพเนนต์ UI ในโหนดทั้งหมดที่ใช้อยู่ หากยังไม่ได้ดำเนินการ 
        /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
      9. ทดสอบการอัปเดตโดยเรียกใช้ยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการ ตามที่อธิบายไว้ในทดสอบการติดตั้ง

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

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

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

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

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

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

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

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

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

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

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

        โดยที่ sso_config_file คือไฟล์การกําหนดค่าที่คุณสร้างขึ้นเมื่อติดตั้ง SSO

      8. รีสตาร์ทคอมโพเนนต์ UI ของ Edge ในเครื่องที่ 1 โดยทำดังนี้ 
        /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

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

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

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

      1. อัปเดต Cassandra และ ZooKeeper ในเครื่องที่ 1, 2 และ 3 
        /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
      2. อัปเดต Qpid และ Postgres ในเครื่อง 4: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
      3. อัปเดต Qpid และ Postgres ในเครื่อง 5: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
      4. อัปเดต LDAP ในเครื่อง 1: 
        /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
      5. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 4, 5, 1, 2, 3 
        /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
      6. อัปเดต UI ของ Edge โดยทำดังนี้
        • UI แบบคลาสสิก: หากคุณใช้ UI แบบคลาสสิก ให้อัปเดตคอมโพเนนต์ ui ในเครื่อง 1 ดังตัวอย่างต่อไปนี้ 
          /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
        • UI ของ Edge ใหม่: หากคุณติดตั้ง UI ของ Edge ใหม่ ให้อัปเดตคอมโพเนนต์ ue ในเครื่องที่เหมาะสม (อาจไม่ใช่เครื่องที่ 1) ดังนี้ 
          /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
      7. (หากคุณติดตั้ง apigee-adminapi) อัปเดตยูทิลิตี apigee-adminapi ในเครื่อง 1 แล้ว: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
      8. (หากคุณติดตั้ง Apigee SSO) อัปเดต Apigee SSO ในเครื่องที่ 1 โดยทำดังนี้ 
        /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

        โดยที่ sso_config_file คือไฟล์การกําหนดค่าที่คุณสร้างขึ้นเมื่อติดตั้ง SSO

      9. รีสตาร์ทคอมโพเนนต์ UI โดยทำดังนี้
        • UI แบบคลาสสิก: หากคุณใช้ UI แบบคลาสสิก ให้รีสตาร์ทคอมโพเนนต์ edge-ui ในเครื่อง 1 ดังที่แสดงในตัวอย่างต่อไปนี้ 
          /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
        • UI ของ Edge ใหม่: หากคุณติดตั้ง UI ของ Edge ใหม่ ให้รีสตาร์ทคอมโพเนนต์ edge-management-ui ในเครื่องที่เหมาะสม (อาจไม่ใช่เครื่องที่ 1) 
          /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

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

        โดยที่ sso_config_file คือไฟล์การกำหนดค่าที่คุณสร้างขึ้นเมื่อติดตั้ง SSO

      10. รีสตาร์ทคอมโพเนนต์ UI โดยทำดังนี้
        • UI แบบคลาสสิก: หากคุณใช้ UI แบบคลาสสิก ให้รีสตาร์ทคอมโพเนนต์ edge-ui ในเครื่อง 1 ดังที่แสดงในตัวอย่างต่อไปนี้ 
          /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
        • Edge UI ใหม่: หากคุณติดตั้ง EDGE UI ใหม่ ให้รีสตาร์ท คอมโพเนนต์ edge-management-ui ในเครื่องที่เหมาะสม (อาจไม่ใช่เครื่อง 1) ดังนี้ 
          /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

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

        โดยที่ sso_config_file คือไฟล์การกําหนดค่าที่คุณสร้างขึ้นเมื่อติดตั้ง SSO

      10. รีสตาร์ทคอมโพเนนต์ UI โดยทำดังนี้
        • UI แบบคลาสสิก: หากคุณใช้ UI แบบคลาสสิก ให้รีสตาร์ทคอมโพเนนต์ edge-ui ในเครื่องที่ 6 และ 7 ดังที่แสดงในตัวอย่างต่อไปนี้ 
          /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
        • UI ของ Edge ใหม่: หากคุณติดตั้ง UI ของ Edge ใหม่ ให้รีสตาร์ทคอมโพเนนต์ edge-management-ui ในเครื่องที่ 6 และ 7 โดยทำดังนี้ 
          /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

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

          3. โดยที่ sso_config_file คือไฟล์การกําหนดค่าที่คุณสร้างขึ้นเมื่อติดตั้ง SSO

      9. รีสตาร์ทคอมโพเนนต์ UI ของ Edge ใหม่ (edge-management-ui) หรือ UI ของ Edge แบบคลาสสิก (edge-ui) ในเครื่องที่ 1 และ 7 โดยทำดังนี้ 
        /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

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

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

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

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