এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

Apigee Edge 4.51.00 বা 4.52.00 বা 4.52.01 থেকে 4.52.02 আপডেট করুন

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

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

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

কে আপডেটটি সম্পাদন করতে পারে

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

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

কোন উপাদানগুলি আপনাকে অবশ্যই আপডেট করতে হবে

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

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

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

সমস্ত নোডের ব্যাকআপ নিন
আপডেট করার আগে, নিরাপত্তার কারণে আমরা আপনাকে সমস্ত নোডের একটি সম্পূর্ণ ব্যাকআপ নেওয়ার পরামর্শ দিই। ব্যাকআপটি করার জন্য আপনার Edge-এর বর্তমান সংস্করণের পদ্ধতিটি অনুসরণ করুন।
এর ফলে, নতুন সংস্করণে আপডেট করার পর যদি তা সঠিকভাবে কাজ না করে, তবে আপনার একটি বিকল্প পরিকল্পনা থাকবে। ব্যাকআপ সম্পর্কে আরও তথ্যের জন্য, ব্যাকআপ এবং রিস্টোর দেখুন।
Edge চালু আছে কিনা তা নিশ্চিত করুন।
আপডেট প্রক্রিয়া চলাকালীন Edge চালু আছে কিনা তা নিশ্চিত করতে নিম্নলিখিত কমান্ডটি ব্যবহার করুন:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
দ্রষ্টব্য: নিশ্চিত করুন যে আপনার বর্তমান সংস্করণে এজ-ম্যানেজমেন্ট-সার্ভার সেটআপ কোনো ত্রুটি ছাড়াই সফলভাবে চলছে। পরবর্তী আপগ্রেডে অগ্রসর হওয়ার আগে পূর্ববর্তী সংস্করণগুলির এজ-ম্যানেজমেন্ট-সার্ভার সেটআপের যেকোনো ত্রুটি সমাধান করুন।
নিশ্চিত করুন যে ক্যাসান্ড্রা কম্প্যাকশন স্ট্র্যাটেজিটি LeveledCompactionStrategy
আপনার বর্তমান সংস্করণ অনুযায়ী, ক্যাসান্ড্রা কম্প্যাকশন স্ট্র্যাটেজিতে প্রয়োজনীয় পরিবর্তনগুলি করুন। নিচের ধাপগুলি অনুসরণ করুন এবং তারপর মূল আপগ্রেড পদ্ধতিতে ফিরে আসুন:
- আপনি যদি সংস্করণ 4.51.00 থেকে আপগ্রেড করেন, তাহলে v4.51.00-এর জন্য Cassandra Compaction Strategy ডকুমেন্টটি দেখুন।
- আপনি যদি সংস্করণ 4.52.00 থেকে আপগ্রেড করেন, তাহলে v4.52.00-এর জন্য Cassandra Compaction Strategy ডকুমেন্টটি দেখুন।
- আপনি যদি সংস্করণ 4.52.01 থেকে আপগ্রেড করেন, তাহলে v4.52.01-এর জন্য Cassandra Compaction Strategy ডকুমেন্টটি দেখুন।

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

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

বর্তমান সংস্করণ	যে সফটওয়্যারটি 4.52.02 সংস্করণে আপগ্রেড করার জন্য বিশেষ পদক্ষেপের প্রয়োজন।
৪.৫২.০১	ক্যাসান্ড্রা
৪.৫২.০০	Zookeeper , Cassandra , Qpid
৪.৫১.০০	Zookeeper , Postgres , Cassandra , Qpid

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

প্রপার্টি সেটিংসের স্বয়ংক্রিয় প্রচার

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

Zookeeper 3.8.3-এ আপগ্রেড করুন

Edge for Private Cloud 4.52.02-এ Zookeeper আপগ্রেড অন্তর্ভুক্ত নেই। তবে, আপনি যদি 4.52.01-এর চেয়ে পুরোনো কোনো সংস্করণ থেকে আপগ্রেড করেন, তাহলে আপনাকে নিচে বর্ণিত Zookeeper আপগ্রেডের ধাপগুলো অনুসরণ করতে হবে।

আপনি যদি Edge for Private Cloud সংস্করণ 4.51.00 বা 4.52.00 থেকে আপগ্রেড করেন, তাহলে Zookeeper আপগ্রেড করার জন্য “Required upgrade to Zookeeper 3.8.3” -এর ধাপগুলো অনুসরণ করুন।
আপনি যদি Edge for Private Cloud সংস্করণ 4.52.01 থেকে আপগ্রেড করেন, তাহলে আপনি ইতিমধ্যেই Zookeeper সংস্করণ 3.8.3 ব্যবহার করছেন এবং Zookeeper আপগ্রেড করার জন্য আপনাকে কোনো বিশেষ পদক্ষেপ অনুসরণ করতে হবে না।

দ্রষ্টব্য:

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

যদি Zookeeper আপডেট করার জন্য নির্দিষ্ট পদক্ষেপের প্রয়োজন হয়, তবে সমস্ত ডেটা সেন্টার জুড়ে একবারে একটি নোড আপডেট করে Zookeeper আপগ্রেড করুন। বিশ্বব্যাপী সমস্ত Zookeeper নোড আপডেট হয়ে গেলে, এই নিবন্ধে পরে বর্ণিত পদ্ধতি অনুসরণ করে একবারে একটি ডেটা সেন্টার থেকে Cassandra আপগ্রেড করুন।

নিম্নলিখিত কমান্ডটি একটি পৃথক Zookeeper আপগ্রেড সহজতর করে:

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

Zookeeper রোলব্যাকের জন্য, সাধারণ Zookeeper রোলব্যাক পদ্ধতি অনুসরণ করুন। যদি Cassandra বা অন্য কোনো কম্পোনেন্টের জন্য রোলব্যাক করা আবশ্যক হয়ে পড়ে, তবে সেই কম্পোনেন্টগুলোকেই রোলব্যাক করা উচিত; সেক্ষেত্রে Zookeeper রোলব্যাকের প্রয়োজন নেই।

Postgres 14-এ আপগ্রেড করুন

আপনি যদি Edge for Private Cloud 4.51.00 থেকে 4.52.02-এ আপগ্রেড করেন, তাহলে আপনাকে অবশ্যই Postgres আপগ্রেড করার ধাপগুলো অনুসরণ করতে হবে, যদিও Edge for Private Cloud 4.52.02-এর সাথে Postgres আপগ্রেড অন্তর্ভুক্ত নেই। Edge for Private Cloud 4.51.00 থেকে 4.52.02-এ আপগ্রেড করার জন্য অতিরিক্ত Postgres আপগ্রেড ধাপের প্রয়োজন। অনুগ্রহ করে ‘ Required upgrade to Postgres 14’ অংশটি দেখুন।
আপনি যদি Edge for Private Cloud 4.52.00 বা 4.52.01 থেকে 4.52.02-এ আপগ্রেড করেন, তাহলে অতিরিক্ত কোনো Postgres আপগ্রেড ধাপের প্রয়োজন নেই।

দ্রষ্টব্য:

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

