อัปเดต Apigee Edge 4.16.01 เป็น 4.16.05

Edge for Private Cloud เวอร์ชัน 4.16.05

Edge เวอร์ชันใดบ้างที่อัปเดตเป็น 4.16.05 ได้

คุณอัปเดต Apigee Edge เวอร์ชัน 4.16.01.x เป็น 4.16.05 ได้เท่านั้น

หากคุณมี Edge เวอร์ชันก่อนหน้า 4.16.01.x คุณต้องย้ายข้อมูลไปยังเวอร์ชัน 4.16.01.x ก่อน แล้วจึงอัปเดตเป็นเวอร์ชัน 4.16.05

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

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

หลังจากติดตั้ง Edge RPM แล้ว ผู้ใช้ทุกคนจะกำหนดค่าได้

ต้องอัปเกรดเป็น Java JDK เวอร์ชัน 8

Edge รุ่นนี้กำหนดให้คุณต้องติดตั้ง Java JDK เวอร์ชัน 8 ในโหนดการประมวลผล Edge ทั้งหมด คุณสามารถติดตั้ง Oracle JDK 8 หรือ OpenJDK 8 ก็ได้ หากยังไม่ได้ติดตั้ง Java JDK 8 สคริปต์อัปเดตจะติดตั้งให้คุณได้

ในการอัปเดตเป็น Java 8 การเข้ารหัส TLS บางรายการจะไม่มีให้บริการใน Oracle JDK 8 อีกต่อไป ดูรายการทั้งหมดได้ที่ส่วน "Default Disabled ชุดการเข้ารหัส" http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html

คำเตือน: Edge รุ่นนี้ไม่รองรับ JDK 7 หากคุณใช้ JDK 7 อยู่ คุณต้องอัปเกรดเป็น JDK 8 หากคุณย้อนกลับการติดตั้ง Edge 4.16.05 คุณจะกำหนดค่า Edge ใหม่เพื่อใช้ Java JDK 7 ได้ (ไม่บังคับ)

กำลังดาวน์เกรด Zookeeper

เวอร์ชันของ Zookeeper RPM ใน Edge สำหรับ Private Cloud 4.16.01 คือ apigee-zookeeper-3.4.5-1.0.905.noarch.rpm ใน Edge เวอร์ชันต่อมา เวอร์ชัน Zookeeper ได้เปลี่ยนกลับไปเป็น apigee-zookeeper-3.4.5-0.0.948 ซึ่งจะป้องกันไม่ให้ yum อัปเกรด Zookeeper เป็นเวอร์ชันที่ใหม่กว่าจาก 4.16.01 วิธีแก้ไขสถานการณ์นี้คือเรียกใช้ yum downgrade apigee-zookeeper ก่อนอัปเดต Zookeeper

คุณตรวจสอบเวอร์ชัน Zookeeper ได้โดยใช้คำสั่งต่อไปนี้

> rpm -qa |grep apigee-zookeeper

หากคำสั่งนี้แสดงผลเวอร์ชัน Zookeeper ให้ทำดังนี้

apigee-zookeeper-3.4.5-1.0.905

จากนั้นคุณต้องดาวน์เกรด

ข้อกำหนดด้านพื้นที่ในดิสก์สำหรับการอัปเดต

ตรวจสอบว่าคุณมีพื้นที่ว่างในดิสก์อย่างน้อย 1 GB ก่อนทำการอัปเดต

การเผยแพร่การตั้งค่าพร็อพเพอร์ตี้โดยอัตโนมัติจาก 4.16.01.x

หากคุณตั้งค่าพร็อพเพอร์ตี้ใดๆ โดยแก้ไขไฟล์ .properties ใน /opt/apigee/customer/application ระบบจะเก็บค่าเหล่านี้ไว้ในการอัปเดต

การอัปเดตยูทิลิตี apigee-validate

