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

Edge for Private Cloud نسخه ۴.۱۸.۰۵

برای نصب Edge در گره، ابتدا ابزار کمکی apigee-setup مربوط به Edge را نصب می‌کنید. اگر در محیطی هستید که گره‌هایتان اتصال اینترنت خارجی ندارند، باید نسخه محلی مخزن Apigee را نیز نصب کنید.

دایرکتوری نصب پیش‌فرض: /opt/apigee

Edge همه فایل‌ها را در دایرکتوری /opt/apigee نصب می‌کند. نمی‌توانید این فهرست راهنما را تغییر دهید. بااین‌حال، درصورت تمایل می‌توانید پیوند نمادینی برای نگاشت /opt/apigee به مکان دیگری ایجاد کنید. برای اطلاعات بیشتر، به الزامات نصب مراجعه کنید.

پیش‌نیاز: غیرفعال کردن SELinux

قبل‌از نصب ابزار Edge apigee-setup یا هریک از مؤلفه‌های Edge باید SELinux را غیرفعال کنید یا آن را روی حالت مجاز تنظیم کنید. درصورت لزوم، پس‌از نصب Edge، می‌توانید SELinux را دوباره فعال کنید.

  • برای تنظیم موقت SELinux روی حالت مجاز، فرمان زیر را اجرا کنید:
    1. در سیستم‌عامل Linux 6.x: 
      sudo echo 0 > /selinux/enforce

      برای فعال کردن مجدد SELinux پس‌از نصب Edge:

      sudo echo 1 > /selinux/enforce
    2. در سیستم‌عامل Linux 7.x: 
      sudo setenforce 0

      برای فعال کردن مجدد SELinux پس‌از نصب Edge:

      sudo setenforce 1
  • برای غیرفعال کردن دائمی SELinux یا تنظیم آن روی حالت مجاز:
    1. /etc/sysconfig/selinux را در ویرایشگر باز کنید.
    2. تنظیم کردن SELINUX=disabled یا SELINUX=permissive
    3. ویرایش‌هایتان را ذخیره کنید.
    4. گره را بازراه‌اندازی کنید.
    5. درصورت لزوم، SELinux را پس‌از نصب Edge با تکرار این رویه برای تنظیم SELINUX=enabled دوباره فعال کنید.

پیش‌نیاز: فعال کردن مخزن 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، پیش‌از نصب، نسخه libdb4 RPM را بررسی کنید. ‫Edge به نسخه ۴.۸ نیاز دارد و برخی‌از نسخه‌های RedHat 7.4 و CentOS 7.4 با نسخه جدیدتری عرضه می‌شوند. اگر نسخه جدیدتری دارید، آن را حذف نصب کنید و سپس نصب‌کننده Edge نسخه ۴.۸ را نصب خواهد کرد.

می‌توانید از فرمان زیر برای بررسی نسخه خود استفاده کنید:

rpm -qa | grep libdb4

اگر دیدید که نسخه libdb4 RPM جدیدتر از نسخه ۴.۸ است، آن را حذف نصب کنید.

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

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

  1. نام کاربری و گذرواژه‌ای را که برای دسترسی به مخزن Apigee استفاده می‌کنید از Apigee دریافت کنید. اگر نام کاربری:گذرواژه موجودی برای سایت ftp مربوط به Apigee دارید، می‌توانید از آن اطلاعات اعتباری استفاده کنید.
  2. برای نصب Edge RPM، به‌عنوان ریشه به گره خود وارد شوید
  3. yum-utils و yum-plugin-priorities را نصب کنید: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. SELinux را همان‌طور که در بالا توضیح داده شد غیرفعال کنید.
  5. مخزن EPEL را طبق توضیحات بالا فعال کنید.
  6. نسخه libdb4 را همان‌طور که در بالا توضیح داده شده است بررسی کنید.
  7. اگر درحال نصب روی Oracle 7.x هستید، فرمان زیر را اجرا کنید: 
    sudo yum-config-manager --enable ol7_optional_latest
  8. اگر در 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
  9. فایل Edge bootstrap_4.18.05.sh را در /tmp/bootstrap_4.18.05.sh بارگیری کنید: 
    curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  10. ابزار کمکی apigee-service و وابستگی‌های Edge را نصب کنید: 
    sudo bash /tmp/bootstrap_4.18.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*'
  11. از apigee-service برای نصب ابزار apigee-setup استفاده کنید:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  12. از apigee-setup برای نصب و پیکربندی مؤلفه‌های Edge در گره استفاده کنید. برای اطلاعات بیشتر، به نصب مؤلفه‌های Edge در گره مراجعه کنید.

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

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

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

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

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

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

  1. نام کاربری و گذرواژه‌ای را که برای دسترسی به مخزن Apigee استفاده می‌کنید از Apigee دریافت کنید. اگر نام کاربری:گذرواژه موجودی برای سایت ftp‏ Apigee دارید، می‌توانید از آن اطلاعات اعتباری استفاده کنید.
  2. برای نصب Edge RPM، به‌عنوان root به سیستم گره وارد شوید.
  3. SELinux را همان‌طور که در بالا توضیح داده شد غیرفعال کنید.
  4. فایل Edge bootstrap_4.18.05.sh را در /tmp/bootstrap_4.18.05.sh بارگیری کنید: 
    curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  5. ابزار کمکی Edge apigee-service و وابستگی‌ها را نصب کنید: 
    sudo bash /tmp/bootstrap_4.18.05.sh apigeeuser=uName apigeepassword=pWord

    که uName:pWord نام کاربری و گذرواژه‌ای است که از Apigee دریافت کرده‌اید. اگر pWord را حذف کنید، از شما خواسته می‌شود آن را وارد کنید.

  6. برنامه کمکی apigee-mirror را در گره نصب کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
  7. از ابزار کمکی 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 را از مخزن محلی شرح می‌دهد.

  8. (اختیاری) اگر می‌خواهید Edge را از مخزن محلی روی همان گرهی که مخزن محلی را میزبانی می‌کند نصب کنید، باید ابتدا فرمان‌های زیر را اجرا کنید:
    1. bootstrap_4.18.05.sh را از مخزن محلی اجرا کنید تا ابزار کمکی apigee-service نصب شود: 
      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.18.05.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. در گره با مخزن محلی، از فرمان زیر برای بسته‌بندی مخزن محلی در یک فایل ‎ .tar با نام /opt/apigee/data/apigee-mirror/apigee-4.18.05.tar.gz استفاده کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
  2. فایل tar .را در گره‌ای که می‌خواهید Edge را نصب کنید کپی کنید. برای مثال، آن را در دایرکتوری /tmp در گره جدید کپی کنید.
  3. در گره جدید، SELinux را همان‌طور که در بالا توضیح داده شد غیرفعال کنید.
  4. در گره جدید، مخزن EPEL را همان‌طور که در بالا توضیح داده شد فعال کنید.
  5. در گره جدید، مطمئن شوید که همه مخازن اینترنت خارجی را غیرفعال کرده‌اید. وقتی فرمان زیر را اجرا می‌کنید، همه مخازن خارجی باید به‌عنوان غیرفعال نشان داده شوند، اما مخزن Apigee محلی و هرکدام از مخازن داخلی شما باید فعال باشند: 
    sudo yum repolist
  6. در گره جدید، yum-utils و yum-plugin-priorities را نصب کنید: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  7. در گره جدید، نسخه libdb4 خود را طبق توضیحات بالا بررسی کنید.
  8. اگر درحال نصب روی Oracle 7.x هستید، فرمان زیر را اجرا کنید: 
    sudo yum-config-manager --enable ol7_optional_latest
  9. اگر در AWS نصب می‌کنید، فرمان زیر را اجرا کنید: yum-configure-manager 
    sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  10. در گره جدید، فایل را در دایرکتوری /tmp از حالت tar خارج کنید: 
    tar -xzf apigee-4.18.05.tar.gz

    این فرمان فهرست راهنمای جدیدی به‌نام repos در فهرست راهنمای حاوی فایل .tar ایجاد می‌کند. برای مثال /tmp/repos.

  11. Install the Edge apigee-service utility and dependencies from /tmp/repos: 
    sudo bash /tmp/repos/bootstrap_4.18.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    توجه داشته باشید که مسیر دایرکتوری repos را در این فرمان اضافه می‌کنید.

  12. از apigee-service برای نصب ابزار apigee-setup استفاده کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  13. از 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. در گره جدید، yum-utils و yum-plugin-priorities را نصب کنید: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  5. در گره جدید، SELinux را همان‌طور که در بالا توضیح داده شد غیرفعال کنید.
  6. در گره جدید، EPEL repo را همان‌طور که در بالا توضیح داده شد فعال کنید.
  7. در گره جدید، نسخه libdb4 خود را طبق توضیحات بالا بررسی کنید.
  8. در گره راه دور، فایل Edge bootstrap_4.18.05.sh را در /tmp/bootstrap_4.18.05.sh بارگیری کنید: 
    curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh

    که uName:pWord نام کاربری و گذرواژه‌ای است که در بالا برای مخزن تنظیم کرده‌اید و remoteRepo نشانی IP یا نام ساناد گره مخزن است.

  9. در گره راه دور، ابزار کمکی Edge apigee-service و وابستگی‌ها را نصب کنید: 
    sudo bash /tmp/bootstrap_4.18.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    که uName:pWord نام کاربری و گذرواژه مخزن است.

  10. در گره ازراه‌دور، از apigee-service برای نصب ابزار کمکی apigee-setup استفاده کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  11. از apigee-setup برای نصب و پیکربندی مؤلفه‌های Edge در گره دور استفاده کنید. برای اطلاعات بیشتر، به نصب مؤلفه‌های Edge در گره مراجعه کنید.

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

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

  1. فایل bootstrap_4.18.05.sh مربوط به Edge را در /tmp/bootstrap_4.18.05.sh بارگیری کنید: 
    curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  2. فایل Edge bootstrap_4.18.05.sh را اجرا کنید: 
    sudo bash/tmp/bootstrap_4.18.05.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.0x/4.17.0x در مخزن 4.18.05

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

