ติดตั้งพอร์ทัล

Edge for Private Cloud v4.18.05

ก่อนติดตั้งพอร์ทัล Apigee Developer Services (หรือเรียกง่ายๆ ว่าพอร์ทัล) ให้ตรวจสอบว่า

1. โดยติดตั้ง Postgres ก่อนติดตั้งพอร์ทัล คุณจะติดตั้ง Postgres เป็นส่วนหนึ่งของก็ได้ ในการติดตั้ง Edge หรือติดตั้ง Postgres แบบสแตนด์อโลนสำหรับใช้โดยพอร์ทัล
   • หากติดตั้ง Postgres แบบสแตนด์อโลน แอปจะอยู่ในโหนดเดียวกันกับพอร์ทัลได้
   • หากจะเชื่อมต่อกับ Postgres ที่ติดตั้งโดยเป็นส่วนหนึ่งของ Edge และมีการกำหนดค่า Postgres แล้ว ในโหมดโฆษณาหลัก/โหมดสแตนด์บาย ให้ระบุที่อยู่ IP ของเซิร์ฟเวอร์ Postgres หลัก
2. คุณกำลังดำเนินการติดตั้ง Red Hat เวอร์ชัน 64 บิตที่รองรับ Enterprise Linux, CentOS หรือ Oracle ดูรายการเวอร์ชันที่รองรับได้ที่ ซอฟต์แวร์และเวอร์ชันที่รองรับ
3. ติดตั้ง Yum แล้ว

โปรแกรมติดตั้งจะมีเฉพาะโมดูลที่ผลิตโดย Drupal ตามข้อกำหนดของ พอร์ทัล Apigee Developer Services (หรือเรียกง่ายๆ ว่าพอร์ทัลก็ได้) โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการติดตั้งโมดูลอื่นๆ ที่ส่งมาได้ที่ การขยายการใช้งาน Drupal 7

ภาพรวมการติดตั้ง

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

1. ทดสอบการเชื่อมต่อ
2. นำ PHP เวอร์ชันก่อน 7.0 ออก
3. ติดตั้ง Postgres
4. ติดตั้งพอร์ทัล
5. ตรวจสอบว่าเปิดใช้ตัวจัดการการอัปเดตแล้ว
6. (ไม่บังคับ) กำหนดค่า Apache Solr
7. (ไม่บังคับ) ติดตั้ง SmartDocuments
8. (ไม่บังคับ) กำหนดค่า JQuery

การเลิกใช้งานพร็อพเพอร์ตี้ SMTPSSL

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

ตอนนี้คุณใช้พร็อพเพอร์ตี้ SMTP_PROTOCOL แล้ว แทนพร็อพเพอร์ตี้ SMTPSSL เพื่อตั้งค่า โปรโตคอลที่ใช้โดยเซิร์ฟเวอร์ SMTP ที่เชื่อมต่อกับพอร์ทัล ค่าที่ถูกต้องคือ "standard", "ssl" หรือ "tls"

สร้างไฟล์การกำหนดค่าพอร์ทัล

ด้านล่างนี้เป็นตัวอย่างไฟล์การกำหนดค่าที่ผู้ใช้ไม่ต้องดำเนินการสำหรับการติดตั้งพอร์ทัล แก้ไขไฟล์นี้ ตามที่จำเป็นสำหรับการกำหนดค่าของคุณ ใช้ตัวเลือก -f เพื่อ setup.sh เพื่อรวมรายการนี้

IP1=IPorDNSnameOfNode

# Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost.
HOSTIP=$(hostname -i)

# Specify the name of the portal database in Postgres.
PG_NAME=devportal

# Specify the Postgres admin credentials.
# The portal connects to Postgres by using the 'apigee' user.
# If you changed the Postgres password from the default of 'postgres'
# then set PG_PWD accordingly.
# If connecting to a Postgres node installed with Edge,
# contact the Edge sys admin to get these credentials.
PG_USER=apigee
PG_PWD=postgres

# The IP address of the Postgres server.
# If it is installed on the same node as the portal, specify that IP.
# If connecting to a remote Postgres server,specify its IP address.
PG_HOST=$IP1

# The Postgres user credentials used by the portal
# to access the Postgres database,
# This account is created if it does not already exist.
DRUPAL_PG_USER=drupaladmin
DRUPAL_PG_PASS=portalSecret

# Specify 'postgres' as the database.
DEFAULT_DB=postgres

# Specify the Drupal admin account details.
# DO NOT set DEVPORTAL_ADMIN_USERNAME=admin.
# The installer creates this user on the portal.
DEVPORTAL_ADMIN_FIRSTNAME=firstName
DEVPORTAL_ADMIN_LASTNAME=lastName
DEVPORTAL_ADMIN_USERNAME=userName
DEVPORTAL_ADMIN_PWD=PORTAL_ADMIN_PASSWORD
DEVPORTAL_ADMIN_EMAIL=foo@bar.com

# Edge connection details.
# If omitted, you can set them in the portal UI.
# Specify the Edge organization associated with the portal.
EDGE_ORG=edgeOrgName

# Specify the URL of the Edge management API.
# For a Cloud based installation of Edge, the URL is:
# https://api.enterprise.apigee.com/v1
# For a Private Cloud installation, it is in the form:
# http://ms_IP_or_DNS:8080/v1 or
# https://ms_IP_or_DNS:TLSport/v1
MGMT_URL=https://api.enterprise.apigee.com/v1

# The org admin credentials for the Edge organization in the form
# of Edge emailAddress:pword.
# The portal uses this information to connect to Edge.
DEVADMIN_USER=orgAdmin@myCorp.com
DEVADMIN_PWD=ORG_ADMIN_PASSWORD

# The PHP port.
# If omitted, it defaults to 8888.
PHP_FPM_PORT=8888

# Optionally configure the SMTP server used by the portal.
# If you do, the properties SMTPHOST and SMTPPORT are required.
# The others are optional with a default value as notated below.
# SMTP hostname. For example, for the Gmail server, use smtp.gmail.com.
SMTPHOST=smtp.gmail.com

# Set the SMTP protocol as "standard", "ssl", or "tls",
# where "standard" corresponds to HTTP.
# Note that in previous releases, this setting was controlled by the
# SMTPSSL property. That property has been deprecated.
SMTP_PROTOCOL="standard"

# SMTP port (usually 25).
# The value can be different based on the selected encryption protocol.
# For example, for Gmail, the port is 465 when using SSL and 587 for TLS.
SMTPPORT=25

# Username used for SMTP authentication, defaults is blank.
SMTPUSER=your@email.com

# Password used for SMTP authentication, default is blank.
SMTPPASSWORD=YOUR_EMAIL_PASSWORD

1. ทดสอบการเชื่อมต่อกับ Apigee Edge

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

curl -u EMAIL:PASSWORD http://ms_IP_or_DNS:8080/v1/organizations/ORGNAME

หรือ

curl -u EMAIL:PASSWORD https://ms_IP_or_DNS:TLSPort/v1/organizations/ORGNAME

โดยที่ EMAIL และ PASSWORD คืออีเมลและรหัสผ่านของ ผู้ดูแลระบบสำหรับ ORGNAME

โปรดระบุชื่อโฮสต์และหมายเลขพอร์ตเฉพาะสำหรับการติดตั้ง Edge พอร์ต 8080 คือพอร์ตเริ่มต้นที่ Edge ใช้ หากคุณกำลังเชื่อมต่อกับองค์กรในระบบคลาวด์ URL คำขอจะเป็น https://api.enterprise.apigee.com/v1/organizations/ORGNAME

หากสำเร็จ curl จะแสดงคำตอบที่คล้ายกับตัวอย่างต่อไปนี้

{
  "createdAt" : 1348689232699,
  "createdBy" : "USERNAME",
  "displayName" : "cg",
  "environments" : [ "test", "prod" ],
  "lastModifiedAt" : 1348689232699,
  "lastModifiedBy" : "foo@bar.com",
  "name" : "cg",
  "properties" : {
    "property" : [ ]
  },
  "type" : "trial"
}

2. นำ 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

นำแพ็กเกจ PHP ออกโดยใช้คำสั่งต่อไปนี้

yum remove package_name

หากไม่แน่ใจว่ามีการติดตั้ง PHP ไว้ในเซิร์ฟเวอร์หรือไม่ ให้ใช้คำสั่งต่อไปนี้

rpm -qa | grep -i php

3. ติดตั้ง Postgres

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

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

สำหรับข้อมูลเกี่ยวกับการติดตั้ง Postgres ซึ่งเป็นส่วนหนึ่งของการติดตั้ง Edge โปรดดู ติดตั้งคอมโพเนนต์ Edge ในโหนด

วิธีติดตั้ง Postgres แบบสแตนด์อโลน

1. ติดตั้งยูทิลิตี Edge apigee-setup บนโหนดโดยใช้ ที่เป็นกระบวนการบนอินเทอร์เน็ต หรือไม่ใช้อินเทอร์เน็ตก็ได้ โปรดดู ติดตั้งยูทิลิตีการตั้งค่า Edge Apigee เพื่อดูข้อมูลเพิ่มเติม
2. สร้างไฟล์การกำหนดค่า Postgres ตามตัวอย่างต่อไปนี้

   # Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost
   HOSTIP=$(hostname -i)
   
   # The pod and region of Postgres. Use the default values shown below.
   MP_POD=gateway
   REGION=dc-1
   
   # Set the Postgres password. The default value is 'postgres'.
   PG_PWD=postgres

3. ที่พรอมต์คำสั่ง ให้เรียกใช้สคริปต์การตั้งค่าเพื่อติดตั้ง Postgres:

   /opt/apigee/apigee-setup/bin/setup.sh -p pdb -f postgres_config_file

   ตัวเลือก -p pdb ระบุว่าจะติดตั้ง Postgre ไฟล์การกำหนดค่าต้อง เข้าถึงได้หรืออ่านได้โดย "Apigee" ผู้ใช้

4. ติดตั้งพอร์ทัล

ก่อนที่จะติดตั้งพอร์ทัลได้ โปรดตรวจสอบว่าคุณได้ทำสิ่งต่อไปนี้ตามที่อธิบายไว้ใน 3. ติดตั้ง Postgres

1. ติดตั้งยูทิลิตี Edge apigee-setup บนโหนดของพอร์ทัล
2. ติดตั้ง Postgres ไม่ว่าจะเป็น Postgres แบบสแตนด์อโลนหรือเป็นส่วนหนึ่งของการติดตั้ง Edge

วิธีติดตั้งพอร์ทัล

1. เรียกใช้สคริปต์ setup ที่พรอมท์คำสั่ง ดังนี้

   /opt/apigee/apigee-setup/bin/setup.sh -p dp -f configFile

   สถานที่:

   • configFile คือไฟล์การกำหนดค่าพอร์ทัลตามที่อธิบายไว้ใน สร้างไฟล์การกำหนดค่าพอร์ทัล
   • -p dp สั่งให้สคริปต์ setup ติดตั้งพอร์ทัล

หากต้องการยืนยันว่าการติดตั้งพอร์ทัลสำเร็จ ให้ทำดังนี้

1. ไปที่หน้าแรกของพอร์ทัลที่ http://localhost:8079 หรือไปที่ชื่อ DNS ของพอร์ทัล
2. เข้าสู่ระบบพอร์ทัลโดยใช้ข้อมูลเข้าสู่ระบบของผู้ดูแลระบบที่คุณตั้งค่าไว้ในพอร์ทัล ใหม่
3. เลือกรายงาน > รายงานสถานะในเมนู Drupal เพื่อให้มั่นใจว่าคุณ สามารถดูสถานะปัจจุบันของพอร์ทัลได้
4. ตรวจสอบว่าการเชื่อมต่อเซิร์ฟเวอร์การจัดการสำเร็จ หากไม่ใช่ ให้ดำเนินการดังนี้
   1. ไปที่หน้าการกำหนดค่าการเชื่อมต่อพอร์ทัล (เช่น http://portal_IP:8079/admin/config/devconnect)
   2. คลิกปุ่มทดสอบการเชื่อมต่อ หากเชื่อมต่อสำเร็จ เท่านี้ก็เรียบร้อย หากเชื่อมต่อไม่สำเร็จ ให้ดำเนินการต่อ
   3. ตรวจสอบการตั้งค่าปลายทางและการตรวจสอบสิทธิ์ดังนี้
      • URL ปลายทางของ API การจัดการ: ตรวจสอบว่าโปรโตคอล (HTTP หรือ HTTPS) ชื่อ IP หรือ DNS และหมายเลขพอร์ตถูกต้อง เช่น

        http://10.10.10.10:8080/v1

      • ผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์ปลายทาง: ผู้ดูแลระบบขององค์กร ชื่อผู้ใช้
      • รหัสผ่านของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์: หมายเลขของผู้ดูแลระบบขององค์กร รหัสผ่าน

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

      ค่าเหล่านี้ควรตรงกับ ms_IP_or_DNS, email และ password ค่าที่คุณใช้ในขั้นตอน 1: ทดสอบการเชื่อมต่อกับ Apigee Edge ชื่อผู้ใช้และรหัสผ่านควรตรงกับค่าของ USER_NAME และพร็อพเพอร์ตี้ USER_PWD รายการใน การเริ่มต้นใช้งานไฟล์การกำหนดค่า หรือ ข้อมูลเข้าสู่ระบบของผู้ใช้ที่มีบทบาทเป็นผู้ดูแลระบบองค์กร

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

5. ตรวจสอบว่าโมดูลตัวจัดการการอัปเดต เปิดใช้อยู่

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

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

drush pm-info update

คุณต้องเรียกใช้คำสั่งนี้จากไดเรกทอรีรากของเว็บไซต์ โดยค่าเริ่มต้น แอตทริบิวต์ มีการติดตั้งพอร์ทัลที่ /opt/apigee/apigee-drupal/wwwroot ดังนั้น คุณควรเปลี่ยนไดเรกทอรีเป็น /opt/apigee/apigee-drupal/wwwroot ก่อน เพื่อเรียกใช้คำสั่ง หากคุณไม่ได้ติดตั้งพอร์ทัลในไดเรกทอรีเริ่มต้น ให้เปลี่ยนเป็น ไดเรกทอรีการติดตั้ง

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

6. กำหนดค่าเครื่องมือค้นหา 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

7. ติดตั้ง SmartDocuments (ไม่บังคับ)

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

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

และต้องเปิดใช้ Smartdocs ในพอร์ทัลด้วย ดูข้อมูลเพิ่มเติมเกี่ยวกับ SmartDocuments ได้ที่ การใช้ Smartdocs เพื่อจัดทำเอกสาร API

8. กําหนดค่า โมดูลการอัปเดต JQuery สำหรับการติดตั้งที่ไม่ใช่อินเทอร์เน็ต (ไม่บังคับ)

หากคุณติดตั้งและใช้โมดูล JQuery Update ในการติดตั้งที่ไม่ใช่อินเทอร์เน็ต คุณจะต้องทำดังนี้ กำหนดค่าโมดูลให้ใช้ JQuery ในเวอร์ชันในเครื่อง หากคุณกำหนดค่าโมดูลให้ใช้ CDN สำหรับการติดตั้งที่ไม่ใช่อินเทอร์เน็ต ระบบจะพยายามเข้าถึง CDN และทำให้หน้าเว็บเกิดความล่าช้า กำลังโหลด สำหรับข้อมูลเพิ่มเติมเกี่ยวกับโมดูลการอัปเดต JQuery โปรดดู https://www.drupal.org/project/jquery_update.

หากต้องการกำหนดค่าโมดูลการอัปเดต JQuery เพื่อใช้ JQuery ในเวอร์ชันที่อยู่ในเครื่อง ให้ทำดังนี้

1. ลงชื่อเข้าสู่ระบบพอร์ทัลในฐานะผู้ใช้ที่มีสิทธิ์ระดับผู้ดูแลระบบหรือการสร้างเนื้อหา
2. เลือกการกำหนดค่า > การเขียน > อัปเดต JQuery ในเมนู Drupal
3. คลิกประสิทธิภาพในการนำทางด้านซ้าย
4. ในรายการแบบเลื่อนลง CDN ของ JQuery และ JQuery UI ให้เลือกไม่มี
5. คลิก Save Configuration

9. ขั้นตอนถัดไป

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