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

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

ผู้ที่ทำการอัปเดตได้

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

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

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

สำรองข้อมูล

สำรองข้อมูลโหนดทั้งหมดของ 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. ดาวน์โหลดและเรียกใช้ Bootstrap ของ 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 เช่น การเพิ่มหรือนำ Message Processor ออก เป็นต้น

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

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

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

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

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

ย้อนกลับ

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

  1. ทำตามขั้นตอนการย้อนกลับใน Observer และ Follower ก่อน
  2. ดาวน์โหลดและเรียกใช้ Bootstrap ของเวอร์ชันที่คุณจะย้อนกลับไป ซึ่งอาจเป็น 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 โหนดที่กำหนดค่าสำหรับการจำลองแบบ 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.50.00 หรือ 4.51.00) ไม่ใช่สำหรับเวอร์ชัน 4.52.00

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

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

    1. ใน Postgres 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 ใน Postgres Master โดยทำดังนี้ 
      /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. ดาวน์โหลดไฟล์ 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
        2. ติดตั้งยูทิลิตี Edge apigee-service และทรัพยากร Dependency โดยทำดังนี้ 
          sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

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

        1. ดาวน์โหลดไฟล์ Edge bootstrap_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
        2. ติดตั้งยูทิลิตี Edge apigee-service และทรัพยากร Dependency โดยทำดังนี้ 
          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. เรียกใช้คำสั่งกำหนดค่าในโฮสต์หลัก ดังนี้ 
      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 ใน Postgres Master โดยทำดังนี้ 
      /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 โดยทำการเรียก Edge Management API ต่อไปนี้ในโหนดเซิร์ฟเวอร์การจัดการ 
      curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

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

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

    Postgres สามารถค่อยๆ สร้างสถิติใหม่เมื่อเวลาผ่านไปเมื่อมีการเรียกใช้การค้นหาและเมื่อ Daemon ของ Autovacuum ทำงาน อย่างไรก็ตาม การค้นหาอาจช้าจนกว่าจะมีการสร้างสถิติใหม่

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

    UI ใหม่ของ Edge

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

    อัปเดตด้วย 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/เราเตอร์)
    3. อัปเดตเราเตอร์ที่เลือกและคอมโพเนนต์ Edge อื่นๆ ทั้งหมดในเครื่องเดียวกับเราเตอร์ การกำหนดค่า Edge ทั้งหมดจะแสดงเราเตอร์และ Message Processor ในโหนดเดียวกัน
    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. ดาวน์โหลดไฟล์ 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
      2. ติดตั้งยูทิลิตีและทรัพยากร 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 เพื่อระบุวิธีจัดการการติดตั้ง 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: Management Server, Message Processor, Router, QPID Server, Postgres Server
          • ldap: OpenLDAP
          • ps: postgresql
          • qpid: qpidd
          • sso: Apigee SSO (หากคุณติดตั้ง SSO)
          • ue: UI ใหม่ของ Edge
          • ui: UI ของ Edge แบบคลาสสิก
          • zk: ผู้ดูแลสัตว์
        • configFile เป็นไฟล์การกำหนดค่าเดียวกับที่คุณใช้กำหนดคอมโพเนนต์ Edge ระหว่างการติดตั้ง 4.50.00 หรือ 4.51.00

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

        /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
      7. รีสตาร์ทคอมโพเนนต์ Edge UI ในโหนดทั้งหมดที่เรียกใช้คอมโพเนนต์ดังกล่าว หากยังไม่ได้ดำเนินการ 
        /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|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. ในโหนดใหม่ ให้แตกไฟล์ tar ไปยังไดเรกทอรี /tmp โดยทำดังนี้ 
          tar -xzf apigee-4.52.00.tar.gz

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

        4. ติดตั้งยูทิลิตี Edge apigee-service และทรัพยากร Dependency จาก /tmp/repos โดยทำดังนี้ 
          sudo bash /tmp/repos/bootstrap_4.52.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

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

        3. ในโหนดระยะไกล ให้ติดตั้งยูทิลิตี Edge apigee-setup และทรัพยากร Dependency โดยทำดังนี้ 
          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 ทั้งหมด ยกเว้น Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres Server
          • ldap: OpenLDAP
          • ps: postgresql
          • qpid: qpidd
          • sso: Apigee SSO (หากคุณติดตั้ง SSO)
          • ue UI ใหม่ของ Edge
          • ui: UI ของ Edge แบบคลาสสิก
          • zk: ผู้ดูแลสัตว์
        • configFile เป็นไฟล์การกำหนดค่าเดียวกับที่คุณใช้กำหนดคอมโพเนนต์ Edge ระหว่างการติดตั้ง 4.50.00 หรือ 4.51.00

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

        /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 หลายรายการ (Management Server, Message Processor, Router, QPID Server แต่ไม่ใช่ Postgres Server) ให้ใช้ตัวเลือก -c edge เพื่ออัปเดตคอมโพเนนต์ทั้งหมดพร้อมกัน
      • หากขั้นตอนระบุว่าควรดำเนินการในเครื่องหลายเครื่อง ให้ดำเนินการตามลำดับเครื่องที่ระบุ
      • ไม่มีขั้นตอนแยกต่างหากในการอัปเดตการสร้างรายได้ ระบบจะอัปเดตเมื่อคุณระบุตัวเลือก -c edge

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

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

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

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

      ดูรายการโทโพโลยี 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. รีสตาร์ทคอมโพเนนต์ 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 ตามลำดับต่อไปนี้

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

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