Edge apigee-setup ইউটিলিটি ইনস্টল করুন

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

ডিফল্ট ইনস্টলেশন ডিরেক্টরি: /opt/apigee

Edge সব ফাইল /opt/apigee ডিরেক্টরিতে ইনস্টল করে। আপনি এই ডিরেক্টরি পরিবর্তন করতে পারবেন না। তবে, আপনি চাইলে, /opt/apigee-কে অন্য লোকেশনে ম্যাপ করার জন্য সিমলিঙ্ক তৈরি করতে পারেন। আরও তথ্যের জন্য ইনস্টলেশন সংক্রান্ত প্রয়োজনীয়তা দেখুন।

প্রয়োজনীয়তা: SELinux বন্ধ করুন

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

পূর্বশর্ত: EPEL রেপো চালু করতে হবে

Edge ইনস্টল বা আপডেট করতে অথবা লোকাল রেপো তৈরি করতে, আপনাকে অবশ্যই Enterprise Linux (বা EPEL)-এর জন্য অতিরিক্ত প্যাকেজ চালু করতে হবে। Red Hat Enterprise Linux (RHEL) 9.x, Rocky Linux 9.x, অথবা Oracle Linux 9.x-এর জন্য, নিম্নলিখিত কমান্ডগুলি রান করুন:

wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
sudo rpm -ivh epel-release-latest-9.noarch.rpm

RHEL 9/Rocky 9/Oracle 9-এর জন্য পূর্বশর্ত

আপনি যদি Red Hat Enterprise Linux (RHEL) 9, Rocky 9 বা Oracle 9-এ চলা সার্ভারে Edge ইনস্টল করেন, তাহলে ইনস্টলেশন করার আগে নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:

1. Extra Packages for Enterprise Linux (EPEL) চালু করুন:

   sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm

2. Postgres ও Nginx বন্ধ করুন:

   sudo dnf module disable postgresql
   sudo dnf module disable nginx

PostgreSQL ও LDAP-এর প্রি-ইনস্টলেশন সংক্রান্ত পরিবর্তনের জন্য, যথাক্রমে PostgreSQL ডেটাবেস প্রি-ইনস্টলেশন সংক্রান্ত প্রয়োজনীয়তা এবং SymasLDAP 2.6.10 প্রি-ইনস্টলেশন সংক্রান্ত পরিবর্তন দেখুন।

এক্সটার্নাল ইন্টারনেট কানেকশন সহ নোডে Edge apigee-setup ইউটিলিটি ইনস্টল করুন

এক্সটার্নাল ইন্টারনেট কানেকশন সহ কোনও নোডে Edge ইনস্টল করতে:

1. Apigee থেকে ইউজারনেম ও পাসওয়ার্ড পান যা আপনি Apigee রিপোজিটরি অ্যাক্সেস করতে ব্যবহার করেন। Apigee ftp সাইটের জন্য আপনার আগে থেকে থাকা username:password থাকলে, আপনি সেইসব ক্রেডেনশিয়াল ব্যবহার করতে পারবেন।
2. Edge RPM ইনস্টল করতে রুট হিসেবে আপনার নোডে লগ-ইন করুন
   
3. SELinux বন্ধ করুন।
4. EPEL রেপো চালু করুন।
5. আপনি যদি RHEL 9/Rocky 9/Oracle 9-এ ইনস্টল করেন, তাহলে RHEL 9/Rocky 9/Oracle 9-এর পূর্বশর্ত-এ দেওয়া ধাপগুলি অনুসরণ করুন।
6. /tmp/bootstrap_4.54.00.sh-এ Edge bootstrap_4.54.00.sh ফাইল ডাউনলোড করুন:

   curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh

7. Edge apigee-service ইউটিলিটি ও ডিপেন্ডেন্সি ইনস্টল করুন:

   sudo bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

   যেখানে uName:pWord হল Apigee থেকে পাওয়া ইউজারনেম ও পাসওয়ার্ড। আপনি pWord বাদ দিলে, এটি লিখতে বলা হবে।

   Apigee Edge for Private Cloud 4.54.00-এর জন্য নোডে Java 17 ও Java 21, এই দুটি ভার্সনই ইনস্টল করা থাকতে হবে। বুটস্ট্র্যাপ স্ক্রিপ্ট চালানোর আগে আপনাকে অবশ্যই Java 17 এবং Java 21 দুটিই ইনস্টল করতে হবে। ইনস্টলার শুধুমাত্র যাচাই করে যে JDK-এর দুটি ভার্সনই ইনস্টল করা আছে; এটি Java অটোমেটিক ইনস্টল করে না।

   apigee-service ইউটিলিটি ইনস্টল করার ফলে /etc/yum.repos.d/apigee.repo ফাইল তৈরি হয় যা Apigee রিপোজিটরিকে সংজ্ঞায়িত করে। ডেফিনিশন ফাইল দেখতে, এই কমান্ড ব্যবহার করুন:

   cat /etc/yum.repos.d/apigee.repo

   রেপো কন্টেন্ট দেখতে, এই কমান্ড ব্যবহার করুন:

   sudo yum -v repolist 'apigee*'

8. apigee-setup ইউটিলিটি ইনস্টল করতে apigee-service ব্যবহার করুন:
   

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

9. নোডে Edge কম্পোনেন্ট ইনস্টল ও কনফিগার করতে apigee-setup ব্যবহার করুন। আরও জানতে নোডে Edge কম্পোনেন্ট ইনস্টল করুন দেখুন।

সমস্যার সমাধান

এক্সটার্নাল ইন্টারনেট কানেকশন সহ নোডে ইনস্টল করার চেষ্টা করলে, আপনি নিম্নলিখিত এক বা একাধিক সমস্যার সম্মুখীন হতে পারেন:

Cannot open: https://username@software.apigee.com/apigee-repo-4.53.00.rpm

bootstrap.sh: Error: Repo configuration failed

error: package package_name is not installed

এইসব সমস্যার কিছু সম্ভাব্য সমাধান নিম্নলিখিত সারণীতে তালিকাভুক্ত করা হয়েছে:

nc -v software.apigee.com 443

Connection to software.apigee.com 443 port [tcp/https] succeeded!

telnet software.apigee.com 443

curl -i -u username:password https://software.apigee.com/apigee-repo.rpm

echo $http_proxy
echo $https_proxy

এক্সটার্নাল ইন্টারনেট কানেকশন নেই এমন নোডে Edge apigee-setup ইউটিলিটি ইনস্টল করা

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

যেসব নোডে ইন্টারনেট কানেকশন নেই সেগুলির জন্য Apigee Edge ইনস্টলেশন প্রসেসে নিম্নলিখিত লোকাল রেপোতে অ্যাক্সেস প্রয়োজন:

• Apigee Edge repo: স্থানীয় Apigee রেপোজিটরি তৈরি করুন-এ যেভাবে বর্ণনা করা হয়েছে।
• Enterprise Linux (বা EPEL)-এর জন্য অতিরিক্ত প্যাকেজ: আপনার অপারেশন টিম আপনার জন্য এটি সেট-আপ করতে পারবে।

স্থানীয় Apigee রিপোজিটরি তৈরি করা

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

আপনি একটি স্থানীয় Apigee রিপোজিটরি তৈরি করার পরে, আপনাকে পরে এটি লেটেস্ট Edge রিলিজ ফাইলের সাথে আপডেট করতে হতে পারে। নিম্নলিখিত বিভাগে কীভাবে একটি লোকাল Apigee রিপোজিটরি তৈরি করতে হয় এবং সেটি কীভাবে আপডেট করতে হয় তা বর্ণনা করা হয়েছে।

লোকাল Apigee রেপো তৈরি করতে:

1. Apigee থেকে ইউজারনেম ও পাসওয়ার্ড পান যা আপনি Apigee রিপোজিটরি অ্যাক্সেস করতে ব্যবহার করেন। Apigee ftp সাইটের জন্য আপনার আগে থেকেই ইউজারনেম:পাসওয়ার্ড থাকলে, আপনি সেই ক্রেডেনশিয়াল ব্যবহার করতে পারবেন।
2. Edge RPM ইনস্টল করতে রুট হিসেবে আপনার নোডে লগ-ইন করুন।
   
3. উপরে যেভাবে বর্ণনা করা হয়েছে সেইভাবে SELinux বন্ধ করুন।
4. /tmp/bootstrap_4.54.00.sh-এ Edge bootstrap_4.54.00.sh ফাইল ডাউনলোড করুন:

   curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh

5. Edge apigee-service ইউটিলিটি ও তার ডিপেন্ডেন্সি ইনস্টল করুন:
   

   sudo bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

   যেখানে uName:pWord হল Apigee থেকে পাওয়া ইউজারনেম ও পাসওয়ার্ড। আপনি pWord বাদ দিলে, আপনাকে এটি লিখতে বলা হবে।

6. নোডে apigee-mirror ইউটিলিটি ইনস্টল করুন:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install

7. apigee-mirror ইউটিলিটি ব্যবহার করে Apigee রেপোকে /opt/apigee/data/apigee-mirror/repos/ ডিরেক্টরির সাথে সিঙ্ক করুন।

   রেপোর সাইজ কমাতে, শুধু লেটেস্ট RPM ডাউনলোড করতে --only-new-rpms অন্তর্ভুক্ত করুন।

8. (ঐচ্ছিক) আপনি যদি লোকাল রেপো থেকে একই নোডে Edge ইনস্টল করতে চান যা লোকাল রেপো হোস্ট করে, তাহলে আপনাকে প্রথমে নিম্নলিখিত কমান্ডগুলি চালাতে হবে:
   1. apigee-service ইউটিলিটি ইনস্টল করতে লোকাল রেপো থেকে bootstrap_4.54.00.sh রান করুন:

      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.54.00.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos

   2. apigee-setup ইউটিলিটি ইনস্টল করতে apigee-service ব্যবহার করুন:

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

   3. নোডে এজ কম্পোনেন্ট ইনস্টল ও কনফিগার করতে apigee-setup ব্যবহার করুন। আরও জানতে নোডে Edge কম্পোনেন্ট ইনস্টল করুন দেখুন।

লোকাল রেপো থেকে রিমোট নোডে apigee-setup ইনস্টল করুন

লোকাল রেপো থেকে Edge ইনস্টল করার জন্য আপনার কাছে দুটি বিকল্প আছে। এগুলির মধ্যে যেকোনও একটি করতে পারেন:

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

.tar ফাইল থেকে ইনস্টল করা

.tar ফাইল থেকে ইনস্টল করতে:

1. লোকাল রেপো সহ নোডে, লোকাল রেপোকে /opt/apigee/data/apigee-mirror/apigee-4.54.00.tar.gz নামের একটি .tar ফাইলে প্যাকেজ করতে নিম্নলিখিত কমান্ড ব্যবহার করুন:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

2. আপনি Edge ইনস্টল করতে চান এমন নোডে .tar ফাইলটি কপি করুন। যেমন, নতুন নোডের /tmp ডিরেক্টরিতে এটি কপি করুন।
3. নতুন নোডে, উপরে যেভাবে বর্ণনা করা হয়েছে সেইভাবে SELinux বন্ধ করুন।
4. নতুন নোডে, আপনি স্থানীয় Yum ইউটিলিটি রেপো এবং EPEL রেপো অ্যাক্সেস করতে পারবেন কিনা তা নিশ্চিত করুন।
5. সব এক্সটার্নাল ইন্টারনেট রেপো বন্ধ করা আছে কিনা তা ডবল-চেক করুন (এটি বন্ধ করা থাকা উচিত কারণ আপনি ইন্টারনেট অ্যাক্সেস নেই এমন মেশিনে ইনস্টল করছেন):

   sudo yum repolist

   সব এক্সটার্নাল রেপো বন্ধ করে দিতে হবে, কিন্তু লোকাল Apigee রেপো ও আপনার ইন্টার্নাল রেপো চালু রাখতে হবে।

6. apigee-setup ইউটিলিটি ইনস্টল করতে apigee-service ব্যবহার করুন:

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

7. নোডে Edge কম্পোনেন্ট ইনস্টল ও কনফিগার করতে apigee-setup ব্যবহার করুন। আরও জানতে নোডে Edge কম্পোনেন্ট ইনস্টল করুন দেখুন।

Nginx ওয়েবসার্ভার ব্যবহার করে রেপো থেকে ইনস্টল করা

Nginx ওয়েবসার্ভার ব্যবহার করে রেপো থেকে ইনস্টল করতে:

1. রেপো নোডে Nginx ওয়েবসার্ভার ইনস্টল করুন:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig

2. সাধারণত, Nginx, সার্ভারের নাম হিসেবে লোকালহোস্ট এবং পোর্ট ৩৯৩৯ ব্যবহার করার জন্য কনফিগার করা হয়। এইসব ভ্যালু পরিবর্তন করতে:
   1. এডিটরে /opt/apigee/customer/application/mirror.properties খুলুন। ফাইলটি না থাকলে সেটি তৈরি করুন।
   2. প্রয়োজন অনুযায়ী নিম্নলিখিত ভ্যালু সেট করুন:

      conf_apigee_mirror_listen_port=3939
      conf_apigee_mirror_server_name=localhost

   3. Nginx রিস্টার্ট করুন:

      /opt/nginx/scripts/apigee-nginx restart

3. ডিফল্ট হিসেবে, রেপোতে admin:admin ইউজারনেম:পাসওয়ার্ড প্রয়োজন। এইসব ক্রেডেনশিয়াল পরিবর্তন করতে, নিম্নলিখিত এনভায়রনমেন্ট ভেরিয়েবল সেট করুন:

   MIRROR_USERNAME=uName
   MIRROR_PASSWORD=pWord

4. নতুন নোডে, EPEL রিপোজিটরি লোকালি চালু করা আছে কিনা তা নিশ্চিত করুন।
5. নতুন নোডে, উপরে যেভাবে উল্লেখ করা আছে সেইভাবে আপনার libdb4-এর ভার্সন চেক করুন।
6. রিমোট নোডে, Edge apigee-service ইউটিলিটি ও ডিপেন্ডেন্সি ইনস্টল করুন:

   sudo bash /tmp/bootstrap_4.54.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

   যেখানে uName:pWord হল রেপো ইউজারনেম ও পাসওয়ার্ড।

7. রিমোট নোডে, apigee-setup ইউটিলিটি ইনস্টল করতে apigee-service ব্যবহার করুন:

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

8. রিমোট নোডে Edge কম্পোনেন্ট ইনস্টল ও কনফিগার করতে apigee-setup ব্যবহার করুন। আরও জানতে নোডে Edge কম্পোনেন্ট ইনস্টল করুন দেখুন।

স্থানীয় Apigee রিপোজিটরি আপডেট করা

রেপো আপডেট করতে, আপনাকে অবশ্যই লেটেস্ট bootstrap_4.54.00.sh ফাইল ডাউনলোড করতে হবে এবং তারপরে নতুন সিঙ্ক করতে হবে।

রেপো আপডেট করতে:

1. /tmp/bootstrap_4.54.00.sh-এ Edge bootstrap_4.54.00.sh ফাইল ডাউনলোড করুন:

   curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh

2. Edge bootstrap_4.54.00.sh ফাইল রান করুন:

   sudo bash/tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

   যেখানে uName:pWord হল Apigee থেকে পাওয়া ইউজারনেম ও পাসওয়ার্ড। আপনি pWord বাদ দিলে, আপনাকে এটি লিখতে বলা হবে।

3. apigee-mirror আপডেট করুন:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update

4. সিঙ্ক করুন:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

5. আপনি যদি সম্পূর্ণ রেপো চান:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

স্থানীয় Apigee রেপো ক্লিন করা

লোকাল রেপো পরিষ্কার করলে /opt/apigee/data/apigee-mirror এবং /var/tmp/yum-apigee-* মুছে যায়।

লোকাল রেপো পরিষ্কার করতে, এটি ব্যবহার করুন:

/opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean