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 ইনস্টল করেছেন অথবা রুট হিসেবে চালাচ্ছেন।

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

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

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

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

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

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

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

  • Edge চলছে কিনা দেখুন
    আপডেট প্রসেস চলাকালীন Edge চলছে কিনা তা নিশ্চিত করতে এই কমান্ড ব্যবহার করুন:
    /opt/apigee/apigee-service/bin/apigee-all status
  • Cassandra কম্প্যাকশন স্ট্র্যাটেজি LeveledCompactionStrategy
    আপনার বর্তমান ভার্সনের উপর নির্ভর করে, Cassandra কম্প্যাকশন স্ট্র্যাটেজিতে প্রয়োজনীয় পরিবর্তন করুন। নিচে উল্লেখ করা ধাপগুলি অনুসরণ করুন এবং তারপর আপগ্রেড করার মূল প্রসেসে ফিরে যান:

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

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

বর্তমান ভার্সন 4.52.02 ভার্সনে আপগ্রেড করার জন্য বিশেষ ধাপ প্রয়োজন এমন সফ্টওয়্যার
4.52.01 Cassandra
4.52.00 Zookeeper, Cassandra, Qpid
4.51.00 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 আপগ্রেড করতে Zookeeper 3.8.3-এ প্রয়োজনীয় আপগ্রেড-এ দেওয়া ধাপগুলি দেখুন।
  • আপনি যদি Edge for Private Cloud ভার্সন 4.52.01 থেকে আপগ্রেড করেন, তাহলে আপনাকে অবশ্যই Zookeeper ভার্সন 3.8.3 ব্যবহার করতে হবে এবং 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 আপগ্রেড ধাপ প্রয়োজন। Postgres 14-এ প্রয়োজনীয় আপগ্রেড বিভাগটি দেখুন।
  • আপনি Edge for Private Cloud 4.52.00 বা 4.52.01 থেকে 4.52.02 ভার্সনে আপগ্রেড করলে, অতিরিক্ত Postgres আপগ্রেড ধাপের প্রয়োজন নেই।

Cassandra 3.11.16-এ আপগ্রেড করুন

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

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

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

Developer Portal - Documenting APIs

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

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

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

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

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

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

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

আপগ্রেড স্ট্র্যাটেজি

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

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

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

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

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

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

  • OAuth টোকেন রিফ্রেশ করা Runtime API
  • Access Entity Policy ব্যবহার করে রানটাইম API
  • ম্যানেজমেন্ট API-এর তালিকাভুক্ত ডেভেলপার অ্যাপ
  • প্রোডাক্ট তালিকাভুক্ত করার ম্যানেজমেন্ট API

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

রোলব্যাক - উচ্চ লেভেল

  • রোলব্যাক করার সময় প্রভাব

    Cassandra 3.11.x থেকে 2.1.x-এ রোলব্যাক করলে, রোলব্যাক করা হচ্ছে এমন ডেটা সেন্টারের (DC) মধ্যে রানটাইম ও ম্যানেজমেন্ট ট্রাফিক, দুটিই প্রভাবিত হয়। এছাড়াও, বর্তমানে যে ডিসি রোল ব্যাক করা হচ্ছে তা নির্বিশেষে, সমস্ত ডেটা সেন্টার জুড়ে নির্দিষ্ট ম্যানেজমেন্ট API-তে বাধা পড়তে পারে।

  • DC-র মাধ্যমে DC রোলব্যাক অ্যাপ্রোচ ফলো করুন

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

  • আংশিক আপগ্রেড করা ক্লাস্টার রোল ব্যাক করা

    Cassandra (2.1.22)-এর পুরনো ভার্সনে অন্তত একটি ডেটা সেন্টার সম্পূর্ণভাবে চালু থাকলে, অন্যান্য আপগ্রেড করা ডিসি (DC)-কে সম্পূর্ণভাবে চালু থাকা Cassandra 2.1.X ডিসি (DC) থেকে আবার বিল্ড করার মাধ্যমে রোল ব্যাক করা যেতে পারে।

  • ক্লাস্টার-ওয়াইড রোলব্যাক

    সম্পূর্ণ Cassandra ক্লাস্টার আপগ্রেড করা হয়ে থাকলে এবং রোলব্যাক করার প্রয়োজন হলে, ব্যাক-আপ বা VM স্ন্যাপশট ব্যবহার করে তা করতে হবে। এই পদ্ধতিটি জটিল এবং এর ফলে সাময়িক ডাউনটাইম বা ডেটা হারিয়ে যেতে পারে।

  • আপগ্রেড করার আগে বিবেচ্য বিষয়

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

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

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

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

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

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

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

বিস্তারিত জানতে Cassandra 3.11.16 আপডেট রোলব্যাক করুন বিভাগ দেখুন।

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

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

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

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

  1. LeveledCompactionStrategy ব্যবহার করার জন্য Cassandra পরিবর্তন করুন।
  2. Apigee ব্যবহার করে Cassandra-র ব্যাক-আপ নিন।
  3. Cassandra নোডের VM স্ন্যাপশট নিন (সম্ভব হলে)।
  4. নিম্নলিখিত কন্টেন্ট সহ /opt/apigee/apigee-cassandra/cass_upgrade.conf-এ প্রতিটি Cassandra নোডে একটি Cassandra আপগ্রেড কনফিগারেশন ফাইল তৈরি করুন:
    # 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-এ ফাইল তৈরি করা না গেলে, প্রতিটি Cassandra নোডে একই কন্টেন্ট সহ /opt/silent.conf ফাইল তৈরি করুন।
  5. আপনি যদি Apigee Drupal 7 ডেভেলপার পোর্টালের SmartDocs ফিচার ব্যবহার করেন, ডেভেলপার পোর্টাল UI থেকে JSON ফর্ম্যাটে ডাউনলোড করে আপনার প্রতিটি মডেলের এক্সপোর্ট নিন। ম্যানেজমেন্ট সার্ভার আপডেট করার পরে এইসব মডেলকে আবার Apigee-তে ইমপোর্ট করতে হবে।
  6. আগে থেকে না থাকলে, নিশ্চিত করুন যে পোর্ট ৯১৬০ এবং ৯০৪২ যেন সব Edge কম্পোনেন্ট থেকে Cassandra নোডে অ্যাক্সেস করা যায়। আরও তথ্যের জন্য পোর্ট সংক্রান্ত প্রয়োজনীয়তা দেখুন।

ধাপ ২: প্রথম ডেটা সেন্টার থেকে ট্রাফিক রিডাইরেক্ট করা

  1. প্রথম ডেটা সেন্টার থেকে আসা ইনকামিং রানটাইম ও ম্যানেজমেন্ট ট্রাফিক ব্লক করুন।
  2. অন্যান্য কার্যকরী ডেটা সেন্টারে সব রানটাইম ট্রাফিক ও ম্যানেজমেন্ট API রিডাইরেক্ট করুন।
  3. অন্যান্য ডিসি(DC) রানটাইম ও ম্যানেজমেন্ট ট্রাফিক সঠিকভাবে ম্যানেজ করছে কিনা তা যাচাই করুন।

ধাপ ৩: প্রথম ডেটা সেন্টারে সব Cassandra নোড আপগ্রেড করা

  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
    উপরের কোডটি এই ধরনের আউটপুট দেবে:
    Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
  3. আপগ্রেড সম্পূর্ণ হওয়ার পরে প্রতিটি Cassandra নোডে একটি একটি করে নিম্নলিখিত post_upgrade কমান্ড রান করুন:
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
এই পর্যায়ে রানটাইম স্টেট এই পর্যায়ে ম্যানেজমেন্টের অবস্থা
  • আপগ্রেড করা হচ্ছে এমন ডেটা সেন্টারে রানটাইম ট্রাফিক ব্লক করা
  • অন্যান্য ডেটা সেন্টারে রানটাইম সম্পূর্ণভাবে কাজ করে

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

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

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
এই পর্যায়ে রানটাইম স্টেট এই পর্যায়ে ম্যানেজমেন্টের অবস্থা
  • আপগ্রেড করা হচ্ছে এমন ডেটা সেন্টারে রানটাইম ট্রাফিক ব্লক করা
  • রানটাইম সম্পূর্ণভাবে কাজ করে

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

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

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
এই পর্যায়ে রানটাইম স্টেট এই পর্যায়ে ম্যানেজমেন্টের অবস্থা
  • আপগ্রেড করা হচ্ছে এমন ডেটা সেন্টারে রানটাইম ট্রাফিক ব্লক করা
  • অন্যান্য ডেটা সেন্টারে রানটাইম সম্পূর্ণভাবে কাজ করে

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

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

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

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

ধাপ ৮: সব ম্যানেজমেন্ট নোডে আপগ্রেড করার ধাপ আবার চালান

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

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

ধাপ ৯ - [ঐচ্ছিক] আগে এক্সপোর্ট করা smartdocs ইমপোর্ট করুন

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

আপনি Drupal 7-এর উপর ভিত্তি করে ডেভেলপার পোর্টাল ব্যবহার করলে এবং smartdocs ফিচার ব্যবহার করলে তবেই আপনাকে এটি করতে হবে।

এই পর্যায়ে রানটাইম স্টেট এই পর্যায়ে ম্যানেজমেন্টের অবস্থা
রানটাইম সম্পূর্ণভাবে কাজ করে ম্যানেজমেন্ট পুরোপুরি কাজ করছে

ধাপ ১০ - অব্যবহৃত টেবিল ড্রপ করা

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

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

ধাপ ১১ - Private Cloud 4.52.02-এর জন্য বাকি সব Edge ও অন্যান্য কম্পোনেন্ট আপগ্রেড করুন

সব অঞ্চলে বাকি থাকা 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 ভার্সনে আপগ্রেড করলে, Qpid আপগ্রেড করুন বিভাগটি দেখুন।
  • আপনি Edge for Private Cloud 4.52.01 থেকে 4.52.02-এ আপগ্রেড করলে, আপনাকে অবশ্যই Qpid Broker-এর লেটেস্ট ভার্সন ব্যবহার করতে হবে এবং অতিরিক্ত Qpidupgrade ধাপের প্রয়োজন হবে না।

নতুন Edge UI

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

Edge UI ইনস্টল করা

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

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

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

Edge UI আপডেট করা

Edge UI কম্পোনেন্ট আপডেট করতে, প্রাইভেট ক্লাউডের জন্য Edge-এর সেই ভার্সন বিবেচনা করুন যেখান থেকে আপনি আপগ্রেড করছেন:

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

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

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

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

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

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

ডিফল্ট হিসেবে, 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 4.50.00 বা 4.51.00 ইনস্টল করার সময় আপনি যে ফাইলটি ব্যবহার করেছিলেন, সেটিই হতে হবে।

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

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

  1. উপস্থিত থাকলে, আপডেট সম্পূর্ণ না হওয়া পর্যন্ত Cassandra-তে মেরামত অপারেশন পারফর্ম করার জন্য কনফিগার করা যেকোনও cron জব বন্ধ করুন।
  2. Edge RPM ইনস্টল করতে, আপনার নোডে রুট হিসেবে লগ-ইন করুন।
  3. yum-utils ও yum-plugin-priorities ইনস্টল করুন:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities
  4. Edge apigee-setup ইউটিলিটি ইনস্টল করুন লিঙ্কে বর্ণিত পদ্ধতি অনুযায়ী SELinux বন্ধ করুন।
  5. আপনি Oracle 7.x-এ ইনস্টল করলে, নিম্নলিখিত কমান্ডটি এক্সিকিউট করুন:
    sudo yum-config-manager --enable ol7_optional_latest
  6. আপনি 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
  7. আপনি বর্তমানে Edge 4.51.00 ব্যবহার করলে:

    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

      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.50.00 বা 4.51.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.52.02 রোল ব্যাক করুন লিঙ্কে বর্ণিত পদ্ধতি ব্যবহার করুন।

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

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

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

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

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

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

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

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

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

  3. Nginx ওয়েবসার্ভার ব্যবহার করে apigee-service ইনস্টল করতে:
    1. Edge ইনস্টল করুন apigee-setup ইউটিলিটি লিঙ্কে "Nginx ওয়েব সার্ভার ব্যবহার করে রিপোজিটরি থেকে ইনস্টল করুন" নিবন্ধে বর্ণিত পদ্ধতি অনুযায়ী Nginx ওয়েব সার্ভার কনফিগার করুন।
    2. রিমোট নোডে, Edge bootstrap_4.52.02.sh ফাইলটি এখানে ডাউনলোড করুন: /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

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

    3. রিমোট নোডে, Edge apigee-setup ইউটিলিটি ও ডিপেন্ডেন্সি ইনস্টল করুন:
      sudo bash /tmp/bootstrap_4.52.02.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 হল সেই একই কনফিগারেশন ফাইল যা আপনি ৪.৫০.০০ বা ৪.৫১.০০ ইনস্টলেশনের সময় আপনার 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.52.02 রোল ব্যাক করুন-এ বর্ণিত পদ্ধতি ব্যবহার করুন।

মেশিন আপডেট করার ক্রম - 4.51.00 (বা) 4.52.00 (বা) 4.52.01 থেকে আপগ্রেড করুন

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

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

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

1-নোড স্ট্যান্ডঅ্যালোন কনফিগারেশনকে 4.52.02-এ আপগ্রেড করতে:
  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. মেশিন ১-এ Zookeeper আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. মেশিন ২-এ Postgres আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. মেশিন ১-এ LDAP আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. মেশিন ১-এ Cassandra আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -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. মেশিন ১, ২ ও ৩-এ ZooKeeper আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. মেশিন ৪-এ Postgres আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. মেশিন ৫-এ Postgres আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. মেশিন ১-এ LDAP আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. মেশিন ১, ২ ও ৩-এ Cassandra আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -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. মেশিন ১, ২ ও ৩-এ ZooKeeper আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. মেশিন ৮-এ Postgres আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. মেশিন ৯-এ Postgres আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. মেশিন ১-এ LDAP আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. মেশিন ১, ২ ও ৩-এ Cassandra আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -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. মেশিন ১, ২ ও ৩-এ ZooKeeper আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. মেশিন ৮-এ Postgres আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. মেশিন ৯-এ Postgres আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. মেশিন ৪ ও ৫-এ LDAP আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. মেশিন ১, ২ ও ৩-এ Cassandra আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -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. দুটি DC-তে মেশিন ১,২,৩,৭,৮,৯-এ ZooKeeper আপডেট করুন:

    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. দুটি DC-তে মেশিন ৬,১২-এ Postgres আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. দুটি DC-তে মেশিন ১,৭-এ LDAP আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. DC-1-এ ট্রাফিক ব্লক করুন এবং নিশ্চিত করুন যে সমস্ত ট্রাফিক অন্য DC-2-এ রিডাইরেক্ট করা হয়েছে

  5. DC-1-এ মেশিন ১,২,৩-এ Cassandra আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. DC-1-এ মেশিন ১-এ আপডেট ম্যানেজমেন্ট সার্ভার:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. DC-1-এ মেশিন ২, ৩-এ রাউটার,মেসেজ প্রসেসর আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. DC-1-এ ট্রাফিক আনব্লক করুন এবং DC-1 যাচাই করে DC-2-তে ট্রাফিক ব্লক করে DC-2-এর সাথে প্রসেস চালিয়ে যান এবং DC-1-এ ট্রাফিক রি-রাউট করুন
  9. DC-2-এর মেশিন ৭,৮,৯-এ Cassandra আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  10. DC-2-এর মেশিন ৭-এ ম্যানেজমেন্ট সার্ভার আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. DC-2-এর মেশিন ৮, ৯-এ রাউটার,মেসেজ প্রসেসর আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. DC-2-তে ট্রাফিক আনব্লক করুন এবং এখন, দুটি DC-ই ট্রাফিক ম্যানেজ করবে
  13. মেশিন ১ ও ৭-এর DC জুড়ে ম্যানেজমেন্ট-সার্ভারে আপডেট কমান্ড আবার রান করান:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  14. দুটি DC-তে মেশিন ৪,৫,৬,১০,১১,১২-এ edge-qpid-server ও edge-postgres-server আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. দুটি DC-তে মেশিন ৪,৫,১০,১১-এ Qpid আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  16. দুটি DC-তে নতুন UI (ue) বা ক্লাসিক UI (ui) আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c  [ui|ue] -f configFile
  17. (আপনি apigee-adminapi ইনস্টল করে থাকলে) দুটি DC-তে apigee-adminapi আপডেট করুন:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  18. (আপনি Apigee SSO ইনস্টল করে থাকলে) দুটি DC-তে Apigee SSO নোড আপডেট করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  19. দুটি DC-তেই নতুন Edge UI (edge-management-ui) বা ক্লাসিক Edge UI (edge-ui) কম্পোনেন্ট রিস্টার্ট করুন:
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart