อัปเกรดพอร์ทัล

กระบวนการนี้อธิบายวิธีอัปเกรดพอร์ทัล Apigee Developer Services ที่มีอยู่ (หรือเรียกง่ายๆ ว่าพอร์ทัล) ภายในองค์กร ของคุณ

ระบุกระบวนการอัปเดตที่ถูกต้อง

ขั้นตอนที่คุณใช้เพื่ออัปเดตพอร์ทัลจะขึ้นอยู่กับการติดตั้งปัจจุบันของคุณ ดังนี้

• หากการติดตั้งใช้ 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 ขึ้นไป

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

   cd /opt

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

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

   2. ติดตั้งยูทิลิตีและการอ้างอิง Edge 4.51.00 apigee-service:

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

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

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

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

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

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

         tar -xzf apigee-4.51.00.tar.gz

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

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

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

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

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

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

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

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

         sudo bash /tmp/bootstrap_4.51.00.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. เรียกใช้ยูทิลิตี update ในโหนด Postgres ของคุณ

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

    โดยที่ configFile คือไฟล์การกำหนดค่าที่ใช้ติดตั้ง ฐานข้อมูล Postgres ข้อกำหนดเพียงอย่างเดียวในไฟล์การกำหนดค่าก็คือ การกำหนดค่า ต้องเข้าถึงหรืออ่านได้โดย "apigee" ผู้ใช้