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

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

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

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

ข้อกําหนดเบื้องต้น: ปิดใช้ SELinux

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

วิธีปิดใช้ SELinux อย่างถาวรหรือตั้งค่าเป็นโหมดอนุญาต

1. เปิด /etc/sysconfig/selinux ในเครื่องมือแก้ไข
2. ตั้งค่า SELINUX=disabled หรือ SELINUX=permissive
3. บันทึกการแก้ไข
4. รีสตาร์ทโหนด
5. หากจำเป็น ให้เปิดใช้ SELinux อีกครั้งหลังจากติดตั้ง Edge โดยทำตามขั้นตอนนี้ซ้ำเพื่อตั้งค่า SELINUX=enabled

ข้อกําหนดเบื้องต้น: เปิดใช้ที่เก็บ EPEL

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

• สำหรับ Red Hat/CentOS/Oracle 8.x ให้ทำดังนี้

  wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
  sudo rpm -ivh epel-release-latest-8.noarch.rpm

• สำหรับ Red Hat/CentOS/Oracle 9.x ให้ทำดังนี้

  wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
  sudo rpm -ivh epel-release-latest-9.noarch.rpm

ข้อกำหนดเบื้องต้นสำหรับ RHEL 8/Rocky 8/Oracle 8

หากติดตั้ง Edge ในเซิร์ฟเวอร์ที่ใช้ Red Hat Enterprise Linux (RHEL) 8 ให้ทำตามขั้นตอนต่อไปนี้ก่อนการติดตั้ง

1. เปิดใช้แพ็กเกจเพิ่มเติมสำหรับ Enterprise Linux (EPEL)

   sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm

2. ปิดใช้ Postgres และ Nginx

   sudo dnf module disable postgresql
   sudo dnf module disable nginx

ข้อกําหนดเบื้องต้นสําหรับ RHEL 9/Rocky 9/Oracle 9

หากคุณติดตั้ง Edge บนเซิร์ฟเวอร์ที่ใช้ Red Hat Enterprise Linux (RHEL) 9, Rocky 9 หรือ Oracle 9 ให้ทำตามขั้นตอนต่อไปนี้ก่อนติดตั้ง

1. เปิดใช้แพ็กเกจพิเศษสำหรับ Enterprise Linux (EPEL)

   sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm

2. ปิดใช้งาน Postgres และ Nginx:

   sudo dnf module disable postgresql
   sudo dnf module disable nginx

ดูการเปลี่ยนแปลงก่อนการติดตั้งสําหรับ PostgreSQL และ LDAP ได้ที่ข้อกําหนดก่อนการติดตั้งฐานข้อมูล PostgreSQL และการเปลี่ยนแปลงก่อนการติดตั้ง OpenLDAP 2.4 ตามลําดับ

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

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

1. รับชื่อผู้ใช้และรหัสผ่านจาก Apigee ที่คุณใช้เข้าถึงที่เก็บ Apigee หากมี username:password สำหรับเว็บไซต์ ftp ของ Apigee อยู่แล้ว คุณจะใช้ข้อมูลเข้าสู่ระบบเหล่านั้นได้
2. เข้าสู่ระบบโหนดในฐานะรูทเพื่อติดตั้ง RPM ของ Edge
   
3. ปิดใช้ SELinux
4. เปิดใช้ที่เก็บ EPEL
5. หากติดตั้งใน RHEL 9/Rocky 9/Oracle 9 ให้ทำตามขั้นตอนในข้อกําหนดเบื้องต้นสําหรับ RHEL 9/Rocky 9/Oracle 9
6. ดาวน์โหลดไฟล์ bootstrap_4.53.00.sh ของ Edge ไปยัง /tmp/bootstrap_4.53.00.sh

   curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh

7. ติดตั้งยูทิลิตีและบริการ Dependency ของ Edge Apigee ดังนี้

   sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord

   โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณได้รับจาก Apigee หากไม่ใส่ pWord ระบบจะแจ้งให้คุณป้อน

   โดยค่าเริ่มต้น โปรแกรมติดตั้งจะตรวจสอบว่าคุณติดตั้ง Java 1.8 แล้ว หากไม่ได้ติดตั้งไว้ ระบบจะติดตั้งให้คุณ ใช้ตัวเลือก JAVA_FIX เพื่อระบุวิธีจัดการการติดตั้ง Java JAVA_FIX ใช้ค่าต่อไปนี้

   • I: ติดตั้ง OpenJDK 1.8 (ค่าเริ่มต้น)
   • ค: ดำเนินการต่อโดยไม่ติดตั้ง Java
   • ถาม: ออก สำหรับตัวเลือกนี้ คุณต้องติดตั้ง Java ด้วยตนเอง

   การติดตั้งยูทิลิตี apigee-service จะสร้างไฟล์ /etc/yum.repos.d/apigee.repo ที่กําหนดที่เก็บ Apigee หากต้องการดูไฟล์คําจํากัดความ ให้ใช้คําสั่งต่อไปนี้

   cat /etc/yum.repos.d/apigee.repo

   หากต้องการดูเนื้อหาของรีโป ให้ใช้คำสั่งต่อไปนี้

   sudo yum -v repolist 'apigee*'

8. ใช้ apigee-service เพื่อติดตั้งยูทิลิตีการตั้งค่า Apigee:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

9. ใช้ apigee-setup เพื่อติดตั้งและกําหนดค่าคอมโพเนนต์ Edge ในโหนด โปรดดูข้อมูลเพิ่มเติมที่หัวข้อติดตั้งคอมโพเนนต์ Edge ในโหนด

การแก้ปัญหา

เมื่อพยายามติดตั้งในโหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก คุณอาจพบข้อผิดพลาดต่อไปนี้อย่างน้อย 1 รายการ

Cannot open: https://username@software.apigee.com/apigee-repo-4.53.00.rpm

bootstrap.sh: Error: Repo configuration failed

error: package package_name is not installed

ตารางต่อไปนี้แสดงวิธีแก้ปัญหาที่เป็นไปได้สำหรับข้อผิดพลาดเหล่านี้

ประเภทข้อผิดพลาด	วิธีแก้ปัญหาที่เป็นไปได้
รหัสผ่านมีอักขระที่ไม่ถูกต้อง	อย่าใช้สัญลักษณ์พิเศษในรหัสผ่าน Apigee
ปัญหาเกี่ยวกับการเชื่อมต่อ	ทดสอบการเชื่อมต่อเครือข่ายโดยเรียกใช้ncat คําสั่งต่อไปนี้ nc -v software.apigee.com 443 คุณควรได้รับข้อความที่คล้ายกับข้อความต่อไปนี้ Connection to software.apigee.com 443 port [tcp/https] succeeded! หากยังไม่ได้ติดตั้ง nc คุณเรียกใช้คำสั่ง telnet ต่อไปนี้ได้ telnet software.apigee.com 443 หากคำสั่งทำงานสำเร็จ คุณสามารถใช้แป้น CTRL+C เพื่อยกเลิกการเชื่อมต่อที่เปิดอยู่ หากใช้คำสั่งใดคำสั่งหนึ่งไม่สำเร็จ แสดงว่าคุณมีการเชื่อมต่อเครือข่ายที่จำกัดหรือไม่มีการเชื่อมต่อ โปรดตรวจสอบกับผู้ดูแลเครือข่าย
ข้อมูลเข้าสู่ระบบไม่ถูกต้อง	ตรวจสอบว่าชื่อผู้ใช้และรหัสผ่านถูกต้อง เช่น ตรวจสอบว่าคุณได้รับข้อผิดพลาดหรือไม่เมื่อพยายามใช้คําสั่งต่อไปนี้กับชื่อผู้ใช้และรหัสผ่าน Apigee curl -i -u username:password https://software.apigee.com/apigee-repo.rpm
ปัญหาเกี่ยวกับพร็อกซี	การกําหนดค่าในเครื่องของคุณใช้พร็อกซี HTTP ขาออก และคุณยังไม่ได้ขยายการกําหนดค่าเดียวกันไปยังyumตัวจัดการแพ็กเกจ ตรวจสอบตัวแปรสภาพแวดล้อม echo $http_proxy echo $https_proxy สําหรับพร็อกซี HTTP ขาออก คุณควรใช้ตัวเลือกใดตัวเลือกหนึ่งต่อไปนี้ เพิ่มการกำหนดค่าพร็อกซี HTTP ใน /etc/yum.conf เพิ่มการกำหนดค่าพร็อกซี HTTP ทั่วโลกใน /etc/environment

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

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

ขั้นตอนการติดตั้ง Apigee Edge สำหรับโหนดที่ไม่มีการเชื่อมต่ออินเทอร์เน็ตต้องมีสิทธิ์เข้าถึงที่เก็บในเครื่องต่อไปนี้

• ที่เก็บ Apigee Edge: ตามที่อธิบายไว้ในสร้างที่เก็บ Apigee ในเครื่อง
• แพ็กเกจพิเศษสำหรับ Enterprise Linux (หรือ EPEL): ทีมปฏิบัติการควรตั้งค่าให้คุณได้

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

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

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

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

1. ขอชื่อผู้ใช้และรหัสผ่านจาก Apigee ที่คุณใช้เข้าถึงที่เก็บ Apigee หากมีชื่อผู้ใช้:รหัสผ่านของเว็บไซต์ Apigee ftp อยู่แล้ว คุณจะใช้ข้อมูลเข้าสู่ระบบเหล่านั้นได้
2. เข้าสู่ระบบโหนดในฐานะรูทเพื่อติดตั้ง RPM ของ Edge
   
3. ปิดใช้ SELinux ตามที่อธิบายไว้ด้านบน
4. ดาวน์โหลดไฟล์ bootstrap_4.53.00.sh ของ Edge ไปยัง /tmp/bootstrap_4.53.00.sh

   curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh

5. ติดตั้งยูทิลิตี apigee-service และรายการที่ต้องพึ่งพาของ Edge:
   

   sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord

   โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณได้รับจาก Apigee หากไม่ใส่ pWord ระบบจะแจ้งให้คุณป้อน

6. ติดตั้งยูทิลิตี apigee-mirror ในโหนด โดยทำดังนี้

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install

7. ใช้ยูทิลิตี apigee-mirror เพื่อซิงค์ที่เก็บ Apigee กับไดเรกทอรี /opt/apigee/data/apigee-mirror/repos/

   หากต้องการลดขนาดของรีโป ให้ใส่ --only-new-rpms เพื่อดาวน์โหลดเฉพาะ RPM เวอร์ชันล่าสุด

8. (ไม่บังคับ) หากต้องการติดตั้ง Edge จากที่เก็บข้อมูลในเครื่องไปยังโหนดเดียวกันกับที่โฮสต์ที่เก็บข้อมูลในเครื่อง คุณจะต้องเรียกใช้คำสั่งต่อไปนี้ก่อน
   1. เรียกใช้ bootstrap_4.53.00.sh จากที่เก็บในเครื่องเพื่อติดตั้งยูทิลิตี apigee-service ดังนี้

      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.53.00.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos

   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

วิธีติดตั้งจากไฟล์ .tar

1. ในโหนดที่มีที่เก็บข้อมูลในเครื่อง ให้ใช้คำสั่งต่อไปนี้เพื่อจัดแพ็กเกจที่เก็บข้อมูลในเครื่องเป็นไฟล์ .tar ไฟล์เดียวชื่อ /opt/apigee/data/apigee-mirror/apigee-4.53.00.tar.gz

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

2. คัดลอกไฟล์ .tar ไปยังโหนดที่ต้องการติดตั้ง Edge เช่น คัดลอกไปยังไดเรกทอรี /tmp ในโหนดใหม่
3. ในโหนดใหม่ ให้ปิดใช้ SELinux ตามที่อธิบายไว้ข้างต้น
4. ในโหนดใหม่ ให้ตรวจสอบว่าคุณเข้าถึงที่เก็บยูทิลิตี Yum ในพื้นที่และที่เก็บ EPEL ได้
5. ตรวจสอบอีกครั้งว่าปิดใช้ที่เก็บข้อมูลภายนอกทั้งหมดในอินเทอร์เน็ตแล้ว (ซึ่งควรจะเป็นเช่นนั้นเนื่องจากคุณติดตั้งในเครื่องที่ไม่มีอินเทอร์เน็ต)

   sudo yum repolist

   คุณควรปิดใช้ที่เก็บข้อมูลภายนอกทั้งหมด แต่ควรเปิดใช้ที่เก็บข้อมูล Apigee ในพื้นที่และที่เก็บข้อมูลภายใน

6. ใช้ apigee-service เพื่อติดตั้งยูทิลิตี apigee-setup โดยทำดังนี้

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

7. ใช้ apigee-setup เพื่อติดตั้งและกำหนดค่าคอมโพเนนต์ Edge ในโหนด ดูข้อมูลเพิ่มเติมที่หัวข้อติดตั้งคอมโพเนนต์ Edge ในโหนด

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

วิธีติดตั้งจากที่เก็บโดยใช้เว็บเซิร์ฟเวอร์ 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 restart

3. โดยค่าเริ่มต้น รีโปจะกำหนดให้ใช้ชื่อผู้ใช้:รหัสผ่านเป็น admin:admin หากต้องการเปลี่ยนข้อมูลเข้าสู่ระบบเหล่านี้ ให้ตั้งค่าตัวแปรสภาพแวดล้อมต่อไปนี้

   MIRROR_USERNAME=uName
   MIRROR_PASSWORD=pWord

4. ในโหนดใหม่ ให้ตรวจสอบว่าได้เปิดใช้ที่เก็บ EPEL ในเครื่องแล้ว
5. ในโหนดใหม่ ให้ตรวจสอบเวอร์ชันของ libdb4 ตามที่อธิบายไว้ข้างต้น
6. ในโหนดระยะไกล ให้ติดตั้งยูทิลิตีและ Dependencies ของ Edge apigee-service:

   sudo bash /tmp/bootstrap_4.53.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

   โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านของรีโป

7. ในโหนดระยะไกล ให้ใช้ apigee-service เพื่อติดตั้งยูทิลิตี apigee-setup ดังนี้

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

8. ใช้ apigee-setup เพื่อติดตั้งและกำหนดค่าคอมโพเนนต์ Edge บนโหนดระยะไกล ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งคอมโพเนนต์ Edge ในโหนด

อัปเดตที่เก็บ Apigee ในพื้นที่

หากต้องการอัปเดตที่เก็บ คุณต้องดาวน์โหลดไฟล์ Bootstrap_4.53.00.sh ล่าสุด จากนั้นดำเนินการซิงค์ใหม่

วิธีอัปเดตที่เก็บ

1. ดาวน์โหลดไฟล์ bootstrap_4.53.00.sh ของ Edge ลงใน /tmp/bootstrap_4.53.00.sh

   curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh

2. เรียกใช้ไฟล์ bootstrap_4.53.00.sh ของ Edge โดยทำดังนี้

   sudo bash/tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord

   โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณได้รับจาก Apigee หากละเว้น pWord ระบบจะแจ้งให้คุณป้อน

3. อัปเดต apigee-mirror

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update

4. ดำเนินการซิงค์โดยทำดังนี้

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

5. หากต้องการยกเลิกทั้งรีโป ให้ทำดังนี้

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

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

การล้างข้อมูลรีโปในเครื่องจะลบ /opt/apigee/data/apigee-mirror และ /var/tmp/yum-apigee-*

หากต้องการล้างที่เก็บข้อมูลในเครื่อง ให้ใช้คำสั่งต่อไปนี้

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