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

Edge for Private Cloud v4.18.05

এই পদ্ধতিতে, আগে থেকে থাকা Apigee ডেভেলপার পরিষেবা পোর্টাল (বা সহজভাবে, পোর্টাল) অন-প্রিমিস ইনস্টলেশন কীভাবে আপগ্রেড করতে হয় তা বর্ণনা করা হয়েছে।

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

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

• আপনার ইনস্টলেশন Nginx/Postgres ব্যবহার করলে, নিচে দেওয়া RPM ব্যবহার করে পোর্টাল আপগ্রেড করা বিকল্প ব্যবহার করুন।
• আপনার ইনস্টলেশন Apache/MySQL বা Apache/MariaDB ব্যবহার করলে, tar-ভিত্তিক পোর্টালকে RPM-ভিত্তিক পোর্টালে কনভার্ট করুন দেখুন।

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

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

• 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
• OPDK-17-09.x
• OPDK-18-01.x

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

http://yourportal.com/buildInfo

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

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

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

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

কোনও নোডে পোর্টাল RPM আপডেট করতে:

1. ডিফল্ট হিসেবে Drupal ডিরেক্টরি, /opt/apigee/apigee-drupal-এ পরিবর্তন করুন:

   cd /opt/apigee/apigee-drupal

2. আপনার Drupal ডেটাবেস ইনস্ট্যান্সের ব্যাক-আপ নিন। pg_dump কমান্ড ডেটাবেসের একটি কপি তৈরি করে:

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

   কোথায়:

   • devportal হল ডেটাবেসের নাম যা পোর্টাল ইনস্টলেশন কনফিগারেশন ফাইলে PG_NAME প্রপার্টি দ্বারা নির্দিষ্ট করা হয়েছে।
   • host_IP_address হল পোর্টাল নোডের IP অ্যাড্রেস।
   • drupaladmin হল Postgres ইউজারনেম যা পোর্টাল ইনস্টলেশন কনফিগারেশন ফাইলে DRUPAL_PG_USER প্রপার্টি দ্বারা নির্দিষ্ট করা ডেটাবেস অ্যাক্সেস করতে পোর্টাল ব্যবহার করে।
   • আপনাকে 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. Drupal-কে রক্ষণাবেক্ষণ মোডে সেট করুন:
   1. Drupal মেনু থেকে কনফিগারেশন বিকল্প বেছে নিন।
   2. কনফিগারেশন পৃষ্ঠায়, ডেভেলপমেন্ট-এর অধীনে মেনটেন্যান্স মোড বেছে নিন।
   3. সাইট রক্ষণাবেক্ষণ মোডে রাখুন বক্সে টিকচিহ্ন দিন।
   4. রক্ষণাবেক্ষণ চলাকালীন ব্যবহারকারীরা দেখতে পাবেন এমন একটি মেসেজ লিখুন।
   5. কনফিগারেশন সেভ করুন বিকল্প বেছে নিন।
6. Edge apigee-setup ইউটিলিটি ইনস্টল করুন-এ যেমন বর্ণনা করা হয়েছে সেই অনুযায়ী SELinux বন্ধ করুন।
7. /opt ডিরেক্টরিতে পরিবর্তন করুন:

   cd /opt

8. ইন্টারনেট কানেকশন আছে এমন সার্ভারে আপগ্রেড করার জন্য:
   1. Edge 4.18.05 bootstrap_4.18.05.sh ফাইলটি /tmp/bootstrap_4.18.05.sh-এ ডাউনলোড করুন:

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

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

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

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

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

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

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

      2. যে নোডে Edge আপডেট করতে চান সেখানে .tar ফাইল কপি করুন। যেমন, নতুন নোডের /tmp ডিরেক্টরিতে এটি কপি করুন।
      3. নতুন নোডে, /tmp ডিরেক্টরিতে ফাইলটি আনটার করুন:

         tar -xzf apigee-4.18.05.tar.gz

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

      4. এখান থেকে Edge apigee-service ইউটিলিটি ও ডিপেন্ডেন্সি ইনস্টল করুন /tmp/repos:

         sudo bash /tmp/repos/bootstrap_4.18.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

   3. Nginx ওয়েবসার্ভার ব্যবহার করে apigee-service ইনস্টল করতে:
      1. Edge apigee-setup ইউটিলিটি ইনস্টল করুন লিঙ্কে "Nginx ওয়েবসার্ভার ব্যবহার করে রেপো থেকে ইনস্টল করুন" বিভাগে যেভাবে বলা হয়েছে সেইভাবে Nginx ওয়েব সার্ভার কনফিগার করুন।
      2. রিমোট নোডে, Edge bootstrap_4.18.05.sh ফাইলটি /tmp/bootstrap_4.18.05.sh-এ ডাউনলোড করুন:

         /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.05.sh
           -o /tmp/bootstrap_4.18.05.sh

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

      3. রিমোট নোডে, Edge apigee-service ইউটিলিটি এবং ডিপেন্ডেন্সি ইনস্টল করুন:

         sudo bash /tmp/bootstrap_4.18.05.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. আপনার Postgre নোডে আপডেট ইউটিলিটি রান করুন:

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

13. পোর্টাল আপডেট করতে আপনার নোডে আপডেট ইউটিলিটি রান করুন:

    /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

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

14. ব্রাউজার উইন্ডোতে নিম্নলিখিত URL খুলে Drupal-এর update.php স্ক্রিপ্ট রান করুন:

    http://portal_IP_DNS:8079/update.php

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

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

/opt/apigee/apigee-drupal/wwwroot

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