পোস্টগ্রেস রোলব্যাকের জন্য, সাধারণ পোস্টগ্রেস রোলব্যাক পদ্ধতি অনুসরণ করুন। যদি ক্যাসান্ড্রা বা অন্যান্য কম্পোনেন্টের জন্য রোলব্যাকের প্রয়োজন হয়, তবে সেই কম্পোনেন্টগুলো রোলব্যাক করুন; পোস্টগ্রেস রোলব্যাকের প্রয়োজন নেই।

ক্যাসান্ড্রা 3.11.16-এ আপগ্রেড করুন

Apigee Edge for Private Cloud 4.52.02 সংস্করণে ক্যাসান্ড্রাকে 3.11.16 ভার্সনে আপগ্রেড করা হয়েছে। ক্যাসান্ড্রা Apigee-এর একটি অত্যন্ত গুরুত্বপূর্ণ উপাদান, এবং এই আপগ্রেডে ক্যাসান্ড্রাকে কোয়েরি করতে ও এতে লেখার জন্য ব্যবহৃত বিভিন্ন রানটাইম এবং ম্যানেজমেন্ট কম্পোনেন্টের ড্রাইভার সফটওয়্যারের আপডেটও অন্তর্ভুক্ত রয়েছে।

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

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

দ্রষ্টব্য: ক্যাসান্ড্রা ৩.এক্স (Cassandra 3.X)-এ cassandra-cli টুলটি আর সমর্থিত নয় এবং এটি আপনার ব্যবহারের জন্য উপলব্ধ নয়।

ডেভেলপার পোর্টাল - এপিআই ডকুমেন্টেশন

Apigee Drupal ডেভেলপার পোর্টাল আপনার API-গুলোর ডকুমেন্টেশনের জন্য বিভিন্ন ফিচার প্রদান করে। যদিও Drupal 7-ভিত্তিক ডেভেলপার পোর্টাল ব্যবহার থেকে সরে আসার পরামর্শ দেওয়া হচ্ছে, আপনি যদি এখনও এটি ব্যবহার করেন এবং এর SmartDocs ফিচারটি কাজে লাগান, তাহলে 'Using SmartDocs APIs' ডকুমেন্টটি আপনার জন্য প্রযোজ্য। আপনি যদি ডেভেলপার পোর্টালের নতুন সংস্করণগুলো ব্যবহার করেন, তাহলে এই আপগ্রেডের সময় আপনার API ডকুমেন্টেশনের উপর কোনো প্রভাব পড়বে না।

আপনি যখন Apigee সংস্করণ 4.52.02-এ আপগ্রেড করবেন, তখন Drupal 7 ডেভেলপার পোর্টালের SmartDocs বৈশিষ্ট্য ব্যবহার করে তৈরি করা কোনো API মডেল স্বয়ংক্রিয়ভাবে নতুন সংস্করণে স্থানান্তরিত হবে না। আপনাকে ডেভেলপার পোর্টাল ব্যবহার করে প্রতিটি মডেল ম্যানুয়ালি এক্সপোর্ট করতে হবে এবং আপগ্রেড সম্পন্ন হওয়ার পরে তা আবার ইম্পোর্ট করতে হবে।

নীচে ব্যবহৃত পরিভাষা

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

ব্যবস্থাপনা: ব্যবস্থাপনার মধ্যে আপনার Apigee Edge সিস্টেমের প্রশাসন অন্তর্ভুক্ত। এর মধ্যে অ্যাপ, প্রোডাক্ট, টার্গেট সার্ভার, কীস্টোর ইত্যাদির ডেপ্লয়মেন্ট ও পরিবর্তন অন্তর্ভুক্ত, তবে এটি কেবল এগুলোর মধ্যেই সীমাবদ্ধ নয়। সমস্ত ম্যানেজমেন্ট এপিআই (এবং তাদের ক্লায়েন্ট যেমন Apigee UI ও ডেভেলপার পোর্টাল) এই পরিধির অন্তর্ভুক্ত।

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

নিচের প্রতিটি ধাপে, আপগ্রেড পদ্ধতির বিভিন্ন পর্যায় অতিক্রম করার সাথে সাথে রানটাইম ও ব্যবস্থাপনার অবস্থা বর্ণনা করা হয়েছে।

আপগ্রেড কৌশল

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

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

দ্রষ্টব্য:

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

দুটি ডেটা সেন্টার সেটআপ করার জন্য, এই প্রধান ধাপগুলো অনুসরণ করুন:

DC-1 থেকে DC-2 তে ট্র্যাফিক পুনঃনির্দেশ করুন এবং DC-1 তে আগত ট্র্যাফিক ব্লক করুন।
ক্যাসান্ড্রা , ম্যানেজমেন্ট সার্ভার এবং রানটাইম উপাদানসহ ডিসি-১ আপগ্রেড করুন ।
ট্র্যাফিককে DC-1- এ ফেরত পাঠান এবং DC-2-তে আগত ট্র্যাফিক ব্লক করুন।
ক্যাসান্ড্রা , ম্যানেজমেন্ট সার্ভার এবং রানটাইম উপাদানসহ ডিসি-২ আপগ্রেড করুন ।

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

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

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

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

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

রানটাইম এপিআই OAuth টোকেন রিফ্রেশ করছে
অ্যাক্সেস এনটিটি পলিসি ব্যবহার করে রানটাইম এপিআই
ম্যানেজমেন্ট এপিআই ডেভেলপার অ্যাপ তালিকাভুক্ত করছে
ব্যবস্থাপনা এপিআই পণ্য তালিকাভুক্ত করে

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

রোলব্যাক - উচ্চ স্তর

রোলব্যাকের সময় প্রভাব
ক্যাসান্ড্রা 3.11.x থেকে 2.1.x-এ রোলব্যাক করলে, যে ডেটা সেন্টারে (DC) এই রোলব্যাকটি করা হচ্ছে, সেখানকার রানটাইম এবং ম্যানেজমেন্ট ট্র্যাফিক উভয়ই প্রভাবিত হয়। এছাড়াও, বর্তমানে কোন ডেটা সেন্টারে রোলব্যাক করা হচ্ছে তা নির্বিশেষে, কিছু নির্দিষ্ট ম্যানেজমেন্ট API-এর কার্যকারিতায় বিঘ্ন ঘটতে পারে।
ডিসি রোলব্যাক পদ্ধতি অনুসরণ করুন
পরিষেবার ধারাবাহিকতা বজায় রাখতে এবং ডাউনটাইম এড়াতে রোলব্যাক অবশ্যই একবারে একটি ডেটা সেন্টারে সম্পাদন করতে হবে। একটি নির্দিষ্ট ডেটা সেন্টারে রোলব্যাক শুরু করার আগে, নিশ্চিত করুন যে অ্যাপ্লিকেশন ট্র্যাফিক অন্য একটি সম্পূর্ণ চালু ডেটা সেন্টারে পুনঃনির্দেশিত করা হয়েছে।
আংশিকভাবে আপগ্রেড করা ক্লাস্টার রোলব্যাক করা হচ্ছে
যদি অন্তত একটি ডেটা সেন্টার ক্যাসান্ড্রার পুরোনো সংস্করণে (২.১.২২) সম্পূর্ণরূপে সচল থাকে, তবে সম্পূর্ণরূপে কার্যকর ক্যাসান্ড্রা ২.১.এক্স ডেটা সেন্টার থেকে একটি রিবিল্ড সম্পাদন করে অন্যান্য আপগ্রেড করা ডেটা সেন্টারগুলোকে রোলব্যাক করা যেতে পারে।
ক্লাস্টার-ব্যাপী রোলব্যাক
যদি সম্পূর্ণ ক্যাসান্ড্রা ক্লাস্টার আপগ্রেড করা হয়ে থাকে এবং রোলব্যাক করার প্রয়োজন হয়, তবে তা অবশ্যই ব্যাকআপ বা ভিএম স্ন্যাপশট ব্যবহার করে করতে হবে। এই পদ্ধতিটি জটিল এবং এর ফলে সাময়িক ডাউনটাইম বা ডেটা হারানোর সম্ভাবনা থাকে।
আপগ্রেডের পূর্ববর্তী বিবেচ্য বিষয়সমূহ
আপগ্রেড করার চেষ্টা করার আগে রোলব্যাক পদ্ধতি সম্পর্কে ভালোভাবে জেনে নেওয়া জরুরি। আপগ্রেড করার সময় রোলব্যাকের সূক্ষ্ম বিষয়গুলো বিবেচনা করা অত্যন্ত গুরুত্বপূর্ণ, যাতে যথাযথ রোলব্যাক পথগুলো উপলব্ধ থাকে।

একটিমাত্র ডেটা সেন্টার দিয়ে ক্লাস্টার রোলব্যাক করুন

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

প্রোডাকশন ওয়ার্কলোডের ক্ষেত্রে, আপগ্রেডের আগে একটি নতুন ডেটা সেন্টার প্রস্তুত করার জন্য দৃঢ়ভাবে সুপারিশ করা হয়। এর ফলে ডেটা নষ্ট হওয়া বা এপিআই ট্র্যাফিকের কোনো ব্যাঘাত ছাড়াই একটি নিরাপদ রোলব্যাক পথ তৈরি হয়। আপগ্রেড সফলভাবে সম্পন্ন হওয়ার পর অতিরিক্ত ডেটা সেন্টারটি নিষ্ক্রিয় করে দেওয়া যেতে পারে।

যদি নতুন ডেটা সেন্টার যোগ করা সম্ভব না হয় কিন্তু রোলব্যাক করার সক্ষমতা প্রয়োজন হয়, তবে আপগ্রেডের আগে নির্ভরযোগ্য ব্যাকআপ নেওয়া নিশ্চিত করুন। ব্যাকআপ থেকে ক্যাসান্ড্রা ২.১.x পুনরুদ্ধার করা সম্ভব, কিন্তু এই পদ্ধতিতে পরিষেবা বন্ধ থাকতে পারে এবং ডেটা হারানোর সম্ভাবনা থাকে।

একাধিক ডেটা সেন্টার সহ রোলব্যাক ক্লাস্টার

একাধিক ডেটা সেন্টার রোলব্যাক করার ক্ষেত্রে ডেটা সেন্টার-বাই-ডেটা সেন্টার (DC-by-DC) পদ্ধতি অনুসরণ করা হয়। এই পদ্ধতিতে, যে ডেটা সেন্টারটি রোলব্যাক করা হচ্ছে, তার ট্র্যাফিক অন্যান্য সচল ডেটা সেন্টারে পুনঃনির্দেশিত করা হয়। এর ফলে ক্যাসান্ড্রা , ম্যানেজমেন্ট সার্ভার এবং রানটাইম নোডগুলোর জন্য একটি নিয়ন্ত্রিত ও বিচ্ছিন্ন রোলব্যাক প্রক্রিয়া নিশ্চিত করা হয়, যাতে ট্র্যাফিকের কোনো ব্যাঘাত না ঘটে।

বিস্তারিত জানতে “ক্যাসান্ড্রা ৩.১১.১৬ আপডেট রোলব্যাক করুন” অংশটি দেখুন।

ধাপ ০: প্রারম্ভিক অবস্থা

Zookeeper, Postgres এবং LDAP কম্পোনেন্টগুলো ইতিমধ্যে 4.52.02 ভার্সনে আপগ্রেড করা হয়েছে। আপনার প্রাইভেট ক্লাউড ক্লাস্টারের জন্য Edge স্থিতিশীল এবং কার্যকর আছে। যদি রোলব্যাকের প্রয়োজন হয়, তবে ক্লাস্টারটিকে এই অবস্থায় রোলব্যাক করা হবে।
Apigee-তে Cassandra ২.১.২২ সংস্করণে চলছে।
প্রান্তের উপাদানসমূহ:

ম্যানেজমেন্ট সার্ভার পুরোনো থ্রিফট প্রোটোকলের মাধ্যমে ক্যাসান্ড্রার সাথে যোগাযোগ করছে।
রানটাইম সার্ভারগুলো (মেসেজ প্রসেসর ও রাউটার) পুরোনো থ্রিফট প্রোটোকলের মাধ্যমে ক্যাসান্ড্রার সাথে যোগাযোগ করছে।

এই পর্যায়ে রানটাইম অবস্থা	এই পর্যায়ে ব্যবস্থাপনার অবস্থা
রানটাইম সম্পূর্ণরূপে কার্যকরী	ব্যবস্থাপনা সম্পূর্ণরূপে কার্যকর

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

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

ক্যাসান্ড্রাকে LeveledCompactionStrategy ব্যবহার করার জন্য পরিবর্তন করুন।
Apigee ব্যবহার করে Cassandra-র ব্যাকআপ নিন।
ক্যাসান্ড্রা নোডগুলোর ভিএম স্ন্যাপশট নিন (যদি সম্ভব হয়)।
প্রতিটি ক্যাসান্ড্রা নোডে /opt/apigee/apigee-cassandra/cass_upgrade.conf এ নিম্নলিখিত বিষয়বস্তু সহ একটি ক্যাসান্ড্রা আপগ্রেড কনফিগারেশন ফাইল তৈরি করুন:
```
# IP Address of node
HOSTIP=10.0.0.1

# Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_USERNAME=<cassuser>

# Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_PASSWORD=<casspass>

# Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
CASS_PORT=9160

# Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
CASS_CQL_PORT=9042

# Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
# Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
CASS_TMP_DIR=/tmp/cass_upgrade_scripts
    
```
যদি /opt/apigee/apigee-cassandra/cass_upgrade.conf ঠিকানায় ফাইলটি তৈরি করা না যায়, তাহলে প্রতিটি ক্যাসান্ড্রা নোডে একই বিষয়বস্তু দিয়ে /opt/silent.conf ফাইলটি তৈরি করুন।
সতর্কতা: Apigee-এর আপগ্রেড ইনস্টলার উপরে তালিকাভুক্ত স্থানগুলিতে ফাইলটি খুঁজবে। যদি ফাইলটি উপরে তালিকাভুক্ত কোনো স্থানেই উপস্থিত না থাকে, তাহলে নিচের মতো একটি বার্তা সহ আপগ্রেডটি ব্যর্থ হবে:
```
could not read env location: '/opt/apigee/apigee-cassandra/cass_upgrade.conf'
file does not exist or cannot be sourced
could not read env location: '/opt/silent.conf'
file does not exist or cannot be sourced
```
এমনটা হলে, আপগ্রেড ব্যর্থ হবে কিন্তু নোডের ক্যাসান্ড্রা সার্ভিসটি সম্ভবত বন্ধ অবস্থায় থাকবে। আপনি যথারীতি ক্যাসান্ড্রা সার্ভিসটি চালু করতে পারেন এবং কনফিগারেশন ফাইলটি প্রত্যাশিত স্থানগুলোর যেকোনো একটিতে রেখে আপগ্রেডটি পুনরায় চেষ্টা করতে পারেন। এছাড়াও, যদি ফাইলটি খুঁজে পাওয়া যায় কিন্তু প্রদত্ত কনফিগারেশনগুলো ভুল হয় (উদাহরণস্বরূপ, ক্যাসান্ড্রা ক্রেডেনশিয়াল ভুল হলে), তাহলে নিচের মতো একটি এরর দেখিয়ে আপগ্রেডটি ব্যর্থ হবে:
```
Error in PREIN scriptlet in rpm package apigee-cassandra-X.XX.XX-X.X.XXXX.noarch
```
এক্ষেত্রেও, আপগ্রেড ব্যর্থ হলে ক্যাসান্ড্রা সার্ভিসটি বন্ধ হয়ে গেলে একইভাবে সেটি চালু করুন এবং ফাইলটিতে কনফিগারেশনগুলো ঠিক করার পর পুনরায় আপগ্রেড করার চেষ্টা করুন।
আপনি যদি Apigee Drupal 7 ডেভেলপার পোর্টালের SmartDocs ফিচারটি ব্যবহার করেন, তাহলে ডেভেলপার পোর্টাল UI থেকে আপনার প্রতিটি মডেলকে JSON ফরম্যাটে ডাউনলোড করে এক্সপোর্ট করুন । ম্যানেজমেন্ট সার্ভারগুলো আপডেট হওয়ার পর এই মডেলগুলোকে আবার Apigee-তে ইম্পোর্ট করতে হবে।
যদি আগে থেকে না থাকে, তবে নিশ্চিত করুন যে সমস্ত এজ কম্পোনেন্ট থেকে ক্যাসান্ড্রা নোডগুলিতে পোর্ট ৯১৬০ এবং ৯০৪২ অ্যাক্সেসযোগ্য। আরও তথ্যের জন্য পোর্ট রিকোয়ারমেন্টস দেখুন।

সতর্কতা: ক্যাসান্ড্রাকে সংস্করণ ৩-এ আপগ্রেড করার জন্য, আপগ্রেডের সময় রোলব্যাকের প্রয়োজন হলে ডেটার ক্ষতি ন্যূনতম রাখা নিশ্চিত করার জন্য এবং আপগ্রেডের পরে আপনার কোনো ডেটা—যেমন স্মার্টডকস-এ থাকা এপিআই ডকুমেন্টেশন—যাতে হারিয়ে না যায়, তা নিশ্চিত করার জন্য এই সমস্ত ধাপগুলি অত্যন্ত গুরুত্বপূর্ণ। এই ধাপগুলি অবশ্যই যত্ন সহকারে করতে হবে এবং এড়িয়ে যাওয়া যাবে না।

ধাপ ২: প্রথম ডেটা সেন্টার থেকে ট্র্যাফিক অন্যত্র সরিয়ে দিন

প্রথম ডেটা সেন্টার থেকে আগত রানটাইম এবং ম্যানেজমেন্ট ট্র্যাফিক ব্লক করুন।
সমস্ত রানটাইম ট্র্যাফিক এবং ম্যানেজমেন্ট এপিআই অন্যান্য কার্যকরী ডেটা সেন্টারগুলিতে পুনঃনির্দেশিত করুন।
যাচাই করুন যে রানটাইম এবং ম্যানেজমেন্ট ট্র্যাফিক অন্য ডিসি(গুলি) দ্বারা সফলভাবে পরিচালিত হচ্ছে।

ধাপ ৩: প্রথম ডেটা সেন্টারের সমস্ত ক্যাসান্ড্রা নোড আপগ্রেড করুন।

ডেটা সেন্টারের সমস্ত ক্যাসান্ড্রা নোড এক এক করে আপগ্রেড করুন। প্রতিটি নোডে নিম্নলিখিত কমান্ডগুলি এক এক করে চালান:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
```
নোডটি আপডেট হয়ে গেলে, সামনে অগ্রসর হওয়ার আগে কিছু যাচাইকরণ সম্পন্ন করতে নোডটিতে নিম্নলিখিত কমান্ডটি চালান:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
```
উপরেরটির আউটপুটটি মোটামুটি এইরকম হবে:
```
Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
```
আপগ্রেড সম্পন্ন হওয়ার পর, প্রতিটি ক্যাসান্ড্রা নোডে এক এক করে নিম্নলিখিত post_upgrade কমান্ডটি চালান:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
```

এই পর্যায়ে রানটাইম অবস্থা	এই পর্যায়ে ব্যবস্থাপনার অবস্থা
ডেটা সেন্টার আপগ্রেড করার কারণে রানটাইম ট্র্যাফিক ব্লক করা হয়েছে। অন্যান্য ডেটা সেন্টারে রানটাইম সম্পূর্ণরূপে কার্যকর	যে ডেটা সেন্টারগুলো আপগ্রেড করা হচ্ছে, সেখানে ম্যানেজমেন্ট ট্র্যাফিক ব্লক করা হয়েছে। অন্যান্য ডেটা সেন্টারে ক্যাসান্ড্রা আপগ্রেড করার পর নিম্নলিখিত ব্যবস্থাপনা ফাংশনের মান হ্রাস পায়: পরিবেশ সহ এপিআই পণ্য তৈরি করার জন্য ম্যানেজমেন্ট এপিআই পরিবেশের সাহায্যে একটি এপিআই পণ্য আপডেট করার জন্য ম্যানেজমেন্ট এপিআই। একটি সংস্থা মুছে ফেলার জন্য ম্যানেজমেন্ট এপিআই

এই পর্যায়ে রানটাইম অবস্থা

এই পর্যায়ে ব্যবস্থাপনার অবস্থা

ডেটা সেন্টার আপগ্রেড করার কারণে রানটাইম ট্র্যাফিক ব্লক করা হয়েছে।
অন্যান্য ডেটা সেন্টারে রানটাইম সম্পূর্ণরূপে কার্যকর

যে ডেটা সেন্টারগুলো আপগ্রেড করা হচ্ছে, সেখানে ম্যানেজমেন্ট ট্র্যাফিক ব্লক করা হয়েছে।
অন্যান্য ডেটা সেন্টারে ক্যাসান্ড্রা আপগ্রেড করার পর নিম্নলিখিত ব্যবস্থাপনা ফাংশনের মান হ্রাস পায়:

ধাপ ৪: প্রথম ডেটা সেন্টারের সমস্ত ম্যানেজমেন্ট নোড আপগ্রেড করুন।

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

Warning:schema version mismatch detected; check the schema versions of your nodes in system.local and system.peers.

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

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

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

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

এই পর্যায়ে রানটাইম অবস্থা

এই পর্যায়ে ব্যবস্থাপনার অবস্থা

ডেটা সেন্টার আপগ্রেড করার কারণে রানটাইম ট্র্যাফিক ব্লক করা হয়েছে।
রানটাইম সম্পূর্ণরূপে কার্যকরী

যে ডেটা সেন্টারগুলো আপগ্রেড করা হচ্ছে, সেখানে ম্যানেজমেন্ট ট্র্যাফিক ব্লক করা হয়েছে।
ক্যাসান্ড্রা আপগ্রেড করার পর নিম্নলিখিত ব্যবস্থাপনা ফাংশনের মান হ্রাস পায়:

ধাপ ৫: প্রথম ডেটা সেন্টারের সমস্ত রানটাইম নোড আপগ্রেড করুন

ডেটা সেন্টারের সমস্ত রাউটার এবং মেসেজ প্রসেসর নোড এক এক করে আপগ্রেড করুন:

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

এই পর্যায়ে রানটাইম অবস্থা	এই পর্যায়ে ব্যবস্থাপনার অবস্থা
ডেটা সেন্টার আপগ্রেড করার কারণে রানটাইম ট্র্যাফিক ব্লক করা হয়েছে। অন্যান্য ডেটা সেন্টারে রানটাইম সম্পূর্ণরূপে কার্যকর	যে ডেটা সেন্টারগুলো আপগ্রেড করা হচ্ছে, সেখানে ম্যানেজমেন্ট ট্র্যাফিক ব্লক করা হয়েছে। অন্যান্য ডেটা সেন্টারে ক্যাসান্ড্রা আপগ্রেড করার পর নিম্নলিখিত ব্যবস্থাপনা ফাংশনের মান হ্রাস পায়: পরিবেশ সহ এপিআই পণ্য তৈরি করার জন্য ম্যানেজমেন্ট এপিআই পরিবেশের সাহায্যে একটি এপিআই পণ্য আপডেট করার জন্য ম্যানেজমেন্ট এপিআই। একটি সংস্থা মুছে ফেলার জন্য ম্যানেজমেন্ট এপিআই

এই পর্যায়ে রানটাইম অবস্থা

এই পর্যায়ে ব্যবস্থাপনার অবস্থা

ডেটা সেন্টার আপগ্রেড করার কারণে রানটাইম ট্র্যাফিক ব্লক করা হয়েছে।
অন্যান্য ডেটা সেন্টারে রানটাইম সম্পূর্ণরূপে কার্যকর

যে ডেটা সেন্টারগুলো আপগ্রেড করা হচ্ছে, সেখানে ম্যানেজমেন্ট ট্র্যাফিক ব্লক করা হয়েছে।
অন্যান্য ডেটা সেন্টারে ক্যাসান্ড্রা আপগ্রেড করার পর নিম্নলিখিত ব্যবস্থাপনা ফাংশনের মান হ্রাস পায়:

ধাপ ৬: ট্র্যাফিককে প্রথম ডেটা সেন্টারে ফেরত পাঠান

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

ধাপ ৭: অন্যান্য ডেটা সেন্টার আপগ্রেড করুন

অবশিষ্ট ডেটা সেন্টারগুলোতে, এক এক করে ধাপ ১ থেকে ধাপ ৬ পুনরাবৃত্তি করুন। এর জন্য, সেই ডেটা সেন্টারগুলো থেকে ট্র্যাফিক অন্যত্র সরিয়ে দিন, Apigee সফটওয়্যার আপডেট করুন এবং সেগুলোতে ট্র্যাফিক পুনরায় চালু করুন।

ধাপ ৮: সমস্ত ম্যানেজমেন্ট নোডে আপগ্রেড ধাপটি পুনরায় চালান।

ডেটা সেন্টার জুড়ে সমস্ত ম্যানেজমেন্ট নোডে নিম্নলিখিত আপগ্রেড কমান্ডটি পুনরায় চালান:

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

ধাপ ৯ - [ঐচ্ছিক] পূর্বে এক্সপোর্ট করা স্মার্টডকগুলো ইম্পোর্ট করুন।

সবগুলো ম্যানেজমেন্ট সার্ভার আপগ্রেড হয়ে গেলে, আপনি ধাপ ১-এ এক্সপোর্ট করা স্মার্ট ডক্স মডেলগুলো ইম্পোর্ট করতে পারবেন। আপনি চাইলে এই কাজটি পরেও করতে পারেন।

আপনাকে কেবল তখনই এটি করতে হবে, যদি আপনি ড্রুপাল ৭ ভিত্তিক ডেভেলপার পোর্টাল এবং স্মার্টডকস ফিচারটি ব্যবহার করেন।

এই পর্যায়ে রানটাইম অবস্থা	এই পর্যায়ে ব্যবস্থাপনার অবস্থা
রানটাইম সম্পূর্ণরূপে কার্যকরী	ব্যবস্থাপনা সম্পূর্ণরূপে কার্যকর

ধাপ ১০ - অব্যবহৃত টেবিলগুলো মুছে ফেলুন

ক্যাসান্ড্রা ক্লাস্টার থেকে পুরোনো অব্যবহৃত টেবিলগুলো ড্রপ করতে নিম্নলিখিত কমান্ডটি চালান। এটি না চালানো পর্যন্ত, আপনি ক্যাসান্ড্রার কিছু নির্দিষ্ট ফিচার ব্যবহার করতে পারবেন না (যেমন নতুন অথেনটিকেশন সেট আপ করা – পুরোনো অথেনটিকেশন পদ্ধতিগুলো কাজ করতে থাকবে)। এই কমান্ডটি ক্লাস্টারের শুধুমাত্র একটি নোডেই চালানো যাবে।

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

ধাপ ১১ - প্রাইভেট ক্লাউড ৪.৫২.০২-এর জন্য বাকি সমস্ত এজ এবং অন্যান্য উপাদান আপগ্রেড করুন।

সমস্ত অঞ্চলের অবশিষ্ট edge-qpid-server এবং edge-postgres-server নোডগুলি এক এক করে আপগ্রেড করুন।

এই পর্যায়ে, আপনি যদি Edge for Private Cloud 4.52.01-এর আগের সংস্করণ থেকে আপগ্রেড করেন, তাহলে নিচে দেওয়া অতিরিক্ত পদক্ষেপগুলো অনুসরণ করে যথাক্রমে Qpid ও Postgres আপগ্রেড করুন এবং এই পদক্ষেপগুলো অনুযায়ী বাকি উপাদানগুলোও আপগ্রেড করুন।

Qpid J-Broker-এ আপগ্রেড করুন

যদিও Edge for Private Cloud 4.52.02-এ QPID-এর আপগ্রেড অন্তর্ভুক্ত নেই, আপনি যদি 4.52.01-এর চেয়ে পুরোনো সংস্করণ থেকে আপগ্রেড করেন, তবে আপনাকে QPID আপগ্রেড করার ধাপগুলো অনুসরণ করতে হবে।

আপনি যদি Edge for Private Cloud 4.51.00 বা 4.52.00 থেকে 4.52.02-এ আপগ্রেড করেন, তাহলে অতিরিক্ত Qpid আপগ্রেড ধাপগুলো অনুসরণ করা আবশ্যক। আপনি যদি সংস্করণ 4.51.00 বা 4.52.00 থেকে 4.52.02-এ আপগ্রেড করেন, তাহলে অনুগ্রহ করে ‘Upgrade Qpid’ বিভাগটি দেখুন।
আপনি যদি Edge for Private Cloud 4.52.01 থেকে 4.52.02-এ আপগ্রেড করেন, তাহলে আপনি ইতিমধ্যেই Qpid Broker-এর সর্বশেষ সংস্করণটি ব্যবহার করছেন এবং অতিরিক্ত কোনো Qpidupgrade ধাপের প্রয়োজন নেই।

নতুন এজ UI

এই বিভাগে Edge UI সংক্রান্ত বিবেচ্য বিষয়গুলো তালিকাভুক্ত করা হয়েছে। আরও তথ্যের জন্য, ‘The new Edge UI for Private Cloud’ দেখুন।

Edge UI ইনস্টল করুন

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

মনে রাখবেন যে, Edge UI ব্যবহারের জন্য আপনাকে Basic authentication নিষ্ক্রিয় করতে হবে এবং SAML বা LDAP-এর মতো একটি IDP ব্যবহার করতে হবে।

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

Edge UI আপডেট করুন

Edge UI কম্পোনেন্ট আপডেট করতে, আপনি Edge for the Private Cloud-এর যে সংস্করণটি থেকে আপগ্রেড করছেন, সেটি বিবেচনা করুন:

4.51.00 থেকে 4.52.00 সংস্করণে (নতুন Edge UI আগে থেকেই ইনস্টল করা থাকলে): edge-management-ui কম্পোনেন্টের জন্য এই বিভাগে দেওয়া আপগ্রেড নির্দেশাবলী ব্যবহার করুন।

Apigee mTLS দিয়ে আপডেট করুন

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

একটি আপডেট পূর্বাবস্থায় ফিরিয়ে আনা হচ্ছে

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

যদি ব্যর্থতার কারণে আপনাকে আপডেটটি পূর্ববর্তী সংস্করণে ফিরিয়ে নিতে হয়, তাহলে বিস্তারিত নির্দেশাবলীর জন্য 'রোল ব্যাক ৪.৫২.০০' দেখুন।

দ্রষ্টব্য: এজ অল-ইন-ওয়ান (AIO) এবং স্ট্যান্ডঅ্যালোন (২-নোড) টপোলজিগুলো প্রোডাকশনের জন্য নয়, বরং প্রাথমিক কাজ শুরু করা এবং প্রোটোটাইপিং পরিবেশের জন্য ডিজাইন করা হয়েছে। তাই, অল-ইন-ওয়ান (AIO) এবং স্ট্যান্ডঅ্যালোন (২-নোড) টপোলজিগুলোর জন্য কোনো রোলব্যাক পদ্ধতি নেই। যদি এই টপোলজিগুলোর আপডেট ব্যর্থ হয় এবং পুনরায় চেষ্টা করেও সমস্যার সমাধান না হয়, তবে সবচেয়ে সহজ উপায় হলো 4.52.02 সংস্করণটি নতুন করে ইনস্টল করা।

লগিং আপডেট তথ্য

ডিফল্টরূপে, update.sh ইউটিলিটি লগ তথ্য লেখে:

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

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

আপনার যদি /tmp তে প্রবেশাধিকার না থাকে, তাহলে update.sh ইউটিলিটিটি ব্যর্থ হয়।

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

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

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

কোনো ডাউনটাইম ছাড়াই আপগ্রেড করার মূল উপায় হলো, লোড ব্যালেন্সার থেকে প্রতিটি রাউটারকে এক এক করে সরিয়ে ফেলা। এরপর, রাউটার এবং সেটির সাথে একই মেশিনে থাকা অন্য যেকোনো কম্পোনেন্ট আপডেট করুন এবং রাউটারটিকে আবার লোড ব্যালেন্সারে যুক্ত করুন।

আপনার ইনস্টলেশনের জন্য বর্ণিত মেশিন আপডেটের ক্রম অনুসারে মেশিনগুলি সঠিক ক্রমে আপডেট করুন।
যখন রাউটারগুলো আপডেট করার সময় হবে, তখন 'সার্ভার (মেসেজ প্রসেসর/রাউটার) রিচেবিলিটি সক্ষম/অক্ষম করা' অংশে বর্ণিত পদ্ধতি অনুসারে যেকোনো একটি রাউটার নির্বাচন করুন এবং সেটিকে আনরিচেবল করে দিন।
নির্বাচিত রাউটার এবং রাউটারের সাথে একই মেশিনে থাকা অন্যান্য সমস্ত এজ কম্পোনেন্ট আপডেট করুন। সমস্ত এজ কনফিগারেশনে একই নোডে একটি রাউটার এবং মেসেজ প্রসেসর দেখানো হয়।
রাউটারটিকে পুনরায় প্রবেশযোগ্য করুন।
বাকি রাউটারগুলোর জন্য ২ থেকে ৪ নম্বর ধাপগুলো পুনরাবৃত্তি করুন।
আপনার ইনস্টলেশনে থাকা বাকি মেশিনগুলোর জন্য আপডেটটি চালিয়ে যান।

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

সম্মিলিত রাউটার এবং মেসেজ প্রসেসর নোডে:
- আপডেট করার আগে নিম্নলিখিতগুলি সম্পাদন করুন:
  1. রাউটারটিকে নাগালের বাইরে করে দিন।
  2. মেসেজ প্রসেসরকে নাগালের বাইরে রাখুন।
- আপডেট করার পর নিম্নলিখিতগুলি সম্পাদন করুন:
  1. মেসেজ প্রসেসরটিকে প্রবেশযোগ্য করুন।
  2. রাউটারটিকে প্রবেশযোগ্য করুন।
একক রাউটার নোডগুলিতে:
- আপডেট করার আগে রাউটারটিকে নাগালের বাইরে রাখুন ।
- আপডেট করার পর রাউটারটিকে যোগাযোগযোগ্য করুন ।
একক মেসেজ প্রসেসর নোডগুলিতে:
- আপডেট করার আগে মেসেজ প্রসেসরকে নাগালের বাইরে রাখুন ।
- আপডেট করার পর মেসেজ প্রসেসরটিকে প্রবেশযোগ্য করুন ।

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

আপনাকে অবশ্যই আপডেট কমান্ডে একটি সাইলেন্ট কনফিগারেশন ফাইল পাস করতে হবে। সাইলেন্ট কনফিগারেশন ফাইলটি অবশ্যই সেই একই ফাইল হতে হবে যা আপনি Edge 4.50.00 বা 4.51.00 ইনস্টল করার জন্য ব্যবহার করেছিলেন।

বাহ্যিক ইন্টারনেট সংযোগযুক্ত একটি নোডে 4.52.02 সংস্করণে আপডেট করুন।

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

যদি থাকে, তাহলে আপডেট সম্পন্ন না হওয়া পর্যন্ত ক্যাসান্ড্রাতে মেরামত কার্যক্রম চালানোর জন্য কনফিগার করা যেকোনো cron জব নিষ্ক্রিয় করুন।
Edge RPM-গুলো ইনস্টল করতে আপনার নোডে রুট হিসেবে লগ ইন করুন।
দ্রষ্টব্য: যদিও RPM ইনস্টলেশনের জন্য রুট অ্যাক্সেসের প্রয়োজন হয়, আপনি রুট অ্যাক্সেস ছাড়াই Edge কনফিগারেশন করতে পারেন।
yum-utils এবং yum-plugin-priorities ইনস্টল করুন:
দ্রষ্টব্য: আপনার অপারেটিং সিস্টেম RHEL 8.0 - 8.6 হলে, এই ধাপটি এড়িয়ে যান।
```
sudo yum install yum-utils
sudo yum install yum-plugin-priorities
```
Edge apigee-setup ইউটিলিটি ইনস্টল করার অংশে বর্ণিত পদ্ধতি অনুযায়ী SELinux নিষ্ক্রিয় করুন।
আপনি যদি ওরাকল ৭.x-এ ইনস্টল করেন , তাহলে নিম্নলিখিত কমান্ডটি চালান:
```
sudo yum-config-manager --enable ol7_optional_latest
```
আপনি যদি 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
```
আপনি যদি বর্তমানে এজ ৪.৫১.০০ ব্যবহার করে থাকেন:
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.52.02.sh
```
2. নিম্নলিখিত কমান্ডটি চালিয়ে Edge 4.52.02 apigee-service ইউটিলিটি এবং এর নির্ভরশীলতাগুলো ইনস্টল করুন:
```
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
```
  এখানে uName:pWord হলো Apigee থেকে পাওয়া আপনার ইউজারনেম এবং পাসওয়ার্ড। আপনি যদি pWord উল্লেখ না করেন, তবে আপনাকে এটি লিখতে বলা হবে।
  ডিফল্টরূপে, ইনস্টলারটি পরীক্ষা করে দেখে যে আপনার সিস্টেমে জাভা ১.৮ ইনস্টল করা আছে কিনা। যদি তা না থাকে, তবে ইনস্টলারটি আপনার জন্য এটি ইনস্টল করে দেয়।
  জাভা ইনস্টলেশন কীভাবে পরিচালনা করা হবে তা নির্দিষ্ট করতে JAVA_FIX অপশনটি ব্যবহার করুন। JAVA_FIX মানগুলো হলো:
  - I : OpenJDK 1.8 ইনস্টল করুন (ডিফল্ট)।
  - C : জাভা ইনস্টল না করেই চালিয়ে যান।
  - Q : প্রস্থান করুন। এই বিকল্পটির জন্য, আপনাকে নিজে থেকেই জাভা ইনস্টল করতে হবে।
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 হলো আপডেট করার জন্য এজ কম্পোনেন্ট। সম্ভাব্য মানগুলো হলো:
    - cs : ক্যাসান্ড্রা
    - edge : Edge UI ছাড়া Edge-এর সকল উপাদান: ম্যানেজমেন্ট সার্ভার, মেসেজ প্রসেসর, রাউটার, Qpid সার্ভার, Postgres সার্ভার
    - ldap : OpenLDAP
    - ps : পোস্টগ্রেসকিউএল
    - qpid : qpidd
    - sso : Apigee SSO (যদি আপনি SSO ইনস্টল করে থাকেন)
    - ue : নতুন এজ UI
    - ui : ক্লাসিক এজ UI
    - zk : চিড়িয়াখানার রক্ষক
  - configFile হলো সেই একই কনফিগারেশন ফাইল যা আপনি 4.50.00 বা 4.51.00 ইনস্টলেশনের সময় আপনার Edge কম্পোনেন্টগুলো সংজ্ঞায়িত করতে ব্যবহার করেছিলেন।
  আপনি ` component `all`-এ সেট করে সমস্ত কম্পোনেন্টের বিরুদ্ধে 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. ইনস্টলেশন পরীক্ষা করুন (Test the install ) অংশে বর্ণিত পদ্ধতি অনুযায়ী ম্যানেজমেন্ট সার্ভারে apigee-validate ইউটিলিটিটি চালিয়ে আপডেটটি পরীক্ষা করুন।

