‫4.19.01.09 - یادداشت‌های انتشار Edge برای «ابر خصوصی»

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید. اطلاعات

در تاریخ ۲۹ سپتامبر ۲۰۲۰، نسخه جدیدی از 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. آخرین فایل Edge 4.19.01 bootstrap_4.19.01.sh را در /tmp/bootstrap_4.19.01.sh بارگیری کنید: 
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
    3. ابزار و وابستگی‌های Edge 4.19.01 apigee-service را نصب کنید: 
      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. برای اجرای دستورگان apigee-service.sh، از فرمان source استفاده کنید: 
      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 را دنبال کنید.

    برای اطلاعات بیشتر، مقدمه‌ای بر Apigee mTLS را ببینید.

نرم‌افزار پشتیبانی‌شده

بدون تغییر.

منسوخ شدن و بازنشستگی

هیچ منسوخ‌سازی یا بازنشستگی جدیدی وجود ندارد.

ویژگی‌های جدید

این بخش ویژگی‌های جدید این نسخه پخش را فهرست می‌کند.

درحال رمزگذاری گذرواژه‌های JMX

اکنون می‌توانید گذرواژه‌های JMX را رمزگذاری کنید. برای جزئیات بیشتر، فعال کردن رمزگذاری گذرواژه JMX و فعال کردن اصالت‌سنجی JMX برای Cassandra را ببینید. (150633039)

اشکالات رفع شد

جدول زیر اشکالات برطرف‌شده در این نسخه را فهرست می‌کند:

شناسه مشکل شرح
159360654

گواهینامه‌های apigee-mtls فقط ۳۰ روز اعتبار داشتند.

گواهینامه‌های جدید اکنون برای یک سال معتبر هستند. برای ارتقا دادن گواهینامه ۳۰ روزه قدیمی با گواهینامه جدید که یک سال اعتبار دارد، ارتقا دادن Apigee MTLS را ببینید.
160890634

وقتی پردازشگرهای پیام بازراه‌اندازی شدند، برخی‌از پراکسی‌ها مستقر نشدند.
130416715

آسیب‌پذیری احتمالی به‌دلیل سرایند «True-Client-IP»

این نسخهٔ پخش عنصر جدیدی به نام «خط‌مشی کنترل دسترسی» IgnoreTrueClientIPHeader را معرفی می‌کند که این مشکل را برطرف می‌کند. عنصر IgnoreTrueClientIPHeader را ببینید.
132654321

گزارش‌های ممیزی کاربرانی را که نقش‌هایشان به‌روز شده بود نشان نمی‌داد.

پس‌از انجام تغییرات نقش برای کاربران موجود یا افزودن کاربر موجود به سازمان، گزارش ممیزی «کاربر نامشخص به‌روزرسانی شد» را نشان می‌داد که مانع از دیدن اینکه کنش روی چه کسی انجام شده است می‌شد.
160951701

نصب mTLS به‌دلیل قدیمی بودن نسخه باینری Consul انجام نمی‌شد.

باینری Consul از نسخه ۱.۶.۲ به جدیدترین نسخه پایدار، نسخه ۱.۸.۰، ارتقا یافت.
160916451

نصب mTLS به‌دلیل وجود نداشتن ورودی برای فیلد Consul bindaddr انجام نشد.

‫apigee-mtls اکنون سرورهای دارای چندین رابط شبکه و نشانی را به‌درستی مدیریت می‌کند.
133145969

مستندات غیرفعال کردن پروتکل‌ها در واسط کاربر وجود نداشت

برای مستندات جدید، غیرفعال کردن پروتکل‌های «امنیت لایه انتقال» را ببینید.

مشکلات شناخته‌شده

جدول زیر مشکلات شناخته‌شده در این نسخه پخش را فهرست می‌کند:

شناسه مشکل شرح
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. هر پردازشگر پیام را بازراه‌اندازی کنید.

برای تأیید اینکه دارایی‌های استخر اتصال JNDI شما تأثیرگذار است، می‌توانید با tcpdump رفتار استخر اتصال LDAP را درطول زمان مشاهده کنید.