อัปเดต Apigee Edge 4.17.05 หรือ 4.17.09 เป็น 4.18.05

Edge สำหรับ Private Cloud เวอร์ชัน 4.18.05

ส่วนนี้อธิบายวิธีดำเนินการอัปเกรดต่อไปนี้

  • ตั้งแต่ 4.17.05 ถึง 4.18.05
  • ตั้งแต่ 4.17.09 ถึง 4.18.05

ผู้ที่มีสิทธิ์อัปเดต

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

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

คอมโพเนนต์ที่ต้องอัปเดต

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

รักษาความเข้ากันได้

เมื่ออัปเกรด Apigee Edge สำหรับ Private Cloud เป็นเวอร์ชัน 4.18.05 คุณต้องตรวจสอบว่าการใช้งานผลลัพธ์อ้างอิงเฉพาะพร็อพเพอร์ตี้ที่รองรับในไฟล์การกำหนดค่าเท่านั้น

พร็อพเพอร์ตี้ ตำแหน่ง คำอธิบาย
conf_load_balancing_load.balancing.
  driver.nginx.server.retry
router.properties นำพร็อพเพอร์ตี้นี้ออกจากไฟล์ router.properties หากต้องการตั้งค่าตัวเลือกการลองอีกครั้งใน 4.18.05 ให้ใช้พร็อพเพอร์ตี้การกำหนดค่าโฮสต์เสมือน

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

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

การเพิ่มพารามิเตอร์การกำหนดค่า SMTPMAILFROM ที่จำเป็น

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

ต้องอัปเกรดเป็น Postgres 9.6

Edge รุ่นนี้มีการอัปเกรดเป็น Postgres 9.6 จากการอัปเกรดดังกล่าว ระบบจะย้ายข้อมูล Postgres ทั้งหมดไปยัง Postgres 9.6

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

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

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

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

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

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

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

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

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

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

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

  1. ในต้นแบบ Postgres ปัจจุบัน ให้แก้ไขไฟล์ /opt/apigee/customer/application/postgresql.properties เพื่อตั้งค่าโทเค็นต่อไปนี้ หากไม่มีไฟล์ดังกล่าว ให้สร้างขึ้นมาโดยทำดังนี้
    conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust

    โดยที่ existing_slave_ip คือที่อยู่ IP ของเซิร์ฟเวอร์ในโหมดสแตนด์บาย Postgres ปัจจุบัน และ new_slave_ip คือที่อยู่ IP ของโหนดสแตนด์บายใหม่

  2. รีสตาร์ท apigee-postgresql ในต้นแบบ Postgres:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. ตรวจสอบว่าได้เพิ่มโหนดสแตนด์บายใหม่โดยดูไฟล์ /opt/apigee/apigee-postgresql/conf/pg_hba.conf บนต้นแบบ คุณควรจะเห็นบรรทัดต่อไปนี้ในไฟล์นั้น:
    host replication apigee existing_slave_ip/32 trust
    host replication apigee new_slave_ip/32 trust
  4. ติดตั้งเซิร์ฟเวอร์ในโหมดสแตนด์บาย Postgres ใหม่โดยทำดังนี้
    1. แก้ไขไฟล์การกำหนดค่าที่คุณใช้ติดตั้ง Edge เวอร์ชันปัจจุบันเพื่อระบุดังนี้
      # IP address of the current master:
      PG_MASTER=192.168.56.103
      # IP address of the new standby node
      PG_STANDBY=192.168.56.102
    2. ปิดใช้ SELinux ตามที่อธิบายไว้ในติดตั้งยูทิลิตี Edge Apigee-setup
    3. ดาวน์โหลดไฟล์ Edge bottrap_4.17.0x.sh โดยที่ x คือ 5 (สำหรับ 4.17.05) หรือ 9 (สำหรับ 4.17.09) ถึง /tmp/bootstrap_4.17.0x.sh :
      curl https://software.apigee.com/bootstrap_4.17.0x.sh -o /tmp/bootstrap_4.17.0x.sh
    4. ติดตั้งยูทิลิตีและทรัพยากร Dependency ของ Edge apigee-service
      sudo bash /tmp/bootstrap_4.17.0x.sh apigeeuser=uName apigeepassword=pWord
    5. ใช้ apigee-service เพื่อติดตั้งยูทิลิตี apigee-setup:
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    6. ติดตั้ง Postgres:
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    7. ในโหนดสแตนด์บายใหม่ ให้เรียกใช้คำสั่งต่อไปนี้
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      ตรวจสอบว่าระบบระบุว่าเป็นโหมดสแตนด์บาย

