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

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

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

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

পূর্বশর্ত: SELinux বন্ধ করুন

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

  • SELinux স্থায়ীভাবে বন্ধ করতে বা পারমিসিভ মোডে সেট করতে:
    1. এডিটরে /etc/sysconfig/selinux খুলুন।
    2. SELINUX=disabled বা SELINUX=permissive সেট করুন
    3. আপনার এডিট সেভ করুন।
    4. নোড রিস্টার্ট করুন।
    5. প্রয়োজন হলে, Edge ইনস্টল করার পরে এই পদ্ধতি অনুসরণ করে SELinux আবার চালু করুন এবং SELINUX=enabled সেট করুন।
  • পূর্বশর্ত: EPEL রেপো চালু করতে হবে

    Edge ইনস্টল বা আপডেট করতে অথবা লোকাল রেপো তৈরি করতে, আপনাকে অবশ্যই Enterprise Linux (বা EPEL)-এর জন্য অতিরিক্ত প্যাকেজ চালু করতে হবে। আপনি কোন কমান্ড ব্যবহার করবেন তা আপনার RedHat/CentOS ভার্সনের উপর নির্ভর করে:

    • Red Hat/CentOS/Oracle 8.x-এর জন্য:
      wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
      sudo rpm -ivh epel-release-latest-8.noarch.rpm
    • Red Hat/CentOS/Oracle 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 8/Rocky 8/Oracle 8-এর পূর্বশর্ত

      আপনি যদি Red Hat Enterprise Linux (RHEL) 8-এ চলছে এমন কোনও সার্ভারে Edge ইনস্টল করেন, তাহলে ইনস্টলেশন করার আগে নিম্নলিখিত ধাপগুলি অনুসরণ করুন:

      1. Enterprise Linux (EPEL)-এর জন্য অতিরিক্ত প্যাকেজ চালু করুন:
        sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
      2. Postgres ও Nginx বন্ধ করুন:
        sudo dnf module disable postgresql
        sudo dnf module disable nginx

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

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

      1. 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.7 প্রি-ইনস্টলেশন পরিবর্তন দেখুন।

      এক্সটার্নাল ইন্টারনেট কানেকশন সহ নোডে 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.53.01.sh-এ Edge bootstrap_4.53.01.sh ফাইল ডাউনলোড করুন:
        curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh
      7. Edge apigee-service ইউটিলিটি ও তার নির্ভরতা ইনস্টল করুন:
        sudo bash /tmp/bootstrap_4.53.01.sh apigeeuser=uName apigeepassword=pWord

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

        ডিফল্ট হিসেবে, ইনস্টলার চেক করে দেখে যে আপনার Java 1.8 ইনস্টল করা আছে কিনা। আপনার কাছে এটি না থাকলে, এটি আপনার জন্য ইনস্টল করে দেয়। Java ইনস্টলেশন কীভাবে হ্যান্ডেল করতে হয় তা নির্দিষ্ট করতে JAVA_FIX বিকল্প ব্যবহার করুন। JAVA_FIX নিম্নলিখিত মান নেয়:

        • I: OpenJDK 1.8 (ডিফল্ট) ইনস্টল করুন
        • গ: Java ইনস্টল না করেই চালিয়ে যান
        • প্রশ্ন: বেরিয়ে আসুন। এই বিকল্পের জন্য, আপনাকে নিজে থেকে 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

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

      সমস্যার ধরন সম্ভাব্য সমাধান
      পাসওয়ার্ডে ভুল অক্ষর আছে আপনার Apigee পাসওয়ার্ডে বিশেষ অক্ষর ব্যবহার করবেন না।
      কানেকশন সংক্রান্ত সমস্যা

      নিম্নলিখিত ncat কমান্ড প্রয়োগ করে আপনার নেটওয়ার্ক কানেক্টিভিটি পরীক্ষা করুন:

      nc -v software.apigee.com 443

      আপনি এই ধরনের একটি মেসেজ পাবেন:

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

      আপনার ডিভাইসে nc ইনস্টল করা না থাকলে, আপনি নিম্নলিখিত telnet কমান্ডটি চালাতে পারেন:

      telnet software.apigee.com 443

      কমান্ড সফল হলে, খোলা কানেকশন বাতিল করতে আপনি CTRL+C ব্যবহার করতে পারবেন।

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

      ভুল ক্রেডেনশিয়াল

      আপনার ইউজারনেম ও পাসওয়ার্ড সঠিক আছে কিনা তা নিশ্চিত করুন।

      যেমন, আপনার Apigee ইউজারনেম ও পাসওয়ার্ড দিয়ে নিম্নলিখিত কমান্ড ব্যবহার করার চেষ্টা করলে কোনও সমস্যা হচ্ছে কিনা দেখুন:

      curl -i -u username:password https://software.apigee.com/apigee-repo.rpm
      প্রক্সি সংক্রান্ত সমস্যা আপনার লোকাল কনফিগারেশন একটি ইগ্রেস HTTP প্রক্সি ব্যবহার করে এবং আপনি yum প্যাকেজ ম্যানেজারের জন্য একই কনফিগারেশন এক্সটেন্ড করেননি। আপনার এনভায়রনমেন্ট ভেরিয়েবল চেক করুন:
      echo $http_proxy
      echo $https_proxy

      এগ্রেস HTTP প্রক্সির জন্য, আপনাকে নিম্নলিখিত বিকল্পগুলির মধ্যে একটি ব্যবহার করতে হবে:

      • /etc/yum.conf-এ HTTP প্রক্সি কনফিগারেশন যোগ করুন
      • /etc/environment-এ গ্লোবাল HTTP প্রক্সি কনফিগারেশন যোগ করুন

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

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

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

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

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

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

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

      1. Apigee থেকে সেই ইউজারনেম ও পাসওয়ার্ড পান যা আপনি Apigee রিপোজিটরি অ্যাক্সেস করার জন্য ব্যবহার করেন। Apigee ftp সাইটের জন্য আপনার আগে থেকে কোনও ইউজারনেম:পাসওয়ার্ড থাকলে, আপনি সেইসব ক্রেডেনশিয়াল ব্যবহার করতে পারবেন।
      2. Edge RPM ইনস্টল করতে, আপনার নোডে রুট হিসেবে লগ-ইন করুন।
      3. উপরে যেভাবে বর্ণনা করা হয়েছে সেইভাবে SELinux বন্ধ করুন।
      4. /tmp/bootstrap_4.53.01.sh-এ Edge bootstrap_4.53.01.sh ফাইল ডাউনলোড করুন:
        curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh
      5. Edge apigee-service ইউটিলিটি ও তার নির্ভরতা ইনস্টল করুন:
        sudo bash /tmp/bootstrap_4.53.01.sh apigeeuser=uName apigeepassword=pWord

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

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

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

      8. (ঐচ্ছিক) আপনি যদি একই নোডে লোকাল রেপো থেকে Edge ইনস্টল করতে চান, যে নোড লোকাল রেপো হোস্ট করে, তাহলে আপনাকে প্রথমে নিম্নলিখিত কমান্ড চালাতে হবে:
        1. bootstrap_4.53.01.sh রান করে লোকাল রেপো থেকে apigee-service ইউটিলিটি ইনস্টল করুন:
          sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.53.01.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. নোডে Edge কম্পোনেন্ট ইনস্টল ও কনফিগার করতে apigee-setup ব্যবহার করুন। আরও জানতে নোডে Edge কম্পোনেন্ট ইনস্টল করুন দেখুন।

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

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

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

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

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

      1. লোকাল রিপোজিটরি সহ নোডে, নিম্নলিখিত কমান্ড ব্যবহার করে লোকাল রিপোজিটরিকে /opt/apigee/data/apigee-mirror/apigee-4.53.01.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.53.01.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.53.01.sh ফাইল ডাউনলোড করতে হবে এবং তারপরে নতুন সিঙ্ক করতে হবে।

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

      1. Edge bootstrap_4.53.01.sh ফাইলটি /tmp/bootstrap_4.53.01.sh-এ ডাউনলোড করুন:
        curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh
      2. Edge bootstrap_4.53.01.sh ফাইল রান করান:
        sudo bash/tmp/bootstrap_4.53.01.sh apigeeuser=uName apigeepassword=pWord

        Apigee-এর থেকে পাওয়া ইউজারনেম ও পাসওয়ার্ড uName:pWord কোথায় আছে। আপনি 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