อัปเดต Apigee Edge 4.51.00 หรือ 4.52.00 หรือ 4.52.01 เป็น 4.52.02

Apigee รองรับการอัปเกรด Edge สำหรับ Private Cloud จากเวอร์ชัน 4.51.00, 4.52.00 หรือ 4.52.01 เป็นเวอร์ชัน 4.52.02 โดยตรง หน้านี้จะอธิบายวิธีอัปเกรดดังกล่าว

ผู้ที่จะอัปเดตได้

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

หลังจากติดตั้ง RPM ของ Edge แล้ว ทุกคนจะกำหนดค่า RPM ได้

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

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

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

ตรวจสอบว่าคุณมีคุณสมบัติตามข้อกําหนดเบื้องต้นต่อไปนี้ก่อนอัปเกรด Apigee Edge

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

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

  • ตรวจสอบว่า Edge ทำงานอยู่
    ตรวจสอบว่า Edge ทำงานอยู่ในระหว่างกระบวนการอัปเดตโดยใช้คำสั่งต่อไปนี้ 
    /opt/apigee/apigee-service/bin/apigee-all status
  • ตรวจสอบว่ากลยุทธ์การบีบอัดข้อมูลของ Cassandra เป็น LeveledCompactionStrategy
    ทําการเปลี่ยนแปลงที่จําเป็นกับกลยุทธ์การบีบอัดข้อมูลของ Cassandra โดยขึ้นอยู่กับเวอร์ชันปัจจุบัน ทำตามขั้นตอนด้านล่าง แล้วกลับไปที่ขั้นตอนการอัปเกรดหลัก

ขั้นตอนพิเศษที่ควรพิจารณาสำหรับการอัปเกรด

หากต้องการอัปเกรดเป็น Edge for Private Cloud 4.52.02 ให้ลองทำตามขั้นตอนเฉพาะสำหรับการอัปเกรดซอฟต์แวร์บางรายการ ขั้นตอนที่จำเป็นจะขึ้นอยู่กับเวอร์ชันปัจจุบันของคุณ โปรดดูตารางด้านล่างสำหรับซอฟต์แวร์ต่างๆ ที่ต้องดำเนินการเพิ่มเติม และทําตามวิธีการโดยละเอียดของแต่ละรายการ หลังจากทํางานที่จำเป็นเสร็จแล้ว ให้กลับไปที่ขั้นตอนการอัปเกรดหลักเพื่อดําเนินการอัปเกรดต่อ

เวอร์ชันปัจจุบัน ซอฟต์แวร์ที่ต้องดำเนินการตามขั้นตอนพิเศษเพื่ออัปเกรดเป็น 4.52.02 ข้อมูลอ้างอิง
4.52.01 Cassandra เปลี่ยนกลยุทธ์การบีบอัด Cassandra
4.52.00 Cassandra, Zookeeper, Qpid เปลี่ยนกลยุทธ์การบีบอัด Cassandra
4.51.00 Cassandra, Zookeeper, Qpid, Postgres เปลี่ยนกลยุทธ์การบีบอัด Cassandra

หลังจากทำตามขั้นตอนที่จำเป็นตามเวอร์ชันแล้ว ให้กลับไปที่ขั้นตอนการอัปเกรดหลักเพื่อดำเนินการต่อ

การนำไปใช้งานการตั้งค่าที่พักโดยอัตโนมัติ

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

ต้องอัปเกรดเป็น Cassandra 3.11.16

Apigee Edge สําหรับ Private Cloud 4.52.02 มีการอัปเกรด Cassandra เป็นเวอร์ชัน 3.11.16 Cassandra เป็นคอมโพเนนต์สําคัญของ Apigee และการอัปเกรดนี้ยังรวมถึงการอัปเดตซอฟต์แวร์ไดรเวอร์ในรันไทม์และคอมโพเนนต์การจัดการต่างๆ ที่ใช้ในการค้นหาและเขียนลงใน Cassandra ด้วย