আপনি যদি পরবর্তীতে আপডেটটি রোল ব্যাক করার সিদ্ধান্ত নেন, তাহলে রোল ব্যাক ৪.৫২.০২-এ বর্ণিত পদ্ধতিটি ব্যবহার করুন।

স্থানীয় রিপো থেকে 4.52.02-এ আপডেট করুন

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

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

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

স্থানীয় 4.52.02 রিপো থেকে আপডেট করতে:

Edge apigee-setup ইউটিলিটি ইনস্টল করার সময় 'একটি স্থানীয় Apigee রিপোজিটরি তৈরি করুন' অংশে বর্ণিত পদ্ধতি অনুসরণ করে একটি স্থানীয় 4.52.02 রিপো তৈরি করুন।
দ্রষ্টব্য: আপনার যদি আগে থেকেই একটি রিপো থাকে, তাহলে আপনি Install the Edge apigee-setup utility- এর 'Update a local Apigee repository' অংশে বর্ণিত পদ্ধতি অনুসরণ করে 4.52.02 রিপোটি তাতে যোগ করতে পারেন।
একটি .tar ফাইল থেকে apigee-service ইনস্টল করতে :
1. On the node with the local repo, use the following command to package the local repo into a single .tar file named /opt/apigee/data/apigee-mirror/apigee-4.52.02.tar.gz :
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
2. Copy the .tar file to the node where you want to update Edge. For example, copy it to the /tmp directory on the new node.
3. On the new node, untar the file to the /tmp directory:
```
tar -xzf apigee-4.52.02.tar.gz
```
  This command creates a new directory, named repos , in the directory containing the .tar file. For example /tmp/repos .