การเลิกใช้งานโหนด Postgres

หลังจากอัปเดตเสร็จสมบูรณ์ ให้เลิกใช้โหนดสแตนด์บายใหม่:

  1. ตรวจสอบว่า Postgres ทำงานอยู่
    /opt/apigee/apigee-service/bin/apigee-all status

    หาก Postgres ไม่ได้ทำงานอยู่ ให้เริ่มต้นดังนี้

    /opt/apigee/apigee-service/bin/apigee-all start

  2. รับ UUID ของโหนดสแตนด์บายใหม่โดยเรียกใช้คำสั่ง cURL ต่อไปนี้ในโหนดสแตนด์บายใหม่:
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    คุณควรเห็น UUID ของโหนดที่จุดสิ้นสุดของเอาต์พุตในรูปแบบ:

    "type" : [ "postgres-server" ],
    "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"

  3. หยุดโหนดสแตนด์บายใหม่โดยเรียกใช้คำสั่งต่อไปนี้บนโหนดสแตนด์บายใหม่:
    /opt/apigee/apigee-service/bin/apigee-all stop
  4. ในโหนดหลักของ Postgres ให้แก้ไข /opt/apigee/customer/application/postgresql.properties เพื่อนำโหนดสแตนด์บายใหม่ออกจาก conf_pg_hba_replication.connection:
    conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust
  5. รีสตาร์ท apigee-postgresql ในต้นแบบ Postgres:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. ยืนยันว่ามีการนำโหนดสแตนด์บายใหม่ออกโดยดูไฟล์ /opt/apigee/apigee-postgresql/conf/pg_hba.conf บนต้นแบบ คุณควรเห็นเฉพาะบรรทัดต่อไปนี้ในไฟล์นั้น:
    host replication apigee existing_slave_ip/32 trust
  7. ลบ UUID ของโหนดสแตนด์บายออกจาก ZooKeeper โดยเรียก Edge Management API ต่อไปนี้ในโหนด Management Server
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_slave_uuid

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

ตรวจสอบข้อกำหนดเบื้องต้นต่อไปนี้ก่อนอัปเกรด Apigee Edge

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

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

  • ตรวจสอบว่า Edge ทำงานอยู่
    ตรวจสอบว่า Edge ทำงานอยู่ในระหว่างขั้นตอนการอัปเดตโดยใช้คำสั่งต่อไปนี้
    /opt/apigee/apigee-service/bin/apigee-all status

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

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

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

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

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

การใช้ไฟล์การกำหนดค่าเงียบ

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

