อัปเดต Apigee Edge 4.16.09 เป็น 4.17.01

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

Edge เวอร์ชันใดบ้างที่คุณสามารถอัปเดตเป็น 4.17.01 ได้

คุณสามารถอัปเดต Apigee Edge เวอร์ชัน 4.16.09.0x เป็น 4.17.01 ได้โดยใช้ขั้นตอนนี้

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

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

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

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

องค์ประกอบใดบ้างที่ต้องอัปเดต

คุณต้องอัปเดตคอมโพเนนต์ Edge ทั้งหมด Edge ไม่รองรับการตั้งค่าที่มีคอมโพเนนต์จากหลายเวอร์ชัน

ต้องอัปเกรดเป็น Qpid 1.35

รุ่นนี้มีการอัปเดตที่จำเป็นสำหรับ Qpid 1.35 ในการอัปเดตโหนด Qpid คุณต้องทำดังนี้

  • ป้องกันไม่ให้เราเตอร์และ Message Processor เขียนไปยังโหนด Qpid ชั่วคราวโดยบล็อกพอร์ต 5672 ในโหนด Qpid คุณสามารถใช้คำสั่งต่อไปนี้เพื่อบล็อกพอร์ตนี้ในโหนด Qpid
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  • รอให้คิว Qpid ไม่มีข้อความเหลืออยู่ เพื่อให้แน่ใจว่าโหนด Qpid ได้ประมวลผลข้อความทั้งหมดก่อนการอัปเดต ใช้คำสั่งต่อไปนี้เพื่อให้แน่ใจว่าคิวข้อความ Qpid ว่างเปล่า
    > qpid-stat -q
  • อัปเดตโหนด Qpid
  • เลิกบล็อกพอร์ต 5672 ในโหนด Qpid เพื่ออนุญาตให้เข้าถึงจากเราเตอร์และ Message Processor คุณใช้คำสั่งต่อไปนี้เพื่อเลิกบล็อกพอร์ตนี้ได้
    > sudo iptables -F

    โปรดทราบว่าหากใช้ iptables สำหรับกฎอื่นๆ คุณสามารถใช้ตัวเลือก -D เพื่อยกเลิกการเปลี่ยนแปลงที่เฉพาะเจาะจงได้
    > sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP

กระบวนการนี้จะอธิบายโดยละเอียดด้านล่างสำหรับโทโพโลยี Edge แต่ละรายการ

ต้องเปิดใช้ที่เก็บ EPEL

คุณต้องเปิดใช้แพ็กเกจเสริมสำหรับ Enterprise Linux (หรือ EPEL) เพื่อติดตั้งหรืออัปเดต Edge คำสั่งที่คุณใช้จะขึ้นอยู่กับเวอร์ชันของ RedHat/CentOS ดังนี้

  • สำหรับ RedHat/CentOS 7.x:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
  • สำหรับ RedHat/CentOS 6.x:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

ต้องระบุหากอัปเดตเมื่อใช้การตรวจสอบสิทธิ์ภายนอก

คุณสามารถผสานรวมบริการไดเรกทอรีภายนอกเข้ากับการติดตั้ง Apigee Edge Private Cloud ที่มีอยู่ได้ ฟีเจอร์นี้ออกแบบมาให้ทำงานร่วมกับบริการไดเรกทอรีที่รองรับ LDAP เช่น Active Directory, OpenLDAP และอื่นๆ โซลูชัน LDAP ภายนอกช่วยให้ผู้ดูแลระบบสามารถจัดการข้อมูลเข้าสู่ระบบของผู้ใช้จากบริการจัดการไดเรกทอรีแบบรวมศูนย์ซึ่งอยู่ภายนอกระบบ เช่น Apigee Edge ที่ใช้ข้อมูลเข้าสู่ระบบดังกล่าว

ดูข้อมูลเพิ่มเติมได้ที่การกำหนดค่าการตรวจสอบสิทธิ์ภายนอก

เมื่อเปิดใช้การตรวจสอบสิทธิ์ภายนอก ลูกค้าส่วนใหญ่จะใช้ช่องชื่อบัญชี SAM ของ Active Directory เป็นชื่อผู้ใช้สำหรับการตรวจสอบสิทธิ์ แทนที่จะใช้อีเมลซึ่งใช้โดยเซิร์ฟเวอร์ Edge OpenLDAP

หากคุณผสานรวมกับบริการไดเรกทอรีภายนอก ให้เพิ่มบรรทัดต่อไปนี้ลงในไฟล์การกำหนดค่าเมื่ออัปเดต Edge เป็น 4.17.01

IS_EXTERNAL_AUTH="true"

บรรทัดนี้จะกำหนดค่า Edge ให้รองรับชื่อบัญชีเป็นชื่อผู้ใช้ แทนที่จะเป็นอีเมล

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

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

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

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

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

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

    > /opt/apigee/apigee-service/bin/apigee-all status

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

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

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

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

โดยค่าเริ่มต้น ยูทิลิตี 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

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

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

  1. หากมี ให้ปิดใช้งานงาน CRON ที่กำหนดค่าให้ดำเนินการซ่อมแซมใน Cassandra จนกว่าการอัปเดตจะเสร็จสมบูรณ์
  2. เข้าสู่ระบบโหนดในฐานะรูทเพื่อติดตั้ง Edge RPM
    หมายเหตุ: แม้ว่าการติดตั้ง RPM จะต้องใช้สิทธิ์เข้าถึงระดับรูท แต่คุณสามารถกำหนดค่า Edge ได้โดยไม่ต้องใช้สิทธิ์เข้าถึงระดับรูท
  3. ปิดใช้ SELinux ตามที่อธิบายไว้ในหัวข้อติดตั้งยูทิลิตี apigee-setup ของ Edge
  4. ดาวน์โหลดไฟล์ Edge 4.17.01 bootstrap_4.17.01.sh ไปยัง /tmp/bootstrap_4.17.01.sh:
    > curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
  5. ติดตั้งยูทิลิตี apigee-service ของ Edge 4.17.01 และทรัพยากร Dependency:
    > sudo bash /tmp/bootstrap_4.17.01.sh apigeeuser=uName apigeepassword=pWord

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

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

    I = ติดตั้ง OpenJDK 1.8 (ค่าเริ่มต้น)
    C = ดำเนินการต่อโดยไม่ติดตั้ง Java
    Q = ออก สำหรับตัวเลือกนี้ คุณต้องติดตั้ง Java ด้วยตนเอง
  6. (CentOS-6.x และ RedHat-6.x เท่านั้น) ในโหนด Qpid ทั้งหมด ให้เรียกใช้คำสั่งต่อไปนี้เพื่อให้แน่ใจว่าคุณดาวน์โหลด Qpid เวอร์ชันที่ถูกต้อง
    > yum install apigee-qpidd --disablerepo=epel
  7. ใช้ apigee-service เพื่ออัปเดตยูทิลิตี apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  8. อัปเดตยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการ:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  9. อัปเดตยูทิลิตี apigee-provision โดยทำดังนี้
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  10. เรียกใช้ยูทิลิตีการอัปเดตในโหนดตามลำดับที่อธิบายไว้ด้านล่างใน "ลำดับการอัปเดตเครื่อง" ด้านล่าง
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    ข้อกำหนดเดียวในไฟล์การกำหนดค่าคือไฟล์การกำหนดค่าต้องเข้าถึงได้หรืออ่านได้โดยผู้ใช้ "apigee"

    ใช้ตัวเลือก "-c" เพื่อระบุคอมโพเนนต์ที่จะอัปเดต รายการคอมโพเนนต์ที่เป็นไปได้มีดังนี้
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =คอมโพเนนต์ Edge ทั้งหมดยกเว้น Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres Server
    ui = Edge UI
    all = อัปเดตคอมโพเนนต์ทั้งหมดในเครื่อง (ใช้สำหรับโปรไฟล์การติดตั้ง Edge aio หรือโปรไฟล์การติดตั้ง API BaaS asa เท่านั้น)
    e = ElasticSearch
    b = API BaaS Stack
    p = API BaaS Portal
    ebp = ElasticSearch, API BaaS Stack และ API BaaS Portal ในโหนดเดียวกัน
  11. ทดสอบการอัปเดตโดยเรียกใช้ยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการตามที่อธิบายไว้ในทดสอบการติดตั้ง

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

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

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

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

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

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

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

      คำสั่งนี้จะสร้างไดเรกทอรีใหม่ชื่อ repos ในไดเรกทอรีที่มีไฟล์ .tar เช่น /tmp/repos
    4. ติดตั้งยูทิลิตี apigee-service ของ Edge และทรัพยากร Dependency จาก /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      โปรดทราบว่าคุณต้องใส่เส้นทางไปยังไดเรกทอรี repos ในคำสั่งนี้
  3. วิธีติดตั้ง apigee-service โดยใช้เว็บเซิร์ฟเวอร์ Nginx
    1. กำหนดค่าเว็บเซิร์ฟเวอร์ Nginx ตามที่อธิบายไว้ใน "ติดตั้งจากที่เก็บโดยใช้เว็บเซิร์ฟเวอร์ Nginx" ที่หัวข้อติดตั้งยูทิลิตี apigee-setup ของ Edge
    2. ในโหนดระยะไกล ให้ดาวน์โหลดไฟล์ Edge bootstrap_4.17.01.sh ไปยัง /tmp/bootstrap_4.17.01.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh

      โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณตั้งไว้ด้านบนสำหรับที่เก็บ และ remoteRepo คือที่อยู่ IP หรือชื่อ DNS ของโหนดที่เก็บ
    3. ในโหนดระยะไกล ให้ติดตั้งยูทิลิตี apigee-service ของ Edge และทรัพยากร Dependency ดังนี้
      > sudo bash /tmp/bootstrap_4.17.01.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. เรียกใช้ยูทิลิตีการอัปเดตในโหนดตามลำดับที่อธิบายไว้ด้านล่างในส่วน "ลำดับการอัปเดตเครื่อง"
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    ข้อกำหนดเดียวในไฟล์การกำหนดค่าคือไฟล์การกำหนดค่าต้องเข้าถึงได้หรืออ่านได้โดยผู้ใช้ "apigee"

    ใช้ตัวเลือก "-c" เพื่อระบุคอมโพเนนต์ที่จะอัปเดต รายการคอมโพเนนต์ที่เป็นไปได้มีดังนี้
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =คอมโพเนนต์ Edge ทั้งหมดยกเว้น Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres Server
    ui = Edge UI
    all = อัปเดตคอมโพเนนต์ทั้งหมดในเครื่อง (ใช้สำหรับโปรไฟล์การติดตั้ง Edge aio หรือโปรไฟล์การติดตั้ง API BaaS asa เท่านั้น)
    e = ElasticSearch
    b = API BaaS Stack
    p = API BaaS Portal
    ebp = ElasticSearch, API BaaS Stack และ API BaaS Portal ในโหนดเดียวกัน
  8. ทดสอบการอัปเดตโดยเรียกใช้ยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการตามที่อธิบายไว้ในทดสอบการติดตั้ง

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

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

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

  • คุณต้องอัปเดตโหนด Cassandra และ ZooKeeper ทั้งหมดก่อนที่จะอัปเดตโหนดอื่นๆ
  • สำหรับเครื่องที่มีคอมโพเนนต์ Edge หลายรายการ (Management Server, Message Processor, Router, QPID Server แต่ไม่ใช่ Postgres Server) ให้ใช้ตัวเลือก "-c edge" เพื่ออัปเดตคอมโพเนนต์ทั้งหมดพร้อมกัน
  • หากขั้นตอนระบุว่าควรดำเนินการในเครื่องหลายเครื่อง ให้ดำเนินการตามลำดับเครื่องที่ระบุ
  • ไม่มีขั้นตอนแยกต่างหากในการอัปเดตการสร้างรายได้ ระบบจะอัปเดตเมื่อคุณระบุตัวเลือก "-c edge"
  • (CentOS-6.x และ RedHat-6.x เท่านั้น) ในโหนด Qpid ทั้งหมดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก ให้ตรวจสอบว่าคุณได้เรียกใช้คำสั่งต่อไปนี้เพื่อดาวน์โหลด Qpid เวอร์ชันที่ถูกต้องตามที่แสดงด้านบน
    > yum install apigee-qpidd --disablerepo=epel

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

  1. อัปเดต Cassandra และ ZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. ตั้งค่ากฎ iptables ต่อไปนี้
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  3. ตรวจสอบคิวข้อความ Qpid:
    > qpid-stat -q

    ตรวจสอบคิวต่อไปจนกว่าจำนวนในคอลัมน์ "msg" จะเป็น 0 คุณไม่สามารถอัปเกรด Qpid ได้จนกว่าจะประมวลผลข้อความทั้งหมดแล้ว
  4. อัปเดต qpidd:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. ล้าง iptables:
    > sudo iptables -F
  6. อัปเดต postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  7. เริ่ม postgresql:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  8. อัปเดต LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. อัปเดตคอมโพเนนต์ Edge ที่เหลือ:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. อัปเดต Edge UI:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. อัปเดต Cassandra และ ZooKeeper ในเครื่องที่ 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. ตั้งค่ากฎ iptables ต่อไปนี้ในเครื่องที่ 2
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  3. ตรวจสอบคิวข้อความ Qpid ในเครื่องที่ 2:
    > qpid-stat -q

    ตรวจสอบคิวต่อไปจนกว่าจำนวนในคอลัมน์ "msg" จะเป็น 0 คุณไม่สามารถอัปเกรด Qpid ได้จนกว่าจะประมวลผลข้อความทั้งหมดแล้ว
  4. อัปเดต qpidd ในเครื่องที่ 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. ล้าง iptables ในเครื่องที่ 2:
    > sudo iptables -F
  6. อัปเดต postgresql ในเครื่องที่ 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  7. เริ่ม postgresql ในเครื่อง 2:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  8. อัปเดต LDAP ในเครื่องที่ 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 2 และ 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. อัปเดต UI ในเครื่องที่ 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. อัปเดต Cassandra และ ZooKeeper ในเครื่อง 1, 2 และ 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. ตั้งค่ากฎ iptables ต่อไปนี้ในเครื่อง 4:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  3. ตรวจสอบคิวข้อความ Qpid ในเครื่อง 4:
    > qpid-stat -q

    ตรวจสอบคิวต่อไปจนกว่าจำนวนในคอลัมน์ "msg" จะเป็น 0 คุณไม่สามารถอัปเกรด Qpid ได้จนกว่าจะประมวลผลข้อความทั้งหมดแล้ว
  4. อัปเดต qpidd ในเครื่อง 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. ล้าง iptables ในเครื่อง 4:
    > sudo iptables -F
  6. ทำขั้นตอนที่ 2 ถึง 5 ซ้ำในเครื่องที่ 5
  7. อัปเดต postgresql ในเครื่อง 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. เริ่ม postgresql ในเครื่อง 4:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. ทำขั้นตอนที่ 7 และ 8 ซ้ำในเครื่องที่ 5
  10. อัปเดต LDAP ในเครื่องที่ 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 4, 5, 1, 2, 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. อัปเดต UI ในเครื่องที่ 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. อัปเดต Cassandra และ ZooKeeper ในเครื่อง 1, 2 และ 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. ตั้งค่ากฎ iptables ต่อไปนี้ในเครื่อง 6:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  3. ตรวจสอบคิวข้อความ Qpid ในเครื่อง 6:
    > qpid-stat -q

    ตรวจสอบคิวต่อไปจนกว่าจำนวนในคอลัมน์ "msg" จะเป็น 0 คุณไม่สามารถอัปเกรด Qpid ได้จนกว่าจะประมวลผลข้อความทั้งหมดแล้ว
  4. อัปเดต qpidd ในเครื่องที่ 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. ล้าง iptables ในเครื่อง 6:
    > sudo iptables -F
  6. ทำขั้นตอนที่ 2 ถึง 5 ซ้ำในเครื่องที่ 7
  7. อัปเดต postgresql ในเครื่อง 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. เริ่ม postgresql ในเครื่อง 6:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. ทำขั้นตอนที่ 7 และ 8 ซ้ำในเครื่องที่ 7
  10. อัปเดต LDAP ในเครื่องที่ 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 6, 7, 8, 9, 1, 4 และ 5 ตามลำดับต่อไปนี้
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. อัปเดต UI ในเครื่องที่ 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. อัปเดต Cassandra และ ZooKeeper ในเครื่อง 1, 2 และ 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. ตั้งค่ากฎ iptables ต่อไปนี้ในเครื่อง 12:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  3. ตรวจสอบคิวข้อความ Qpid ในเครื่อง 12:
    > qpid-stat -q

    ตรวจสอบคิวต่อไปจนกว่าจำนวนในคอลัมน์ "msg" จะเป็น 0 คุณไม่สามารถอัปเกรด Qpid ได้จนกว่าจะประมวลผลข้อความทั้งหมดแล้ว
  4. อัปเดต qpidd ในเครื่อง 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. ล้าง iptables ในเครื่อง 12:
    > sudo iptables -F
  6. ทำซ้ำขั้นตอนที่ 2 ถึง 5 ในเครื่อง 13
  7. อัปเดต postgresql ในเครื่อง 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. เริ่ม postgresql ในเครื่อง 12:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. ทำขั้นตอนที่ 7 และ 8 ซ้ำในเครื่อง 13
  10. อัปเดต LDAP ในเครื่อง 4 และ 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 12, 13, 8, 9, 6, 7, 10 และ 11 ตามลำดับดังนี้
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. อัปเดต UI ในเครื่อง 6 และ 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

สำหรับการติดตั้งแบบคลัสเตอร์ที่มีโฮสต์ 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. ตั้งค่ากฎ iptables ต่อไปนี้ในเครื่อง 4:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. ตรวจสอบคิวข้อความ Qpid ในเครื่อง 4:
        > qpid-stat -q

        ตรวจสอบคิวต่อไปจนกว่าจำนวนในคอลัมน์ "msg" จะเป็น 0 คุณไม่สามารถอัปเกรด Qpid ได้จนกว่าจะประมวลผลข้อความทั้งหมดแล้ว
      3. อัปเดต qpidd ในเครื่อง 4:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. ล้าง iptables ในเครื่อง 4:
        > sudo iptables -F
      5. ทำขั้นตอนที่ 1 ถึง 4 ซ้ำในเครื่องที่ 5
    2. เครื่อง 10, 11 ในศูนย์ข้อมูล 2
      1. ตั้งค่ากฎ iptables ต่อไปนี้ในเครื่อง 10:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. ตรวจสอบคิวข้อความ Qpid ในเครื่อง 10:
        > qpid-stat -q

        ตรวจสอบคิวต่อไปจนกว่าจำนวนในคอลัมน์ "msg" จะเป็น 0 คุณไม่สามารถอัปเกรด Qpid ได้จนกว่าจะประมวลผลข้อความทั้งหมดแล้ว
      3. อัปเดต qpidd ในเครื่อง 10:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. ล้าง iptables ในเครื่อง 10:
        > sudo iptables -F
      5. ทำขั้นตอนที่ 1-4 ซ้ำในเครื่อง 11
  3. อัปเดต postgresql:
    1. เครื่องที่ 6 ในศูนย์ข้อมูล 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
    2. เครื่อง 12 ในศูนย์ข้อมูล 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  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:
    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 โฮสต์

คุณต้องเพิ่มพร็อพเพอร์ตี้ใหม่ 2 รายการลงในไฟล์การกำหนดค่าก่อนที่จะเรียกใช้ขั้นตอนการอัปเกรด ดังนี้

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

ดูตัวอย่างไฟล์การกำหนดค่าที่สมบูรณ์ได้ที่การติดตั้ง API BaaS

นอกจากนี้ คุณต้องตรวจสอบว่าพอร์ต 2551 เปิดอยู่ในโหนด Stack ทั้งหมดเพื่อให้เข้าถึงได้จากโหนด Stack อื่นๆ ทั้งหมด

ดูรายการโทโพโลยี 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 โฮสต์

คุณต้องเพิ่มพร็อพเพอร์ตี้ใหม่ 2 รายการลงในไฟล์การกำหนดค่าก่อนที่จะเรียกใช้ขั้นตอนการอัปเกรด ดังนี้

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

ดูตัวอย่างไฟล์การกำหนดค่าที่สมบูรณ์ได้ที่การติดตั้ง API BaaS

นอกจากนี้ คุณต้องตรวจสอบว่าพอร์ต 2551 เปิดอยู่ในโหนด Stack ทั้งหมดเพื่อให้เข้าถึงได้จากโหนด Stack อื่นๆ ทั้งหมด

ดูรายการโทโพโลยี 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, ps
  4. LDAP
  5. Edge หมายถึงโปรไฟล์ "-c edge" ในโหนดทั้งหมดตามลำดับ ได้แก่ โหนดที่มีเซิร์ฟเวอร์ Qpid, เซิร์ฟเวอร์ Postgres, Management Server, Message Processor และเราเตอร์
    หมายเหตุ: หากโหนดมีทั้งเซิร์ฟเวอร์ Qpid และเซิร์ฟเวอร์ Postgres ติดตั้งอยู่ ให้เรียกใช้ขั้นตอนโปรไฟล์ "-c edge"
  6. Edge UI