อัปเดต 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 สำหรับ Private Cloud มีการอัปเกรดเป็น Zookeeper 3.8.0 ในการอัปเกรดครั้งนี้ ระบบจะย้ายข้อมูล Zookeeper ทั้งหมดไปยัง Zookeeper 3.8.0

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

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

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

สำรองข้อมูล

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

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

หากใช้เครื่องเสมือนและมีความสามารถ คุณยังอาจใช้สแนปชอตหรือข้อมูลสํารองของ VM เพื่อกู้คืนหรือเปลี่ยนกลับ (หากจําเป็น) ได้

ระบุผู้นำ ผู้ติดตาม และผู้สังเกตการณ์

หมายเหตุ: ตัวอย่างคําสั่งด้านล่างใช้ยูทิลิตี nc เพื่อส่งข้อมูลไปยัง Zookeeper คุณสามารถใช้ยูทิลิตีอื่นเพื่อส่งข้อมูลไปยัง Zookeeper ได้ด้วย

  1. หากยังไม่ได้ติดตั้ง nc ในโหนด ZooKeeper ให้ทำดังนี้ 
      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

      ในการกำหนดค่า 1 โหนดและ 2 โหนดของ Edge ซึ่งเป็นโทโปโลยีที่ใช้สำหรับการสร้างต้นแบบและการทดสอบ คุณจะมีโหนด Postgres เพียงโหนดเดียว คุณสามารถอัปเดตโหนด Postgres เหล่านี้ได้โดยตรงโดยไม่ต้องสร้างโหนด Postgres ใหม่

    • หากใช้พื้นที่เก็บข้อมูลเครือข่ายสำหรับโหนด Postgres ตามที่ Apigee แนะนำ คุณไม่จําเป็นต้องติดตั้งโหนด Postgres ใหม่ ในขั้นตอนด้านล่าง คุณสามารถข้ามขั้นตอนที่ระบุให้ติดตั้งและเลิกใช้งานโหนดสแตนด์บาย Postgres ใหม่ในภายหลัง

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

    การติดตั้งโหนดสแตนด์บาย Postgres ใหม่

    ขั้นตอนนี้จะสร้างเซิร์ฟเวอร์สแตนด์บาย Postgres ในโหนดใหม่ ตรวจสอบว่าคุณได้ติดตั้งเซิร์ฟเวอร์สแตนด์บาย Postgres ใหม่สำหรับ Edge เวอร์ชันที่มีอยู่ (4.50.00 หรือ 4.51.00) ไม่ใช่สำหรับเวอร์ชัน 4.52.00

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

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

    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. ติดตั้งยูทิลิตี apigee-service ของ Edge และข้อกําหนดเบื้องต้น 
          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 สําหรับระบบคลาวด์ส่วนตัว

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

      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 โ nod

      ดูรายการโทโพโลยี 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
        • UI ของ Edge ใหม่: หากคุณติดตั้ง UI ของ Edge ใหม่ ให้รีสตาร์ทคอมโพเนนต์ 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

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