Edge สำหรับ Private Cloud เวอร์ชัน 4.17.01
หากต้องการติดตั้ง Edge ในโหนด คุณต้องติดตั้งยูทิลิตี Edge Apigee-setup ก่อน หากคุณอยู่ในสภาพแวดล้อมที่โหนดไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก คุณต้องติดตั้งสำเนาที่เก็บ Apigee ในเครื่องด้วย
ไดเรกทอรีการติดตั้งเริ่มต้น: /opt/apigee
Edge จะติดตั้งไฟล์ทั้งหมดในไดเรกทอรี /opt/apigee คุณจะเปลี่ยนไดเรกทอรีนี้ไม่ได้ อย่างไรก็ตาม คุณสามารถสร้างลิงก์สัญลักษณ์เพื่อจับคู่ /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
สิ่งที่ต้องทำก่อน: เปิดใช้ที่เก็บ EPEL
คุณต้องเปิดใช้แพ็กเกจพิเศษสำหรับ Enterprise Linux (หรือ EPEL) เพื่อติดตั้งหรืออัปเดต Edge คำสั่งที่คุณใช้ขึ้นอยู่กับเวอร์ชันของ RedHat/CentOS ดังนี้
- สำหรับ RedHat/CentOS 7.x
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; sudo rpm -ivh epel-release-latest-7.noarch.rpm - สำหรับ RedHat/CentOS 6.x
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; sudo rpm -ivh epel-release-latest-6.noarch.rpm
ติดตั้งยูทิลิตี Edge Apigee-setup บนโหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก
วิธีติดตั้ง Edge ในโหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก
- รับชื่อผู้ใช้และรหัสผ่านจาก Apigee ที่คุณใช้เข้าถึงที่เก็บ Apigee หากมี username:password สำหรับเว็บไซต์ Apigee FTP อยู่แล้ว คุณจะใช้ข้อมูลเข้าสู่ระบบเหล่านั้นได้
- เข้าสู่ระบบโหนดเป็นรูทเพื่อติดตั้ง Edge RPM
หมายเหตุ: แม้ว่าการติดตั้ง RPM จะต้องมีสิทธิ์เข้าถึงรูท แต่คุณก็ดำเนินการกำหนดค่า Edge ได้โดยไม่ต้องมีสิทธิ์เข้าถึงรูท - ปิดใช้ SELinux ตามที่อธิบายไว้ข้างต้น
- เปิดใช้ที่เก็บ EPEL ตามที่อธิบายไว้ข้างต้น
- ดาวน์โหลดไฟล์ Edge bootstrap_4.17.01.sh ไปยัง bootstrap_4.17.01.sh:
> curl https://software.apigee.com/Boottrap_4.17.01.sh -o /tmp/Boottrap_4.17.01.sh - ติดตั้ง Edge apigee-serviceยูทิลิตีและการอ้างอิง:
> sudo bash /tmp/Boottrap_4.17.01.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*' - (CentOS-6.x และ RedHat-6.x เท่านั้น) ในโหนด Qpid ทั้งหมด ให้เรียกใช้คำสั่งต่อไปนี้เพื่อให้แน่ใจว่าคุณได้ดาวน์โหลดเวอร์ชัน Qpid ที่ถูกต้อง
> yum install apigee-qpidd --disablerepo=epel - ใช้ 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 ภายใน คุณต้องมีโหนดที่มีสิทธิ์เข้าถึงอินเทอร์เน็ตภายนอกจึงจะดาวน์โหลด Edge RPM และทรัพยากร Dependency ได้ เมื่อสร้างที่เก็บภายในแล้ว คุณจะย้ายไปยังโหนดอื่นหรือกำหนดให้โหนด 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 ตามที่อธิบายไว้ข้างต้น
- เปิดใช้ที่เก็บ EPEL ตามที่อธิบายไว้ข้างต้น
- ดาวน์โหลดไฟล์ Edge bootstrap_4.17.01.sh ไปยัง bootstrap_4.17.01.sh:
> curl https://software.apigee.com/Boottrap_4.17.01.sh -o /tmp/Boottrap_4.17.01.sh - (CentOS-6.x และ RedHat-6.x เท่านั้น) เรียกใช้คำสั่งต่อไปนี้เพื่อให้แน่ใจว่าคุณได้ดาวน์โหลดเวอร์ชัน Qpid ที่ถูกต้อง
> yum install apigee-qpidd --disablerepo=epel - ติดตั้ง Edge apigee-serviceยูทิลิตีและการอ้างอิง:
> sudo bash /tmp/shoestrap_4.17.01.sh apigeeuser=uName apigeepassword=pWord
โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่ได้รับจาก Apigee หากคุณไม่ได้ใส่ pWord ระบบจะขอให้คุณป้อนคำนั้น - ติดตั้งยูทิลิตี apigee-mirror
ในโหนดดังนี้
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
หมายเหตุ: หากกำลังอัปเดต repo ที่มีอยู่เป็น 4.17.01 คุณต้องอัปเดตเพียง apigee-mirror:
> api/api/apigee off - ใช้ยูทิลิตี 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.17.01.sh จาก repo ภายในเพื่อติดตั้งยูทิลิตี bootstrap_4.17.01.sh:
> sudo bash /opt/apigee/data/apigee-mirror/repos/Boottrap_4.17.01.sh apigeeprotocol="file://" apigeerepogeedata/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.17.01.sh จาก repo ภายในเพื่อติดตั้งยูทิลิตี bootstrap_4.17.01.sh:
ติดตั้ง Apigee-setup บนโหนดระยะไกลจากที่เก็บในเครื่อง
คุณมี 2 ตัวเลือกในการติดตั้ง Edge จากที่เก็บในเครื่อง เลือกดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้
- สร้างไฟล์ .tar ของที่เก็บ คัดลอกไฟล์ .tar ไปยังโหนด จากนั้นติดตั้ง Edge จากไฟล์ .tar
- ติดตั้งเว็บเซิร์ฟเวอร์บนโหนดที่มีที่เก็บในเครื่องเพื่อให้โหนดอื่นๆ เข้าถึงได้ Apigee มีเว็บเซิร์ฟเวอร์ Nginx ให้คุณใช้ หรือจะใช้เว็บเซิร์ฟเวอร์ของคุณเองก็ได้
ติดตั้งจากไฟล์ .tar:
- บนโหนดที่มีที่เก็บในเครื่อง ให้ใช้คำสั่งต่อไปนี้เพื่อแพ็กเกจ repo ในเครื่องลงในไฟล์ .tar เดี่ยวที่ชื่อ /opt/apigee/data/apigee-mirror/apigee-4.17.01.tar.gz:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package - คัดลอกไฟล์ .tar ไปยังโหนดที่ต้องการติดตั้ง Edge เช่น คัดลอกไปยังไดเรกทอรี /tmp ในโหนดใหม่
- ในโหนดใหม่ ให้ปิดใช้ SELinux ตามที่อธิบายข้างต้น
- ในโหนดใหม่ ให้ยกเลิกไฟล์ไปยังไดเรกทอรี /tmp ดังนี้
> tar -xzf apigee-4.17.01.tar.gz
คำสั่งนี้จะสร้างไดเรกทอรีใหม่ชื่อ repos ในไดเรกทอรีที่มีไฟล์ .tar เช่น /tmp/repos - ติดตั้งยูทิลิตี้ Edge apigee-serviceและการอ้างอิงจาก /tmp/repos:
> sudo bash /tmp/repos/Boottrap_4.17.01.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 Bootstrap_4.17.01.sh ไปยัง /tmp/bootstrap_4.17.01.sh:
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/belttrap_1us_4.17
- ในโหนดระยะไกล ให้ติดตั้ง Edge apigee-serviceยูทิลิตีและ Dependencies:
> sudo bash /tmp/Boottrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord the apigee password=http://ให้ดำเนินการใน - ในโหนดระยะไกล ให้ใช้ apigee-service เพื่อติดตั้งยูทิลิตี apigee-setup ดังนี้
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install - ใช้ apigee-setup เพื่อติดตั้งและกำหนดค่าคอมโพเนนต์ Edge บนโหนดระยะไกล ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งคอมโพเนนต์ Edge ในโหนด
อัปเดตที่เก็บ Apigee ในเครื่อง
หากต้องการอัปเดตที่เก็บ คุณต้องดาวน์โหลดไฟล์ Bootstrap_4.17.01.sh ล่าสุด จากนั้นดำเนินการ ซิงค์ใหม่
- ดาวน์โหลดไฟล์ Edge Boottrap_4.17.01.sh ไปยัง /tmp/bootstrap_4.17.01.sh:
> curl https://software.apigee.com/หัวข้อ Boottrap_4.17.01.sh -o /tmp/หัวข้อบูตtrap_4.17.01.sh - เรียกใช้ไฟล์ Edge bootstrap_4.17.01.sh:
> sudo bash /tmp/Boottrap_4.17.01.sh apigeeuser=uName apigeepassword=uName
โดยที่ uName คือชื่อผู้ใช้และรหัสผ่านที่คุณได้รับจาก ที่คุณได้รับจาก หากละเว้น 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 ในที่เก็บ 4.17.01
หากคุณต้องรักษาการติดตั้งสำหรับ Edge 4.16.0x ในที่เก็บ 4.17.01 คุณจะใช้ที่เก็บที่มีทุกเวอร์ชันได้ จากนั้นคุณจะติดตั้ง Edge เวอร์ชันใดก็ได้จากที่เก็บดังกล่าว
วิธีเพิ่ม 4.16.0x ไปยังที่เก็บ 4.17.01
- ตรวจสอบว่าคุณได้ติดตั้งยูทิลิตี apigee-mirror เวอร์ชัน 4.17.01 แล้ว
> /opt/apigee/apigee-service/bin/apigee-service apigee-miแสดงรายละเอียดเวอร์ชัน
คุณจะเห็นผลลัพธ์ในแบบฟอร์มด้านล่าง โดยที่ xyz คือหมายเลขบิลด์:
apigee-mirror-04.1 - ใช้ยูทิลิตี apigee-mirror
เพื่อดาวน์โหลด Edge 4.16.01/4.16.05/4.16.09 ไปยังที่เก็บ สังเกตวิธีใส่คำนำหน้าคำสั่งด้วย apigeereleasever=4.16.01
หรือ apigeereleasever=4.16.05 ดังนี้
> apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install --only-new-rpms this - ตรวจสอบไดเรกทอรี /opt/apigee/data/apigee-mirror/repos
เพื่อดูโครงสร้างไฟล์ ดังนี้
> ls /opt/apigee/data/apigee-mirror/repos
คุณควรเห็นไฟล์และไดเรกทอรีต่อไปนี้
apigee apigee-repo-1.0-6.x86_64.rpm Notification
นอกจากนี้ ไดเรกทอรี apigee จะมีไดเรกทอรีแยกกันสำหรับ Edge แต่ละเวอร์ชันด้วย - หากต้องการทำแพ็กเกจที่เก็บในไฟล์ .tar ให้ใช้คำสั่งต่อไปนี้
> apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
คำสั่งนี้จะรวบรวมทั้งไฟล์ 4.17.01 และ 4.16.0x repos ไว้ในไฟล์ .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