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

พอร์ทัลบริการสำหรับนักพัฒนาซอฟต์แวร์ v. 4.16.05

ทำตามขั้นตอนต่อไปนี้เพื่อติดตั้งพอร์ทัล Developer Channel Services

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

1. รับแพ็กเกจ Developer Channel Services

ไปที่ http://community.apigee.com/content/apigee-customer-support แล้วเลือก "Login to your Support Portal" เพื่อขอไฟล์ .tar ของ Developer Channel Services ด้วยวิธีใดวิธีหนึ่งต่อไปนี้

• ขอสิทธิ์เข้าถึงไดเรกทอรีดาวน์โหลด Edge for Private Cloud
• ขอ URL ไปยังไฟล์ .tar ของ Developer Channel Services

2. ตรวจสอบว่าระบบของคุณเป็นไปตามข้อกำหนดของระบบ

ก่อนติดตั้งพอร์ทัล เซิร์ฟเวอร์ของคุณต้องเป็นไปตามข้อกำหนดต่อไปนี้

1. ตรวจสอบว่าคุณกำลังติดตั้งใน Red Hat Enterprise Linux, CentOS หรือ Oracle เวอร์ชัน 64 บิตที่รองรับ ดูรายการเวอร์ชันที่รองรับได้ที่นี่
2. ตรวจสอบว่าได้ติดตั้ง Yum แล้ว
3. (สำหรับการติดตั้งบนเซิร์ฟเวอร์ที่ไม่มีการเชื่อมต่ออินเทอร์เน็ต) คุณต้องดาวน์โหลดไฟล์ที่จำเป็นทั้งหมดลงในเซิร์ฟเวอร์ที่มีการเชื่อมต่ออินเทอร์เน็ตเป็นไฟล์ .tar.gz ไฟล์เดียวก่อน จากนั้นคัดลอกไฟล์ .tar.gz นั้นไปยังเซิร์ฟเวอร์ที่ไม่มีการเชื่อมต่ออินเทอร์เน็ตเพื่อทำการติดตั้ง
   1. เข้าสู่ระบบเซิร์ฟเวอร์ที่มีการเชื่อมต่ออินเทอร์เน็ตในฐานะผู้ใช้ระดับรูทหรือผู้ใช้ระดับสูง
   2. สร้างไดเรกทอรีสำหรับไฟล์ติดตั้ง เช่น portal_tar
   3. เปลี่ยนไดเรกทอรี (CD) เป็นไดเรกทอรีใหม่และดาวน์โหลดไฟล์ Developer Channel Services DeveloperServices_x.y.z.tar โดยที่ x.y.z สอดคล้องกับหมายเลขเวอร์ชันของพอร์ทัล
   4. แตกเนื้อหาของไฟล์ .tar ของ Developer Channel Services โดยใช้คำสั่งต่อไปนี้
      > tar -xvf <tar file>
   5. เปลี่ยนไดเรกทอรีเป็น DeveloperServices-4.x.y.z
   6. สร้างไฟล์ .tar.gz ของพอร์ทัลโดยใช้คำสั่งต่อไปนี้
      > ./non-networked-install.sh
      
      คำสั่งดังกล่าวจะดาวน์โหลดไฟล์ที่จำเป็นทั้งหมดและรวมไว้ในไฟล์ .tar.gz ไฟล์เดียว จากนั้นคัดลอกไฟล์ .tar.gz นั้นไปยังเซิร์ฟเวอร์ที่ไม่มีการเชื่อมต่ออินเทอร์เน็ตเพื่อทำการติดตั้งให้เสร็จสมบูรณ์
