ابزار Edge apigee-setup را نصب کنید

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

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

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

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

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

  • برای تنظیم موقت SELinux روی حالت مجاز، دستور زیر را اجرا کنید:
    • در سیستم عامل لینوکس 8.x :
      sudo setenforce 0

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

      sudo setenforce 1
    • در سیستم عامل لینوکس 7.x :
      sudo setenforce 0

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

      sudo setenforce 1
    • در سیستم عامل لینوکس 6.x :
      sudo echo 0 > /selinux/enforce

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

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

پیش نیاز: EPEL repo را فعال کنید

برای نصب یا به‌روزرسانی Edge یا ایجاد یک مخزن محلی، باید بسته‌های اضافی برای لینوکس سازمانی (یا EPEL) را فعال کنید. دستوری که استفاده می کنید به نسخه RedHat/CentOS شما بستگی دارد:

  • برای Red Hat Enterprise Linux (RHEL) 8.0، پیش نیازهای RHEL 8 را ببینید.

  • برای Red Hat/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
  • برای Red Hat/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
  • برای AWS-2:
    sudo amazon-linux-extras install epel -y
    sudo yum-config-manager --enable epel

پیش نیاز: نسخه کتابخانه libdb4 را در RedHat 7.4 و CentOS 7.4 بررسی کنید

در RedHat 7.4 و CentOS 7.4، قبل از نصب، نسخه RPM های libdb4 را بررسی کنید. Edge به نسخه 4.8 نیاز دارد و برخی از نسخه های RedHat 7.4 و CentOS 7.4 با نسخه بعدی عرضه می شوند. اگر نسخه بعدی دارید، آن را حذف نصب کنید و سپس نصب کننده Edge نسخه 4.8 را نصب خواهد کرد.

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

rpm -qa | grep libdb4

اگر مشاهده کردید که نسخه libdb4 RPM دیرتر از نسخه 4.8 است، آن را حذف نصب کنید.

پیش نیازهای RHEL 8

اگر Edge را روی سروری نصب می‌کنید که دارای Red Hat Enterprise Linux (RHEL) 8 است، قبل از نصب مراحل زیر را انجام دهید:

  1. فعال کردن بسته‌های اضافی برای لینوکس سازمانی (EPEL) :
    sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
  2. Postgres و NGINX:
    sudo dnf module disable postgresql
    sudo dnf module disable nginx
    غیرفعال کنید
  3. Python 2 را نصب کنید و یک سیم پیوند ایجاد کنید:
    sudo dnf install -y python2
    sudo ln -s /usr/bin/python2 /usr/bin/python

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

برای نصب Edge بر روی یک گره با اتصال اینترنت خارجی:

  1. نام کاربری و رمز عبوری را که برای دسترسی به مخزن Apigee استفاده می کنید، از Apigee دریافت کنید. اگر یک username:password برای سایت Apigee ftp دارید، می توانید از آن اعتبارنامه ها استفاده کنید.
  2. برای نصب Edge RPM به عنوان root وارد گره خود شوید
  3. yum-utils و yum-plugin-priorities نصب کنید:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities
  4. SELinux را غیرفعال کنید .
  5. مخزن EPEL را فعال کنید .
  6. نسخه libdb4 خود را بررسی کنید .
  7. اگر روی RHEL 8 نصب می کنید، مراحل پیش نیازهای RHEL 8 را دنبال کنید.
  8. اگر روی Oracle 7.x نصب می‌کنید، دستور زیر را اجرا کنید:
    sudo yum-config-manager --enable ol7_optional_latest
  9. اگر روی 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
  10. فایل Edge bootstrap_4.51.00.sh را در /tmp/bootstrap_4.51.00.sh دانلود کنید:
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  11. ابزار Edge apigee-service و وابستگی ها را نصب کنید:
    sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

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

    به طور پیش فرض، نصب کننده بررسی می کند که جاوا 1.8 را نصب کرده اید. اگر این کار را نکنید، آن را برای شما نصب می کند. از گزینه JAVA_FIX برای تعیین نحوه مدیریت نصب جاوا استفاده کنید. JAVA_FIX مقادیر زیر را می گیرد:

    • I: نصب OpenJDK 1.8 (پیش‌فرض)
    • ج: بدون نصب جاوا ادامه دهید
    • س: ترک برای این گزینه باید خود جاوا را نصب کنید.

    نصب ابزار apigee-service فایل /etc/yum.repos.d/apigee.repo را ایجاد می کند که مخزن Apigee را تعریف می کند. برای مشاهده فایل تعریف از دستور زیر استفاده کنید:

    cat /etc/yum.repos.d/apigee.repo

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

    sudo yum -v repolist 'apigee*'
  12. از apigee-service برای نصب ابزار apigee-setup استفاده کنید:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  13. از apigee-setup برای نصب و پیکربندی اجزای Edge در گره استفاده کنید. برای اطلاعات بیشتر به نصب اجزای Edge روی یک گره مراجعه کنید.

عیب یابی

هنگام تلاش برای نصب روی یک گره با اتصال اینترنت خارجی، ممکن است با یک یا چند خطای زیر مواجه شوید:

Cannot open: https:// : @ software.apigee.com//apigee-repo-version.rpm

bootstrap.sh: Error: Repo configuration failed

error: package package_name is not installed

جدول زیر برخی از وضوح های ممکن برای این خطاها را فهرست می کند:

نوع خطا وضوح ممکن
رمز عبور حاوی کاراکترهای بد است از کاراکترهای خاص در رمز عبور Apigee خود استفاده نکنید.
مشکلات اتصال

اتصال شبکه خود را با اجرای دستور ncat زیر تست کنید:

nc -v software.apigee.com 443

شما باید پیامی شبیه به زیر دریافت کنید:

Connection to software.apigee.com 443 port [tcp/https] succeeded!

اگر nc نصب نکرده‌اید، می‌توانید دستور telnet زیر را اجرا کنید:

telnet software.apigee.com 443

در صورت موفقیت آمیز بودن دستورات، می توانید از CTRL+C برای قطع اتصال باز استفاده کنید.

اگر هر یک از دستورات ناموفق باشد، اتصال شبکه محدود است یا اصلاً وجود ندارد. با سرپرست شبکه خود چک کنید.

اعتبارنامه نادرست

از صحت نام کاربری و رمز عبور خود اطمینان حاصل کنید.

برای مثال، بررسی کنید که آیا هنگام استفاده از دستور زیر با نام کاربری و رمز عبور Apigee خود با خطا مواجه می شوید یا خیر:

curl -i -u username:password https://software.apigee.com/apigee-repo.rpm
مشکلات پروکسی پیکربندی محلی شما از یک پراکسی HTTP egress استفاده می کند و شما همان پیکربندی را به مدیر بسته yum گسترش نداده اید. متغیرهای محیط خود را بررسی کنید:
echo $http_proxy
echo $https_proxy

برای یک پراکسی HTTP egress، باید از یکی از گزینه های زیر استفاده کنید:

  • یک پیکربندی پروکسی HTTP را در /etc/yum.conf اضافه کنید
  • پیکربندی پروکسی HTTP سراسری را در /etc/environment اضافه کنید

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

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

فرآیند نصب Apigee Edge برای گره‌های بدون اتصال به اینترنت نیاز به دسترسی به مخازن محلی زیر دارد:

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

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

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

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

  1. نام کاربری و رمز عبوری را که برای دسترسی به مخزن Apigee استفاده می کنید، از Apigee دریافت کنید. اگر یک نام کاربری: رمز عبور برای سایت Apigee ftp دارید، می توانید از آن اعتبارنامه ها استفاده کنید.
  2. برای نصب Edge RPM به عنوان root وارد گره خود شوید.
  3. همانطور که در بالا توضیح داده شد SELinux را غیرفعال کنید.
  4. فایل Edge bootstrap_4.51.00.sh را در /tmp/bootstrap_4.51.00.sh دانلود کنید:
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  5. ابزار و وابستگی های Edge apigee-service را نصب کنید:
    sudo bash /tmp/bootstrap_4.51.00.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/ استفاده کنید.

    برای به حداقل رساندن اندازه مخزن، RPM های --only-new-rpms اضافه کنید تا فقط آخرین RPM ها را دانلود کنید. برای دانلود تقریباً به 1.6 گیگابایت فضای دیسک نیاز دارید:

    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    اگر می‌خواهید کل مخزن، از جمله RPM‌های قدیمی‌تر را دانلود کنید، --only-new-rpms حذف کنید. برای دانلود کامل به حدود 6 گیگابایت فضای دیسک نیاز دارید:

    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

    اکنون یک کپی محلی از مخزن Apigee دارید. بخش بعدی نحوه نصب ابزار Edge apigee-setup را از مخزن محلی توضیح می دهد.

  8. (اختیاری) اگر می خواهید Edge را از مخزن محلی روی همان گره ای که میزبان مخزن محلی است نصب کنید، ابتدا باید دستورات زیر را اجرا کنید:
    1. برای نصب ابزار apigee-service :
      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
      bootstrap_4.51.00.sh از مخزن محلی اجرا کنید
    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 نصب کنید

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

  1. در گره دارای مخزن محلی، از دستور زیر برای بسته بندی مخزن محلی در یک فایل .tar به نام /opt/apigee/data/apigee-mirror/apigee-4.51.00.tar.gz استفاده کنید:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
  2. فایل tar را در گره ای که می خواهید Edge را نصب کنید کپی کنید. به عنوان مثال، آن را در پوشه /tmp در گره جدید کپی کنید.
  3. در گره جدید، SELinux را همانطور که در بالا توضیح داده شد غیرفعال کنید.
  4. در گره جدید، مطمئن شوید که می توانید به مخزن محلی Yum utility و مخزن EPEL دسترسی داشته باشید.
  5. دوباره بررسی کنید که همه مخازن اینترنت خارجی غیرفعال هستند (این مورد باید باشد زیرا شما در حال نصب بر روی دستگاهی بدون دسترسی به اینترنت هستید):
    sudo yum repolist

    همه مخازن خارجی باید غیرفعال شوند، اما مخزن محلی Apigee و مخازن داخلی شما باید فعال باشند.

  6. در گره جدید، yum-utils و yum-plugin-priorities از مخزن محلی خود نصب کنید:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities

    تیم عملیات شما یا گروه دیگری در سازمان شما باید یک مخزن محلی برای شما راه اندازی کند تا بتوانید ابزارهای Yum را نصب کنید.

  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 untar کنید:
    tar -xzf apigee-4.51.00.tar.gz

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

  11. ابزار Edge apigee-service و وابستگی ها را از /tmp/repos نصب کنید:
    sudo bash /tmp/repos/bootstrap_4.51.00.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 نصب کنید

برای نصب از مخزن با استفاده از وب سرور NGINX:

  1. وب سرور NGINX را روی گره repo نصب کنید:
    opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
  2. به طور پیش فرض، NGINX به گونه ای پیکربندی شده است که از localhost به عنوان نام سرور و پورت 3939 استفاده کند. برای تغییر این مقادیر:
    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 فعال است.
  7. در گره جدید، نسخه libdb4 خود را همانطور که در بالا توضیح داده شد بررسی کنید.
  8. در گره راه دور، فایل Edge bootstrap_4.51.00.sh را در /tmp/bootstrap_4.51.00.sh دانلود کنید:
    curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh

    که در آن uName:pWord نام کاربری و رمز عبوری است که در بالا برای مخزن تنظیم کرده‌اید و remoteRepo آدرس IP یا نام DNS گره repo است.

  9. در گره راه دور، ابزار Edge apigee-service و وابستگی ها را نصب کنید:
    sudo bash /tmp/bootstrap_4.51.00.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.51.00.sh را دانلود کرده و سپس یک همگام سازی جدید انجام دهید.

برای به روز رسانی مخزن:

  1. فایل Edge bootstrap_4.51.00.sh را در /tmp/bootstrap_4.51.00.sh دانلود کنید:
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  2. فایل Edge bootstrap_4.51.00.sh را اجرا کنید:
    sudo bash/tmp/bootstrap_4.51.00.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 را تمیز کنید

پاک کردن مخزن محلی /opt/apigee/data/apigee-mirror و /var/tmp/yum-apigee-* را حذف می کند.

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

/opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean

Edge 4.16.0x/4.17.0x را در مخزن 4.51.00 اضافه یا به روز کنید

اگر باید نصب‌های Edge 4.16.0x یا 4.17.0x را در مخزن 4.51.00 نگهداری کنید، می‌توانید یک مخزن حاوی تمام نسخه‌ها نگهداری کنید. از آن مخزن، می توانید هر نسخه ای از Edge را نصب کنید.

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

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

    شما باید یک نتیجه را در فرم زیر مشاهده کنید، جایی که xyz شماره ساخت است:

    apigee-mirror-4.51.00-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.01.sh
    bootstrap_4.18.05.sh
    bootstrap_4.19.01.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 از فایل repo یا .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» در بالا را دنبال کنید.

،

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

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

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

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

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

  • برای تنظیم موقت SELinux روی حالت مجاز، دستور زیر را اجرا کنید:
    • در سیستم عامل لینوکس 8.x :
      sudo setenforce 0

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

      sudo setenforce 1
    • در سیستم عامل لینوکس 7.x :
      sudo setenforce 0

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

      sudo setenforce 1
    • در سیستم عامل لینوکس 6.x :
      sudo echo 0 > /selinux/enforce

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

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

پیش نیاز: EPEL repo را فعال کنید

برای نصب یا به‌روزرسانی Edge یا ایجاد یک مخزن محلی، باید بسته‌های اضافی برای لینوکس سازمانی (یا EPEL) را فعال کنید. دستوری که استفاده می کنید به نسخه RedHat/CentOS شما بستگی دارد:

  • برای Red Hat Enterprise Linux (RHEL) 8.0، پیش نیازهای RHEL 8 را ببینید.

  • برای Red Hat/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
  • برای Red Hat/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
  • برای AWS-2:
    sudo amazon-linux-extras install epel -y
    sudo yum-config-manager --enable epel

پیش نیاز: نسخه کتابخانه libdb4 را در RedHat 7.4 و CentOS 7.4 بررسی کنید

در RedHat 7.4 و CentOS 7.4، قبل از نصب، نسخه RPM های libdb4 را بررسی کنید. Edge به نسخه 4.8 نیاز دارد و برخی از نسخه های RedHat 7.4 و CentOS 7.4 با نسخه بعدی عرضه می شوند. اگر نسخه بعدی دارید، آن را حذف نصب کنید و سپس نصب کننده Edge نسخه 4.8 را نصب خواهد کرد.

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

rpm -qa | grep libdb4

اگر مشاهده کردید که نسخه libdb4 RPM دیرتر از نسخه 4.8 است، آن را حذف نصب کنید.

پیش نیازهای RHEL 8

اگر Edge را روی سروری نصب می‌کنید که دارای Red Hat Enterprise Linux (RHEL) 8 است، قبل از نصب مراحل زیر را انجام دهید:

  1. فعال کردن بسته‌های اضافی برای لینوکس سازمانی (EPEL) :
    sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
  2. Postgres و NGINX:
    sudo dnf module disable postgresql
    sudo dnf module disable nginx
    غیرفعال کنید
  3. Python 2 را نصب کنید و یک سیم پیوند ایجاد کنید:
    sudo dnf install -y python2
    sudo ln -s /usr/bin/python2 /usr/bin/python

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

برای نصب Edge بر روی یک گره با اتصال اینترنت خارجی:

  1. نام کاربری و رمز عبوری را که برای دسترسی به مخزن Apigee استفاده می کنید، از Apigee دریافت کنید. اگر یک username:password برای سایت Apigee ftp دارید، می توانید از آن اعتبارنامه ها استفاده کنید.
  2. برای نصب Edge RPM به عنوان root وارد گره خود شوید
  3. yum-utils و yum-plugin-priorities نصب کنید:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities
  4. SELinux را غیرفعال کنید .
  5. مخزن EPEL را فعال کنید .
  6. نسخه libdb4 خود را بررسی کنید .
  7. اگر روی RHEL 8 نصب می کنید، مراحل پیش نیازهای RHEL 8 را دنبال کنید.
  8. اگر روی Oracle 7.x نصب می‌کنید، دستور زیر را اجرا کنید:
    sudo yum-config-manager --enable ol7_optional_latest
  9. اگر روی 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
  10. فایل Edge bootstrap_4.51.00.sh را در /tmp/bootstrap_4.51.00.sh دانلود کنید:
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  11. ابزار Edge apigee-service و وابستگی ها را نصب کنید:
    sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

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

    به طور پیش فرض، نصب کننده بررسی می کند که جاوا 1.8 را نصب کرده اید. اگر این کار را نکنید، آن را برای شما نصب می کند. از گزینه JAVA_FIX برای تعیین نحوه مدیریت نصب جاوا استفاده کنید. JAVA_FIX مقادیر زیر را می گیرد:

    • I: نصب OpenJDK 1.8 (پیش‌فرض)
    • ج: بدون نصب جاوا ادامه دهید
    • س: ترک برای این گزینه باید خود جاوا را نصب کنید.

    نصب ابزار apigee-service فایل /etc/yum.repos.d/apigee.repo را ایجاد می کند که مخزن Apigee را تعریف می کند. برای مشاهده فایل تعریف از دستور زیر استفاده کنید:

    cat /etc/yum.repos.d/apigee.repo

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

    sudo yum -v repolist 'apigee*'
  12. از apigee-service برای نصب ابزار apigee-setup استفاده کنید:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  13. از apigee-setup برای نصب و پیکربندی اجزای Edge در گره استفاده کنید. برای اطلاعات بیشتر به نصب اجزای Edge روی یک گره مراجعه کنید.

عیب یابی

هنگام تلاش برای نصب روی یک گره با اتصال اینترنت خارجی، ممکن است با یک یا چند خطای زیر مواجه شوید:

Cannot open: https:// : @ software.apigee.com//apigee-repo-version.rpm

bootstrap.sh: Error: Repo configuration failed

error: package package_name is not installed

جدول زیر برخی از وضوح های ممکن برای این خطاها را فهرست می کند:

نوع خطا وضوح ممکن
رمز عبور حاوی کاراکترهای بد است از کاراکترهای خاص در رمز عبور Apigee خود استفاده نکنید.
مشکلات اتصال

اتصال شبکه خود را با اجرای دستور ncat زیر تست کنید:

nc -v software.apigee.com 443

شما باید پیامی شبیه به زیر دریافت کنید:

Connection to software.apigee.com 443 port [tcp/https] succeeded!

اگر nc نصب نکرده‌اید، می‌توانید دستور telnet زیر را اجرا کنید:

telnet software.apigee.com 443

در صورت موفقیت آمیز بودن دستورات، می توانید از CTRL+C برای قطع اتصال باز استفاده کنید.

اگر هر یک از دستورات ناموفق باشد، اتصال شبکه محدود است یا اصلاً وجود ندارد. با سرپرست شبکه خود چک کنید.

اعتبارنامه نادرست

از صحت نام کاربری و رمز عبور خود اطمینان حاصل کنید.

برای مثال، بررسی کنید که آیا هنگام استفاده از دستور زیر با نام کاربری و رمز عبور Apigee خود با خطا مواجه می شوید یا خیر:

curl -i -u username:password https://software.apigee.com/apigee-repo.rpm
مشکلات پروکسی پیکربندی محلی شما از یک پراکسی HTTP egress استفاده می کند و شما همان پیکربندی را به مدیر بسته yum گسترش نداده اید. متغیرهای محیط خود را بررسی کنید:
echo $http_proxy
echo $https_proxy

برای یک پراکسی HTTP egress، باید از یکی از گزینه های زیر استفاده کنید:

  • یک پیکربندی پروکسی HTTP را در /etc/yum.conf اضافه کنید
  • پیکربندی پروکسی HTTP سراسری را در /etc/environment اضافه کنید

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

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

فرآیند نصب Apigee Edge برای گره‌های بدون اتصال به اینترنت نیاز به دسترسی به مخازن محلی زیر دارد:

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

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

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

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

  1. نام کاربری و رمز عبوری را که برای دسترسی به مخزن Apigee استفاده می کنید، از Apigee دریافت کنید. اگر یک نام کاربری: رمز عبور برای سایت Apigee ftp دارید، می توانید از آن اعتبارنامه ها استفاده کنید.
  2. برای نصب Edge RPM به عنوان root وارد گره خود شوید.
  3. همانطور که در بالا توضیح داده شد SELinux را غیرفعال کنید.
  4. فایل Edge bootstrap_4.51.00.sh را در /tmp/bootstrap_4.51.00.sh دانلود کنید:
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  5. ابزار و وابستگی های Edge apigee-service را نصب کنید:
    sudo bash /tmp/bootstrap_4.51.00.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/ استفاده کنید.

    برای به حداقل رساندن اندازه مخزن، RPM های --only-new-rpms اضافه کنید تا فقط آخرین RPM ها را دانلود کنید. برای دانلود تقریباً به 1.6 گیگابایت فضای دیسک نیاز دارید:

    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    اگر می‌خواهید کل مخزن، از جمله RPM‌های قدیمی‌تر را دانلود کنید، --only-new-rpms حذف کنید. برای دانلود کامل به حدود 6 گیگابایت فضای دیسک نیاز دارید:

    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

    اکنون یک کپی محلی از مخزن Apigee دارید. بخش بعدی نحوه نصب ابزار Edge apigee-setup را از مخزن محلی توضیح می دهد.

  8. (اختیاری) اگر می خواهید Edge را از مخزن محلی روی همان گره ای که میزبان مخزن محلی است نصب کنید، ابتدا باید دستورات زیر را اجرا کنید:
    1. برای نصب ابزار apigee-service :
      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
      bootstrap_4.51.00.sh از مخزن محلی اجرا کنید
    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 نصب کنید

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

  1. در گره دارای مخزن محلی، از دستور زیر برای بسته بندی مخزن محلی در یک فایل .tar به نام /opt/apigee/data/apigee-mirror/apigee-4.51.00.tar.gz استفاده کنید:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
  2. فایل tar را در گره ای که می خواهید Edge را نصب کنید کپی کنید. به عنوان مثال، آن را در پوشه /tmp در گره جدید کپی کنید.
  3. در گره جدید، SELinux را همانطور که در بالا توضیح داده شد غیرفعال کنید.
  4. در گره جدید، مطمئن شوید که می توانید به مخزن محلی Yum utility و مخزن EPEL دسترسی داشته باشید.
  5. دوباره بررسی کنید که همه مخازن اینترنت خارجی غیرفعال هستند (این مورد باید باشد زیرا شما در حال نصب بر روی دستگاهی بدون دسترسی به اینترنت هستید):
    sudo yum repolist

    همه مخازن خارجی باید غیرفعال شوند، اما مخزن محلی Apigee و مخازن داخلی شما باید فعال باشند.

  6. در گره جدید، yum-utils و yum-plugin-priorities از مخزن محلی خود نصب کنید:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities

    تیم عملیات شما یا گروه دیگری در سازمان شما باید یک مخزن محلی برای شما راه اندازی کند تا بتوانید ابزارهای Yum را نصب کنید.

  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 untar کنید:
    tar -xzf apigee-4.51.00.tar.gz

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

  11. ابزار Edge apigee-service و وابستگی ها را از /tmp/repos نصب کنید:
    sudo bash /tmp/repos/bootstrap_4.51.00.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 نصب کنید

برای نصب از مخزن با استفاده از وب سرور NGINX:

  1. وب سرور NGINX را روی گره repo نصب کنید:
    opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
  2. به طور پیش فرض، NGINX به گونه ای پیکربندی شده است که از localhost به عنوان نام سرور و پورت 3939 استفاده کند. برای تغییر این مقادیر:
    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 فعال است.
  7. در گره جدید، نسخه libdb4 خود را همانطور که در بالا توضیح داده شد بررسی کنید.
  8. در گره راه دور، فایل Edge bootstrap_4.51.00.sh را در /tmp/bootstrap_4.51.00.sh دانلود کنید:
    curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh

    که در آن uName:pWord نام کاربری و رمز عبوری است که در بالا برای مخزن تنظیم کرده‌اید و remoteRepo آدرس IP یا نام DNS گره repo است.

  9. در گره راه دور، ابزار Edge apigee-service و وابستگی ها را نصب کنید:
    sudo bash /tmp/bootstrap_4.51.00.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.51.00.sh را دانلود کرده و سپس یک همگام سازی جدید انجام دهید.

برای به روز رسانی مخزن:

  1. فایل Edge bootstrap_4.51.00.sh را در /tmp/bootstrap_4.51.00.sh دانلود کنید:
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  2. فایل Edge bootstrap_4.51.00.sh را اجرا کنید:
    sudo bash/tmp/bootstrap_4.51.00.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 را تمیز کنید

پاک کردن مخزن محلی /opt/apigee/data/apigee-mirror و /var/tmp/yum-apigee-* را حذف می کند.

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

/opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean

Edge 4.16.0x/4.17.0x را در مخزن 4.51.00 اضافه یا به روز کنید

اگر باید نصب‌های Edge 4.16.0x یا 4.17.0x را در مخزن 4.51.00 نگهداری کنید، می‌توانید یک مخزن حاوی تمام نسخه‌ها نگهداری کنید. از آن مخزن، می توانید هر نسخه ای از Edge را نصب کنید.

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

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

    شما باید یک نتیجه را در فرم زیر مشاهده کنید، جایی که xyz شماره ساخت است:

    apigee-mirror-4.51.00-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.01.sh
    bootstrap_4.18.05.sh
    bootstrap_4.19.01.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 از فایل repo یا .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» در بالا را دنبال کنید.

