ติดตั้งยูทิลิตีการตั้งค่า Edge API

Edge สำหรับ Private Cloud เวอร์ชัน 4.18.01

หากต้องการติดตั้ง Edge ในโหนด คุณต้องติดตั้งยูทิลิตี Edge Apigee-setup ก่อน หากคุณอยู่ในสภาพแวดล้อมที่โหนดไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก คุณต้องติดตั้งสำเนาที่เก็บ Apigee ในเครื่องด้วย

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

Edge จะติดตั้งไฟล์ทั้งหมดในไดเรกทอรี /opt/apigee คุณจะเปลี่ยนไดเรกทอรีนี้ไม่ได้ อย่างไรก็ตาม คุณสามารถสร้างลิงก์สัญลักษณ์เพื่อจับคู่ /opt/apigee กับตำแหน่งอื่นได้หากต้องการ ดูข้อมูลเพิ่มเติมได้ที่ข้อกำหนดในการติดตั้ง

สิ่งที่ต้องทำก่อน: ปิดใช้ SELinux

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

• หากต้องการตั้งค่า SELinux เป็นโหมดอนุญาตชั่วคราว ให้ใช้คำสั่งต่อไปนี้
  1. ในระบบปฏิบัติการ Linux 6.x ให้ทำดังนี้
     sudo echo 0 > /selinux/enforce
     
     วิธีเปิดใช้ SELinux อีกครั้งหลังจากติดตั้ง Edge
     sudo echo 1 > /selinux/enforce
  2. ในระบบปฏิบัติการ Linux 7.x
     sudo setenforce 0
     
     หากต้องการเปิดใช้ SELinux อีกครั้งหลังจากติดตั้ง Edge ให้ทำดังนี้
     sudo setenforce 1
• หากต้องการปิดใช้ SELinux ถาวร หรือตั้งค่าเป็นโหมดอนุญาต ให้ทำดังนี้
  1. เปิด /etc/sysconfig/selinux ใน ตัวแก้ไข
  2. ตั้งค่า SELINUX=disabled หรือ SELINUX=permissive
  3. บันทึกการแก้ไข
  4. รีสตาร์ทโหนด
  5. หากจำเป็น ให้เปิดใช้ SELinux อีกครั้งหลังจากติดตั้ง Edge โดยทำซ้ำขั้นตอนนี้เพื่อตั้งค่า SELINUX=enabled

สิ่งที่ต้องทำก่อน: เปิดใช้ที่เก็บ EPEL

คุณต้องเปิดใช้แพ็กเกจพิเศษสำหรับ Enterprise Linux (หรือ EPEL) เพื่อติดตั้งหรืออัปเดต Edge หรือสร้างที่เก็บในเครื่อง คำสั่งที่คุณใช้ขึ้นอยู่กับเวอร์ชันของ RedHat/CentOS ดังนี้

• สำหรับ RedHat/CentOS/Oracle 7.x:?
  > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; sudo rpm -ivh epel-release-latest-7.noarch.rpm
• สำหรับ RedHat/CentOS/Oracle 6.x:
  > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; sudo rpm -ivh epel-release-latest-6.noarch.rpm

สิ่งที่ต้องทำก่อน: ตรวจสอบเวอร์ชันไลบรารี libdb4 ใน RedHat 7.4 และ CentOS 7.4

ใน RedHat 7.4 และ CentOS 7.4 ให้ตรวจสอบเวอร์ชันของ RPM libdb4 ก่อนติดตั้ง Edge ต้องใช้เวอร์ชัน 4.8 รวมถึง RedHat 7.4 และ CentOS 7.4 บางเวอร์ชันจะมาพร้อมกับเวอร์ชันที่ใหม่กว่า หากคุณใช้เวอร์ชันที่ใหม่กว่า ให้ถอนการติดตั้ง จากนั้นโปรแกรมติดตั้ง Edge จะติดตั้งเวอร์ชัน 4.8

คุณใช้คำสั่งต่อไปนี้เพื่อตรวจสอบเวอร์ชันของคุณได้

> rpm -qa | grep libdb4

หากคุณพบว่า libdb4 เวอร์ชัน RPM สูงกว่าเวอร์ชัน 4.8 ให้ถอนการติดตั้ง

ติดตั้งยูทิลิตี Edge Apigee-setup บนโหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก

วิธีติดตั้ง Edge ในโหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก

1. รับชื่อผู้ใช้และรหัสผ่านจาก Apigee ที่คุณใช้เข้าถึงที่เก็บ Apigee หากมี username:password สำหรับเว็บไซต์ Apigee FTP อยู่แล้ว คุณจะใช้ข้อมูลเข้าสู่ระบบเหล่านั้นได้
2. เข้าสู่ระบบโหนดเป็นรูทเพื่อติดตั้ง Edge RPM
   หมายเหตุ: แม้ว่าการติดตั้ง RPM จะต้องมีสิทธิ์เข้าถึงรูท แต่คุณก็ดำเนินการกำหนดค่า Edge ได้โดยไม่ต้องมีสิทธิ์เข้าถึงรูท
3. ติดตั้ง yum-utils และ yum-plugin-priorities:
   > sudo yum install yum-utils
   > sudo yum install yum-plugin-priorities
4. ปิดใช้ SELinux ตามที่อธิบายไว้ข้างต้น
5. เปิดใช้ที่เก็บ EPEL ตามที่อธิบายไว้ข้างต้น
6. ตรวจสอบเวอร์ชันของ libdb4 ตามที่อธิบายข้างต้น
7. หากจะติดตั้งใน Oracle 7.x ให้เรียกใช้คำสั่งต่อไปนี้
   > sudo yum-config-manager --enable ol7_optional_latest
8. หากคุณติดตั้งบน AWS ให้เรียกใช้คำสั่ง yum-configure-manager ต่อไปนี้
   > yumupdate rh-amazon-rhui-client.noarch
   > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
9. ดาวน์โหลดไฟล์ Edge bootstrap_4.18.01.sh ไปยัง bootstrap_4.18.01.sh:
   > curl https://software.apigee.com/Boottrap_4.18.01.sh -o /tmp/shoestrap_4.18.01.sh
10. ติดตั้ง Edge apigee-service URI และ Dependencies
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord
    
    โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่ได้รับจาก Apigee หากคุณไม่ได้ใส่ pWord ระบบจะขอให้คุณป้อนคำนั้น
    
    โดยค่าเริ่มต้น โปรแกรมติดตั้งจะตรวจสอบว่าคุณติดตั้ง Java 1.8 หรือไม่ หากคุณไม่ได้ทำ ระบบจะติดตั้งให้คุณ ใช้ตัวเลือก JAVA_FIX เพื่อระบุวิธีจัดการการติดตั้ง Java JAVA_FIX ใช้ค่าต่อไปนี้
    
    I = ติดตั้ง OpenJDK 1.8 (ค่าเริ่มต้น)
    C = ดำเนินการต่อโดยไม่ติดตั้ง Java
    Q = Quit คุณต้องติดตั้ง Java ด้วยตนเองสำหรับตัวเลือกนี้
    
    การติดตั้งยูทิลิตี Apigee-service จะสร้างไฟล์ /etc/yum.repos.d/apigee.repo ที่กำหนดที่เก็บ Apigee หากต้องการดูไฟล์คำจำกัดความ ให้ใช้คำสั่งต่อไปนี้
    > cat /etc/yum.repos.d/apigee.repo
    
    หากต้องการดูเนื้อหาของที่เก็บ ให้ใช้คำสั่งดังนี้
    > sudo yum -v repolist 'apigee*'
11. ใช้ apigee-service เพื่อติดตั้งยูทิลิตี apigee-setup
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
12. ใช้ Apigee-setup เพื่อติดตั้งและกำหนดค่าคอมโพเนนต์ Edge บนโหนด ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งคอมโพเนนต์ Edge ในโหนด

ติดตั้งยูทิลิตี Edge Apigee-setup บนโหนดที่ไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก

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

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

หมายเหตุ: Apigee ไม่ได้โฮสต์ทรัพยากร Dependency ของบุคคลที่สามทั้งหมดในที่เก็บสาธารณะของเรา คุณต้องดาวน์โหลดและติดตั้งทรัพยากร Dependency เหล่านี้จากที่เก็บที่เข้าถึงได้แบบสาธารณะ

หลังจากสร้างที่เก็บ Edge ในเครื่องแล้ว คุณอาจต้องอัปเดตที่เก็บดังกล่าวด้วยไฟล์การเผยแพร่ Edge ล่าสุดในภายหลัง ส่วนต่อไปนี้อธิบายวิธีสร้างที่เก็บในเครื่องและวิธีอัปเดตที่เก็บ

สร้างที่เก็บ Apigee ในเครื่อง

วิธีสร้างที่เก็บ Apigee ในเครื่อง

1. รับชื่อผู้ใช้และรหัสผ่านจาก Apigee ที่คุณใช้เข้าถึงที่เก็บ Apigee หากมี username:password สำหรับเว็บไซต์ Apigee FTP อยู่แล้ว คุณจะใช้ข้อมูลเข้าสู่ระบบเหล่านั้นได้
2. เข้าสู่ระบบโหนดในฐานะรูทเพื่อติดตั้ง Edge RPM
   หมายเหตุ: แม้ว่าการติดตั้ง RPM จะต้องมีสิทธิ์เข้าถึงรูท แต่คุณก็กำหนดค่า Edge ได้โดยไม่ต้องมีสิทธิ์เข้าถึงรูท
