রোল ব্যাক Apigee Edge 4.53.01

আপনি যদি এজ 4.53.01-এ একটি আপডেটের সময় একটি ত্রুটির সম্মুখীন হন, আপনি ত্রুটির কারণ হওয়া উপাদানটিকে ফিরিয়ে আনতে পারেন এবং তারপরে আবার আপডেটের চেষ্টা করুন৷

আপনি এজ 4.53.01 কে নিচের যে কোন বড় রিলিজ সংস্করণে রোল ব্যাক করতে পারেন:

  • সংস্করণ 4.53.00
  • সংস্করণ 4.52.02

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

সংস্করণে রোলব্যাক সফটওয়্যারের জন্য বিশেষ বিবেচনা
4.53.00 চিড়িয়াখানা , পোস্টগ্রেস , এলডিএপি
৪.৫২.০২ চিড়িয়াখানা , ক্যাসান্দ্রা , পোস্টগ্রেস , এলডিএপি

এখানে একটি দৃশ্যকল্প যেখানে আপনি একটি রোলব্যাক করতে চাইতে পারেন:

আগের বড় বা ছোট রিলিজে ফিরে যান । উদাহরণস্বরূপ, 4.53.01 থেকে 4.53.00 পর্যন্ত।

আরও তথ্যের জন্য, Apigee Edge রিলিজ প্রক্রিয়া দেখুন।

রোলব্যাক অর্ডার

কম্পোনেন্টগুলির রোলব্যাক করা উচিত বিপরীত ক্রমে সেগুলি আপগ্রেড করা হয়েছে, ব্যতীত ম্যানেজমেন্ট সার্ভারগুলি ক্যাসান্দ্রার পরে রোলব্যাক করা উচিত। প্রাইভেট ক্লাউড 4.53.01 এর জন্য রোলব্যাকের একটি সাধারণ সাধারণ অর্ডার নীচের মত দেখাবে:

  1. রোলব্যাক Qpid, অন্যান্য বিশ্লেষণ-সম্পর্কিত উপাদান এবং পোস্টগ্রেস।
  2. রোলব্যাক রাউটার এবং বার্তা প্রসেসর
  3. রোলব্যাক ক্যাসান্দ্রা, চিড়িয়াখানা
  4. রোলব্যাক ম্যানেজমেন্ট সার্ভার
  5. রোলব্যাক LDAP

উদাহরণস্বরূপ, ধরা যাক আপনি সম্পূর্ণ ক্যাসান্ড্রা ক্লাস্টার, আপনার সমস্ত পরিচালনা সার্ভার এবং কয়েকটি আরএমপি সংস্করণ 4.52.02 থেকে 4.53.01 সংস্করণে আপগ্রেড করেছেন এবং রোলব্যাক করতে চান৷ এই ক্ষেত্রে, আপনি হবে:

  • এক এক করে সব RMP রোলব্যাক করুন
  • ব্যাকআপ ব্যবহার করে পুরো ক্যাসান্দ্রা ক্লাস্টার রোলব্যাক করুন
  • রোলব্যাক এজ ম্যানেজমেন্ট সার্ভার নোড একে একে

কে একটি রোলব্যাক সঞ্চালন করতে পারেন

যে ব্যবহারকারী একটি রোলব্যাক সম্পাদন করছেন সেই ব্যবহারকারীর মতোই হওয়া উচিত যিনি মূলত এজ আপডেট করেছেন, বা রুট হিসাবে চলমান ব্যবহারকারীর মতো।

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

সাধারণ কোড সহ উপাদান

নিম্নলিখিত এজ উপাদানগুলি সাধারণ কোড ভাগ করে। অতএব, একটি নোডে এই উপাদানগুলির যে কোনও একটিকে রোল ব্যাক করতে, আপনাকে অবশ্যই সেই নোডে থাকা এই সমস্ত উপাদানগুলিকে রোল ব্যাক করতে হবে।

  • edge-management-server (ম্যানেজমেন্ট সার্ভার)
  • edge-message-processor (মেসেজ প্রসেসর)
  • edge-router (রাউটার)
  • edge-postgres-server (Postgres সার্ভার)
  • edge-qpid-server (Qpid সার্ভার)

উদাহরণস্বরূপ, যদি আপনার নোডে ম্যানেজমেন্ট সার্ভার, রাউটার এবং মেসেজ প্রসেসর ইনস্টল করা থাকে, তবে তাদের যে কোনো একটিকে রোলব্যাক করতে আপনাকে অবশ্যই তিনটিই রোল ব্যাক করতে হবে।

ক্যাসান্দ্রার রোলব্যাক

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

রোলব্যাক দৃশ্যকল্প

Cassandra 4.0.X, প্রাইভেট ক্লাউড 4.53.01 এর জন্য এজ এর সাথে উপলব্ধ, প্রাইভেট ক্লাউড 4.52.02 এর অন্যান্য উপাদানগুলির সাথে সামঞ্জস্যপূর্ণ।

আপনি ব্যবহার করতে পারেন এমন বিভিন্ন রোলব্যাক কৌশলগুলির সংক্ষিপ্তসারের জন্য অনুগ্রহ করে নীচের টেবিলটি পড়ুন:

দৃশ্যকল্প রোলব্যাক কৌশল
একক ডিসি, কিছু ক্যাসান্দ্রা নোড আপগ্রেড করা হয়েছে ব্যাকআপ ব্যবহার করুন
একক ডিসি, সমস্ত ক্যাসান্দ্রা নোড আপগ্রেড করা হয়েছে ক্যাসান্দ্রাকে রোলব্যাক করবেন না। অন্যান্য উপাদান ফিরে পাকানো যেতে পারে.
একক ডিসি, সমস্ত নোড (ক্যাসান্ড্রা এবং অন্যান্য) আপগ্রেড করা হয়েছে ক্যাসান্দ্রাকে রোলব্যাক করবেন না। অন্যান্য উপাদান ফিরে পাকানো যেতে পারে.
একাধিক ডিসি, এক ডিসিতে কিছু নোড আপগ্রেড করা হয়েছে বিদ্যমান ডিসি থেকে পুনর্নির্মাণ
একাধিক ডিসি, কিছু ডিসি-তে সমস্ত ক্যাসান্দ্রা নোড আপগ্রেড করা হয়েছে বিদ্যমান ডিসি থেকে পুনর্নির্মাণ
একাধিক ডিসি, শেষ ডিসির ক্যাসান্দ্রা নোড আপগ্রেড করা হচ্ছে আপগ্রেড শেষ করার চেষ্টা করুন। যদি সম্ভব না হয়, ব্যাকআপ ব্যবহার করে 1 ডিসি রোলব্যাক করুন । রোলড-ব্যাক ডিসি থেকে অবশিষ্ট ডিসি পুনর্নির্মাণ করুন ।
একাধিক ডিসি, সমস্ত ক্যাসান্দ্রা নোড আপগ্রেড করা হয়েছে ক্যাসান্দ্রাকে রোলব্যাক করবেন না। অন্যান্য উপাদান ফিরে পাকানো যেতে পারে.
একাধিক ডিসি, সমস্ত নোড (ক্যাসান্ড্রা এবং অন্যান্য) আপগ্রেড করা হয়েছে ক্যাসান্দ্রাকে রোলব্যাক করবেন না। অন্যান্য উপাদান ফিরে পাকানো যেতে পারে.