อัปเดตเป็น 4.18.05 บนโหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก

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

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

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

  2. หากมี ให้ปิดใช้งาน CRON ที่กำหนดค่าเพื่อดำเนินการซ่อมแซมใน Cassandra จนกว่าการอัปเดตจะเสร็จสมบูรณ์
  3. เข้าสู่ระบบโหนดในฐานะรูทเพื่อติดตั้ง Edge RPM
  4. ติดตั้ง yum-utils และ yum-plugin-priorities:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities
  5. ปิดใช้ SELinux ตามที่อธิบายไว้ในติดตั้งยูทิลิตี Edge Apigee-setup
  6. หากกำลังติดตั้งบน Oracle 7.x ให้เรียกใช้คำสั่งต่อไปนี้
    sudo yum-config-manager --enable ol7_optional_latest
  7. หากจะติดตั้งบน AWS ให้เรียกใช้คำสั่ง yum-configure-manager ต่อไปนี้
    yum update rh-amazon-rhui-client.noarch
    sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  8. ดาวน์โหลดไฟล์ bootstrap_4.18.05.sh Edge 4.18.05 ไปยัง /tmp/bootstrap_4.18.05.sh:
    curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  9. ติดตั้งยูทิลิตีและการอ้างอิง Edge 4.18.05 ของ apigee-service
    sudo bash /tmp/bootstrap_4.18.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 ด้วยตนเองสำหรับตัวเลือกนี้
  10. ใช้ apigee-service เพื่ออัปเดตยูทิลิตี apigee-setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. อัปเดตยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการ:
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  12. อัปเดตยูทิลิตี apigee-provision:
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  13. เรียกใช้ยูทิลิตีการอัปเดตบนโหนดของคุณตามลำดับที่อธิบายไว้ในลำดับการอัปเดตเครื่อง:
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

    ใช้ตัวเลือก -c เพื่อระบุคอมโพเนนต์ที่จะอัปเดต รายการคอมโพเนนต์ที่เป็นไปได้มีดังนี้

    • "cs" = คาสซานดรา
    • "e" = ElasticSearch
    • "edge" =คอมโพเนนต์ Edge ทั้งหมด ยกเว้น Edge UI คอมโพเนนต์ "edge" ประกอบด้วย Management Server, Message Processor, Router, QPID Server, Edge Postgres Server
    • "ldap" = OpenLDAP
    • "ps" = Postgresql
    • "qpid" = qpidd
    • "sso" = Edge SSO
    • "ui" = UI ของ Edge
    • "zk" = ผู้ดูแลสวนสัตว์

    คุณเรียกใช้ update.sh กับคอมโพเนนต์ทั้งหมดได้โดยตั้งค่า component เป็น "ทั้งหมด" แต่เฉพาะเมื่อมีโปรไฟล์การติดตั้ง Edge all-in-one (aio) เท่านั้น เช่น

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  14. รีสตาร์ทคอมโพเนนต์ Edge UI ในเครื่องทุกเครื่องที่เรียกใช้คอมโพเนนต์ดังกล่าวหากยังไม่ได้ทำ
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  15. ทดสอบการอัปเดตโดยเรียกใช้ยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการตามที่อธิบายไว้ในทดสอบการติดตั้ง
  16. หากคุณติดตั้งโหนด Postgres ใหม่ในโหมดสแตนด์บาย ให้ปิดใช้งานโหนดตามที่อธิบายไว้ในการเลิกใช้งานโหนด Postgres

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

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