เนื่องจากเป็นการอัปเกรดครั้งใหญ่ จึงจำเป็นต้องทำการเปลี่ยนแปลงบางอย่างในโมเดลข้อมูลของ Apigee ใน Cassandra เพื่อให้ได้ประสิทธิภาพที่ดีที่สุดในเวอร์ชันใหม่ แม้ว่าการเปลี่ยนแปลงเหล่านี้จะน้อยมาก แต่กระบวนการอัปเกรดจะรบกวน API การจัดการบางอย่าง ซึ่งส่งผลต่อทั้ง UI ของ Apigee และพอร์ทัลนักพัฒนาแอป เอกสารด้านล่างจะระบุ API ที่ใช้งานไม่ได้อย่างเจาะจง รวมถึงขั้นตอนต่างๆ ในระหว่างการอัปเกรดเมื่อการหยุดชะงักเริ่มต้นและสิ้นสุด ที่สำคัญคือ การเข้าชมรันไทม์จะไม่หยุดชะงักในระหว่างการอัปเกรด

การย้อนกลับระดับสูง

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

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

โปรดดูรายละเอียดเพิ่มเติมที่ส่วนเปลี่ยนกลับการอัปเดต Cassandra 3.11.16

การจัดทำเอกสารประกอบ API ในพอร์ทัลสําหรับนักพัฒนาแอป

พอร์ทัลนักพัฒนาซอฟต์แวร์ Drupal ของ Apigee มีฟีเจอร์ต่างๆ สำหรับการเขียนเอกสารประกอบ API แม้ว่าเราจะแนะนำให้เลิกใช้พอร์ทัลนักพัฒนาซอฟต์แวร์ที่ใช้ Drupal 7 แต่หากคุณยังคงใช้พอร์ทัลดังกล่าวและใช้ประโยชน์จากฟีเจอร์ SmartDocs เอกสาร การใช้ SmartDocs API จะมีผลกับคุณ หากคุณใช้พอร์ทัลนักพัฒนาซอฟต์แวร์เวอร์ชันใหม่ การอัปเกรดนี้จะไม่ส่งผลต่อเอกสารประกอบ API ของคุณ

เมื่อคุณอัปเกรด Apigee เป็นเวอร์ชัน 4.52.02 ระบบจะไม่ย้ายข้อมูลโมเดล API ที่สร้างขึ้นโดยใช้ฟีเจอร์ SmartDocs ของพอร์ทัลนักพัฒนาซอฟต์แวร์ Drupal 7 ไปยังเวอร์ชันใหม่โดยอัตโนมัติ คุณจะต้องส่งออกแต่ละรูปแบบด้วยตนเองโดยใช้พอร์ทัลนักพัฒนาแอปและนําเข้าอีกครั้งหลังจากการอัปเกรดเสร็จสมบูรณ์

คําศัพท์ที่ใช้ในส่วนต่อไปนี้

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

การจัดการ: การจัดการรวมถึงการดูแลระบบ Apigee Edge ซึ่งรวมถึงแต่ไม่จํากัดเพียงการติดตั้งใช้งาน การแก้ไขแอป ผลิตภัณฑ์ เซิร์ฟเวอร์เป้าหมาย คีย์สโตร์ ฯลฯ API การจัดการทั้งหมด (และไคลเอ็นต์ เช่น UI ของ Apigee และพอร์ทัลนักพัฒนาแอป) จะรวมอยู่ในขอบเขตนี้

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

ขั้นตอนที่ 0: สถานะเริ่มต้น

  1. Cassandra ใน Apigee ที่ใช้เวอร์ชัน 2.1.22
  2. คอมโพเนนต์ของ Edge for Private Cloud 4.52.02
    • เซิร์ฟเวอร์การจัดการที่สื่อสารกับ Cassandra ผ่านโปรโตคอล Thrift เวอร์ชันเก่า
    • เซิร์ฟเวอร์รันไทม์ (โปรแกรมประมวลผลข้อความและเราเตอร์) ที่สื่อสารกับ Cassandra ผ่านโปรโตคอล Thrift เวอร์ชันเก่า
สถานะรันไทม์ในขั้นตอนนี้ สถานะการจัดการในขั้นตอนนี้
รันไทม์ทํางานได้เต็มรูปแบบ การจัดการทํางานได้เต็มรูปแบบ

