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

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

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

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

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

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

วิธีปิดใช้ 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. เปิดใช้ 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.7 ตามลำดับ

ติดตั้งยูทิลิตี 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.01.sh ของ Edge ไปยัง /tmp/bootstrap_4.53.01.sh

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

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

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

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

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

   • I: ติดตั้ง OpenJDK 1.8 (ค่าเริ่มต้น)
   • C: ดำเนินการต่อโดยไม่ติดตั้ง 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-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

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

ประเภทข้อผิดพลาด	การแก้ปัญหาที่ทำได้
รหัสผ่านมีอักขระที่ไม่ถูกต้อง	อย่าใช้สัญลักษณ์พิเศษในรหัสผ่าน 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

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

หากโหนด 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.01.sh ของ Edge ไปยัง /tmp/bootstrap_4.53.01.sh

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

5. ติดตั้งยูทิลิตี apigee-service ของ Edge และการอ้างอิงด้วยคำสั่งต่อไปนี้
   

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

      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.53.01.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 ในโหนดระยะไกลจากที่เก็บในเครื่อง

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

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

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

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

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

   /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 และการอ้างอิง

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

วิธีอัปเดตรีโป

1. ดาวน์โหลดไฟล์ bootstrap_4.53.01.sh ของ Edge ไปยัง /tmp/bootstrap_4.53.01.sh

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

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

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