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

Edge for Private Cloud v4.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 โหนดที่กำหนดค่าสำหรับการจำลองแบบ Master-Standby ในระหว่างกระบวนการอัปเดต ขณะที่โหนด 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 Master ปัจจุบัน ให้แก้ไขไฟล์ /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 Master โดยทำดังนี้ 
    /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 ตามที่อธิบายไว้ในติดตั้งยูทิลิตี apigee-setup ของ Edge
    3. ดาวน์โหลดไฟล์ Edge bootstrap_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. ติดตั้งยูทิลิตี Edge apigee-service และทรัพยากร Dependency โดยทำดังนี้ 
      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 Master โดยทำดังนี้ 
    /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 ต่อไปนี้ในโหนดเซิร์ฟเวอร์การจัดการ 
    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. เมื่อถึงเวลาอัปเดตเราเตอร์ ให้เลือกเราเตอร์ 1 รายการและทำให้เข้าถึงไม่ได้ตามที่อธิบายไว้ในหัวข้อการเปิด/ปิดใช้ความสามารถในการเข้าถึงเซิร์ฟเวอร์ (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.0x

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

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

  1. หากคุณกำลังใช้การจำลองแบบ Master-Standby ของ 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 ตามที่อธิบายไว้ในติดตั้งยูทิลิตี apigee-setup ของ Edge
  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. ดาวน์โหลดไฟล์ Edge 4.18.05 bootstrap_4.18.05.sh ไปยัง /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 และทรัพยากร Dependency ดังนี้ 
    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" = Cassandra
    • "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" = Edge UI
    • "zk" = Zookeeper

    คุณสามารถเรียกใช้ update.sh กับคอมโพเนนต์ทั้งหมดได้โดยตั้งค่า component เป็น "all" แต่ต้องมีโปรไฟล์การติดตั้ง 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. หากคุณกำลังใช้การจำลองแบบ Master-Standby ของ Postgres ให้ติดตั้งโหนดสแตนด์บาย Postgres ใหม่ตามที่อธิบายไว้ในหัวข้อการติดตั้งโหนดสแตนด์บาย Postgres ใหม่

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

  2. สร้างที่เก็บ 4.18.05 ในเครื่องตามที่อธิบายไว้ใน "สร้างที่เก็บ Apigee ในเครื่อง" ที่หัวข้อติดตั้งยูทิลิตี apigee-setup ของ Edge
  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. ในโหนดใหม่ ให้แตกไฟล์ tar ไปยังไดเรกทอรี /tmp โดยทำดังนี้ 
      tar -xzf apigee-4.18.05tar.gz

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

    4. ติดตั้งยูทิลิตี apigee-service ของ Edge และทรัพยากร Dependency จาก /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.18.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/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. ในโหนดระยะไกล ให้ติดตั้งยูทิลิตี 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" = Cassandra
    • "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" = Edge UI
    • "zk" = Zookeeper

    คุณสามารถเรียกใช้ update.sh กับคอมโพเนนต์ทั้งหมดได้โดยตั้งค่า component เป็น "all" แต่ต้องมีโปรไฟล์การติดตั้ง 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 หลายรายการ (Management Server, Message Processor, Router, QPID Server แต่ไม่ใช่ Postgres Server) ให้ใช้ตัวเลือก "-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 Master เท่านั้น) โดยทำดังนี้ 
      /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 Master เท่านั้น) โดยทำดังนี้ 
      /-->
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 Master เท่านั้น) โดยทำดังนี้ 
      /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 ในศูนย์ข้อมูล 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. อัปเดต 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, 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 Master เท่านั้น) โดยทำดังนี้ 
      /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, Management Server, Message Processor และเราเตอร์
  6. Edge UI
  7. Edge SSO

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