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

Edge for Private Cloud v4.18.01

ขั้นตอนนี้อธิบายถึงวิธีอัปเกรดบริการช่องทางขายสำหรับนักพัฒนาซอฟต์แวร์ Apigee ที่มีอยู่ จากการติดตั้งภายในองค์กร

การพิจารณาขั้นตอนการอัปเดตที่ถูกต้อง

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

กำลังตรวจสอบ ประเภทการติดตั้งปัจจุบันของคุณ

หากไม่แน่ใจเกี่ยวกับประเภทการติดตั้งปัจจุบัน ให้ใช้คําสั่งต่อไปนี้เพื่อระบุประเภท

  • 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 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

    where:

    • 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. เลือกการกําหนดค่าในเมนู 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. ติดตั้งยูทิลิตีและไลบรารีของ 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 ในพื้นที่" ที่หัวข้อติดตั้งยูทิลิตี apigee-setup ของ Edge
    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. ติดตั้งยูทิลิตี apigee-service ของ Edge และไลบรารีที่เกี่ยวข้องจาก /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 และ dependencies: 
        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

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