نصب ابزار Edge apigee-setup

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 روی حالت مجاز، فرمان زیر را اجرا کنید:
  1. در سیستم‌عامل Linux 6.x:
     echo 0 > /selinux/enforce
     
     برای فعال کردن مجدد SELinux پس‌از نصب Edge:
     echo 1 > /selinux/enforce
  2. در سیستم‌عامل Linux 7.x:
     setenforce 0
     
     برای فعال کردن مجدد SELinux پس‌از نصب Edge:
     setenforce 1
• برای غیرفعال کردن دائمی SELinux یا تنظیم آن روی حالت مجاز:
  1. /etc/sysconfig/selinux را در ویرایشگر باز کنید.
  2. SELINUX=disabled یا SELINUX=permissive را تنظیم کنید
  3. ویرایش‌هایتان را ذخیره کنید.
  4. گره را بازراه‌اندازی کنید.
  5. درصورت لزوم، پس‌از نصب Edge، با تکرار این روال برای تنظیم SELINUX=enabled،‏ SELinux را دوباره فعال کنید.

پیش‌نیاز: فعال کردن مخزن EPEL

برای نصب یا به‌روزرسانی Edge، باید بسته‌های اضافی برای Enterprise Linux (یا EPEL) را فعال کنید. فرمانی که استفاده می‌کنید به نسخه 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

ابزار کمکی apigee-setup مربوط به Edge را در گرهی با اتصال اینترنت خارجی نصب کنید

برای نصب Edge در گره‌ای با اتصال اینترنت خارجی:

1. نام کاربری و گذرواژه‌ای را که برای دسترسی به مخزن Apigee استفاده می‌کنید از Apigee دریافت کنید. اگر نام کاربری:گذرواژه موجودی برای سایت ftp مربوط به Apigee دارید، می‌توانید از آن اطلاعات اعتباری استفاده کنید.
2. به‌عنوان ریشه به گره خود وارد شوید تا Edge RPM را نصب کنید
   توجه: اگرچه نصب RPM به دسترسی ریشه نیاز دارد، می‌توانید پیکربندی Edge را بدون دسترسی ریشه انجام دهید.
3. SELinux را همان‌طور که در بالا توضیح داده شد غیرفعال کنید.
4. مخزن EPEL را طبق توضیحات بالا فعال کنید.
5. فایل Edge bootstrap_4.17.01.sh را در /tmp/bootstrap_4.17.01.sh بارگیری کنید:
   > curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
6. ‫Edge apigee-service utility و وابستگی‌ها را نصب کنید:
   > sudo bash /tmp/bootstrap_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 = خروج. برای این گزینه، باید Java را خودتان نصب کنید.
   
   نصب ابزار apigee-service فایل /etc/yum.repos.d/apigee.repo را ایجاد می‌کند که مخزن Apigee را تعریف می‌کند. برای مشاهده فایل تعریف، از این فرمان استفاده کنید:
   > cat /etc/yum.repos.d/apigee.repo
   
   برای مشاهده محتوای مخزن، از این فرمان استفاده کنید:
   > sudo yum -v repolist 'apigee*'
7. (فقط CentOS-6.x و RedHat-6.x) در همه گره‌های Qpid، دستور زیر را اجرا کنید تا مطمئن شوید نسخه صحیح Qpid را بارگیری می‌کنید:
   > yum install apigee-qpidd --disablerepo=epel
8. از apigee-service برای نصب ابزار کمکی apigee-setup استفاده کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
9. از apigee-setup برای نصب و پیکربندی مؤلفه‌های Edge در گره استفاده کنید. برای اطلاعات بیشتر، به نصب مؤلفه‌های Edge در گره مراجعه کنید.

نصب کردن Edge برنامه کمکی apigee-setup در گره‌ای بدون اتصال اینترنت خارجی

اگر گره‌های Edge شما پشت دیوار آتش هستند یا به هر دلیل دیگری نمی‌توانند ازطریق اینترنت به مخزن Apigee دسترسی داشته باشند، باید مخزن محلی یا آینه‌ای از مخزن Apigee ایجاد کنید. سپس آن آینه باید برای همه گره‌ها دردسترس باشد. پس‌از ایجاد، گره‌ها می‌توانند برای نصب Edge به آن آینه محلی دسترسی پیدا کنند.

برای ایجاد مخزن Apigee داخلی، به گره‌ای با دسترسی به اینترنت خارجی نیاز دارید تا بتوانید RPMهای Edge و وابستگی‌ها را بارگیری کنید. پس‌از ایجاد مخزن داخلی، می‌توانید آن را به گره دیگری منتقل کنید یا آن گره را برای نصب در گره‌های Edge دردسترس قرار دهید.

توجه: Apigee همه وابستگی‌های شخص ثالث را در مخازن عمومی ما میزبانی نمی‌کند. باید این وابستگی‌ها را از مخازن دردسترس عموم بارگیری و نصب کنید.

پس‌از ایجاد مخزن Edge محلی، ممکن است بعداً لازم باشد آن را با جدیدترین فایل‌های نسخه Edge به‌روز کنید. بخش‌های زیر نحوه ایجاد مخزن محلی و نحوه به‌روزرسانی آن را شرح می‌دهد.

ایجاد مخزن Apigee محلی

برای ایجاد مخزن Apigee محلی:

1. نام کاربری و گذرواژه‌ای را که برای دسترسی به مخزن Apigee استفاده می‌کنید از Apigee دریافت کنید. اگر نام کاربری:گذرواژه موجودی برای سایت ftp مربوط به Apigee دارید، می‌توانید از آن اطلاعات اعتباری استفاده کنید.
2. برای نصب RPMهای Edge، به‌عنوان کاربر root به گره RedHat یا CentOS خود وارد شوید.
   توجه: اگرچه نصب RPM به دسترسی ریشه نیاز دارد، می‌توانید پیکربندی Edge را بدون دسترسی ریشه انجام دهید.
3. مطمئن شوید که جدیدترین نسخه yum-utils را دارید:
   > sudo yum update yum-utils
4. SELinux را همان‌طور که در بالا توضیح داده شد غیرفعال کنید.
5. مخزن EPEL را طبق توضیحات بالا فعال کنید.
6. Download the Edge bootstrap_4.17.01.sh file to /tmp/bootstrap_4.17.01.sh:
   > curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
7. (فقط CentOS-6.x و RedHat-6.x) فرمان زیر را اجرا کنید تا مطمئن شوید نسخه صحیح Qpid را بارگیری می‌کنید:
   > yum install apigee-qpidd --disablerepo=epel
8. برنامه کمکی Edge apigee-service و وابستگی‌ها را نصب کنید:
   > sudo bash /tmp/bootstrap_4.17.01.sh apigeeuser=uName apigeepassword=pWord
   
   که در آن uName:pWord نام کاربری و گذرواژه‌ای است که از Apigee دریافت کرده‌اید. اگر pWord را حذف کنید، از شما خواسته می‌شود آن را وارد کنید.
9. 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.17.01, you only have to update apigee-mirror:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
10. از ابزار کمکی 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 را از مخزن محلی شرح می‌دهد.
11. (اختیاری) اگر می‌خواهید Edge را از مخزن محلی در همان گره‌ای که مخزن محلی را میزبانی می‌کند نصب کنید، باید ابتدا فرمان‌های زیر را اجرا کنید:
    1. bootstrap_4.17.01.sh را از مخزن محلی اجرا کنید تا ابزار apigee-service نصب شود:
       > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.17.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 از مخزن محلی دارید. یا می‌توانید:

• فایل tar .از مخزن ایجاد کنید، فایل tar .را در گره کپی کنید، و سپس Edge را از فایل tar .نصب کنید.
• یک وب‌سرور روی گره با مخزن محلی نصب کنید تا گره‌های دیگر بتوانند به آن دسترسی داشته باشند. Apigee وب‌سرور Nginx را برای استفاده شما ارائه می‌دهد، یا می‌توانید از وب‌سرور خودتان استفاده کنید.

نصب از فایل tar.:

1. 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.17.01.tar.gz:
   
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
2. فایل tar .را در گره‌ای که می‌خواهید Edge را نصب کنید کپی کنید. برای مثال، آن را در دایرکتوری /tmp در گره جدید کپی کنید.
3. در گره جدید، SELinux را همان‌طور که در بالا توضیح داده شد غیرفعال کنید.
4. در گره جدید، فایل را در دایرکتوری /tmp از حالت tar خارج کنید:
   > tar -xzf apigee-4.17.01.tar.gz
   
   این فرمان دایرکتوری جدیدی به‌نام repos در دایرکتوری حاوی فایل tar .ایجاد می‌کند. برای مثال /tmp/repos.
5. برنامه کمکی Edge apigee-service و وابستگی‌ها را از /tmp/repos نصب کنید:
   > sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
   
   توجه داشته باشید که مسیر دایرکتوری repos را در این فرمان اضافه کنید.
6. از apigee-service برای نصب ابزار apigee-setup استفاده کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
7. از apigee-setup برای نصب و پیکربندی مؤلفه‌های Edge در گره استفاده کنید. برای اطلاعات بیشتر، به نصب مؤلفه‌های Edge در گره مراجعه کنید.

نصب از مخزن بااستفاده از وب‌سرور Nginx:

1. وب‌سرور Nginx را روی گره مخزن نصب کنید:
   > opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
2. به‌طور پیش‌فرض، Nginx طوری پیکربندی شده است که از localhost به‌عنوان نام سرور و درگاه ۳۹۳۹ استفاده کند. برای تغییر دادن این مقادیر
   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. در گره جدید، SELinux را همان‌طور که در بالا توضیح داده شد غیرفعال کنید.
5. On the remote node, download the Edge bootstrap_4.17.01.sh file to /tmp/bootstrap_4.17.01.sh:
   > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.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.
6. On the remote node, install the Edge apigee-service utility and dependencies:
   > sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
   
   where uName:pWord are the repo username and password.
7. در گره راه دور، از apigee-service برای نصب ابزار apigee-setup استفاده کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
8. از apigee-setup برای نصب و پیکربندی مؤلفه‌های Edge در گره دور استفاده کنید. برای اطلاعات بیشتر، به نصب مؤلفه‌های Edge در گره مراجعه کنید.

به‌روزرسانی مخزن Apigee محلی

برای به‌روزرسانی مخزن، باید جدیدترین فایل bootstrap_4.17.01.sh را بارگیری کنید، سپس همگام‌سازی جدیدی انجام دهید:

1. فایل Edge bootstrap_4.17.01.sh را در /tmp/bootstrap_4.17.01.sh بارگیری کنید:
   > curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
2. فایل Edge bootstrap_4.17.01.sh را اجرا کنید:
   > sudo bash /tmp/bootstrap_4.17.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 محلی

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.01/4.16.05/4.16.09 در مخزن 4.17.01

اگر باید نصب‌های Edge 4.16.0x را در مخزن 4.17.01 حفظ کنید، می‌توانید مخزنی را حفظ کنید که شامل همه نسخه‌ها باشد. سپس از آن مخزن می‌توانید هر نسخه‌ای از Edge را نصب کنید.

برای افزودن 4.16.0x به مخزن 4.17.01:

1. Ensure that you have installed the 4.17.01 version of the apigee-mirror utility:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version
   
   You should see a result in the form below, where xyz is the build number:
   apigee-mirror-4.17.01-0.0.xyz
2. از ابزار کمکی apigee-mirror برای بارگیری Edge 4.16.01/4.16.05/4.16.09 در مخزن خود استفاده کنید. Notice how you prefix the command with apigeereleasever=4.16.01 or apigeereleasever=4.16.05:
   > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
   
   Use this same command to later update the 4.16.05/4.16.09 repos by specifying the required version numbers.
3. 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.sh bootstrap_4.17.01.sh thirdparty
   
   Notice how you have a bootstrap file for all versions of Edge. دایرکتوری apigee همچنین حاوی دایرکتوری‌های جداگانه‌ای برای هر نسخه از Edge است.
4. برای بسته‌بندی مخزن در یک فایل .tar، از فرمان زیر استفاده کنید:
   > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
   
   این فرمان هر دو مخزن 4.17.01 و 4.16.0x را در یک فایل .tar بسته‌بندی می‌کند. نمی‌توانید فقط بخشی از مخزن را بسته‌بندی کنید.

برای نصب Edge از مخزن محلی یا فایل tar.، فقط مطمئن شوید که فایل راه‌انداز صحیح را بااستفاده از یکی از فرمان‌های زیر اجرا می‌کنید:

• If installing from a .tar file, run the correct bootstrap file from the repo:
  > sudo bash /tmp/repos/bootstrap_4.16.0X.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  To complete the installation, follow the remaining steps from "Install from the .tar file" above.
• If installing using the Nginx webserver, download and then run the correct bootstrap file from the repo:
  > /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://
  
  To complete the installation, follow the remaining steps from "Install from the repo using the Nginx webserver" above.