3. ปิดใช้ SELinux ตามที่อธิบายไว้ข้างต้น
4. ดาวน์โหลดไฟล์ Edge bootstrap_4.18.01.sh ไปยัง bootstrap_4.18.01.sh:
   > curl https://software.apigee.com/Boottrap_4.18.01.sh -o /tmp/shoestrap_4.18.01.sh
5. ติดตั้ง Edge apigee-serviceยูทิลิตีและ Dependencies:
   > sudo bash /tmp/Boottrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord
   
   โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่ได้รับจาก Apigee หากคุณไม่ได้ใส่ pWord ระบบจะขอให้คุณป้อนคำนั้น
6. ติดตั้งยูทิลิตี apigee-mirror ในโหนดดังนี้
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
   
   หมายเหตุ: หากกำลังอัปเดต repo ที่มีอยู่เป็น 4.18.01 คุณต้องอัปเดตเพียง apigee-mirror:
   > api/api/apigeeแต่ละข้อ
7. ใช้ยูทิลิตี apigee-mirror เพื่อซิงค์ที่เก็บ Apigee กับไดเรกทอรี /opt/apigee/data/apigee-mirror/repos/
   
   หากต้องการลดขนาดของที่เก็บ ให้ใส่ --only-new-rpms เพื่อดาวน์โหลดเฉพาะ RPM ล่าสุด คุณต้องมีพื้นที่ดิสก์ประมาณ 1.6 GB สําหรับการดาวน์โหลด
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror Sync --only-new-rpms
   
   หากต้องการดาวน์โหลดที่เก็บข้อมูลทั้งหมด รวมถึง RPM เก่าๆ ให้ยกเว้น --only-new-rpms คุณต้องมีพื้นที่ว่างประมาณ 6 GB สําหรับการดาวน์โหลดแบบเต็ม
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror Sync
   
   ตอนนี้คุณมีสำเนาที่เก็บ Apigee ในเครื่องแล้ว หัวข้อถัดไปอธิบายวิธีติดตั้งยูทิลิตี Edge apigee-setup จากที่เก็บในเครื่อง
8. (ไม่บังคับ) หากต้องการติดตั้ง Edge จากที่เก็บในเครื่องลงในโหนดเดียวกันที่โฮสต์ที่เก็บในเครื่อง คุณจะต้องเรียกใช้คำสั่งต่อไปนี้ก่อน
   1. เรียกใช้ bootstrap_4.18.01.sh จากทรัพยากรภายในเพื่อติดตั้งยูทิลิตี bootstrap_4.18.01.sh:
      > sudo bash /opt/apigee/data/apigee-mirror/repos/Boottrap_4.18.01.sh apigeeprotocol="file://" apigeerepogeedata/apigeeprotocol="file://" apigeerepogeedata Protocol/opt/apigeeth
   2. ใช้ apigee-service เพื่อ ติดตั้งยูทิลิตี apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
   3. ใช้ apigee-setup เพื่อติดตั้งและกำหนดค่าคอมโพเนนต์ Edge บนโหนด ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งคอมโพเนนต์ Edge ในโหนด

ติดตั้ง Apigee-setup บนโหนดระยะไกลจากที่เก็บในเครื่อง

คุณมี 2 ตัวเลือกในการติดตั้ง Edge จากที่เก็บในเครื่อง เลือกดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้

• สร้างไฟล์ .tar ของที่เก็บ คัดลอกไฟล์ .tar ไปยังโหนด จากนั้นติดตั้ง Edge จากไฟล์ .tar
• ติดตั้งเว็บเซิร์ฟเวอร์บนโหนดที่มีที่เก็บในเครื่องเพื่อให้โหนดอื่นๆ เข้าถึงได้ Apigee มีเว็บเซิร์ฟเวอร์ Nginx ให้คุณใช้ หรือจะใช้เว็บเซิร์ฟเวอร์ของคุณเองก็ได้

ติดตั้งจากไฟล์ .tar:

1. บนโหนดที่มีที่เก็บในเครื่อง ให้ใช้คำสั่งต่อไปนี้เพื่อแพ็กเกจที่เก็บในเครื่องลงในไฟล์ .tar เดี่ยวที่ชื่อ /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
2. คัดลอกไฟล์ .tar ไปยังโหนดที่ต้องการติดตั้ง Edge เช่น คัดลอกไปยังไดเรกทอรี /tmp ในโหนดใหม่
3. ในโหนดใหม่ ให้ปิดใช้ SELinux ตามที่อธิบายข้างต้น
4. ในโหนดใหม่ ให้เปิดใช้ที่เก็บ EPEL ตามที่อธิบายข้างต้น
5. ในโหนดใหม่ ให้ตรวจสอบว่าคุณได้ปิดใช้ที่เก็บอินเทอร์เน็ตภายนอกแล้ว เมื่อคุณเรียกใช้คำสั่งต่อไปนี้ ที่เก็บภายนอกทั้งหมดควรแสดงเป็นปิดใช้ แต่ควรเปิดใช้ที่เก็บ Apigee ในเครื่องและที่เก็บภายในทั้งหมดไว้:
   > sudo yum repolist
6. ในโหนดใหม่ ให้ติดตั้ง yum-utils และ yum-plugin-priorities
   > sudo yum install yum-utils
   > sudo yum install yum-plugin-priorities
7. ตรวจสอบเวอร์ชันของ libdb4 ในโหนดใหม่ตามที่อธิบายข้างต้น
8. หากคุณติดตั้งบน Oracle 7.x ให้เรียกใช้คำสั่งต่อไปนี้
   > sudo yum-config-manager --enable ol7_optional_latest
9. หากคุณติดตั้งบน AWS ให้เรียกใช้คำสั่ง yum-configure-manager ต่อไปนี้
   > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
10. ในโหนดใหม่ ให้ยกเลิกไฟล์ไปยังไดเรกทอรี /tmp ดังนี้
    > tar -xzf apigee-4.18.01.tar.gz
    
    คำสั่งนี้จะสร้างไดเรกทอรีใหม่ชื่อ repos ในไดเรกทอรีที่มีไฟล์ .tar เช่น /tmp/repos
11. ติดตั้งเครื่องมือยูทิลิตี้ Edge apigee-service และ Dependencies จาก /tmp/repos:
    > sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
    
    แจ้งให้ทราบว่าคุณใส่เส้นทางไปยังไดเรกทอรีคำสั่ง repos นี้แล้ว
12. ใช้ apigee-service เพื่อ ติดตั้งยูทิลิตี apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
13. ใช้ apigee-setup เพื่อติดตั้งและกำหนดค่าคอมโพเนนต์ Edge บนโหนด ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งคอมโพเนนต์ Edge ในโหนด

ติดตั้งจากที่เก็บโดยใช้เว็บเซิร์ฟเวอร์ Nginx ดังนี้

1. ติดตั้งเว็บเซิร์ฟเวอร์ Nginx บนโหนด Repo:
   > opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
2. โดยค่าเริ่มต้น Nginx จะได้รับการกำหนดค่าให้ใช้ localhost เป็นชื่อเซิร์ฟเวอร์และพอร์ต 3939 วิธีเปลี่ยนค่าเหล่านี้
   1. เปิด /opt/apigee/customer/application/mirror.properties ในตัวแก้ไข ให้สร้างไฟล์หากยังไม่มี
   2. กำหนดค่าต่อไปนี้ตามความจำเป็น
      conf_apigee_mirror_listen_port=3939
      conf_apigee_mirror_server_name=localhost
   3. รีสตาร์ท Nginx:
      ?> /opt/nginx/scripts/apigee-nginxเกี่ยวกับการรีสตาร์ท
3. โดยค่าเริ่มต้น ที่เก็บกำหนดให้ต้องมี username:password ของ admin:admin หากต้องการเปลี่ยนข้อมูลเข้าสู่ระบบเหล่านี้ ให้ตั้งค่าตัวแปรสภาพแวดล้อมต่อไปนี้
   MIRROR_USERNAME=uName
   MIRROR_PASSWORD=pWord
4. ในโหนดใหม่ ให้ติดตั้ง yum-utils และ yum-plugin-priorities
   > sudo yum install yum-utils
   > sudo yum install yum-plugin-priorities
5. ในโหนดใหม่ ให้ปิดใช้ SELinux ตามที่อธิบายข้างต้น
6. ในโหนดใหม่ ให้เปิดใช้ที่เก็บ EPEL ตามที่อธิบายข้างต้น
7. ตรวจสอบเวอร์ชันของ libdb4 ในโหนดใหม่ตามที่อธิบายข้างต้น
8. ในโหนดระยะไกล ให้ดาวน์โหลดไฟล์ Edge bottrap_4.18.01.sh เป็น /tmp/bootstrap_4.18.01.sh:
   > /usr/bin/curl http://uName:pWord@remoteRepo:3939/shoestrap_18.18
   
   
9. ในโหนดระยะไกล ให้ติดตั้งยูทิลิตี้ Edge apigee-service U และ Dependencies:
   > sudo bash /tmp/Boottrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigee password=http://protocol=pWord apigee password
   
   
10. ในโหนดระยะไกล ให้ใช้ apigee-service เพื่อติดตั้งยูทิลิตี apigee-setup ดังนี้
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
11. ใช้ apigee-setup เพื่อติดตั้งและกำหนดค่าคอมโพเนนต์ Edge บนโหนดระยะไกล ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งคอมโพเนนต์ Edge ในโหนด

> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean