نصب ابزار 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) را فعال کنید. فرمانی که استفاده می‌کنید به نسخه RedHat/CentOS شما بستگی دارد:

    • برای Red Hat/CentOS/Oracle 8.x: 
      wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
sudo rpm -ivh epel-release-latest-8.noarch.rpm
    • برای Red Hat/CentOS/Oracle 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 8/Rocky 8/Oracle 8

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

      1. بسته‌های اضافی برای ‫Enterprise 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

      پیش‌نیاز برای 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.7 را ببینید.

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

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

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

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

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

        • I: نصب OpenJDK 1.8 (پیش‌فرض)
        • C: ادامه بدون نصب Java
        • Q: Quit (خروج). برای این گزینه، باید خودتان 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، به‌عنوان ریشه به سیستم گره‌تان وارد شوید.
      3. ‫SELinux را طبق توضیحات بالا غیرفعال کنید.
      4. فایل Edge bootstrap_4.53.01.sh را در /tmp/bootstrap_4.53.01.sh بارگیری کنید: 
        curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh
      5. ابزار Edge apigee-service و وابستگی‌ها را نصب کنید: 
        sudo bash /tmp/bootstrap_4.53.01.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. برای نصب ابزار apigee-service، bootstrap_4.53.01.sh را از مخزن محلی اجرا کنید: 
          sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.53.01.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.53.01.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-setup، از apigee-service استفاده کنید: 
        /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. در گره از دور، ابزار apigee-service Edge و وابستگی‌ها را نصب کنید: 
        sudo bash /tmp/bootstrap_4.53.01.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.53.01.sh را بارگیری کنید و سپس همگام‌سازی جدیدی انجام دهید.

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

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

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

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

      پاک کردن مخزن محلی Apigee

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

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

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