Edge for Private Cloud نسخه ۴.۱۸.۰۱
برای نصب Edge در گره، ابتدا ابزار کمکی apigee-setup مربوط به Edge را نصب میکنید. اگر در محیطی هستید که گرههایتان اتصال اینترنت خارجی ندارند، باید نسخه محلی مخزن Apigee را نیز نصب کنید.
دایرکتوری نصب پیشفرض: /opt/apigee
Edge همه فایلها را در فهرست راهنمای /opt/apigee نصب میکند. نمیتوانید این فهرست راهنما را تغییر دهید. بااینحال، درصورت تمایل میتوانید پیوند نمادینی برای نگاشت /opt/apigee به مکان دیگری ایجاد کنید. برای اطلاعات بیشتر، به الزامات نصب مراجعه کنید.
پیشنیاز: غیرفعال کردن SELinux
قبلاز اینکه بتوانید ابزار کمکی apigee-setup Edge یا هر مؤلفه Edge دیگری را نصب کنید، باید SELinux را غیرفعال کنید یا آن را روی حالت مجاز تنظیم کنید. درصورت لزوم، پساز نصب Edge، میتوانید SELinux را دوباره فعال کنید.
- برای تنظیم موقت SELinux روی حالت مجاز، فرمان زیر را اجرا کنید:
- در سیستمعامل Linux 6.x:
sudo echo 0 > /selinux/enforce
برای فعال کردن مجدد SELinux پساز نصب Edge:
sudo echo 1 > /selinux/enforce - در سیستمعامل Linux 7.x:
sudo setenforce 0
برای فعال کردن مجدد SELinux پساز نصب Edge:
sudo setenforce 1
- در سیستمعامل Linux 6.x:
- برای غیرفعال کردن دائمی SELinux یا تنظیم آن روی حالت مجاز:
- /etc/sysconfig/selinux را در ویرایشگر باز کنید.
- SELINUX=disabled یا SELINUX=permissive را تنظیم کنید
- ویرایشهایتان را ذخیره کنید.
- گره را بازراهاندازی کنید.
- درصورت لزوم، پساز نصب Edge، با تکرار این روال برای تنظیم SELINUX=enabled، SELinux را دوباره فعال کنید.
پیشنیاز: فعال کردن مخزن EPEL
برای نصب یا بهروزرسانی Edge، یا برای ایجاد مخزن محلی، باید بستههای اضافی برای Enterprise Linux (یا EPEL) را فعال کنید. فرمانی که استفاده میکنید به نسخه RedHat/CentOS شما بستگی دارد:
- برای RedHat/CentOS/Oracle 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/Oracle 6.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; sudo rpm -ivh epel-release-latest-6.noarch.rpm
پیشنیاز: بررسی نسخه کتابخانه libdb4 در RedHat 7.4 و CentOS 7.4
در RedHat 7.4 و CentOS 7.4، پیشاز نصب، نسخه RPMهای libdb4 را بررسی کنید. Edge به نسخه ۴.۸ نیاز دارد و برخیاز نسخههای RedHat 7.4 و CentOS 7.4 با نسخه جدیدتری عرضه میشوند. اگر نسخه جدیدتری دارید، آن را حذف نصب کنید و سپس نصبکننده Edge نسخه ۴.۸ را نصب خواهد کرد.
میتوانید از فرمان زیر برای بررسی نسخه خود استفاده کنید:
> rpm -qa | grep libdb4
اگر میبینید که نسخه RPM libdb4 جدیدتر از نسخه 4.8 است، آن را حذف نصب کنید.
ابزار کمکی apigee-setup مربوط به Edge را در گرهی با اتصال اینترنت خارجی نصب کنید
برای نصب Edge در گرهای با اتصال اینترنت خارجی:
- نام کاربری و گذرواژهای را که برای دسترسی به مخزن Apigee استفاده میکنید از Apigee دریافت کنید. اگر نام کاربری:گذرواژه موجودی برای سایت ftp مربوط به Apigee دارید، میتوانید از آن اطلاعات اعتباری استفاده کنید.
- بهعنوان ریشه به گره خود وارد شوید تا Edge RPM را نصب کنید
توجه: اگرچه نصب RPM به دسترسی ریشه نیاز دارد، میتوانید پیکربندی Edge را بدون دسترسی ریشه انجام دهید. - yum-utils و
yum-plugin-priorities را نصب کنید:
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities - SELinux را همانطور که در بالا توضیح داده شد غیرفعال کنید.
- مخزن EPEL را طبق توضیحات بالا فعال کنید.
- نسخه libdb4 خود را همانطور که در بالا توضیح داده شده است بررسی کنید.
- اگر درحال نصب روی Oracle 7.x هستید، فرمان زیر را اجرا کنید:
> sudo yum-config-manager --enable ol7_optional_latest - اگر در AWS نصب میکنید، فرمانهای yum-configure-manager زیر را اجرا کنید:
> yum update rh-amazon-rhui-client.noarch
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional - Download the Edge bootstrap_4.18.01.sh file to /tmp/bootstrap_4.18.01.sh:
> curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh - Install the Edge apigee-service utility and dependencies:
> sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord
where uName:pWord are the username and password you received from 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 در گره مراجعه کنید.
نصب کردن Edge برنامه کمکی apigee-setup در گرهای بدون اتصال اینترنت خارجی
اگر گرههای Edge شما پشت دیوار آتش هستند یا به هر دلیل دیگری نمیتوانند ازطریق اینترنت به مخزن Apigee دسترسی داشته باشند، باید مخزن محلی یا آینهای از مخزن Apigee ایجاد کنید. سپس آن آینه باید برای همه گرهها دردسترس باشد. پساز ایجاد، گرهها میتوانند برای نصب Edge به آن آینه محلی دسترسی پیدا کنند.
برای ایجاد مخزن Apigee داخلی، به گرهای با دسترسی به اینترنت خارجی نیاز دارید تا بتوانید RPMهای Edge و وابستگیها را بارگیری کنید. پساز ایجاد مخزن داخلی، میتوانید آن را به گره دیگری منتقل کنید یا آن گره را برای نصب در گرههای Edge دردسترس قرار دهید.
توجه: Apigee همه وابستگیهای شخص ثالث را در مخازن عمومی ما میزبانی نمیکند. باید این وابستگیها را از مخازن دردسترس عموم بارگیری و نصب کنید.
پساز ایجاد مخزن Edge محلی، ممکن است بعداً لازم باشد آن را با جدیدترین فایلهای نسخه Edge بهروز کنید. بخشهای زیر نحوه ایجاد مخزن محلی و نحوه بهروزرسانی آن را شرح میدهد.
ایجاد مخزن Apigee محلی
برای ایجاد مخزن Apigee محلی:
- نام کاربری و گذرواژهای را که برای دسترسی به مخزن Apigee استفاده میکنید از Apigee دریافت کنید. اگر نام کاربری:گذرواژه موجودی برای سایت ftp مربوط به Apigee دارید، میتوانید از آن اطلاعات اعتباری استفاده کنید.
- برای نصب Edge RPM، بهعنوان root به سیستم گره وارد شوید.
توجه: اگرچه نصب RPM به دسترسی ریشه نیاز دارد، میتوانید پیکربندی Edge را بدون دسترسی ریشه انجام دهید. - SELinux را همانطور که در بالا توضیح داده شد غیرفعال کنید.
- Download the Edge bootstrap_4.18.01.sh file to /tmp/bootstrap_4.18.01.sh:
> curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh - ابزار کمکی Edge apigee-service و وابستگیها را نصب کنید:
> sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord
که در آن uName:pWord نام کاربری و گذرواژهای است که از Apigee دریافت کردهاید. اگر pWord را حذف کنید، از شما خواسته میشود آن را وارد کنید. - Install the apigee-mirror
utility on the node:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
Note: If you are updating an existing repo to 4.18.01, you only have to update apigee-mirror:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update - از ابزار کمکی apigee-mirror
برای همگامسازی مخزن Apigee با دایرکتوری /opt/apigee/data/apigee-mirror/repos/
استفاده کنید.
برای بهحداقل رساندن اندازه مخزن، --only-new-rpms را اضافه کنید تا فقط جدیدترین RPMها بارگیری شود. برای بارگیری به تقریباً ۱٫۶ گیگابایت فضای دیسک نیاز دارید:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
اگر میخواهید کل مخزن را، ازجمله RPMهای قدیمیتر، بارگیری کنید، --only-new-rpms را حذف کنید. برای بارگیری کامل به حدود ۶ گیگابایت فضای دیسک نیاز دارید:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync
اکنون یک نسخه محلی از مخزن Apigee دارید. بخش بعدی نحوه نصب ابزار کمکی Edge apigee-setup را از مخزن محلی شرح میدهد. -
(اختیاری) اگر میخواهید Edge را از مخزن محلی در همان گرهای که مخزن محلی را میزبانی میکند نصب کنید، باید ابتدا فرمانهای زیر را اجرا کنید:
- bootstrap_4.18.01.sh را از مخزن محلی اجرا کنید تا ابزار apigee-service نصب شود:
> sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.18.01.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.18.01.sh را از مخزن محلی اجرا کنید تا ابزار apigee-service نصب شود:
نصب apigee-setup در گره از راه دور از مخزن محلی
دو گزینه برای نصب Edge از مخزن محلی دارید. یا میتوانید:
- فایل tar .از مخزن ایجاد کنید، فایل tar .را در گره کپی کنید، و سپس Edge را از فایل tar .نصب کنید.
- یک وبسرور روی گره با مخزن محلی نصب کنید تا گرههای دیگر بتوانند به آن دسترسی داشته باشند. Apigee وبسرور Nginx را برای استفاده شما ارائه میدهد، یا میتوانید از وبسرور خودتان استفاده کنید.
نصب از فایل tar.:
- On the node with the local repo, use the following command to package the local repo into a
single .tar file named /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package - فایل tar .را در گرهای که میخواهید Edge را نصب کنید کپی کنید. برای مثال، آن را در دایرکتوری /tmp در گره جدید کپی کنید.
- در گره جدید، SELinux را همانطور که در بالا توضیح داده شد غیرفعال کنید.
- در گره جدید، EPEL repo را همانطور که در بالا توضیح داده شد فعال کنید.
- در گره جدید، مطمئن شوید که همه مخازن اینترنت خارجی را غیرفعال کردهاید.
وقتی فرمان زیر را اجرا میکنید، همه مخازن خارجی باید بهعنوان غیرفعال نشان داده شوند،
اما مخزن Apigee محلی و هرکدام از مخازن داخلی شما باید فعال باشند:
> sudo yum repolist - در گره جدید، yum-utils و yum-plugin-priorities را نصب کنید:
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities - در گره جدید، نسخه libdb4 خود را طبق توضیحات بالا بررسی کنید.
- اگر درحال نصب روی Oracle 7.x هستید، فرمان زیر را اجرا کنید:
> sudo yum-config-manager --enable ol7_optional_latest - اگر در AWS نصب میکنید، فرمان yum-configure-manager زیر را اجرا کنید:
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional - در گره جدید، فایل را در دایرکتوری /tmp از حالت tar خارج کنید:
> tar -xzf apigee-4.18.01.tar.gz
این فرمان دایرکتوری جدیدی بهنام repos در دایرکتوری حاوی فایل tar .ایجاد میکند. برای مثال /tmp/repos. - Install the Edge apigee-service utility and dependencies from /tmp/repos:
> sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Notice that you include the path to the repos directory in this command. - از 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 بهعنوان نام سرور و درگاه ۳۹۳۹ استفاده کند. برای
تغییر دادن این مقادیر
- /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 - در گره جدید، yum-utils و yum-plugin-priorities را نصب کنید:
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities - در گره جدید، SELinux را همانطور که در بالا توضیح داده شد غیرفعال کنید.
- در گره جدید، EPEL repo را همانطور که در بالا توضیح داده شد فعال کنید.
- در گره جدید، نسخه libdb4 خود را طبق توضیحات بالا بررسی کنید.
- On the remote node, download the Edge bootstrap_4.18.01.sh file to /tmp/bootstrap_4.18.01.sh:
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
where uName:pWord are the username and password you set above for the repo, and remoteRepo is the IP address or DNS name of the repo node. - On the remote node, install the Edge apigee-service utility and dependencies:
> sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
where uName:pWord are the repo username and password. - در گره راه دور، از apigee-service برای نصب ابزار apigee-setup استفاده کنید:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install - از apigee-setup برای نصب و پیکربندی مؤلفههای Edge در گره دور استفاده کنید. برای اطلاعات بیشتر، به نصب مؤلفههای Edge در گره مراجعه کنید.
بهروزرسانی مخزن Apigee محلی
برای بهروزرسانی مخزن، باید جدیدترین فایل bootstrap_4.18.01.sh را بارگیری کنید، سپس همگامسازی جدیدی انجام دهید:
- فایل Edge bootstrap_4.18.01.sh را در /tmp/bootstrap_4.18.01.sh بارگیری کنید:
> curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh - فایل Edge bootstrap_4.18.01.sh را اجرا کنید:
> sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord
که در آن uName:pWord نام کاربری و گذرواژهای است که از Apigee دریافت کردهاید. اگر pWord را حذف کنید، از شما خواسته میشود آن را وارد کنید. - apigee-mirror را بهروز کنید:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update - همگامسازی را انجام دهید:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms - If you want to entire repo:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync
پاک کردن مخزن Apigee محلی
Cleaning the local repo deletes /opt/apigee/data/apigee-mirror and /var/tmp/yum-apigee-*.
برای پاک کردن مخزن محلی، از این دستور استفاده کنید:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror cleanافزودن یا بهروزرسانی Edge 4.16.0x/4.17.0x در مخزن 4.18.01
اگر باید نصبهای Edge 4.16.0x یا 4.17.0x را در مخزن 4.18.01 حفظ کنید، میتوانید مخزنی را حفظ کنید که شامل همه نسخهها باشد. سپس از آن مخزن میتوانید هر نسخهای از Edge را نصب کنید.
برای افزودن 4.16.0x/4.17.0x به مخزن 4.18.01:
- مطمئن شوید که نسخه 4.18.01 ابزار کمکی apigee-mirror را نصب کردهاید:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version
باید نتیجهای به شکل زیر ببینید که در آن xyz شماره ساخت است:
apigee-mirror-4.18.01-0.0.xyz - از ابزار کمکی apigee-mirror
برای بارگیری Edge 4.16.0x/4.17.0x در مخزن خود استفاده کنید. توجه کنید که چگونه پیشوند فرمان را با
نسخه موردنظر وارد میکنید:
> apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
از همین فرمان برای بهروزرسانی مخازن 4.16.0x/4.17.0x در آینده با مشخص کردن شمارههای نسخه موردنیاز استفاده کنید. - Examine the /opt/apigee/data/apigee-mirror/repos
directory to see the file structure:
> ls /opt/apigee/data/apigee-mirror/repos
You should see the following files and directories:
apigee apigee-repo-1.0-6.x86_64.rpm bootstrap_4.16.01.sh bootstrap_4.16.05.shbootstrap_4.17.01.sh bootstrap_4.17.05.sh bootstrap_4.17.09.sh bootstrap_4.18.01.sh thirdparty
Notice how you have a bootstrap file for all versions of Edge. دایرکتوری apigee همچنین حاوی دایرکتوریهای جداگانهای برای هر نسخه از Edge است. - برای بستهبندی کردن مخزن در فایل tar.، از فرمان زیر استفاده کنید:
> apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
این فرمان همه مخزنهای 4.17.0x و 4.16.0x را در یک فایل tar .بستهبندی میکند. نمیتوانید فقط بخشی از مخزن را بستهبندی کنید.
برای نصب Edge از مخزن محلی یا فایل tar.، فقط مطمئن شوید که فایل راهانداز صحیح را بااستفاده از یکی از فرمانهای زیر اجرا میکنید. این مثال Edge 4.17.01 را نصب میکند:
- If installing from a .tar file, run the correct bootstrap file from the repo:
> sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
To complete the installation, follow the remaining steps from "Install from the .tar file" above. - اگر بااستفاده از وبسرور Nginx نصب میکنید، فایل راهاندازی صحیح را از مخزن بارگیری و سپس اجرا کنید:
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
> sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
برای تکمیل نصب، مراحل باقیمانده را از بخش «نصب از مخزن بااستفاده از وبسرور Nginx» در بالا دنبال کنید.