อัปเดตเป็น 4.18.05 จากที่เก็บในพื้นที่

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

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

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

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

  1. หากคุณกำลังใช้การจำลองในโหมดสแตนด์บายต้นแบบ Postgres ให้ติดตั้งโหนดในโหมดสแตนด์บาย Postgres ใหม่ตามที่อธิบายไว้ในการติดตั้งโหนดสแตนด์บาย Postgres ใหม่

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

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

      คำสั่งนี้จะสร้างไดเรกทอรีใหม่ที่ชื่อว่า repos ในไดเรกทอรีที่มีไฟล์ .tar ตัวอย่างเช่น /tmp/repos

    4. ติดตั้งยูทิลิตี้ Edge Apigee-service และ Dependencies จาก /tmp/repos:
      sudo bash /tmp/repos/bootstrap_4.18.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      โปรดสังเกตว่าคุณใส่เส้นทางไปยังไดเรกทอรี Repos ในคำสั่งนี้

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

      โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณตั้งค่าไว้ก่อนหน้านี้สำหรับที่เก็บ และ remoteRepo คือที่อยู่ IP หรือชื่อ DNS ของโหนดที่เก็บ

    3. ติดตั้งยูทิลิตี apigee-service Edge apigee-service และทรัพยากร Dependency ในโหนดระยะไกล:
      sudo bash /tmp/bootstrap_4.18.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      โดย uName:pWord คือชื่อผู้ใช้และรหัสผ่านของที่เก็บ

  5. ใช้ apigee-service เพื่ออัปเดตยูทิลิตี apigee-setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
  6. อัปเดตยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการ:
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  7. อัปเดตยูทิลิตี apigee-provision:
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  8. เรียกใช้ยูทิลิตี update บนโหนดของคุณตามลำดับที่อธิบายไว้ในลำดับการอัปเดตเครื่อง:
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

    ใช้ตัวเลือก -c เพื่อระบุคอมโพเนนต์ที่จะอัปเดต รายการคอมโพเนนต์ที่เป็นไปได้มีดังนี้

    • "cs" = คาสซานดรา
    • "e" = ElasticSearch
    • "edge" =คอมโพเนนต์ Edge ทั้งหมด ยกเว้น Edge UI คอมโพเนนต์ "edge" ประกอบด้วย Management Server, Message Processor, Router, QPID Server, Edge Postgres Server
    • "ldap" = OpenLDAP
    • "ps" = Postgresql
    • "qpid" = qpidd
    • "sso" = Edge SSO
    • "ui" = UI ของ Edge
    • "zk" = ผู้ดูแลสวนสัตว์

    คุณเรียกใช้ update.sh กับคอมโพเนนต์ทั้งหมดได้โดยตั้งค่า component เป็น "ทั้งหมด" แต่เฉพาะเมื่อมีโปรไฟล์การติดตั้ง Edge all-in-one (aio) เท่านั้น เช่น

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  9. รีสตาร์ทคอมโพเนนต์ Edge UI ในเครื่องทุกเครื่องที่เรียกใช้คอมโพเนนต์ดังกล่าวหากยังไม่ได้ทำ
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  10. ทดสอบการอัปเดตโดยเรียกใช้ยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการตามที่อธิบายไว้ในทดสอบการติดตั้ง
  11. หากคุณติดตั้งโหนด Postgres ใหม่ในโหมดสแตนด์บาย ให้ปิดใช้งานโหนดตามที่อธิบายไว้ในการเลิกใช้งานโหนด Postgres

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

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

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

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

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

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

  1. อัปเดต Cassandra และ ZooKeeper:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. อัปเดต Qpid:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. อัปเดต LDAP:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. หยุดเซิร์ฟเวอร์ Postgres, เซิร์ฟเวอร์ Qpid และ PostgreSQL:
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
  5. อัปเดต Postgresql:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  6. อัปเดตฐานข้อมูล Postgres ดังนี้
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  7. อัปเดตคอมโพเนนต์ Edge ที่เหลือ:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. อัปเดต Edge UI:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  9. (หากคุณติดตั้ง Edge SSO) ให้อัปเดต Edge SSO โดยทำดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    โดย sso_config_file คือไฟล์การกำหนดค่าที่คุณสร้างขึ้นเมื่อติดตั้ง SSO

  10. เริ่มคอมโพเนนต์ Edge UI ใหม่ โดยทำดังนี้
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

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

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

  1. อัปเดต Cassandra และ ZooKeeper ในเครื่อง 1:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. อัปเดต Qpid ในเครื่อง 2:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. อัปเดต LDAP ในเครื่อง 1:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 1:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. อัปเดต UI ในเครื่อง 1:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. (หากติดตั้ง Edge SSO ไว้) ให้อัปเดต Edge SSO ในเครื่อง 1 ดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    โดย sso_config_file คือไฟล์การกำหนดค่าที่คุณสร้างขึ้นเมื่อติดตั้ง SSO

  7. อัปเดต Postgresql ในเครื่อง 2 โดยทำดังนี้
    1. หยุดเซิร์ฟเวอร์ Postgres, เซิร์ฟเวอร์ Qpid และ postgresql:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    2. อัปเดต Postgresql:
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. อัปเดตฐานข้อมูล Postgres ดังนี้
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    4. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 2:
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. รีสตาร์ทคอมโพเนนต์ Edge UI ในเครื่อง 1 โดยทำดังนี้
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

การติดตั้ง 5 โหนด

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

  1. ตรวจสอบว่าคุณได้ติดตั้งโหนดสแตนด์บาย Postgres ใหม่ตามที่อธิบายไว้ในการติดตั้งโหนดสแตนด์บาย Postgres ใหม่

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

  2. อัปเดต Cassandra และ ZooKeeper ในเครื่อง 1, 2 และ 3:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. อัปเดต Qpid ในเครื่อง 4 และ 5:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. อัปเดต LDAP ในเครื่อง 1:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 1, 2, 3 ดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. อัปเดต UI ในเครื่อง 1:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (หากติดตั้ง Edge SSO ไว้) ให้อัปเดต Edge SSO ในเครื่อง 1 ดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    โดย sso_config_file คือไฟล์การกำหนดค่าที่คุณสร้างขึ้นเมื่อติดตั้ง SSO

  8. อัปเดตเครื่อง 4 และ 5 โดยทำดังนี้
    1. หยุดเซิร์ฟเวอร์ Postgres และเซิร์ฟเวอร์ Qpid ในเครื่อง 4:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    2. หยุดเซิร์ฟเวอร์ Postgres, เซิร์ฟเวอร์ Qpid และ Postgresql ในเครื่อง 5:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. หากติดตั้งแล้ว ให้หยุดเซิร์ฟเวอร์ Postgres และ Postgresql ในโหนดสแตนด์บายใหม่ที่คุณเพิ่มสำหรับการย้อนกลับ:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    4. อัปเดต postgresql ในเครื่อง 4:
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. อัปเดตฐานข้อมูล Postgres ในเครื่อง 4 (ต้นแบบ Postgres เท่านั้น) ดังนี้
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. อัปเดต Postgresql ในเครื่อง 5:
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. เริ่มต้นเซิร์ฟเวอร์ Postgres และเซิร์ฟเวอร์ Qpid ในเครื่องคอมพิวเตอร์ 4 และ 5:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    8. กำหนดค่า Postgres เป็นโหนดสแตนด์บายโดยเรียกใช้คำสั่งต่อไปนี้ในเครื่อง 5:
      cd /opt/apigee/data/apigee-postgresql/pgdata
      rm -rf *
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    9. ยืนยันสถานะการจำลองโดยออกสคริปต์ต่อไปนี้บนเซิร์ฟเวอร์ทั้ง 2 เครื่อง ระบบควรแสดงผลลัพธ์ที่เหมือนกันบนเซิร์ฟเวอร์ทั้ง 2 แห่งเพื่อให้การจำลองประสบความสำเร็จ
      • โหนดหลักในเครื่อง 4 ให้เรียกใช้
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        ยืนยันว่าเป็นต้นฉบับ

      • ในเครื่อง 5 โหนดสแตนด์บาย:
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        ตรวจสอบว่าระบบระบุว่าเป็นโหมดสแตนด์บาย

  9. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 4, 5 ดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. ตรวจสอบว่าคุณได้ปิดใช้งานโหนดสแตนด์บายใหม่ตามที่อธิบายไว้ในการเลิกใช้งานโหนด Postgres

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

  11. รีสตาร์ทคอมโพเนนต์ Edge UI ในเครื่อง 1 โดยทำดังนี้
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

การติดตั้งคลัสเตอร์ 9 โหนด

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

  1. ตรวจสอบว่าคุณได้ติดตั้งโหนดสแตนด์บาย Postgres ใหม่ตามที่อธิบายไว้ในการติดตั้งโหนดสแตนด์บาย Postgres ใหม่

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

  2. อัปเดต Cassandra และ ZooKeeper ในเครื่อง 1, 2 และ 3:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. อัปเดต Qpid ในเครื่อง 6 และ 7:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. อัปเดต LDAP ในเครื่อง 1:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 6, 7, 1, 4 และ 5 ตามลำดับดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. อัปเดต UI ในเครื่อง 1:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (หากติดตั้ง Edge SSO ไว้) ให้อัปเดต Edge SSO ในเครื่อง 1 ดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    โดย sso_config_file คือไฟล์การกำหนดค่าที่คุณสร้างขึ้นเมื่อติดตั้ง SSO

  8. อัปเดตเครื่อง 8 และ 9 โดยทำดังนี้
    1. หยุดเซิร์ฟเวอร์ Postgres ในเครื่อง 8:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. หยุดเซิร์ฟเวอร์ Postgres และ Postgresql ในเครื่อง 9:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. หยุดเซิร์ฟเวอร์ Qpid ในเครื่อง 6 และ 7 โดยทำดังนี้
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. หากติดตั้งแล้ว ให้หยุดเซิร์ฟเวอร์ Postgres และ Postgresql ในโหนดสแตนด์บายใหม่ที่คุณเพิ่มสำหรับการย้อนกลับ:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. อัปเดต postgresql ในเครื่อง 8:
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. อัปเดตฐานข้อมูล Postgres ในเครื่อง 8 (ต้นแบบ Postgres เท่านั้น) ดังนี้
      /-->
      opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. อัปเดต postgresql บนเครื่อง 9:
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. เริ่มต้นเซิร์ฟเวอร์ Postgres ในเครื่อง 8 และ 9:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. เริ่มต้นเซิร์ฟเวอร์ Qpid ในเครื่อง 6 และ 7 ดังนี้
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. กำหนดค่า Postgres เป็นโหนดสแตนด์บายโดยเรียกใช้คำสั่งต่อไปนี้ในเครื่อง 9:
      cd /opt/apigee/data/apigee-postgresql/pgdata
      rm -rf *
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    11. ยืนยันสถานะการจำลองโดยออกสคริปต์ต่อไปนี้บนเซิร์ฟเวอร์ทั้ง 2 เครื่อง ระบบควรแสดงผลลัพธ์ที่เหมือนกันบนเซิร์ฟเวอร์ทั้ง 2 แห่งเพื่อให้การจำลองประสบความสำเร็จ
      • โหนดหลักในเครื่อง 8 ให้เรียกใช้
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        ยืนยันว่าเป็นต้นฉบับ

      • ในเครื่อง 9 โหนดสแตนด์บาย:
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        ตรวจสอบว่าระบบระบุว่าเป็นโหมดสแตนด์บาย

  9. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 8 และ 9 ดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. ตรวจสอบว่าคุณเลิกใช้โหนดสแตนด์บายใหม่ตามที่อธิบายไว้ในการเลิกใช้งานโหนด Postgres

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

  11. รีสตาร์ทคอมโพเนนต์ Edge UI ในเครื่อง 1 โดยทำดังนี้
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

การติดตั้งคลัสเตอร์ 13 โหนด

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

  1. ตรวจสอบว่าคุณได้ติดตั้งโหนดสแตนด์บาย Postgres ใหม่ตามที่อธิบายไว้ในการติดตั้งโหนดสแตนด์บาย Postgres ใหม่

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

  2. อัปเดต Cassandra และ ZooKeeper ในเครื่อง 1, 2 และ 3:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. อัปเดต Qpid ในเครื่อง 12 และ 13:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. อัปเดต LDAP ในเครื่อง 4 และ 5:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 12, 13, 6, 7, 10 และ 11 ตามลำดับดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. อัปเดต UI ในเครื่อง 6 และ 7:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (หากติดตั้ง Edge SSO ไว้) อัปเดต Edge SSO ในเครื่อง 6 และ 7 ดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    โดย sso_config_file คือไฟล์การกำหนดค่าที่คุณสร้างขึ้นเมื่อติดตั้ง SSO

  8. อัปเดตเครื่อง 8 และ 9 โดยทำดังนี้
    1. หยุดเซิร์ฟเวอร์ Postgres ในเครื่อง 8:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. หยุดเซิร์ฟเวอร์ Postgres และ Postgresql ในเครื่อง 9:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. หยุดเซิร์ฟเวอร์ Qpid ในเครื่อง 12 และ 13:
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. หากติดตั้งแล้ว ให้หยุดเซิร์ฟเวอร์ Postgres และ Postgresql ในโหนดสแตนด์บายใหม่ที่คุณเพิ่มสำหรับการย้อนกลับ:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. อัปเดต postgresql ในเครื่อง 8:
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. อัปเดตฐานข้อมูล Postgres ในเครื่อง 8 (ต้นแบบ Postgres เท่านั้น) ดังนี้
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. อัปเดต postgresql บนเครื่อง 9:
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. เริ่มต้นเซิร์ฟเวอร์ Postgres ในเครื่อง 8 และ 9:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. เริ่มต้นเซิร์ฟเวอร์ Qpid ในเครื่องที่ 12 และ 13:
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. กำหนดค่า Postgres เป็นโหนดสแตนด์บายโดยเรียกใช้คำสั่งต่อไปนี้ในเครื่อง 9:
      cd /opt/apigee/data/apigee-postgresql/pgdata
      rm -rf *
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    11. ยืนยันสถานะการจำลองโดยออกสคริปต์ต่อไปนี้บนเซิร์ฟเวอร์ทั้ง 2 เครื่อง ระบบควรแสดงผลลัพธ์ที่เหมือนกันบนเซิร์ฟเวอร์ทั้ง 2 แห่งเพื่อให้การจำลองประสบความสำเร็จ
      • โหนดหลักในเครื่อง 8 ให้เรียกใช้
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        ยืนยันว่าเป็นต้นฉบับ

      • ในเครื่อง 9 โหนดสแตนด์บาย:
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        ตรวจสอบว่าระบบระบุว่าเป็นโหมดสแตนด์บาย

  9. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 8 และ 9 ดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. ตรวจสอบว่าคุณเลิกใช้โหนดสแตนด์บายใหม่ตามที่อธิบายไว้ในการเลิกใช้งานโหนด Postgres

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

  11. รีสตาร์ทคอมโพเนนต์ Edge UI ในเครื่อง 6 และ 7 โดยทำดังนี้
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