ขั้นตอนที่ 1: เตรียมพร้อมสำหรับการอัปเกรด

ขั้นตอนด้านล่างนี้นอกเหนือจากไฟล์มาตรฐานที่คุณสร้างโดยทั่วไป เช่น ไฟล์การกําหนดค่ามาตรฐานของ Apigee เพื่อเปิดใช้การอัปเกรดคอมโพเนนต์

  1. เปลี่ยน Cassandra ให้ใช้ LeveledCompactionStrategy
  2. สำรองข้อมูล Cassandra โดยใช้ Apigee
  3. ถ่ายภาพหน้าจอ VM ของโหนด Cassandra (หากเป็นไปได้)
  4. สร้างไฟล์การกําหนดค่าการอัปเกรด Cassandra ในโหนด Cassandra แต่ละโหนดที่ /opt/apigee/apigee-cassandra/cass_upgrade.conf โดยมีเนื้อหาดังต่อไปนี้ 
    # IP Address of node
HOSTIP=10.0.0.1

# Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_USERNAME=<cassuser>

# Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_PASSWORD=<casspass>

# Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
CASS_PORT=9160

# Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
CASS_CQL_PORT=9042

# Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
# Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
CASS_TMP_DIR=/tmp/cass_upgrade_scripts
    หากสร้างไฟล์ที่ /opt/apigee/apigee-cassandra/cass_upgrade.conf ไม่ได้ ให้สร้างไฟล์ /opt/silent.conf ที่มีเนื้อหาเดียวกันในโหนด Cassandra แต่ละโหนด
  • หากคุณใช้ฟีเจอร์ SmartDocs ของพอร์ทัลนักพัฒนาแอป Apigee Drupal 7 ให้ส่งออกโมเดลแต่ละรายการโดยดาวน์โหลดในรูปแบบ JSON จาก UI ของพอร์ทัลนักพัฒนาแอป คุณจะต้องนำเข้าโมเดลเหล่านี้กลับไปยัง Apigee หลังจากที่อัปเดตเซิร์ฟเวอร์การจัดการแล้ว
  • ตรวจสอบว่าพอร์ต 9160 และ 9042 เข้าถึงได้จากคอมโพเนนต์ Edge for Private Cloud 4.52.02 ทั้งหมดไปยังโหนด Cassandra หากยังไม่มี ดูข้อมูลเพิ่มเติมได้ที่ข้อกำหนดเกี่ยวกับพอร์ต

ขั้นตอนที่ 2: อัปเกรดโหนด Cassandra ทั้งหมด

  1. อัปเกรดโหนด Cassandra ทั้งหมดในทุกภูมิภาคทีละโหนด เรียกใช้คําสั่งต่อไปนี้ในแต่ละโหนด 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. เมื่ออัปเดตโหนดแล้ว ให้เรียกใช้คําสั่งต่อไปนี้ในโหนดเพื่อเรียกใช้การตรวจสอบบางอย่างก่อนดำเนินการต่อ 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
  3. คำสั่งข้างต้นจะแสดงผลลัพธ์ประมาณดังนี้ 
    Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
สถานะรันไทม์ในขั้นตอนนี้ สถานะการจัดการในขั้นตอนนี้
รันไทม์ทํางานได้เต็มรูปแบบ ฟังก์ชันการจัดการต่อไปนี้จะมีประสิทธิภาพลดลงหลังจากอัปเกรด Cassandra

ขั้นตอนที่ 3: อัปเกรดโหนดการจัดการทั้งหมด

อัปเกรดโหนดการจัดการทั้งหมดในทุกภูมิภาคทีละโหนด ดังนี้

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
สถานะรันไทม์ สถานะการจัดการ
รันไทม์ทํางานได้เต็มรูปแบบ Management API ทำงานได้น้อยลงในกรณีต่อไปนี้

ขั้นตอนที่ 3ก: [ไม่บังคับ] นําเข้า SmartDocs ที่ส่งออกก่อนหน้านี้

เมื่ออัปเกรดเซิร์ฟเวอร์การจัดการทั้งหมดแล้ว คุณจะนําเข้าโมเดล SmartDocs ที่ส่งออกในขั้นตอนที่ 1 ได้ หรือจะดำเนินการในภายหลังก็ได้

สถานะรันไทม์ สถานะการจัดการ
รันไทม์ทํางานได้เต็มรูปแบบ การจัดการทํางานได้เต็มรูปแบบ

ขั้นตอนที่ 4: อัปเกรดโหนดรันไทม์ทั้งหมด

อัปเกรดเราเตอร์และโหนดโปรแกรมประมวลผลข้อความทั้งหมดในทุกภูมิภาคทีละรายการ ดังนี้

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
สถานะรันไทม์ สถานะการจัดการ
รันไทม์ทํางานได้เต็มรูปแบบ การจัดการทํางานได้เต็มรูปแบบ

ขั้นตอนที่ 5: อัปเกรดคอมโพเนนต์ Edge for Private Cloud 4.52.02 ที่เหลือทั้งหมด

อัปเกรดโหนด edge-qpid-server และ edge-postgres-server ที่เหลือทั้งหมดในทุกภูมิภาคทีละโหนด

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

สถานะรันไทม์ สถานะการจัดการ
รันไทม์ทํางานได้เต็มรูปแบบ การจัดการทํางานได้เต็มรูปแบบ

ขั้นตอนที่ 6: ขั้นตอนหลังการอัปเกรด

เรียกใช้คําสั่งต่อไปนี้บนโหนด Cassandra แต่ละโหนดทีละรายการหลังจากการอัปเกรดเสร็จสมบูรณ์

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

เรียกใช้คําสั่งต่อไปนี้เพื่อลบตารางเก่าที่ไม่ได้ใช้ออกจากคลัสเตอร์ Cassandra จนกว่าระบบจะเรียกใช้ คุณจะไม่สามารถใช้งานฟีเจอร์บางอย่างของ Cassandra (เช่น การตั้งค่าการตรวจสอบสิทธิ์ใหม่ - กลไกการตรวจสอบสิทธิ์แบบเก่าจะยังคงทำงานต่อไป) คำสั่งนี้จะทำงานได้ในโหนดเพียง 1 โหนดในคลัสเตอร์เท่านั้น

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

ทําตามขั้นตอนที่ 3ก หากยังไม่ได้ทํา

สถานะรันไทม์ สถานะการจัดการ
รันไทม์ทํางานได้เต็มรูปแบบ การจัดการทํางานได้เต็มรูปแบบ

ต้องอัปเกรดเป็น Zookeeper 3.8.3

แม้ว่า Edge for Private Cloud 4.52.02 จะไม่รวมการอัปเกรด Zookeeper ไว้ด้วย แต่หากคุณอัปเกรดจากเวอร์ชันที่เก่ากว่า 4.52.01 คุณต้องทำตามขั้นตอนเพื่ออัปเกรด Zookeeper

  • หากจะอัปเกรดจาก Edge for Private Cloud เวอร์ชัน 4.51.00 หรือ 4.52.00 โปรดดูขั้นตอนในการอัปเกรดเป็น Zookeeper 3.8.3 ที่จำเป็นเพื่ออัปเกรด Zookeeper
  • หากจะอัปเกรดจาก Edge for Private Cloud เวอร์ชัน 4.52.01 คุณควรใช้ Zookeeper เวอร์ชัน 3.8.3 อยู่แล้ว และไม่จำเป็นต้องทำตามขั้นตอนพิเศษใดๆ ในการอัปเกรด Zookeeper

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

  • หากจะอัปเกรดจาก Edge for Private Cloud 4.51.00 เป็น 4.52.02 คุณต้องทําตามขั้นตอนเพื่ออัปเกรด Postgres แม้ว่า Edge for Private Cloud 4.52.02 จะไม่รวมการอัปเกรด Postgres ก็ตาม การอัปเกรดจาก Edge for Private Cloud 4.51.00 เป็น 4.52.02 ต้องใช้ขั้นตอนการอัปเกรด Postgres เพิ่มเติม โปรดดูส่วนการอัปเกรดเป็น Postgres 14 ที่จำเป็น
  • หากจะอัปเกรดจาก Edge for Private Cloud 4.52.00 หรือ 4.52.01 เป็น 4.52.02 คุณไม่จําเป็นต้องทําตามขั้นตอนการอัปเกรด Postgres เพิ่มเติม

