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

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

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

درحال ایجاد پیوند نمادین از opt /apigee/

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

قبل‌از ایجاد پیوند نمادین، ابتدا باید کاربر و گروهی با نام «apigee» ایجاد کنید. این همان گروه و کاربری است که توسط نصب‌کننده Edge ایجاد شده است.

برای ایجاد پیوند نمادین، این مراحل را قبل‌از بارگیری فایل bootstrap_4.16.05.sh انجام دهید. باید همه این مراحل را به‌عنوان root انجام دهید:

  1. Create the "apigee" user and group:
    > groupadd -r apigee
    > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee
  2. یک پیوند نمادین از /opt/apigee به ریشه نصب موردنظر خود ایجاد کنید:
    > ln -Ts /srv/myInstallDir /opt/apigee
    که در آن /srv/myInstallDir مکان موردنظر برای فایل‌های Edge است.
  3. Change ownership of the install root and symlink to the "apigee" user:
    > chown -h apigee:apigee /srv/myInstallDir /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 را دوباره فعال کنید.

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

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

  1. نام کاربری و گذرواژه‌ای را که برای دسترسی به مخزن Apigee استفاده می‌کنید از Apigee دریافت کنید. اگر نام کاربری:گذرواژه موجودی برای سایت ftp مربوط به Apigee دارید، می‌توانید از آن اطلاعات اعتباری استفاده کنید.
  2. به‌عنوان ریشه به گره خود وارد شوید تا Edge RPM را نصب کنید
    توجه: اگرچه نصب RPM به دسترسی ریشه نیاز دارد، می‌توانید پیکربندی Edge را بدون دسترسی ریشه انجام دهید.
  3. SELinux را همان‌طور که در بالا توضیح داده شد غیرفعال کنید.
  4. Download the Edge bootstrap_4.16.05.sh file to /tmp/bootstrap_4.16.05.sh:
    > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  5. برنامه کمکی Edge apigee-service و وابستگی‌ها را نصب کنید:
    > sudo bash /tmp/bootstrap_4.16.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*'
  6. از apigee-service برای نصب ابزار کمکی apigee-setup استفاده کنید:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  7. از apigee-setup برای نصب و پیکربندی مؤلفه‌های Edge در گره استفاده کنید. برای اطلاعات بیشتر، به نصب مؤلفه‌های Edge در گره مراجعه کنید.

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

اگر گره‌های Edge شما پشت دیوار آتش هستند یا به هر دلیل دیگری نمی‌توانند ازطریق اینترنت به مخزن Apigee دسترسی داشته باشند، باید مخزن محلی یا آینه‌ای از مخزن Apigee ایجاد کنید. سپس آن آینه باید برای همه گره‌ها دردسترس باشد. پس‌از ایجاد، گره‌ها می‌توانند برای نصب 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. فایل Edge bootstrap_4.16.05.sh را در /tmp/bootstrap_4.16.05.sh بارگیری کنید:
    > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  6. ابزار کمکی apigee-service و وابستگی‌های Edge را نصب کنید:
    > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord

    که در آن uName:pWord نام کاربری و گذرواژه‌ای است که از Apigee دریافت کرده‌اید. اگر pWord را حذف کنید، از شما خواسته می‌شود آن را وارد کنید.
  7. برنامه کمکی apigee-mirror را در گره نصب کنید:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
  8. از ابزار کمکی 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 را از مخزن محلی شرح می‌دهد.
  9. (اختیاری) اگر می‌خواهید Edge را از مخزن محلی در همان گره‌ای که مخزن محلی را میزبانی می‌کند نصب کنید، باید ابتدا فرمان‌های زیر را اجرا کنید:
    1. Run bootstrap_4.16.05.sh from the local repo to install the apigee-service utility:
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.16.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. 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.16.05.tar.gz:

    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
  2. فایل tar .را در گره‌ای که می‌خواهید Edge را نصب کنید کپی کنید. برای مثال، آن را در دایرکتوری /tmp در گره جدید کپی کنید.
  3. در گره جدید، SELinux را همان‌طور که در بالا توضیح داده شد غیرفعال کنید.
  4. در گره جدید، فایل را در دایرکتوری /tmp از حالت فشرده خارج کنید:
    > tar -xzf apigee-4.16.05.tar.gz

    این فرمان دایرکتوری جدیدی به‌نام repos در دایرکتوری حاوی فایل .tar ایجاد می‌کند. برای مثال /tmp/repos.
  5. ابزار کمکی apigee-service در Edge و وابستگی‌ها را از /tmp/repos نصب کنید:
    > sudo bash /tmp/repos/bootstrap_4.16.05.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. در گره راه دور، فایل Edge bootstrap_4.16.05.sh را در /tmp/bootstrap_4.16.05.sh بارگیری کنید:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh

    که در آن uName:pWord نام کاربری و گذرواژه‌ای است که در بالا برای مخزن تنظیم کرده‌اید، و remoteRepo نشانی IP یا نام DNS گره مخزن است.
  6. در گره راه دور، ابزار Edge apigee-service و وابستگی‌ها را نصب کنید:
    > sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    که در آن uName:pWord نام کاربری و گذرواژه مخزن هستند.
  7. در گره راه دور، از apigee-service برای نصب ابزار apigee-setup استفاده کنید:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. از apigee-setup برای نصب و پیکربندی مؤلفه‌های Edge در گره دور استفاده کنید. برای اطلاعات بیشتر، به نصب مؤلفه‌های Edge در گره مراجعه کنید.

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

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

  1. فایل Edge bootstrap_4.16.05.sh را در /tmp/bootstrap_4.16.05.sh بارگیری کنید:
    > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  2. همگام‌سازی را انجام دهید:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
  3. اگر می‌خواهید کل مخزن را بارگیری کنید:
    > /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

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

برای افزودن نسخه ۴.۱۶.۰۱ به مخزن نسخه ۴.۱۵.۰۵:

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

    باید نتیجه‌ای به شکل زیر ببینید که در آن xyz شماره ساخت است:
    apigee-mirror-4.16.05-0.0.xyz
  2. از ابزار کمکی apigee-mirror برای بارگیری Edge 4.16.01 در مخزن خود استفاده کنید. Notice how you prefix the command with apigeereleasever=4.16.01:
    > 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.01 repo.
  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 thirdparty

    توجه کنید که چگونه برای هر دو نسخه Edge یک فایل bootstrap دارید. دایرکتوری apigee همچنین حاوی دایرکتوری‌های جداگانه‌ای برای هر نسخه از Edge است.
  4. برای بسته‌بندی مخزن در فایل tar.، از فرمان زیر استفاده کنید:
    > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

    این فرمان هر دو مخزن 4.16.05 و 4.16.01 را در یک فایل 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.