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

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

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

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

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

  • edge-gateway-4.19.06-0.0.20094.noarch.rpm
  • edge-management-server-4.19.06-0.0.20094.noarch.rpm
  • edge-message-processor-4.19.06-0.0.20094.noarch.rpm
  • edge-postgres-server-4.19.06-0.0.20094.noarch.rpm
  • edge-qpid-server-4.19.06-0.0.20094.noarch.rpm
  • edge-router-4.19.06-0.0.20094.noarch.rpm
  • apigee-mtls-4.19.06-0.0.20189.noarch.rpm
  • apigee-mtls-consul-4.19.06-0.0.20128.noarch.rpm
  • apigee-cassandra-2.1.16-0.0.2508.noarch.rpm
  • edge-ui-4.19.06-0.0.20164.noarch.rpm
  • edge-management-ui-static-4.19.06-0.0.20018.noarch.rpm
  • apigee-sso-4.19.06-0.0.20080.noarch.rpm
  • apigee-setup-4.19.06-0.0.1122.noarch.rpm

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

apigee-all version

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

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

    1. ล้างข้อมูลที่เก็บ Yum
      sudo yum clean all
    2. ดาวน์โหลดไฟล์ Edge 4.19.06 bootstrap_4.19.06.sh ล่าสุดไปที่ /tmp/bootstrap_4.19.06.sh
      curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
    3. ติดตั้งยูทิลิตี apigee-service และทรัพยากร Dependency ของ Edge 4.19.06 โดยทำดังนี้
      sudo bash /tmp/bootstrap_4.19.06.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 สำหรับ Private Cloud เช่น /opt/silent.conf

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

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

    ดูข้อมูลเพิ่มเติมได้ที่ ข้อมูลเบื้องต้นเกี่ยวกับ Apigee mTLS

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

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

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

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

ฟีเจอร์ใหม่

ส่วนนี้แสดงฟีเจอร์ใหม่ในรุ่นนี้

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

ตอนนี้คุณเข้ารหัสรหัสผ่าน JMX ได้แล้ว ดูรายละเอียดได้ที่ การเปิดใช้การเข้ารหัสรหัสผ่าน JMX และ การเปิดใช้การตรวจสอบสิทธิ์ JMX สำหรับ Cassandra (150633039)

แก้ไขข้อบกพร่องแล้ว

ตารางต่อไปนี้แสดงข้อบกพร่องที่แก้ไขแล้วในรุ่นนี้

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

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

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

147736003

ไลบรารีที่ล้าสมัยใน enterprise.apigee.com ทำให้เกิดปัญหาด้านความปลอดภัย

อัปเดตคลังแล้ว

150594487

ชุดทรัพยากร Java ที่ระดับ org ทำให้ตัวประมวลผลข้อความโหลดองค์กรไม่สำเร็จ

149739904

การมาสก์ข้อมูล สำหรับส่วนหัว HTTP จะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

เราได้แก้ไขแล้ว โดยการมาสก์ข้อมูลจะไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่อีกต่อไป

130416715

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

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

161858295

ตัวแปรบางตัวที่ไม่มีการแสดงผลมีการสะกดผิด

ตัวแปรการติดตั้งแบบเงียบ SSO_JWT_SIGNING_KEY_FILEPATH ไม่ได้สะกดผิดอีกต่อไป

160951701

การติดตั้ง mTLS ไม่สำเร็จเนื่องจากปัญหาเกี่ยวกับเซิร์ฟเวอร์ Consul

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

132654321

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

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

160916451

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

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

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

161764596

apigee-tomcat ไม่ได้รับการอัปเดตเมื่อใช้การอัปเดตแพตช์

ปัญหานี้ได้รับการแก้ไขแล้ว

133145969

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

ดูเอกสารประกอบใหม่ได้ที่ การปิดใช้โปรโตคอล TLS

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

ตารางต่อไปนี้แสดงปัญหาที่ทราบในรุ่นนี้

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

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

การตั้งค่า Connection Pool ของ LDAP สำหรับ JNDI ที่กำหนดค่าผ่าน แหล่งข้อมูล LDAP จะไม่แสดง และค่าเริ่มต้นของ JNDI จะทำให้เกิดการเชื่อมต่อแบบใช้ครั้งเดียวทุกครั้ง ด้วยเหตุนี้ การเชื่อมต่อจึงเปิด และปิดทุกครั้งสำหรับการใช้งานครั้งเดียว ซึ่งทำให้เกิดการเชื่อมต่อจำนวนมาก ต่อชั่วโมงกับเซิร์ฟเวอร์ 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. รีสตาร์ทตัวประมวลผลข้อความแต่ละตัว

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