4. Install the Edge apigee-service utility and dependencies from /tmp/repos :
```
sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
  Notice that you include the path to the repos directory in this command.
To install apigee-service using the Nginx webserver:
1. Configure the Nginx web server as described in "Install from the repo using the Nginx webserver" at Install the Edge apigee-setup utility .
2. On the remote node, download the Edge bootstrap_4.52.02.sh file to /tmp/bootstrap_4.52.02.sh :
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
```
  Where uName:pWord are the username and password you set previously for the repo, and remoteRepo is the IP address or DNS name of the repo node.
3. On the remote node, install the Edge apigee-setup utility and dependencies:
```
sudo bash /tmp/bootstrap_4.52.02.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
  Where uName:pWord are the repo username and password.
Use apigee-service to update the apigee-setup utility, as the following example shows:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
```
Update the apigee-validate utility on the Management Server, as the following example shows:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
Update the apigee-provision utility on the Management Server, as the following example shows:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
Run the update utility on your nodes in the order described in Order of machine update :
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
কোথায়:
- component is the Edge component to update. You typically update the following components:
  - cs : Cassandra
  - edge : All Edge components except Edge UI: Management Server, Message Processor, Router, Qpid Server, Postgres Server
  - ldap : OpenLDAP
  - ps : postgresql
  - qpid : qpidd
  - sso : Apigee SSO (if you installed SSO)
  - ue New Edge UI
  - ui : Classic Edge UI
  - zk : Zookeeper
- configFile is the same configuration file that you used to define your Edge components during the 4.50.00 or 4.51.00 installation.
  NOTE: The configuration file must be readable by the "apigee" user. To change the owner, use the following command:
```
chown apigee:apigee configFile
```
You can run update.sh against all components by setting component to "all", but only if you have an Edge all-in-one (AIO) installation profile. For example:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
```

Restart the UI components on all nodes running it, if you haven't done so already:

/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart

Test the update by running the apigee-validate utility on the Management Server, as described in Test the install .

If you later decide to roll back the update, use the procedure described in Roll back 4.52.02 .

Order of machine update - upgrade from 4.51.00 (or) 4.52.00 (or) 4.52.01

The order that you update the machines in an Edge installation is important:

You must update all ZooKeeper nodes across data centers before upgrading all other components. If you are upgrading from Edge Private Cloud 4.51.00 (or) 4.52.00, you will also need to follow additional steps to upgrade zookeeper .
You must update Postgresql across all the data centers. If you are upgrading from Edge Private Cloud 4.51.00, you will also need to follow additional steps to upgrade postgres .
You must update LDAP nodes across all the data centers.
You must update all Cassandra, Management Server, Message Processor and Router nodes, one data center at a time , until all data centers are upgraded.
You must update edge-qpid-server & edge-postgres-server components across all data centers.
You must upgrade Qpid nodes across all data centers. If you are upgrading from Edge Private Cloud 4.51.00 (or) 4.52.00, you will also need to follow additional steps to upgrade Qpid .
Update Edge UI and New Edge UI, SSO nodes across all data centers.
There is no separate step to update Monetization. It is updated when you specify the -c edge option.
Note: After you update the Edge UI component, you must restart the Edge UI service, as described in the update installation instructions.

1-node standalone upgrade

To upgrade a 1-node standalone configuration to 4.52.02:

Update all components:

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

(If you installed apigee-adminapi ) Updated the apigee-adminapi utility:

/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

2-node standalone upgrade

Update the following components for a 2-node standalone installation:

See Installation topologies for the list of Edge topologies and node numbers.

Update Zookeeper on machine 1:

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

Update Postgres on machine 2:

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

Update LDAP on machine 1:

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

Update Cassandra on machine 1:

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

Update Edge components on machine 1 and 2:

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

Update Qpid on Machine 2:

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

Update the UI on machine 1:

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

(If you installed apigee-adminapi ) Updated the apigee-adminapi utility on machine 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(If you installed Apigee SSO) Update Apigee SSO on machine 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
Where sso_config_file is the configuration file you created when you installed SSO .

Restart the Edge UI component on machine 1:

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

5-node upgrade

Update the following components for a 5-node installation:

See Installation topologies for the list of Edge topologies and node numbers.

Update ZooKeeper on machines 1, 2, and 3:

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

Update Postgres on machine 4:

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

Update Postgres on machine 5:

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

Update LDAP on machine 1:

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

Update Cassandra on machines 1, 2, and 3:

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

Update Edge components on machines 1, 2, 3, 4, 5:

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

Update Qpid on machine 4:

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

Update Qpid on machine 5:

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

Update the Edge UI:
- Classic UI: If you are using the classic UI, then update the ui component on machine 1, as the following example shows:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
- New Edge UI: If you installed the new Edge UI, then update the ue component on the appropriate machine (may not be machine 1):
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
```
(If you installed apigee-adminapi ) Updated the apigee-adminapi utility on machine 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(If you installed Apigee SSO) Update Apigee SSO on machine 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
Where sso_config_file is the configuration file you created when you installed SSO .
Restart the UI component:
- Classic UI: If you are using the classic UI, then restart the edge-ui component on machine 1, as the following example shows:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
- New Edge UI: If you installed the new Edge UI, then restart the edge-management-ui component on the appropriate machine (may not be machine 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

9-node cluster upgrade

Update the following components for a 9-node clustered installation:

See Installation topologies for the list of Edge topologies and node numbers.

Update ZooKeeper on machine 1, 2, and 3:

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

Update Postgres on machine 8:

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

Update Postgres on machine 9:

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

Update LDAP on machine 1:

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

Update Cassandra on machine 1, 2, and 3:

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

Update Edge components on machines 1, 4, 5, 6, 7, 8, and 9 in that order:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Update Qpid on machines 6 and 7:

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

Update either the new UI ( ue ) or classic UI ( ui ) on machine 1:

/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

(If you installed apigee-adminapi ) Update the apigee-adminapi utility on machine 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(If you installed Apigee SSO) Update Apigee SSO on machine 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
Where sso_config_file is the configuration file you created when you installed SSO .
Restart the UI component:
- Classic UI: If you are using the classic UI, then restart the edge-ui component on machine 1, as the following example shows:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
- New Edge UI: If you installed the new Edge UI, then restart the edge-management-ui component on the appropriate machine (may not be machine 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

13-node cluster upgrade

Update the following components for a 13-node clustered installation:

See Installation topologies for the list of Edge topologies and node numbers.

Update ZooKeeper on machines 1, 2, and 3:

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

Update Postgres on machine 8:

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

Update Postgres on machine 9:

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

Update LDAP on machines 4 and 5:

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

Update Cassandra on machines 1, 2, and 3:

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

Update Edge components on machines 6, 7, 10, 11, 12, 13, 8, and 9 in that order:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Update Qpid on machines 12 and 13:

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

Update either the new UI ( ue ) or classic UI ( ui ) on machines 6 and 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
(If you installed apigee-adminapi ) Updated the apigee-adminapi utility on machines 6 and 7:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(If you installed Apigee SSO) Update Apigee SSO on machines 6 and 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
Where sso_config_file is the configuration file you created when you installed SSO .
Restart the UI component:
- Classic UI: If you are using the classic UI, then restart the edge-ui component on machines 6 and 7, as the following example shows:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
- New Edge UI: If you installed the new Edge UI, then restart the edge-management-ui component on machines 6 and 7:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

12-node cluster upgrade

Update the following components for a 12-node clustered installation:

See Installation topologies for the list of Edge topologies and node numbers.

Update ZooKeeper on machines 1,2,3,7,8,9 in both DCs:

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

Update Postgres on machines 6,12 in both DCs:

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

Update LDAP on machines 1,7 in both DCs:

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

Block the traffic in DC-1 and make sure all the traffic rerouted to other DC-2

Update Update Cassandra on machine 1,2,3 in DC-1:

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

Update Management Server on machine 1 in DC-1:

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

Update Router, Message Processor on machine 2,3 in DC-1:

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

Unblock the traffic in DC-1 and validate the DC-1 and proceed with the DC-2 by blocking traffic in DC-2 and reroute the traffic to DC-1

Update Cassandra on machine 7,8,9 in DC-2:

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

Update Management Server on machine 7 in DC-2:

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

Update Router, Message Processor on machine 8,9 in DC-2:

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

Unblock the traffic in DC-2 and now, both DCs will handle traffic
Re-run the update command in all the management-server across DCs on machine 1 & 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
Update edge-qpid-server & edge-postgres-server on machine 4,5,6,10,11,12 in both DCs:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Update Qpid on machine 4,5,10,11 in both DCs:

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

Update either the new UI (ue) or classic UI (ui) in both DCs:

/opt/apigee/apigee-setup/bin/update.sh -c  [ui|ue] -f configFile

(If you installed apigee-adminapi) Update the apigee-adminapi in both DCs:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(If you installed Apigee SSO) Update Apigee SSO nodes in both DCs:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
```
Restart the new Edge UI (edge-management-ui) or classic Edge UI (edge-ui) component in both DCs:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
```