อัปเดต Apigee Edge 4.17.01/4.17.05 เป็น 4.17.09

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

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

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

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

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

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

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

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

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

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

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

ต้องเพิ่มพารามิเตอร์การกำหนดค่า SMTPMAILFROM

Edge 4.17.05 ได้เพิ่มพารามิเตอร์ใหม่ที่จำเป็นลงในไฟล์การกำหนดค่าที่ใช้เมื่อคุณเปิดใช้เซิร์ฟเวอร์ SMTP หากอัปเดตจาก 4.17.01 คุณต้องตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่าเมื่อเปิดใช้เซิร์ฟเวอร์ SMTP

API BaaS เวอร์ชัน 4.17.09 ยังเพิ่มการรองรับพร็อพเพอร์ตี้ SMTPMAILFROM ด้วย เมื่ออัปเดต API BaaS จาก 4.17.01 หรือ 4.17.05 คุณต้องตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่า

พารามิเตอร์นี้มีรูปแบบดังนี้

SMTPMAILFROM="My Company <myco@company.com>"

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

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

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

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

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

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

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

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

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

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

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

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

  1. หากมี ให้ปิดใช้งานงาน CRON ที่กำหนดค่าให้ดำเนินการซ่อมแซมใน Cassandra จนกว่าการอัปเดตจะเสร็จสมบูรณ์
  2. เข้าสู่ระบบโหนดในฐานะรูทเพื่อติดตั้ง Edge RPM
    หมายเหตุ: แม้ว่าการติดตั้ง 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. หากติดตั้งใน AWS ให้เรียกใช้คำสั่ง yum-configure-manager ต่อไปนี้
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  6. ดาวน์โหลดไฟล์ Edge 4.17.09 bootstrap_4.17.09.sh ไปยัง /tmp/bootstrap_4.17.09.sh:
    > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  7. ติดตั้งยูทิลิตี apigee-service ของ Edge 4.17.09 และทรัพยากร Dependency ดังนี้
    > sudo bash /tmp/bootstrap_4.17.09.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 ด้วยตนเอง
  8. ใช้ apigee-service เพื่ออัปเดตยูทิลิตี apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  9. อัปเดตยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการ:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  10. อัปเดตยูทิลิตี apigee-provision โดยทำดังนี้
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  11. เรียกใช้ยูทิลิตีการอัปเดตในโหนดตามลำดับที่อธิบายไว้ด้านล่างใน "ลำดับการอัปเดตเครื่อง" ด้านล่าง
    > /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 ในโหนดเดียวกัน
  12. ทดสอบการอัปเดตโดยเรียกใช้ยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการตามที่อธิบายไว้ในทดสอบการติดตั้ง

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. หากคุณอัปเดตจาก 4.17.01 ให้ตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่าหากคุณเปิดใช้ SMTP ใน Edge พารามิเตอร์นี้มีรูปแบบดังนี้
    SMTPMAILFROM="My Company <myco@company.com>"
  2. อัปเดต Cassandra และ ZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. อัปเดต Qpid และ Postgres:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. เริ่ม postgresql:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. อัปเดต LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. อัปเดตคอมโพเนนต์ Edge ที่เหลือ:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. อัปเดต Edge UI:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. หากคุณอัปเดตจาก 4.17.01 ให้ตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่าหากคุณเปิดใช้ SMTP ใน Edge พารามิเตอร์นี้มีรูปแบบดังนี้
    SMTPMAILFROM="My Company <myco@company.com>"
  2. อัปเดต Cassandra และ ZooKeeper ในเครื่องที่ 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. อัปเดต Qpid และ Postgres ในเครื่องที่ 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. เริ่ม postgresql ในเครื่อง 2:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. อัปเดต LDAP ในเครื่องที่ 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 2 และ 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. อัปเดต UI ในเครื่องที่ 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. หากคุณอัปเดตจาก 4.17.01 ให้ตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่าหากคุณเปิดใช้ SMTP ใน Edge พารามิเตอร์นี้มีรูปแบบดังนี้
    SMTPMAILFROM="My Company <myco@company.com>"
  2. อัปเดต Cassandra และ ZooKeeper ในเครื่อง 1, 2 และ 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. อัปเดต Qpid และ Postgres ในเครื่อง 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. เริ่ม postgresql ในเครื่อง 4:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. ทำขั้นตอนที่ 3 และ 4 ซ้ำในเครื่องที่ 5
  6. อัปเดต LDAP ในเครื่องที่ 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  7. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 4, 5, 1, 2, 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. อัปเดต UI ในเครื่องที่ 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. หากคุณอัปเดตจาก 4.17.01 ให้ตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่าหากคุณเปิดใช้ SMTP ใน Edge พารามิเตอร์นี้มีรูปแบบดังนี้
    SMTPMAILFROM="My Company <myco@company.com>"
  2. อัปเดต Cassandra และ ZooKeeper ในเครื่อง 1, 2 และ 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. อัปเดต Qpid และ Postgres ในเครื่อง 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. เริ่ม postgresql ในเครื่อง 6:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. ทำขั้นตอนที่ 3 และ 4 ซ้ำในเครื่องที่ 7
  6. อัปเดต LDAP ในเครื่องที่ 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  7. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 6, 7, 8, 9, 1, 4 และ 5 ตามลำดับต่อไปนี้
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. อัปเดต UI ในเครื่องที่ 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. หากคุณอัปเดตจาก 4.17.01 ให้ตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่าหากคุณเปิดใช้ SMTP ใน Edge พารามิเตอร์นี้มีรูปแบบดังนี้
    SMTPMAILFROM="My Company <myco@company.com>"
  2. อัปเดต Cassandra และ ZooKeeper ในเครื่อง 1, 2 และ 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. อัปเดต Qpid และ Postgres ในเครื่อง 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. เริ่ม postgresql ในเครื่อง 12:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. ทำขั้นตอนที่ 3 และ 4 ซ้ำในเครื่อง 13
  6. อัปเดต LDAP ในเครื่อง 4 และ 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  7. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 12, 13, 8, 9, 6, 7, 10 และ 11 ตามลำดับดังนี้
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. อัปเดต UI ในเครื่อง 6 และ 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. หากคุณอัปเดตจาก 4.17.01 ให้ตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่าหากคุณเปิดใช้ SMTP ใน Edge พารามิเตอร์นี้มีรูปแบบดังนี้
    SMTPMAILFROM="My Company <myco@company.com>"
  2. อัปเดต 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
  3. อัปเดต qpidd โดยทำดังนี้
    1. เครื่อง 4, 5 ในศูนย์ข้อมูล 1
      1. อัปเดต qpidd ในเครื่อง 4:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. ทำขั้นตอนที่ 1 ซ้ำในเครื่องที่ 5
    2. เครื่อง 10, 11 ในศูนย์ข้อมูล 2
      1. อัปเดต qpidd ในเครื่อง 10:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. ทำขั้นตอนที่ 1 ซ้ำในเครื่อง 11
  4. อัปเดต 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
  5. อัปเดต 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
  6. อัปเดตคอมโพเนนต์ 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
  7. อัปเดต 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 โฮสต์

  1. ตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่า พารามิเตอร์นี้มีรูปแบบดังนี้
    SMTPMAILFROM="My Company <myco@company.com>"
  2. อัปเดต Cassandra ในเครื่อง 5, 6 และ 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

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

  4. อัปเดตพอร์ทัล API BaaS ในเครื่อง 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

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

  1. ตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่า พารามิเตอร์นี้มีรูปแบบดังนี้
    SMTPMAILFROM="My Company <myco@company.com>"
  2. อัปเดต Cassandra ในเครื่อง 8, 9 และ 10:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  3. อัปเดต ElasticSearch ในเครื่อง 1, 2 และ 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  4. อัปเดตสแต็ก API BaaS ในเครื่อง 4, 5 และ 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  5. อัปเดตพอร์ทัล API BaaS ในเครื่อง 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

สำหรับการติดตั้ง API Baas ในศูนย์ข้อมูล 2 แห่ง

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

  1. ตั้งค่า SMTPMAILFROM ในไฟล์การกำหนดค่า พารามิเตอร์นี้มีรูปแบบดังนี้
    SMTPMAILFROM="My Company <myco@company.com>"
  2. อัปเดตคีย์สเปซ Cassandra ด้วยปัจจัยการจำลองที่ถูกต้องสำหรับศูนย์ข้อมูลทั้ง 2 แห่ง คุณต้องทำขั้นตอนนี้เพียงครั้งเดียวในเซิร์ฟเวอร์ Cassandra ในศูนย์ข้อมูลใดศูนย์ข้อมูลหนึ่ง ดังนี้

    หมายเหตุ: คำสั่งด้านล่างทั้งหมดจะตั้งค่าปัจจัยการจำลองเป็น "3" ซึ่งหมายถึงโหนด Cassandra 3 โหนดในคลัสเตอร์ แก้ไขค่านี้ตามความจำเป็นสำหรับการติดตั้ง
    1. เริ่มยูทิลิตี Cassandra cqlsh:
      > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. เรียกใช้คำสั่ง CQL ต่อไปนี้ที่พรอมต์ "cqlsh>" เพื่อตั้งค่าระดับการจำลองสำหรับคีย์สเปซ Cassandra
      1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      2. cqlsh> ALTER KEYSPACE "Apigee_Baas" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      3. cqlsh> ALTER KEYSPACE "Apigee_Baas_Locks" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      4. cqlsh> ALTER KEYSPACE "system_traces" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      5. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      6. ดูคีย์สเปซโดยใช้คำสั่งต่อไปนี้
        cqlsh> select * from system.schema_keyspaces;
      7. ออกจาก cqlsh:
        cqlsh> exit
  3. (เฉพาะในกรณีที่คุณไม่ได้อัปเดต Cassandra เป็นส่วนหนึ่งของการอัปเดต Edge) อัปเดตโหนด Cassandra ในศูนย์ข้อมูล 1 ทีละเครื่อง:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  4. (เฉพาะในกรณีที่คุณไม่ได้อัปเดต Cassandra เป็นส่วนหนึ่งของการอัปเดต Edge) อัปเดตโหนด Cassandra ในศูนย์ข้อมูล 2 ทีละเครื่อง:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  5. อัปเดต ElasticSearch ในเครื่องในศูนย์ข้อมูล 1 ทีละเครื่อง:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  6. อัปเดต ElasticSearch ในเครื่องในศูนย์ข้อมูล 2 ทีละเครื่อง:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  7. อัปเดตสแต็ก API BaaS ในเครื่องในศูนย์ข้อมูล 1 ทีละเครื่อง:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  8. อัปเดต API BaaS Stack ในเครื่องในศูนย์ข้อมูล 2 ทีละเครื่อง:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  9. อัปเดตพอร์ทัล API BaaS ในเครื่องในศูนย์ข้อมูล 1 ทีละเครื่อง:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
  10. อัปเดตพอร์ทัล API BaaS ในเครื่องในศูนย์ข้อมูล 2 ทีละเครื่อง:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
  11. อัปเดตค่าคีย์สเปซ BaaS ต้องตั้งค่าคีย์สเปซเหล่านี้สำหรับการจำลองแบบ ณ เวลาติดตั้ง แต่ไม่จำเป็นต้องตั้งค่า ณ รันไทม์ การนำการจำลองออกยังช่วยประหยัดหน่วยความจำ Cassandra ด้วย

    คุณต้องทำขั้นตอนนี้เพียงครั้งเดียวในเซิร์ฟเวอร์ Cassandra ในศูนย์ข้อมูลใดศูนย์ข้อมูลหนึ่ง ดังนี้
    1. เริ่มยูทิลิตี Cassandra cqlsh:
      > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. เรียกใช้คำสั่ง CQL ต่อไปนี้เพื่อตั้งค่าระดับการจำลองสำหรับคีย์สเปซ Cassandra
      1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3' };
      2. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-2': '3' };
      3. ดูคีย์สเปซโดยใช้คำสั่งต่อไปนี้
        cqlsh> select * from system.schema_keyspaces;
      4. ออกจาก cqlsh:
        cqlsh> exit

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

หากคุณมีการติดตั้งที่ไม่ได้มาตรฐาน ให้อัปเดตคอมโพเนนต์ 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