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.52.00.sh ফাইলটি /tmp/bootstrap_4.52.00.sh-এ ডাউনলোড করুন।
    • Edge apigee-service ইউটিলিটি ও ডিপেন্ডেন্সি ইনস্টল করুন।
    • Edge apigee-setup ইউটিলিটি ও ডিপেন্ডেন্সি ইনস্টল করুন।

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

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

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

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

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

  8. ইনস্টলেশন সম্পূর্ণ হওয়ার পরে প্রতিটি নোডে ক্লাসিক UI কম্পোনেন্ট রিস্টার্ট করুন, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

  9. (সাজেস্ট করা হয়) প্রাথমিক ইনস্টলেশন সম্পূর্ণ করার পরে, Apigee সাজেস্ট করে যে আপনি নতুন Edge UI (যার কম্পোনেন্টের নাম হল edge-management-ui) ইনস্টল করুন, যা Private Cloud-এর জন্য Apigee Edge-এর ডেভেলপার ও অ্যাডমিনিস্ট্রেটরদের জন্য একটি উন্নত ইউজার ইন্টারফেস।

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

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

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

Apigee Edge ডিস্ট্রিবিউশন ফাইলগুলি RPM এবং ডিপেন্ডেন্সির সেট হিসাবে ইনস্টল করা হয়। Edge RPM ইনস্টল, আনইনস্টল ও আপডেট করতে, রুট ব্যবহারকারী বা সম্পূর্ণ sudo অ্যাক্সেস আছে এমন ব্যবহারকারীকে কমান্ড রান করতে হবে। সম্পূর্ণ sudo অ্যাক্সেসের জন্য, এর অর্থ হল ব্যবহারকারীর কাছে রুট হিসাবে একই অপারেশন করার জন্য 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" ব্যবহারকারীর জন্য সম্পূর্ণ sudo অ্যাক্সেস সহ একজন ব্যবহারকারী তৈরি করা হচ্ছে

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

installUser        ALL=(apigee)      NOPASSWD: ALL

যেখানে installUser হল Edge-এর সাথে কাজ করা ব্যক্তির ইউজারনেম।

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

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

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

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

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

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

  1. রুট দ্বারা সম্পাদিত টাস্ক:
    1. bootstrap_4.52.00.sh ফাইল ডাউনলোড করে রান করুন: 
      curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
sudo bash /tmp/bootstrap_4.52.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-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server।

  2. রুট ব্যবহারকারী নোডে Edge RPM ইনস্টল করার পরে, "apigee" ব্যবহারকারীর সম্পূর্ণ sudo অ্যাক্সেস সহ ব্যবহারকারী কনফিগারেশন প্রসেস সম্পূর্ণ করেন:
    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

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

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

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

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

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

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

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

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

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

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

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

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

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

    ইন্টার্নাল Apigee রিপোজিটরি তৈরি করতে, আপনার এমন একটি নোড প্রয়োজন যার এক্সটার্নাল ইন্টারনেট অ্যাক্সেস আছে যাতে Edge RPM এবং ডিপেন্ডেন্সি ডাউনলোড করা যায়। আপনি ইন্টার্নাল রেপো তৈরি করার পরে, আপনি এটিকে অন্য নোডে সরাতে পারেন বা সেই নোডটিকে ইনস্টলেশনের জন্য এজ নোডে অ্যাক্সেসযোগ্য করতে পারেন।

আপনার 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

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

কম্পোনেন্ট লোকেশন

ম্যানেজমেন্ট সার্ভার

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

রাউটার

 /opt/apigee/var/log/edge-router

Nginx ব্যবহার করে এজ রাউটার প্রয়োগ করা হয়। অতিরিক্ত লগের জন্য, দেখুন:

/opt/apigee/var/log/edge-router/nginx
/opt/nginx/logs

মেসেজ প্রসেসর

 /opt/apigee/var/log/edge-message-processor

Apigee Qpid Server

 /opt/apigee/var/log/edge-qpid-server
Apigee Postgres Server /opt/apigee/var/log/edge-postgres-server
ক্লাসিক UI (নতুন Edge UI নয়, যার কম্পোনেন্টের নাম হল edge-management-ui) /opt/apigee/var/log/edge-ui
ZooKeeper /opt/apigee/var/log/apigee-zookeeper
OpenLDAP /opt/apigee/var/log/apigee-openldap
Cassandra /opt/apigee/var/log/apigee-cassandra/system.log
Qpidd /opt/apigee/var/log/apigee-qpidd
PostgreSQL ডেটাবেস /opt/apigee/var/log/apigee-postgresql
apigee-monit /opt/apigee/var/log/apigee-monit

ডেটা

কম্পোনেন্ট লোকেশন
ম্যানেজমেন্ট সার্ভার /opt/apigee/data/edge-management-server
রাউটার /opt/apigee/data/edge-router
মেসেজ প্রসেসর /opt/apigee/data/edge-message-processor
Apigee Qpid এজেন্ট /opt/apigee/data/edge-qpid-server
Apigee Postgres এজেন্ট /opt/apigee/data/edge-postgres-server
ZooKeeper /opt/apigee/data/apigee-zookeeper
OpenLDAP /opt/apigee/data/apigee-openldap
Cassandra /opt/apigee/data/apigee-cassandra/data
Qpidd /opt/apigee/data/apigee-qpid/data
PostgreSQL ডেটাবেস /opt/apigee/data/apigee-postgres/pgdata
apigee-monit /opt/apigee/data/apigee-monit

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

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

ENABLE_SYSTEM_CHECK=y

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