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

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

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

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

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

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

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

คุณต้องเปิดใช้ Extra Packages for Enterprise Linux (หรือ EPEL) เพื่อติดตั้งหรืออัปเดต Edge หรือเพื่อสร้าง ที่เก็บในเครื่อง สำหรับ Red Hat Enterprise Linux (RHEL) 9.x, Rocky Linux 9.x หรือ Oracle Linux 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 9/Rocky 9/Oracle 9

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

1. เปิดใช้ Extra Packages for 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 และ การเปลี่ยนแปลงก่อนการติดตั้ง SymasLDAP 2.6.10 ตามลำดับ

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

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

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

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

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

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

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

   Apigee Edge for Private Cloud 4.54.00 ต้องรองรับ Java แบบคู่ โดยต้องติดตั้งทั้ง Java 17 และ Java 21 ในโหนด คุณต้องติดตั้งทั้ง Java 17 และ Java 21 ก่อนเรียกใช้สคริปต์ Bootstrap โปรแกรมติดตั้งจะตรวจสอบว่ามีการติดตั้ง JDK ทั้ง 2 เวอร์ชันแล้วเท่านั้น โดยจะไม่ติดตั้ง 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-setup
   

   /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

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

nc -v software.apigee.com 443

Connection to software.apigee.com 443 port [tcp/https] succeeded!

telnet software.apigee.com 443

curl -i -u username:password https://software.apigee.com/apigee-repo.rpm

echo $http_proxy
echo $https_proxy

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

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

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

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

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

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

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

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

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

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

5. ติดตั้งยูทิลิตี apigee-service ของ Edge และทรัพยากร Dependency โดยทำดังนี้
   

   sudo bash /tmp/bootstrap_4.54.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.54.00.sh จากที่เก็บในเครื่องเพื่อติดตั้ง apigee-service ยูทิลิตี:

      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.54.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.54.00.tar.gz

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

2. คัดลอกไฟล์ .tar ไปยังโหนดที่ต้องการติดตั้ง Edge เช่น คัดลอกไปยัง /tmp ไดเรกทอรีในโหนดใหม่
3. ในโหนดใหม่ ให้ปิดใช้ SELinux ตามที่อธิบายไว้ข้างต้น
4. ในโหนดใหม่ ตรวจสอบว่าคุณเข้าถึงที่เก็บยูทิลิตี Yum ในเครื่องและที่เก็บ EPEL repo ได้
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 ในโหนดที่เก็บโดยทำดังนี้
   

   /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. ในโหนดระยะไกล ให้ติดตั้งยูทิลิตี apigee-service ของ Edge และทรัพยากร Dependency โดยทำดังนี้

   sudo bash /tmp/bootstrap_4.54.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.54.00.sh ล่าสุด แล้ว ทำการซิงค์ใหม่

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

1. ดาวน์โหลดไฟล์ bootstrap_4.54.00.sh ของ Edge ไปที่ /tmp/bootstrap_4.54.00.sh

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

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

   sudo bash/tmp/bootstrap_4.54.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