4.19.01.09 - Edge สำหรับบันทึกประจำรุ่นของ Private Cloud

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่ เอกสารประกอบของ Apigee X info

เมื่อวันที่ 29 ก. ย. 2020 เราได้เปิดตัว Apigee Edge for Private Cloud เวอร์ชันใหม่

ขั้นตอนการอัปเดต

การอัปเดตเวอร์ชันนี้จะอัปเดตคอมโพเนนต์ในรายการ RPM ต่อไปนี้:

  • edge-gateway-4.19.01-0.0.20095.noarch.rpm
  • edge-management-server-4.19.01-0.0.20095.noarch.rpm
  • edge-message-processor-4.19.01-0.0.20095.noarch.rpm
  • edge-postgres-server-4.19.01-0.0.20095.noarch.rpm
  • edge-qpid-server-4.19.01-0.0.20095.noarch.rpm
  • edge-router-4.19.01-0.0.20095.noarch.rpm
  • apigee-cassandra-2.1.16-0.0.2507.noarch.rpm
  • edge-management-ui-static-4.19.01-0.0.20017.noarch.rpm
  • apigee-setup-4.19.01-0.0.1123.noarch.rpm
  • apigee-mtls-consul-4.19.01-0.0.20129.noarch.rpm
  • apigee-mtls-4.19.01-0.0.20190.noarch.rpm

คุณสามารถตรวจสอบเวอร์ชัน RPM ที่ติดตั้งอยู่ในปัจจุบันเพื่อดูว่าต้องอัปเดตหรือไม่ โดยป้อนคำสั่งต่อไปนี้

apigee-all version

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

  1. ในโหนด Edge ทั้งหมด ให้ทำดังนี้

    1. ล้างข้อมูลที่เก็บ Yum 
      sudo yum clean all
    2. ดาวน์โหลดไฟล์ bootstrap_4.19.01.sh ของ Edge 4.19.01 เวอร์ชันล่าสุดไปที่ /tmp/bootstrap_4.19.01.sh 
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
    3. ติดตั้งยูทิลิตี apigee-service และการอ้างอิงของ Edge 4.19.01 
      sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

      โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณได้รับจาก Apigee หากไม่ระบุ pWord ระบบจะแจ้งให้คุณป้อน

    4. อัปเดตยูทิลิตี apigee-setup 
      sudo /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    5. ใช้คำสั่ง source เพื่อเรียกใช้สคริปต์ apigee-service.sh 
      source /etc/profile.d/apigee-service.sh

  2. อัปเดตโหนด Cassandra ทั้งหมด

    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

    โดยที่ configFile จะระบุไฟล์การกำหนดค่าที่คุณใช้ติดตั้ง Apigee Edge for Private Cloud เช่น /opt/silent.conf

  3. ในโหนด Edge ทั้งหมด ให้เรียกใช้สคริปต์ update.sh สำหรับกระบวนการ edge โดยเรียกใช้คำสั่งต่อไปนี้ในแต่ละโหนด 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. หากคุณใช้ประสบการณ์การใช้งาน Edge แบบใหม่ ให้เรียกใช้คำสั่งต่อไปนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
  5. (Apigee mTLS เท่านั้น) หากต้องการอัปเดต Apigee mTLS: ทำตามขั้นตอนที่อธิบายไว้ใน อัปเกรด Apigee mTLS

    ดูข้อมูลเพิ่มเติมได้ที่หัวข้อ Introduction to Apigee mTLS

ซอฟต์แวร์ที่รองรับ

ไม่มีการเปลี่ยนแปลง

การเลิกใช้งานและการเลิกให้บริการ

ไม่มีการเลิกใช้งานหรือเลิกให้บริการใหม่

ฟีเจอร์ใหม่

ส่วนนี้แสดงรายการฟีเจอร์ใหม่ในเวอร์ชันนี้

การเข้ารหัสรหัสผ่าน JMX

ตอนนี้คุณเข้ารหัสรหัสผ่าน JMX ได้แล้ว ดูรายละเอียดได้ที่หัวข้อ Enabling JMX password encryption และ Enabling JMX authentication for Cassandra (150633039)

