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

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

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

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

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

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

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

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

    برای نصب یا به‌روزرسانی Edge، یا برای ایجاد مخزن محلی، باید بسته‌های اضافی برای Enterprise Linux (یا EPEL) را فعال کنید. برای Red Hat Enterprise Linux (RHEL) نسخه 9.x،‏ Rocky Linux نسخه 9.x، یا Oracle Linux نسخه 9.x، فرمان‌های زیر را اجرا کنید:

    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
sudo rpm -ivh epel-release-latest-9.noarch.rpm

    پیش‌نیاز برای RHEL 9/Rocky 9/Oracle 9

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

    1. بسته‌های اضافی برای Enterprise Linux (EPEL) را فعال کنید: 
      sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
    2. غیرفعال کردن Postgres و Nginx: 
      sudo dnf module disable postgresql
sudo dnf module disable nginx

    برای تغییرات پیش‌از نصب PostgreSQL و LDAP، به‌ترتیب به الزامات پیش‌از نصب پایگاه داده PostgreSQL و تغییرات پیش‌از نصب SymasLDAP 2.6.10 مراجعه کنید.

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

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

    1. نام کاربری و گذرواژه‌ای را که برای دسترسی به مخزن Apigee استفاده می‌کنید از Apigee دریافت کنید. اگر ازقبل username:password برای سایت ftp مربوط به Apigee دارید، می‌توانید از آن اعتبارنامه‌ها استفاده کنید.
    2. برای نصب کردن Edge RPM، به‌عنوان ریشه به سیستم گره‌تان وارد شوید
    3. غیرفعال کردن SELinux.
    4. مخزن EPEL را فعال کنید.
    5. اگر درحال نصب روی RHEL 9/Rocky 9/Oracle 9 هستید، مراحل موجود در پیش‌نیازهای RHEL 9/Rocky 9/Oracle 9 را دنبال کنید.
    6. فایل Edge bootstrap_4.54.00.sh را در /tmp/bootstrap_4.54.00.sh بارگیری کنید: 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    7. ابزار کمکی apigee-service و وابستگی‌های Edge را نصب کنید: 
      sudo bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

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

      Apigee Edge برای Private Cloud 4.54.00 به پشتیبانی دوگانه Java با نصب Java 17 و Java 21 در گره نیاز دارد. باید قبل‌از اجرای دستورگان راه‌انداز، هم Java 17 و هم Java 21 را نصب کنید. نصب‌کننده فقط تأیید می‌کند که هر دو نسخه JDK نصب شده باشند؛ Java را به‌طور خودکار نصب نمی‌کند.

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

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

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

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

    عیب‌یابی

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

    Cannot open: https://username@software.apigee.com/apigee-repo-4.53.00.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 خروجی استفاده می‌کند و شما همان پیکربندی را به مدیر بسته yum گسترش نداده‌اید. متغیرهای محیطی‌تان را بررسی کنید: 
    echo $http_proxy
echo $https_proxy

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

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

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

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

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

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

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

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

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

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

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

    8. (اختیاری) اگر می‌خواهید Edge را از مخزن محلی روی همان گره‌ای که مخزن محلی را میزبانی می‌کند نصب کنید، ابتدا باید دستورات زیر را اجرا کنید:
      1. bootstrap_4.54.00.sh را از مخزن محلی اجرا کنید تا ابزار کمکی apigee-service نصب شود: 
        sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.54.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 در گره استفاده کنید. برای اطلاعات بیشتر، نصب کردن عناصر Edge در گره را ببینید.

    نصب apigee-setup در گره از دور از مخزن محلی

    برای نصب Edge از مخزن محلی دو گزینه دارید. یا می‌توانید:

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

    نصب از فایل tar.

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

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

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

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

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

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

    1. وب‌سرور Nginx را در گره مخزن نصب کنید:
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
    2. به‌طور پیش‌فرض، Nginx پیکربندی شده است تا از «میزبان محلی» به‌عنوان نام سرور و از درگاه ۳۹۳۹ استفاده کند. برای تغییر این مقادیر:
      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. در گره جدید، مطمئن شوید که مخزن EPEL به‌صورت محلی فعال شده باشد.
    5. در گره جدید، نسخه libdb4 خود را طبق توضیحات بالا بررسی کنید.
    6. در گره راه دور، ابزار کمکی Edge apigee-service و وابستگی‌ها را نصب کنید: 
      sudo bash /tmp/bootstrap_4.54.00.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.54.00.sh را بارگیری کنید و سپس همگام‌سازی جدیدی انجام دهید.

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

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

    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