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

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

এই পদ্ধতিতে, আগে থেকে ইনস্টল করা 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 চালু আছে
    + 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)

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

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

  • /opt/apigee/apigee-drupal (Nginx)
  • /var/www/html (Apache)

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

আপনি যদি ইনস্টলেশন ডিরেক্টরি না জানেন, তাহলে সাধারণত ব্যবহৃত Drush কমান্ড-এ বর্ণিত পদ্ধতি অনুযায়ী এটি নির্ধারণ করতে পারেন।

নতুন 4.17.01 ইনস্টলেশন থেকে Nginx/Postgres আপডেট করার পরে নতুন ডিফল্ট ইনস্টলেশন ডিরেক্টরি ইনস্টলেশন

Nginx/Postgres ব্যবহার করে এমন 4.17.01-এর নতুন ইনস্টলেশন আপডেট করার পরে, রুট ডিরেক্টরি এখান থেকে পরিবর্তন করা হয়েছে:

/opt/apigee/apigee-drupal

 এখানে:

/opt/apigee/apigee-drupal/wwwroot

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

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

  • pantheon-14.02.x
  • pantheon-14.03.x
  • pantheon-14.04.x
  • pantheon-14.07.x
  • pantheon-15-01.x
  • OPDK-15-04.x
  • OPDK-15-07.x
  • OPDK-16-01.x
  • OPDK-16-05.x
  • OPDK-16-09.x
  • OPDK-17-01.x

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

http://yourportal.com/buildInfo

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

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

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

.tar ফাইল ব্যবহার করে পোর্টাল আপগ্রেড করা হচ্ছে

  1. আপনার Drupal MySQL/MariaDB ইনস্ট্যান্সের ব্যাক-আপ নিন।
    আরও তথ্যের জন্য, http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/ দেখুন
    1. বিকল্প ১: Drush ব্যবহার করুন

      Drush কমান্ড sql-dump ডেটাবেসের একটি কপি তৈরি করে। আপনার Drupal ডিরেক্টরি থেকে, ডিফল্ট হিসেবে /var/www/html, কমান্ড রান করুন:
      > drush sql-dump > /path/to/backup_dir/database-backup.sql

      আরও তথ্যের জন্য drush help sql-dump ব্যবহার করুন।
    2. বিকল্প ২: MySQLdump ব্যবহার করুন
      ডেটাবেসের কপি তৈরি করতে mysqldump কমান্ড ব্যবহার করুন:
      mysqldump -u USERNAME -p'PASSWORD' DATABASENAME > /path/to/backup_dir/database-backup.sql

      -p বিকল্প এবং পাসওয়ার্ডের মধ্যে কোনও স্পেস থাকা চলবে না। পাসওয়ার্ডে বিশেষ অক্ষর থাকলে, পাসওয়ার্ডের শুরুতে ও শেষে সিঙ্গেল কোট ব্যবহার করতে হবে।

      আপনি পোর্টাল ইনস্টল করার সময় USERNAME এবং DATABASENAME সেট করেছেন। ডিফল্ট হিসেবে, দুটিই devportal।
  2. আপনার সম্পূর্ণ Drupal ওয়েব রুট ডিরেক্টরির ব্যাক-আপ নিন। ডিফল্ট ইনস্টল লোকেশন হল /var/www/html, তবে আপনি ইনস্টল করার সময় এটি পরিবর্তন করে থাকতে পারেন।
  3. ftp.apigee.com থেকে ডেভেলপার চ্যানেল পরিষেবা DeveloperServices_x.y.z.tar ফাইল ডাউনলোড করুন, যেখানে x.y.z পোর্টাল ভার্সন নম্বরকে বোঝায়। প্রম্পট করা হলে, Apigee থেকে পাওয়া ক্রেডেনশিয়াল লিখুন।

    আপনি ব্রাউজারে Apigee-এর পাঠানো লিঙ্ক থেকে অথবা সেটি কপি করে নিম্নলিখিত cURL কমান্ডে যোগ করে ফাইল ডাউনলোড করতে পারবেন:
    > curl -kOL <এখানে লিঙ্ক পেস্ট করুন>

    মনে রাখবেন: আপনার পোর্টাল যদি এমন কোনও সার্ভারে থাকে যেখানে কোনও এক্সটার্নাল ইন্টারনেট কানেকশন নেই, তাহলে অ্যাক্সেস আছে এমন কোনও সার্ভারে এই ধাপটি সম্পূর্ণ করুন।

    Apigee Edge সহায়তা লিঙ্কে যান এবং ডেভেলপার চ্যানেল পরিষেবা আপগ্রেড .tar ফাইলের জন্য অনুরোধ করতে আপনার সহায়তা পোর্টালে লগ-ইন করুন বিকল্প বেছে নিন। সহায়তা পোর্টালে আপনার অ্যাকাউন্ট না থাকলে, আপনার সহায়তা পোর্টালে লগ-ইন করুন বিকল্প বেছে নিন এবং তারপর সাইন-ইন পৃষ্ঠায় তাড়াহুড়ো আছে? এখানে সহায়তা টিকিট তৈরি করুন।
  4. ইন্টারনেট কানেকশন আছে এমন সার্ভারে আপগ্রেড করার জন্য:
    1. পোর্টাল আপগ্রেড ফাইল এক্সট্র্যাক্ট করুন:
      > tar -xvf <tar file>

      এই কমান্ড এক্সট্র্যাক্ট DeveloperServices-4.x.y.z নামে একটি নতুন ডিরেক্টরি তৈরি করে।
    2. DeveloperServices-4.x.y.z ডিরেক্টরিতে পরিবর্তন করুন।
    3. নিম্নলিখিত কমান্ড ব্যবহার করে লেটেস্ট Drupal ভার্সন ডাউনলোড করুন:
      > drush dl drupal

      এই কমান্ড drupal-x.y নামের একটি ডিরেক্টরি তৈরি করে, যেখানে x.y হল Drupal-এর বর্তমান ভার্সন।
    4. networked-update.sh স্ক্রিপ্ট রান করান:
      > ./networked-update.sh

      ফাইল অ্যাক্সেস করার পারমিশনের উপর নির্ভর করে, এই কমান্ড রান করানোর জন্য আপনাকে sudo ব্যবহার করতে হতে পারে অথবা অ্যাডমিনিস্ট্রেটর হিসেবে এটি রান করাতে হতে পারে।
    5. Drupal আপডেট সংক্রান্ত বিজ্ঞপ্তি পেতে, Drupal আপডেট ম্যানেজার মডিউল চালু আছে কিনা তা নিশ্চিত করুন। Drupal মেনু থেকে, মডিউল বেছে নিন এবং স্ক্রল করে নিচে আপডেট ম্যানেজার মডিউলে যান। এটি চালু করা না থাকলে, চালু করুন।

      চালু করার পরে, আপনি রিপোর্ট > উপলভ্য আপডেট মেনু আইটেম ব্যবহার করে উপলভ্য আপডেট দেখতে পাবেন।

      আপডেট উপলভ্য হলে আপনাকে ইমেল করার জন্য মডিউল কনফিগার করতে এবং আপডেট চেক করার ফ্রিকোয়েন্সি সেট করতে রিপোর্ট > উপলভ্য আপডেট > সেটিংস মেনু আইটেম ব্যবহার করুন।
  5. ইন্টারনেট কানেকশন নেই এমন সার্ভারে আপগ্রেড করার জন্য:
    1. যে সার্ভার থেকে আপনি ডেভেলপার চ্যানেল পরিষেবা DeveloperServices_x.y.z.tar ফাইল ডাউনলোড করেছেন, সেখানে পোর্টাল আপগ্রেড ফাইল এক্সট্র্যাক্ট করুন:
      > tar -xvf <tar file>

      এই কমান্ড এক্সট্র্যাক্ট DeveloperServices-4.x.y.z নামে একটি নতুন ডিরেক্টরি তৈরি করে।
    2. DeveloperServices-4.x.y.z ডিরেক্টরিতে পরিবর্তন করুন।
    3. non-networked-update.sh স্ক্রিপ্ট রান করুন:
      > ./non-networked-update.sh

      ফাইল অ্যাক্সেস করার পারমিশনের উপর নির্ভর করে, এই কমান্ড রান করার জন্য আপনাকে sudo ব্যবহার করতে হতে পারে অথবা অ্যাডমিনিস্ট্রেটর হিসেবে এটি রান করতে হতে পারে।

      এই কমান্ডটি সমস্ত প্রয়োজনীয় আপডেট ফাইল ডাউনলোড করে এবং সেগুলিকে devportal-update.tgz নামের একটি ফাইলে প্যাকেজ করে এবং আপনার বেছে নেওয়া লোকেশনে ফাইলটি সেভ করে।
    4. টার্গেট সার্ভারে devportal-update.tgz কপি করুন, যেটি পোর্টাল চালাচ্ছে।
      মনে রাখবেন: টার্গেট সার্ভারের ওয়েব রুটে devportal-update.tgz কপি করবেন না।
    5. বর্তমান ডিরেক্টরিতে devportal-update.tgz ফাইলটি আনটার করুন:
      > tar -xzf /path/to/devportal-update.tgz
    6. developer-update ডিরেক্টরিতে পরিবর্তন করুন।
    7. আপডেট ইনস্টল করতে এই কমান্ড রান করুন:
      > ./install-update.sh
    8. প্রম্পটের উত্তর দিন।

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

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

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

  1. ডিফল্ট হিসেবে Drupal ডিরেক্টরি, /opt/apigee/apigee-drupal-এ পরিবর্তন করুন:
    > cd /opt/apigee/apigee-drupal
  2. আপনার Drupal ডেটাবেস ইনস্ট্যান্সের ব্যাক-আপ নিন। pg_dump কমান্ড ডেটাবেসের একটি কপি তৈরি করে:

    pg_dump --dbname=devportal --host=192.168.56.101 --username=drupaladmin --password --format=c > /tmp/portal.dmp

    যেখানে:
    • dbname পোর্টাল ইনস্টলেশন কনফিগারেশন ফাইলে PG_NAME প্রপার্টি দ্বারা নির্দিষ্ট করা ডেটাবেসের নাম নির্দিষ্ট করে।
    • হোস্ট পোর্টাল নোডের 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, তবে আপনি এটি পরিবর্তন করে থাকতে পারেন।

    এই ডিরেক্টরির লোকেশন সম্পর্কে নিশ্চিত না হলে, drush status কমান্ড ব্যবহার করুন অথবা Drupal মেনুতে কনফিগারেশন > মিডিয়া > ফাইল এন্ট্রি ব্যবহার করে পাবলিক ফাইল সিস্টেম ও প্রাইভেট ফাইল সিস্টেম পাথের লোকেশন (পরবর্তী ধাপের জন্য) নির্ধারণ করুন।
  4. /opt/apigee/data/apigee-drupal-devportal/private-এ ফাইলের ব্যাক-আপ নিন।
  5. Edge apigee-setup ইউটিলিটি ইনস্টল করুন-এ যেভাবে বলা হয়েছে সেইভাবে SELinux বন্ধ করুন।
  6. ইন্টারনেট কানেকশন আছে এমন সার্ভারে আপগ্রেড করার জন্য:
    1. Edge 4.17.05 bootstrap_4.17.05.sh ফাইলটি /tmp/bootstrap_4.17.05.sh-এ ডাউনলোড করুন:
      > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
    2. Edge 4.17.05 apigee-service ইউটিলিটি এবং নির্ভরতা ইনস্টল করুন:
      > sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord

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

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

        এই কমান্ডটি .tar ফাইল থাকা ডিরেক্টরিতে repos নামে একটি নতুন ডিরেক্টরি তৈরি করে। যেমন /tmp/repos.
      4. /tmp/repos থেকে Edge apigee-service ইউটিলিটি এবং ডিপেন্ডেন্সি ইনস্টল করুন:
        > sudo bash /tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

        যেখানে uName:pWord হল রেপোর জন্য উপরে সেট করা ইউজারনেম ও পাসওয়ার্ড এবং remoteRepo হল রেপো নোডের IP অ্যাড্রেস বা DNS নাম।
      3. রিমোট নোডে, Edge apigee-service ইউটিলিটি এবং নির্ভরতা ইনস্টল করুন:
        > sudo bash /tmp/bootstrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

        যেখানে uName:pWord হল রেপো ইউজারনেম এবং পাসওয়ার্ড।
  8. apigee-setup ইউটিলিটি আপডেট করতে apigee-service ব্যবহার করুন:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  9. Postgres ডেটাবেস আপডেট করতে আপনার নোডে আপডেট ইউটিলিটি রান করুন:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

    যেখানে configFile হল কনফিগারেশন ফাইল যা আপনি Postgres ডেটাবেস ইনস্টল করতে ব্যবহার করেছেন। কনফিগারেশন ফাইলের একমাত্র প্রয়োজনীয়তা হল, কনফিগারেশন ফাইলটি "apigee" ব্যবহারকারীর দ্বারা অ্যাক্সেসযোগ্য বা পাঠযোগ্য হতে হবে।
  10. Postgres শুরু করুন:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  11. পোর্টাল আপডেট করতে আপনার নোডে আপডেট ইউটিলিটি রান করুন:
    > /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

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

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

/opt/apigee/apigee-drupal/wwwroot

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