Apigee Edge 4.52.02 বা 4.53.00 থেকে 4.53.01 ভার্সনে আপডেট করুন

Apigee, Edge for Private Cloud-কে সরাসরি 4.52.02 বা 4.53.00 ভার্সন থেকে 4.53.01 ভার্সনে আপগ্রেড করার সুবিধা দেয়। এই ধরনের আপগ্রেড কীভাবে করতে হয় তা এই পৃষ্ঠায় বর্ণনা করা আছে।

মানানসই আপগ্রেড পাথ সম্পর্কে এক ঝলকে জানতে, প্রাইভেট ক্লাউড রিলিজের জন্য Edge-এর আপগ্রেড কম্প্যাটিবিলিটি ম্যাট্রিক্স দেখুন।

কে আপডেট করতে পারবেন

যে ব্যক্তি আপডেট চালাচ্ছেন, তাকে অবশ্যই সেই ব্যক্তি হতে হবে যিনি মূলত Edge ইনস্টল করেছেন অথবা রুট হিসেবে চালাচ্ছেন।

Edge RPM ইনস্টল করার পরে, যেকেউ সেগুলি কনফিগার করতে পারবেন।

কোন কোন কম্পোনেন্ট আপনাকে অবশ্যই আপডেট করতে হবে

আপনাকে অবশ্যই সব Edge কম্পোনেন্ট আপডেট করতে হবে। Edge এমন কোনও সেট-আপে কাজ করে না যেখানে একাধিক ভার্সনের কম্পোনেন্ট থাকে।

পূর্বশর্ত আপডেট করা

প্রাইভেট ক্লাউড 4.53.01-এর জন্য Edge-এ করা পরিবর্তনগুলি পর্যালোচনা করুন দেখুন।

Apigee Edge আপগ্রেড করার আগে নিম্নলিখিত পূর্বশর্তগুলি পূরণ হয়েছে কিনা তা নিশ্চিত করুন:

  • সব নোডের ব্যাক-আপ নেওয়া
    আপডেট করার আগে, নিরাপত্তার কারণে আমরা সাজেস্ট করি যে আপনি সব নোডের সম্পূর্ণ ব্যাক-আপ নিন। ব্যাক-আপ নেওয়ার জন্য আপনার বর্তমান Edge ভার্সনের প্রসেডিওর ব্যবহার করুন।

    নতুন ভার্সনে আপডেট করার পরে সেটি ঠিকমতো কাজ না করলে, এটি আপনাকে ব্যাক-আপ প্ল্যান রাখতে সাহায্য করে। ব্যাক-আপ সম্পর্কে আরও জানতে, ব্যাক-আপ ও ফিরিয়ে আনা দেখুন।

  • Edge চলছে কিনা দেখুন
    আপডেট প্রসেস চলাকালীন Edge চলছে কিনা তা নিশ্চিত করতে এই কমান্ড ব্যবহার করুন: 
    /opt/apigee/apigee-service/bin/apigee-all status
  • Cassandra-র পূর্বশর্ত যাচাই করুন

    আপনি যদি আগে Edge for Private Cloud-এর পুরনো ভার্সন থেকে 4.52.02 ভার্সনে আপগ্রেড করে থাকেন এবং এখন 4.53.01 ভার্সনে আপগ্রেড করার পরিকল্পনা করেন, তাহলে নিশ্চিত করুন যে আপনি Cassandra-এর জন্য প্রয়োজনীয় পোস্ট-আপগ্রেড ধাপগুলি সম্পূর্ণ করেছেন। এইসব ধাপ 4.52.02 ভার্সনের আপগ্রেড ডকুমেন্টেশনে উল্লেখ করা আছে এবং Cassandra আপগ্রেড করার পূর্বশর্ত-এর অধীনেও উল্লেখ করা আছে। আগের আপগ্রেড করার সময় এই ধাপগুলি সম্পূর্ণ করা হয়েছিল কিনা সেই ব্যাপারে নিশ্চিত না হলে, ভার্সন 4.53.01-এ আপগ্রেড করার আগে সেগুলি আবার সম্পূর্ণ করুন।

  • প্রাইভেট ক্লাউড 4.53.01-এর জন্য Edge-এ IDP কী ও সার্টিফিকেট কনফিগার করা

    Edge for Private Cloud 4.53.01-এ, apigee-sso কম্পোনেন্টে ব্যবহৃত IDP কী ও সার্টিফিকেট এখন কীস্টোরের মাধ্যমে কনফিগার করা হয়। আপনাকে আগে ব্যবহার করা কী ও সার্টিফিকেট একটি কীস্টোরে এক্সপোর্ট করতে হবে। SSO কম্পোনেন্ট আপডেট করার আগে বিস্তারিত ধাপের জন্য পুরনো ভার্সন থেকে Apigee SSO আপডেট করার ধাপ বিভাগে দেওয়া ধাপগুলি অনুসরণ করুন।

  • Python সংক্রান্ত প্রয়োজনীয়তা
    আপগ্রেড করার চেষ্টা করার আগে নিশ্চিত করুন যে Cassandra নোড সহ সমস্ত নোডে Python 3 ইনস্টল করা আছে।

আপগ্রেড করার জন্য কী কী বিশেষ ধাপ বিবেচনা করতে হবে

Private Cloud 4.53.01-এ Edge-এ আপগ্রেড করতে, নির্দিষ্ট সফ্টওয়্যার আপগ্রেড করার জন্য নির্দিষ্ট ধাপগুলি চালানোর কথা বিবেচনা করুন। প্রয়োজনীয় ধাপগুলি আপনার বর্তমান ভার্সনের উপর নির্ভর করে। অতিরিক্ত ধাপের প্রয়োজন হয় এমন বিভিন্ন সফ্টওয়্যারের জন্য নিচের সারণী দেখুন এবং প্রতিটি সফ্টওয়্যারের জন্য বিস্তারিত নির্দেশাবলী অনুসরণ করুন। প্রয়োজনীয় টাস্ক সম্পূর্ণ করার পরে, আপগ্রেড প্রসেস চালিয়ে যেতে মূল আপগ্রেড প্রসেসে ফিরে যান।

বর্তমান ভার্সন 4.53.01 ভার্সনে আপগ্রেড করার জন্য বিশেষ ধাপ প্রয়োজন এমন সফ্টওয়্যার
4.52.02 LDAP, Cassandra, Zookeeper, Postgres
4.53.00 LDAP, Zookeeper, Postgres

আপনার ভার্সনের উপর ভিত্তি করে প্রয়োজনীয় ধাপগুলি সম্পূর্ণ করার পরে, চালিয়ে যেতে মূল আপগ্রেড প্রসেসে ফিরে যান।

প্রপার্টি সেটিংসের অটোমেটিক প্রোপাগেশন

আপনি যদি /opt/apigee/customer/application-এ .properties ফাইল এডিট করে কোনও প্রপার্টি সেট করে থাকেন, তাহলে আপডেট করার সময় এই ভ্যালুগুলি বজায় রাখা হয়।

OpenLDAP 2.6-এ আপগ্রেড করতে হবে

এখানে, লেগ্যাসি OpenLDAP 2.4 থেকে OpenLDAP 2.6-এ প্রাইভেট ক্লাউডের অন্তর্নিহিত LDAP পরিষেবা আপগ্রেড করার জন্য ধাপে ধাপে পদ্ধতি দেওয়া হল। Apigee Edge for Private Cloud ভার্সন 4.53.01 ও তার পরের যেকোনও ভার্সনে আপডেট করার জন্য এই আপগ্রেড বাধ্যতামূলক। এই আপগ্রেড সব Apigee LDAP ডিপ্লয়মেন্ট টপোলজির ক্ষেত্রে প্রযোজ্য: সিঙ্গেল-সার্ভার, অ্যাক্টিভ-প্যাসিভ ও অ্যাক্টিভ-অ্যাক্টিভ (মাল্টি-মাস্টার)।

পূর্বশর্ত ও বিবেচ্য বিষয়

  • মনে রাখবেন, LDAP আপগ্রেড করার প্রসেস চলাকালীন, ম্যানেজমেন্ট API এবং এর ফলে Apigee UI সমস্ত অঞ্চলে সম্পূর্ণভাবে উপলভ্য থাকবে না। ব্যবহারকারী, ভূমিকা, অ্যাপ ও সংস্থার মতো সব প্রশাসনিক কাজ ব্যর্থ হবে এবং পজ করা উচিত। আপনার API প্রক্সি ট্রাফিকের প্রসেসিংয়ে কোনও প্রভাব পড়বে না। LDAP আপগ্রেড করার আগে সব এজ-ম্যানেজমেন্ট-সার্ভার ও এজ-UI বন্ধ করতে ভুলবেন না।

  • ব্যাক-আপ অত্যন্ত গুরুত্বপূর্ণ: আপনার আগে থেকে থাকা LDAP ডেটার সম্পূর্ণ ও যাচাই করা ব্যাক-আপের ব্যাপারে কোনও আপস করা যাবে না। সঠিক ব্যাক-আপ না নিয়ে প্রসেস চালিয়ে গেলে ডেটা স্থায়ীভাবে মুছে যাবে। LDAP ডেটার সামঞ্জস্যপূর্ণ, নির্দিষ্ট সময়ের স্ন্যাপশট ক্যাপচার করার জন্য LDAP পরিষেবা চলাকালীন ব্যাক-আপ শুরু করতে হবে। প্রকৃত আপগ্রেড করার জন্য ব্যাক-আপ নেওয়া প্রয়োজন। ব্যাক-আপ না নিলে, আপনি আপগ্রেড করতে বা আগের ভার্সনে ফিরিয়ে আনতে পারবেন না, কারণ আপগ্রেড করার ধাপের মধ্যে LDAP ডেটা মুছে ফেলা হয়।

প্রস্তুতি ও ইনস্টলেশন (সব LDAP সার্ভার)

এই বিভাগে (ধাপ ২ থেকে ধাপ ৫) উল্লেখ করা ধাপগুলি সব LDAP ডিপ্লয়মেন্ট টপোলজির জন্য একই। apigee-openldap কম্পোনেন্ট ইনস্টল করা আছে এমন প্রতিটি সার্ভারে এই অ্যাকশনগুলি অবশ্যই পারফর্ম করতে হবে, সেটির ভূমিকা যাই হোক না কেন।

  1. LDAP আপগ্রেড করার আগে সব edge-management-server এবং edge-ui বন্ধ করতে ভুলবেন না। 
    apigee-service edge-management-server stop
apigee-service edge-ui stop

  2. আগে থেকে থাকা LDAP ডেটার ব্যাক-আপ নেওয়া

    কোনও পরিবর্তন করার আগে, সব LDAP সার্ভার থেকে বর্তমান LDAP ডেটার সম্পূর্ণ ব্যাক-আপ নিন। এটি একটি নিরাপদ রিস্টোর পয়েন্ট তৈরি করে।

    • ব্যাক-আপ কমান্ড এক্সিকিউট করুন। এই অ্যাকশন /opt/apigee/backup/openldap ডিরেক্টরির মধ্যে টাইমস্ট্যাম্প করা ব্যাকআপ আর্কাইভ তৈরি করে। 
      apigee-service apigee-openldap backup
    • মোট রেকর্ড সংখ্যা পান: আপগ্রেড করার পরে যাচাইকরণের জন্য আপনার ডিরেক্টরিতে থাকা রেকর্ড সংখ্যা ক্যাপচার করুন (সব LDAP সার্ভারে রেকর্ড সংখ্যা একই হতে হবে)। এটি হল স্যানিটি চেক। 
      # Note: Replace 'YOUR_PASSWORD' with your current LDAP manager password.
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" \
-D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l

  3. LDAP বন্ধ করুন এবং ডেটা ডিরেক্টরি পরিষ্কার করুন

    এই ধাপটি অবশ্যই সব LDAP সার্ভারে করতে হবে। মেজর ভার্সন পরিবর্তন ও অন্তর্নিহিত স্ট্রাকচারাল পার্থক্যের কারণে এটি বাধ্যতামূলক। পরিষ্কার ডিরেক্টরি থাকলে কোনও সমস্যা হয় না। সব LDAP সার্ভার বন্ধ হয়ে গেলে, ম্যানেজমেন্ট API ও UI-তে বিঘ্ন ঘটবে।

    • LDAP পরিষেবা বন্ধ করুন। 
      apigee-service apigee-openldap stop
    • পুরনো LDAP ডেটা ও কনফিগারেশন ডিরেক্টরি স্থায়ীভাবে সরিয়ে দিন। 
      rm -rf /opt/apigee/data/apigee-openldap/*

  4. নতুন LDAP ভার্সন ইনস্টল ও কনফিগার করা

    সব LDAP সার্ভারে, নতুন কম্পোনেন্ট ভার্সন ডাউনলোড ও ইনস্টল করতে, স্ট্যান্ডার্ড Apigee স্ক্রিপ্ট ব্যবহার করুন।

    • নতুন LDAP কম্পোনেন্ট ইনস্টল করুন: আপডেট স্ক্রিপ্ট আপনার কনফিগারেশন ফাইল পড়ে এবং নতুন apigee-openldap প্যাকেজ ইনস্টল করে। 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f /opt/silent.conf
    • নতুন LDAP ভার্সন যাচাই করুন:ইনস্টলেশন সম্পূর্ণ হওয়ার পরে প্রোফাইল আবার লোড করুন, নতুন LDAP ভার্সন সঠিকভাবে ইনস্টল করা হয়েছে কিনা তা যাচাই করুন। 
      source ~/.bash_profile
ldapsearch -VV
Expected output:
ldapsearch: @(#) $OpenLDAP: ldapsearch 2.6.7

  5. ডেটা রিস্টোর করার আগে সব সার্ভারে LDAP বন্ধ করুন

    এটি একটি গুরুত্বপূর্ণ সিঙ্ক্রোনাইজেশন ধাপ। আপনার ব্যাক-আপ ফিরিয়ে আনার আগে, আপনাকে অবশ্যই নিশ্চিত করতে হবে যে নতুন ইনস্টল করা LDAP পরিষেবা সব সার্ভারে বন্ধ করা আছে। প্রতিটি LDAP সার্ভারে, নিম্নলিখিত কমান্ডগুলি এক্সিকিউট করুন: 

    apigee-service apigee-openldap stop
rm -rf /opt/apigee/data/apigee-openldap/ldap/*

  6. LDAP ডেটা ফিরিয়ে আনা

    প্রথম অ্যাক্টিভ সার্ভারে ব্যাক-আপ ফিরিয়ে আনাই হল স্ট্র্যাটেজি। এই সার্ভারটি তখন সোর্স অফ ট্রুথ হিসেবে কাজ করবে এবং মাল্টি-সার্ভার সেট-আপে তার পিয়ারদের কাছে ডেটা রেপ্লিকেট করবে।

    1. রিস্টোর করার জন্য প্রথম অ্যাক্টিভ সার্ভার শনাক্ত করুন

      • সিঙ্গেল-সার্ভার সেট-আপের জন্য: এটিই আপনার একমাত্র LDAP সার্ভার। আপনি সরাসরি পরবর্তী ধাপে যেতে পারবেন।
      • অ্যাক্টিভ-প্যাসিভ ও অ্যাক্টিভ-অ্যাক্টিভ সেট-আপের জন্য: প্রতিটি LDAP সার্ভারে নিম্নলিখিত ডায়াগনস্টিক কমান্ড রান করান: 
        grep -i '^olcSyncrepl:' /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase*\ldif
Note:
-If this command returns output, the server is a passive server.
-If it returns no output, the server is the active server.

    2. ব্যাক-আপ ডেটা ফিরিয়ে আনা

      এগিয়ে যাওয়ার আগে, সব LDAP সার্ভারে ৫ নম্বর ধাপটি সঠিকভাবে সম্পূর্ণ হয়েছে কিনা তা ডবল-চেক করুন।

      • আপনি উপরে যে প্রথম অ্যাক্টিভ সার্ভার শনাক্ত করেছেন, সেটিতে ব্যাক-আপ ডিরেক্টরিতে নেভিগেট করুন। 
        cd /opt/apigee/backup/openldap
      • restore কমান্ড এক্সিকিউট করুন। আমরা সাজেস্ট করি যে ধাপ ২ থেকে সঠিক ব্যাক-আপ টাইমস্ট্যাম্প উল্লেখ করুন যাতে কোনও অনাকাঙ্ক্ষিত বা পুরনো ভার্সন ফিরিয়ে আনা না হয়। 
        # To restore a specific backup (recommended):
apigee-service apigee-openldap restore 2025.08.11,23.34.00

# To restore the latest available backup by default:
apigee-service apigee-openldap restore
      • রিস্টোর করার প্রসেস সম্পূর্ণ হয়ে গেলে, প্রথম অ্যাক্টিভ সার্ভারে LDAP পরিষেবা চালু করুন। 
        apigee-service apigee-openldap start

  7. বাকি LDAP সার্ভার চালু করুন

    আপনার মাল্টি সার্ভার সেট-আপ থাকলে, প্রতিটি LDAP সার্ভারে পরিষেবা চালু করুন: 

    apigee-service apigee-openldap start

  8. চূড়ান্ত যাচাইকরণ

    শেষ ধাপ হল, আপগ্রেড সফল হয়েছে কিনা এবং সমগ্র LDAP ক্লাস্টার জুড়ে ডেটা সামঞ্জস্যপূর্ণ কিনা তা যাচাই করা।

    • সব LDAP সার্ভারে যাচাইকরণ কমান্ড চালান। সব সার্ভারে রেকর্ড সংখ্যা একই হতে হবে এবং ২ নম্বর ধাপে আপনি যে সংখ্যা ক্যাপচার করেছেন তার সাথে ম্যাচ করতে হবে।
      • # Note: Replace 'YOUR_PASSWORD' with your LDAP manager password.
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" \
-D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l
    • ডেটা সঠিক ও সামঞ্জস্যপূর্ণ কিনা তা কনফার্ম করার পরে, আপনার LDAP আপগ্রেড সম্পূর্ণ হয়ে যাবে। আপনার সংস্থার স্ট্যান্ডার্ড আপগ্রেড প্রসেস অনুযায়ী, আপনি এখন edge-management-server ও edge-ui এবং অন্যান্য সংশ্লিষ্ট কম্পোনেন্ট চালু করার প্রসেস শুরু করতে পারেন।

Cassandra 4.0.18-এ আপগ্রেড করতে হবে

Apigee Edge for Private Cloud 4.53.01-এ Cassandra-কে 4.0.18 ভার্সনে আপগ্রেড করা হয়েছে।

আপগ্রেড ও রোলব্যাক

  • Cassandra 3.11.X থেকে Cassandra 4.0.X-এ আপগ্রেড করা একটি সহজ প্রসেস। Edge for Private Cloud 4.53.00-এর সাথে রিলিজ করা Cassandra 4.0.X, Private Cloud 4.52.02-এর রানটাইম ও ম্যানেজমেন্ট কম্পোনেন্টের সাথে মানানসই।
  • Cassandra 4.0.X থেকে 3.11.X-এ সরাসরি ইন-প্লেস রোলব্যাক করা যায় না। রেপ্লিকা বা ব্যাক-আপ ব্যবহার করে রোল ব্যাক করা একটি জটিল পদ্ধতি এবং এর মধ্যে ডাউনটাইম এবং/অথবা ডেটা হারানোর সম্ভাবনা থাকতে পারে। সমস্যার সমাধান করা এবং Cassandra 4.0.X-এ আপগ্রেড করা, আগের ভার্সনে ফিরিয়ে আনার চেয়ে বেশি পছন্দসই।
  • আপগ্রেড করার চেষ্টা করার আগে রোলব্যাক পদ্ধতি সম্পর্কে ভালোভাবে জেনে নেওয়া গুরুত্বপূর্ণ। আপগ্রেড করার সময় রোলব্যাক সংক্রান্ত খুঁটিনাটি বিষয় বিবেচনা করা অত্যন্ত গুরুত্বপূর্ণ, যাতে উপযুক্ত রোলব্যাক পাথ উপলভ্য থাকে।

সিঙ্গেল ডেটা সেন্টার

একটি ডেটা সেন্টারের মধ্যে Cassandra-কে 3.11.X থেকে 4.0.X ভার্সনে আপগ্রেড করা সহজ, কিন্তু রোলব্যাক করা কঠিন এবং এর ফলে ডাউনটাইম ও ডেটা হারানোর মতো ঘটনা ঘটতে পারে। প্রোডাকশন ওয়ার্কলোডের জন্য, আপগ্রেড শুরু করার আগে অন্তত নতুন ডেটা সেন্টারে উপলভ্য ক্যাসান্ড্রা নোড সহ একটি নতুন ডেটা সেন্টার যোগ করার জন্য অত্যন্ত জোরালোভাবে সাজেস্ট করা হয়। এর ফলে আপনার API ট্রাফিকে কোনও বিঘ্ন না ঘটিয়ে বা ডেটা হারিয়ে না ফেলে Cassandra রোলব্যাক করা যাবে। আপগ্রেড সম্পূর্ণ হয়ে গেলে বা চেকপয়েন্ট ২-এ পৌঁছে গেলে এই অতিরিক্ত ডেটা সেন্টার বন্ধ করে দেওয়া যেতে পারে।

নতুন ডেটা সেন্টার যোগ করা সম্ভব না হলেও রোলব্যাক করার সুবিধা প্রয়োজন হলে, Cassandra 3.11.X ফিরিয়ে আনার জন্য ব্যাক-আপ প্রয়োজন হবে। তবে, এই পদ্ধতিতে ডাউনটাইম ও ডেটা হারানোর সম্ভাবনা থাকে।

একাধিক ডেটা সেন্টার

Edge for Private Cloud 4.52.02-এর সাথে একাধিক ডেটা সেন্টার পরিচালনা করা হলে, Edge for Private Cloud 4.53.00-এ আপগ্রেড করার সময় রোলব্যাক করার ক্ষেত্রে আরও বেশি নমনীয়তা পাওয়া যায়।

  • রোলব্যাক করার জন্য অন্তত একটি ডেটা সেন্টারে পুরনো Cassandra ভার্সন (3.11.X) চলতে হবে।
  • আপনার সম্পূর্ণ Cassandra ক্লাস্টার 4.0.X-এ আপগ্রেড করা হলে, আপনাকে অবশ্যই Cassandra 3.11.X-এ রোল ব্যাক করা যাবে না। আপনাকে অবশ্যই Private Cloud 4.53.00 বা 4.52.02-এর অন্যান্য কম্পোনেন্ট সহ নতুন Cassandra ভার্সন ব্যবহার করা চালিয়ে যেতে হবে।
  1. একবারে একটি Cassandra ডেটা সেন্টার আপগ্রেড করুন: একটি ডেটা সেন্টারের মধ্যে আলাদা আলাদা করে Cassandra নোড আপগ্রেড করার মাধ্যমে শুরু করুন। পরবর্তী ডেটা সেন্টারে যাওয়ার আগে একটি ডেটা সেন্টারের সব Cassandra নোডের আপগ্রেড সম্পূর্ণ করুন।
  2. পজ ও যাচাইকরণ: একটি ডেটা সেন্টার আপগ্রেড করার পরে, আপনার প্রাইভেট ক্লাউড ক্লাস্টার, বিশেষ করে আপগ্রেড করা ডেটা সেন্টার সঠিকভাবে কাজ করছে কিনা তা নিশ্চিত করতে পজ করুন।
  3. মনে রাখবেন: আপনি শুধুমাত্র তখনই আগের Cassandra ভার্সনে রোল ব্যাক করতে পারবেন যদি আপনার অন্তত একটি ডেটা সেন্টার এখনও পুরনো ভার্সনে চলে।
  4. সময়-সংবেদনশীল: কার্যকারিতা যাচাই করার জন্য আপনি অল্প সময়ের জন্য (কয়েক ঘণ্টা সাজেস্ট করা হয়) পজ করতে পারলেও, আপনি অনির্দিষ্টকালের জন্য মিক্সড-ভার্সন স্টেটে থাকতে পারবেন না। এর কারণ হল, নন-ইউনিফর্ম ক্যাসান্ড্রা ক্লাস্টারে (বিভিন্ন ভার্সনের নোড সহ) অপারেশনাল সীমাবদ্ধতা থাকে।
  5. পুঙ্খানুপুঙ্খ পরীক্ষা: পরবর্তী ডেটা সেন্টার আপগ্রেড করার আগে Apigee পারফর্ম্যান্স ও কার্যকারিতা পুঙ্খানুপুঙ্খভাবে পরীক্ষা করার জন্য জোরালোভাবে সাজেস্ট করে। সব ডেটা সেন্টার আপগ্রেড করা হয়ে গেলে, আগের ভার্সনে রোলব্যাক করা সম্ভব নয়।
দুটি চেকপয়েন্ট প্রসেস হিসেবে রোলব্যাক করা
  1. চেকপয়েন্ট ১: প্রাথমিক অবস্থা, যেখানে সব কম্পোনেন্ট ভার্সন 4.52.02-এ আছে। যতক্ষণ পর্যন্ত অন্তত একটি Cassandra ডেটা সেন্টার পুরনো ভার্সনে থাকে, ততক্ষণ পর্যন্ত সম্পূর্ণ রোলব্যাক করা সম্ভব।
  2. চেকপয়েন্ট ২: সব ডেটা সেন্টারের সব Cassandra নোড আপডেট করার পরে। আপনি এই স্টেটে রোল ব্যাক করতে পারবেন, কিন্তু চেকপয়েন্ট ১-এ আর ফিরে যেতে পারবেন না।
উদাহরণ

দুটি ডেটা সেন্টার (DC) ক্লাস্টার বিবেচনা করুন:

  1. শুরুর অবস্থা: দুটি DC-তে Cassandra নোড 3.11.X ভার্সনে আছে। অন্যান্য সব নোড প্রাইভেট ক্লাউড ভার্সন 4.52.02-এর Edge-এ আছে। প্রতিটি ডিসি (DC)-তে তিনটি করে Cassandra নোড আছে বলে ধরে নিন।
  2. DC-1 আপগ্রেড করা: DC-1-এর তিনটি Cassandra নোড একটি একটি করে আপগ্রেড করুন।
  3. পজ ও যাচাই করা: ক্লাস্টার, বিশেষ করে DC-1 সঠিকভাবে কাজ করছে কিনা তা নিশ্চিত করতে পজ করুন (পারফর্ম্যান্স, কার্যকারিতা চেক করুন)। আপনি DC-2-তে Cassandra নোড ব্যবহার করে প্রাথমিক অবস্থায় ফিরে যেতে পারবেন। মনে রাখবেন, মিক্সড-ভার্সন Cassandra ক্লাস্টারের সীমাবদ্ধতার কারণে এই পজ অবশ্যই সাময়িক হতে হবে।
  4. DC-2 আপগ্রেড করুন: DC-2-তে বাকি তিনটি Cassandra নোড আপগ্রেড করুন। এটি আপনার নতুন রোলব্যাক চেকপয়েন্ট হয়ে যাবে।
  5. অন্যান্য কম্পোনেন্ট আপগ্রেড করা: সব ডেটা সেন্টার জুড়ে, ম্যানেজমেন্ট, রানটাইম ও অ্যানালিটিক্স নোডকে স্বাভাবিকভাবে আপগ্রেড করুন, তবে একবারে একটি নোড ও একটি ডেটা সেন্টার আপগ্রেড করুন। কোনও সমস্যা হলে, আপনি ধাপ ৪-এর অবস্থায় ফিরে যেতে পারবেন।

Cassandra আপগ্রেডের পূর্বশর্ত

আপনাকে Edge for Private Cloud 4.52.02-এর সাথে Cassandra 3.11.16 চালাতে হবে এবং নিম্নলিখিত বিষয়গুলি নিশ্চিত করতে হবে:
  1. সম্পূর্ণ ক্লাস্টারটি Cassandra 3.11.16-এর সাথে অপারেশনাল এবং সম্পূর্ণ কার্যকরী।
  2. কম্প্যাকশন স্ট্র্যাটেজি LeveledCompactionStrategy-এ সেট করা আছে (4.52.02 ভার্সনে আপগ্রেড করার জন্য এটি পূর্বশর্ত)।

  3. Edge for Private Cloud 4.52.02-এ Cassandra 3.11-এর প্রাথমিক আপগ্রেডেশনের অংশ হিসেবে নিচে উল্লেখ করা প্রতিটি ধাপ সম্পূর্ণ করা হয়েছে কিনা তা কনফার্ম করুন।

    • আগের আপগ্রেডের সময় প্রতিটি Cassandra নোডে post_upgrade কমান্ড চালানো হয়েছে
    • আগের আপগ্রেড চলাকালীন সম্পূর্ণ Cassandra ক্লাস্টারে drop_old_tables কমান্ডটি এক্সিকিউট করা হয়েছিল।

Edge for Private Cloud 4.52.02 ব্যবহার করার সময় Cassandra 3.11-এ post_upgrade এবং drop_old_tables কমান্ড কার্যকর করা হয়েছে কিনা তা আপনি নিশ্চিত না হলে, 4.53.01-এ আপগ্রেড করার চেষ্টা করার আগে আপনি নিরাপদে সেগুলি আবার রান করতে পারেন।

ধাপ ১: আপগ্রেডের জন্য প্রস্তুতি নেওয়া

কম্পোনেন্ট আপগ্রেড করার জন্য Apigee-এর স্ট্যান্ডার্ড কনফিগারেশন ফাইল-এর মতো আপনি সাধারণত যেসব স্ট্যান্ডার্ড ফাইল তৈরি করেন, নিচে উল্লেখ করা ধাপগুলি তার অতিরিক্ত।

  1. Apigee ব্যবহার করে Cassandra-র ব্যাক-আপ নিন।
  2. Cassandra নোডের VM স্ন্যাপশট নিন (সম্ভব হলে)।
  3. আগে থেকে কনফিগার করা না থাকলে, ম্যানেজমেন্ট সার্ভার, মেসেজ প্রসেসর, রাউটার, Qpid এবং Postgres সহ Private Cloud-এর সব Edge কম্পোনেন্ট থেকে Cassandra নোডে পোর্ট 9042 অ্যাক্সেস করা যায় কিনা তা নিশ্চিত করুন। আরও তথ্যের জন্য পোর্ট সংক্রান্ত প্রয়োজনীয়তা দেখুন।

ধাপ ২: সব Cassandra নোড আপগ্রেড করুন

প্রতিটি ডেটা সেন্টারে, এক এক করে সব Cassandra নোড আপডেট করতে হবে, একবারে একটি ডেটা সেন্টার। ডেটা সেন্টারের মধ্যে নোড আপগ্রেড করার সময়, আপডেট করা নোড সম্পূর্ণভাবে চালু হয়েছে এবং ক্লাস্টারে যোগ দিয়েছে কিনা তা নিশ্চিত করতে কয়েক মিনিট অপেক্ষা করুন, তারপরে একই ডেটা সেন্টারে অন্য নোড আপগ্রেড করার প্রসেস শুরু করুন।

কোনও ডেটা সেন্টারের মধ্যে থাকা সব Cassandra নোড আপগ্রেড করার পরে, পরবর্তী ডেটা সেন্টারের নোড নিয়ে কাজ শুরু করার আগে কিছু সময় (৩০ মিনিট থেকে কয়েক ঘণ্টা) অপেক্ষা করুন। এই সময়, আপডেট করা ডেটা সেন্টার ভালভাবে পর্যালোচনা করুন এবং নিশ্চিত করুন যে আপনার Apigee ক্লাস্টারের কার্যকরী ও পারফর্ম্যান্স মেট্রিক অক্ষত আছে। যে ডেটা সেন্টারে Cassandra-কে 4.0.X ভার্সনে আপগ্রেড করা হয়েছে, সেখানে ডেটা সেন্টারের স্থিতিশীলতা নিশ্চিত করার জন্য এই ধাপটি অত্যন্ত গুরুত্বপূর্ণ, কারণ Apigee-এর বাকি কম্পোনেন্ট 4.52.02 ভার্সনে রয়ে গেছে।

  1. Cassandra নোড আপগ্রেড করতে, নিম্নলিখিত কমান্ড রান করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. কোনও নোড আপডেট করা হয়ে গেলে, এগিয়ে যাওয়ার আগে কিছু যাচাইকরণ রান করাতে, নোডে নিম্নলিখিত কমান্ড রান করান: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
  3. উপরের কোডটি এই ধরনের কিছু আউটপুট দেবে: 
    Cassandra version is verified - [cqlsh 6.0.0 | Cassandra 4.0.18 | CQL spec 3.4.5 | Native protocol v5] 
Metadata is verified
  4. Cassandra নোডে নিম্নলিখিত post_upgrade কমান্ড রান করুন: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
  5. Cassandra নোডে নিম্নলিখিত cleanup_old_index কমান্ড রান করুন: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra cleanup_old_index
  6. Cassandra নোডে ইনডেক্স আবার তৈরি করতে নিম্নলিখিত nodetool কমান্ড রান করুন: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms api_products api_products_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_api_products_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_end_user app_end_user_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_family_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_type_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms maps maps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_request_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_refresh_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_company_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_developer_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_operation_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_requesturi_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_responsecode_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_timestamp_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_user_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_active_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_index_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_method_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_latest_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_active
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_latest
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rel_ver
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_entity
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template_auth au_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index dek keys usecase_index
     আপনি মনিটাইজেশন ব্যবহার করলে, মনিটাইজেশন কীস্পেসের সাথে সম্পর্কিত নিম্নলিখিত আবার ইন্ডেক্স তৈরি করুন কমান্ডও চালান: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_updated_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_currency_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_dev_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_limit_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_prod_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_reason_code_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_sub_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_company_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_created_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_developer_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_lastmodified_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_env_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_job_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_class_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus org_triggers org_triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_suite_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_to_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_org_id_idx

ধাপ ৩: সব ম্যানেজমেন্ট নোড আপগ্রেড করুন

সব অঞ্চলে ম্যানেজমেন্ট নোডগুলি একটি একটি করে আপগ্রেড করুন:

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

ধাপ ৪: সব রানটাইম নোড আপগ্রেড করুন

সব অঞ্চলে সব রাউটার ও মেসেজ প্রসেসর নোড একটি একটি করে আপগ্রেড করুন:

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

ধাপ ৫: Edge for Private Cloud 4.53.01-এর বাকি সব কম্পোনেন্ট আপগ্রেড করুন

সব অঞ্চলে বাকি থাকা edge-qpid-server ও edge-postgres-server নোডগুলি একটি একটি করে আপগ্রেড করুন।

Zookeeper 3.8.4-এ আপগ্রেড করতে হবে

প্রাইভেট ক্লাউডের জন্য Edge-এর এই রিলিজে Zookeeper 3.8.4-এ আপগ্রেড অন্তর্ভুক্ত। সেই আপগ্রেডের অংশ হিসেবে, সব Zookeeper ডেটা Zookeeper 3.8.4-এ মাইগ্রেট করা হবে।

Zookeeper আপগ্রেড করার আগে, Zookeeper পরিচালনা সংক্রান্ত নির্দেশিকা পড়ে নিন। বেশিরভাগ Edge প্রোডাকশন সিস্টেম একাধিক ডেটা সেন্টার জুড়ে Zookeeper নোডের একটি ক্লাস্টার ব্যবহার করে। এইসব নোডের মধ্যে কিছু নোডকে ভোটার হিসেবে কনফিগার করা হয়, যারা Zookeeper লিডার নির্বাচনে অংশগ্রহণ করে এবং বাকি নোডকে পর্যবেক্ষক হিসেবে কনফিগার করা হয়। আরও তথ্যের জন্য নেতা, ফলোয়ার, ভোটার ও পর্যবেক্ষক সম্পর্কে দেখুন। ভোটার নোড একটি লিডার বেছে নেয়, তারপরে ভোটার নোডগুলি ফলোয়ার হয়ে যায়।

আপডেট প্রসেস চলাকালীন, লিডার নোড বন্ধ হয়ে গেলে, Zookeeper-এ সাময়িক বিলম্ব বা লেখার ক্ষেত্রে সমস্যা হতে পারে। এর ফলে, প্রক্সি ডেপ্লয়মেন্ট অপারেশন এবং Apigee ইনফ্রাস্ট্রাকচার পরিবর্তনের মতো Zookeeper-এ লেখা ম্যানেজমেন্ট অপারেশন প্রভাবিত হতে পারে। যেমন, মেসেজ প্রসেসর যোগ করা বা সরানো ইত্যাদি। নিচে উল্লেখ করা পদ্ধতি অনুসরণ করার সময় Zookeeper আপগ্রেড করার সময় Apigee-এর রানটাইম API-এর উপর কোনও প্রভাব পড়বে না (যদি না এই রানটাইম API ম্যানেজমেন্ট API কল করে)।

মোটামুটিভাবে, আপগ্রেড প্রসেসে প্রতিটি নোডের ব্যাক-আপ নেওয়া হয়। এর পরে সব পর্যবেক্ষক ও ফলোয়ারকে আপগ্রেড করা হয় এবং সবশেষে লিডার নোডকে আপগ্রেড করা হয়।

ব্যাক-আপ নেওয়া

রোলব্যাক করার প্রয়োজন হলে ব্যবহার করার জন্য Zookeeper-এর সব নোডের ব্যাক-আপ নিন। মনে রাখবেন যে রোলব্যাক করলে, ব্যাক-আপ নেওয়ার সময় Zookeeper যে অবস্থায় ছিল সেই অবস্থায় ফিরিয়ে আনা হবে। মনে রাখবেন: ব্যাক-আপ নেওয়ার পর থেকে Apigee-তে করা যেকোনও ডেপ্লয়মেন্ট বা ইনফ্রাস্ট্রাকচার সংক্রান্ত পরিবর্তন (যেগুলির তথ্য Zookeeper-এ সেভ করা আছে) রিস্টোর করার সময় হারিয়ে যাবে। 

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

আপনি ভার্চুয়াল মেশিন ব্যবহার করলে এবং আপনার কাছে সেই ক্ষমতা থাকলে, রিস্টোরেশন বা রোলব্যাক করার জন্য VM স্ন্যাপশট বা ব্যাক-আপও নেওয়া যেতে পারে (প্রয়োজন হলে)।

নেতা, অনুগামী ও পর্যবেক্ষকদের শনাক্ত করা

মনে রাখবেন: নিচে দেওয়া নমুনা কমান্ডগুলি Zookeeper-এ ডেটা পাঠানোর জন্য nc ইউটিলিটি ব্যবহার করে। এছাড়াও, আপনি Zookeeper-এ ডেটা পাঠানোর জন্য বিকল্প ইউটিলিটি ব্যবহার করতে পারেন।

  1. এটি ZooKeeper নোডে ইনস্টল করা না থাকলে, nc ইনস্টল করুন: 
      sudo yum install nc
  2. নোডে নিম্নলিখিত nc কমান্ড রান করুন, যেখানে 2181 হল ZooKeeper পোর্ট: 
      echo stat | nc localhost 2181

    আপনি এই ধরনের আউটপুট দেখতে পাবেন:

      Zookeeper version: 3.8.4-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
  Clients:
   /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
  
  Latency min/avg/max: 0/0.2518/41
  Received: 647228
  Sent: 647339
  Connections: 4
  Outstanding: 0
  Zxid: 0x400018b15
  Mode: follower
  Node count: 100597

    নোডের আউটপুটের Mode লাইনে, নোড কনফিগারেশনের উপর নির্ভর করে, আপনাকে observer, leader বা follower (অর্থাৎ, এমন ভোটার যে লিডার নয়) দেখতে হবে। মনে রাখবেন: একটি ZooKeeper নোড সহ Edge-এর স্ট্যান্ডঅলোন ইনস্টলেশনে, Mode স্ট্যান্ডঅলোন হিসেবে সেট করা আছে।

  3. প্রতিটি ZooKeeper নোডে ১ ও ২ নম্বর ধাপ আবার করুন।

অবজার্ভার ও ফলোয়ার নোডে Zookeeper আপগ্রেড করা

নিম্নলিখিত পদ্ধতিতে প্রতিটি পর্যবেক্ষক ও ফলোয়ার নোডে Zookeeper আপগ্রেড করুন:

  1. Edge for Private Cloud 4.53.01-এর বুটস্ট্র্যাপ ডাউনলোড ও রান করুন, যা এক্সটার্নাল ইন্টারনেট কানেকশন সহ নোডে 4.53.01 ভার্সনে আপডেট করুন লিঙ্কে বর্ণনা করা হয়েছে। নোডে এক্সটার্নাল ইন্টারনেট কানেকশন আছে কিনা বা আপনি অফলাইন ইনস্টলেশন করছেন কিনা, তার উপর নির্ভর করে প্রসেস আলাদা হতে পারে।
  2. Zookeeper কম্পোনেন্ট আপগ্রেড করুন: 
      /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
     মনে রাখবেন: এই নোডগুলিতে অন্যান্য কম্পোনেন্ট ইনস্টল করা থাকলে (যেমন, Cassandra), আপনি এখন সেগুলিও আপগ্রেড করতে পারেন (যেমন, cs,zk প্রোফাইল দিয়ে) অথবা পরে অন্যান্য কম্পোনেন্ট আপগ্রেড করতে পারেন। Apigee সাজেস্ট করে যে আপনি প্রথমে শুধুমাত্র Zookeeper আপগ্রেড করুন এবং অন্যান্য কম্পোনেন্ট আপগ্রেড করার আগে আপনার ক্লাস্টার সঠিকভাবে কাজ করছে কিনা তা নিশ্চিত করুন।
  3. Zookeeper-এর প্রতিটি পর্যবেক্ষক ও ফলোয়ার নোডে উপরের ধাপগুলি আবার অনুসরণ করুন।

লিডার নোড বন্ধ করা

সবকটি পর্যবেক্ষক ও ফলোয়ার নোড আপগ্রেড করা হয়ে গেলে, লিডার নোড বন্ধ করে দিন। লিডার হিসেবে শনাক্ত করা নোড -এ নিচের কমান্ডটি রান করুন: 

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

মনে রাখবেন, এই ইভেন্টের সময়, নতুন লিডার নির্বাচিত হওয়ার আগে, Zookeeper-এ সাময়িক বিলম্ব বা রাইট ব্যর্থতা হতে পারে। এর ফলে Zookeeper-এ লেখা অপারেশন প্রভাবিত হতে পারে যেমন, প্রক্সি ডেপ্লয়মেন্ট অ্যাকশন বা Apigee ইনফ্রাস্ট্রাকচারে পরিবর্তন, যেমন মেসেজ প্রসেসর যোগ করা বা সরিয়ে দেওয়া ইত্যাদি।

নতুন নেতা নির্বাচিত হয়েছেন কিনা তা যাচাই করুন

উপরে লিডার, ফলোয়ার ও পর্যবেক্ষক শনাক্ত করুন বিভাগে দেওয়া ধাপগুলি ব্যবহার করে, যাচাই করুন যে বর্তমান লিডারকে বন্ধ করে দেওয়ার পরে ফলোয়ারদের মধ্যে থেকে নতুন লিডার বেছে নেওয়া হয়েছে। মনে রাখবেন, বর্তমান লিডারের থেকে আলাদা ডেটা সেন্টারে লিডার নির্বাচিত হতে পারেন।

আপগ্রেড লিডার

উপরে অবজার্ভার ও ফলোয়ার নোডে Zookeeper আপগ্রেড করা বিভাগে উল্লেখ করা ধাপগুলি অনুসরণ করুন।

পুরনো লিডার নোড আপগ্রেড করা হয়ে গেলে, ক্লাস্টারের অবস্থা যাচাই করুন এবং লিডার নোড আছে কিনা দেখুন।

Edge-Router-এ Nginx 1.26 আপগ্রেড

আগের ভার্সন থেকে Edge for Private Cloud 4.53.01-এ আপগ্রেড করলে, Nginx সফ্টওয়্যার অটোমেটিক লেটেস্ট ভার্সনে (1.26.x) আপগ্রেড হয় না। Apigee Edge 4.53.01-এ Nginx 1.26-এর পরিবর্তন ডকুমেন্টেশনে উল্লেখ করা পরিবর্তনগুলির ফলে রানটাইমে কোনও অপ্রত্যাশিত পার্শ্বপ্রতিক্রিয়া এড়াতে এটি করা হয়। নিম্নলিখিত এনভায়রনমেন্টে যাচাই করার পরে আপনি Nginx-কে 1.20.x থেকে 1.26.x ভার্সনে ম্যানুয়ালি আপগ্রেড করতে পারবেন। ম্যানুয়ালি আপগ্রেড করতে:

  1. এজ-রাউটার নোডে লেটেস্ট 4.53.01 সফ্টওয়্যার আছে কিনা তা নিশ্চিত করুন

    /opt/apigee/apigee-service/bin/apigee-service edge-router version

  2. আপনি বর্তমানে যে Nginx ভার্সন চালাচ্ছেন সেটি চেক ও যাচাই করুন

    /opt/nginx/sbin/nginx -V

    আপনি যদি Nginx-এর পুরনো ভার্সন ব্যবহার করেন, তাহলে রাউটার নোডে Nginx-কে 1.26.X ভার্সনে আপগ্রেড করতে, নিচে উল্লেখ করা ধাপগুলি অনুসরণ করতে পারেন।

  3. রাউটার নোডে এজ-রাউটার প্রসেস বন্ধ করা

    /opt/apigee/apigee-service/bin/apigee-service edge-router stop

  4. রাউটার নোডে nginx সফ্টওয়্যার আপগ্রেড করা

    dnf update apigee-nginx-1.26.3

  5. Nginx ভার্সন আপডেট করা হয়েছে কিনা তা যাচাই করুন

    /opt/nginx/sbin/nginx -V

  6. নোডে রাউটার প্রসেস শুরু করা

    /opt/apigee/apigee-service/bin/apigee-service edge-router start

  7. প্রতিটি রাউটার নোডে, এক এক করে প্রসেসটি রিপিট করুন

Postgres 17-এ আপগ্রেড করতে হবে

Edge-এর এই রিলিজে Postgres 17-এ আপগ্রেড করা হয়েছে। সেই আপগ্রেডের অংশ হিসেবে, সব Postgres ডেটা Postgres 17-এ মাইগ্রেট করা হয়।

বেশিরভাগ Edge প্রোডাকশন সিস্টেমে মাস্টার-স্ট্যান্ডবাই রেপ্লিকেশনের জন্য কনফিগার করা দুটি Postgres নোড ব্যবহার করা হয়। আপডেট প্রসেস চলাকালীন, Postgres নোড আপডেট করার জন্য বন্ধ থাকলেও, অ্যানালিটিক্স ডেটা এখনও Qpid নোডে লেখা হয়। Postgres নোড আপডেট হয়ে অনলাইন হলে, অ্যানালিটিক্স ডেটা Postgres নোডে পুশ করা হয়।

আপনি যেভাবে Postgres আপডেট করেন তা নির্ভর করে আপনার Postgres নোডের জন্য কীভাবে ডেটা স্টোরেজ কনফিগার করেছেন তার উপর:

  • আপনার Postgres নোডের জন্য লোকাল ডেটা স্টোরেজ ব্যবহার করলে, আপনাকে অবশ্যই আপগ্রেড চলাকালীন একটি নতুন Postgres স্ট্যান্ডবাই নোড ইনস্টল করতে হবে। আপগ্রেড সম্পূর্ণ হওয়ার পরে, আপনি নতুন Postgres স্ট্যান্ডবাই নোডটি বন্ধ করে দিতে পারবেন।

    আপনাকে যদি কোনও কারণে আপডেট রোল ব্যাক করতে হয়, তাহলে অতিরিক্ত Postgres স্ট্যান্ডবাই নোডের প্রয়োজন হবে। আপডেট রোল ব্যাক করতে হলে, রোল ব্যাক করার পরে নতুন Postgres স্ট্যান্ডবাই নোড মাস্টার Postgres নোড হয়ে যায়। তাই, আপনি যখন নতুন Postgres স্ট্যান্ডবাই নোড ইনস্টল করবেন, তখন এটি এমন একটি নোডে থাকতে হবে যা Edge-এ ইনস্টলেশন সংক্রান্ত প্রয়োজনীয়তাতে সংজ্ঞায়িত করা Postgres সার্ভারের সমস্ত হার্ডওয়্যার সংক্রান্ত প্রয়োজনীয়তা পূরণ করে।

    Edge-এর ১-নোড ও ২-নোড কনফিগারেশনে, প্রোটোটাইপিং ও টেস্টিংয়ের জন্য ব্যবহৃত টপোলজি, আপনার শুধুমাত্র একটি Postgres নোড আছে। নতুন Postgres নোড তৈরি না করেই আপনি সরাসরি এইসব Postgres নোড আপডেট করতে পারবেন।

  • আপনি যদি নিজের Postgres নোডের জন্য নেটওয়ার্ক স্টোরেজ ব্যবহার করেন, তাহলে Apigee-এর সাজেশন অনুযায়ী, আপনাকে নতুন Postgres নোড ইনস্টল করতে হবে না। নিচে উল্লেখ করা প্রক্রিয়াতে, আপনি সেইসব ধাপ এড়িয়ে যেতে পারেন যেগুলিতে নতুন Postgres স্ট্যান্ডবাই নোড ইনস্টল ও পরে ডি-কমিশন করার কথা বলা হয়েছে।

    আপডেট প্রসেস শুরু করার আগে, Postgres-এর ব্যবহার করা ডেটা স্টোরের নেটওয়ার্ক স্ন্যাপশট নিন। তারপরে, আপডেট করার সময় কোনও সমস্যা হলে এবং আপনাকে রোল ব্যাক করতে বাধ্য করা হলে, আপনি সেই স্ন্যাপশট থেকে Postgres নোড রিস্টোর করতে পারবেন।

নতুন Postgres স্ট্যান্ডবাই নোড ইনস্টল করা

এই পদ্ধতিতে নতুন নোডে Postgres স্ট্যান্ডবাই সার্ভার তৈরি করা হয়। Edge-এর আগে থেকে থাকা ভার্সনের (4.52.02 বা 4.53.00) জন্য নতুন Postgres স্ট্যান্ডবাই সার্ভার ইনস্টল করেছেন কিনা তা নিশ্চিত করুন, 4.53.01 ভার্সনের জন্য নয়।

ইনস্টল করার জন্য, Edge-এর বর্তমান ভার্সন ইনস্টল করার জন্য আপনি যে কনফিগারেশন ফাইল ব্যবহার করেছিলেন সেটিই ব্যবহার করুন।

নতুন Postgres স্ট্যান্ডবাই নোড তৈরি করতে:

  1. বর্তমান Postgres মাস্টারে, নিম্নলিখিত টোকেন সেট করতে /opt/apigee/customer/application/postgresql.properties ফাইল এডিট করুন। সেই ফাইলটি না থাকলে, এটি তৈরি করুন: 
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

    যেখানে existing_standby_ip হল বর্তমান Postgres স্ট্যান্ডবাই সার্ভারের IP অ্যাড্রেস এবং new_standby_ip হল নতুন স্ট্যান্ডবাই নোডের IP অ্যাড্রেস।

  2. Postgres মাস্টার সার্ভারে apigee-postgresql রিস্টার্ট করুন: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. মাস্টারে /opt/apigee/apigee-postgresql/conf/pg_hba.conf ফাইল দেখে যাচাই করুন যে নতুন স্ট্যান্ডবাই নোড যোগ করা হয়েছে। সেই ফাইলে আপনাকে নিচের লাইনগুলি দেখতে হবে: 
    host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
  4. নতুন Postgres স্ট্যান্ডবাই সার্ভার ইনস্টল করুন:
    1. Edge-এর বর্তমান ভার্সন ইনস্টল করার জন্য আপনি যে কনফিগারেশন ফাইল ব্যবহার করেছেন সেটি এডিট করে নিম্নলিখিত বিষয়গুলি নির্দিষ্ট করুন: 
      # IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
    2. Edge apigee-setup ইউটিলিটি ইনস্টল করুন-এ বর্ণিত পদ্ধতি অনুযায়ী SELinux বন্ধ করুন।

    3. আপনি বর্তমানে Edge 4.52.02 ব্যবহার করলে:

      1. Edge bootstrap_4.52.02.sh ফাইলটি /tmp/bootstrap_4.52.02.sh -এ ডাউনলোড করুন: 
        curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.51.00.sh
      2. Edge apigee-service ইউটিলিটি ও ডিপেন্ডেন্সি ইনস্টল করুন: 
        sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

      আপনি বর্তমানে Edge 4.53.00 ব্যবহার করলে:

      1. Edge bootstrap_4.53.00.sh ফাইলটি /tmp/bootstrap_4.53.00.sh -এ ডাউনলোড করুন: 
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      2. Edge apigee-service ইউটিলিটি ও ডিপেন্ডেন্সি ইনস্টল করুন: 
        sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
    4. apigee-setup ইউটিলিটি ইনস্টল করতে apigee-service ব্যবহার করুন: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    5. Postgres ইনস্টল করুন: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. নতুন স্ট্যান্ডবাই নোডে, নিম্নলিখিত কমান্ড রান করুন: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      এটি স্ট্যান্ডবাই আছে কিনা তা যাচাই করুন।

Postgres-এর ইন-প্লেস আপগ্রেড করা

মনে রাখবেন: Postgres-এর ইন-প্লেস আপগ্রেড করার আগে আপনাকে অবশ্যই নিম্নলিখিত প্রাথমিক ধাপটি সম্পূর্ণ করতে হবে।

প্রাথমিক ধাপ

Postgres-এ ইন-প্লেস আপগ্রেড করার আগে, মাস্টার হোস্ট ও স্ট্যান্ডবাই, দু'টিতেই নিম্নলিখিত ধাপগুলি সম্পূর্ণ করে apigee-postgresql-এ max_locks_per_transaction প্রপার্টি আপডেট করুন:

  1. সেটি না থাকলে, /opt/apigee/customer/application/postgresql.properties ফাইলটি তৈরি করুন।
  2. এই ফাইলের মালিকানা apigee-এ পরিবর্তন করুন: 
    sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
  3. ফাইলে নিম্নলিখিত প্রপার্টি যোগ করুন: 
    conf/postgresql.conf+max_locks_per_transaction=30000
  4. apigee-postgresql কনফিগার করুন: 
    apigee-service apigee-postgresql configure
  5. apigee-postgresql রিস্টার্ট করুন: 
    apigee-service apigee-postgresql restart

ইন-প্লেস আপগ্রেড করা

Postgres 17-এ ইন-প্লেস আপগ্রেড করতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:

  1. মাস্টার হোস্টে postgres আপগ্রেড করা 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  2. মাস্টার হোস্টের উপর সেট-আপ কমান্ড রান করুন: 
    apigee-service apigee-postgresql setup -f /opt/silent.conf
  3. মাস্টার হোস্টে configure কমান্ড রান করান: 
    apigee-service apigee-postgresql configure
  4. মাস্টার হোস্ট রিস্টার্ট করুন: 
    apigee-service apigee-postgresql restart
  5. এটি মাস্টার হিসেবে কনফিগার করুন: 
    apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
  6. মাস্টার হোস্ট শুরু করেছেন কিনা তা নিশ্চিত করুন: 
    apigee-service apigee-postgresql wait_for_ready
  7. স্ট্যান্ডবাই বন্ধ করা: 
    apigee-service apigee-postgresql stop
  8. স্ট্যান্ডবাই আপগ্রেড করুন।

    মনে রাখবেন: এই ধাপে কোনও সমস্যা হলে/কাজ না করলে, এটি উপেক্ষা করা যেতে পারে। update.sh ভুল কনফিগারেশন দিয়ে স্ট্যান্ড-বাই সার্ভার চালু করার চেষ্টা করবে। Postgres ইনস্টলেশন 17-এ আপগ্রেড করা হলে, এই সমস্যাটি উপেক্ষা করা যেতে পারে।

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  9. স্ট্যান্ডবাই বন্ধ করা হয়েছে কিনা তা নিশ্চিত করুন: 
    apigee-service apigee-postgresql stop
  10. পুরনো স্ট্যান্ডবাই কনফিগারেশন সরিয়ে দিন: 
    rm -rf /opt/apigee/data/apigee-postgresql/
  11. স্ট্যান্ডবাই সার্ভারে রেপ্লিকেশন সেট-আপ করুন: 
    apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf
  12. মাস্টার হোস্ট ও স্ট্যান্ডবাই, দু'টি থেকেই conf/postgresql.conf+max_locks_per_transaction=30000 লাইনটি /opt/apigee/customer/application/postgresql.properties ফাইল থেকে সরিয়ে দিন। এই লাইনটি প্রাথমিক ধাপে যোগ করা হয়েছে।

এই পদ্ধতি সম্পূর্ণ করার পরে, স্ট্যান্ডবাই সফলভাবে শুরু হবে।

Postgres নোড বন্ধ করা

আপডেট সম্পূর্ণ হওয়ার পরে, নতুন স্ট্যান্ডবাই নোড বন্ধ করে দিন:

  1. Postgres চলছে কিনা তা নিশ্চিত করুন: 
    /opt/apigee/apigee-service/bin/apigee-all status

    Postgres চালু না থাকলে, এটি চালু করুন: 

    /opt/apigee/apigee-service/bin/apigee-all start
  2. নতুন স্ট্যান্ডবাই নোডে নিম্নলিখিত curl কমান্ড রান করে নতুন স্ট্যান্ডবাই নোডের UUID পান: 
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    আউটপুটের শেষে, আপনাকে নোডের UUID দেখতে পাওয়ার কথা, এই ফর্ম্যাটে: 

    "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  3. নতুন স্ট্যান্ডবাই নোডে নিম্নলিখিত কমান্ড রান করে নতুন স্ট্যান্ডবাই নোড বন্ধ করুন: 
    /opt/apigee/apigee-service/bin/apigee-all stop
  4. Postgres মাস্টার নোডে, conf_pg_hba_replication.connection থেকে নতুন স্ট্যান্ডবাই নোড সরাতে /opt/apigee/customer/application/postgresql.properties এডিট করুন: 
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
  5. Postgres মাস্টার নোডে apigee-postgresql রিস্টার্ট করুন: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. মাস্টারে /opt/apigee/apigee-postgresql/conf/pg_hba.conf ফাইল দেখে যাচাই করুন যে নতুন স্ট্যান্ডবাই নোড সরানো হয়েছে। আপনি সেই ফাইলে শুধুমাত্র নিম্নলিখিত লাইনটি দেখতে পাবেন: 
    host replication apigee existing_standby_ip/32 trust
  7. ম্যানেজমেন্ট সার্ভার নোডে নিম্নলিখিত Edge ম্যানেজমেন্ট API কল করে ZooKeeper থেকে স্ট্যান্ডবাই নোডের UUID মুছে দিন: 
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

Postgres-এর জন্য আপগ্রেড করার পরের ধাপ

Postgres-এ বড় ধরনের আপগ্রেড করার পরে, Postgres-এর ইন্টার্নাল পরিসংখ্যান মুছে যায়। এইসব পরিসংখ্যান Postgres কোয়েরি প্ল্যানারকে কোয়েরি এক্সিকিউট করার জন্য সবচেয়ে অপ্টিমাল ইন্ডেক্স ও পাথ ব্যবহার করতে সাহায্য করে।

কোয়েরি এক্সিকিউট করা হলে এবং autovacuum ডেমনের রান করার সময় Postgres ধীরে ধীরে তার পরিসংখ্যান আবার তৈরি করতে পারে। তবে, পরিসংখ্যান আবার তৈরি না হওয়া পর্যন্ত, আপনার কোয়েরি ধীরে চলতে পারে।

এই সমস্যার সমাধান করতে, মাস্টার Postgres নোডে ডেটাবেসের সব টেবিলে ANALYZE এক্সিকিউট করুন। অথবা, আপনি একবারে কয়েকটি টেবিলের জন্য ANALYZE এক্সিকিউট করতে পারেন।

পুরনো ভার্সন থেকে Apigee SSO আপডেট করার ধাপ

Edge for Private Cloud 4.53.01-এ, apigee-sso কম্পোনেন্টে ব্যবহৃত IDP কী ও সার্টিফিকেট এখন কীস্টোরের মাধ্যমে কনফিগার করা হয়। আপনাকে আগে ব্যবহৃত কী ও সার্টিফিকেট একটি কীস্টোরে এক্সপোর্ট করতে হবে, এটি কনফিগার করতে হবে এবং তারপর স্বাভাবিকভাবে SSO আপডেট করার প্রসেস চালিয়ে যেতে হবে।

  1. IDP কনফিগার করার জন্য ব্যবহৃত আগে থেকে থাকা কী ও সার্টিফিকেট শনাক্ত করুন:

    1. SSO ইনস্টলেশন কনফিগারেশন ফাইলে SSO_SAML_SERVICE_PROVIDER_CERTIFICATE-এর ভ্যালু দেখে অথবা apigee-sso কম্পোনেন্টকে conf_login_service_provider_certificate-এর জন্য কোয়েরি করে সার্টিফিকেট রিট্রিভ করুন।

      IDP সার্টিফিকেটের পাথ কোয়েরি করতে SSO নোডে নিম্নলিখিত কমান্ড ব্যবহার করুন apigee-sso। আউটপুটের শেষ লাইনে ভ্যালু দেখুন। 

      apigee-service apigee-sso configure -search conf_login_service_provider_certificate

    2. SSO ইনস্টলেশন কনফিগারেশন ফাইলে SSO_SAML_SERVICE_PROVIDER_KEY-এর ভ্যালু দেখে অথবা apigee-sso কম্পোনেন্টকে conf_login_service_provider_key-এর জন্য কোয়েরি করে কী ফিরিয়ে আনুন।

      IDP কী পাথ কোয়েরি করার জন্য SSO নোডে নিম্নলিখিত কমান্ড ব্যবহার করুন।apigee-sso আউটপুটে, শেষ লাইনে ভ্যালু দেখুন।

      apigee-service apigee-sso configure -search conf_login_service_provider_key
  2. কীস্টোরে কী ও সার্টিফিকেট এক্সপোর্ট করুন:
    1. PKCS12 কীস্টোরে কী ও সার্টিফিকেট এক্সপোর্ট করুন: 
      sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>

      প্যারামিটার:

      • certificate_path: ধাপ ১.ক-তে পাওয়া সার্টিফিকেট ফাইলের পাথ।
      • key_path: ১.খ ধাপে পাওয়া প্রাইভেট কী ফাইলের পাথ।
      • keystore_path: সার্টিফিকেট ও ব্যক্তিগত কী সহ নতুন তৈরি কীস্টোরের পাথ।
      • alias: কীস্টোরের মধ্যে কী ও সার্টিফিকেট পেয়ারের জন্য ব্যবহৃত উপনাম।

      আরও বিবরণের জন্য OpenSSL ডকুমেন্টেশন দেখুন।

    2. (ঐচ্ছিক) PKCS12 থেকে JKS কীস্টোরে কী ও সার্টিফিকেট এক্সপোর্ট করুন: 
      sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>

      প্যারামিটার:

      • PKCS12_keystore_path: ধাপ ২.ক-তে তৈরি PKCS12 কীস্টোরের পাথ, যাতে সার্টিফিকেট ও কী থাকে।
      • destination_keystore_path: নতুন JKS কীস্টোরের পাথ যেখানে সার্টিফিকেট ও কী এক্সপোর্ট করা হবে।
      • alias: JKS কীস্টোরের মধ্যে কী ও সার্টিফিকেট পেয়ারের জন্য ব্যবহৃত ছদ্মনাম।

      3. আরও বিবরণের জন্য keytool ডকুমেন্টেশন দেখুন।

  3. আউটপুট কীস্টোর ফাইলের মালিককে "apigee" ব্যবহারকারী হিসেবে পরিবর্তন করুন: 
    sudo chown apigee:apigee <keystore_file>
  4. Apigee SSO কনফিগারেশন ফাইলে নিম্নলিখিত প্রপার্টি যোগ করুন এবং কীস্টোর ফাইলের পাথ, পাসওয়ার্ড, কীস্টোর টাইপ ও অ্যালিয়াস দিয়ে সেগুলি আপডেট করুন: 
    # Path to the keystore file
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PATH=${APIGEE_ROOT}/apigee-sso/source/conf/keystore.jks

# Keystore password
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PASSWORD=Secret123  # Password for accessing the keystore

# Keystore type
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_TYPE=JKS  # Type of keystore, e.g., JKS, PKCS12

# Alias within keystore that stores the key and certificate
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_ALIAS=service-provider-cert
  5. নিম্নলিখিত কমান্ড ব্যবহার করে SSO নোডে Apigee SSO সফ্টওয়্যার আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf

নতুন Edge UI

এই বিভাগে Edge UI সংক্রান্ত বিবেচ্য বিষয়গুলি তালিকাভুক্ত করা হয়েছে। আরও তথ্যের জন্য, প্রাইভেট ক্লাউডের জন্য নতুন Edge UI দেখুন।

Edge UI ইনস্টল করা

প্রাথমিক ইনস্টলেশন সম্পূর্ণ করার পরে, Apigee সাজেস্ট করে যে আপনি Edge UI ইনস্টল করুন, এটি হল Apigee Edge for Private Cloud-এর ডেভেলপার ও অ্যাডমিনিস্ট্রেটরদের জন্য উন্নত ইউজার ইন্টারফেস।

মনে রাখবেন, Edge UI-এর জন্য আপনাকে সাধারণ যাচাইকরণ বন্ধ করতে হবে এবং SAML বা LDAP-এর মতো IDP ব্যবহার করতে হবে।

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

Apigee mTLS-এর মাধ্যমে আপডেট করা

Apigee mTLS আপডেট করতে , নিম্নলিখিত ধাপগুলি অনুসরণ করুন:

আপডেট রোল ব্যাক করা

আপডেট করা না গেলে, আপনি সমস্যাটি সমাধান করার চেষ্টা করতে পারেন এবং তারপরে আবার update.sh চালান। আপনি একাধিকবার আপডেট চালাতে পারবেন এবং এটি যেখানে শেষ হয়েছিল সেখান থেকে আপডেট করা চালিয়ে যাবে।

আপডেট করা না গেলে, আগের ভার্সনে ফিরিয়ে নিয়ে যাওয়ার প্রয়োজন হলে, বিস্তারিত নির্দেশাবলীর জন্য 4.53.01 ভার্সন ফিরিয়ে নিয়ে যান দেখুন।

আপডেট সংক্রান্ত তথ্য লগ করা

ডিফল্ট হিসেবে, update.sh ইউটিলিটি লগ সংক্রান্ত তথ্য এখানে লেখে:

/opt/apigee/var/log/apigee-setup/update.log

update.sh ইউটিলিটি যে ব্যক্তি চালাচ্ছেন তার যদি সেই ডিরেক্টরি অ্যাক্সেস না থাকে, তাহলে /tmp ডিরেক্টরির মধ্যে update_username.log নামে একটি ফাইল হিসেবে লগ সেভ করে।

ব্যক্তির /tmp-এ অ্যাক্সেস না থাকলে, update.sh ইউটিলিটি কাজ করে না।

জিরো-ডাউনটাইম আপডেট

জিরো-ডাউনটাইম আপডেট বা রোলিং আপডেট, Edge বন্ধ না করেই Edge ইনস্টলেশন আপডেট করতে দেয়।

৫-নোড কনফিগারেশন ও তার থেকে বড় কনফিগারেশনের ক্ষেত্রেই শুধু জিরো-ডাউনটাইম আপডেট সম্ভব।

জিরো-ডাউনটাইম আপগ্রেড করার মূল চাবিকাঠি হল, লোড ব্যালেন্সার থেকে প্রতিটি রাউটারকে, একটি একটি করে, সরিয়ে দেওয়া। তারপরে, আপনি রাউটার এবং রাউটারের মতো একই মেশিনে থাকা অন্য যেকোনও কম্পোনেন্ট আপডেট করেন, এবং তারপরে লোড ব্যালেন্সারে রাউটারটি আবার যোগ করেন।

  1. আপনার ইনস্টলেশনের জন্য সঠিক ক্রমে মেশিন আপডেট করুন, যেমনটি মেশিন আপডেটের ক্রম-এ বর্ণনা করা হয়েছে।
  2. রাউটার আপডেট করার সময় হলে, যেকোনও একটি রাউটার বেছে নিন এবং এটিকে নাগালের বাইরে করে দিন, যেমন সার্ভার (মেসেজ প্রসেসর/রাউটার) নাগালের মধ্যে আছে কিনা তা চালু/বন্ধ করা নিবন্ধে বর্ণনা করা হয়েছে।
  3. বেছে নেওয়া রাউটার এবং রাউটারের মতো একই মেশিনে থাকা অন্যান্য সব Edge কম্পোনেন্ট আপডেট করুন। সব Edge কনফিগারেশনে একই নোডে একটি রাউটার ও মেসেজ প্রসেসর দেখানো হয়।
  4. রাউটারকে আবার অ্যাক্সেসযোগ্য করে তুলুন।
  5. বাকি রাউটারগুলির জন্য ২ থেকে ৪ নম্বর ধাপগুলি আবার করুন।
  6. আপনার ইনস্টলেশনে বাকি থাকা যেকোনও মেশিনের জন্য আপডেট করা চালিয়ে যান।

আপডেট করার আগে ও পরে নিম্নলিখিত বিষয়গুলি খেয়াল রাখুন:

সাইলেন্ট কনফিগারেশন ফাইল ব্যবহার করা

আপডেট কমান্ডে আপনাকে অবশ্যই একটি সাইলেন্ট কনফিগারেশন ফাইল পাস করতে হবে। সাইলেন্ট কনফিগারেশন ফাইলটি Edge for Private Cloud 4.52.02 বা 4.53.00 ইনস্টল করার সময় আপনি যে ফাইলটি ব্যবহার করেছিলেন সেটিই হতে হবে।

এক্সটার্নাল ইন্টারনেট কানেকশন সহ নোডে 4.53.01 ভার্সনে আপডেট করুন

কোনও নোডে Edge কম্পোনেন্ট আপডেট করতে, নিম্নলিখিত পদ্ধতি ব্যবহার করুন:

  1. উপস্থিত থাকলে, আপডেট সম্পূর্ণ না হওয়া পর্যন্ত Cassandra-তে মেরামত অপারেশন পারফর্ম করার জন্য কনফিগার করা যেকোনও cron জব বন্ধ করুন।
  2. Edge RPM ইনস্টল করতে, আপনার নোডে রুট হিসেবে লগ-ইন করুন।
  3. Edge apigee-setup ইউটিলিটি ইনস্টল করুন লিঙ্কে বর্ণিত পদ্ধতি অনুযায়ী SELinux বন্ধ করুন।
  4. আপনি AWS-এ ইনস্টল করলে, নিম্নলিখিত yum-configure-manager কমান্ডগুলি প্রয়োগ করুন: 
    yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

  5. আপনি বর্তমানে Edge 4.52.02 বা 4.53.00 ব্যবহার করলে:

    1. /tmp/bootstrap_4.53.01.sh-এ Edge bootstrap_4.53.01.sh ফাইল ডাউনলোড করুন: 
      curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh
    2. নিম্নলিখিত কমান্ড এক্সিকিউট করে Edge 4.53.01 apigee-service ইউটিলিটি ও ডিপেন্ডেন্সি ইনস্টল করুন: 
      sudo bash /tmp/bootstrap_4.53.01.sh apigeeuser=uName apigeepassword=pWord

      Apigee-এর থেকে পাওয়া ইউজারনেম ও পাসওয়ার্ড uName:pWord কোথায় আছে। আপনি pWord বাদ দিলে, এটি লিখতে বলা হবে।

      ডিফল্ট হিসেবে, ইনস্টলার চেক করে যে আপনার Java 1.8 ইনস্টল করা আছে কিনা। আপনার কাছে এটি না থাকলে, ইনস্টলার আপনার জন্য এটি ইনস্টল করে দেয়।

      Java ইনস্টলেশন কীভাবে হ্যান্ডেল করতে হয় তা নির্দিষ্ট করতে JAVA_FIX বিকল্প ব্যবহার করুন। JAVA_FIX নিম্নলিখিত মানগুলি নেয়:

      • I: OpenJDK 1.8 (ডিফল্ট) ইনস্টল করুন।
      • C: Java ইনস্টল না করেই চালিয়ে যান।
      • Q: বেরিয়ে আসুন। এই বিকল্পের জন্য, আপনাকে অবশ্যই নিজে থেকে Java ইনস্টল করতে হবে।
    3. apigee-setup ইউটিলিটি আপডেট করতে apigee-service ব্যবহার করুন, যেমন নিচের উদাহরণে দেখানো হয়েছে: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    4. ম্যানেজমেন্ট সার্ভারে apigee-validate ইউটিলিটি আপডেট করুন, যেমনটি নিচে দেখানো হয়েছে: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    5. ম্যানেজমেন্ট সার্ভারে apigee-provision ইউটিলিটি আপডেট করুন, যেমনটি নিচে দেখানো হয়েছে: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
    6. নিচের কমান্ডটি এক্সিকিউট করে আপনার নোডে update ইউটিলিটি রান করুন: 
      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

      মেশিন আপডেট করার ক্রম-এ বর্ণিত ক্রম অনুযায়ী এটি করুন।

      যেখানে:

      • component হল আপডেট করার Edge কম্পোনেন্ট। সম্ভাব্য ভ্যালুর মধ্যে এগুলি পড়ে:
        • cs: Cassandra
        • edge: Edge UI ছাড়া Edge-এর সব কম্পোনেন্ট: ম্যানেজমেন্ট সার্ভার, মেসেজ প্রসেসর, রাউটার, QPID সার্ভার, Postgres সার্ভার
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: Apigee SSO (আপনি SSO ইনস্টল করে থাকলে)
        • ue: নতুন Edge UI
        • ui: ক্লাসিক Edge UI
        • zk: চিড়িয়াখানার কর্মী
      • configFile হল সেই একই কনফিগারেশন ফাইল যা আপনি 4.52.02 বা 4.53.00 ইনস্টলেশন চলাকালীন আপনার Edge কম্পোনেন্টকে সংজ্ঞায়িত করতে ব্যবহার করেছেন।

      আপনি component "সব" হিসেবে সেট করে সব কম্পোনেন্টের বিরুদ্ধে update.sh রান করাতে পারবেন, তবে শুধুমাত্র আপনার কাছে Edge অল-ইন-ওয়ান (AIO) ইনস্টলেশন প্রোফাইল থাকলে। যেমন:

      /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
    7. আপনি আগেই এটি না করে থাকলে, Edge UI কম্পোনেন্ট রান করা সব নোডে সেগুলি রিস্টার্ট করুন: 
      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
    8. ইনস্টল পরীক্ষা করুন-এ বর্ণিত পদ্ধতি অনুযায়ী ম্যানেজমেন্ট সার্ভারে apigee-validate ইউটিলিটি চালিয়ে আপডেট পরীক্ষা করুন।

আপনি পরে আপডেট রোল ব্যাক করার সিদ্ধান্ত নিলে, 4.53.01 রোল ব্যাক করুন-এ বর্ণিত পদ্ধতি ব্যবহার করুন।

লোকাল রেপো থেকে 4.53.01-এ আপডেট করা

আপনার Edge নোড ফায়ারওয়ালের পিছনে থাকলে অথবা অন্য কোনও উপায়ে ইন্টারনেটের মাধ্যমে Apigee রেপোজিটরি অ্যাক্সেস করতে না পারলে, আপনি Apigee রেপোর লোকাল রেপোজিটরি অথবা মিরর থেকে আপডেট করতে পারবেন।

আপনি একটি লোকাল Edge রেপোজিটরি তৈরি করার পরে, লোকাল রেপোজিটরি থেকে Edge আপডেট করার জন্য আপনার কাছে দুটি বিকল্প আছে:

  • রেপোর একটি .tar ফাইল তৈরি করুন, .tar ফাইলটি কোনও নোডে কপি করুন এবং তারপরে .tar ফাইল থেকে Edge আপডেট করুন।
  • লোকাল রিপোজিটরি সহ নোডে একটি ওয়েবসার্ভার ইনস্টল করুন যাতে অন্যান্য নোড এটি অ্যাক্সেস করতে পারে। Apigee আপনাকে ব্যবহার করার জন্য Nginx ওয়েবসার্ভার প্রদান করে অথবা আপনি নিজের ওয়েবসার্ভার ব্যবহার করতে পারেন।

লোকাল 4.53.01 রেপো থেকে আপডেট করতে:

  1. "স্থানীয় Apigee রিপোজিটরি তৈরি করুন" লিঙ্কে বর্ণিত পদ্ধতি অনুযায়ী একটি স্থানীয় 4.53.01 রিপোজিটরি তৈরি করুন Edge apigee-setup ইউটিলিটি ইনস্টল করুন।
  2. .tar ফাইল থেকে apigee-service ইনস্টল করতে:
    1. লোকাল রিপোজিটরি সহ নোডে, নিম্নলিখিত কমান্ড ব্যবহার করে লোকাল রিপোজিটরিকে /opt/apigee/data/apigee-mirror/apigee-4.53.01.tar.gz নামের একটি .tar ফাইলে প্যাকেজ করুন: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. আপনি যে নোডে Edge আপডেট করতে চান সেখানে .tar ফাইলটি কপি করুন। যেমন, নতুন নোডের /tmp ডিরেক্টরিতে এটি কপি করুন।
    3. নতুন নোডে, /tmp ডিরেক্টরিতে ফাইলটি আনটার করুন: 
      tar -xzf apigee-4.53.01.tar.gz

      এই কমান্ডটি .tar ফাইল থাকা ডিরেক্টরিতে repos নামের একটি নতুন ডিরেক্টরি তৈরি করে। যেমন /tmp/repos।

    4. Edge apigee-service ইউটিলিটি ও ডিপেন্ডেন্সি এখান থেকে ইনস্টল করুন /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.53.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      লক্ষ্য করুন যে এই কমান্ডে আপনি রিপোজিটরি ডিরেক্টরির পাথ অন্তর্ভুক্ত করেছেন।

  3. Nginx ওয়েবসার্ভার ব্যবহার করে apigee-service ইনস্টল করতে:
    1. Edge ইনস্টল করুন apigee-setup ইউটিলিটি লিঙ্কে "Nginx ওয়েব সার্ভার ব্যবহার করে রিপোজিটরি থেকে ইনস্টল করুন" নিবন্ধে বর্ণিত পদ্ধতি অনুযায়ী Nginx ওয়েব সার্ভার কনফিগার করুন।
    2. রিমোট নোডে, Edge bootstrap_4.53.01.sh ফাইলটি এখানে ডাউনলোড করুন: /tmp/bootstrap_4.53.01.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh

      uName:pWord হল রিপোজিটরির জন্য আগে সেট করা ইউজারনেম ও পাসওয়ার্ড এবং remoteRepo হল রিপো নোডের IP অ্যাড্রেস বা DNS নাম।

    3. রিমোট নোডে, Edge apigee-setup ইউটিলিটি ও ডিপেন্ডেন্সি ইনস্টল করুন: 
      sudo bash /tmp/bootstrap_4.53.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      রেপো ইউজারনেম ও পাসওয়ার্ড uName:pWord কোথায় আছে।

  4. apigee-setup ইউটিলিটি আপডেট করতে apigee-service ব্যবহার করুন, যেমন নিচের উদাহরণে দেখানো হয়েছে: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. ম্যানেজমেন্ট সার্ভারে apigee-validate ইউটিলিটি আপডেট করুন, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. ম্যানেজমেন্ট সার্ভারে apigee-provision ইউটিলিটি আপডেট করুন, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. মেশিন আপডেটের ক্রম অনুসারে আপনার নোডে update ইউটিলিটি রান করান: 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    যেখানে:

    • component হল আপডেট করার Edge কম্পোনেন্ট। আপনি সাধারণত নিম্নলিখিত কম্পোনেন্ট আপডেট করেন:
      • cs: Cassandra
      • edge: Edge UI ছাড়া সব Edge কম্পোনেন্ট: ম্যানেজমেন্ট সার্ভার, মেসেজ প্রসেসর, রাউটার, QPID সার্ভার, Postgres সার্ভার
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: Apigee SSO (আপনি SSO ইনস্টল করে থাকলে)
      • ue নতুন Edge UI
      • ui: ক্লাসিক Edge UI
      • zk: চিড়িয়াখানার কর্মী
    • configFile হল সেই একই কনফিগারেশন ফাইল যা আপনি 4.52.02 বা 4.53.00 ইনস্টলেশনের সময় আপনার Edge কম্পোনেন্টকে সংজ্ঞায়িত করতে ব্যবহার করেছিলেন।

    আপনি component "সব" হিসেবে সেট করে সব কম্পোনেন্টের বিরুদ্ধে update.sh রান করাতে পারবেন, তবে এটি তখনই সম্ভব হবে যদি আপনার কাছে Edge অল-ইন-ওয়ান (AIO) ইনস্টলেশন প্রোফাইল থাকে। যেমন:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. আপনি আগেই এটি না করে থাকলে, এটি চলছে এমন সব নোডে UI কম্পোনেন্ট রিস্টার্ট করুন: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. ইনস্টল পরীক্ষা করুন-এ বর্ণিত apigee-validate ইউটিলিটি ম্যানেজমেন্ট সার্ভারে রান করিয়ে আপডেট পরীক্ষা করুন।

আপনি পরে আপডেট রোল ব্যাক করার সিদ্ধান্ত নিলে, 4.53.01 রোল ব্যাক করুন-এ বর্ণিত পদ্ধতি ব্যবহার করুন।

মেশিন আপডেটের ক্রম

Edge ইনস্টলেশনে আপনি যে ক্রমে মেশিন আপডেট করেন তা গুরুত্বপূর্ণ:

  • অন্যান্য কম্পোনেন্ট আপডেট করার আগে আপনাকে অবশ্যই সব LDAP নোড আপডেট করতে হবে। LDAP আপগ্রেড করার জন্য আপনাকে বিশেষ ধাপ অনুসরণ করতে হবে।
  • আপনাকে অবশ্যই সব Cassandra ও ZooKeeper নোড আপডেট করতে হবে। আপনি যদি 4.52.02 থেকে আপগ্রেড করেন, তাহলে cassandra আপগ্রেড করার জন্য বিশেষ ধাপগুলি অনুসরণ করুন। 4.52.02 বা 4.53.00-এর জন্য Zookeeper আপগ্রেড করতে আপনাকে বিশেষ ধাপ অনুসরণ করতে হবে।
  • আপডেট করার জন্য আপনাকে অবশ্যই -c edge বিকল্প ব্যবহার করে সব ম্যানেজমেন্ট সার্ভার এবং রাউটার ও মেসেজ প্রসেসর আপগ্রেড করতে হবে।
  • Postgres আপগ্রেড করার বিশেষ ধাপ অনুসরণ করে আপনাকে অবশ্যই সব Postgres নোড আপগ্রেড করতে হবে।
  • আপনাকে সব ডেটা সেন্টার জুড়ে edge-qpid-server ও edge-postgres-server কম্পোনেন্ট আপডেট করতে হবে।
  • আপনাকে অবশ্যই সব Qpid নোড আপগ্রেড করতে হবে।
  • আপনাকে অবশ্যই Edge UI নোড আপগ্রেড করতে হবে এবং এছাড়াও New Edge UI ও SSO নোড আপগ্রেড করতে হবে(প্রযোজ্য হলে)।
  • মনিটাইজেশন আপডেট করার জন্য আলাদা কোনও ধাপ নেই। আপনি -c edge বিকল্প উল্লেখ করলে এটি আপডেট করা হয়।

১-নোড স্ট্যান্ডঅ্যালোন আপগ্রেড

1-নোড স্ট্যান্ডঅ্যালোন কনফিগারেশনকে 4.53.01-এ আপগ্রেড করতে:

  1. সব কম্পোনেন্ট আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (আপনি apigee-adminapi ইনস্টল করে থাকলে) apigee-adminapi ইউটিলিটি আপডেট করুন: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

২-নোড স্ট্যান্ডঅ্যালোন আপগ্রেড

২-নোড স্ট্যান্ডঅলোন ইনস্টলেশনের জন্য নিম্নলিখিত কম্পোনেন্ট আপডেট করুন:

Edge টপোলজি ও নোড নম্বরের তালিকা পেতে ইনস্টলেশন টপোলজি দেখুন।

  1. মেশিন ১-এ LDAP আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  2. মেশিন ১-এ Cassandra ও ZooKeeper আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. মেশিন ১-এ Edge কম্পোনেন্ট আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. মেশিন ২-এ Postgres আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. মেশিন ১-এ Edge কম্পোনেন্ট আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. মেশিন ২-এ Qpid আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. মেশিন ১-এ UI আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. (আপনি apigee-adminapi ইনস্টল করে থাকলে) মেশিন ১-এ apigee-adminapi ইউটিলিটি আপডেট করুন: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (আপনি Apigee SSO ইনস্টল করে থাকলে) মেশিন ১-এ Apigee SSO আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    যেখানে sso_config_file হল সেই কনফিগারেশন ফাইল যা আপনি SSO ইনস্টল করার সময় তৈরি করেছেন।

  10. মেশিন ১-এ Edge UI কম্পোনেন্ট রিস্টার্ট করুন: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

৫-নোড আপগ্রেড

৫-নোড ইনস্টলেশনের জন্য নিম্নলিখিত কম্পোনেন্ট আপডেট করুন:

Edge টপোলজি ও নোড নম্বরের তালিকা পেতে ইনস্টলেশন টপোলজি দেখুন।

  1. মেশিন ১-এ LDAP আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  2. মেশিন ১, ২ ও ৩-এ Cassandra ও ZooKeeper আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. মেশিন ১, ২, ৩-এ Edge কম্পোনেন্ট আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. মেশিন ৪-এ Postgres আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. মেশিন ৫-এ Postgres আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  6. মেশিন ৪, ৫-এ Edge কম্পোনেন্ট আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. মেশিন ৪-এ Qpid আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. মেশিন ৫-এ Qpid আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  9. Edge UI আপডেট করুন:
    • ক্লাসিক UI: আপনি ক্লাসিক UI ব্যবহার করলে, মেশিন ১-এ ui কম্পোনেন্ট আপডেট করুন, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • নতুন Edge UI: আপনি নতুন Edge UI ইনস্টল করে থাকলে, উপযুক্ত মেশিনে (মেশিন ১ নাও হতে পারে) ue কম্পোনেন্ট আপডেট করুন: 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  10. (আপনি apigee-adminapi ইনস্টল করে থাকলে) মেশিন ১-এ apigee-adminapi ইউটিলিটি আপডেট করুন: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  11. (আপনি Apigee SSO ইনস্টল করে থাকলে) মেশিন ১-এ Apigee SSO আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    যেখানে sso_config_file হল সেই কনফিগারেশন ফাইল যা আপনি SSO ইনস্টল করার সময় তৈরি করেছেন।

  12. UI কম্পোনেন্ট রিস্টার্ট করুন:
    • ক্লাসিক UI: আপনি ক্লাসিক UI ব্যবহার করলে, মেশিন ১-এ edge-ui কম্পোনেন্ট রিস্টার্ট করুন, যেমন নিম্নলিখিত উদাহরণে দেখানো হয়েছে: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • নতুন Edge UI: আপনি নতুন Edge UI ইনস্টল করে থাকলে, উপযুক্ত মেশিনে edge-management-ui কম্পোনেন্ট রিস্টার্ট করুন (এটি মেশিন ১ নাও হতে পারে): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

৯-নোড ক্লাস্টারড আপগ্রেড

৯-নোড ক্লাস্টার ইনস্টলেশনের জন্য নিম্নলিখিত কম্পোনেন্ট আপডেট করুন:

Edge টপোলজি ও নোড নম্বরের তালিকা পেতে ইনস্টলেশন টপোলজি দেখুন।

  1. মেশিন ১-এ LDAP আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  2. মেশিন ১, ২ ও ৩-এ Cassandra ও ZooKeeper আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. মেশিন ১, ৪ ও ৫-এ Edge কম্পোনেন্ট (ম্যানেজমেন্ট সার্ভার, মেসেজ প্রসেসর, রাউটার) এই ক্রমে আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. মেশিন ৮-এ Postgres আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. মেশিন ৯-এ Postgres আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  6. ৬, ৭, ৮ ও ৯ নম্বর মেশিনে Edge কম্পোনেন্ট এই ক্রমে আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. মেশিন ৬ ও ৭-এ Qpid আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. মেশিন ১-এ নতুন UI (ue) বা ক্লাসিক UI (ui) আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  9. (আপনি apigee-adminapi ইনস্টল করে থাকলে) মেশিন ১-এ apigee-adminapi ইউটিলিটি আপডেট করুন: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (আপনি Apigee SSO ইনস্টল করে থাকলে) মেশিন ১-এ Apigee SSO আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    যেখানে sso_config_file হল সেই কনফিগারেশন ফাইল যা আপনি SSO ইনস্টল করার সময় তৈরি করেছেন।

  11. UI কম্পোনেন্ট রিস্টার্ট করুন:
    • ক্লাসিক UI: আপনি ক্লাসিক UI ব্যবহার করলে, মেশিন ১-এ edge-ui কম্পোনেন্ট রিস্টার্ট করুন, যেমন নিম্নলিখিত উদাহরণে দেখানো হয়েছে: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • নতুন Edge UI: আপনি নতুন Edge UI ইনস্টল করে থাকলে, উপযুক্ত মেশিনে edge-management-ui কম্পোনেন্ট রিস্টার্ট করুন (এটি মেশিন ১ নাও হতে পারে): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

১৩-নোড ক্লাস্টারড আপগ্রেড

১৩-নোড ক্লাস্টার ইনস্টলেশনের জন্য নিম্নলিখিত কম্পোনেন্ট আপডেট করুন:

Edge টপোলজি ও নোড নম্বরের তালিকা পেতে ইনস্টলেশন টপোলজি দেখুন।

  1. মেশিন ৪ ও ৫-এ LDAP আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  2. মেশিন ১, ২ ও ৩-এ Cassandra ও ZooKeeper আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. ৬, ৭, ১০ ও ১১ নম্বর মেশিনে এই ক্রম অনুযায়ী Edge কম্পোনেন্ট আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. মেশিন ৮-এ Postgres আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. মেশিন ৯-এ Postgres আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  6. এই ক্রমে মেশিন ১২, ১৩, ৮ ও ৯-এ Edge কম্পোনেন্ট আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. মেশিন ১২ ও ১৩-এ Qpid আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. মেশিন ৬ ও ৭-এ নতুন UI (ue) অথবা ক্লাসিক UI (ui) আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  9. (আপনি apigee-adminapi ইনস্টল করে থাকলে) মেশিন ৬ ও ৭-এ apigee-adminapi ইউটিলিটি আপডেট করা হয়েছে: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (আপনি Apigee SSO ইনস্টল করে থাকলে) ৬ ও ৭ নম্বর মেশিনে Apigee SSO আপডেট করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    যেখানে sso_config_file হল সেই কনফিগারেশন ফাইল যা আপনি SSO ইনস্টল করার সময় তৈরি করেছেন।

  11. UI কম্পোনেন্ট রিস্টার্ট করুন:
    • ক্লাসিক UI: আপনি ক্লাসিক UI ব্যবহার করলে, মেশিন ৬ ও ৭-এ edge-ui কম্পোনেন্ট রিস্টার্ট করুন, যেমন নিম্নলিখিত উদাহরণে দেখানো হয়েছে: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • নতুন Edge UI: আপনি নতুন Edge UI ইনস্টল করে থাকলে, মেশিন ৬ ও ৭-এ edge-management-ui কম্পোনেন্ট রিস্টার্ট করুন: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

১২-নোড ক্লাস্টার আপগ্রেড

১২-নোড ক্লাস্টার ইনস্টলেশনের জন্য নিম্নলিখিত কম্পোনেন্ট আপডেট করুন:

Edge টপোলজি ও নোড নম্বরের তালিকা পেতে ইনস্টলেশন টপোলজি দেখুন।

  1. LDAP আপডেট করুন:
    1. ডেটা সেন্টার ১-এ মেশিন ১ 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. ডেটা সেন্টার ২-এ মেশিন ৭ 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  2. Cassandra ও ZooKeeper আপডেট করুন:
    1. ডেটা সেন্টার ১-এ মেশিন ১, ২ ও ৩: 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. ডেটা সেন্টার ২-এর ৭, ৮ ও ৯ নম্বর মেশিনে: 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Edge কম্পোনেন্ট আপডেট করা:
    1. ডেটা সেন্টার ১-এর মেশিন ১, ২ ও ৩-এ: 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. ডেটা সেন্টার ২-এর ৭, ৮ ও ৯ নম্বর মেশিনে 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. Postgres আপডেট করুন:
    1. ডেটা সেন্টার ১-এ মেশিন ৬ 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. ডেটা সেন্টার ২-এর মেশিন ১২ 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. Edge কম্পোনেন্ট আপডেট করা:
    1. ডেটা সেন্টার ১-এ মেশিন ৪, ৫, ৬ 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. ডেটা সেন্টার ২-এ মেশিন ১০, ১১, ১২ 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. qpidd আপডেট করুন:
    1. ডেটা সেন্টার ১-এ মেশিন ৪, ৫
      1. মেশিন ৪-এ qpidd আপডেট করুন: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. মেশিন ৫-এ qpidd আপডেট করুন: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. মেশিন ১০, ১১, ডেটা সেন্টার ২-এ
      1. মেশিন ১০-এ qpidd আপডেট করুন: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. মেশিন ১১-এ qpidd আপডেট করুন: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. নতুন UI (ue) বা ক্লাসিক UI (ui) আপডেট করুন:
    1. ডেটা সেন্টার ১-এ মেশিন ১: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. ডেটা সেন্টার ২-এর মেশিন ৭: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (আপনি apigee-adminapi ইনস্টল করে থাকলে) apigee-adminapi ইউটিলিটি আপডেট করা হয়েছে:
    1. ডেটা সেন্টার ১-এ মেশিন ১: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. ডেটা সেন্টার ২-এর মেশিন ৭: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (আপনি Apigee SSO ইনস্টল করে থাকলে) Apigee SSO আপডেট করুন:
    1. ডেটা সেন্টার ১-এ মেশিন ১: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. ডেটা সেন্টার ২-এর মেশিন ৭: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

      3. যেখানে sso_config_file হল সেই কনফিগারেশন ফাইল যা আপনি SSO ইনস্টল করার সময় তৈরি করেছেন।

  10. মেশিন ১ ও ৭-এ নতুন Edge UI (edge-management-ui) বা ক্লাসিক Edge UI (edge-ui) কম্পোনেন্ট রিস্টার্ট করুন: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

অপ্রচলিত কনফিগারেশনের জন্য

আপনার যদি কোনও নন-স্ট্যান্ডার্ড কনফিগারেশন থাকে, তাহলে নিম্নলিখিত ক্রম অনুসারে Edge কম্পোনেন্ট আপডেট করুন:

  1. LDAP
  2. Cassandra
  3. চিড়িয়াখানার কর্মী
  4. ম্যানেজমেন্ট সার্ভার
  5. মেসেজ প্রসেসর
  6. রাউটার
  7. Postgres
  8. Edge, অর্থাৎ সব নোডে "-c edge" প্রোফাইল এই ক্রমে: Qpid সার্ভার সহ নোড, Edge Postgres সার্ভার।
  9. qpidd
  10. Edge UI (ক্লাসিক বা নতুন)
  11. apigee-adminapi
  12. Apigee SSO

আপডেট করা হয়ে গেলে, Edge UI কম্পোনেন্ট সব মেশিনে রিস্টার্ট করতে ভুলবেন না যেগুলিতে এটি রান করছে।