การอัปเกรดพอร์ทัลบริการสําหรับนักพัฒนาแอป

Edge for Private Cloud v4.18.01

ขั้นตอนนี้อธิบายถึงวิธีอัปเกรดบริการช่องทางขายสำหรับนักพัฒนาซอฟต์แวร์ 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

หากต้องการทราบเวอร์ชันของพอร์ทัล ให้เปิด URL ต่อไปนี้ในเบราว์เซอร์

http://yourportal.com/buildInfo

ก่อนที่คุณจะอัปเดต

สำหรับการติดตั้งที่มีอยู่ หากคุณได้แก้ไขโค้ดใน Drupal Core หรือในโค้ดใดๆ ที่ไม่ได้กำหนดเอง การแก้ไขของคุณจะถูกเขียนทับ ซึ่งรวมถึงการเปลี่ยนแปลงใดๆ ก็ตาม ที่คุณอาจทำกับ .htaccess คุณควรสมมติว่า Drupal เป็นเจ้าของทุกสิ่งที่อยู่นอกไดเรกทอรี /sites CANNOT TRANSLATE ข้อยกเว้นสำหรับกฎนี้คือ 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=192.168.56.101 --username=drupaladmin
     --password --format=c > /tmp/portal.dmp

   โดยมี

   • dbname ระบุชื่อฐานข้อมูลตามที่ระบุโดย พร็อพเพอร์ตี้ PG_NAME ในไฟล์การกำหนดค่าการติดตั้งพอร์ทัล
   • host ระบุที่อยู่ IP ของโหนดพอร์ทัล
   • username ระบุ ชื่อผู้ใช้ 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. เลือก Configuration ในเมนู Drupal
   2. ในหน้า การกำหนดค่า ให้เลือก การบำรุงรักษา โหมด ภายใต้ การพัฒนา
   3. เลือกช่องทำให้เว็บไซต์เข้าสู่โหมดบำรุงรักษา
   4. ป้อนข้อความที่ผู้ใช้เห็นระหว่างการบำรุงรักษา
   5. เลือกบันทึกการกำหนดค่า
6. ปิดใช้ SELinux ตามที่อธิบายไว้ใน ติดตั้งยูทิลิตีการตั้งค่า Apigee ของ Edge
7. เปลี่ยนเป็นไดเรกทอรี /opt:

   > cd /opt

8. สำหรับการอัปเกรดในเซิร์ฟเวอร์ที่มีการเชื่อมต่ออินเทอร์เน็ต ให้ทำดังนี้
   1. ดาวน์โหลดไฟล์ Edge 4.18.01 bootstrap_4.18.01.sh ไปยัง /tmp/bootstrap_4.18.01.sh:

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

   2. ติดตั้งยูทิลิตีและ Dependency ของ Edge 4.18.01 apigee-service ดังนี้

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

      โดย uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณได้รับ Apigee หากคุณไม่ใส่ pWord ระบบจะแจ้งให้คุณป้อน

      โดยค่าเริ่มต้น โปรแกรมติดตั้งจะตรวจสอบว่าคุณติดตั้ง Java 1.8 แล้ว คุณสามารถใช้ "C" เพื่อดำเนินการต่อโดยไม่ติดตั้ง Java

9. สำหรับการอัปเกรดในเซิร์ฟเวอร์ที่ไม่มีการเชื่อมต่ออินเทอร์เน็ต ให้ทำดังนี้
   1. สร้างที่เก็บ 4.18.01 ในเครื่องตามที่อธิบายไว้ใน "สร้างที่เก็บ Apigee ในเครื่อง" ที่ ติดตั้ง Edge ยูทิลิตีการตั้งค่า Apigee
   2. วิธีติดตั้ง apigee-service จากไฟล์ .tar
      1. ในโหนดที่มีที่เก็บในเครื่อง ให้ใช้คำสั่งต่อไปนี้เพื่อจัดแพ็กเกจในเครื่อง เก็บลงในไฟล์ .tar ไฟล์เดียวที่ชื่อ /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz:

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

      2. คัดลอกไฟล์ .tar ไปยังโหนดที่ต้องการอัปเดต Edge เช่น คัดลอก ไปที่ไดเรกทอรี /tmp ในโหนดใหม่
      3. ในโหนดใหม่ ให้ยกเลิกการอัปโหลดไฟล์ไปยังไดเรกทอรี /tmp ดังนี้

         tar -xzf apigee-4.18.01.tar.gz

         คำสั่งนี้จะสร้างไดเรกทอรีใหม่ที่ชื่อว่า repos ในไดเรกทอรีที่มี .tar เช่น /tmp/repos

      4. ติดตั้งยูทิลิตี Edge apigee-service และการอ้างอิงจาก /tmp/repos:

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

         คุณจะเห็นว่าใส่เส้นทางไปยังไดเรกทอรี repos ในคำสั่งนี้

   3. วิธีติดตั้ง apigee-service โดยใช้เว็บเซิร์ฟเวอร์ Nginx
      1. กำหนดค่าเว็บเซิร์ฟเวอร์ Nginx ตามที่อธิบายไว้ใน "ติดตั้งจากที่เก็บโดยใช้ เว็บเซิร์ฟเวอร์ Nginx" ที่ Install the Edge ยูทิลิตีการตั้งค่า Apigee
      2. ในโหนดระยะไกล ให้ดาวน์โหลดไฟล์ Edge bootstrap_4.18.01.sh ไปยัง /tmp/bootstrap_4.18.01.sh:

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

         โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณตั้งไว้ด้านบน สำหรับที่เก็บ และ remoteRepo คือที่อยู่ IP หรือชื่อ DNS ของ โหนดที่เก็บ

      3. ในโหนดระยะไกล ให้ติดตั้งยูทิลิตี Edge apigee-service และ ทรัพยากร Dependency:

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

         โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่เก็บ

10. ใช้ apigee-service เพื่ออัปเดตยูทิลิตี apigee-setup:

    /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. เรียกใช้สคริปต์ update.php ของ Drupal โดยเปิด URL ต่อไปนี้ในหน้าต่างเบราว์เซอร์

    http://portalIP_DNS:8079/update.php

15. ปิดใช้ Drupal ในโหมดบำรุงรักษา
    1. เลือก Configuration ในเมนู Drupal
    2. ในหน้า การกำหนดค่า ให้เลือก การบำรุงรักษา โหมด ภายใต้ การพัฒนา
    3. ยกเลิกการเลือกช่องทำให้เว็บไซต์เข้าสู่โหมดบำรุงรักษา
    4. เลือกบันทึกการกำหนดค่า

โปรดทราบว่าไดเรกทอรีรากหลังจากการอัปเดตจะเป็นดังนี้

/opt/apigee/apigee-drupal/wwwroot

การอัปเกรดเสร็จสมบูรณ์แล้ว