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

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

เมื่อวันที่ 29 ก. ย. 2020 เราได้เปิดตัว Apigee Edge for 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 และการอ้างอิงของ 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 for Private Cloud เช่น /opt/silent.conf

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

  4. อัปเดต Edge UI โดยใช้คำสั่งต่อไปนี้

    /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 ที่ระดับองค์กรทำให้ Message Processor โหลดองค์กรไม่สำเร็จ

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

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

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

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

  1. สร้างไฟล์พร็อพเพอร์ตี้การกำหนดค่า หากยังไม่มี 
    /opt/apigee/customer/application/message-processor.properties
  2. เพิ่มเนื้อหาต่อไปนี้ลงในไฟล์ (แทนที่ค่าพร็อพเพอร์ตี้ Java Naming and Directory Interface (JNDI) properties ตามข้อกำหนดการกำหนดค่าทรัพยากร 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 เมื่อเวลาผ่านไป