Edge for Private Cloud เวอร์ชัน 4.16.05
หากต้องการติดตั้ง Edge ในโหนด คุณต้องติดตั้งยูทิลิตี apigee-setup ของ Edge ก่อน หากคุณอยู่ในสภาพแวดล้อมที่โหนดไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก คุณต้องติดตั้งสำเนาในเครื่องของที่เก็บ Apigee ด้วย
กำลังสร้าง Symlink จาก /opt/apigee
Edge จะติดตั้งไฟล์ทั้งหมดในไดเรกทอรี /opt/apigee คุณเปลี่ยนไดเรกทอรีนี้ไม่ได้ อย่างไรก็ตาม คุณสามารถสร้างลิงก์สัญลักษณ์เพื่อแมป /opt/apigee กับตำแหน่งอื่นได้หากต้องการ
ก่อนสร้าง Symlink คุณต้องสร้างผู้ใช้และกลุ่มชื่อ "apigee" ก่อน ซึ่งเป็นกลุ่มและผู้ใช้เดียวกันกับที่สร้างโดยโปรแกรมติดตั้ง Edge
หากต้องการสร้างลิงก์สัญลักษณ์ ให้ทำตามขั้นตอนต่อไปนี้ก่อนดาวน์โหลดไฟล์ bootstrap_4.16.05.sh คุณต้องทำตามขั้นตอนทั้งหมดต่อไปนี้ในฐานะรูท
- สร้างผู้ใช้และกลุ่ม "apigee" ดังนี้
> groupadd -r apigee
> useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee - สร้างลิงก์สัญลักษณ์จาก /opt/apigee ไปยังรูทการติดตั้งที่ต้องการ:
> ln -Ts /srv/myInstallDir /opt/apigee
โดยที่ /srv/myInstallDir คือตำแหน่งที่ต้องการของไฟล์ Edge - เปลี่ยนการเป็นเจ้าของรูทการติดตั้งและลิงก์สัญลักษณ์เป็นผู้ใช้ "apigee":
> chown -h apigee:apigee /srv/myInstallDir /opt/apigee
ข้อกำหนดเบื้องต้น: ปิดใช้ SELinux
คุณต้องปิดใช้ SELinux หรือตั้งค่าเป็นโหมดอนุญาตก่อนจึงจะติดตั้งยูทิลิตี apigee-setup ของ Edge หรือคอมโพเนนต์ Edge ได้ หากจำเป็น คุณสามารถเปิดใช้ SELinux อีกครั้งหลังจากติดตั้ง Edge แล้ว
- หากต้องการตั้งค่า SELinux เป็นโหมดอนุญาตชั่วคราว ให้เรียกใช้คำสั่งต่อไปนี้
- ในระบบปฏิบัติการ Linux 6.x:
echo 0 > /selinux/enforce
หากต้องการเปิดใช้ SELinux อีกครั้งหลังจากติดตั้ง Edge ให้ทำดังนี้
echo 1 > /selinux/enforce - ในระบบปฏิบัติการ Linux 7.x:
setenforce 0
หากต้องการเปิดใช้ SELinux อีกครั้งหลังจากติดตั้ง Edge ให้ทำดังนี้
setenforce 1
- ในระบบปฏิบัติการ Linux 6.x:
- หากต้องการปิดใช้ SELinux อย่างถาวรหรือตั้งค่าเป็นโหมดอนุญาต ให้ทำดังนี้
- เปิด /etc/sysconfig/selinux ในเครื่องมือแก้ไข
- ตั้งค่า SELINUX=disabled หรือ SELINUX=permissive
- บันทึกการแก้ไข
- รีสตาร์ทโหนด
- หากจำเป็น ให้เปิดใช้ SELinux อีกครั้งหลังจากติดตั้ง Edge โดยทำตามขั้นตอนนี้ซ้ำเพื่อตั้งค่า SELINUX=enabled
ติดตั้งยูทิลิตี apigee-setup ของ Edge ในโหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก
วิธีติดตั้ง Edge ในโหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก
- รับชื่อผู้ใช้และรหัสผ่านจาก Apigee ที่คุณใช้เพื่อเข้าถึงที่เก็บ Apigee หากคุณมีชื่อผู้ใช้:รหัสผ่านสำหรับเว็บไซต์ FTP ของ Apigee อยู่แล้ว คุณสามารถใช้ข้อมูลเข้าสู่ระบบดังกล่าวได้
- เข้าสู่ระบบโหนดในฐานะรูทเพื่อติดตั้ง Edge RPM
หมายเหตุ: แม้ว่าการติดตั้ง RPM จะต้องใช้สิทธิ์เข้าถึงระดับรูท แต่คุณสามารถกำหนดค่า Edge โดยไม่ต้องใช้สิทธิ์เข้าถึงระดับรูทได้ - ปิดใช้ SELinux ตามที่อธิบายไว้ข้างต้น
- ดาวน์โหลดไฟล์ Edge bootstrap_4.16.05.sh ไปยัง /tmp/bootstrap_4.16.05.sh:
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh - ติดตั้งยูทิลิตี apigee-service ของ Edge และทรัพยากร Dependency:
> sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณได้รับจาก Apigee หากคุณละเว้น pWord ระบบจะแจ้งให้คุณป้อนรหัสผ่าน
โดยค่าเริ่มต้น โปรแกรมติดตั้งจะตรวจสอบว่าคุณได้ติดตั้ง Java 1.8 ไว้หรือไม่ หากยังไม่ได้ติดตั้ง ระบบจะติดตั้งให้คุณ ใช้ตัวเลือก JAVA_FIX เพื่อระบุวิธีจัดการการติดตั้ง Java JAVA_FIX ใช้ค่าต่อไปนี้
I = ติดตั้ง OpenJDK 1.8 (ค่าเริ่มต้น)
C = ดำเนินการต่อโดยไม่ติดตั้ง Java
Q = ออก สำหรับตัวเลือกนี้ คุณต้องติดตั้ง Java ด้วยตนเอง
การติดตั้งยูทิลิตี apigee-service จะสร้างไฟล์ /etc/yum.repos.d/apigee.repo ซึ่งกำหนดที่เก็บ Apigee หากต้องการดูไฟล์คำจำกัดความ ให้ใช้คำสั่งต่อไปนี้
> cat /etc/yum.repos.d/apigee.repo
หากต้องการดูเนื้อหาที่เก็บ ให้ใช้คำสั่งต่อไปนี้
> sudo yum -v repolist 'apigee*' - ใช้ apigee-service เพื่อติดตั้งยูทิลิตี apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install - ใช้ apigee-setup เพื่อติดตั้งและกำหนดค่าคอมโพเนนต์ Edge ในโหนด ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งคอมโพเนนต์ Edge ในโหนด
ติดตั้งยูทิลิตี apigee-setup ของ Edge ในโหนดที่ไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก
หากโหนด Edge อยู่หลังไฟร์วอลล์ หรือถูกห้ามไม่ให้เข้าถึงที่เก็บ Apigee ผ่านอินเทอร์เน็ตด้วยวิธีอื่น คุณต้องสร้างที่เก็บในเครื่องหรือมิเรอร์ของที่เก็บ Apigee จากนั้นโหนดทั้งหมดต้องเข้าถึงมิเรอร์นั้นได้ เมื่อสร้างแล้ว โหนดจะเข้าถึงมิเรอร์ในเครื่องนั้นเพื่อติดตั้ง Edge ได้
หมายเหตุ: Apigee ไม่ได้โฮสต์ทรัพยากร Dependency ของบุคคลที่สามทั้งหมดในที่เก็บสาธารณะของเรา คุณต้องดาวน์โหลดและติดตั้งทรัพยากร Dependency เหล่านี้จากที่เก็บที่เข้าถึงได้แบบสาธารณะ
หลังจากสร้างที่เก็บ Edge ในเครื่องแล้ว คุณอาจต้องอัปเดตที่เก็บด้วยไฟล์ Edge เวอร์ชันล่าสุดในภายหลัง ส่วนต่อไปนี้จะอธิบายวิธีสร้างที่เก็บในเครื่องและวิธีอัปเดต
สร้างที่เก็บ Apigee ในเครื่อง
วิธีสร้างที่เก็บ Apigee ในเครื่อง
- รับชื่อผู้ใช้และรหัสผ่านจาก Apigee ที่คุณใช้เพื่อเข้าถึงที่เก็บ Apigee หากคุณมีชื่อผู้ใช้:รหัสผ่านสำหรับเว็บไซต์ FTP ของ Apigee อยู่แล้ว คุณสามารถใช้ข้อมูลเข้าสู่ระบบดังกล่าวได้
- เข้าสู่ระบบโหนด RedHat หรือ CentOS ในฐานะรูทเพื่อติดตั้ง Edge RPM
หมายเหตุ: แม้ว่าการติดตั้ง RPM จะต้องใช้สิทธิ์เข้าถึงระดับรูท แต่คุณสามารถกำหนดค่า Edge ได้โดยไม่ต้องใช้สิทธิ์เข้าถึงระดับรูท - ตรวจสอบว่าคุณใช้ yum-utils เวอร์ชันล่าสุด:
> sudo yum update yum-utils - ปิดใช้ SELinux ตามที่อธิบายไว้ข้างต้น
- ดาวน์โหลดไฟล์ Edge bootstrap_4.16.05.sh ไปยัง /tmp/bootstrap_4.16.05.sh:
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh - ติดตั้งยูทิลิตี apigee-service ของ Edge และทรัพยากร Dependency:
> sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณได้รับจาก Apigee หากคุณละเว้น pWord ระบบจะแจ้งให้คุณป้อนรหัสผ่าน - ติดตั้งยูทิลิตี apigee-mirror ในโหนด:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install - ใช้ยูทิลิตี 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 ในเครื่องแล้ว ส่วนถัดไปจะอธิบายวิธีติดตั้งยูทิลิตี apigee-setup ของ Edge จากที่เก็บในเครื่อง -
(ไม่บังคับ) หากต้องการติดตั้ง Edge จากที่เก็บในเครื่องลงในโหนดเดียวกันกับที่โฮสต์ที่เก็บในเครื่อง คุณต้องเรียกใช้คำสั่งต่อไปนี้ก่อน
- เรียกใช้ bootstrap_4.16.05.sh จากที่เก็บในเครื่องเพื่อติดตั้งยูทิลิตี apigee-service:
> sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos - ใช้ apigee-service เพื่อติดตั้งยูทิลิตี apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install - ใช้ apigee-setup เพื่อติดตั้งและกำหนดค่าคอมโพเนนต์ Edge ในโหนด ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งคอมโพเนนต์ Edge ในโหนด
- เรียกใช้ bootstrap_4.16.05.sh จากที่เก็บในเครื่องเพื่อติดตั้งยูทิลิตี apigee-service:
ติดตั้ง apigee-setup บนโหนดระยะไกลจากที่เก็บในเครื่อง
คุณมี 2 ตัวเลือกในการติดตั้ง Edge จากที่เก็บในเครื่อง เลือกดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้
- สร้างไฟล์ .tar ของที่เก็บ คัดลอกไฟล์ .tar ไปยังโหนด แล้วติดตั้ง Edge จากไฟล์ .tar
- ติดตั้งเว็บเซิร์ฟเวอร์ในโหนดที่มีที่เก็บในเครื่องเพื่อให้โหนดอื่นๆ เข้าถึงได้ Apigee มีเว็บเซิร์ฟเวอร์ Nginx ให้คุณใช้ หรือคุณจะใช้เว็บเซิร์ฟเวอร์ของคุณเองก็ได้
ติดตั้งจากไฟล์ .tar โดยทำดังนี้
- ในโหนดที่มีที่เก็บในเครื่อง ให้ใช้คำสั่งต่อไปนี้เพื่อจัดแพ็กเกจที่เก็บในเครื่องเป็นไฟล์ .tar ไฟล์เดียวชื่อ /opt/apigee/data/apigee-mirror/apigee-4.16.05.tar.gz
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package - คัดลอกไฟล์ .tar ไปยังโหนดที่ต้องการติดตั้ง Edge เช่น คัดลอกไปยังไดเรกทอรี /tmp ในโหนดใหม่
- ในโหนดใหม่ ให้ปิดใช้ SELinux ตามที่อธิบายไว้ข้างต้น
- ในโหนดใหม่ ให้ Untar ไฟล์ไปยังไดเรกทอรี /tmp:
> tar -xzf apigee-4.16.05.tar.gz
คำสั่งนี้จะสร้างไดเรกทอรีใหม่ชื่อ repos ในไดเรกทอรีที่มีไฟล์ .tar เช่น /tmp/repos. - ติดตั้งยูทิลิตี apigee-service ของ Edge และทรัพยากร Dependency จาก /tmp/repos:
> sudo bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
โปรดทราบว่าคุณต้องระบุเส้นทางไปยังไดเรกทอรี repos ในคำสั่งนี้ - ใช้ apigee-service เพื่อติดตั้งยูทิลิตี apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install - ใช้ apigee-setup เพื่อติดตั้งและกำหนดค่าคอมโพเนนต์ Edge ในโหนด ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งคอมโพเนนต์ Edge ในโหนด
ติดตั้งจากที่เก็บโดยใช้เว็บเซิร์ฟเวอร์ Nginx
- ติดตั้งเว็บเซิร์ฟเวอร์ Nginx ในโหนดที่เก็บข้อมูล:
> opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig - โดยค่าเริ่มต้น Nginx จะได้รับการกำหนดค่าให้ใช้ localhost เป็นชื่อเซิร์ฟเวอร์และพอร์ต 3939 หากต้องการเปลี่ยนค่าเหล่านี้ ให้ทำดังนี้
- เปิด /opt/apigee/customer/application/mirror.properties ในเครื่องมือแก้ไข สร้างไฟล์หากยังไม่มี
- กำหนดค่าต่อไปนี้ตามความจำเป็น
conf_apigee_mirror_listen_port=3939
conf_apigee_mirror_server_name=localhost - รีสตาร์ท Nginx:
> /opt/nginx/scripts/apigee-nginx restart
- โดยค่าเริ่มต้น ที่เก็บต้องใช้ชื่อผู้ใช้:รหัสผ่านเป็น admin:admin หากต้องการเปลี่ยนข้อมูลเข้าสู่ระบบเหล่านี้
ให้ตั้งค่าตัวแปรสภาพแวดล้อมต่อไปนี้
MIRROR_USERNAME=uName
MIRROR_PASSWORD=pWord - ในโหนดใหม่ ให้ปิดใช้ SELinux ตามที่อธิบายไว้ข้างต้น
- ในโหนดระยะไกล ให้ดาวน์โหลดไฟล์ Edge bootstrap_4.16.05.sh ไปยัง /tmp/bootstrap_4.16.05.sh:
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณตั้งไว้ด้านบนสำหรับที่เก็บ และ remoteRepo คือที่อยู่ IP หรือชื่อ DNS ของโหนดที่เก็บ - ในโหนดระยะไกล ให้ติดตั้งยูทิลิตี apigee-service ของ Edge และทรัพยากร Dependency:
> sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านของที่เก็บ - ในโหนดระยะไกล ให้ใช้ apigee-service เพื่อติดตั้งยูทิลิตี apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install - ใช้ apigee-setup เพื่อติดตั้งและกำหนดค่าคอมโพเนนต์ Edge ในโหนดระยะไกล ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งคอมโพเนนต์ Edge ในโหนด
อัปเดตที่เก็บ Apigee ในเครื่อง
หากต้องการอัปเดตที่เก็บ คุณต้องดาวน์โหลดไฟล์ bootstrap_4.16.05.sh ล่าสุด แล้วทำการซิงค์ใหม่ โดยทำดังนี้
- ดาวน์โหลดไฟล์ bootstrap_4.16.05.sh ของ Edge ไปยัง /tmp/bootstrap_4.16.05.sh:
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh - ทำการซิงค์:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms - หากต้องการดาวน์โหลดที่เก็บทั้งหมด ให้ทำดังนี้
> /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เพิ่มหรืออัปเดต Edge 4.16.01 ในที่เก็บ 4.16.05
หากต้องรักษาการติดตั้งสำหรับทั้ง Edge 4.16.05 และ 4.16.01 คุณสามารถรักษาที่เก็บที่มีทั้ง 2 เวอร์ชันได้ จากที่เก็บนั้น คุณจะติดตั้ง Edge 4.16.05 และ 4.16.01 ได้
วิธีเพิ่ม 4.16.01 ลงในที่เก็บ 4.15.05
- ตรวจสอบว่าคุณได้ติดตั้งยูทิลิตี apigee-mirror เวอร์ชัน 4.16.05 แล้ว
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version
คุณควรเห็นผลลัพธ์ในรูปแบบด้านล่าง โดยที่ xyz คือหมายเลขบิลด์
apigee-mirror-4.16.05-0.0.xyz - ใช้ยูทิลิตี apigee-mirror เพื่อดาวน์โหลด Edge 4.16.01 ไปยังที่เก็บของคุณ โปรดสังเกตว่าคุณใส่คำสั่งนำหน้าด้วย
apigeereleasever=4.16.01:
> apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
ใช้คำสั่งเดียวกันนี้เพื่ออัปเดตที่เก็บ 4.16.01 ในภายหลัง - ตรวจสอบไดเรกทอรี /opt/apigee/data/apigee-mirror/repos เพื่อดูโครงสร้างไฟล์:
> ls /opt/apigee/data/apigee-mirror/repos
คุณควรเห็นไฟล์และไดเรกทอรีต่อไปนี้
apigee apigee-repo-1.0-6.x86_64.rpm bootstrap_4.16.01.sh bootstrap_4.16.05.sh thirdparty
โปรดสังเกตว่าคุณมีไฟล์บูตสแตรปสำหรับ Edge ทั้ง 2 เวอร์ชัน ไดเรกทอรี apigee ยังมีไดเรกทอรีแยกต่างหากสำหรับ Edge แต่ละเวอร์ชันด้วย - หากต้องการจัดแพ็กเกจที่เก็บเป็นไฟล์ .tar ให้ใช้คำสั่งต่อไปนี้
> apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
คำสั่งนี้จะจัดแพ็กเกจทั้งที่เก็บ 4.16.05 และ 4.16.01 ไว้ในไฟล์ .tar เดียวกัน คุณไม่สามารถแพ็กเกจเฉพาะบางส่วนของที่เก็บได้
หากต้องการติดตั้ง Edge จากที่เก็บในเครื่องหรือไฟล์ .tar ให้ตรวจสอบว่าได้เรียกใช้ไฟล์บูตสแตรปที่ถูกต้องโดยใช้คำสั่งใดคำสั่งหนึ่งต่อไปนี้
- หากติดตั้งจากไฟล์ .tar ให้เรียกใช้ไฟล์บูตสแตรปที่ถูกต้องจากที่เก็บข้อมูล ดังนี้
> sudo bash /tmp/repos/bootstrap_4.16.0X.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
หากต้องการติดตั้งให้เสร็จสมบูรณ์ ให้ทำตามขั้นตอนที่เหลือจาก "ติดตั้งจากไฟล์ .tar" ด้านบน - หากติดตั้งโดยใช้เว็บเซิร์ฟเวอร์ Nginx ให้ดาวน์โหลดแล้วเรียกใช้ไฟล์บูตสแตรปที่ถูกต้องจากที่เก็บข้อมูล ดังนี้
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.0X.sh -o /tmp/bootstrap_4.16.0X.sh
> sudo bash /tmp/bootstrap_4.16.0X.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
หากต้องการติดตั้งให้เสร็จสมบูรณ์ ให้ทำตามขั้นตอนที่เหลือจาก "ติดตั้งจากที่เก็บข้อมูลโดยใช้เว็บเซิร์ฟเวอร์ Nginx" ด้านบน