4. ทดสอบการเชื่อมต่อกับเซิร์ฟเวอร์การจัดการ Edge โดยเรียกใช้คำสั่ง cURL ต่อไปนี้จาก Command Prompt ในเซิร์ฟเวอร์พอร์ทัล
   > curl -u {EMAIL}:{PASSWORD} https://{hostname}:8080/v1/organizations/{ORGNAME}
   
   โดยที่ EMAIL และ PASSWORD คืออีเมลและรหัสผ่านของผู้ดูแลระบบสำหรับ ORGNAME
   
   อย่าลืมระบุชื่อโฮสต์และหมายเลขพอร์ตที่เจาะจงสำหรับการติดตั้ง Edge ของคุณ พอร์ต 8080 คือพอร์ตเริ่มต้นที่ Edge ใช้ หากคุณกำลังเชื่อมต่อกับองค์กรในระบบคลาวด์ URL คำขอจะเป็นดังนี้
   https://api.enterprise.apigee.com/v1/organizations/{ORGNAME}
   
   หากสำเร็จ คำสั่งนี้จะแสดงผลการตอบกลับที่คล้ายกับตัวอย่างต่อไปนี้
   {
   "createdAt" : 1348689232699,
   "createdBy" : "USERNAME",
   "displayName" : "cg",
   "environments" : [ "test", "prod" ],
   "lastModifiedAt" : 1348689232699,
   "lastModifiedBy" : "foo@bar.com",
   "name" : "cg",
   "properties" : {
   "property" : [ ]
   },
   "type" : "trial"
   }

3. ติดตั้ง Developer Channel Services โดยใช้สคริปต์การติดตั้งอัตโนมัติ

ใช้ขั้นตอนต่อไปนี้เพื่อติดตั้งพอร์ทัลโดยใช้สคริปต์การติดตั้งอัตโนมัติ ขั้นตอนนี้ใช้ได้กับเซิร์ฟเวอร์ที่มีหรือไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก

1. เข้าสู่ระบบเซิร์ฟเวอร์ในฐานะรูทหรือผู้ใช้ระดับสูง
2. สร้างไดเรกทอรีสำหรับไฟล์ติดตั้ง เช่น portal
3. ในเซิร์ฟเวอร์ที่มีการเชื่อมต่ออินเทอร์เน็ต
   1. เปลี่ยนไดเรกทอรีไปยังไดเรกทอรี portal ใหม่ แล้วดาวน์โหลดไฟล์ DeveloperServices_x.y.z.tar ของ Developer Channel Services โดยที่ x.y.z สอดคล้องกับหมายเลขเวอร์ชันของพอร์ทัล
      
      คุณสามารถดาวน์โหลดไฟล์จากลิงก์ที่ Apigee ส่งให้คุณในเบราว์เซอร์หรือโดยการคัดลอกลิงก์ แล้วเพิ่มลงในคำสั่ง cURL ต่อไปนี้
      > curl -kOL <วางลิงก์ที่นี่>
   2. แตกเนื้อหาของไฟล์ .tar ของ Developer Channel Services โดยใช้คำสั่งต่อไปนี้
      > tar -xvf <tar file>
   3. เปลี่ยนไดเรกทอรีเป็น DeveloperServices-4.x.y.z
   4. เรียกใช้สคริปต์การติดตั้งโดยใช้คำสั่งต่อไปนี้
      > ./networked-install.sh
4. ในเซิร์ฟเวอร์ที่ไม่มีการเชื่อมต่ออินเทอร์เน็ต
   1. คัดลอกไฟล์ .tar.gz ที่คุณสร้างไว้ด้านบนในส่วนที่ 2 ตรวจสอบว่าระบบเป็นไปตามข้อกำหนดของระบบ
   2. แตกเนื้อหาของไฟล์ .tar.gz โดยใช้คำสั่งต่อไปนี้
      > tar -xvf <tar file>
   3. เปลี่ยนไดเรกทอรี (CD) เป็นไดเรกทอรีที่สร้างโดยคำสั่ง tar
   4. ตั้งค่าสิทธิ์ในสคริปต์ install-from-rpm-bundle.sh:
      > chmod 755 install-from-rpm-bundle.sh
   5. เรียกใช้สคริปต์ install-from-rpm-bundle.sh โดยใช้คำสั่งต่อไปนี้
      > ./install-from-rpm-bundle.sh
5. ตอบคำถาม
6. หลังจากติดตั้งเสร็จแล้ว ให้ไปที่ URL ของเซิร์ฟเวอร์ในเบราว์เซอร์ เช่น
   http://localhost หรือหากคุณกำหนดค่า IP หรือ DNS ที่เฉพาะเจาะจงไว้ ให้ไปที่ http://IP_address หรือ http://DNS_name
   
   ระบบจะเปลี่ยนเส้นทางคุณไปยังหน้าการกำหนดค่าฐานข้อมูลโปรไฟล์ Apigee
   
   หมายเหตุ: โดยปกติแล้ว คุณจะกำหนดค่าชื่อโฮสต์และลงทะเบียนกับเซิร์ฟเวอร์ DNS ไว้แล้ว คุณจึงไม่ต้องใช้ http://localhost
7. กำหนดค่าการเชื่อมต่อกับ MySQL หาก MySQL อยู่ในเครื่องระยะไกล ให้ขยายส่วนตัวเลือกขั้นสูง แล้วป้อนข้อมูลการเชื่อมต่อกับเครื่องนั้น จากนั้นเลือกบันทึกและต่อไป
8. กำหนดค่าการเชื่อมต่อกับปลายทาง Apigee โดยป้อนข้อมูลต่อไปนี้ แล้วเลือกบันทึก
   ดูข้อมูลเพิ่มเติมเกี่ยวกับค่าเหล่านี้ได้ที่ "ข้อมูลที่จำเป็นก่อนเริ่มการติดตั้ง" ในข้อกำหนดของพอร์ทัลบริการสำหรับนักพัฒนาซอฟต์แวร์
   1. Dev Portal Org
   2. Dev Portal Endpoint URL
   3. ผู้ใช้ที่ตรวจสอบสิทธิ์ปลายทางแล้ว
   4. รหัสผ่านของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว
9. เมื่อได้รับข้อความแจ้ง ให้เลือกปุ่มติดตั้ง WADL ของ SmartDocs ตัวอย่างเพื่อติดตั้ง WADL ของ SmartDocs ตัวอย่าง หากข้ามขั้นตอนนี้ ตัวอย่าง SmartDocs API จะไม่ปรากฏในพอร์ทัล
   หมายเหตุ: หากพอร์ทัลเชื่อมต่อกับการติดตั้ง Apigee Edge สำหรับ Private Cloud และการติดตั้ง Edge นั้นไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก คุณต้องกำหนดค่าโมดูล SmartDocs เพิ่มเติมก่อนจึงจะใช้ SmartDocs ได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับ SmartDocs ได้ที่ http://apigee.com/docs/developer-services/content/using-smartdocs-document-apis
10. กำหนดค่าการตั้งค่าเซิร์ฟเวอร์ SMTP Apigee กำหนดให้คุณต้องกำหนดค่าเซิร์ฟเวอร์ SMTP เพื่อส่งข้อความอีเมลจากพอร์ทัล
    ดูข้อมูลเพิ่มเติมได้ที่ http://apigee.com/docs/developer-services/content/configuring-email
11. กำหนดค่าผู้ใช้ที่เป็นผู้ดูแลระบบโดยป้อนข้อมูลต่อไปนี้ แล้วเลือกบันทึก โปรดทราบว่า Drupal จะสร้างผู้ใช้ที่ดูแลระบบชื่อ "admin" โดยค่าเริ่มต้น ดังนั้นอย่าใช้ "admin" เป็นชื่อผู้ใช้
    หากข้ามขั้นตอนนี้ คุณจะยังใช้ Drush เพื่อสร้างผู้ดูแลระบบได้ตามที่อธิบายไว้ในข้อ 4 ด้านล่าง สร้างผู้ใช้ที่ดูแลระบบ
    1. ชื่อและนามสกุลของนักพัฒนาแอป
    2. ชื่อผู้ใช้พอร์ทัลของนักพัฒนาแอป
    3. รหัสผ่าน
    4. อีเมล
12. หลังจากติดตั้งเสร็จแล้ว ให้ตั้งค่าสิทธิ์ในไฟล์ settings.php ดังนี้
    > chmod 640 /var/www/html/sites/default/settings.php
13. ไปที่หน้าแรกของพอร์ทัลที่ http://localhost/ หรือไปที่ชื่อ DNS ของพอร์ทัล
14. เข้าสู่ระบบพอร์ทัลโดยใช้ข้อมูลเข้าสู่ระบบของผู้ดูแลระบบ

4. สร้างผู้ใช้ที่ดูแลระบบ

ใช้ Drush เพื่อสร้างผู้ใช้ที่เป็นผู้ดูแลระบบสำหรับการติดตั้ง Developer Channel Services Drupal จะสร้างผู้ใช้ที่ดูแลระบบชื่อ "admin" โดยอัตโนมัติเป็นค่าเริ่มต้น ดังนั้นอย่าใช้ "admin" เป็นชื่อผู้ใช้

1. เปลี่ยนไดเรกทอรี (CD) เป็น drupal_root/sites/default ตำแหน่งมาตรฐานสำหรับไดเรกทอรีรากของ Drupal คือ /var/www/html:
   > cd <drupal_root>/sites/default
2. ตรวจสอบว่าคุณมีสิทธิ์เขียนในไฟล์ Drupal ส่วนตัว:
   > drush vget file_private_path
   
   คำสั่งนี้จะแสดงเส้นทางไปยังไฟล์ Drupal ส่วนตัว เช่น
   file_private_path: 'sites/default/private'
   
   ซึ่งสอดคล้องกับ /var/www/html/sites/default/private/ ใช้คำสั่งต่อไปนี้เพื่อให้แน่ใจว่าเจ้าของและกลุ่มสามารถเขียนไดเรกทอรีนี้ได้
   chmod -R g+w dirPathAndName
   chmod -R o+r dirPathAndName
3. ป้อนคำสั่งต่อไปนี้เพื่อสร้างผู้ใช้ที่ดูแลระบบ โดยแทนที่คำสั่งใน "< >" ด้วยค่าของคุณ
   > drush user-create <username> --mail="<email-address>" --password="<password>"
   > drush user-add-role Administrator <username>
4. เข้าสู่ระบบพอร์ทัลนักพัฒนาซอฟต์แวร์ในฐานะผู้ดูแลระบบโดยใช้ชื่อผู้ใช้และรหัสผ่านที่ระบุไว้ข้างต้น

5. ตั้งรหัสผ่านรูทของ MySQL

หากคุณติดตั้ง MySQL เป็นส่วนหนึ่งของการติดตั้งพอร์ทัล สคริปต์การติดตั้งจะปล่อยรหัสผ่านรูท MySQL ไว้เป็นค่าเริ่มต้น ซึ่งเป็นค่าว่าง

ใช้คำสั่งต่อไปนี้เพื่อตั้งรหัสผ่านรูท

> mysqladmin -u root password NEWPASSWORD

หากคุณเคยตั้งรหัสผ่านรูทไว้ก่อนหน้านี้และต้องการเปลี่ยน ให้ใช้คำสั่งต่อไปนี้

> mysqladmin -u root -p'OLDPASSWORD' password NEWPASSWORD

นอกจากนี้ คุณต้องอัปเดตรหัสผ่านในไฟล์ /var/www/html/sites/default/settings.php ด้วย

6. ตรวจสอบว่าเปิดใช้โมดูล Update manager แล้ว

หากต้องการรับการแจ้งเตือนเกี่ยวกับการอัปเดต Drupal ให้ตรวจสอบว่าได้เปิดใช้โมดูล Drupal Update manager แล้ว จากเมนู Drupal ให้เลือกโมดูล แล้วเลื่อนลงไปที่โมดูลเครื่องมือจัดการการอัปเดต หากไม่ได้เปิดใช้ ให้เปิดใช้

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

> drush pm-info update

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

7. ไม่บังคับ - การติดตั้งใช้งานบนเซิร์ฟเวอร์เวอร์ชันที่ใช้งานจริง

หากติดตั้งใช้งานพอร์ทัลในเซิร์ฟเวอร์เวอร์ชันที่ใช้งานจริง คุณควรทำตามขั้นตอนการรักษาความปลอดภัยเพิ่มเติม ซึ่งรวมถึงขั้นตอนต่อไปนี้

1. เรียกใช้สคริปต์ต่อไปนี้เพื่อรักษาความปลอดภัยให้กับการติดตั้ง MySQL:
   > /usr/bin/mysql_secure_installation
   
   สคริปต์นี้จะตั้งรหัสผ่านรูทและให้ตัวเลือกในการจำกัดการเข้าถึงรูทเฉพาะ localhost และนำฐานข้อมูลทดสอบและผู้ใช้ที่ไม่ระบุชื่อที่สร้างขึ้นโดยค่าเริ่มต้นออก เราขอแนะนำอย่างยิ่งให้เรียกใช้สคริปต์นี้สำหรับเซิร์ฟเวอร์ที่ใช้งานจริง
2. หากนโยบายของบริษัทกำหนดไว้ ให้เปิดใช้และกำหนดค่า SELinux

8. ไม่บังคับ - กำหนดค่าเครื่องมือค้นหา Apache Solr

โดยค่าเริ่มต้น โมดูล Drupal ที่เชื่อมต่อกับเครื่องมือค้นหา Apache Solr จะปิดใช้เมื่อคุณติดตั้งพอร์ทัล พอร์ทัลส่วนใหญ่ใช้เครื่องมือค้นหา Drupal ภายใน จึงไม่จำเป็นต้องใช้โมดูล Drupal Solr

หากตัดสินใจใช้ Solr เป็นเครื่องมือค้นหา คุณต้องติดตั้ง Solr ในเครื่องบนเซิร์ฟเวอร์ จากนั้นเปิดใช้และกำหนดค่าโมดูล Drupal Solr ในพอร์ทัล

วิธีเปิดใช้โมดูล Drupal Solr

1. เข้าสู่ระบบพอร์ทัลในฐานะผู้ใช้ที่มีสิทธิ์ของผู้ดูแลระบบหรือสิทธิ์ในการสร้างคอนเทนต์
2. เลือก Modules ในเมนู Drupal
3. เปิดใช้โมดูล Apache Solr Framework และโมดูล Apache Solr Search
4. บันทึกการเปลี่ยนแปลง
5. กำหนดค่า Solr ตามที่อธิบายไว้ที่ https://drupal.org/node/1999280

9. ไม่บังคับ - ติดตั้ง mod_ssl เพื่อรองรับ HTTPS

โมดูล mod_ssl ใช้โดยเซิร์ฟเวอร์ Apache HTTP เพื่อแสดงหน้าเว็บผ่าน HTTPS หากต้องการใช้ HTTPS ให้ใช้คำสั่งต่อไปนี้เพื่อติดตั้ง mod_ssl

> yum install mod_ssl

ดูข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดค่าพอร์ทัลเพื่อใช้ SSL ได้ที่ http://apigee.com/docs/developer-services/content/using-ssl-portal

10. ไม่บังคับ - ติดตั้ง SmartDocs

SmartDocs ช่วยให้คุณจัดทำเอกสาร API ในพอร์ทัลบริการสำหรับนักพัฒนาซอฟต์แวร์ในลักษณะที่ทำให้เอกสารประกอบ API เป็นแบบอินเทอร์แอกทีฟอย่างสมบูรณ์ อย่างไรก็ตาม หากต้องการใช้ SmartDocs กับพอร์ทัล คุณต้องติดตั้ง SmartDocs ใน Edge ก่อน

• หากคุณเชื่อมต่อพอร์ทัลกับการติดตั้ง Edge Cloud แสดงว่า SmartDocs ได้รับการติดตั้งแล้วและไม่จำเป็นต้องกำหนดค่าเพิ่มเติม
• หากคุณเชื่อมต่อพอร์ทัลกับการติดตั้ง Edge for Private Cloud คุณต้องตรวจสอบว่าได้ติดตั้ง SmartDocs ใน Edge แล้ว ดูข้อมูลเพิ่มเติมเกี่ยวกับการติดตั้ง Edge และ SmartDocs ได้ที่ติดตั้ง SmartDocs

ดูข้อมูลเพิ่มเติมเกี่ยวกับ SmartDocs ได้ที่การใช้ SmartDocs เพื่อจัดทำเอกสาร API

11. ขั้นต่อไปคืออะไร

ขั้นตอนถัดไปหลังจากติดตั้งพอร์ทัลบริการสำหรับนักพัฒนาซอฟต์แวร์คือกำหนดค่าและปรับแต่งตามข้อกำหนดเฉพาะของคุณ เอกสารประกอบในเว็บไซต์ Apigee มีข้อมูลทั้งหมดเกี่ยวกับการกำหนดค่า การจัดรูปแบบ และการจัดการพอร์ทัล เข้าถึงเอกสารประกอบได้ที่ http://apigee.com/docs/developer-services/content/what-developer-portal

ตารางต่อไปนี้แสดงงานที่พบบ่อยที่สุดบางส่วนที่คุณทำหลังจากการติดตั้ง และมีลิงก์ไปยังเอกสารประกอบของ Apigee ซึ่งคุณจะดูข้อมูลเพิ่มเติมได้