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

Developer Services Portal v. 4.17.01

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

ไดเรกทอรีการติดตั้งเริ่มต้น

กระบวนการอัปเกรดจะถือว่ามีการติดตั้งพอร์ทัลนักพัฒนาซอฟต์แวร์ที่ /var/www/html หากคุณไม่ได้ติดตั้งพอร์ทัลในไดเรกทอรีเริ่มต้น ให้แก้ไขเส้นทางในขั้นตอนด้านล่างเพื่อใช้ไดเรกทอรีการติดตั้งของคุณ

หากไม่ทราบไดเรกทอรีการติดตั้ง คุณสามารถค้นหาได้ตามที่อธิบายไว้ในคำสั่ง Drush ที่ใช้กันโดยทั่วไป

เวอร์ชันการอัปเกรดที่รองรับ

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

• 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

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

http://yourportal.com/buildInfo

ก่อนติดตั้ง

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

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

การอัปเกรดบริการช่องทางสำหรับนักพัฒนาซอฟต์แวร์ Apigee เป็นรุ่นใหม่

1. ข้อมูลสำรองของอินสแตนซ์ Drupal MySQL
   ดูข้อมูลเพิ่มเติมได้ที่ http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/
   1. ตัวเลือกที่ 1: ใช้ Drush
      
      คำสั่ง 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'PASSWORD' DATABASENAME > /path/to/backup_dir/database-backup.sql
      
      ไม่ควรมีช่องว่างระหว่างตัวเลือก -p กับรหัสผ่าน ต้องใส่เครื่องหมายคำพูดเดี่ยวรอบรหัสผ่านหากรหัสผ่านมีสัญลักษณ์พิเศษ
      
      คุณตั้งค่า USERNAME และ DATABASENAME เมื่อติดตั้งพอร์ทัล โดยค่าเริ่มต้น ทั้ง 2 รายการจะเป็น devportal
2. สำรองข้อมูลไดเรกทอรีรากของเว็บ Drupal ทั้งหมด ตำแหน่งการติดตั้งเริ่มต้นคือ /var/www/html แต่คุณอาจเปลี่ยนตำแหน่งนี้ได้ในเวลาที่ติดตั้ง
3. ดาวน์โหลดไฟล์ Developer Channel Services DeveloperServices_x.y.z.tar จาก ftp.apigee.com โดยที่ x.y.z สอดคล้องกับหมายเลขเวอร์ชันของพอร์ทัล เมื่อได้รับข้อความแจ้ง ให้ป้อนข้อมูลเข้าสู่ระบบที่คุณได้รับจาก Apigee
   
   คุณสามารถดาวน์โหลดไฟล์จากลิงก์ที่ Apigee ส่งให้คุณในเบราว์เซอร์ หรือโดยการคัดลอกลิงก์แล้วเพิ่มลงในคำสั่ง cURL ต่อไปนี้
   > curl -kOL <วางลิงก์ที่นี่>
   
   หมายเหตุ: หากพอร์ทัลของคุณอยู่ในเซิร์ฟเวอร์ที่ไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก ให้ทำขั้นตอนนี้ในเซิร์ฟเวอร์ที่มีสิทธิ์เข้าถึง
   
   ไปที่ http://community.apigee.com/content/apigee-customer-support แล้วเลือกเข้าสู่ระบบพอร์ทัลการสนับสนุนเพื่อขอไฟล์ .tar สำหรับการอัปเกรดบริการช่องทางสำหรับนักพัฒนาแอป หากไม่มีบัญชีในพอร์ทัลการสนับสนุน ให้เลือกเข้าสู่ระบบพอร์ทัลการสนับสนุน แล้วเลือกรีบใช่ไหม สร้างคำขอแจ้งปัญหาที่นี่
4. สำหรับการอัปเกรดในเซิร์ฟเวอร์ที่มีการเชื่อมต่ออินเทอร์เน็ต ให้ทำดังนี้
   1. แตกไฟล์อัปเกรดพอร์ทัล:
      > tar -xvf <tar file>
      
      คำสั่งแตกไฟล์นี้จะสร้างไดเรกทอรีใหม่ชื่อ DeveloperServices-4.x.y.z
   2. เปลี่ยนเป็นไดเรกทอรี DeveloperServices-4.x.y.z
   3. ดาวน์โหลด Drupal เวอร์ชันล่าสุดโดยใช้คำสั่งต่อไปนี้
      > drush dl drupal
      
      คำสั่งนี้จะสร้างไดเรกทอรีชื่อ drupal-x.y โดยที่ x.y สอดคล้องกับ Drupal เวอร์ชันปัจจุบัน
   4. เรียกใช้สคริปต์ networked-update.sh:
      > ./networked-update.sh
      
      คุณอาจต้องใช้ sudo เพื่อเรียกใช้คำสั่งนี้ หรือเรียกใช้ในฐานะผู้ดูแลระบบ ทั้งนี้ขึ้นอยู่กับสิทธิ์ในไฟล์
   5. หากต้องการรับการแจ้งเตือนเกี่ยวกับการอัปเดต Drupal ให้ตรวจสอบว่าได้เปิดใช้โมดูล Drupal Update manager แล้ว จากเมนู Drupal ให้เลือกโมดูล แล้วเลื่อนลงไปที่โมดูลเครื่องมือจัดการการอัปเดต หากไม่ได้เปิดใช้ ให้เปิดใช้
      
      เมื่อเปิดใช้แล้ว คุณจะดูการอัปเดตที่พร้อมใช้งานได้โดยใช้รายการเมนูรายงาน > การอัปเดตที่พร้อมใช้งาน
      
      ใช้รายการเมนูรายงาน > การอัปเดตที่พร้อมใช้งาน > การตั้งค่าเพื่อกำหนดค่าโมดูลให้ส่งอีเมลถึงคุณเมื่อมีการอัปเดต และเพื่อตั้งค่าความถี่ในการตรวจหาการอัปเดต
5. สำหรับการอัปเกรดในเซิร์ฟเวอร์ที่ไม่มีการเชื่อมต่ออินเทอร์เน็ต ให้ทำดังนี้
   1. ในเซิร์ฟเวอร์ที่คุณดาวน์โหลดไฟล์ DeveloperServices_x.y.z.tar ของ Developer Channel Services ไว้ ให้แตกไฟล์อัปเกรดพอร์ทัล ดังนี้
      > tar -xvf <tar file>
      
      การแตกไฟล์ด้วยคำสั่งนี้จะสร้างไดเรกทอรีใหม่ชื่อ 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. Untar ไฟล์ devportal-update.tgz ไปยังไดเรกทอรีปัจจุบัน:
      > tar -xzf /path/to/devportal-update.tgz
   6. เปลี่ยนเป็นไดเรกทอรี developer-update
   7. เรียกใช้คำสั่งต่อไปนี้เพื่อติดตั้งการอัปเดต
      > ./install-update.sh
   8. ตอบคำถาม

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