সাধারণ বিবেচনা

একটি রোলব্যাক বিবেচনা করার সময়, নিম্নলিখিত মনে রাখবেন:

  • রানটাইম বা ম্যানেজমেন্ট কম্পোনেন্টের রোলব্যাক: আপনি যদি এজ-ম্যানেজমেন্ট-সার্ভার, এজ-মেসেজ-প্রসেসর, বা প্রাইভেট ক্লাউড সংস্করণ 4.52.02-এ যেকোন নন-ক্যাসান্ড্রা কম্পোনেন্ট রোলব্যাক করতে চান, তাহলে ক্যাসান্দ্রাকে রোলব্যাক না করার পরামর্শ দেওয়া হচ্ছে। প্রাইভেট ক্লাউড 4.53.00 এর সাথে পাঠানো ক্যাসান্দ্রা প্রাইভেট ক্লাউড 4.52.02-এর জন্য এজের সমস্ত নন-ক্যাসান্ড্রা উপাদানগুলির সাথে সামঞ্জস্যপূর্ণ। ক্যাসান্ড্রা 4.0.13 সংস্করণে থাকাকালীন আপনি এখানে তালিকাভুক্ত পদ্ধতি ব্যবহার করে নন-ক্যাসান্ড্রা উপাদানগুলি রোলব্যাক করতে পারেন।
  • পুরো ক্যাসান্দ্রা ক্লাস্টার 4.0.X-এ আপগ্রেড হওয়ার পরে রোলব্যাক: যদি ব্যক্তিগত ক্লাউড সংস্করণ 4.53.00-তে আপগ্রেড করার অংশ হিসাবে আপনার সম্পূর্ণ ক্যাসান্দ্রা ক্লাস্টার 4.0.X সংস্করণে আপগ্রেড করা হয়, তাহলে এটি সুপারিশ করা হয় যে আপনি এই ক্লাস্টার সেটআপটি চালিয়ে যান এবং ক্যাসান্দ্রাকে রোলব্যাক করবেন না৷ প্রাইভেট ক্লাউড সংস্করণ 4.52.02-এর এজ-ম্যানেজমেন্ট-সার্ভার, এজ-মেসেজ-প্রসেসর, এজ-রাউটার ইত্যাদি উপাদানগুলি ক্যাসান্দ্রা সংস্করণ 4.0.X এর সাথে সামঞ্জস্যপূর্ণ।
  • ক্যাসান্ড্রা আপগ্রেডের সময় ক্যাসান্দ্রার রোলব্যাক: ক্যাসান্দ্রা আপগ্রেড করার সময় আপনি যদি সমস্যার সম্মুখীন হন, আপনি একটি রোলব্যাক বিবেচনা করতে চাইতে পারেন। আপগ্রেড প্রক্রিয়া চলাকালীন আপনি যে অবস্থায় আছেন তার উপর ভিত্তি করে এই নিবন্ধে তালিকাভুক্ত রোলব্যাক কৌশলগুলি অনুসরণ করা যেতে পারে।
  • ব্যাকআপ ব্যবহার করে রোলব্যাক: Cassandra 4.0.X থেকে নেওয়া ব্যাকআপগুলি Cassandra 3.11.X এর ব্যাকআপগুলির সাথে সামঞ্জস্যপূর্ণ নয়৷ ব্যাকআপ পুনরুদ্ধার ব্যবহার করে ক্যাসান্দ্রাকে রোলব্যাক করতে, আপগ্রেড করার চেষ্টা করার আগে আপনাকে অবশ্যই ক্যাসান্দ্রা 3.11.X এর ব্যাকআপ নিতে হবে।

পুনঃনির্মাণ ব্যবহার করে রোলব্যাক ক্যাসান্দ্রা

পূর্বশর্ত

  • আপনি একাধিক ডেটা সেন্টার জুড়ে প্রাইভেট ক্লাউড 4.52.02 ক্লাস্টারের জন্য একটি এজ পরিচালনা করছেন।
  • আপনি Cassandra কে 3.11.X থেকে 4.0.X এ আপগ্রেড করার প্রক্রিয়ার মধ্যে আছেন এবং আপগ্রেড করার সময় সমস্যার সম্মুখীন হয়েছেন৷
  • আপনার ক্লাস্টারে কমপক্ষে একটি সম্পূর্ণ কার্যকরী ডেটা সেন্টার রয়েছে যা এখনও Cassandra (Cassandra 3.11.X) এর পুরানো সংস্করণ চালাচ্ছে৷

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

উচ্চ-স্তরের পদক্ষেপ

  1. একটি ডেটা সেন্টার নির্বাচন করুন (হয় আংশিকভাবে বা সম্পূর্ণরূপে আপগ্রেড করা হয়েছে) যা আপনি রোল ব্যাক করতে চান৷ রানটাইম ট্রাফিককে একটি ভিন্ন কার্যকরী ডেটা সেন্টারে ডাইভার্ট করুন।
  2. ডেটা সেন্টারে বীজ নোড সনাক্ত করুন এবং বীজ নোডগুলির একটি দিয়ে শুরু করুন।
  3. ক্যাসান্দ্রা নোড বন্ধ করুন, আনইনস্টল করুন এবং পরিষ্কার করুন।
  4. নোডে ক্যাসান্ড্রার পুরোনো সংস্করণটি ইনস্টল করুন এবং প্রয়োজন অনুসারে এটি কনফিগার করুন।
  5. পূর্বে যোগ করা অতিরিক্ত কনফিগারেশনগুলি সরান।
  6. ডেটা সেন্টারের সমস্ত বীজ নোডের জন্য উপরের ধাপগুলি এক এক করে পুনরাবৃত্তি করুন।
  7. ডেটা সেন্টারে সমস্ত অবশিষ্ট ক্যাসান্ড্রা নোডগুলির জন্য উপরের ধাপগুলি একের পর এক পুনরাবৃত্তি করুন৷
  8. বিদ্যমান কার্যকরী ডেটা সেন্টার থেকে এক এক করে নোডগুলি পুনর্নির্মাণ করুন।
  9. ক্যাসান্দ্রার সাথে সংযুক্ত ডেটা সেন্টারের সমস্ত প্রান্ত-* উপাদানগুলি পুনরায় চালু করুন।
  10. পরীক্ষা করুন এবং এই ডেটা সেন্টারে ট্রাফিক ফিরিয়ে আনুন।
  11. প্রতিটি ডেটা সেন্টারের জন্য এক এক করে ধাপগুলি পুনরাবৃত্তি করুন।

বিস্তারিত পদক্ষেপ

  1. একটি ডেটা সেন্টার বেছে নিন যেখানে সমস্ত বা কিছু ক্যাসান্দ্রা নোড আপগ্রেড করা হয়েছে। এই ডেটা সেন্টার থেকে সমস্ত রানটাইম প্রক্সি ট্র্যাফিক এবং ম্যানেজমেন্ট ট্রাফিক ডাইভার্ট করুন যখন এই ডেটা সেন্টারে ক্যাসান্ড্রা নোডগুলি রোল ব্যাক করা হচ্ছে৷ নোডগুলিতে nodetool ring কমান্ড কার্যকর করা হলে সমস্ত ক্যাসান্দ্রা নোডগুলি ইউএন (উপর/স্বাভাবিক) অবস্থায় রয়েছে তা নিশ্চিত করুন। যদি নির্দিষ্ট নোডগুলি ডাউন থাকে তবে সমস্যাটির সমাধান করুন এবং চালিয়ে যাওয়ার আগে সেই নোডগুলিকে ফিরিয়ে আনুন।

    নীচের উদাহরণ দেখুন:

    /opt/apigee/apigee-cassandra/bin/nodetool status
Datacenter: dc-1
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address      Load       Tokens       Owns (effective)  Host ID                               Rack
UN  DC1-1IP1  456.41 KiB  1            100.0%            78fc4ddd-2ed9-4a8c-98a2-63a38c2f1920  ra-1
UN  DC1-1IP2  870.93 KiB  1            100.0%            160db01a-64ab-43a7-b9ea-3b7f8f66d52b  ra-1
UN  DC1-1IP3  824.08 KiB  1            100.0%            21d61543-d59e-403a-bf5d-bfe7f664baa6  ra-1
Datacenter: dc-2
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address      Load       Tokens       Owns (effective)  Host ID                               Rack
UN  DC2-1IP1   802.08 KiB  1            100.0%            583e0576-336d-4ce7-9729-2ae74e0abde2  ra-1
UN  DC2-1IP2   844.4 KiB   1            100.0%            fef794d5-f4c2-4a4e-bb05-9adaeb4aea4b  ra-1
UN  DC2-1IP3   878.12 KiB  1            100.0%            3894b3d9-1f5a-444d-83db-7b1e338bbfc9  ra-1

    পুরো ক্লাস্টারের বর্তমান অবস্থা বোঝার জন্য আপনি নোডগুলিতে nodetool describecluster চালাতে পারেন। উদাহরণস্বরূপ, নিম্নলিখিতটি একটি 2-ডেটা-সেন্টার ক্লাস্টারের একটি উদাহরণ দেখায় যেখানে সমস্ত DC-1 নোডগুলি ক্যাসান্দ্রা সংস্করণ 4-এ রয়েছে, যেখানে সমস্ত DC-2 নোডগুলি ক্যাসান্দ্রা সংস্করণ 3-তে রয়েছে:

    # On nodes where Cassandra is upgraded
/opt/apigee/apigee-cassandra/bin/nodetool describecluster
Cluster Information:
    Name: Apigee
    Snitch: org.apache.cassandra.locator.PropertyFileSnitch
    DynamicEndPointSnitch: enabled
    Partitioner: org.apache.cassandra.dht.RandomPartitioner
    Schema versions:
        2eadcd74-0245-309a-9992-3625afa70038: [DC-1-IP1, DC-1-IP2, DC-1-IP3]
        129dc15e-198e-3c11-b64c-701044a3a1ad: [DC-2-IP1, DC-2-IP2, DC-2-IP3]

Stats for all nodes:
    Live: 6
    Joining: 0
    Moving: 0
    Leaving: 0
    Unreachable: 0

Data Centers:
    dc-1 #Nodes: 3 #Down: 0
    dc-2 #Nodes: 3 #Down: 0

Database versions:
    4.0.13: [DC-1-IP1:7000, DC-1-IP2:7000, DC-1-IP3:7000]
    3.11.16: [DC-2-IP1:7000, DC-2-IP2:7000, DC-2-IP3:7000]

Keyspaces:
    system_schema -> Replication class: LocalStrategy {}
    system -> Replication class: LocalStrategy {}
    auth -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    cache -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    devconnect -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    dek -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    user_settings -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    apprepo -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    kms -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    identityzone -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    audit -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    analytics -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    keyvaluemap -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    counter -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    apimodel_v2 -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    system_distributed -> Replication class: SimpleStrategy {replication_factor=3}
    system_traces -> Replication class: SimpleStrategy {replication_factor=2}
    system_auth -> Replication class: SimpleStrategy {replication_factor=1}

# On nodes where Cassandra is not upgraded
/opt/apigee/apigee-cassandra/bin/nodetool describecluster
Cluster Information:
    Name: Apigee
    Snitch: org.apache.cassandra.locator.PropertyFileSnitch
    DynamicEndPointSnitch: enabled
    Partitioner: org.apache.cassandra.dht.RandomPartitioner
    Schema versions:
        2eadcd74-0245-309a-9992-3625afa70038: [DC-1-IP1, DC-1-IP2, DC-1-IP3]
        129dc15e-198e-3c11-b64c-701044a3a1ad: [DC-2-IP1, DC-2-IP2, DC-2-IP3]
  2. ডেটা সেন্টারে বীজ নোডগুলি সনাক্ত করুন: পরিশিষ্টে বীজ নোডগুলি কীভাবে সনাক্ত করতে হয় সে বিভাগটি পড়ুন। বীজ নোডগুলির একটিতে নীচের পদক্ষেপগুলি সম্পাদন করুন:
  3. ক্যাসান্দ্রার নোড থেকে ডেটা থামান, আনইনস্টল করুন এবং পরিষ্কার করুন। এই ডেটা সেন্টারে ক্যাসান্দ্রা সংস্করণ 4-এ প্রথম বীজ নোডটি বেছে নিন। এটা বন্ধ করুন। 
    # Stop Cassandra service on the node
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

# Uninstall Cassandra software
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall

# Wipe out Cassandra data
rm -rf /opt/apigee/data/apigee-cassandra
  4. নোডে পুরানো ক্যাসান্ড্রা সফ্টওয়্যার ইনস্টল করুন এবং কিছু কনফিগারেশন সেট করুন। প্রাইভেট ক্লাউড 4.52.02 এর জন্য এজের বুটস্ট্র্যাপ ফাইলটি চালান। 
    5. # Download bootstrap of 4.52.02
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh -u uName:pWord

# Execute bootstrap of 4.52.02
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
  5. /opt/apigee/customer/application/cassandra.properties ফাইলটি তৈরি বা সম্পাদনা করুন।
  6. ফাইলে নিম্নলিখিত বিষয়বস্তু যোগ করুন। ipOfNode হল নোডের IP ঠিকানা যা Cassandra অন্যান্য Cassandra নোডের সাথে যোগাযোগ করতে ব্যবহার করে: 
    conf_jvm_options_custom_settings=-Dcassandra.replace_address=ipOfNode -Dcassandra.allow_unsafe_replace=true
  7. নিশ্চিত করুন যে ফাইলটি এপিজি ব্যবহারকারীর মালিকানাধীন এবং পাঠযোগ্য: 
    chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
  8. ক্যাসান্দ্রা ইনস্টল এবং সেট আপ করুন: 
    9. # Install cassandra version 3.11.X
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install
# Setup cassandra while passing standard configuration file
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile
# Ensure Cassandra version is correct and service is running
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra version
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra status
  9. নোড শুরু হয়েছে তা যাচাই করুন। এই নোড এবং ক্লাস্টারের অন্যান্য নোডগুলিতে নিম্নলিখিত কমান্ডটি পরীক্ষা করুন। নোডের রিপোর্ট করা উচিত যে এটি "UN" (আপ/স্বাভাবিক) অবস্থায় রয়েছে: 
    /opt/apigee/apigee-cassandra/bin/nodetool status
  10. /opt/apigee/customer/application/cassandra.properties ফাইল থেকে আগে যোগ করা অতিরিক্ত কনফিগারেশনগুলি সরান।
  11. ডাটা সেন্টারের সমস্ত ক্যাসান্ড্রা বীজ নোডগুলিতে একের পর এক ধাপ 3 থেকে 10 পুনরাবৃত্তি করুন।
  12. ডেটা সেন্টারের সমস্ত অবশিষ্ট ক্যাসান্ড্রা নোডগুলিতে 3 থেকে 10 ধাপগুলি পুনরাবৃত্তি করুন, একে একে।
  13. পুরানো Cassandra সংস্করণ চলমান একটি ডেটা সেন্টার থেকে ডেটা সেন্টারের সমস্ত নোড পুনর্নির্মাণ করুন। এই ধাপটি একবারে একটি নোড সম্পাদন করুন:
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -dc <name of working DC>

    এই পদ্ধতিতে সময় লাগতে পারে। প্রয়োজনে আপনি streamingthroughput সামঞ্জস্য করতে পারেন। অপারেশন সমাপ্তির স্থিতির জন্য nodetool netstats পরীক্ষা করুন।

  14. (ঐচ্ছিক) যদি ডেটা পুনর্নির্মাণ না হয় তবে ক্যাসান্দ্রা নোডে মেরামত কমান্ডটি চালান। 
    /opt/apigee/apigee-cassandra/bin/nodetool -h node-IP repair -pr
  15. এক এক করে ডেটা সেন্টারের সমস্ত প্রান্ত-* উপাদানগুলি পুনরায় চালু করুন: 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
  16. যাচাই করুন এবং এই ডেটা সেন্টারে ট্রাফিক ফিরিয়ে আনুন। এই ডেটা সেন্টারে রানটাইম ট্র্যাফিক এবং ম্যানেজমেন্ট API-এর জন্য কিছু বৈধতা চালান এবং প্রক্সি এবং ম্যানেজমেন্ট API ট্র্যাফিককে এটিতে ফেরত পাঠানো শুরু করুন।
  17. আপনি রোল ব্যাক করতে চান প্রতিটি ডেটা সেন্টারের জন্য উপরের ধাপগুলি পুনরাবৃত্তি করুন।

ব্যাকআপ ব্যবহার করে রোলব্যাক ক্যাসান্দ্রা

পূর্বশর্ত

  1. আপনি Cassandra কে 3.11.X থেকে 4.0.X এ আপগ্রেড করার প্রক্রিয়ার মধ্যে আছেন এবং আপগ্রেড করার সময় সমস্যার সম্মুখীন হয়েছেন৷
  2. আপনি যে নোডটি ফিরিয়ে আনছেন তার জন্য আপনার কাছে ব্যাকআপ রয়েছে। 3.11.X থেকে 4.0.X পর্যন্ত আপগ্রেড করার চেষ্টা করার আগে ব্যাকআপ নেওয়া হয়েছিল৷

ধাপ

  1. আপনি রোল ব্যাক করতে চান একটি নোড নির্বাচন করুন. আপনি যদি ব্যাকআপ ব্যবহার করে ডেটা সেন্টারে সমস্ত নোডগুলিকে রোলব্যাক করে থাকেন তবে প্রথমে বীজ নোডগুলি দিয়ে শুরু করুন৷ পরিশিষ্টে "কীভাবে বীজ নোড সনাক্ত করতে হয়" বিভাগটি পড়ুন।

  2. ক্যাসান্ড্রা নোড বন্ধ করুন, আনইনস্টল করুন এবং পরিষ্কার করুন: 

    # Stop Cassandra service on the node
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

# Uninstall Cassandra software
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall

# Wipe Cassandra data
rm -rf /opt/apigee/data/apigee-cassandra

  3. নোডে পুরানো ক্যাসান্ড্রা সফ্টওয়্যার ইনস্টল করুন এবং এটি কনফিগার করুন:

    • প্রাইভেট ক্লাউড 4.52.02 এর জন্য এজের বুটস্ট্র্যাপ ফাইলটি চালান: 
      • # Download bootstrap for 4.52.02
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh -u ‘uName:pWord’

# Execute bootstrap for 4.52.02
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
    • ফাইল তৈরি বা সম্পাদনা করুন /opt/apigee/customer/application/cassandra.properties : 
      • conf_jvm_options_custom_settings=-Dcassandra.replace_address=ipOfNode -Dcassandra.allow_unsafe_replace=true
    • নিশ্চিত করুন যে ফাইলটি এপিজি ব্যবহারকারীর মালিকানাধীন এবং পাঠযোগ্য: 
      • chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
    • ক্যাসান্দ্রা ইনস্টল এবং সেট আপ করুন: 
      • # Install Cassandra version 3.11.X
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install

# Set up Cassandra with the standard configuration file
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile

# Verify Cassandra version and check service status
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra version
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra status

    নোড শুরু হয়েছে তা যাচাই করুন। এই নোড এবং ক্লাস্টারের অন্যান্য নোডগুলিতে নিম্নলিখিত কমান্ডটি পরীক্ষা করুন। নোডগুলিকে রিপোর্ট করা উচিত যে এই নোডটি "UN" অবস্থায় রয়েছে: 

    /opt/apigee/apigee-cassandra/bin/nodetool status

  4. ক্যাসান্দ্রা পরিষেবা বন্ধ করুন এবং ব্যাকআপ পুনরুদ্ধার করুন। আরো বিস্তারিত জানার জন্য ব্যাকআপ এবং পুনরুদ্ধার ডকুমেন্টেশন পড়ুন: 

    # Stop Cassandra service on the node
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

# Wipe the data directory in preparation for restore
rm -rf /opt/apigee/data/apigee-cassandra/data

# Restore the backup taken before the upgrade attempt
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backupFile

  5. একবার ব্যাকআপ পুনরুদ্ধার করা হলে, অতিরিক্ত কনফিগারেশনগুলি সরান:

    /opt/apigee/customer/application/cassandra.properties ফাইল থেকে আগে যোগ করা কনফিগারেশন সরান।

  6. নোডে ক্যাসান্ড্রা পরিষেবা শুরু করুন: 

    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start

  7. প্রতিটি ক্যাসান্ড্রা নোডের ধাপগুলি পুনরাবৃত্তি করুন যা আপনি ব্যাকআপ ব্যবহার করে রোল ব্যাক করতে চান, একবারে একটি।

  8. একবার সমস্ত ক্যাসান্ড্রা নোড পুনরুদ্ধার করা হলে, সমস্ত প্রান্ত-* উপাদানগুলি একে একে পুনরায় চালু করুন: 

    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

ব্যাকআপ অপ্টিমাইজেশান (উন্নত বিকল্প)

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

পরিশিষ্ট

কিভাবে বীজ নোড সনাক্ত করতে হয়

একটি ডাটা সেন্টারের যেকোনো ক্যাসান্ড্রা নোডে, নিম্নলিখিত কমান্ডটি চালান: 

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure -search conf_cassandra_seeds

কমান্ডটি একাধিক লাইন আউটপুট করবে। আউটপুট শেষ লাইন জন্য দেখুন. শেষ লাইনে তালিকাভুক্ত IP ঠিকানাগুলি হল বীজ নোড। নীচের উদাহরণে, DC-1-IP1 , DC-1-IP2 , DC-2-IP1 , এবং DC-2-IP2 হল বীজ নোড আইপি: 

Found key conf_cassandra_seeds, with value, "127.0.0.1", in /opt/apigee/apigee-cassandra/token/default.properties

Found key conf_cassandra_seeds, with value, 127.0.0.1, in /opt/apigee/apigee-cassandra/token/application/cassandra.properties

Found key conf_cassandra_seeds, with value, "DC-1-IP1, DC-1-IP2, DC-2-IP1, DC-2-IP2", in /opt/apigee/token/application/cassandra.properties
apigee-configutil: apigee-cassandra: # OK

Zookeeper 3.8.4 আপডেট রোলব্যাক করুন

রোলব্যাক

যদি একটি রোলব্যাক প্রয়োজন হয়:

  1. প্রথমে পর্যবেক্ষক এবং অনুসরণকারীদের উপর রোলব্যাক পদক্ষেপগুলি সম্পাদন করুন৷
  2. আপনি যে সংস্করণে ফিরে আসছেন তার বুটস্ট্র্যাপ ডাউনলোড করুন এবং চালান—হয় 4.52.02 বা 4.53.00। নোডের একটি বাহ্যিক ইন্টারনেট সংযোগ আছে বা আপনি অফলাইন ইনস্টলেশন অনুসরণ করছেন কিনা তার উপর নির্ভর করে প্রক্রিয়াটি সম্ভবত পরিবর্তিত হবে।
  3. Zookeeper বন্ধ করুন যদি এটি নোডে চলছে: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
  4. বিদ্যমান চিড়িয়াখানা আনইনস্টল করুন: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall
  5. যথারীতি জুকিপার ইনস্টল করুন: 
      /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>
  6. একবার সমস্ত অনুগামী এবং পর্যবেক্ষকদের রোল ব্যাক করা হয়ে গেলে, লিডার নোডে 2 থেকে 5 ধাপ অনুসরণ করে লিডার নোডটিকে রোল ব্যাক করুন।
  7. সমস্ত নোড রোল ব্যাক করার পরে, ক্লাস্টারের স্বাস্থ্য যাচাই করুন এবং নিশ্চিত করুন যে ক্লাস্টারে একটি লিডার নোড আছে।

ব্যাকআপ পুনরুদ্ধার করুন

একটি ব্যাকআপ থেকে পুনরুদ্ধার পড়ুন। মনে রাখবেন যে প্রাইভেট ক্লাউডের জন্য এজ-এর আগের সংস্করণগুলি যেমন 4.52.02 বা 4.53.00 থেকে নেওয়া Zookeeper-এর ব্যাকআপগুলি প্রাইভেট ক্লাউড 4.53.01-এর জন্য এজ-এর Zookeeper সংস্করণের সাথে সামঞ্জস্যপূর্ণ হওয়া উচিত।

Postgres 17 আপডেটটি রোল ব্যাক করুন

আপনি যদি 4.52.02 বা 4.53.00 সংস্করণ থেকে 4.53.01 এ আপগ্রেড করেন, তাহলে এজ উপাদানগুলি ছাড়াও আপনাকে অবশ্যই আপনার পোস্টগ্রেস আপডেটটি রোল ব্যাক করতে হবে।

একটি মাস্টার-স্ট্যান্ডবাই কনফিগারেশনে Postgres আপডেট করার সময় Postgres আপডেট রোলব্যাক করতে:

  • পোস্টগ্রেস মাস্টার হওয়ার জন্য নতুন স্ট্যান্ডবাই নোডকে প্রচার করুন। নতুন পোস্টগ্রেস মাস্টার আপনার আগের এজ ইনস্টলেশনের মতো একই সংস্করণ হবে।
  • পুরানো স্ট্যান্ডবাই নোডটিকে নতুন মাস্টারের স্ট্যান্ডবাই নোড হিসাবে কনফিগার করুন। পুরানো স্ট্যান্ডবাই নোডটি আপনার আগের এজ ইনস্টলেশনের মতো একই সংস্করণ হবে।
  • বিশ্লেষণ এবং ভোক্তা গোষ্ঠীর সাথে নতুন মাস্টার এবং স্ট্যান্ডবাই নোড নিবন্ধন করুন।

যখন আপনি রোলব্যাকটি সম্পন্ন করেন, পুরানো মাস্টার নোডের আর প্রয়োজন হবে না। তারপর আপনি পুরানো মাস্টার নোড ডিকমিশন করতে পারেন।

আপনি শুরু করার আগে

একটি রোলব্যাক পোস্টগ্রেস 17 থেকে 14 করার আগে, apigee-postgresql এ max_locks_per_transaction বৈশিষ্ট্য আপডেট করতে, নতুন স্ট্যান্ডবাই হোস্ট এবং পুরানো স্ট্যান্ডবাই উভয় ক্ষেত্রেই নিম্নলিখিত পদক্ষেপগুলি করুন:

  1. উপস্থিত না থাকলে, /opt/apigee/customer/application/postgresql.properties ফাইল তৈরি করুন
  2. এই ফাইলের মালিকানা এপিজিতে পরিবর্তন করুন: 
    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
  1. নিশ্চিত করুন যে নতুন স্ট্যান্ডবাই পোস্টগ্রেস নোড চলছে:
    /opt/apigee/apigee-service/bin/apigee-all status

    Postgres চলমান না হলে, এটি শুরু করুন: 

    /opt/apigee/apigee-service/bin/apigee-all start
  2. পুরানো মাস্টার নোড এবং পুরানো স্ট্যান্ডবাই নোডে পোস্টগ্রেস বন্ধ করা হয়েছে তা নিশ্চিত করুন:
    /opt/apigee/apigee-service/bin/apigee-all status

    Postgres চলমান থাকলে, এটি বন্ধ করুন: 

    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop  
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
  3. ইনস্টল করা থাকলে, পুরানো স্ট্যান্ডবাই নোডে Qpid শুরু করুন: 
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
  4. পোস্টগ্রেস মাস্টার হিসাবে নতুন স্ট্যান্ডবাই নোডকে প্রচার করুন:
    1. নতুন মাস্টার হতে নতুন স্ট্যান্ডবাই নোডকে প্রচার করুন:
      apigee-service apigee-postgresql promote-standby-to-master old_master_IP

      অনুরোধ করা হলে, 'apigee' ব্যবহারকারীর জন্য Postgres পাসওয়ার্ড লিখুন, যা ডিফল্ট "postgres"।

    2. নিম্নলিখিতগুলি নির্দিষ্ট করতে আপনি যে কনফিগার ফাইলটি এজ এর বর্তমান সংস্করণ ইনস্টল করতে ব্যবহার করেছিলেন তা সম্পাদনা করুন: 
      # IP address of the new master:
PG_MASTER=new_standby_IP
# IP address of the old standby node
PG_STANDBY=old_standby_IP
    3. নতুন মাস্টার কনফিগার করুন: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile
  5. আপনি যদি ইতিমধ্যেই পুরানো স্ট্যান্ডবাই নোডটিকে নতুন সংস্করণে আপগ্রেড করে থাকেন তবে আপনাকে অবশ্যই প্রথমে পুরানো স্ট্যান্ডবাই নোডে Apigee সফ্টওয়্যারটি ডাউনগ্রেড করতে হবে৷ আপনার যদি এখনও পুরানো স্ট্যান্ডবাই নোডে পুরানো সংস্করণ থাকে তবে আপনি এই ধাপটি এড়িয়ে যেতে পারেন এবং ধাপ 6 দিয়ে চালিয়ে যেতে পারেন।
    1. পুরানো স্ট্যান্ডবাই নোডে পোস্টগ্রেস বন্ধ করুন: 
      apigee-service apigee-postgresql stop
apigee-service edge-postgres-server stop
    2. পুরানো স্ট্যান্ডবাই নোড থেকে পোস্টগ্রেস আনইনস্টল করুন: 
      apigee-service apigee-postgresql uninstall
apigee-service edge-postgres-server uninstall
    3. পুরানো স্ট্যান্ডবাই নোড থেকে Postgres ডেটা ডিরেক্টরি মুছুন: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
    4. পুরানো স্ট্যান্ডবাই নোডে পুরানো সংস্করণ বুটস্ট্র্যাপ (আপনি যে অ্যাপিজি সংস্করণে ফিরে আসছেন তার জন্য) ডাউনলোড করুন এবং চালান। আপনি ইন্টারনেট ভিত্তিক বা অফলাইন ইনস্টলেশন ব্যবহার করছেন কিনা তার উপর ভিত্তি করে সঠিক পদক্ষেপগুলি পরিবর্তিত হতে পারে। পুরানো সংস্করণ Apigee বুটস্ট্র্যাপ চালানো পুরানো সংস্করণ Apigee ডেটা সহ yum সংগ্রহস্থল সেট আপ করবে।
    5. পুরানো স্ট্যান্ডবাই নোডে Postgres উপাদান সেট আপ করুন: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. চেক করুন এবং যাচাই করুন যে পুরানো স্ট্যান্ডবাই নোডে পোস্টগ্রেস উপাদানগুলি পুরানো সংস্করণে ফিরিয়ে আনা হয়েছে: 
      apigee-service apigee-postgresql version
apigee-service edge-postgres-server version
  6. পুরানো স্ট্যান্ডবাই নোড পুনর্নির্মাণ করুন:
    1. নিম্নলিখিতগুলি নির্দিষ্ট করতে আপনি যে কনফিগার ফাইলটি এজ এর বর্তমান সংস্করণ ইনস্টল করতে ব্যবহার করেছিলেন তা সম্পাদনা করুন: 
      # IP address of the new master:
PG_MASTER=new_standby_IP
# IP address of the old standby node
PG_STANDBY=old_standby_IP
    2. পুরানো স্ট্যান্ডবাই নোডে ডেটা ডিরেক্টরি সরান: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
    3. পুরানো স্ট্যান্ডবাই নোডটিকে নতুন মাস্টারের স্ট্যান্ডবাই নোড হতে পুনরায় কনফিগার করুন: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    4. নিশ্চিত করুন পোস্টগ্রেস পুরানো স্ট্যান্ডবাই নোডে চলছে:
      /opt/apigee/apigee-service/bin/apigee-all status

      Postgres চলমান না হলে, এটি শুরু করুন: 

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
  7. নতুন মাস্টারে /opt/apigee/apigee-postgresql/conf/pg_hba.conf ফাইলটি দেখে নতুন স্ট্যান্ডবাই নোড যোগ করা হয়েছে কিনা তা যাচাই করুন।
  8. ম্যানেজমেন্ট সার্ভারে নিম্নলিখিত কমান্ডটি চালিয়ে বর্তমান বিশ্লেষণ এবং ভোক্তা গোষ্ঠীর তথ্য দেখুন:
    curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

    এই কমান্ডটি name ক্ষেত্রে বিশ্লেষণ গোষ্ঠীর নাম এবং consumer-groups অধীনে name ক্ষেত্রের ভোক্তা গোষ্ঠীর নাম প্রদান করে। এটি postgres-server ফিল্ডে এবং datastores ফিল্ডে পুরানো পোস্টগ্রেস মাস্টার এবং স্ট্যান্ডবাই নোডগুলির UUID ফেরত দেয়। আপনি ফর্মে আউটপুট দেখতে হবে: 

    {
  "name" : "axgroup-001",
  "properties" : {
  },
  "scopes" : [ "VALIDATE~test", "sgilson~prod" ],
  "uuids" : {
    "qpid-server" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
    "postgres-server" : [
      "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256"
    ]
  },
  "consumer-groups" : [ {
    "name" : "consumer-group-001",
    "consumers" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
    "datastores" :
      [ "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256" ],
      "properties" : {     }
    }
  ],
  "data-processors" : {
  }
}
  9. পুরানো মাস্টার নোডে নিম্নলিখিত curl কমান্ডটি চালিয়ে পুরানো মাস্টারের UUID ঠিকানা পান:
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    আপনি আউটপুট শেষে নোডের UUID দেখতে হবে, ফর্মটিতে: 

    "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  10. পুরানো স্ট্যান্ডবাই নোড এবং নতুন মাস্টারের আইপি ঠিকানাগুলি পেতে আগের পদক্ষেপটি পুনরাবৃত্তি করুন৷
  11. ভোক্তা গোষ্ঠী থেকে পুরানো মাস্টার এবং স্ট্যান্ডবাই নোডগুলি সরান:
    curl -u sysAdminEmail:password -X DELETE \
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores/masterUUID,standbyUUID" -v

    যেখানে axgroup-001 এবং consumer-group-001 হল বিশ্লেষণ এবং ভোক্তা গোষ্ঠীর ডিফল্ট নাম। masterUUID,standbyUUID একই ক্রমে আছে যেভাবে সেগুলি উপরে প্রদর্শিত হয়েছিল যখন আপনি উপরে বর্তমান বিশ্লেষণ এবং ভোক্তা গোষ্ঠীর তথ্য দেখেছেন৷ আপনাকে তাদের standbyUUID,masterUUID হিসাবে নির্দিষ্ট করতে হতে পারে।

    consumer-groups জন্য datastores সম্পত্তি এখন খালি হওয়া উচিত।

  12. বিশ্লেষণ গোষ্ঠী থেকে পুরানো মাস্টার এবং স্ট্যান্ডবাই নোডগুলি সরান:
    curl -u sysAdminEmail:password -X DELETE \
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v

    uuids অধীনে postgres-server সম্পত্তি এখন খালি হওয়া উচিত।

  13. বিশ্লেষণ এবং ভোক্তা গোষ্ঠীর সাথে নতুন PG মাস্টার এবং স্ট্যান্ডবাই নোড নিবন্ধন করুন: 
    curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v
curl -u sysAdminEmail:password -X POST -H "Content-Type:application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores?uuid=masterUUID,standbyUUID" -v
  14. বিশ্লেষণ গ্রুপ যাচাই করুন:
    curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

    আপনাকে বিশ্লেষণ গোষ্ঠী এবং ভোক্তা গোষ্ঠীতে তালিকাভুক্ত নতুন মাস্টার এবং স্ট্যান্ডবাই নোডগুলির UUID দেখতে হবে৷

  15. এজ ম্যানেজমেন্ট সার্ভার পুনরায় চালু করুন: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
  16. সমস্ত Qpid সার্ভার পুনরায় চালু করুন: 
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
  17. সমস্ত Postgres সার্ভার পুনরায় চালু করুন: 
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
  18. উভয় সার্ভারে নিম্নলিখিত স্ক্রিপ্ট ইস্যু করে প্রতিলিপি স্থিতি যাচাই করুন। একটি সফল প্রতিলিপি নিশ্চিত করতে সিস্টেমটিকে উভয় সার্ভারে অভিন্ন ফলাফল প্রদর্শন করা উচিত:

    নতুন মাস্টারে, চালান: 

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

    যাচাই করুন যে এটি মাস্টার। পুরানো স্ট্যান্ডবাই নোডে:

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

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

  19. নোডগুলি সিঙ্কে রয়েছে তা নিশ্চিত করতে বেশ কয়েকটি API অনুরোধ করার পরে পূর্ববর্তী পদক্ষেপটি পুনরাবৃত্তি করুন।
  20. পোস্টগ্রেস নোড ডিকমিশন করার পদ্ধতি ব্যবহার করে পুরানো পোস্টগ্রেস মাস্টারকে ডিকমিশন করুন।

    বিকল্পভাবে, আপনি পুরানো মাস্টার থেকে Qpid আনইনস্টল করতে পারেন এবং নতুন মাস্টার নোডে Qpid ইনস্টল করতে পারেন । Qpid আনইনস্টল করার পরে, আপনি পুরানো মাস্টার নোড ডিকমিশন করতে পারেন।

LDAP 2.6 আপডেট রোলব্যাক করুন

এই বিভাগটি পূর্ববর্তী LDAP সংস্করণে একটি LDAP ইনস্টলেশন রোল ব্যাক করার জন্য একটি ব্যাপক, ধাপে ধাপে নির্দেশিকা প্রদান করে। রোলব্যাক অবশ্যই সম্পূর্ণ LDAP ক্লাস্টারে সঞ্চালিত হতে হবে এবং শুধুমাত্র একটি বৈধ প্রাক-আপগ্রেড LDAP ব্যাকআপ ব্যবহার করেই সম্ভব।

প্রাথমিক লক্ষ্য হল একটি পরিচিত - ভাল ব্যাকআপ থেকে সম্পূর্ণ LDAP ক্লাস্টারটিকে একটি সামঞ্জস্যপূর্ণ অবস্থায় ফিরিয়ে আনা। এই পদ্ধতিটি সমস্ত পরিস্থিতিতে একই - একক সার্ভার, সক্রিয়-সক্রিয় এবং সক্রিয়-প্যাসিভ।

পূর্বশর্ত এবং বিবেচনা

  • ব্যাকআপ অসামঞ্জস্যতা: প্রাইভেট ক্লাউড 4.52.02 বা 4.53.00 এর জন্য আপনি এজ এর সাথে যে পুরানো 2.4 LDAP সংস্করণটি চালাচ্ছেন তার একটি ব্যাকআপ ব্যবহার করুন৷ আপগ্রেড করার চেষ্টা করার আগে এই ব্যাকআপটি অবশ্যই নেওয়া হয়েছে৷ আপগ্রেড করার পরে নেওয়া ব্যাকআপগুলি বেমানান এবং ব্যবহার করা যাবে না৷
  • ম্যানেজমেন্ট এপিআই ডাউনটাইম: এলডিএপি রোলব্যাকের সময়, ম্যানেজমেন্ট এপিআই অনুপলব্ধ থাকবে, যা প্রশাসনিক কাজগুলিকে প্রভাবিত করতে পারে। LDAP রোলব্যাকের সাথে আরও এগিয়ে যাওয়ার আগে অনুগ্রহ করে সমস্ত প্রান্ত-ব্যবস্থাপনা-সার্ভার এবং এজ-ইউআই বন্ধ করা নিশ্চিত করুন৷
  • ডেটা হারানোর ঝুঁকি: একটি বৈধ, সামঞ্জস্যপূর্ণ ব্যাকআপ ছাড়াই অগ্রসর হলে অপরিবর্তনীয় ডেটা ক্ষতির ঝুঁকি থাকে।
  • বৈধ ব্যাকআপ: একটি বৈধ প্রাক-আপগ্রেড LDAP ব্যাকআপ প্রয়োজন।

রোলব্যাক পদ্ধতি

  1. LDAP আপগ্রেডের সাথে আরও এগিয়ে যাওয়ার আগে অনুগ্রহ করে সমস্ত প্রান্ত-ব্যবস্থাপনা-সার্ভার এবং এজ-ইউআই বন্ধ করা নিশ্চিত করুন৷ 
    apigee-service edge-management-server stop
apigee-service edge-ui stop
  2. বিদ্যমান LDAP ডেটা ব্যাকআপ করুন (LDAP বন্ধ করার আগে)

    সমস্ত ldap সার্ভার থেকে রেফারেন্সের জন্য মোট রেকর্ড গণনা পান। (রেকর্ড গণনা সমস্ত 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 2.6 আনইনস্টল করুন

    apigee-openldap পরিষেবা বন্ধ করুন এবং এর কনফিগারেশন এবং ডেটা ডিরেক্টরি মুছুন। এটি অবশ্যই সমস্ত LDAP সার্ভারে সঞ্চালিত হবে, ধারাবাহিকতা নিশ্চিত করতে ক্লাস্টারে একটি সময়ে একটি নোড। 

    apigee-service apigee-openldap stop
apigee-service apigee-openldap uninstall
rm -rf /opt/apigee/data/apigee-openldap/*
  4. পুরানো LDAP 2.4 সংস্করণ ইনস্টল করুন
    • পুরানো LDAP সংস্করণ ইনস্টল করুন: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ld -f /opt/silent.conf
    • LDAP সংস্করণ যাচাই করুন: 
      source ~/.bash_profile
ldapsearch -VV

#Expected output:
ldapsearch: @(#) $OpenLDAP: ldapsearch 2.4.46
    • প্রতিটি LDAP নোডে উপরের ধাপগুলি একবারে পুনরাবৃত্তি করুন
  5. অবশিষ্ট ডেটা পরিষ্কার করুন

    সমস্ত LDAP সার্ভারে, একবারে, নতুন ইনস্টল করা পরিষেবাটি বন্ধ করুন এবং ব্যাকআপ থেকে পুনরুদ্ধারের জন্য প্রস্তুত করতে এর ডেটা ডিরেক্টরি পরিষ্কার করুন। 

    apigee-service apigee-openldap stop
rm -rf /opt/apigee/data/apigee-openldap/*
  6. LDAP ডেটা পুনরুদ্ধার করুন

    একক-সার্ভার সেটআপের জন্য, আপনি সরাসরি 5b ধাপে যেতে পারেন। মাল্টি সার্ভার সেটআপের জন্য, ধাপ 5a দিয়ে এগিয়ে যান।

    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 ডেটা পুনরুদ্ধার করুন (পুনরুদ্ধার করার আগে ধাপ 4 সমস্ত সার্ভার জুড়ে সম্পন্ন হয়েছে তা নিশ্চিত করুন।)
      • একক এবং সক্রিয় LDAP সার্ভারে (ধাপে 5a নির্ধারিত), ব্যাকআপ পুনরুদ্ধার করুন। 
        cd /opt/apigee/backup/openldap

# To restore a specific backup, provide the timestamp as shown below:
apigee-service apigee-openldap restore 2025.07.28,13.59.00
# Note: If no timestamp is provided, the latest available backup will be restored by default.
apigee-service apigee-openldap restore

# It is recommended to specify the backup explicitly to avoid restoring an unintended version.
      • apigee-openldap পরিষেবা শুরু করুন। 
        apigee-service apigee-openldap start
  7. অবশিষ্ট LDAP সার্ভারগুলি শুরু করুন৷

    আপনার যদি একটি মাল্টি সার্ভার সেটআপ থাকে, প্রতিটি LDAP সার্ভারে, পরিষেবাটি শুরু করুন: 

    apigee-service apigee-openldap start
  8. চূড়ান্ত বৈধতা
    • চূড়ান্ত ধাপ হল রোলব্যাক সফল হয়েছে এবং সেই ডেটা সমগ্র LDAP ক্লাস্টার জুড়ে সামঞ্জস্যপূর্ণ তা যাচাই করা।
    • সমস্ত LDAP সার্ভারে বৈধতা কমান্ড চালান। রেকর্ড গণনা সমস্ত সার্ভার জুড়ে অভিন্ন হওয়া উচিত এবং ধাপ 1-এ আপনি যে গণনা করেছেন তার সাথে অবশ্যই মিল থাকতে হবে। 
      # 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
    • একবার আপনি নিশ্চিত করেছেন যে ডেটা সঠিক এবং সামঞ্জস্যপূর্ণ, আপনার LDAP রোলব্যাক সম্পূর্ণ। আপনি এখন আপনার প্রতিষ্ঠানের স্ট্যান্ডার্ড আপগ্রেড পদ্ধতি অনুসারে প্রান্ত-ব্যবস্থাপনা-সার্ভার , edge-ui এবং অন্য কোনও নির্ভরশীল উপাদান শুরু করার সাথে এগিয়ে যেতে পারেন।

আগের বড় বা ছোট রিলিজে ফিরে যান

পূর্ববর্তী বড় বা ছোট রিলিজে ফিরে যেতে, উপাদানটি হোস্ট করে এমন প্রতিটি নোডে নিম্নলিখিতগুলি করুন:

  1. আপনি যে সংস্করণে ফিরে আসতে চান তার জন্য bootstrap.sh ফাইলটি ডাউনলোড করুন:

    • 4.52.02 এ ফিরে যেতে, bootstrap_4.52.02.sh ডাউনলোড করুন
  2. কম্পোনেন্টটিকে রোল ব্যাক করতে থামান:
    1. নোডে সাধারণ কোড সহ যেকোনও কম্পোনেন্ট রোল ব্যাক করতে, আপনাকে অবশ্যই সেগুলি বন্ধ করতে হবে, যেমনটি নিম্নলিখিত উদাহরণটি দেখায়: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. নোডে অন্য কোনো কম্পোনেন্ট রোল ব্যাক করতে, শুধু সেই কম্পোনেন্ট বন্ধ করুন: 
      /opt/apigee/apigee-service/bin/apigee-service component stop
  3. আপনি যদি নগদীকরণকে রোল ব্যাক করছেন, তাহলে সমস্ত ম্যানেজমেন্ট সার্ভার এবং মেসেজ প্রসেসর নোড থেকে এটি আনইনস্টল করুন: 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. নোডে রোল ব্যাক করতে উপাদানটি আনইনস্টল করুন:
    1. নোডে সাধারণ কোড সহ যেকোনও কম্পোনেন্ট রোল ব্যাক করতে, আপনাকে অবশ্যই edge-gateway এবং apigee-cassandra-client কম্পোনেন্ট গ্রুপ আনইনস্টল করে সেগুলিকে আনইনস্টল করতে হবে, যেমনটি নিম্নলিখিত উদাহরণটি দেখায়: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra-client uninstall
    2. নিচের মত Nginx রোলব্যাক করতে: 
      ###Find the apigee-nginx RPM 
rpm -qa | grep -i "apigee-nginx"

###Remove the apigee-nginx RPM
dnf remove apigee-nginx-1.26.x
    3. নোডে অন্য কোনো কম্পোনেন্ট রোল ব্যাক করতে, সেই কম্পোনেন্টটিকে আনইনস্টল করুন, যেমন নিচের উদাহরণটি দেখায়:
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      যেখানে component হল কম্পোনেন্টের নাম।

    4. এজ রাউটারটি রোল ব্যাক করতে, আপনাকে edge-gateway কম্পোনেন্ট গ্রুপ আনইনস্টল করার পাশাপাশি /opt/nginx/conf.d ফাইলের বিষয়বস্তু মুছে ফেলতে হবে: 
      cd /opt/nginx/conf.d
rm -rf *
  5. apigee-setup 4.53.01 সংস্করণ আনইনস্টল করুন: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. apigee-service ইউটিলিটি এবং এর নির্ভরতাগুলির 4.52.02 সংস্করণ ইনস্টল করুন। নিম্নলিখিত উদাহরণটি apigee-service 4.52.02 সংস্করণ ইনস্টল করে:
    sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

    যেখানে uName এবং pWord হল ব্যবহারকারীর নাম এবং পাসওয়ার্ড আপনি Apigee থেকে পেয়েছেন। আপনি pWord বাদ দিলে, আপনাকে এটি লিখতে বলা হবে।

    আপনি যদি একটি ত্রুটি পান, তাহলে নিশ্চিত হন যে আপনি ধাপ 1 এ bootstrap.sh ফাইলটি ডাউনলোড করেছেন৷

  7. apigee-setup ইনস্টল করুন: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. উপাদানটির পুরানো সংস্করণ ইনস্টল করুন:
    /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

    যেখানে component ইন্সটল করার কম্পোনেন্ট এবং কনফিগার ফাইল হল আপনার পুরানো সংস্করণের জন্য কনফিগারেশন ফাইল।

  9. আপনি যদি Qpid চালু করেন, তাহলে iptables ফ্লাশ করুন: 
    sudo iptables -F
  10. প্রতিটি নোডের জন্য এই প্রক্রিয়াটি পুনরাবৃত্তি করুন যা আপনি যে উপাদানটিকে ফিরিয়ে আনছেন সেটি হোস্ট করে।

এমটিএলএস রোল ব্যাক করুন

mTLS আপডেট রোল ব্যাক করতে, সমস্ত হোস্টে নিম্নলিখিত পদক্ষেপগুলি করুন:

  1. Apigee বন্ধ করুন: 
    apigee-all stop
  2. mTLS বন্ধ করুন: 
    apigee-service apigee-mtls uninstall
  3. mTLS পুনরায় ইনস্টল করুন: 
    apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf