Edge ইনস্টলেশন ওভারভিউ

সাধারণত Edge ইনস্টল করার সময় একাধিক নোড জুড়ে Edge কম্পোনেন্ট ডিস্ট্রিবিউট করা হয়। আপনি কোনও নোডে Edge ইনস্টল করার পরে, আপনি নোডে এক বা একাধিক Edge কম্পোনেন্ট ইনস্টল এবং কনফিগার করেন।

ইনস্টলেশন প্রসেস

কোনও নোডে Edge ইনস্টল করা একটি একাধিক ধাপের প্রসেস:

1. নোডে SELinux বন্ধ করুন অথবা এটিকে অনুমোদিত মোডে সেট করুন। আরও জানতে Edge apigee-setup ইউটিলিটি ইনস্টল করুন দেখুন।
2. আপনি Cassandra যাচাইকরণ চালু করতে চান কিনা সেই ব্যাপারে সিদ্ধান্ত নিন।
3. Postgres-এর জন্য মাস্টার-স্ট্যান্ডবাই রেপ্লিকেশন সেট-আপ করতে চান কিনা তা ঠিক করুন।
4. সাজেস্ট করা টপোলজি তালিকা থেকে আপনার Edge কনফিগারেশন বেছে নিন। যেমন, আপনি পরীক্ষা করার জন্য একটি নোডে বা প্রোডাকশনের জন্য ১৩টি নোডে Edge ইনস্টল করতে পারেন। আরও জানতে ইনস্টলেশন টপোলজি দেখুন।
5. আপনার বেছে নেওয়া টপোলজির প্রতিটি নোডে, Edge apigee-setup ইউটিলিটি ইনস্টল করুন:
   • Edge bootstrap_4.54.00.sh ফাইলটি /tmp/bootstrap_4.54.00.sh-এ ডাউনলোড করুন।
   • Edge apigee-service ইউটিলিটি ও ডিপেন্ডেন্সি ইনস্টল করুন।
   • Edge apigee-setup ইউটিলিটি ও ডিপেন্ডেন্সি ইনস্টল করুন।

     আরও জানতে Edge apigee-setup ইউটিলিটি ইনস্টল করুন দেখুন।

6. আপনার বেছে নেওয়া টপোলজি অনুযায়ী প্রতিটি নোডে এক বা একাধিক Edge কম্পোনেন্ট ইনস্টল করতে apigee-setup ইউটিলিটি ব্যবহার করুন।

   নোডে Edge কম্পোনেন্ট ইনস্টল করা দেখুন।

7. ম্যানেজমেন্ট সার্ভার নোডে, apigee-setup ইউটিলিটি ব্যবহার করে apigee-provision ইনস্টল করুন, যে ইউটিলিটি আপনি Edge প্রতিষ্ঠান তৈরি ও ম্যানেজ করতে ব্যবহার করেন।

   আরও জানতে কোনও সংস্থাকে অনবোর্ড করা দেখুন।

8. ইনস্টলেশন সম্পূর্ণ হওয়ার পরে, প্রতিটি নোডে New Edge UI কম্পোনেন্ট রিস্টার্ট করুন, যেমন নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

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

9. নতুন Edge UI-এর জন্য (যার কম্পোনেন্টের নাম হল edge-management-ui ও edge-management-ui-static) যাচাইকরণ ও ঐচ্ছিক সেটিংস কনফিগার করুন।

   আরও তথ্যের জন্য, নতুন Edge UI কনফিগার করুন দেখুন।

ইনস্টলেশন সম্পূর্ণ হওয়ার পরে, ইনস্টলেশন পরবর্তী সাধারণ অ্যাকশনের এই তালিকা দেখুন।

কে ইনস্টল করতে পারবেন

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

যেসব ব্যবহারকারী নিম্নলিখিত কমান্ড বা স্ক্রিপ্ট চালাতে চান, তাদের হয় রুট হতে হবে অথবা সম্পূর্ণ sudo অ্যাক্সেস সহ ব্যবহারকারী হতে হবে:

• apigee-service ইউটিলিটি:
  • apigee-service কমান্ড: install, uninstall, update.
  • apigee-all কমান্ড: install, uninstall, update.
• Edge কম্পোনেন্ট ইনস্টল করার জন্য setup.sh স্ক্রিপ্ট (প্রয়োজনীয় RPM ইনস্টল করার জন্য "apigee-service install" আগে থেকেই ব্যবহার করে থাকলে এটি প্রযোজ্য নয়। তারপরে রুট বা সম্পূর্ণ sudo অ্যাক্সেস (প্রয়োজন না হলে লাগবে না)।)
• Edge কম্পোনেন্ট আপডেট করার জন্য update.sh স্ক্রিপ্ট

এছাড়াও, Edge ইনস্টলার আপনার সিস্টেমে "apigee" নামে একটি নতুন ব্যবহারকারী তৈরি করে। অনেক Edge কমান্ড "apigee" ব্যবহারকারী হিসেবে চালানোর জন্য sudo আহ্বান করে।

উপরে দেখানো কমান্ড ছাড়া অন্য কোনও কমান্ড রান করতে চাইলে, ব্যবহারকারীর কাছে "apigee" ব্যবহারকারীর জন্য সম্পূর্ণ sudo অ্যাক্সেস থাকতে হবে। এইসব কমান্ডের মধ্যে রয়েছে:

• apigee-service ইউটিলিটি কমান্ড, যার মধ্যে এগুলি অন্তর্ভুক্ত:
  • apigee-service কমান্ড, যেমন start, stop, restart, configure।
  • apigee-all কমান্ড, যেমন start, stop, restart, configure।

"apigee" ব্যবহারকারীর জন্য সম্পূর্ণ সুডো অ্যাক্সেস সহ ব্যবহারকারী তৈরি করা

"apigee" ব্যবহারকারীর জন্য সম্পূর্ণ sudo অ্যাক্সেস সহ কোনও ব্যবহারকারীকে কনফিগার করতে, "visudo" কমান্ড ব্যবহার করে sudoers ফাইল এডিট করে এটি যোগ করুন:

installUser        ALL=(apigee)      NOPASSWD: ALL

Edge-এ কাজ করা ব্যক্তির ইউজারনেম installUser কোথায় আছে।

কনফিগারেশন ফাইলে অনুমতি সেট করা

Edge কমান্ডের মাধ্যমে ব্যবহার করা যেকোনও ফাইল বা রিসোর্স "apigee" ব্যবহারকারীর জন্য অ্যাক্সেসযোগ্য হতে হবে। এর মধ্যে Edge লাইসেন্স ফাইল ও যেকোনও কনফিগারেশন ফাইল অন্তর্ভুক্ত।

কনফিগারেশন ফাইল তৈরি করার সময়, আপনি এটির মালিক পরিবর্তন করে "apigee:apigee" করতে পারেন যাতে এটি Edge কমান্ডের মাধ্যমে অ্যাক্সেস করা যায়:

1. যেকোনও ব্যবহারকারী হিসেবে এডিটরে ফাইল তৈরি করুন।
2. ফাইলের মালিককে "apigee:apigee" হিসেবে chown করুন অথবা আপনি যদি "apigee" ব্যবহারকারী থেকে Edge পরিষেবা চালানো ব্যবহারকারীকে পরিবর্তন করে থাকেন, তাহলে Edge পরিষেবা চালানো ব্যবহারকারীকে ফাইলের মালিক হিসেবে chown করুন।

রুট ও নন-রুট ব্যবহারকারীর মধ্যে Edge ইনস্টল করার টাস্ক আলাদা করা হচ্ছে

যদিও রুট বা সম্পূর্ণ sudo অ্যাক্সেস আছে এমন ব্যবহারকারীর মাধ্যমে সম্পূর্ণ Edge ইনস্টল প্রসেস করা সবচেয়ে সহজ, তবে এটি সবসময় সম্ভব হয় না। পরিবর্তে, আপনি প্রক্রিয়াটিকে রুট দ্বারা সম্পাদিত টাস্ক এবং "apigee" ব্যবহারকারীর সম্পূর্ণ sudo অ্যাক্সেস সহ ব্যবহারকারী দ্বারা সম্পাদিত টাস্কে আলাদা করতে পারেন।

1. রুট দ্বারা সম্পাদিত টাস্ক:
   1. bootstrap_4.54.00.sh ফাইল ডাউনলোড করে রান করান:

      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
      sudo bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

      এই ধাপ apigee-service ইউটিলিটি ইনস্টল করে এবং "apigee" ব্যবহারকারী তৈরি করে।

   2. "apigee" ব্যবহারকারীর সম্পূর্ণ sudo অ্যাক্সেস সহ ব্যবহারকারী তৈরি করা-এ যেমন বর্ণনা করা হয়েছে, "apigee" ব্যবহারকারীর সম্পূর্ণ sudo অ্যাক্সেস সহ ব্যবহারকারী কনফিগার করুন।
   3. apigee-setup ইউটিলিটি ইনস্টল করুন:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   4. নোডে Edge RPM ইনস্টল করতে apigee-setup ইউটিলিটি ব্যবহার করুন:

      /opt/apigee/apigee-service/bin/apigee-service compName install

      নোডে ইনস্টল করা Edge RPM আপনার টপোলজির উপর নির্ভর করে। উপলভ্য কম্পোনেন্টের তালিকায় এগুলি অন্তর্ভুক্ত: apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-management-ui, edge-management-ui-static, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server।

2. নোডে রুট ব্যবহারকারী Edge RPM ইনস্টল করার পরে, "apigee" ব্যবহারকারীর সম্পূর্ণ সুডো অ্যাক্সেস সহ ব্যবহারকারী কনফিগারেশন প্রসেস সম্পূর্ণ করেন:
   1. নোডে Edge কম্পোনেন্ট কনফিগার করার জন্য setup.sh ইউটিলিটি ব্যবহার করুন। নোডে ইনস্টল করা কম্পোনেন্টগুলির উপর নির্ভর করে কমান্ডের ফর্ম পরিবর্তিত হয়। সম্পূর্ণ তালিকার জন্য, কোনও নোডে Edge কম্পোনেন্ট ইনস্টল করুন দেখুন।

      যেমন, ZooKeeper এবং Cassandra-এর ইনস্টলেশন সম্পূর্ণ করতে, নিম্নলিখিত কমান্ডটি ব্যবহার করুন:

      /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile

      যেখানে configFile হল Edge কনফিগারেশন ফাইল।

      অথবা, অল-ইন-ওয়ান ইনস্টল করতে, নিম্নলিখিত কমান্ডটি ব্যবহার করুন:

      /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile

ইনস্টলেশন কনফিগারেশন ফাইলের লোকেশন

Edge ইনস্টলেশন সংক্রান্ত তথ্য সহ একটি কনফিগারেশন ফাইল আপনাকে apigee-setup ইউটিলিটিতে পাস করতে হবে। নীরব ইনস্টলেশনের একমাত্র প্রয়োজনীয়তা হল, কনফিগারেশন ফাইলটি "apigee" ব্যবহারকারীর দ্বারা অ্যাক্সেসযোগ্য বা পাঠযোগ্য হতে হবে। যেমন, নোডের /usr/local/var বা /usr/local/share ডিরেক্টরিতে ফাইলটি রাখুন এবং chown করে "apigee:apigee" করুন।

কনফিগারেশন ফাইলের সব তথ্যই প্রয়োজন, শুধু Edge সিস্টেম অ্যাডমিনিস্ট্রেটরের পাসওয়ার্ড প্রয়োজন নেই। আপনি পাসওয়ার্ড বাদ দিলে, apigee-setup ইউটিলিটি আপনাকে কমান্ড লাইনে এটি লিখতে প্রম্পট করবে।

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

ইনস্টল করার সময় হওয়া সমস্যার সমাধান করা

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

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

ইন্টারনেট বা ইন্টারনেট ছাড়া ইনস্টলেশন

কোনও নোডে Edge ইনস্টল করতে, নোডটিকে অবশ্যই Apigee রিপোজিটরি অ্যাক্সেস করতে সক্ষম হতে হবে:

• এক্সটার্নাল ইন্টারনেট কানেকশন সহ নোড

  এক্সটার্নাল ইন্টারনেট কানেকশন সহ নোড, Edge RPM এবং ডিপেন্ডেন্সি ইনস্টল করার জন্য Apigee রিপোজিটরি অ্যাক্সেস করে।

• এক্সটার্নাল ইন্টারনেট কানেকশন ছাড়া নোড

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

  ইন্টার্নাল Apigee রিপোজিটরি তৈরি করতে, Edge RPM ও তার ডিপেন্ডেন্সি ডাউনলোড করার জন্য এক্সটার্নাল ইন্টারনেট অ্যাক্সেস সহ নোড প্রয়োজন। ইন্টার্নাল রেপোজিটরি তৈরি করার পরে, আপনি সেটি অন্য নোডে সরাতে পারেন অথবা ইনস্টলেশনের জন্য Edge নোডকে সেই নোড অ্যাক্সেস করার অনুমতি দিতে পারেন।

আপনার Edge ভার্সন বজায় রাখতে লোকাল Edge রেপোজিটরি ব্যবহার করা

স্থানীয় বা মিরর করা রিপোজিটরি ব্যবহার করার একটি কারণ হল, আগের বিভাগে বর্ণিত কোনও এক্সটার্নাল ইন্টারনেট কানেকশন না থাকা নোডে Edge ইনস্টল করা।

RPM ইনস্টলেশন সংক্রান্ত সমস্যার সমাধান করা

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

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

সাধারণ Yum কমান্ড

Linux-এর জন্য Edge ইনস্টলেশন টুল, কম্পোনেন্ট ইনস্টল ও আপডেট করার জন্য Yum-এর উপর নির্ভর করে। কোনও নোডে ইনস্টলেশন ম্যানেজ করতে আপনাকে একাধিক Yum কমান্ড ব্যবহার করতে হতে পারে।

• সব Yum ক্যাশে পরিষ্কার করুন:

  sudo yum clean all

• Edge কম্পোনেন্ট আপডেট করতে:

  sudo yum update componentName

  যেমন:

  sudo yum update apigee-setup
  sudo yum update edge-management-server

ফাইল সিস্টেম স্ট্রাকচার

Edge সব ফাইল /opt/apigee ডিরেক্টরিতে ইনস্টল করে।

এই গাইড এবং Edge অপারেশন গাইডে, রুট ইনস্টলেশন ডিরেক্টরি এইভাবে উল্লেখ করা হয়েছে:

/opt/apigee

ইনস্টলেশন, Apigee Edge for Private Cloud ডেপ্লয় করার জন্য নিম্নলিখিত ফাইল সিস্টেম স্ট্রাকচার ব্যবহার করে।

লগ ফাইল

apigee-setup-এর লগ ফাইল এবং setup.sh স্ক্রিপ্ট /tmp/setup-root.log-এ লেখা হয়।

প্রতিটি কম্পোনেন্টের লগ ফাইল /opt/apigee/var/log ডিরেক্টরিতে থাকে। প্রতিটি কম্পোনেন্টের নিজস্ব সাবডিরেক্টরি আছে। যেমন, ম্যানেজমেন্ট সার্ভারের লগ এই ডিরেক্টরিতে আছে:

/opt/apigee/var/log/edge-management-server

নিচের সারণীতে লগ ফাইলের লোকেশন তালিকাভুক্ত করা আছে:

ডেটা

ইনস্টল করার সময় সিস্টেম চেক করার সুবিধা চালু করা

Edge ইনস্টলেশন কনফিগারেশন ফাইলে নিম্নলিখিত প্রপার্টি কাজ করে:

ENABLE_SYSTEM_CHECK=y

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