ในเวอร์ชัน 4.16.01 คุณได้ติดตั้งและเรียกใช้ยูทิลิตี apigee-validate ในโหนด Message Processor ในเวอร์ชัน 4.16.05 ยูทิลิตี apigee-validate ได้รับการอัปเดตให้ทำงานในโหนด Management Server

เมื่ออัปเดตเป็น 4.16.05 คุณจะมี 2 ตัวเลือกในการอัปเดตยูทิลิตี apigee-validate ดังนี้

  1. Apigee แนะนำ - ติดตั้งและเรียกใช้ยูทิลิตี apigee-validate ในโหนดเซิร์ฟเวอร์การจัดการ

    คุณเลือกถอนการติดตั้งยูทิลิตี apigee-validate จากโหนด Message Processor ได้ หากปล่อยไว้ในโหนด Message Processor คุณต้องอัปเดตเป็น 4.16.05
  2. หรืออัปเดตยูทิลิตี apigee-validate ในโหนด Message Processor แล้วเรียกใช้จากที่นั่น อย่างไรก็ตาม Apigee ขอแนะนำให้คุณติดตั้งและเรียกใช้จากเซิร์ฟเวอร์การจัดการ

ข้อกำหนดเบื้องต้นในการอัปเดต

โปรดดำเนินการตามข้อกำหนดเบื้องต้นต่อไปนี้ก่อนอัปเกรด Apigee Edge

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

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

    > /<inst_root>/apigee/apigee-service/bin/apigee-all status

การจัดการการอัปเดตที่ไม่สำเร็จ

ในกรณีที่อัปเดตไม่สำเร็จ คุณสามารถลองแก้ไขปัญหา แล้วเรียกใช้ update.sh อีกครั้ง คุณสามารถเรียกใช้การอัปเดตหลายครั้งได้ และระบบจะอัปเดตต่อจากจุดที่ค้างไว้ล่าสุด

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

กำลังบันทึกข้อมูลการอัปเดต

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

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

  • ในโหนดเราเตอร์และ Message Processor แบบรวม ให้ทำดังนี้
    • ก่อนอัปเดต ให้ทำดังนี้
      1. ทำให้เราเตอร์เข้าถึงไม่ได้
      2. ทำให้ Message Processor เข้าถึงไม่ได้
    • หลังการอัปเดต - ดำเนินการต่อไปนี้
      1. ทำให้ Message Processor เข้าถึงได้
      2. ตรวจสอบว่าเราเตอร์เข้าถึงได้
  • ในโหนดเราเตอร์เดียว ให้ทำดังนี้
    • ก่อนอัปเดต ให้ทำให้เราเตอร์เข้าถึงไม่ได้
    • หลังจากอัปเดตแล้ว ให้ตรวจสอบว่าเราเตอร์เข้าถึงได้
  • ในโหนด Message Processor เดียว ให้ทำดังนี้
    • ก่อนอัปเดต ให้ทำให้ Message Processor เข้าถึงไม่ได้
    • หลังจากอัปเดตแล้ว ให้ทำให้ Message Processor เข้าถึงได้

การใช้ไฟล์การกำหนดค่าแบบไม่มีการโต้ตอบ

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

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

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

  1. หากมี ให้ปิดใช้งานงาน CRON ที่กำหนดค่าให้ดำเนินการซ่อมแซมใน Cassandra จนกว่าการอัปเดตจะเสร็จสมบูรณ์
  2. เข้าสู่ระบบโหนดในฐานะรูทเพื่อติดตั้ง Edge RPM
    หมายเหตุ: แม้ว่าการติดตั้ง RPM จะต้องใช้สิทธิ์เข้าถึงระดับรูท แต่คุณสามารถกำหนดค่า Edge โดยไม่ต้องใช้สิทธิ์เข้าถึงระดับรูทได้
  3. ปิดใช้ SELinux ตามที่อธิบายไว้ในหัวข้อติดตั้งยูทิลิตี apigee-setup ของ Edge
  4. ดาวน์โหลดไฟล์ Edge 4.16.05 bootstrap_4.16.05.sh ไปยัง /tmp/bootstrap_4.16.05.sh:
    > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  5. ติดตั้งยูทิลิตี Edge 4.16.05 apigee-service และทรัพยากร Dependency:
    > sudo bash /tmp/bootstrap_4.16.05.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 ด้วยตนเอง
  6. ใช้ apigee-service เพื่ออัปเดตยูทิลิตี apigee-setup ดังนี้
    1. หากคุณติดตั้ง 4.16.01 โดยอัปเกรด Edge เวอร์ชัน 4.15.07.0x คุณต้องติดตั้งยูทิลิตี apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      คำสั่งนี้จะติดตั้งยูทิลิตี update.sh ใน <inst_dir>/apigee/apigee-setup/bin

      หากคุณติดตั้งยูทิลิตี apigee-setup แล้ว ให้อัปเดตดังนี้
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    2. หากคุณติดตั้ง 4.16.01 โดยตรง ซึ่งหมายความว่าคุณไม่ได้อัปเกรดจาก 4.15.07.0x คุณต้องอัปเดตยูทิลิตี apigee-setup ดังนี้
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      การอัปเดต apigee-service นี้จะติดตั้งยูทิลิตี update.sh ใน <inst_dir>/apigee/apigee-setup/bin
  7. ติดตั้งยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการ:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
    หมายเหตุ: หากคุณติดตั้งยูทิลิตี apigee-validate ในโหนด Message Processor คุณสามารถอัปเดตได้โดยใช้คำสั่งต่อไปนี้ในโหนดนั้น:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    อย่างไรก็ตาม สำหรับ 4.16.05 Apigee ขอแนะนำให้คุณติดตั้งและเรียกใช้ยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการ
  8. แก้ไขไฟล์การกำหนดค่าที่ส่งไปยังยูทิลิตี apigee-validate ใน Edge เวอร์ชันก่อนหน้า ไฟล์การกำหนดค่าที่ apigee-validate ใช้ต้องมีพร็อพเพอร์ตี้ต่อไปนี้
    APIGEE_ADMINPW=sysAdminPword
    MP_POD=gateway
    REGION=dc-1
    ในเวอร์ชันนี้ ไฟล์การกำหนดค่าต้องมีพร็อพเพอร์ตี้ APIGEE_ADMINPW เท่านั้น คุณสามารถนำพร็อพเพอร์ตี้อีก 2 รายการออกจากไฟล์ได้
  9. เรียกใช้ยูทิลิตีการอัปเดตในโหนดตามลำดับที่อธิบายไว้ด้านล่างในส่วน "ลำดับการอัปเดตเครื่อง"
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
    ข้อกำหนดเดียวสำหรับไฟล์การกำหนดค่าคือไฟล์การกำหนดค่าต้องเข้าถึงได้หรืออ่านได้โดยผู้ใช้ "apigee" เช่น วางไฟล์ในไดเรกทอรี /tmp บนโหนด
    ใช้ตัวเลือก "-c" เพื่อระบุคอมโพเนนต์ที่จะอัปเดต รายการคอมโพเนนต์ที่เป็นไปได้มีดังนี้
    • ldap = OpenLDAP
    • cs = Cassandra
    • zk = Zookeeper
    • qpid = qpidd
    • ps = postgresql
    • edge =คอมโพเนนต์ Edge ทั้งหมด ยกเว้น Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres Server
    • ui = Edge UI
    • all = อัปเดตคอมโพเนนต์ทั้งหมดในเครื่อง (ใช้สำหรับโปรไฟล์การติดตั้ง Edge aio หรือโปรไฟล์การติดตั้ง API BaaS asa เท่านั้น)
    • e = ElasticSearch
    • b = API BaaS Stack
    • p = API BaaS Portal
    • ebp = ElasticSearch, API BaaS Stack และ API BaaS Portal ในโหนดเดียวกัน
  10. ทดสอบการอัปเดตโดยเรียกใช้ยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการตามที่อธิบายไว้ในทดสอบการติดตั้ง

หากต้องการย้อนกลับการอัปเดตในภายหลัง ให้ใช้ขั้นตอนที่อธิบายไว้ในกระบวนการย้อนกลับ 4.16.05

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

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

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

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

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

  1. สร้างที่เก็บ 4.16.05 ในเครื่องตามที่อธิบายไว้ใน "สร้างที่เก็บ Apigee ในเครื่อง" ที่หัวข้อติดตั้งยูทิลิตี apigee-setup ของ Edge
    หมายเหตุ: หากมีที่เก็บ 4.16.01 อยู่แล้ว คุณสามารถเพิ่มที่เก็บ 4.16.05 ลงในที่เก็บดังกล่าวได้
  2. วิธีติดตั้ง apigee-service จากไฟล์ .tar
    1. ในโหนดที่มีที่เก็บในเครื่อง ให้ใช้คำสั่งต่อไปนี้เพื่อจัดแพ็กเกจที่เก็บในเครื่องเป็นไฟล์ .tar ไฟล์เดียวชื่อ /opt/apigee/data/apigee-mirror/apigee-4.16.05.tar.gz:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. คัดลอกไฟล์ .tar ไปยังโหนดที่ต้องการอัปเดต Edge เช่น คัดลอกไปยังไดเรกทอรี /tmp ในโหนดใหม่
    3. ในโหนดใหม่ ให้ Untar ไฟล์ไปยังไดเรกทอรี /tmp:
      > tar -xzf apigee-4.16.05.tar.gz
      คำสั่งนี้จะสร้างไดเรกทอรีใหม่ชื่อ repos ในไดเรกทอรีที่มีไฟล์ .tar เช่น /tmp/repos.
    4. ติดตั้งยูทิลิตี apigee-service ของ Edge และทรัพยากร Dependency จาก /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
      โปรดทราบว่าคุณต้องใส่เส้นทางไปยังไดเรกทอรี repos ในคำสั่งนี้
  3. วิธีติดตั้ง apigee-service โดยใช้เว็บเซิร์ฟเวอร์ Nginx
    1. กำหนดค่าเว็บเซิร์ฟเวอร์ Nginx ตามที่อธิบายไว้ใน "ติดตั้งจากที่เก็บโดยใช้เว็บเซิร์ฟเวอร์ Nginx" ที่หัวข้อติดตั้งยูทิลิตี apigee-setup ของ Edge
    2. ในโหนดระยะไกล ให้ดาวน์โหลดไฟล์ Edge bootstrap_4.16.05.sh ไปยัง /tmp/bootstrap_4.16.05.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
      โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณตั้งค่าไว้ด้านบนสำหรับที่เก็บ และ remoteRepo คือที่อยู่ IP หรือชื่อ DNS ของโหนดที่เก็บ
    3. ในโหนดระยะไกล ให้ติดตั้งยูทิลิตี apigee-service ของ Edge และทรัพยากร Dependency ดังนี้
      > sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
      โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านของที่เก็บ
  4. ใช้ apigee-service เพื่ออัปเดตยูทิลิตี apigee-setup ดังนี้
    1. หากคุณติดตั้ง 4.16.01 โดยอัปเกรด Edge เวอร์ชัน 4.15.07.0x คุณต้องติดตั้งยูทิลิตี apigee-setup ดังนี้
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      คำสั่งนี้จะติดตั้งยูทิลิตี update.sh ใน <inst_dir>/apigee/apigee-setup/bin

      หากคุณติดตั้งยูทิลิตี apigee-setup ไว้แล้ว ให้อัปเดตดังนี้
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    2. หากคุณติดตั้ง 4.16.01 โดยตรง ซึ่งหมายความว่าคุณไม่ได้อัปเกรดจาก 4.15.07.0x คุณต้องอัปเดตยูทิลิตี apigee-setup ดังนี้
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      การอัปเดต apigee-service นี้จะติดตั้งยูทิลิตี update.sh ใน <inst_dir>/apigee/apigee-setup/bin
  5. ติดตั้งยูทิลิตี apigee-validate ในโหนดเซิร์ฟเวอร์การจัดการ:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
    หมายเหตุ: หากคุณติดตั้งยูทิลิตี apigee-validate ในโหนด Message Processor คุณสามารถอัปเดตได้โดยใช้คำสั่งต่อไปนี้ในโหนดนั้น:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    อย่างไรก็ตาม สำหรับเวอร์ชัน 4.16.05 Apigee ขอแนะนำให้คุณติดตั้งและเรียกใช้ยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการ
  6. แก้ไขไฟล์การกำหนดค่าที่ส่งไปยังยูทิลิตี apigee-validate ใน Edge รุ่นก่อนหน้า ไฟล์การกำหนดค่าที่ apigee-validate ใช้ต้องมีพร็อพเพอร์ตี้ต่อไปนี้
    APIGEE_ADMINPW=sysAdminPword
    MP_POD=gateway
    REGION=dc-1
    ในรุ่นนี้ ไฟล์การกำหนดค่าต้องมีพร็อพเพอร์ตี้ APIGEE_ADMINPW เท่านั้น คุณสามารถนำพร็อพเพอร์ตี้อีก 2 รายการออกจากไฟล์ได้
  7. เรียกใช้ยูทิลิตีการอัปเดตในโหนดตามลำดับที่อธิบายไว้ด้านล่างในส่วน "ลำดับการอัปเดตเครื่อง" ด้านล่าง
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
    ข้อกำหนดเดียวในไฟล์การกำหนดค่าคือไฟล์การกำหนดค่าต้องเข้าถึงได้หรืออ่านได้โดยผู้ใช้ "apigee" เช่น วางไฟล์ในไดเรกทอรี /tmp บนโหนด
    ใช้ตัวเลือก "-c" เพื่อระบุคอมโพเนนต์ที่จะอัปเดต รายการคอมโพเนนต์ที่เป็นไปได้มีดังนี้
    • ldap = OpenLDAP
    • cs = Cassandra
    • zk = Zookeeper
    • qpid = qpidd
    • ps = postgresql
    • edge =คอมโพเนนต์ Edge ทั้งหมด ยกเว้น Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres Server
    • ui = Edge UI
    • all = อัปเดตคอมโพเนนต์ทั้งหมดในเครื่อง (ใช้สำหรับโปรไฟล์การติดตั้ง Edge aio หรือโปรไฟล์การติดตั้ง API BaaS asa เท่านั้น)
    • e = ElasticSearch
    • b = API BaaS Stack
    • p = API BaaS Portal
    • ebp = ElasticSearch, API BaaS Stack และ API BaaS Portal ในโหนดเดียวกัน
  8. ทดสอบการอัปเดตโดยเรียกใช้ยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการตามที่อธิบายไว้ในทดสอบการติดตั้ง

หากต้องการย้อนกลับการอัปเดตในภายหลัง ให้ใช้ขั้นตอนที่อธิบายไว้ในกระบวนการย้อนกลับ 4.16.05

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

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

  • คุณต้องอัปเดตโหนด Cassandra และ ZooKeeper ทั้งหมดก่อนที่จะอัปเดตโหนดอื่นๆ
  • คุณต้องอัปเดตโหนด qpidd และ postgresql ทั้งหมดก่อนที่จะอัปเดตโหนดเราเตอร์และ Message Processor
  • สำหรับเครื่องที่มีคอมโพเนนต์ Edge หลายรายการ (Management Server, Message Processor, Router, QPID Server, Postgres Server) ให้ใช้ตัวเลือก "-c edge" เพื่ออัปเดตคอมโพเนนต์ทั้งหมดพร้อมกัน
  • หากขั้นตอนระบุว่าควรดำเนินการในเครื่องหลายเครื่อง ให้ดำเนินการตามลำดับเครื่องที่ระบุ
  • ไม่มีขั้นตอนแยกต่างหากในการอัปเดตการสร้างรายได้ ระบบจะอัปเดตเมื่อคุณระบุตัวเลือก "-c edge"
  • หลังจากอัปเดตโหนดเราเตอร์แล้ว คุณต้องนำไฟล์ทั้งหมดออกจากไดเรกทอรี /opt/nginx/conf.d แล้วรีสตาร์ทเราเตอร์

สำหรับการติดตั้งแบบสแตนด์อโลน 1 โฮสต์

  1. ดาวน์เกรด Zookeeper:
    > yum downgrade apigee-zookeeper
  2. อัปเดตเครื่องที่ 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  3. ลบไฟล์ใน /opt/nginx/conf.d:
    > rm -f /opt/nginx/conf.d/*
  4. รีสตาร์ท Edge Router:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart

สำหรับการติดตั้งแบบสแตนด์อโลน 2 โฮสต์

ดูรายการโทโพโลยี Edge และหมายเลขโหนดได้ที่โทโพโลยีการติดตั้ง

  1. ดาวน์เกรด Zookeeper ในเครื่อง 1:
    > yum downgrade apigee-zookeeper
  2. อัปเดต Cassandra และ ZooKeeper ในเครื่อง 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. อัปเดต qpidd และ postgresql ในเครื่อง 2:
    > /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 ในเครื่อง 2 และเครื่อง 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. ในโหนด 1 ให้ทำดังนี้
    1. ลบไฟล์ใน /opt/nginx/conf.d:
      > rm -f /opt/nginx/conf.d/*
    2. รีสตาร์ท Edge Router:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
  7. อัปเดต UI ในเครื่องที่ 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

สำหรับการติดตั้งแบบคลัสเตอร์ 5 โฮสต์

ดูรายการโทโพโลยี Edge และหมายเลขโหนดได้ที่โทโพโลยีการติดตั้ง

  1. ดาวน์เกรด Zookeeper ในเครื่อง 1, 2 และ 3:
    > yum downgrade apigee-zookeeper
  2. อัปเดต Cassandra และ ZooKeeper ในเครื่อง 1, 2 และ 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. อัปเดต qpidd และ postgresql ในเครื่อง 4 และ 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. ในโหนด 2 และ 3 ให้ทำดังนี้
    1. ลบไฟล์ใน /opt/nginx/conf.d:
      > rm -f /opt/nginx/conf.d/*
    2. รีสตาร์ท Edge Router:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
  7. อัปเดต UI ในเครื่องที่ 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

สำหรับการติดตั้งแบบคลัสเตอร์ 9 โฮสต์

ดูรายการโทโพโลยี Edge และหมายเลขโหนดได้ที่โทโพโลยีการติดตั้ง

  1. ดาวน์เกรด Zookeeper ในเครื่อง 1, 2 และ 3:
    > yum downgrade apigee-zookeeper
  2. อัปเดต Cassandra และ ZooKeeper ในเครื่อง 1, 2 และ 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. อัปเดต qpidd ในเครื่อง 6 และ 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. อัปเดต postgresql ในเครื่อง 8 และ 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. ในโหนด 4 และ 5 ให้ทำดังนี้
    1. ลบไฟล์ใน /opt/nginx/conf.d:
      > rm -f /opt/nginx/conf.d/*
    2. รีสตาร์ท Edge Router:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
  8. อัปเดต UI ในเครื่องที่ 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

สำหรับการติดตั้งแบบคลัสเตอร์ 13 โฮสต์

ดูรายการโทโพโลยี Edge และหมายเลขโหนดได้ที่โทโพโลยีการติดตั้ง

  1. ดาวน์เกรด Zookeeper ในเครื่อง 1, 2 และ 3:
    > yum downgrade apigee-zookeeper
  2. อัปเดต Cassandra และ ZooKeeper ในเครื่อง 1, 2 และ 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. อัปเดต qpidd ในเครื่อง 12 และ 13:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. อัปเดต postgresql ในเครื่อง 8 และ 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. ในโหนด 10 และ 11 ให้ทำดังนี้
    1. ลบไฟล์ใน /opt/nginx/conf.d:
      > rm -f /opt/nginx/conf.d/*
    2. รีสตาร์ท Edge Router:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
  8. อัปเดต UI ในเครื่อง 6 และ 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

สำหรับการติดตั้งแบบคลัสเตอร์ที่มีโฮสต์ 12 ราย

ดูรายการโทโพโลยี Edge และหมายเลขโหนดได้ที่โทโพโลยีการติดตั้ง

  1. อัปเดต Cassandra และ ZooKeeper โดยทำดังนี้
    1. ดาวน์เกรด Zookeeper ในเครื่อง 1, 2 และ 3 ในศูนย์ข้อมูล 1:
      > yum downgrade apigee-zookeeper
    2. ในเครื่อง 1, 2 และ 3 ในศูนย์ข้อมูล 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    3. ดาวน์เกรด Zookeeper ในเครื่อง 7, 8 และ 9 ในศูนย์ข้อมูล 2:
      > yum downgrade apigee-zookeeper
    4. ในเครื่อง 7, 8 และ 9 ในศูนย์ข้อมูล 2
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. อัปเดต qpidd โดยทำดังนี้
    1. เครื่อง 4, 5 ในศูนย์ข้อมูล 1
      > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. เครื่อง 10, 11 ในศูนย์ข้อมูล 2
      > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. อัปเดต postgresql โดยทำดังนี้
    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
    3. ในโหนด 2, 3, 8 และ 9
      1. ลบไฟล์ใน /opt/nginx/conf.d:
        > rm -f /opt/nginx/conf.d/*
      2. รีสตาร์ท Edge Router:
        > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
  6. อัปเดต UI:
    1. เครื่องที่ 1 ในศูนย์ข้อมูลที่ 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. เครื่องที่ 7 ในศูนย์ข้อมูล 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

สำหรับการติดตั้ง API BaaS แบบ 7 โฮสต์

ดูรายการโทโพโลยี Edge และหมายเลขโหนดได้ที่โทโพโลยีการติดตั้ง

  1. อัปเดต Cassandra ในเครื่อง 5, 6 และ 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. อัปเดต ElasticSearch และ API BaaS Stack ในเครื่อง 1, 2 และ 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile
  3. อัปเดตพอร์ทัล API BaaS ในเครื่อง 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

สำหรับการติดตั้ง API BaaS แบบ 10 โฮสต์

ดูรายการโทโพโลยี Edge และหมายเลขโหนดได้ที่โทโพโลยีการติดตั้ง

  1. อัปเดต Cassandra ในเครื่อง 8, 9 และ 10:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. อัปเดต ElasticSearch ในเครื่อง 1, 2 และ 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  3. อัปเดตสแต็ก API BaaS ในเครื่อง 4, 5 และ 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  4. อัปเดตพอร์ทัล API BaaS ในเครื่อง 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

สำหรับการติดตั้งที่ไม่ได้มาตรฐาน

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

  1. ZooKeeper
  2. Cassandra
  3. qpidd
  4. postgresql
  5. LDAP
  6. Edge หมายถึงโปรไฟล์ "-c edge" ในโหนดทั้งหมดตามลำดับ Qpid, Postgres, Management Server, Message Processor, Router
  7. ในโหนดเราเตอร์ทั้งหมด ให้ทำดังนี้
    1. ลบไฟล์ใน /opt/nginx/conf.d:
      > rm -f /opt/nginx/conf.d/*
    2. รีสตาร์ท Edge Router:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
  8. UI