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

Edge for Private Cloud v. 4.17.01

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

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

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

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

      আরও জানতে Edge apigee-setup ইউটিলিটি ইনস্টল করুন দেখুন।
  • আপনার বেছে নেওয়া টোপোলজির উপর ভিত্তি করে প্রতিটি নোডে এক বা একাধিক Edge কম্পোনেন্ট ইনস্টল করতে apigee-setup ইউটিলিটি ব্যবহার করুন।
    নোডে Edge কম্পোনেন্ট ইনস্টল করা দেখুন।
  • ম্যানেজমেন্ট সার্ভার নোডে, apigee-provision ইনস্টল করতে apigee-setup ইউটিলিটি ব্যবহার করুন, যে ইউটিলিটিগুলি আপনি এজ সংস্থাগুলি তৈরি এবং পরিচালনা করতে ব্যবহার করেন।
    আরও জানতে কোনও সংস্থাকে অনবোর্ড করুন দেখুন।

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

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

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

  • apigee-service ইউটিলিটি:
    • apigee-service কমান্ড: ইনস্টল, আনইনস্টল, আপডেট।
    • apigee-all কমান্ড: ইনস্টল, আনইনস্টল, আপডেট।
  • 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 অ্যাক্সেস সহ কোনও ব্যবহারকারীকে কনফিগার করতে, sudoers ফাইল এডিট করে যোগ করুন:

installUser        ALL=(apigee)      NOPASSWD: ALL

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    মনে রাখবেন: Apigee আমাদের সর্বজনীন রিপোজিটরিতে সব থার্ড-পার্টি ডিপেন্ডেন্সি হোস্ট করে না। আপনাকে সর্বজনীনভাবে অ্যাক্সেসযোগ্য রিপোজিটরি থেকে এইসব ডিপেন্ডেন্সি ডাউনলোড ও ইনস্টল করতে হবে।

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

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

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

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

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

মিরর করা রেপো খুব নমনীয়। যেমন, আপনি লেটেস্ট Edge RPMs বা Edge-এর নির্দিষ্ট ভার্সন থেকে মিরর করা রেপো তৈরি করতে পারবেন। রেপো তৈরি করার পরে, আপনি বিভিন্ন Edge ভার্সন থেকে RPM যোগ করার জন্য এটি আপডেট করতে পারবেন। আরও জানতে Edge apigee-setup ইউটিলিটি ইনস্টল করুন দেখুন।

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 অপারেশন গাইডে, রুট ইনস্টলেশন ডিরেক্টরিকে এইভাবে উল্লেখ করা হয়েছে:

<inst_root>/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

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

কম্পোনেন্ট

লোকেশন

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

<inst_root>/apigee/var/log/edge-management-server

রাউটার

<inst_root>/apigee/var/log/edge-router

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

<inst_root>/apigee/var/log/edge-message-processor

Apigee Qpid Server

<inst_root>/apigee/var/log/edge-qpid-server

Apigee Postgres Server

<inst_root>/apigee/var/log/edge-postgres-server

Edge UI

<inst_root>/apigee/var/log/edge-ui

ZooKeeper

<inst_root>/apigee/var/log/apigee-zookeeper

OpenLDAP

<inst_root>/apigee/var/log/apigee-openldap

Cassandra

<inst_root>/apigee/var/log/apigee-cassandra

Qpidd

<inst_root>/apigee/var/log/apigee-qpidd

PostgreSQL ডেটাবেস

<inst_root>/apigee/var/log/apigee-postgresql

ডেটা

কম্পোনেন্ট

লোকেশন

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

<data_root>/apigee/data/edge-management-server

রাউটার

<data_root>/apigee/data/edge-router

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

<data_root>/apigee/data/edge-message-processor

Apigee Qpid এজেন্ট

<data_root>/apigee/data/edge-qpid-server

Apigee Postgres এজেন্ট

<data_root>/apigee/data/edge-postgres-server

ZooKeeper

<data_root>/apigee/data/apigee-zookeeper

OpenLDAP

<data_root>/apigee/data/apigee-openldap

Cassandra

<data_root>/apigee/data/apigee-cassandra/data

