ক্লাসিক UI প্রপার্টি নতুন Edge UI-তে মাইগ্রেট করা

Apigee Edge for Private Cloud 4.54.00-এ, ক্লাসিক UI (edge-ui কম্পোনেন্ট) সরিয়ে দেওয়া হয়েছে এবং আর উপলভ্য নেই। নতুন Edge UI (edge-management-ui কম্পোনেন্ট) হল Edge for Private Cloud-এর একমাত্র UI।

আপনি Edge for Private Cloud 4.54.00-এ edge-ui ব্যবহার করতে পারবেন না। আপনি /opt/apigee/customer/application/ui.properties-এ প্রপার্টি সেট করে ক্লাসিক UI কাস্টমাইজ করে থাকলে, নতুন Edge UI সেই ফাইল রিড করে না। 4.54.00 ভার্সনে আপডেট করার পরে, আপনাকে /opt/apigee/customer/application/management-ui.properties-এ সমতুল্য প্রপার্টি সেট করতে হবে।

এই পৃষ্ঠায় ui.properties-এর জন্য ডকুমেন্ট করা ক্লাসিক UI প্রপার্টি, নতুন Edge UI-এর জন্য সমতুল্য প্রপার্টি এবং নতুন Edge UI-তে কাজ করে না এমন ক্লাসিক UI প্রপার্টির তালিকা দেওয়া আছে।

New Edge UI, অন্যান্য Edge কম্পোনেন্টগুলির মতো একই কোড সহ কনফিগার (CwC) মেকানিজম ব্যবহার করে। আরও তথ্যের জন্য, Edge কীভাবে কনফিগার করতে হয় দেখুন।

ক্লাসিক UI এবং নতুন Edge UI কনফিগারেশনের তুলনা করুন

নতুন Edge UI, ক্লাসিক UI কম্পোনেন্ট, প্রপার্টি ফাইল, পরিষেবার নাম, ডিফল্ট পোর্ট এবং TLS সার্টিফিকেট ফর্ম্যাটকে প্রতিস্থাপন করে। আপনার প্রপার্টি মাইগ্রেট করার আগে অটোমেশন স্ক্রিপ্ট, ফায়ারওয়াল রুল ও TLS ফাইল আপডেট করতে নিচের টেবিল পর্যালোচনা করুন:

সেটিং ক্লাসিক UI (4.53.01 এবং তার আগের ভার্সন) New Edge UI (4.54.00)
কম্পোনেন্টের নাম edge-ui edge-management-ui
প্রপার্টি ফাইল /opt/apigee/customer/application/ui.properties /opt/apigee/customer/application/management-ui.properties
রিস্টার্ট কমান্ড apigee-service edge-ui restart apigee-service edge-management-ui restart
ডিফল্ট পোর্ট 9000 3001
TLS কনফিগারেশন Java কীস্টোর (JKS) ফাইল PEM সার্টিফিকেট ও কী ফাইল। নতুন এজ UI-এর জন্য TLS কনফিগার করুন দেখুন।

নতুন Edge UI-এর জন্য প্রপার্টি সেট করুন

/opt/apigee/customer/application/management-ui.properties-এ নতুন Edge UI কনফিগারেশন প্রপার্টি সেট করুন এবং edge-management-ui পরিষেবা রিস্টার্ট করুন যাতে আপনার করা পরিবর্তন প্রযোজ্য হয়।

নতুন Edge UI-এর জন্য প্রপার্টি সেট করতে:

  1. এডিটরে management-ui.properties ফাইল খুলুন। ফাইলটি না থাকলে, এটি তৈরি করুন: 
    vi /opt/apigee/customer/application/management-ui.properties
  2. প্রপার্টি সেট করুন। যেমন: 
    conf_uebe_disableGeoMap=true
  3. আপনার করা পরিবর্তন সেভ করুন।
  4. apigee ব্যবহারকারী ফাইলের মালিক কিনা তা নিশ্চিত করুন: 
    chown apigee:apigee /opt/apigee/customer/application/management-ui.properties
  5. নতুন Edge UI রিস্টার্ট করুন: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

New Edge UI-এর জন্য প্রপার্টি সেট করার সময় ফর্ম্যাটিং সংক্রান্ত এইসব নিয়ম মেনে চলুন:

  • প্রপার্টির নামে ছোট ও বড় হাতের অক্ষরের মধ্যে পার্থক্য করা হয়। যেমন, conf_uebe_disableGeoMap সঠিক, কিন্তু conf_uebe_disablegeomap সঠিক নয়।
  • ডবল কোটেশন চিহ্নের মধ্যে স্ট্রিং ভ্যালু লিখুন, যেমন conf_uebe_branding_companyNameShort="My Company"।
  • বুলিয়ান ভ্যালু (true বা false) বা সংখ্যার ভ্যালু কোটেশন চিহ্নের মধ্যে রাখবেন না। বুলিয়ান বা সংখ্যাসূচক ভ্যালু উদ্ধৃতি চিহ্নের মধ্যে থাকলে, New Edge UI চালু হয় না।

কোনও প্রপার্টির বর্তমান ভ্যালু চেক করতে, -search বিকল্প ব্যবহার করুন। যেমন:

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui \
  configure -search conf_uebe_disableGeoMap

নতুন Edge UI-তে ক্লাসিক UI প্রপার্টি ম্যাপ করুন

নিম্নলিখিত সারণীগুলি ui.properties-এ প্রতিটি কাজ করে এমন ক্লাসিক UI প্রপার্টিকে management-ui.properties-এ তার সমতুল্য নতুন এজ UI প্রপার্টির সাথে ম্যাপ করে। ডিফল্ট কলামে New Edge UI-তে ডিফল্ট ভ্যালু দেখানো হয়।

ফিচার প্রপার্টি কনফিগার করুন

ম্যাপের ক্লাসিক UI ফিচার ফ্ল্যাগকে সংশ্লিষ্ট management-ui.properties-এর conf_uebe_* প্রপার্টির সাথে ম্যাপ করুন:

ক্লাসিক UI প্রপার্টি নতুন Edge UI প্রপার্টি ডিফল্ট নোট
conf_apigee_apigee.feature.disablegeomap conf_uebe_disableGeoMap false জিও ম্যাপ লুকাতে true-এ সেট করুন। Private Cloud-এর জন্য Edge-এর ক্লাসিক UI-তে, জিও ম্যাপ ডিফল্ট হিসেবে বন্ধ করা ছিল। আপনি যদি জিও অ্যাগ্রিগেশন চালু না করে থাকেন, তাহলে এই প্রপার্টি true-এ সেট করুন। জিও অ্যাগ্রিগেশন ও জিও ম্যাপ চালু করা দেখুন।
conf_apigee_apigee.feature.disablepasswordreset conf_uebe_disablePasswordReset false লগ-ইন পৃষ্ঠায় পাসওয়ার্ড রিসেট করুন লিঙ্ক লুকাতে true-এ সেট করুন।
conf_apigee-base_apigee.feature.enableforcerangelimit conf_uebe_enableForceRangeLimit true ১৪ দিনের বেশি তারিখের রেঞ্জের জন্য কাস্টম রিপোর্ট অনুমোদন করতে false-এ সেট করুন।
conf_apigee-base_apigee.feature.enabletraceforinternaladdresses conf_uebe_trace_for_internal_addresses false ট্রেস টুলকে লোকাল বা ইন্টার্নাল IP অ্যাড্রেসে অনুরোধ পাঠানোর অনুমতি দিতে true-এ সেট করুন।
conf_apigee-base_apigee.feature.enableopenapiforinternaladdresses conf_uebe_openapi_for_internal_addresses false স্থানীয় বা ইন্টার্নাল IP অ্যাড্রেস থেকে OpenAPI স্পেসিফিকেশন ইমপোর্ট করার অনুমতি দিতে true-এ সেট করুন।
conf_apigee-base_apigee.feature.enablewsdlforinternaladdresses conf_uebe_wsdl_for_internal_addresses false স্থানীয় বা ইন্টার্নাল IP অ্যাড্রেস থেকে WSDL ফাইল ইমপোর্ট করার অনুমতি দিতে true হিসেবে সেট করুন।

সেশন ও TLS প্রপার্টি কনফিগার করা

management-ui.properties-এ ম্যাপ ক্লাসিক UI সেশন টাইমআউট এবং TLS প্রপার্টি তাদের নতুন এজ UI-এর সমতুল্য:

ক্লাসিক UI প্রপার্টি নতুন Edge UI প্রপার্টি ডিফল্ট নোট
conf_application_session.maxage conf_uebe_authsessiontimeout 12 (ঘণ্টা) লগ-ইন করার পরে ব্যবহারকারীর সেশনের মেয়াদ শেষ হওয়ার সময়। ঘণ্টার সংখ্যা (যেমন, 12 বা 0.5) অথবা h (ঘণ্টা) বা m (মিনিট) একক (যেমন, 24h বা 90m) সহ সময়ের পরিমাণ উল্লেখ করুন। 12 ও 12h ভ্যালু দুটি একই। d (দিন) ইউনিট কাজ করে না; যেমন, 1d-এর পরিবর্তে 24h ব্যবহার করুন। ভ্যালু সঠিক না হলে, ডিফল্ট হিসেবে ১২ ঘণ্টা ব্যবহার করা হয় এবং কোনও সমস্যার কথা জানানো হয় না। বেসিক যাচাইকরণ ব্যবহার করে এমন সেশনের ক্ষেত্রে প্রযোজ্য।
conf_application_session.secure কিছু প্রয়োজন নেই প্রযোজ্য নয় TLS চালু থাকলে (conf_uebe_usehttps=true) অথবা লোড ব্যালেন্সারে (conf_uebe_tlsoffload=true) TLS বন্ধ হয়ে গেলে, New Edge UI অটোমেটিক সেশন কুকিতে Secure ফ্ল্যাগ সেট করে দেয় ।
conf/application.conf+trustxforwarded conf_uebe_usehttps=true এবং conf_uebe_tlsoffload=true false লোড ব্যালেন্সারে TLS বন্ধ হয়ে গেলে, দুটি প্রপার্টি সেট করুন। লোড ব্যালেন্সারকে অবশ্যই HTTP-এর মাধ্যমে New Edge UI-তে অনুরোধ ফরওয়ার্ড করতে হবে এবং X-Forwarded-Proto হেডার সেট করতে হবে। configure-ssl কমান্ড এইসব প্রপার্টি সেট করে যখন MANAGEMENT_UI_SCHEME=https এবং MANAGEMENT_UI_TLS_OFFLOAD=y। নতুন এজ UI-এর জন্য TLS কনফিগার করুন দেখুন।
conf/application.conf+play.ws.ssl.loose.acceptAnyCertificate conf_uebe_skipverify false ম্যানেজমেন্ট সার্ভার স্ব-স্বাক্ষরিত সার্টিফিকেট ব্যবহার করলে তবেই true-এ সেট করুন। ম্যানেজমেন্ট API-এর জন্য TLS কনফিগার করা দেখুন।

ইমেল প্রপার্টি ও টেমপ্লেট কনফিগার করুন

নতুন Edge UI-তে ক্লাসিক UI ইমেল প্রেরক, বিষয়, ব্র্যান্ডিং, হোস্ট URL এবং লিঙ্কের মেয়াদ শেষ হওয়ার প্রপার্টি ম্যাপ করুন:

ক্লাসিক UI প্রপার্টি নতুন Edge UI প্রপার্টি ডিফল্ট নোট
conf_apigee_apigee.mgmt.mailfrom conf_apigee_apigee.mgmt.mailfrom Apigee <sales@apigee.com>, অথবা ইনস্টল করার সময় SMTPMAILFROM-এর উল্লেখ করা ভ্যালু অপরিবর্তিত রয়েছে।
conf_apigee-base_apigee.emails.passwordreset.subject conf_apigee_apigee.emails.passwordReset.subject Password Reset Request camelCase passwordReset প্রপার্টি সেগমেন্টটি মনে রাখবেন।
conf_apigee-base_apigee.emails.useraddedexisting.subject conf_apigee_apigee.emails.userAddedExisting.subject You Have Been Added to an Organization {organization} camelCase userAddedExisting প্রপার্টি সেগমেন্টটি মনে রাখবেন।
conf_apigee-base_apigee.emails.useraddednew.subject conf_apigee_apigee.emails.userAddedNew.subject An Account Has been Created for You at {companyNameShort} camelCase userAddedNew প্রপার্টি সেগমেন্টটি মনে রাখবেন।
conf_apigee_apigee.branding.companynameshort conf_uebe_branding_companyNameShort Apigee ইমেলের বিষয় ও টেমপ্লেটে {companyNameShort} প্লেসহোল্ডারের মান সেট করে।
conf_apigee_apigee.emails.hosturl conf_apigee_apigee.emails.hosturl কোনওটিই নয় কোনও পরিবর্তন হয়নি। সেট করা না থাকলে, পাসওয়ার্ড রিসেট করার লিঙ্ক New Edge UI-এর URL ব্যবহার করে যা ইনস্টল করার সময় উল্লেখ করা হয়েছিল এবং ব্যবহারকারীর আমন্ত্রণ লিঙ্ক অনুরোধের হোস্টের নাম ব্যবহার করে। ব্যবহারকারীরা লোড ব্যালেন্সার বা DNS নামের মাধ্যমে নতুন Edge UI অ্যাক্সেস করলে এই প্রপার্টি সেট করুন, যেমন conf_apigee_apigee.emails.hosturl="https://ui.mycompany.com"।
conf_apigee_apigee.forgotpassword.emaillinkexpiryseconds conf_apigee_apigee.forgotPassword.EmailLinkExpirySeconds 600 পাসওয়ার্ড রিসেট লিঙ্ক ও ব্যবহারকারীর আমন্ত্রণ লিঙ্কের ক্ষেত্রে প্রযোজ্য।

নতুন Edge UI-তে বিল্ট-ইন ইমেল টেমপ্লেট ব্যবহার করা হয়। ক্লাসিক UI-এর জন্য কাস্টমাইজ করা টেমপ্লেট ব্যবহার করতে:

  1. /opt/apigee/edge-management-ui/email-templates ডিরেক্টরি তৈরি করুন।
  2. আপনার কাস্টমাইজ করা password-reset.html, user-added-existing.html এবং user-added-new.html ফাইলগুলি আপডেট করার আগে আপনার তৈরি করা ব্যাকআপ ডিরেক্টরি থেকে (যেমন, /opt/apigee/customer/backup/) /opt/apigee/edge-management-ui/email-templates-এ কপি করুন। টেমপ্লেট ফাইলের নাম ও প্লেসহোল্ডার Classic UI-এর মতোই।
  3. দেখে নিন যে ডিরেক্টরি ও ফাইলের মালিক apigee ব্যবহারকারী।
  4. New Edge UI রিস্টার্ট করুন।

আরও তথ্যের জন্য, Edge ইমেল টেমপ্লেট কাস্টমাইজ করা দেখুন।

অটোমেটিক জেনারেট হওয়া পাসওয়ার্ডের প্রপার্টি কনফিগার করুন

নতুন Edge UI-তে ক্লাসিক UI অটোমেটিক তৈরি হওয়া পাসওয়ার্ড প্রপার্টি ম্যাপ করুন:

ক্লাসিক UI প্রপার্টি নতুন Edge UI প্রপার্টি ডিফল্ট
conf_apigee-base_apigee.forgotPassword.underscore.minimum conf_apigee_apigee.forgotPassword.underscore.minimum 0
conf_apigee-base_apigee.forgotPassword.specialchars.minimum conf_apigee_apigee.forgotPassword.specialchars.minimum 0
conf_apigee-base_apigee.forgotPassword.lowecase.minimum conf_apigee_apigee.forgotPassword.lowecase.minimum 0
conf_apigee-base_apigee.forgotPassword.uppercase.minimum conf_apigee_apigee.forgotPassword.uppercase.minimum 0

ম্যানেজমেন্ট সার্ভার কানেকশন এবং শেয়ার্ড সিক্রেট প্রপার্টি কনফিগার করুন

নতুন Edge UI-তে ক্লাসিক UI ম্যানেজমেন্ট সার্ভার কানেকশন, ক্রেডেনশিয়াল ও অ্যাপ্লিকেশন সিক্রেট প্রপার্টি ম্যাপ করুন:

ক্লাসিক UI প্রপার্টি নতুন Edge UI প্রপার্টি নোট
conf_apigee_apigee.mgmt.baseurl mgmt_baseurl ম্যানেজমেন্ট API-এর URL, যেমন https://FQ_domain_name:port/v1। এই প্রপার্টির নাম conf_ দিয়ে শুরু হচ্ছে না। ম্যানেজমেন্ট সার্ভার স্ব-স্বাক্ষরিত সার্টিফিকেট ব্যবহার করলে, conf_uebe_skipverify=true-ও সেট করুন।
conf_apigee_apigee.mgmt.credential conf_uebe_mgmtCredential এনক্রিপটেড সিস্টেম অ্যাডমিন ক্রেডেনশিয়াল। আপনাকে আবার ক্রেডেনশিয়াল এনক্রিপ্ট করতে হবে নতুন Edge UI-এর জন্য ./bin/management-ui --encrypt ব্যবহার করে; দেখুন বিভিন্ন sysadmin ক্রেডেনশিয়ালের জন্য কনফিগারেশন প্রয়োজন।
conf_apigee_mail.smtp.credential conf_apigee_mail.smtp.credential এনক্রিপটেড SMTP ক্রেডেনশিয়াল।
conf_application_application.secret conf_uebe_applicationsecret ক্রেডেনশিয়াল ও সেশন কুকি এনক্রিপ্ট করার জন্য ব্যবহৃত সিক্রেট। ইনস্টল করার সময় জেনারেট করা হয়েছে।

ক্লাসিক UI প্রপার্টি সরান যেগুলির জন্য কোনও অ্যাকশন প্রয়োজন নেই

নিম্নলিখিত ক্লাসিক UI প্রপার্টির সমতুল্য কিছু নতুন Edge UI-তে নেই কারণ আচরণ সবসময় চালু থাকে। management-ui.properties-এ এইসব প্রপার্টি অন্তর্ভুক্ত করবেন না (এবং কোনও অটোমেটিক কনফিগারেশন স্ক্রিপ্ট থেকে সেগুলি সরিয়ে দিন):

ক্লাসিক UI প্রপার্টি নতুন Edge UI-তে আচরণ
conf_apigee_apigee.feature.expireSessionCookiesInternally সার্ভারে সবসময় সেশনের মেয়াদ শেষ হওয়া সংক্রান্ত তথ্য যাচাই করা হয়।
conf_apigee_apigee.feature.trackSessionCookies সেশন সংক্রান্ত তথ্য সবসময় সার্ভার মেমরিতে স্টোর করা হয়। আপনি যদি লোড ব্যালেন্সারের পিছনে New Edge UI-এর একাধিক ইনস্ট্যান্স ব্যবহার করেন, তাহলে স্টিকি সেশন ব্যবহার করার জন্য লোড ব্যালেন্সার কনফিগার করুন।

কাজ করে না এমন Classic UI প্রপার্টি সরিয়ে দিন

নিম্নলিখিত ক্লাসিক UI প্রপার্টি কাজ করে না এবং New Edge UI-তে এর সমতুল্য কিছু নেই। এইসব প্রপার্টি management-ui.properties-এ অন্তর্ভুক্ত করবেন না (এবং যেকোনও অটোমেটেড কনফিগারেশন স্ক্রিপ্ট থেকে সেগুলি সরিয়ে দিন):

ক্লাসিক UI প্রপার্টি বিবরণ
conf_apigee_apigee.feature.apitimeout, conf_apigee_play.ws.timeout.idle, conf_apigee_play.ws.timeout.connection ম্যানেজমেন্ট API কলের টাইম-আউট New Edge UI-তে কনফিগার করা যায় না।
conf_application_http.proxyhost, conf_application_http.proxyport, conf_application_http.proxyuser, conf_application_http.proxypassword New Edge UI, Trace টুল অনুরোধের জন্য ফরওয়ার্ড প্রক্সি কাজ করে না।
conf_apigee-base_apigee.feature.enableconsentbanner, conf_apigee-base_apigee.consentbanner.buttoncaption, conf_apigee-base_apigee.consentbanner.body নতুন Edge UI-তে সম্মতি জানানোর ব্যানার কাজ করে না।
conf_apigee-base_apigee.feature.apiproxypaginationenabled, conf_apigee-base_apigee.pagination.apiproxypaginationbatchsize নতুন Edge UI-তে, API প্রক্সি তালিকা সবসময় পৃষ্ঠায় লোড করা হয়। পৃষ্ঠার সাইজ কনফিগার করা যায় না।
conf_logger_settings_application_log_level, conf_logger_settings_play_log_level, conf_application_logger.application নতুন Edge UI-তে লগ লেভেল কনফিগার করা যায় না। লগ ফাইলগুলি /opt/apigee/var/log/edge-management-ui-এ লেখা হয়।
bin_setenv_min_mem, bin_setenv_max_mem, bin_setenv_meta_space_size, bin_setenv_ext_jvm_opts নতুন Edge UI জাভা ভার্চুয়াল মেশিনে চলে না। Java মেমরি সেটিংস প্রয়োগ করা হয় না।

মাইগ্রেশনের উদাহরণ পর্যালোচনা করা

নিম্নলিখিত উদাহরণে, ক্লাসিক UI-এর ui.properties ফাইলের সাথে New Edge UI-এর সমতুল্য management-ui.properties ফাইলের তুলনা করা হয়েছে।

ক্লাসিক UI, /opt/apigee/customer/application/ui.properties:

conf_apigee_apigee.feature.disablegeomap=false
conf_apigee-base_apigee.feature.enabletraceforinternaladdresses="true"
conf_application_session.maxage="1d"
conf_apigee-base_apigee.emails.passwordreset.subject="Reset your My Company password"
conf_apigee_apigee.branding.companynameshort="My Company"
conf_apigee_apigee.emails.hosturl="https://ui.mycompany.com"

/opt/apigee/customer/application/management-ui.properties: নতুন Edge UI,

conf_uebe_disableGeoMap=false
conf_uebe_trace_for_internal_addresses=true
conf_uebe_authsessiontimeout=24
conf_apigee_apigee.emails.passwordReset.subject="Reset your My Company password"
conf_uebe_branding_companyNameShort="My Company"
conf_apigee_apigee.emails.hosturl="https://ui.mycompany.com"

মনে রাখবেন, বুলিয়ান ভ্যালু true কোটেশন চিহ্নের মধ্যে রাখা হয়নি এবং সেশন টাইমআউট 1d-এর পরিবর্তে 24 ব্যবহার করা হয়েছে।

ফাইল সেভ করার পরে, New Edge UI রিস্টার্ট করুন:

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

সারসংক্ষেপ চেকলিস্ট

Apigee Edge for Private Cloud 4.54.00-এ নতুন Edge UI-তে মাইগ্রেশন সম্পূর্ণ করতে নিম্নলিখিত চেকলিস্ট ব্যবহার করুন:

  1. আপগ্রেড করার আগে /opt/apigee/customer/application/ui.properties এবং /opt/apigee/edge-ui/email-templates থেকে যেকোনও কাস্টমাইজ করা ইমেল টেমপ্লেটের ব্যাক-আপ নিন।
  2. ম্যাপ করা প্রপার্টি যোগ করুন /opt/apigee/customer/application/management-ui.properties বুলিয়ান বা নিউমেরিক ভ্যালু কোট না করেই এবং কাজ করে না এমন ক্লাসিক UI প্রপার্টি বাদ দিন।
  3. আপনার ব্যাক-আপ ডিরেক্টরি থেকে /opt/apigee/edge-management-ui/email-templates-এ কাস্টমাইজ করা ইমেল টেমপ্লেট কপি করুন।
  4. সিস্টেম অ্যাডমিনের ক্রেডেনশিয়াল আবার এনক্রিপ্ট করুন ./bin/management-ui --encrypt দিয়ে যদি আপনি সেট করেন conf_uebe_mgmtCredential।
  5. ফাইলের মালিকানা apigee:apigee-এ সেট করুন এবং edge-management-ui রিস্টার্ট করুন।