Edge สำหรับ Private Cloud เวอร์ชัน 4.16.09
หากต้องการติดตั้ง Edge ในโหนด คุณต้องติดตั้งยูทิลิตี Edge Apigee-setup ก่อน หากคุณอยู่ในสภาพแวดล้อมที่โหนดไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก คุณต้องติดตั้งสำเนาที่เก็บ Apigee ในเครื่องด้วย
การสร้างลิงก์สัญลักษณ์จาก /opt/apigee
Edge จะติดตั้งไฟล์ทั้งหมดในไดเรกทอรี /opt/apigee คุณจะเปลี่ยนไดเรกทอรีนี้ไม่ได้ อย่างไรก็ตาม คุณสามารถสร้างลิงก์สัญลักษณ์เพื่อจับคู่ /opt/apigee กับตำแหน่งอื่นได้หากต้องการ
ก่อนสร้างลิงก์สัญลักษณ์ คุณต้องสร้างผู้ใช้และกลุ่มชื่อ "apigee" ก่อน ซึ่งเป็นกลุ่มและผู้ใช้เดียวกับที่โปรแกรมติดตั้ง Edge สร้างขึ้น
หากต้องการสร้างลิงก์สัญลักษณ์ ให้ทำตามขั้นตอนเหล่านี้ก่อนดาวน์โหลดไฟล์ Bootstrap_4.16.09.sh คุณต้องทําตามขั้นตอนเหล่านี้ทั้งหมดในฐานะรูท
- สร้างผู้ใช้และกลุ่ม "apigee" ดังต่อไปนี้
> groupadd -r apigee
> useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigeeplatform user" apigee - สร้างลิงก์สัญลักษณ์จาก /opt/apigee ลงในรูทการติดตั้งที่ต้องการ ดังนี้
> ln -Ts /srv/myInstallDir /opt/apigee
โดยที่ /srv/myInstallDir เป็นตำแหน่งที่ต้องการของไฟล์ Edge - เปลี่ยนการเป็นเจ้าของรูทการติดตั้งและ Symlink เป็นผู้ใช้ "apigee":
> chown -h apigee:apigee /srv/myInstallDir /opt/apigee
สิ่งที่ต้องทำก่อน: ปิดใช้ SELinux
คุณต้องปิดใช้ SELinux หรือตั้งค่าเป็นโหมดอนุญาต ก่อนจึงจะติดตั้งยูทิลิตี apigee-setup ของ Edge หรือคอมโพเนนต์ Edge ได้ หากจำเป็น หลังจากติดตั้ง Edge แล้ว คุณสามารถเปิดใช้ SELinux อีกครั้ง
- หากต้องการตั้งค่า 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
ติดตั้งยูทิลิตี Edge Apigee-setup บนโหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก
วิธีติดตั้ง Edge ในโหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก
- รับชื่อผู้ใช้และรหัสผ่านจาก Apigee ที่คุณใช้เข้าถึงที่เก็บ Apigee หากมี username:password สำหรับเว็บไซต์ Apigee FTP อยู่แล้ว คุณจะใช้ข้อมูลเข้าสู่ระบบเหล่านั้นได้
- เข้าสู่ระบบโหนดเป็นรูทเพื่อติดตั้ง Edge RPM
หมายเหตุ: แม้ว่าการติดตั้ง RPM จะต้องมีสิทธิ์เข้าถึงรูท แต่คุณก็ดำเนินการกำหนดค่า Edge ได้โดยไม่ต้องมีสิทธิ์เข้าถึงรูท - ปิดใช้ SELinux ตามที่อธิบายไว้ข้างต้น
- ดาวน์โหลดไฟล์ Edge bootstrap_4.16.09.sh ไปยัง bootstrap_4.16.09.sh:
> curl https://software.apigee.com/Boottrap_4.16.09.sh -o /tmp/shoestrap_4.16.09.sh - ติดตั้ง Edge apigee-serviceยูทิลิตีและการอ้างอิง:
> sudo bash /tmp/Boottrap_4.16.09.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*' - ใช้ apigee-service เพื่อติดตั้งยูทิลิตี apigee-setup
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install - ใช้ Apigee-setup เพื่อติดตั้งและกำหนดค่าคอมโพเนนต์ Edge บนโหนด ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งคอมโพเนนต์ Edge ในโหนด
ติดตั้งยูทิลิตี Edge Apigee-setup บนโหนดที่ไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก
หากโหนด Edge อยู่หลังไฟร์วอลล์หรือถูกห้ามไม่ให้เข้าถึงที่เก็บ Apigee ทางอินเทอร์เน็ตเช่นกัน คุณต้องสร้างที่เก็บในเครื่องหรือมิเรอร์ของที่เก็บ Apigee จากนั้นทุกโหนดต้องเข้าถึงมิเรอร์นั้นได้ เมื่อสร้างแล้ว โหนดจะเข้าถึงมิเรอร์ในเครื่องนั้นเพื่อติดตั้ง Edge ได้
หมายเหตุ: Apigee ไม่ได้โฮสต์ทรัพยากร Dependency ของบุคคลที่สามทั้งหมดในที่เก็บสาธารณะของเรา คุณต้องดาวน์โหลดและติดตั้งทรัพยากร Dependency เหล่านี้จากที่เก็บที่เข้าถึงได้แบบสาธารณะ
หลังจากสร้างที่เก็บ Edge ในเครื่องแล้ว คุณอาจต้องอัปเดตที่เก็บดังกล่าวด้วยไฟล์การเผยแพร่ Edge ล่าสุดในภายหลัง ส่วนต่อไปนี้อธิบายวิธีสร้างที่เก็บในเครื่องและวิธีอัปเดตที่เก็บ
สร้างที่เก็บ Apigee ในเครื่อง
วิธีสร้างที่เก็บ Apigee ในเครื่อง
- รับชื่อผู้ใช้และรหัสผ่านจาก Apigee ที่คุณใช้เข้าถึงที่เก็บ Apigee หากมี username:password สำหรับเว็บไซต์ Apigee FTP อยู่แล้ว คุณจะใช้ข้อมูลเข้าสู่ระบบเหล่านั้นได้
- เข้าสู่ระบบโหนด RedHat หรือ CentOS เป็นรูทเพื่อติดตั้ง Edge RPM
หมายเหตุ: แม้ว่าการติดตั้ง RPM จะต้องมีสิทธิ์เข้าถึงรูท แต่คุณก็กำหนดค่า Edge ได้โดยไม่ต้องมีสิทธิ์เข้าถึงรูท - ตรวจสอบว่าคุณมี yum-utils เวอร์ชันล่าสุด:
> sudo yumupdate yum-utils - ปิดใช้ SELinux ตามที่อธิบายไว้ข้างต้น
- ดาวน์โหลดไฟล์ Edge bootstrap_4.16.09.sh ไปยัง bootstrap_4.16.09.sh:
> curl https://software.apigee.com/Boottrap_4.16.09.sh -o /tmp/shoestrap_4.16.09.sh - ติดตั้งยูทิลิตีและ
ทรัพยากร Dependency ของ Edge apigee-service ดังนี้
> sudo bash /tmp/ขีดจำกัด Boottrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord
โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณได้รับจาก Apigee หากคุณไม่ได้ใส่ pWord ระบบจะขอให้คุณป้อนคำนั้น - ติดตั้งยูทิลิตี apigee-mirror
ในโหนดดังนี้
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
หมายเหตุ: หากกำลังอัปเดต repo ที่มีอยู่เป็น 4.16.09 คุณต้องอัปเดตเพียง apigee-mirror:
> api/api/Apigee/apirror - ใช้ยูทิลิตี 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 จากที่เก็บในเครื่อง -
(ไม่บังคับ) หากต้องการติดตั้ง Edge จากที่เก็บในเครื่องลงในโหนดเดียวกันที่โฮสต์ที่เก็บในเครื่อง คุณจะต้องเรียกใช้คำสั่งต่อไปนี้ก่อน
- เรียกใช้ bootstrap_4.16.09.sh จาก repo ภายในเพื่อติดตั้งยูทิลิตี bootstrap_4.16.09.sh :
> sudo bash /opt/apigee/data/apigee-mirror/repos/Boottrap_4.16.09.sh apigeeprotocol="file://" apigeerepogeedataprofile/apigeeprotocol="file://" apigeerepogeedata/opt/apigeebase - ใช้ apigee-service เพื่อ
ติดตั้งยูทิลิตี apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install - ใช้ apigee-setup เพื่อติดตั้งและกำหนดค่าคอมโพเนนต์ Edge บนโหนด ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งคอมโพเนนต์ Edge ในโหนด
- เรียกใช้ bootstrap_4.16.09.sh จาก repo ภายในเพื่อติดตั้งยูทิลิตี bootstrap_4.16.09.sh :
ติดตั้ง Apigee-setup บนโหนดระยะไกลจากที่เก็บในเครื่อง
คุณมี 2 ตัวเลือกในการติดตั้ง Edge จากที่เก็บในเครื่อง เลือกดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้
- สร้างไฟล์ .tar ของที่เก็บ คัดลอกไฟล์ .tar ไปยังโหนด จากนั้นติดตั้ง Edge จากไฟล์ .tar
- ติดตั้งเว็บเซิร์ฟเวอร์บนโหนดที่มีที่เก็บในเครื่องเพื่อให้โหนดอื่นๆ เข้าถึงได้ Apigee มีเว็บเซิร์ฟเวอร์ Nginx ให้คุณใช้ หรือจะใช้เว็บเซิร์ฟเวอร์ของคุณเองก็ได้
ติดตั้งจากไฟล์ .tar:
- บนโหนดที่มีที่เก็บในเครื่อง ให้ใช้คำสั่งต่อไปนี้เพื่อแพ็กเกจที่เก็บในเครื่องลงในไฟล์ .tar เดี่ยวที่ชื่อ /opt/apigee/data/apigee-mirror/apigee-4.16.09.tar.gz:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package - คัดลอกไฟล์ .tar ไปยังโหนดที่ต้องการติดตั้ง Edge เช่น คัดลอกไปยังไดเรกทอรี /tmp ในโหนดใหม่
- ในโหนดใหม่ ให้ปิดใช้ SELinux ตามที่อธิบายข้างต้น
- ในโหนดใหม่ ให้ยกเลิกไฟล์ไปยังไดเรกทอรี /tmp ดังนี้
> tar -xzf apigee-4.16.09.tar.gz
คำสั่งนี้จะสร้างไดเรกทอรีใหม่ชื่อ repos ในไดเรกทอรีที่มีไฟล์ .tar เช่น /tmp/repos - ติดตั้ง Edge apigee-serviceยูทิลิตีและการอ้างอิงจาก /tmp/repos:
> sudo bash /tmp/repos/Boottrap_4.16.09.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 บนโหนด Repo:
> 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เกี่ยวกับการรีสตาร์ท
- โดยค่าเริ่มต้น ที่เก็บกำหนดให้ต้องมี username:password ของ admin:admin หากต้องการเปลี่ยนข้อมูลเข้าสู่ระบบเหล่านี้ ให้ตั้งค่าตัวแปรสภาพแวดล้อมต่อไปนี้
MIRROR_USERNAME=uName
MIRROR_PASSWORD=pWord - ในโหนดใหม่ ให้ปิดใช้ SELinux ตามที่อธิบายข้างต้น
- ในโหนดระยะไกล ให้ดาวน์โหลดไฟล์ Edge Boottrap_4.16.09.sh ไปยัง /tmp/bootstrap_4.16.09.sh:
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/shoestrap_4.16.
- ในโหนดระยะไกล ให้ติดตั้ง Edge apigee-serviceยูทิลิตีและ Dependencies:
> sudo bash /tmp/Boottrap_4.16.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigee password=http://protocol=pWord apigee password - ในโหนดระยะไกล ให้ใช้ apigee-service เพื่อติดตั้งยูทิลิตี apigee-setup ดังนี้
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install - ใช้ apigee-setup เพื่อติดตั้งและกำหนดค่าคอมโพเนนต์ Edge บนโหนดระยะไกล ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งคอมโพเนนต์ Edge ในโหนด
อัปเดตที่เก็บ Apigee ในเครื่อง
หากต้องการอัปเดตที่เก็บ คุณต้องดาวน์โหลดไฟล์ bootstrap_4.16.09.sh ล่าสุด จากนั้นจึงดำเนินการ ซิงค์ใหม่:
- ดาวน์โหลดไฟล์ Edge Boottrap_4.16.09.sh ไปยัง /tmp/bootstrap_4.16.09.sh:
> curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/หัวข้อ Boottrap_4.16.09.sh - เรียกใช้ไฟล์ Edge bootstrap_4.16.09.sh:
> sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=uName
โดยที่ uName คือชื่อผู้ใช้และรหัสผ่านที่คุณได้รับจาก Apigee หากละเว้น pWord ระบบจะแจ้งให้คุณป้อน - อัปเดต apigee-mirror:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror อัปเดต - ดำเนินการซิงค์
> /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 ในที่เก็บ 4.16.09
หากต้องรักษาการติดตั้งสำหรับ Edge 4.16.01 และ 4.16.05 ในที่เก็บ 4.16.09 คุณจะเก็บรักษาที่เก็บที่มีทุกเวอร์ชันได้ จากนั้นคุณจะติดตั้ง Edge เวอร์ชันใดก็ได้จากที่เก็บดังกล่าว
หากต้องการเพิ่ม 4.16.01/4.16.05 ไปยังที่เก็บ 4.16.09 ให้ทำดังนี้
- ตรวจสอบว่าคุณได้ติดตั้งยูทิลิตี apigee-mirror เวอร์ชัน 4.16.09 แล้ว
> /opt/apigee/apigee-service/bin/apigee-service apigee-miแสดงรายละเอียดเวอร์ชัน
คุณจะเห็นผลลัพธ์ในแบบฟอร์มด้านล่าง โดยที่ xyz คือหมายเลขบิลด์:
apigee-mirror-094.194.1 - ใช้ยูทิลิตี apigee-mirror เพื่อดาวน์โหลด Edge 4.16.01 หรือ 4.16.05 ไปยังที่เก็บ สังเกตวิธีใส่คำนำหน้าคำสั่งด้วย apigeereleasever=4.16.01
หรือ apigeereleasever=4.16.05 ดังนี้
> apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
- ตรวจสอบไดเรกทอรี /opt/apigee/data/apigee-mirror/repos
เพื่อดูโครงสร้างไฟล์ ดังนี้
> ls /opt/apigee/data/apigee-mirror/repos
คุณควรเห็นไฟล์และไดเรกทอรีต่อไปนี้
apigee apigee-repo-1.0-6.x86_64.rpm
นอกจากนี้ ไดเรกทอรี apigee จะมีไดเรกทอรีแยกกันสำหรับ Edge แต่ละเวอร์ชันด้วย - หากต้องการทำแพ็กเกจที่เก็บในไฟล์ .tar ให้ใช้คำสั่งต่อไปนี้
> apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
คำสั่งนี้จะรวมทั้งไฟล์ 4.16.09 และ 4.16.01 ไว้ใน .tar เดียวกัน คุณจะสร้างแพ็กเกจเฉพาะบางส่วนของที่เก็บไม่ได้
หากต้องการติดตั้ง Edge จากไฟล์ repo ในเครื่องหรือไฟล์ .tar คุณเพียงแค่ต้องเรียกใช้ไฟล์ Bootstrap ที่ถูกต้องโดยใช้คำสั่งใดคำสั่งหนึ่งต่อไปนี้
- หากติดตั้งจากไฟล์ .tar ให้เรียกใช้ไฟล์ Bootstrap ที่ถูกต้องจาก repo:
> sudo bash /tmp/repos/bootstrap_4.16.0X.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
โดยทำตามขั้นตอนที่เหลือจาก "ติดตั้ง" ตามขั้นตอนด้านบน - หากติดตั้งโดยใช้เว็บเซิร์ฟเวอร์ Nginx ให้ดาวน์โหลดแล้วเรียกใช้ไฟล์ Boottrap ที่ถูกต้องจาก repo:
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.0X.sh -o /tmp/bootstrap_4.16.0X.sh
bootstrap_4.16.0X.sh