،

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

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

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

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

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

  • برای تنظیم موقت SELinux روی حالت مجاز، دستور زیر را اجرا کنید:
    • در سیستم عامل لینوکس 8.x :
      sudo setenforce 0

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

      sudo setenforce 1
    • در سیستم عامل لینوکس 7.x :
      sudo setenforce 0

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

      sudo setenforce 1
    • در سیستم عامل لینوکس 6.x :
      sudo echo 0 > /selinux/enforce

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

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

پیش نیاز: EPEL repo را فعال کنید

برای نصب یا به‌روزرسانی Edge یا ایجاد یک مخزن محلی، باید بسته‌های اضافی برای لینوکس سازمانی (یا EPEL) را فعال کنید. دستوری که استفاده می کنید به نسخه RedHat/CentOS شما بستگی دارد:

  • برای Red Hat Enterprise Linux (RHEL) 8.0، پیش نیازهای RHEL 8 را ببینید.

  • برای Red Hat/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
  • برای Red Hat/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
  • برای AWS-2:
    sudo amazon-linux-extras install epel -y
    sudo yum-config-manager --enable epel

پیش نیاز: نسخه کتابخانه libdb4 را در RedHat 7.4 و CentOS 7.4 بررسی کنید

در RedHat 7.4 و CentOS 7.4، قبل از نصب، نسخه RPM های libdb4 را بررسی کنید. Edge به نسخه 4.8 و برخی از نسخه های کشتی Redhat 7.4 و Centos 7.4 با نسخه بعدی نیاز دارد. اگر نسخه بعدی دارید ، آن را حذف کنید و Edge Installer نسخه 4.8 را نصب می کند.

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

rpm -qa | grep libdb4

اگر می بینید که نسخه libdb4 RPM دیرتر از نسخه 4.8 است ، آن را حذف کنید.

پیش نیازهای RHEL 8

اگر در حال نصب لبه روی سرور هستید که Red Hat Enterprise Linux (RHEL) 8 را اجرا می کند ، مراحل زیر را قبل از انجام نصب انجام دهید:

  1. بسته های اضافی را برای شرکت Linux (EPEL) فعال کنید:
    sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
  2. Postgres و Nginx را غیرفعال کنید:
    sudo dnf module disable postgresql
    sudo dnf module disable nginx
  3. Python 2 را نصب کنید و یک Symlink ایجاد کنید:
    sudo dnf install -y python2
    sudo ln -s /usr/bin/python2 /usr/bin/python

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

برای نصب لبه روی گره با اتصال اینترنتی خارجی:

  1. نام کاربری و رمز عبور را از Apigee که برای دسترسی به مخزن Apigee استفاده می کنید ، بدست آورید. اگر username:password برای سایت Apigee FTP ، می توانید از آن اعتبار استفاده کنید.
  2. برای نصب RPMS Edge به گره خود به عنوان ریشه وارد شوید
  3. yum-utils و yum-plugin-priorities نصب کنید:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities
  4. Selinux را غیرفعال کنید .
  5. repo epel را فعال کنید .
  6. نسخه libdb4 خود را بررسی کنید .
  7. اگر در حال نصب RHEL 8 هستید ، مراحل پیش نیازهای RHEL 8 را دنبال کنید.
  8. اگر در حال نصب بر روی Oracle 7.x هستید ، دستور زیر را اجرا کنید:
    sudo yum-config-manager --enable ol7_optional_latest
  9. اگر در حال نصب 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
  10. پرونده Edge bootstrap_4.51.00.sh را به /tmp/bootstrap_4.51.00.sh :
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
    بارگیری کنید.
  11. ابزار و وابستگی های سرویس Apigee-Service را نصب کنید:
    sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

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

    به طور پیش فرض، نصب کننده بررسی می کند که جاوا 1.8 را نصب کرده اید. اگر این کار را نکنید، آن را برای شما نصب می کند. از گزینه JAVA_FIX برای تعیین نحوه مدیریت نصب جاوا استفاده کنید. JAVA_FIX مقادیر زیر را می گیرد:

    • I: نصب OpenJDK 1.8 (پیش فرض)
    • ج: بدون نصب جاوا ادامه دهید
    • س: ترک برای این گزینه ، شما باید خودتان جاوا را نصب کنید.

    نصب ابزار Apigee-Service پرونده /etc/yum.repos.d/apigee.repo را ایجاد می کند که مخزن Apigee را تعریف می کند. برای مشاهده پرونده تعریف ، از دستور استفاده کنید:

    cat /etc/yum.repos.d/apigee.repo

    برای مشاهده محتوای repo ، از دستور استفاده کنید:

    sudo yum -v repolist 'apigee*'
  12. برای نصب ابزار Apigee-Setup از Apigee-Service استفاده کنید:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  13. برای نصب و پیکربندی اجزای لبه روی گره از Apigee-setup استفاده کنید. برای اطلاعات بیشتر به اجزای نصب Edge روی یک گره مراجعه کنید.

عیب یابی

هنگام تلاش برای نصب روی یک گره با اتصال اینترنتی خارجی ، ممکن است با یک یا چند خطای زیر روبرو شوید:

Cannot open: https:// : @ software.apigee.com//apigee-repo-version.rpm

bootstrap.sh: Error: Repo configuration failed

error: package package_name is not installed

در جدول زیر برخی از قطعنامه های ممکن برای این خطاها ذکر شده است:

نوع خطا وضوح احتمالی
رمز عبور شامل شخصیت های بد است در رمز عبور Apigee خود از شخصیت های خاصی استفاده نکنید.
مشکلات اتصال

اتصال شبکه خود را با اجرای دستور ncat زیر آزمایش کنید:

nc -v software.apigee.com 443

شما باید پیامی مشابه موارد زیر دریافت کنید:

Connection to software.apigee.com 443 port [tcp/https] succeeded!

اگر nc نصب نشده اید ، می توانید دستور telnet زیر را اجرا کنید:

telnet software.apigee.com 443

اگر دستورات موفق شوند ، می توانید از Ctrl+C برای سقط اتصال باز استفاده کنید.

اگر هر یک از دستور شکست بخورد ، در این صورت اتصال به شبکه محدود یا محدود دارید. با مدیر شبکه خود تماس بگیرید.

اعتبارنامه های نادرست

اطمینان حاصل کنید که نام کاربری و رمز عبور شما صحیح است.

به عنوان مثال ، بررسی کنید که وقتی سعی می کنید از دستور زیر با نام کاربری و رمز عبور APIGEE خود استفاده کنید ، خطایی دریافت می کنید:

curl -i -u username:password https://software.apigee.com/apigee-repo.rpm
مسائل پروکسی پیکربندی محلی شما از پروکسی HTTP Egress استفاده می کند و شما همان پیکربندی را به مدیر بسته yum گسترش نداده اید. متغیرهای محیط خود را بررسی کنید:
echo $http_proxy
echo $https_proxy

برای یک پروکسی HTTP Egress ، باید از یکی از گزینه های زیر استفاده کنید:

  • پیکربندی پروکسی HTTP را در /etc/yum.conf اضافه کنید
  • پیکربندی پروکسی جهانی HTTP را در /etc/environment اضافه کنید

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

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

فرآیند نصب Apigee Edge برای گره هایی که هیچ اتصال اینترنتی ندارند ، نیاز به دسترسی به repos محلی زیر دارد:

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

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

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

برای ایجاد یک repo apigee محلی:

  1. نام کاربری و رمز عبور را از Apigee که برای دسترسی به مخزن Apigee استفاده می کنید ، بدست آورید. اگر نام کاربری موجود دارید: رمز عبور برای سایت Apigee FTP ، می توانید از آن اعتبار استفاده کنید.
  2. برای نصب Edge RPM به عنوان root وارد گره خود شوید.
  3. همانطور که در بالا توضیح داده شد ، Selinux را غیرفعال کنید.
  4. پرونده Edge bootstrap_4.51.00.sh را به /tmp/bootstrap_4.51.00.sh :
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
    بارگیری کنید
  5. ابزار و وابستگی های سرویس Apigee-Service را نصب کنید:
    sudo bash /tmp/bootstrap_4.51.00.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 برای همگام سازی repo apigee با /opt/apigee/data/apigee-mirror/repos/ دایرکتوری استفاده کنید.

    برای به حداقل رساندن اندازه repo ، شامل --only-new-rpms برای بارگیری جدیدترین RPMS است. برای بارگیری تقریباً به 1.6 گیگابایت فضای دیسک نیاز دارید:

    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    اگر می خواهید کل repo ، از جمله RPM های قدیمی تر ، حذف شده ، از بین برود --only-new-rpms . برای بارگیری کامل به تقریباً 6 گیگابایت فضای دیسک نیاز دارید:

    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

    شما اکنون یک نسخه محلی از Apigee Repo دارید. در بخش بعدی نحوه نصب ابزار Edge apigee-setup از repo محلی توضیح داده شده است.

  8. (اختیاری) اگر می خواهید لبه را از repo محلی بر روی همان گره که میزبان repo محلی است نصب کنید ، باید ابتدا دستورات زیر را اجرا کنید:
    1. bootstrap_4.51.00.sh از repo محلی اجرا کنید تا ابزار apigee-service را نصب کنید:
      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
    2. برای نصب ابزار apigee-setup apigee-service استفاده کنید:
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    3. برای نصب و پیکربندی اجزای لبه روی گره از apigee-setup استفاده کنید. برای اطلاعات بیشتر به اجزای نصب Edge روی یک گره مراجعه کنید.

Apigee-setup را روی یک گره از راه دور از repo محلی نصب کنید

شما دو گزینه برای نصب لبه از repo محلی دارید. شما می توانید یا:

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

از پرونده .tar نصب کنید

