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

พอร์ทัลบริการสำหรับนักพัฒนาซอฟต์แวร์ เวอร์ชัน 4.17.05

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

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

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

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

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

  • ls /opt
    หากใช้ Nginx/Postgres คุณจะเห็นไดเรกทอรีต่อไปนี้ /opt/apigee และ /opt/nginx

    หากคุณใช้ Apache/MySQL หรือ Apache/MariaDB ไดเรกทอรีเหล่านี้ก็ไม่ควร ปัจจุบัน
  • /opt/apigee/apigee-service/bin/apigee-all สถานะ
    หากใช้ Nginx/Postgres คุณจะเห็นผลลัพธ์ต่อไปนี้

    + apigee-service สถานะ apigee-drupal-devportal
    ตกลง: apigee-drupal-devportal ทำงานแล้ว
    + สถานะ apigee-lb ของบริการ apigee
    apigee-service: apigee-lb: ตกลง
    + สถานะ Apigee-postgresql ของบริการ Apigee
    apigee-service: apigee-postgresql: ตกลง
  • 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 ที่ใช้กันโดยทั่วไป

รายงานใหม่ ไดเรกทอรีการติดตั้งเริ่มต้นหลังจากการอัปเดต Nginx/Postgres จาก 4.17.01 ใหม่ การติดตั้ง

หลังจากอัปเดตการติดตั้ง 4.17.01 ใหม่ที่ใช้ Nginx/Postgres ไดเรกทอรีราก เปลี่ยนจาก:

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

ก่อนดำเนินการติดตั้ง ให้สำรองข้อมูลรูทเว็บของ Drupal ทั้งหมด ไดเรกทอรี หลังจากทำตามขั้นตอนการติดตั้งตามที่อธิบายไว้ด้านล่างแล้ว คุณสามารถคืนค่า การปรับแต่งจากข้อมูลสำรอง

การอัปเกรดพอร์ทัลโดยใช้ไฟล์ .tar

  1. สำรองอินสแตนซ์ Drupal MySQL/MariaDB
    ดูข้อมูลเพิ่มเติมได้ที่ http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/
    1. ตัวเลือกที่ 1: ใช้แปรง

      คำสั่ง Drush sql-dump สร้างสำเนาของฐานข้อมูล จากไดเรกทอรี Drupal ของคุณ ให้ใช้ /var/www/html โดยค่าเริ่มต้น ให้เรียกใช้ คำสั่ง:
      Drush Sql-Dump > /path/to/backup_dir/database-backup.sql

      ใช้ drush Help sql-dump สำหรับ ข้อมูลเพิ่มเติม
    2. ตัวเลือกที่ 2: ใช้ MySQLdump
      ใช้คำสั่ง mysqldump ในการสร้างสำเนาของฐานข้อมูล ให้ทำดังนี้
      Mysqldump -U USERNAME -p'รหัสผ่าน' ชื่อฐานข้อมูล > /path/to/backup_dir/database-backup.sql

      โดยไม่ควรมีช่องว่างระหว่างตัวเลือก -p และรหัสผ่าน ซิงเกิล ต้องมีเครื่องหมายอัญประกาศล้อมรอบรหัสผ่านหากรหัสผ่านมีสัญลักษณ์พิเศษ

      คุณตั้งค่า USERNAME และ DATABASENAME เมื่อคุณติดตั้งพอร์ทัล โดยค่าเริ่มต้น ทั้ง 2 อย่างคือ devportal
  2. สำรองข้อมูลไดเรกทอรีรูทของเว็บ Drupal ทั้งหมด ตำแหน่งการติดตั้งเริ่มต้นคือ /var/www/html แต่คุณอาจ มีการเปลี่ยนแปลง ณ เวลาติดตั้ง
  3. ดาวน์โหลดบริการช่องทางขาย DeveloperServices_x.y.z.tar จาก ftp.apigee.com โดยที่ x.y.z จะตรงกับหมายเลขเวอร์ชันของพอร์ทัล เมื่อได้รับข้อความแจ้ง ให้ป้อนข้อมูลเข้าสู่ระบบที่ได้รับ จาก Apigee

    คุณสามารถดาวน์โหลดไฟล์จากลิงก์ที่ Apigee ส่งให้คุณในเบราว์เซอร์หรือโดยการคัดลอกไฟล์และ แล้วเพิ่มลงในคำสั่ง cURL ต่อไปนี้:
    &gt; curl -kOL <วางลิงก์ here&gt;

    หมายเหตุ: หากพอร์ทัลของคุณอยู่ในเซิร์ฟเวอร์ที่ไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก ดำเนินการขั้นตอนนี้ในเซิร์ฟเวอร์ที่มีสิทธิ์เข้าถึง

    ไปที่การสนับสนุน Apigee Edge และเลือก เข้าสู่ระบบพอร์ทัลการสนับสนุน เพื่อขอช่องนักพัฒนาซอฟต์แวร์ ไฟล์ .tar สำหรับการอัปเกรดบริการ ถ้าคุณไม่มีบัญชีในพอร์ทัลการสนับสนุน ให้เลือก ลงชื่อเข้าใช้พอร์ทัลการสนับสนุน จากนั้นในหน้าลงชื่อเข้าใช้ ให้เลือกใน รีบไหม ยื่นตั๋วสนับสนุนที่นี่
  4. สำหรับการอัปเกรดในเซิร์ฟเวอร์ที่มีการเชื่อมต่ออินเทอร์เน็ต ให้ทำดังนี้
    1. แตกไฟล์อัปเกรดพอร์ทัล:
      &gt; tar -xvf <tar file&gt;

      การดึงข้อมูลคำสั่งนี้จะสร้างไดเรกทอรีใหม่ชื่อ DeveloperServices-4.x.y.z
    2. เปลี่ยนเป็น DeveloperServices-4.x.y.z ไดเรกทอรี
    3. ดาวน์โหลด Drupal เวอร์ชันล่าสุดโดยใช้คำสั่งต่อไปนี้
      &gt; drush dl drupal

      คำสั่งนี้จะสร้างไดเรกทอรีชื่อ drupal-x.y โดยที่ x.y สอดคล้องกับตัวแปรปัจจุบัน Drupal เวอร์ชันเดิม
    4. เรียกใช้สคริปต์ networked-update.sh ดังนี้
      ./networked-update.sh

      คุณอาจต้องใช้ sudo เพื่อเรียกใช้คำสั่งนี้ หรือเรียกใช้เป็น ทั้งนี้ขึ้นอยู่กับสิทธิ์ของไฟล์ ผู้ดูแลระบบ
    5. หากต้องการรับการแจ้งเตือนเกี่ยวกับการอัปเดตของ Drupal ให้ตรวจสอบว่าตัวจัดการการอัปเดตของ Drupal เปิดใช้งานโมดูลแล้ว จากเมนู Drupal ให้เลือกโมดูล แล้วเลื่อนลงไปที่ โมดูล Update Manager หากไม่ได้เปิดใช้ ให้เปิดใช้

      เมื่อเปิดใช้แล้ว คุณสามารถดูการอัปเดตที่มีได้โดยใช้ รายงาน > พร้อมใช้งาน รายการในเมนูอัปเดต

      ใช้ รายงาน > การอัปเดตที่มี > รายการในเมนูการตั้งค่า กำหนดค่าโมดูลให้ส่งอีเมลถึงคุณเมื่อมีการอัปเดตพร้อมใช้งาน และเพื่อกำหนดความถี่สำหรับ กำลังตรวจหาการอัปเดต
  5. สำหรับการอัปเกรดในเซิร์ฟเวอร์ที่ไม่มีการเชื่อมต่ออินเทอร์เน็ต ให้ทำดังนี้
    1. บนเซิร์ฟเวอร์ที่คุณดาวน์โหลดไฟล์ DeveloperServices_x.y.z.tar สำหรับ Developer Channel Services แยกไฟล์อัปเกรดพอร์ทัล:
      tar -xvf <tar file&gt;

      การดึงข้อมูลคำสั่งนี้จะสร้างไดเรกทอรีใหม่ชื่อ 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. เรียกใช้คำสั่งต่อไปนี้เพื่อติดตั้งการอัปเดต
      &gt; ./install-update.sh
    8. ตอบพรอมต์

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

การอัปเกรดพอร์ทัลโดยใช้ RPM

ใช้ขั้นตอนต่อไปนี้เพื่ออัปเดต RPM พอร์ทัลในโหนด

  1. เปลี่ยนเป็นไดเรกทอรี Drupal /opt/apigee/apigee-drupal โดย ค่าเริ่มต้น:
    &gt; 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 --สะอาด --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. ปิดใช้งาน SELinux ตามที่อธิบายไว้ใน ติดตั้ง ยูทิลิตีการตั้งค่า Apigee ของ Edge
  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. ติดตั้งยูทิลิตี apigee-service ของ Edge 4.17.05 และ ทรัพยากร Dependency:
      Sudo Bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord

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

      โดยค่าเริ่มต้น โปรแกรมติดตั้งจะตรวจสอบว่าคุณติดตั้ง Java 1.8 แล้ว คุณสามารถใช้ "C" เพื่อดำเนินการต่อโดยไม่ติดตั้ง Java
  7. สำหรับการอัปเกรดในเซิร์ฟเวอร์ที่ไม่มีการเชื่อมต่ออินเทอร์เน็ต ให้ทำดังนี้
    1. สร้างที่เก็บ 4.17.05 ในเครื่องตามที่อธิบายไว้ใน "สร้างที่เก็บ Apigee ในเครื่อง" ที่ ติดตั้งการตั้งค่า Apigee ของ Edge ยูทิลิตี
      หมายเหตุ: หากมีที่เก็บเวอร์ชัน 4.17.01 อยู่แล้ว คุณสามารถเพิ่ม ที่เก็บ 4.17.05 ไปยังที่เก็บตามที่อธิบายไว้ใน "อัปเดตที่เก็บ Apigee ในเครื่อง" ที่ติดตั้งยูทิลิตีการตั้งค่า Apigee ของ Edge
    2. วิธีติดตั้ง apigee-service จากไฟล์ .tar
      1. ในโหนดที่มีที่เก็บในเครื่อง ให้ใช้คำสั่งต่อไปนี้เพื่อจัดแพ็กเกจในเครื่อง เก็บลงในไฟล์ .tar ไฟล์เดียวที่ชื่อ /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz ดังนี้
        /opt/apigee/apigee-service/bin/apigee-service แพ็กเกจ apigee-Mirror
      2. คัดลอกไฟล์ .tar ไปยังโหนดที่ต้องการอัปเดต Edge เช่น คัดลอก ไปที่ไดเรกทอรี /tmp ในโหนดใหม่
      3. ในโหนดใหม่ ให้ยกเลิกการอัปโหลดไฟล์ไปยังไดเรกทอรี /tmp:
        &gt; tar -Xzf apigee-4.17.05.tar.gz

        คำสั่งนี้จะสร้างไดเรกทอรีใหม่ที่ชื่อว่า repos ในไดเรกทอรีที่มี .tar เช่น /tmp/repos
      4. ติดตั้งยูทิลิตี apigee-service ของ Edge และ ทรัพยากร Dependency จาก /tmp/repos:
        Sudo Bash /tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

        คุณจะเห็นว่าใส่เส้นทางไปยังไดเรกทอรี repos ในคำสั่งนี้
    3. วิธีติดตั้ง apigee-service โดยใช้เว็บเซิร์ฟเวอร์ Nginx
      1. กำหนดค่าเว็บเซิร์ฟเวอร์ Nginx ตามที่อธิบายไว้ใน "ติดตั้งจากที่เก็บโดยใช้ เว็บเซิร์ฟเวอร์ Nginx" ที่ Install the Edge ยูทิลิตีการตั้งค่า Apigee
      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. ในโหนดระยะไกล ให้ติดตั้งยูทิลิตี apigee-service ของ Edge และ ทรัพยากร Dependency:
        Sudo Bash /tmp/bootstrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

        โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่เก็บ
  8. ใช้ apigee-service เพื่อ อัปเดต apigee-setup ยูทิลิตี:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup อัปเดต
  9. เรียกใช้ยูทิลิตีการอัปเดตในโหนดเพื่ออัปเดตฐานข้อมูล Postgres โดยทำดังนี้
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

    โดยที่ configFile คือไฟล์การกำหนดค่าที่ใช้ติดตั้ง ฐานข้อมูล Postgres ข้อกำหนดเพียงอย่างเดียวในไฟล์การกำหนดค่าก็คือ การกำหนดค่า ต้องเข้าถึงหรืออ่านได้โดย "apigee" ผู้ใช้
  10. เริ่ม Postgres:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql การเริ่มต้น
  11. เรียกใช้ยูทิลิตีการอัปเดตในโหนดเพื่ออัปเดตพอร์ทัล:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

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

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

/opt/apigee/apigee-drupal/wwwroot

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