ต้องอัปเกรดเป็น Qpid J-Broker

แม้ว่า Edge for Private Cloud 4.52.02 จะไม่รวมการอัปเกรด QPID ไว้ด้วย แต่หากคุณอัปเกรดจากเวอร์ชันที่เก่ากว่า 4.52.01 คุณต้องทําตามขั้นตอนเพื่ออัปเกรด QPID

  • หากจะอัปเกรดจาก Edge for Private Cloud 4.51.00 หรือ 4.52.00 เป็น 4.52.02 คุณต้องทำตามขั้นตอนเพิ่มเติมในการอัปเกรด QPID โปรดดูส่วนอัปเกรด Qpid หากคุณจะอัปเกรดจากเวอร์ชัน 4.51.00 หรือ 4.52.00 เป็น 4.52.02
  • หากคุณจะอัปเกรดจาก Edge for Private Cloud 4.52.01 เป็น 4.52.02 คุณควรใช้ Qpid Broker เวอร์ชันล่าสุดอยู่แล้ว และไม่จำเป็นต้องทำตามขั้นตอนการอัปเกรด QPID เพิ่มเติม

UI ของ Edge เวอร์ชันใหม่

ส่วนนี้จะแสดงข้อควรพิจารณาเกี่ยวกับ UI ของ Edge ดูข้อมูลเพิ่มเติมได้ที่UI ใหม่ของ Edge สำหรับระบบคลาวด์ส่วนตัว

ติดตั้ง UI ของ Edge

หลังจากการติดตั้งครั้งแรกเสร็จสมบูรณ์แล้ว Apigee ขอแนะนำให้คุณติดตั้ง Edge UI ซึ่งเป็นอินเทอร์เฟซผู้ใช้ที่ปรับปรุงแล้วสำหรับนักพัฒนาซอฟต์แวร์และผู้ดูแลระบบของ Apigee Edge สําหรับระบบคลาวด์ส่วนตัว

โปรดทราบว่า UI ของ Edge กำหนดให้คุณปิดใช้การตรวจสอบสิทธิ์พื้นฐานและใช้ IDP เช่น SAML หรือ LDAP

ดูข้อมูลเพิ่มเติมได้ที่ติดตั้ง UI ใหม่ของ Edge

อัปเดต UI ของ Edge

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

อัปเดตด้วย mTLS ของ Apigee

หากต้องการอัปเดต Apigee mTLS ให้ทําตามขั้นตอนต่อไปนี้

การย้อนกลับการอัปเดต

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

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

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

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

โปรดดำเนินการต่อไปนี้ก่อนและหลังการอัปเดต

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

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

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

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

  1. หากมี ให้ปิดใช้งานงาน cron ที่กําหนดค่าให้ดําเนินการซ่อมใน Cassandra จนกว่าการอัปเดตจะเสร็จสมบูรณ์
  2. เข้าสู่ระบบโหนดในฐานะรูทเพื่อติดตั้ง 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. หากติดตั้งใน Oracle 7.x ให้เรียกใช้คำสั่งต่อไปนี้ 
    sudo yum-config-manager --enable ol7_optional_latest
  6. หากติดตั้งใน 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

  7. หากคุณใช้ Edge 4.51.00 อยู่ ให้ทำดังนี้

    1. ดาวน์โหลดไฟล์ bootstrap_4.52.02.sh ของ Edge ไปยัง /tmp/bootstrap_4.52.02.sh 
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
    2. ติดตั้งยูทิลิตีและไลบรารีที่ใช้ร่วมกันของ Edge 4.52.02 apigee-service โดยดำเนินการตามคำสั่งต่อไปนี้ 
      sudo bash /tmp/bootstrap_4.52.02.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 ด้วยตนเอง
    3. ใช้ apigee-service เพื่ออัปเดตยูทิลิตี apigee-setup ดังตัวอย่างต่อไปนี้ 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    4. อัปเดตยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการ ดังที่แสดงในตัวอย่างต่อไปนี้ 
      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    5. อัปเดตยูทิลิตี apigee-provision ในเซิร์ฟเวอร์การจัดการ ดังที่แสดงในตัวอย่างต่อไปนี้ 
      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
    6. เรียกใช้ยูทิลิตี update ในโหนดโดยเรียกใช้คำสั่งต่อไปนี้ 
      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

      โดยทําตามลําดับที่อธิบายไว้ในลําดับการอัปเดตเครื่อง

      สถานที่:

      • component คือคอมโพเนนต์ Edge ที่จะอัปเดต ค่าที่เป็นไปได้ ได้แก่
        • cs: Cassandra
        • edge: คอมโพเนนต์ Edge ทั้งหมดยกเว้น UI ของ Edge: เซิร์ฟเวอร์การจัดการ, โปรแกรมประมวลผลข้อความ, เราเตอร์, เซิร์ฟเวอร์ QPID, เซิร์ฟเวอร์ Postgres
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: Apigee SSO (หากคุณติดตั้ง SSO)
        • ue: UI ของ Edge เวอร์ชันใหม่
        • ui: UI ของ Edge แบบคลาสสิก
        • zk: Zookeeper
      • configFile คือไฟล์การกําหนดค่าเดียวกับที่คุณใช้กําหนดคอมโพเนนต์ Edge ในระหว่างการติดตั้ง 4.50.00 หรือ 4.51.00

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

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

หากในภายหลังคุณตัดสินใจที่จะเปลี่ยนกลับการอัปเดต ให้ทำตามขั้นตอนที่อธิบายไว้ในหัวข้อเปลี่ยนกลับเป็น 4.52.02

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

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

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

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

วิธีอัปเดตจากที่เก็บข้อมูล 4.52.02 ในพื้นที่

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

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

    4. ติดตั้งยูทิลิตี apigee-service ของ Edge และไลบรารีที่เกี่ยวข้องจาก /tmp/repos ดังนี้ 
      sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      โปรดทราบว่าคุณใส่เส้นทางไปยังไดเรกทอรี repos ในคําสั่งนี้

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

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

    3. ในโหนดระยะไกล ให้ติดตั้งยูทิลิตี apigee-setup ของ Edge และข้อกำหนดต่อไปนี้ 
      sudo bash /tmp/bootstrap_4.52.02.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. เรียกใช้ยูทิลิตี update ในโหนดตามลำดับที่อธิบายไว้ในลำดับการอัปเดตเครื่อง ดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    สถานที่:

    • component คือคอมโพเนนต์ Edge ที่จะอัปเดต โดยทั่วไปแล้ว คุณจะต้องอัปเดตคอมโพเนนต์ต่อไปนี้
      • cs: Cassandra
      • edge: คอมโพเนนต์ Edge ทั้งหมดยกเว้น UI ของ Edge: เซิร์ฟเวอร์การจัดการ เครื่องประมวลผลข้อความ รูทเตอร์ เซิร์ฟเวอร์ QPID เซิร์ฟเวอร์ Postgres
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: Apigee SSO (หากคุณติดตั้ง SSO)
      • ue UI ของ Edge ใหม่
      • ui: UI ของ Edge แบบคลาสสิก
      • zk: Zookeeper
    • configFile คือไฟล์การกําหนดค่าเดียวกับที่คุณใช้กําหนดคอมโพเนนต์ Edge ในระหว่างการติดตั้ง 4.50.00 หรือ 4.51.00

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

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

หากในภายหลังคุณตัดสินใจที่จะเปลี่ยนกลับการอัปเดต ให้ทำตามขั้นตอนที่อธิบายไว้ในหัวข้อเปลี่ยนกลับเป็น 4.52.02

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

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

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

การอัปเกรดแบบสแตนด์อโลน 1 โหนด

วิธีอัปเกรดการกำหนดค่าแบบสแตนด์อโลน 1 โ nod เป็น 4.52.02

  1. อัปเดตคอมโพเนนต์ทั้งหมดโดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (หากคุณติดตั้ง apigee-adminapi) อัปเดตยูทิลิตี apigee-adminapi โดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

การอัปเกรดแบบสแตนด์อโลน 2 โหนด

อัปเดตคอมโพเนนต์ต่อไปนี้สําหรับการติดตั้งแบบสแตนด์อโลน 2 โหนด

ดูรายการโทโพโลยี Edge และจำนวนโหนดได้ที่โทโพโลยีการติดตั้ง

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

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

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

การอัปเกรด 5 โหนด

อัปเดตคอมโพเนนต์ต่อไปนี้สําหรับการติดตั้ง 5 โ nod

ดูรายการโทโพโลยี Edge และจำนวนโหนดได้ที่โทโพโลยีการติดตั้ง

  1. อัปเดต Cassandra และ ZooKeeper ในเครื่องที่ 1, 2 และ 3 โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. อัปเดต Postgres ในเครื่องที่ 4 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. อัปเดต Postgres ในเครื่อง 5 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. อัปเดต LDAP ในเครื่องที่ 1 โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 4, 5, 1, 2, 3 โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. อัปเดต Qpid ในเครื่องที่ 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. อัปเดต Qpid ในเครื่องที่ 5 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. อัปเดต UI ของ Edge โดยทำดังนี้
    • UI แบบคลาสสิก: หากคุณใช้ UI แบบคลาสสิก ให้อัปเดตคอมโพเนนต์ ui ในเครื่อง 1 ดังที่แสดงในตัวอย่างต่อไปนี้ 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • UI ของ Edge ใหม่: หากคุณติดตั้ง UI ของ Edge ใหม่ ให้อัปเดตคอมโพเนนต์ ue ในเครื่องที่เหมาะสม (อาจไม่ใช่เครื่องที่ 1) ดังนี้ 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  9. (หากคุณติดตั้ง apigee-adminapi) อัปเดตยูทิลิตี apigee-adminapi ในเครื่องที่ 1 ดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (หากคุณติดตั้ง Apigee SSO) อัปเดต Apigee SSO ในเครื่องที่ 1 โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  11. รีสตาร์ทคอมโพเนนต์ UI โดยทำดังนี้
    • UI แบบคลาสสิก: หากคุณใช้ UI แบบคลาสสิก ให้รีสตาร์ทคอมโพเนนต์ edge-ui ในเครื่อง 1 ดังที่แสดงในตัวอย่างต่อไปนี้ 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • UI ของ Edge ใหม่: หากคุณติดตั้ง UI ของ Edge ใหม่ ให้รีสตาร์ทคอมโพเนนต์ edge-management-ui ในเครื่องที่เหมาะสม (อาจไม่ใช่เครื่องที่ 1) โดยทำดังนี้ 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

อัปเดตคอมโพเนนต์ต่อไปนี้สําหรับการติดตั้งคลัสเตอร์ 9 นอต

ดูรายการโทโพโลยี Edge และจำนวนโหนดได้ที่โทโพโลยีการติดตั้ง

  1. อัปเดต Cassandra และ ZooKeeper ในเครื่องที่ 1, 2 และ 3 โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. อัปเดต Postgres ในเครื่อง 8 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. อัปเดต Postgres ในเครื่อง 9 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. อัปเดต LDAP ในเครื่องที่ 1 โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 6, 7, 8, 9, 1, 4 และ 5 ตามลำดับ ดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. อัปเดต Qpid ในเครื่อง 6 และ 7 โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. อัปเดต UI ใหม่ (ue) หรือ UI แบบคลาสสิก (ui) ในเครื่องที่ 1 โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (หากคุณติดตั้ง apigee-adminapi) อัปเดตยูทิลิตี apigee-adminapi ในเครื่องที่ 1 โดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (หากคุณติดตั้ง Apigee SSO) อัปเดต Apigee SSO ในเครื่องที่ 1 โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  10. รีสตาร์ทคอมโพเนนต์ UI โดยทำดังนี้
    • UI แบบคลาสสิก: หากคุณใช้ UI แบบคลาสสิก ให้รีสตาร์ทคอมโพเนนต์ edge-ui ในเครื่อง 1 ดังที่แสดงในตัวอย่างต่อไปนี้ 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • UI ของ Edge ใหม่: หากคุณติดตั้ง UI ของ Edge ใหม่ ให้รีสตาร์ทคอมโพเนนต์ edge-management-ui ในเครื่องที่เหมาะสม (อาจไม่ใช่เครื่องที่ 1) โดยทำดังนี้ 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