برای نصب از پرونده .tar:

  1. در گره با repo محلی ، از دستور زیر استفاده کنید تا repo محلی را در یک پرونده .tar به نام/tar به نام /opt/apigee/data/apigee-mirror/apigee-4.51.00.tar.gz :
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    استفاده کنید.
  2. پرونده .tar را در گره ای که می خواهید لبه نصب کنید کپی کنید. به عنوان مثال، آن را در پوشه /tmp در گره جدید کپی کنید.
  3. در گره جدید ، Selinux را همانطور که در بالا توضیح داده شد غیرفعال کنید.
  4. در گره جدید ، مطمئن باشید که می توانید به repo برنامه محلی YUM و Repo Epel دسترسی پیدا کنید.
  5. بررسی کنید که تمام بازپرداختهای اینترنتی خارجی غیرفعال هستند (این مورد باید باشد زیرا شما در دستگاه بدون دسترسی به اینترنت نصب می کنید):
    sudo yum repolist

    تمام رپوهای خارجی باید غیرفعال شوند ، اما repo محلی Apigee و repos داخلی شما باید فعال شوند.

  6. در گره جدید ، yum-utils و yum-plugin-priorities از repo محلی خود نصب کنید:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities

    تیم OPS یا گروه دیگر در سازمان شما باید یک repo محلی را برای شما تنظیم کند تا بتوانید ابزارهای YUM را نصب کنید.

  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 -xzf apigee-4.51.00.tar.gz

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

  11. ابزار و وابستگی های Edge Apigee-Service را از /tmp/repos نصب کنید:
    sudo bash /tmp/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

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

از repo با استفاده از Nginx Weberver نصب کنید

برای نصب از repo با استفاده از NGINX WebServer:

  1. WebServer Nginx را روی گره repo نصب کنید:
    opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
  2. به طور پیش فرض ، Nginx برای استفاده از LocalHost به عنوان نام سرور و پورت 3939 تنظیم شده است تا این مقادیر را تغییر دهد:
    1. Open /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. به طور پیش فرض ، repo به نام کاربری نیاز دارد: رمز عبور 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.51.00.sh را به /tmp/bootstrap_4.51.00.sh :
    curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
    بارگیری کنید.

    جایی که uName:pWord نام کاربری و رمز عبوری است که در بالا برای repo تنظیم کرده اید ، و remoteRepo آدرس IP یا نام DNS گره repo است.

  9. در گره از راه دور ، ابزار و وابستگی های apigee-service Edge را نصب کنید:
    sudo bash /tmp/bootstrap_4.51.00.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 روی یک گره مراجعه کنید.

یک مخزن محلی Apigee را به روز کنید

برای به روزرسانی repo ، شما باید آخرین پرونده bootstrap_4.51.00.sh را بارگیری کرده و سپس یک همگام سازی جدید انجام دهید.

برای به روزرسانی repo:

  1. پرونده Edge bootstrap_4.51.00.sh را به /tmp/bootstrap_4.51.00.sh :
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
    بارگیری کنید
  2. پرونده Edge bootstrap_4.51.00.sh را اجرا کنید:
    sudo bash/tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

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

  3. به روزرسانی apigee-mirror :
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
  4. SYNC را انجام دهید:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
  5. اگر می خواهید کل repo:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

یک repo apigee محلی را تمیز کنید

تمیز کردن repo محلی حذف/opt/apigee/data/apigee-mirror و/var/tmp/yum-apigee-*.

برای تمیز کردن repo محلی ، استفاده کنید:

/opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean

لبه 4.16.0x/4.17.0x را در یک repo 4.51.00 اضافه یا به روز کنید

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

برای افزودن 4.16.0x/4.17.0x به repo 4.51.00:

  1. اطمینان حاصل کنید که نسخه 4.51.00 از ابزار apigee-mirror را نصب کرده اید:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

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

    apigee-mirror-4.51.00-0.0.xyz
  2. برای بارگیری Edge 4.16.0x/4.17.0x در repo خود از ابزار apigee-mirror استفاده کنید. توجه کنید که چگونه دستور را با نسخه مورد نظر پیشوند می کنید:
    apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    از همین دستور استفاده کنید تا بعداً با مشخص کردن شماره نسخه های مورد نیاز ، repos 4.16.0x/4.17.0x را به روز کنید.

  3. برای دیدن ساختار پرونده:
    ls /opt/apigee/data/apigee-mirror/repos
    فهرست /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.01.sh
    bootstrap_4.18.05.sh
    bootstrap_4.19.01.sh
    thirdparty

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

  4. برای بسته بندی repo در یک پرونده .tar ، از دستور زیر استفاده کنید:
    apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

    این فرمان تمام Repos 4.17.0x و 4.16.0x را در همان پرونده .tar بسته بندی می کند. شما فقط نمی توانید بخشی از repo را بسته بندی کنید.

برای نصب لبه از پرونده محلی repo یا .tar ، کافی است با استفاده از یکی از دستورات زیر ، فایل بوت استرپ صحیح را اجرا کنید. این مثال Edge 4.17.01 را نصب می کند:

  • در صورت نصب از یک فایل .tar ، فایل bootstrap صحیح را از repo اجرا کنید:
    sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    برای تکمیل نصب ، مراحل باقیمانده از "نصب از پرونده .tar" را در بالا دنبال کنید.

  • در صورت نصب با استفاده از NGINX WebServer ، فایل Bootstrap صحیح را از repo بارگیری کرده و اجرا کنید:
    /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://

    برای تکمیل نصب ، مراحل باقیمانده "نصب از repo را با استفاده از WebServer Nginx" در بالا دنبال کنید.