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

พอร์ทัลบริการสำหรับนักพัฒนาแอปเวอร์ชัน 4.16.09

โปรดตรวจสอบสิ่งต่อไปนี้ก่อนติดตั้ง

• คุณกำลังติดตั้งใน Red Hat Enterprise Linux, CentOS หรือ Oracle เวอร์ชัน 64 บิตที่รองรับ ดูรายการเวอร์ชันที่รองรับได้ที่นี่
• ติดตั้ง Yum แล้ว
• คุณสำรองข้อมูลการติดตั้งที่มีอยู่ หากคุณได้แก้ไขโค้ดใดๆ ใน Drupal Core หรือในโมดูลที่ไม่ใช่โมดูลที่กำหนดเอง ระบบจะเขียนทับการแก้ไขของคุณ ซึ่งรวมถึงการเปลี่ยนแปลงที่คุณอาจทำกับ .htaccess และอื่นๆ คุณควรสันนิษฐานว่าทุกอย่างที่อยู่นอกไดเรกทอรี /sites เป็นของ Drupal ข้อยกเว้นของกฎนี้คือ robots.txt หากไฟล์นี้อยู่ในรูทของเว็บ ระบบจะเก็บไฟล์นี้ไว้ให้คุณ ก่อนดำเนินการติดตั้ง ให้สำรองข้อมูลไดเรกทอรีรากของเว็บ Drupal ทั้งหมด ตำแหน่งการติดตั้งเริ่มต้นคือ /var/www/html แต่คุณอาจเปลี่ยนตำแหน่งนี้ได้ในเวลาติดตั้ง หลังจากทำตามขั้นตอนการติดตั้งที่อธิบายไว้ด้านล่างแล้ว คุณจะกู้คืนการปรับแต่งจากข้อมูลสำรองได้

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

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. ทดสอบการเชื่อมต่อกับ Apigee Edge

ทดสอบการเชื่อมต่อกับเซิร์ฟเวอร์การจัดการ 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. นำ PHP เวอร์ชันก่อน 7.0 ออก

สคริปต์การติดตั้งจะตรวจสอบ PHP เวอร์ชันก่อน 7.0 ในระบบก่อนเริ่มการติดตั้ง หากมี PHP เวอร์ชันก่อน 7.0 ข้อความเตือนต่อไปนี้จะปรากฏขึ้น

The following packages present on your system conflict with software we are
about to install. You will need to manually remove each one, then re-run this install script.
php
php-cli
php-common
php-gd
php-mbstring
php-mysql
php-pdo
php-pear
php-pecl-apc
php-process
php-xml

สำหรับ CentOS และ Red Hat Enterprise Linux (RHEL) ให้นำแพ็กเกจ PHP ออกโดยใช้คำสั่งต่อไปนี้

yum remove <package-name>

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

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

ในเซิร์ฟเวอร์ที่มีการเชื่อมต่ออินเทอร์เน็ต ให้ทำดังนี้

วิธีติดตั้ง Developer Channel Services ในเซิร์ฟเวอร์ที่มีการเชื่อมต่ออินเทอร์เน็ต

1. เข้าสู่ระบบเซิร์ฟเวอร์ในฐานะรูทหรือผู้ใช้ระดับสูง
2. สร้างไดเรกทอรีสำหรับไฟล์ติดตั้ง เช่น portal
3. เปลี่ยนไดเรกทอรี (CD) เป็นไดเรกทอรี portal ใหม่ แล้วดาวน์โหลดไฟล์ DeveloperServices_x.y.z.tar ของ Developer Channel Services โดยที่ x.y.z สอดคล้องกับหมายเลขเวอร์ชันของพอร์ทัล
   
   คุณสามารถดาวน์โหลดไฟล์จากลิงก์ที่ Apigee ส่งให้คุณในเบราว์เซอร์ หรือโดยการคัดลอกลิงก์แล้วเพิ่มลงในคำสั่ง cURL ต่อไปนี้
   > curl -kOL <วางลิงก์ที่นี่>
4. แตกเนื้อหาของไฟล์ .tar ของ Developer Channel Services โดยใช้คำสั่งต่อไปนี้
   > tar -xvf <tar file>
5. เปลี่ยนไดเรกทอรีเป็น DeveloperServices-4.x.y.z
6. เรียกใช้สคริปต์การติดตั้งโดยใช้คำสั่งต่อไปนี้
   > ./networked-install.sh
7. ตอบกลับข้อความแจ้ง

ในเซิร์ฟเวอร์ที่ไม่มีการเชื่อมต่ออินเทอร์เน็ต ให้ทำดังนี้

ก่อนอื่น ให้สร้างสคริปต์การติดตั้งแบบไม่มีเครือข่ายในระบบที่มีการเชื่อมต่ออินเทอร์เน็ต โดยทำดังนี้

1. เข้าสู่ระบบที่มีการเชื่อมต่ออินเทอร์เน็ตในฐานะผู้ใช้ระดับรูทหรือผู้ใช้ระดับสูง
2. สร้างไดเรกทอรีสำหรับไฟล์ติดตั้ง เช่น portal_tar
3. เปลี่ยนไดเรกทอรี (CD) เป็นไดเรกทอรี portal_tar แล้วดาวน์โหลดไฟล์ DeveloperServices_x.y.z.tar ของ Developer Channel Services โดยที่ 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 ใหม่สำหรับการติดตั้งแบบไม่ใช้เครือข่าย

1. เข้าสู่ระบบเซิร์ฟเวอร์ในฐานะรูทหรือผู้ใช้ระดับสูง
2. สร้างไดเรกทอรีสำหรับไฟล์ติดตั้ง เช่น portal
3. เปลี่ยนไดเรกทอรี (CD) ไปยังไดเรกทอรี portal
4. คัดลอกไฟล์ .tar.gz ที่คุณสร้างขึ้นสำหรับการติดตั้งแบบไม่มีเครือข่าย (ในขั้นตอนข้างต้น) ไปยังไดเรกทอรี portal
5. แตกเนื้อหาของไฟล์ .tar.gz โดยใช้คำสั่งต่อไปนี้
   > tar -xvf <tar file>
6. เปลี่ยนไดเรกทอรี (CD) เป็นไดเรกทอรีที่สร้างโดยคำสั่ง tar
7. ตั้งค่าสิทธิ์ในสคริปต์ install-from-rpm-bundle.sh:
   > chmod 755 install-from-rpm-bundle.sh
8. เรียกใช้สคริปต์ install-from-rpm-bundle.sh โดยใช้คำสั่งต่อไปนี้
   > ./install-from-rpm-bundle.sh
9. ตอบกลับข้อความแจ้ง

5. กำหนดค่าพอร์ทัลนักพัฒนาซอฟต์แวร์

การกำหนดค่าพอร์ทัลส่วนใหญ่จะดำเนินการโดยไม่ต้องมีการโต้ตอบจากคุณ เช่น การติดตั้งโมดูล Drupal และการสร้างคอนเทนต์เริ่มต้น ระบบจะแจ้งให้คุณตั้งค่าฐานข้อมูล กำหนดค่าปลายทาง Edge และสร้างผู้ใช้ที่ดูแลระบบใหม่

วิธีกำหนดค่าพอร์ทัลนักพัฒนาซอฟต์แวร์

1. ไปที่ URL ของเซิร์ฟเวอร์ในเบราว์เซอร์ เช่น
   http://localhost หรือหากคุณกำหนดค่า IP หรือ DNS ที่เฉพาะเจาะจงไว้ ให้ไปที่ http://IP_address หรือ http://DNS_name
   
   ระบบจะเปลี่ยนเส้นทางคุณไปยังหน้าการกำหนดค่าฐานข้อมูลโปรไฟล์ Apigee
   
   หมายเหตุ: โดยปกติแล้ว คุณจะกำหนดค่าชื่อโฮสต์และลงทะเบียนกับเซิร์ฟเวอร์ DNS ไว้แล้ว คุณจึงไม่ต้องใช้ http://localhost
2. กำหนดค่าการเชื่อมต่อกับฐานข้อมูล หากฐานข้อมูลอยู่ในเครื่องระยะไกล ให้ขยายส่วนตัวเลือกขั้นสูง แล้วป้อนข้อมูลการเชื่อมต่อกับเครื่องนั้น จากนั้นเลือกบันทึกและต่อไป
3. กำหนดค่าการเชื่อมต่อกับปลายทาง Apigee โดยป้อนข้อมูลต่อไปนี้ แล้วเลือกบันทึก
   ดูข้อมูลเพิ่มเติมเกี่ยวกับค่าเหล่านี้ได้ที่หัวข้อ "ข้อมูลที่จำเป็นก่อนเริ่มการติดตั้ง" ในข้อกำหนดของพอร์ทัลบริการสำหรับนักพัฒนาซอฟต์แวร์
   1. องค์กร Management API
   2. Management API Endpoint URL
   3. ผู้ใช้ที่ตรวจสอบสิทธิ์ปลายทางแล้ว
   4. รหัสผ่านของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว
4. กำหนดค่าผู้ใช้ที่เป็นผู้ดูแลระบบโดยป้อนข้อมูลต่อไปนี้ แล้วเลือกบันทึก โปรดทราบว่า Drupal จะสร้างผู้ใช้ที่ดูแลระบบชื่อ "admin" โดยค่าเริ่มต้น ดังนั้นอย่าใช้ "admin" เป็นชื่อผู้ใช้
   หากข้ามขั้นตอนนี้ คุณจะยังใช้ Drush เพื่อสร้างผู้ดูแลระบบได้ตามที่อธิบายไว้ในข้อ 4 ด้านล่าง สร้างผู้ใช้ที่ดูแลระบบ
   1. ชื่อและนามสกุลของนักพัฒนาแอป
   2. ชื่อผู้ใช้พอร์ทัลของนักพัฒนาแอป
   3. รหัสผ่าน
   4. อีเมล
5. หลังจากติดตั้งเสร็จแล้ว ให้ตั้งค่าสิทธิ์ในไฟล์ settings.php ดังนี้
   > chmod 640 /var/www/html/sites/default/settings.php
6. ไปที่หน้าแรกของพอร์ทัลที่ http://localhost/ หรือไปที่ชื่อ DNS ของพอร์ทัล
7. เข้าสู่ระบบพอร์ทัลโดยใช้ข้อมูลเข้าสู่ระบบของผู้ดูแลระบบ

6. สร้างผู้ใช้ที่ดูแลระบบ (ไม่บังคับ)

ใช้ 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 ซึ่งคุณจะดูข้อมูลเพิ่มเติมได้