برای افزودن 4.16.0x/4.17.0x به مخزن 4.18.05:

  1. مطمئن شوید که نسخه 4.18.05 از ابزار apigee-mirror را نصب کرده‌اید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

    باید نتیجه‌ای به شکل زیر ببینید که در آن xyz شماره ساخت است:

    apigee-mirror-4.18.05-0.0.xyz
  2. از ابزار کمکی 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 در آینده با مشخص کردن شماره‌های نسخه موردنیاز استفاده کنید.

  3. دایرکتوری /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
bootstrap_4.17.01.sh
bootstrap_4.17.05.sh
bootstrap_4.17.09.sh
bootstrap_4.18.05.sh
thirdparty

    توجه کنید که چگونه برای همه نسخه‌های Edge فایل راه‌انداز دارید. فهرست راهنمای apigee همچنین حاوی فهرست‌های راهنمای جداگانه برای هر نسخه از Edge است.

  4. برای بسته‌بندی مخزن در فایل 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 را نصب می‌کند:

  • اگر از فایل tar .نصب می‌کنید، فایل راه‌انداز صحیح را از مخزن اجرا کنید:
    sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    برای تکمیل نصب، مراحل باقی‌مانده را از «نصب از فایل tar.» در بالا دنبال کنید.

  • اگر بااستفاده از وب‌سرور 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» در بالا دنبال کنید.