อัปเดต 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 คุณจะต้อง ต้องทำสิ่งต่อไปนี้

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

    โปรดทราบว่าหากคุณใช้ iptables สำหรับกฎอื่นๆ คุณสามารถใช้ตัวเลือก -D เพื่อกลับค่า การเปลี่ยนแปลงที่เฉพาะเจาะจง:
    > sudo iptables -D INPUT -p tcp --พอร์ตปลายทาง 5672! -s `ชื่อโฮสต์` -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 สถานะ

การจัดการการอัปเดตที่ล้มเหลว

ในกรณีที่อัปเดตไม่สำเร็จ ให้ลองแก้ไขปัญหาแล้วเรียกใช้ 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. เมื่อถึงเวลาอัปเดตเราเตอร์ ให้เลือกเราเตอร์หนึ่งตัวและทำให้ไม่สามารถเข้าถึงได้ เช่น ที่อธิบายไว้ในบทความการเปิด/ปิดใช้ ความสามารถในการเข้าถึงของเซิร์ฟเวอร์ (ตัวประมวลผลข้อความ/เราเตอร์)
  3. อัปเดตเราเตอร์ที่เลือกและคอมโพเนนต์ Edge อื่นๆ ทั้งหมดบนเครื่องเดียวกันกับเราเตอร์ การกำหนดค่า Edge ทั้งหมดจะแสดงเราเตอร์และผู้ประมวลผลข้อความในโหนดเดียวกัน
  4. ทำให้เราเตอร์เข้าถึงได้อีกครั้ง
  5. ทำซ้ำขั้นตอนที่ 2 ถึง 4 สำหรับเราเตอร์ที่เหลือ
  6. อัปเดตเครื่องที่เหลือในการติดตั้งต่อ

ดูแลสิ่งต่อไปนี้ก่อน/หลังการอัปเดต

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

การใช้ไฟล์การกำหนดค่าที่ผู้ใช้ไม่ต้องดำเนินการ

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

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

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

  1. หากมี ให้ปิดใช้งาน CRON ที่กำหนดค่าไว้เพื่อดำเนินการซ่อมแซมใน Cassandra จนกว่าการอัปเดตจะเสร็จสมบูรณ์
  2. เข้าสู่ระบบโหนดในฐานะรูทเพื่อติดตั้ง Edge RPM
    หมายเหตุ: แม้ว่าการติดตั้ง RPM จะต้องมีสิทธิ์เข้าถึงรูท แต่คุณดำเนินการ Edge ได้ การกำหนดค่าที่ไม่มีสิทธิ์เข้าถึงราก
  3. ปิดใช้งาน SELinux ตามที่อธิบายไว้ใน ติดตั้ง ยูทิลิตีการตั้งค่า Apigee ของ 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
    ถาม = ออก สำหรับตัวเลือกนี้ คุณต้องติดตั้ง Java ด้วยตนเอง
  6. (CentOS-6.x และ RedHat-6.x เท่านั้น) ในโหนด Qpid ทั้งหมด ให้เรียกใช้คำสั่งต่อไปนี้ เพื่อให้แน่ใจว่าคุณได้ดาวน์โหลด Qpid เวอร์ชันที่ถูกต้อง:
    > อร่อยจัง ติดตั้งเลย apigee-qpidd --disablerepo=epel
  7. ใช้ apigee-service เพื่อ อัปเดต apigee-setup ยูทิลิตี:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup อัปเดต
  8. อัปเดต apigee-validate ยูทิลิตีในเซิร์ฟเวอร์การจัดการ:
    /opt/apigee/apigee-service/bin/apigee-service apigee-checkate อัปเดต
  9. อัปเดต apigee-provision ยูทิลิตี:
    อัปเดต /opt/apigee/apigee-service/bin/apigee-service apigee-provision
  10. เรียกใช้ยูทิลิตีการอัปเดตบนโหนดของคุณตามลำดับที่อธิบายด้านล่างใน "ลำดับของเครื่อง อัปเดต" ด้านล่าง
    > /opt/apigee/apigee-setup/bin/update.sh -c คอมโพเนนต์ -f configFile

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

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

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

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

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

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

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

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

  1. สร้างที่เก็บ 4.17.01 ในเครื่องตามที่อธิบายไว้ใน "สร้างที่เก็บ Apigee ในเครื่อง" ที่ ติดตั้งยูทิลิตีการตั้งค่า Apigee ของ Edge
    หมายเหตุ: หากมีที่เก็บเวอร์ชัน 4.16.09 อยู่แล้ว คุณจะเพิ่ม 4.17.01 ได้ เก็บบันทึกไว้ใน "อัปเดตที่เก็บ Apigee ในเครื่อง" ที่ ติดตั้งยูทิลิตีการตั้งค่า Apigee ของ 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
    2. คัดลอกไฟล์ .tar ไปยังโหนดที่ต้องการอัปเดต Edge ตัวอย่างเช่น คัดลอกไปที่ ไดเรกทอรี /tmp ใน โหนดใหม่
    3. ในโหนดใหม่ ให้ยกเลิกการอัปโหลดไฟล์ไปยังไดเรกทอรี /tmp:
      > tar -Xzf apigee-4.17.01.tar.gz

      คำสั่งนี้จะสร้างไดเรกทอรีใหม่ที่ชื่อว่า repos ในไดเรกทอรีที่มี .tar เช่น /tmp/repos
    4. ติดตั้งยูทิลิตี Edge apigee-service และทรัพยากร 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 webserver" ที่ Install the Edge ยูทิลิตีการตั้งค่า Apigee
    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 ของ 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 ดังนี้
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup อัปเดต
  5. อัปเดต apigee-validate ในเซิร์ฟเวอร์การจัดการ
    > /opt/apigee/apigee-service/bin/apigee-service apigee-checkate อัปเดต
  6. อัปเดต apigee-provision ยูทิลิตี:
    อัปเดต /opt/apigee/apigee-service/bin/apigee-service apigee-provision
  7. เรียกใช้ยูทิลิตีการอัปเดตบนโหนดของคุณตามลำดับที่อธิบายด้านล่างใน "ลำดับของเครื่อง อัปเดต" ด้านล่าง:
    > /opt/apigee/apigee-setup/bin/update.sh -c คอมโพเนนต์ -f configFile

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

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

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

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

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

  • คุณต้องอัปเดตโหนด Cassandra และ ZooKeeper ทั้งหมดก่อนที่จะอัปเดต โหนดอื่นๆ
  • สําหรับเครื่องใดก็ตามที่มีคอมโพเนนต์ Edge หลายรายการ (เซิร์ฟเวอร์การจัดการ, Message Processor เราเตอร์, เซิร์ฟเวอร์ QPID แต่ไม่ใช่เซิร์ฟเวอร์ Postgres) ให้ใช้ "-c edge" ตัวเลือกการอัปเดตทั้งหมด ในเวลาเดียวกัน
  • หากขั้นตอนระบุว่าควรดำเนินการในหลายเครื่อง ให้ดำเนินการใน ลำดับเครื่องที่ระบุ
  • เราไม่มีขั้นตอนแยกต่างหากในการอัปเดตการสร้างรายได้ โดยจะอัปเดตเมื่อระบุ "-c" ขอบ" ตัวเลือก
  • (CentOS-6.x และ RedHat-6.x เท่านั้น) ในโหนด Qpid ทั้งหมดที่มี การเชื่อมต่ออินเทอร์เน็ตภายนอก โปรดตรวจสอบว่าคุณเรียกใช้คำสั่งต่อไปนี้เพื่อดาวน์โหลด รุ่น Qpid ที่ถูกต้องตามที่แสดงด้านบน:
    > อร่อย ติดตั้ง 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 --พอร์ตปลายทาง 5672! -s `ชื่อโฮสต์` -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. ล้าง iptable:
    > 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 การเริ่มต้น
  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 --พอร์ตปลายทาง 5672! -s `ชื่อโฮสต์` -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. ล้าง PIP บนเครื่อง 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 การเริ่มต้น
  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 --พอร์ตปลายทาง 5672! -s `ชื่อโฮสต์` -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. ล้าง PIP บนเครื่อง 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 การเริ่มต้น
  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 --พอร์ตปลายทาง 5672! -s `ชื่อโฮสต์` -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. ล้าง PIP บนเครื่อง 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 การเริ่มต้น
  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 --พอร์ตปลายทาง 5672! -s `ชื่อโฮสต์` -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. ล้าง PIP บนเครื่อง 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 การเริ่มต้น
  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 ใน Data Center 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. บนเครื่อง 7, 8 และ 9 ใน Data Center 2
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. อัปเดต qpidd:
    1. เครื่อง 4, 5 ใน Data Center 1
      1. ตั้งค่ากฎ iptables ต่อไปนี้ในเครื่อง 4
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `ชื่อโฮสต์` -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. ล้าง PIP บนเครื่อง 4:
        > sudo iptables -ฉ
      5. ทำขั้นตอนที่ 1 ถึง 4 ซ้ำในเครื่อง 5
    2. เครื่อง 10, 11 ใน Data Center 2
      1. ตั้งค่ากฎ iptables ต่อไปนี้ในเครื่อง 10:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `ชื่อโฮสต์` -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. ล้าง PIP บนเครื่อง 10:
        > sudo iptables -ฉ
      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 การเริ่มต้น
    2. เครื่อง 12 ในศูนย์ข้อมูล 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql การเริ่มต้น
  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 ใน Data Center 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

สำหรับ BaaS ของ API ทั้ง 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 เปิดอยู่บนโหนดสแต็กทุกรายการเพื่อเข้าถึงจากสแต็กอื่นๆ ทั้งหมด

ดูหลักเกณฑ์การติดตั้ง สำหรับรายการของโทโพโลยี 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

สำหรับ BaaS ของ API 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 เปิดอยู่บนโหนดสแต็กทุกรายการเพื่อเข้าถึงจากสแต็กอื่นๆ ทั้งหมด

ดูหลักเกณฑ์การติดตั้ง สำหรับรายการของโทโพโลยี 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, เซิร์ฟเวอร์การจัดการ, Message Processor และเราเตอร์
    หมายเหตุ: ถ้าโหนดมีทั้งเซิร์ฟเวอร์ Qpid และเซิร์ฟเวอร์ Postgres ให้เรียกใช้เมธอด "-ขอบ C" โปรไฟล์
  6. UI ของ Edge