อัปเดตคอมโพเนนต์ต่อไปนี้สําหรับการติดตั้งคลัสเตอร์ 13 นอต

ดูรายการโทโพโลยี Edge และจำนวนโหนดได้ที่โทโพโลยีการติดตั้ง

  1. อัปเดต Cassandra และ ZooKeeper ในเครื่องที่ 1, 2 และ 3 โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. อัปเดต Postgres ในเครื่อง 8 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. อัปเดต Postgres ในเครื่อง 9 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. อัปเดต LDAP ในเครื่องที่ 4 และ 5 โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 12, 13, 8, 9, 6, 7, 10 และ 11 ตามลำดับ โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. อัปเดต Qpid ในเครื่อง 12 และ 13 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. อัปเดต UI ใหม่ (ue) หรือ UI แบบคลาสสิก (ui) ในเครื่องที่ 6 และ 7 โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (หากคุณติดตั้ง apigee-adminapi) อัปเดตยูทิลิตี apigee-adminapi ในเครื่องที่ 6 และ 7 โดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (หากคุณติดตั้ง Apigee SSO) อัปเดต Apigee SSO ในเครื่องที่ 6 และ 7 โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  10. รีสตาร์ทคอมโพเนนต์ UI โดยทำดังนี้
    • UI แบบคลาสสิก: หากคุณใช้ UI แบบคลาสสิก ให้รีสตาร์ทคอมโพเนนต์ edge-ui ในเครื่อง 6 และ 7 ดังที่แสดงในตัวอย่างต่อไปนี้ 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • UI ของ Edge ใหม่: หากคุณติดตั้ง UI ของ Edge ใหม่ ให้รีสตาร์ทคอมโพเนนต์ edge-management-ui ในเครื่องที่ 6 และ 7 โดยทำดังนี้ 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

อัปเดตคอมโพเนนต์ต่อไปนี้สําหรับการติดตั้งคลัสเตอร์ 12 โหนด

ดูรายการโทโพโลยี Edge และจำนวนโหนดได้ที่โทโพโลยีการติดตั้ง

  1. อัปเดต Cassandra และ ZooKeeper โดยทำดังนี้
    1. ในเครื่อง 1, 2 และ 3 ในศูนย์ข้อมูล 1 ให้ทำดังนี้ 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. ในเครื่อง 7, 8 และ 9 ในศูนย์ข้อมูล 2 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. อัปเดต Postgres
    1. เครื่อง 6 ในศูนย์ข้อมูล 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. เครื่อง 12 ในศูนย์ข้อมูล 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. อัปเดต 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
  4. อัปเดตคอมโพเนนต์ 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
  5. อัปเดต qpidd
    1. เครื่อง 4, 5 ในศูนย์ข้อมูล 1
      1. อัปเดต qpidd ในเครื่อง 4 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. อัปเดต qpidd ในเครื่อง 5 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. เครื่อง 10, 11 ในศูนย์ข้อมูล 2
      1. อัปเดต qpidd ในเครื่อง 10 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. อัปเดต qpidd ในเครื่อง 11 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. อัปเดต UI ใหม่ (ue) หรือ UI แบบคลาสสิก (ui) โดยทำดังนี้
    1. เครื่อง 1 ในศูนย์ข้อมูล 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. เครื่อง 7 ในศูนย์ข้อมูล 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  7. (หากคุณติดตั้ง apigee-adminapi) อัปเดตยูทิลิตี apigee-adminapi โดยทำดังนี้
    1. เครื่อง 1 ในศูนย์ข้อมูล 1: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. เครื่อง 7 ในศูนย์ข้อมูล 2: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (หากคุณติดตั้ง Apigee SSO) อัปเดต Apigee 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

  9. รีสตาร์ทคอมโพเนนต์ UI ของ Edge ใหม่ (edge-management-ui) หรือ UI ของ Edge แบบคลาสสิก (edge-ui) ในเครื่องที่ 1 และ 7 โดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

สําหรับการกําหนดค่าที่ไม่ใช่มาตรฐาน

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

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

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