Developer Services পোর্টাল আপগ্রেড করা

ডেভেলপার পরিষেবা পোর্টাল v. 4.17.09

এই পদ্ধতিতে, আগে থেকে ইনস্টল করা Apigee Developer Channel Services অন-প্রিমিস কীভাবে আপগ্রেড করতে হয় তা বর্ণনা করা হয়েছে।

আপডেট করার সঠিক পদ্ধতি নির্ধারণ করা হচ্ছে

পোর্টাল আপডেট করার জন্য আপনি যে পদ্ধতি ব্যবহার করেন তা আপনার বর্তমান ইনস্টলেশনের উপর ভিত্তি করে:

আপনার বর্তমান ইনস্টলেশনের ধরন নির্ধারণ করা হচ্ছে

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

  • ls /opt

    আপনি Nginx/Postgres ব্যবহার করলে, নিম্নলিখিত ডিরেক্টরি দেখতে পাবেন: /opt/apigee এবং /opt/nginx।

    আপনি Apache/MySQL বা Apache/MariaDB ব্যবহার করলে, এইসব ডিরেক্টরি থাকবে না।

  • /opt/apigee/apigee-service/bin/apigee-all status

    আপনি Nginx/Postgres ব্যবহার করলে, নিম্নলিখিত আউটপুট দেখতে পাবেন:

    + apigee-service
  apigee-drupal-devportal status
  OK: apigee-drupal-devportal is up and running
  + apigee-service apigee-lb status
  apigee-service: apigee-lb: OK
  + apigee-service apigee-postgresql status
  apigee-service: apigee-postgresql: OK
  • apachectl -S

    আপনি Apache/MySQL বা Apache/MariaDB ব্যবহার করলে, এই কমান্ডের মাধ্যমে পোর্টালের ওয়েব রুট ডিরেক্টরি এই ফর্ম্যাটে দেখানো উচিত:

    *:80
  192.168.56.102
  (/etc/httpd/conf/vhosts/devportal.conf:1)

ডিফল্ট ইনস্টলেশন ডিরেক্টরি

আপগ্রেড প্রসেস ধরে নেয় যে ডেভেলপার পোর্টাল এখানে ইনস্টল করা হয়েছে:

  • 4.17.05 এবং তার পরের যেকোনও ভার্সন: /opt/apigee/apigee-drupal/wwwroot
  • 4.17.05-এর আগে: /opt/apigee/apigee-drupal (Nginx) অথবা /var/www/html (Apache)

আপনি যদি ডিফল্ট ডিরেক্টরিতে পোর্টাল ইনস্টল না করে থাকেন, তাহলে আপনার ইনস্টলেশন ডিরেক্টরি ব্যবহার করতে নিচের পদ্ধতিতে পাথগুলি পরিবর্তন করুন।

আপগ্রেড করা যেসব ভার্সন কাজ করে

এই আপগ্রেড পদ্ধতি পোর্টালের নিম্নলিখিত ভার্সনের জন্য কাজ করে:

  • OPDK-17-01.x
  • OPDK-17-05.x

আপনার পোর্টাল ভার্সন নির্ধারণ করতে, ব্রাউজারে নিম্নলিখিত URL খুলুন:

http://your_portal.com/buildInfo

আপডেট করার আগে

আগে থেকে ইনস্টল করা থাকলে, আপনি Drupal কোর বা কোনও নন-কাস্টম মডিউলে কোনও কোড পরিবর্তন করে থাকলে, আপনার করা পরিবর্তন ওভাররাইট করা হবে। এর মধ্যে, অন্যান্য বিষয়ের সাথে, .htaccess-এ আপনার করা যেকোনও পরিবর্তন অন্তর্ভুক্ত। /sites ডিরেক্টরির বাইরে যা কিছু আছে তা Drupal-এর মালিকানাধীন বলে আপনাকে ধরে নিতে হবে। এই নিয়মের ব্যতিক্রম হল robots.txt; এই ফাইল ওয়েব রুটে থাকলে, এটি আপনার জন্য রেখে দেওয়া হবে।

ইনস্টলেশন শুরু করার আগে, আপনার সম্পূর্ণ Drupal ওয়েব রুট ডিরেক্টরির ব্যাক-আপ নিন। নিচে উল্লেখ করা ইনস্টলেশন ধাপগুলি সম্পূর্ণ করার পরে, আপনি ব্যাক-আপ থেকে আপনার কাস্টমাইজেশন রিস্টোর করতে পারবেন।

RPM ব্যবহার করে পোর্টাল আপগ্রেড করা

কোনও নোডে পোর্টাল RPM আপডেট করতে নিম্নলিখিত পদ্ধতি ব্যবহার করুন:

  1. Drupal ডিরেক্টরিতে পরিবর্তন করুন। যেমন, /opt/apigee/apigee-drupal/wwwroot 

    cd /opt/apigee/apigee-drupal/wwwroot

    আপনার প্রোডাক্ট ভার্সনের ডিফল্ট ডিরেক্টরির জন্য ডিফল্ট ইনস্টলেশন ডিরেক্টরি দেখুন।

  2. আপনার Drupal ডেটাবেস ইনস্ট্যান্সের ব্যাক-আপ নিন। pg_dump কমান্ড ডেটাবেসের একটি কপি তৈরি করে:
    pg_dump --dbname=devportal --host=192.168.56.101
  --username=drupaladmin --password --format=c > /tmp/portal.dmp

    কোথায়:

    • dbname ডেটাবেসের নাম উল্লেখ করে, যেমন পোর্টাল ইনস্টলেশন কনফিগারেশন ফাইলে PG_NAME প্রপার্টি দ্বারা উল্লেখ করা হয়েছে।
    • host পোর্টাল নোডের IP অ্যাড্রেস নির্দিষ্ট করে।
    • username পোর্টাল ইনস্টলেশন কনফিগারেশন ফাইলে DRUPAL_PG_USER প্রপার্টি দ্বারা নির্দিষ্ট করা ডেটাবেস অ্যাক্সেস করার জন্য পোর্টাল দ্বারা ব্যবহৃত Postgres ব্যবহারকারীর নাম নির্দিষ্ট করে।
    • আপনাকে Postgres ব্যবহারকারীর পাসওয়ার্ডের জন্য প্রম্পট করা হয়, যেমনটি পোর্টাল ইনস্টলেশন কনফিগারেশন ফাইলে DRUPAL_PG_PASS প্রপার্টি দ্বারা সংজ্ঞায়িত করা হয়েছে।

    পরে ব্যাক-আপ থেকে ফিরিয়ে আনতে হলে, এই কমান্ড ব্যবহার করুন:

    pg_restore --clean --dbname=devportal --host=localhost  --username=apigee < /tmp/portal.dmp
  3. আপনার সম্পূর্ণ Drupal ওয়েব রুট ডিরেক্টরির ব্যাক-আপ নিন। ইনস্টল করার ডিফল্ট লোকেশন হল /opt/apigee/apigee-drupal, তবে আপনি এটি পরিবর্তন করে থাকতে পারেন।
    এই ডিরেক্টরির লোকেশন সম্পর্কে আপনি নিশ্চিত না হলে, পাবলিক ফাইল সিস্টেম ও প্রাইভেট ফাইল সিস্টেম পাথের লোকেশন নির্ধারণ করতে (পরবর্তী ধাপের জন্য) Drupal মেনুতে drush status কমান্ড বা কনফিগারেশন > মিডিয়া > ফাইল এন্ট্রি ব্যবহার করুন।
  4. /opt/apigee/data/apigee-drupal-devportal/private-এ ফাইলের ব্যাক-আপ নিন।
  5. Drupal-কে রক্ষণাবেক্ষণ মোডে সেট করুন:
    1. Drupal মেনু থেকে কনফিগারেশন বিকল্প বেছে নিন।
    2. কনফিগারেশন পৃষ্ঠায়, ডেভেলপমেন্ট বিকল্পের অধীনে মেনটেন্যান্স মোড বেছে নিন।
    3. সাইট রক্ষণাবেক্ষণ মোডে রাখুন বক্সে টিকচিহ্ন দিন।
    4. রক্ষণাবেক্ষণ চলাকালীন ব্যবহারকারীরা দেখতে পাবেন এমন একটি মেসেজ লিখুন।
    5. কনফিগারেশন সেভ করুন বিকল্প বেছে নিন।
  6. Edge apigee-setup ইউটিলিটি ইনস্টল করুন-এ যেমন বর্ণনা করা হয়েছে সেই অনুযায়ী SELinux বন্ধ করুন।
  7. /opt ডিরেক্টরিতে পরিবর্তন করুন: 
    cd /opt
  8. ইন্টারনেট কানেকশন আছে এমন সার্ভারে আপগ্রেড করার জন্য:
    1. Edge 4.17.09 bootstrap_4.17.09.sh ফাইলটি /tmp/bootstrap_4.17.09.sh-এ ডাউনলোড করুন: 
      curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
    2. Edge 4.17.09 apigee-service ইউটিলিটি ও ডিপেন্ডেন্সি ইনস্টল করুন: 
      sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName
  apigeepassword=pWord

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

      ডিফল্ট হিসেবে, ইনস্টলার চেক করে দেখে যে আপনার Java 1.8 ইনস্টল করা আছে কিনা। Java ইনস্টল না করেই চালিয়ে যেতে আপনি "C" বিকল্প ব্যবহার করতে পারেন।

  9. ইন্টারনেট কানেকশন নেই এমন সার্ভারে আপগ্রেড করার জন্য:
    1. "স্থানীয় Apigee রিপোজিটরি তৈরি করুন" বিভাগে যেভাবে বর্ণনা করা হয়েছে সেইভাবে স্থানীয় 4.17.09 রিপো তৈরি করুন। Edge apigee-setup ইউটিলিটি ইনস্টল করুন।
    2. .tar ফাইল থেকে apigee-service ইনস্টল করতে:
      1. লোকাল রেপো সহ নোডে, লোকাল রেপোকে /opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz নামের একটি .tar ফাইলে প্যাকেজ করতে নিম্নলিখিত কমান্ডটি ব্যবহার করুন: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
      2. যে নোডে Edge আপডেট করতে চান সেখানে .tar ফাইল কপি করুন। যেমন, নতুন নোডের /tmp ডিরেক্টরিতে এটি কপি করুন।
      3. নতুন নোডে, /tmp ডিরেক্টরিতে ফাইলটি আনটার করুন:
        tar -xzf apigee-4.17.09.tar.gz

        এই কমান্ডটি .tar ফাইল ধারণকারী ডিরেক্টরিতে repos নামে একটি নতুন ডিরেক্টরি তৈরি করে। যেমন /tmp/repos.

      4. /tmp/repos থেকে Edge apigee-service ইউটিলিটি এবং ডিপেন্ডেন্সি ইনস্টল করুন: 
        sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

        লক্ষ্য করুন যে আপনি এই কমান্ডে রেপো ডিরেক্টরির পাথ অন্তর্ভুক্ত করেছেন।

    3. Nginx ওয়েবসার্ভার ব্যবহার করে apigee-service ইনস্টল করতে:
      1. Edge apigee-setup ইউটিলিটি ইনস্টল করুন-এ "Nginx ওয়েবসার্ভার ব্যবহার করে রেপো থেকে ইনস্টল করুন" বিভাগে যেভাবে বর্ণনা করা হয়েছে সেইভাবে Nginx ওয়েব সার্ভার কনফিগার করুন।
      2. রিমোট নোডে, Edge bootstrap_4.17.09.sh ফাইলটি /tmp/bootstrap_4.17.09.sh-এ ডাউনলোড করুন: 
        /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh
  -o /tmp/bootstrap_4.17.09.sh

        যেখানে uName:pWord হল রেপোর জন্য উপরে সেট করা ইউজারনেম ও পাসওয়ার্ড এবং remoteRepo হল রেপো নোডের IP অ্যাড্রেস বা ডিএনএস নাম।

      3. রিমোট নোডে, Edge apigee-service ইউটিলিটি এবং ডিপেন্ডেন্সি ইনস্টল করুন:code 
        sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939
  apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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

  10. apigee-setup ইউটিলিটি আপডেট করতে apigee-service ব্যবহার করুন: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. Postgres ডেটাবেস আপডেট করতে আপনার নোডে আপডেট ইউটিলিটি রান করুন:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

    যেখানে configFile হল কনফিগারেশন ফাইল যা আপনি Postgres ডেটাবেস ইনস্টল করতে ব্যবহার করেছেন। কনফিগারেশন ফাইলের ক্ষেত্রে একমাত্র প্রয়োজনীয়তা হল, কনফিগারেশন ফাইলটি "apigee" ব্যবহারকারীর দ্বারা অ্যাক্সেসযোগ্য বা পাঠযোগ্য হতে হবে।

  12. Postgres শুরু করুন:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  13. পোর্টাল আপডেট করতে আপনার নোডে আপডেট ইউটিলিটি রান করুন: 
    /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

    যেখানে configFile হল কনফিগারেশন ফাইল যা আপনি পোর্টাল ইনস্টল করতে ব্যবহার করেছেন। কনফিগারেশন ফাইলের ক্ষেত্রে একমাত্র প্রয়োজনীয়তা হল, কনফিগারেশন ফাইলটি "apigee" ব্যবহারকারীর দ্বারা অ্যাক্সেসযোগ্য বা পাঠযোগ্য হতে হবে।

  14. ব্রাউজার উইন্ডোতে নিম্নলিখিত URL খুলে Drupal-এর update.php স্ক্রিপ্ট রান করুন: 
    http://portalIP_DNS:8079/update.php
  15. Drupal-কে রক্ষণাবেক্ষণ মোডে বন্ধ করুন:
    1. Drupal মেনু থেকে কনফিগারেশন বিকল্প বেছে নিন।
    2. কনফিগারেশন পৃষ্ঠায়, ডেভেলপমেন্ট বিকল্পের অধীনে মেনটেন্যান্স মোড বেছে নিন।
    3. সাইট রক্ষণাবেক্ষণ মোডে রাখুন বক্স থেকে টিকচিহ্ন সরিয়ে দিন।
    4. কনফিগারেশন সেভ করুন বিকল্প বেছে নিন।

মনে রাখবেন যে আপডেট করার পরে রুট ডিরেক্টরি হল:

/opt/apigee/apigee-drupal/wwwroot

আপগ্রেড করা হয়ে গেছে।