Qpidd

<data_root>/apigee/data/apigee-qpid/data

PostgreSQL ডেটাবেস

<data_root>/apigee/data/apigee-postgres/pgdata

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

ইনস্টলেশন সম্পূর্ণ হওয়ার পরে, আপনি Edge কম্পোনেন্টে অতিরিক্ত অ্যাকশন পারফর্ম করতে পারবেন।

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

ইনস্টলেশনের পরে Edge কনফিগার করতে, আপনি .properties ফাইল এবং Edge ইউটিলিটির একটি কম্বিনেশন ব্যবহার করেন। যেমন, Edge UI-তে TLS/SSL কনফিগার করতে, প্রয়োজনীয় প্রপার্টি সেট করার জন্য আপনি .properties ফাইল এডিট করেন। .properties ফাইলে পরিবর্তন করার জন্য আপনাকে প্রভাবিত Edge কম্পোনেন্ট রিস্টার্ট করতে হবে।

.properties ফাইলগুলি /opt/apigee/customer/application ডিরেক্টরিতে অবস্থিত। প্রতিটি কম্পোনেন্টের নিজস্ব .properties ফাইল সেই ডিরেক্টরিতে থাকে। যেমন, router.properties এবং management-server.properties।

কোনও কম্পোনেন্টের জন্য প্রপার্টি সেট করতে, সংশ্লিষ্ট .properties ফাইল এডিট করুন এবং তারপর কম্পোনেন্ট রিস্টার্ট করুন:

> /opt/apigee/apigee-service/bin/apigee-service component restart

যেমন:

> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

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

Edge কনফিগারেশন সম্পর্কে আরও তথ্যের জন্য Edge কীভাবে কনফিগার করবেন দেখুন।

Edge কম্পোনেন্টে কমান্ড চালু করা হচ্ছে

Edge /opt/apigee/apigee-service/bin-এর অধীনে ম্যানেজমেন্ট ইউটিলিটি ইনস্টল করে যা আপনি Edge ইনস্টলেশন ম্যানেজ করতে ব্যবহার করতে পারেন। যেমন, নোডে সব এজ কম্পোনেন্টের স্ট্যাটাস শুরু, বন্ধ, রিস্টার্ট বা নির্ধারণ করতে আপনি apigee-all ইউটিলিটি ব্যবহার করতে পারেন:

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

আলাদা আলাদা কম্পোনেন্ট কন্ট্রোল ও কনফিগার করতে apigee-service ইউটিলিটি ব্যবহার করুন। apigee-service ইউটিলিটির ফর্মটি হল:

/opt/apigee/apigee-service/bin/apigee-service component action

যেমন, Edge Router রিস্টার্ট করতে:

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

আপনি /opt/apigee ডিরেক্টরি পরীক্ষা করে নোডে ইনস্টল করা কম্পোনেন্টের তালিকা নির্ধারণ করতে পারেন। সেই ডিরেক্টরিতে নোডে ইনস্টল করা প্রতিটি Edge কম্পোনেন্টের জন্য একটি সাবডিরেক্টরি থাকে। প্রতিটি সাবডিরেক্টরির প্রিফিক্স হল:

  • apigee - Edge-এর ব্যবহার করা থার্ড-পার্টি কম্পোনেন্ট। যেমন, apigee-cassandra।
  • edge - Apigee-এর একটি Edge কম্পোনেন্ট। যেমন, edge-management-server.
  • edge-mint - একটি মনিটাইজেশন কম্পোনেন্ট। যেমন, edge-mint-management-server.
  • baas - একটি API BaaS কম্পোনেন্ট। যেমন baas-usergrid।

কোনও কম্পোনেন্টের জন্য অ্যাকশনের সম্পূর্ণ তালিকা কম্পোনেন্টের উপর নির্ভর করে, তবে সব কম্পোনেন্ট নিম্নলিখিত অ্যাকশনগুলি সাপোর্ট করে:

  • চালু, বন্ধ, রিস্টার্ট করুন
  • স্ট্যাটাস, ভার্সন
  • ব্যাক-আপ, ফিরিয়ে আনা
  • ইনস্টল, আনইনস্টল করা