การติดตั้งคลัสเตอร์ 12 โหนด

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

  1. ตรวจสอบว่าคุณได้ติดตั้งโหนดสแตนด์บาย Postgres ใหม่ตามที่อธิบายไว้ในการติดตั้งโหนดสแตนด์บาย Postgres ใหม่

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

  2. อัปเดต Cassandra และ ZooKeeper
    1. ในเครื่องที่ 1, 2 และ 3 ในศูนย์ข้อมูล 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
  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 ใน Data Center 2
      1. อัปเดตqpidd ในเครื่อง 10:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. ทำขั้นตอนที่ 1 ซ้ำในเครื่อง 11
  4. อัปเดต LDAP โดยทําดังนี้
    1. เครื่อง 1 ในศูนย์ข้อมูล 1
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. เครื่อง 7 ใน Data Center 2
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. อัปเดตคอมโพเนนต์ Edge ดังนี้
    1. เครื่อง 4, 5, 1, 2, 3 ในศูนย์ข้อมูล 1
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. เครื่องที่ 10, 11, 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
  7. (หากติดตั้ง Edge SSO ไว้) ให้อัปเดต Edge SSO โดยทำดังนี้
    1. เครื่อง 1 ในศูนย์ข้อมูล 1:
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. เครื่อง 7 ในศูนย์ข้อมูล 2:
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    3. โดย sso_config_file คือไฟล์การกำหนดค่าที่คุณสร้างขึ้นเมื่อติดตั้ง SSO

  8. อัปเดตเครื่อง 6 ในศูนย์ข้อมูล 1 และ 12 ในศูนย์ข้อมูล 2:
    1. หยุดเซิร์ฟเวอร์ Postgres ในเครื่อง 6:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. หยุดเซิร์ฟเวอร์ Postgres และ Postgresql ในเครื่อง 12:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. หยุดเซิร์ฟเวอร์ Qpid ในเครื่อง 4, 5, 10 และ 11:
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. หากติดตั้งแล้ว ให้หยุดเซิร์ฟเวอร์ Postgres และ Postgresql ในโหนดสแตนด์บายใหม่ที่คุณเพิ่มสำหรับการย้อนกลับ:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. อัปเดต postgresql ในเครื่อง 6:
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. อัปเดตฐานข้อมูล Postgres ในเครื่อง 6 (ต้นแบบ Postgres เท่านั้น) ดังนี้
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. อัปเดต Postgresql ในเครื่อง 12:
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. เริ่มต้นเซิร์ฟเวอร์ Postgres ในเครื่อง 6 และ 12:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. เริ่มต้นเซิร์ฟเวอร์ Qpid ในเครื่องคอมพิวเตอร์ 4, 5, 10 และ 11:
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. กำหนดค่า Postgres เป็นโหนดสแตนด์บายโดยเรียกใช้คำสั่งต่อไปนี้ในเครื่อง 12:
      cd /opt/apigee/data/apigee-postgresql/pgdata
      rm -rf *
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    11. ยืนยันสถานะการจำลองโดยออกสคริปต์ต่อไปนี้บนเซิร์ฟเวอร์ทั้ง 2 เครื่อง ระบบควรแสดงผลลัพธ์ที่เหมือนกันในเซิร์ฟเวอร์ทั้ง 2 แห่งเพื่อให้การจำลองประสบความสำเร็จ

      ในเครื่อง 6 ให้โหนดหลักเรียกใช้ดังนี้

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      ยืนยันว่าเป็นต้นฉบับ

      ในเครื่อง 12 โหนดสแตนด์บายจะ:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      ตรวจสอบว่าระบบระบุว่าเป็นโหมดสแตนด์บาย

  9. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 6 และ 12:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. ตรวจสอบว่าคุณเลิกใช้โหนดสแตนด์บายใหม่ตามที่อธิบายไว้ในการเลิกใช้งานโหนด Postgres

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

  11. รีสตาร์ทคอมโพเนนต์ Edge UI ในเครื่อง 1 และ 7 โดยทำดังนี้
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

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

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

  1. ZooKeeper
  2. Cassandra
  3. qpidd, ps
  4. LDAP
  5. Edge ซึ่งหมายถึงโปรไฟล์ "-c edge" ในโหนดทั้งหมดตามลำดับ ซึ่งได้แก่ โหนดที่มีเซิร์ฟเวอร์ Qpid, Edge Postgres Server, เซิร์ฟเวอร์การจัดการ, ผู้ประมวลผลข้อมูลข้อความ และเราเตอร์
  6. UI ของ Edge
  7. SSO ของ Edge

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