ข้อบกพร่องที่ได้รับการแก้ไข

ตารางต่อไปนี้แสดงรายการข้อบกพร่องที่ได้รับการแก้ไขในเวอร์ชันนี้

รหัสปัญหา คำอธิบาย
159360654

ใบรับรอง apigee-mtls มีอายุเพียง 30 วัน

ตอนนี้ใบรับรองใหม่มีอายุ 1 ปีแล้ว หากต้องการอัปเกรดใบรับรองเก่าที่มีอายุ 30 วันด้วยใบรับรองใหม่ ที่มีอายุ 1 ปี โปรดดูหัวข้อ อัปเกรด Apigee MTLS
160890634

เมื่อรีสตาร์ท Message Processor ระบบไม่ได้ติดตั้งใช้งานพร็อกซีบางรายการ
130416715

อาจเกิดช่องโหว่เนื่องจากส่วนหัว "True-Client-IP"

เวอร์ชันนี้ได้เพิ่มองค์ประกอบนโยบายการควบคุมการเข้าถึงใหม่ IgnoreTrueClientIPHeader ซึ่งจะช่วยแก้ไขปัญหานี้ ดูหัวข้อ องค์ประกอบ IgnoreTrueClientIPHeader
132654321

บันทึกการตรวจสอบไม่แสดงผู้ใช้ที่มีการอัปเดตบทบาท

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

การติดตั้ง mTLS ไม่สำเร็จเนื่องจาก Consul Binary เวอร์ชันเก่า

Consul Binary ได้รับการอัปเกรดจาก v1.6.2 เป็นเวอร์ชันเสถียรล่าสุด v1.8.0
160916451

การติดตั้ง mTLS ไม่สำเร็จเนื่องจากไม่มีรายการสำหรับช่อง bindaddr ของ Consul

ตอนนี้ apigee-mtls จัดการเซิร์ฟเวอร์ที่มีอินเทอร์เฟซและ ที่อยู่เครือข่ายหลายรายการได้อย่างถูกต้องแล้ว
133145969

ไม่มีเอกสารประกอบสำหรับการปิดใช้โปรโตคอลใน UI

ดูเอกสารประกอบใหม่ได้ที่หัวข้อ Disabling TLS protocols.

ปัญหาที่ทราบ

ตารางต่อไปนี้แสดงรายการปัญหาที่ทราบในเวอร์ชันนี้

รหัสปัญหา คำอธิบาย
149245401

ปัญหาการจัดกลุ่มการเชื่อมต่อของนโยบาย LDAP

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

วิธีแก้ปัญหาเฉพาะหน้า:

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

  1. สร้างไฟล์พร็อพเพอร์ตี้การกำหนดค่า หากยังไม่มี 
    /opt/apigee/customer/application/message-processor.properties
  2. เพิ่มข้อมูลต่อไปนี้ลงในไฟล์ (แทนที่ค่าของ พร็อพเพอร์ตี้ Java Naming and Directory Interface (JNDI) ตามข้อกำหนดการกำหนดค่าทรัพยากร LDAP) 
    bin_setenv_ext_jvm_opts="-Dcom.sun.jndi.ldap.connect.pool.maxsize=20
-Dcom.sun.jndi.ldap.connect.pool.prefsize=2
-Dcom.sun.jndi.ldap.connect.pool.initsize=2
-Dcom.sun.jndi.ldap.connect.pool.timeout=120000
-Dcom.sun.jndi.ldap.connect.pool.protocol=ssl"
  3. ตรวจสอบว่าไฟล์ /opt/apigee/customer/application/message-processor.properties เป็น ของ apigee:apigee
  4. รีสตาร์ท Message Processor แต่ละรายการ

หากต้องการยืนยันว่าพร็อพเพอร์ตี้ JNDI ของกลุ่มการเชื่อมต่อมีผล คุณสามารถ ใช้ tcpdump เพื่อสังเกตลักษณะการทำงานของกลุ่มการเชื่อมต่อ LDAP เมื่อเวลาผ่านไป