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

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. ติดตั้งบริการช่องทางขายสำหรับนักพัฒนาแอปโดยใช้สคริปต์การติดตั้งอัตโนมัติ

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

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

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

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

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

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

1. ลงชื่อเข้าใช้ระบบที่มีการเชื่อมต่ออินเทอร์เน็ตเป็นรูทหรือในฐานะผู้ใช้ระดับสูง
2. สร้างไดเรกทอรีสำหรับไฟล์ติดตั้ง เช่น portal_tar
3. ซีดีไปยังไดเรกทอรี portal_tar และดาวน์โหลดไฟล์ DeveloperServices_x.y.z.tar สำหรับช่องทางสำหรับนักพัฒนาซอฟต์แวร์ โดยที่ x.y.z ตรงกับหมายเลขเวอร์ชันของพอร์ทัล
4. แยกเนื้อหาของไฟล์ .tar ของบริการช่องทางขายสำหรับนักพัฒนาซอฟต์แวร์โดยใช้คำสั่งต่อไปนี้
   > tar -xvf <tar file>
5. ซีดีเป็น DeveloperServices-4.x.y.z
6. สร้างไฟล์พอร์ทัล .tar.gz โดยใช้คำสั่งต่อไปนี้
   > ./non-networked-install.sh

ระบบจะสร้างไฟล์ .tar.gz ใหม่สำหรับการติดตั้งที่ไม่ใช่เครือข่าย

1. เข้าสู่ระบบเซิร์ฟเวอร์ในฐานะผู้ใช้ระดับรากหรือระดับสูง
2. สร้างไดเรกทอรีสำหรับไฟล์ติดตั้ง เช่น พอร์ทัล
3. ซีดีไปยังไดเรกทอรีพอร์ทัล
4. คัดลอกไฟล์ .tar.gz ที่คุณสร้างขึ้นสำหรับการติดตั้งที่ไม่ได้เชื่อมต่อเครือข่าย (ในขั้นตอนด้านบน) ลงในไดเรกทอรีพอร์ทัล
5. แยกเนื้อหาของไฟล์ .tar.gz โดยใช้คำสั่งดังนี้
   > tar -xvf <tar file>
6. ซีดีไปยังไดเรกทอรีที่สร้างโดยคำสั่ง 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. URL ปลายทางของการจัดการ API
   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 เพื่อสร้างผู้ใช้ที่มีสิทธิ์ดูแลระบบสำหรับการติดตั้งบริการช่องทางสำหรับนักพัฒนาซอฟต์แวร์ Drupal จะสร้างผู้ใช้ที่ดูแลระบบชื่อ "admin" โดยอัตโนมัติโดยค่าเริ่มต้น ดังนั้นอย่าใช้ "ผู้ดูแลระบบ" เป็นชื่อผู้ใช้

1. ใส่ลงในไดเรกทอรี 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. ตรวจสอบว่าได้เปิดใช้โมดูลตัวจัดการการอัปเดตแล้ว

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

เมื่อเปิดใช้แล้ว คุณจะเห็นการอัปเดตที่พร้อมใช้งานโดยใช้รายการในเมนูรายงาน > การอัปเดตที่พร้อมใช้งาน นอกจากนี้คุณยังใช้คำสั่ง 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 และโมดูลการค้นหา Apache Solr
4. บันทึกการเปลี่ยนแปลง
5. กำหนดค่า Solr ตามที่อธิบายไว้ใน https://drupal.org/node/1999280

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

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

> yum install mod_ssl

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

10. ติดตั้ง Smartdocument (ไม่บังคับ)

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

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

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

11. แล้วยังไงต่อดี

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

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