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

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

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

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

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

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

  • برای غیرفعال کردن دائمی 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/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. فعال کردن بسته‌های اضافی برای لینوکس سازمانی (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. فعال کردن بسته‌های اضافی برای لینوکس سازمانی (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 و تغییرات پیش‌نصب OpenLDAP 2.4 را ببینید.

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

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

      1. نام کاربری و رمز عبوری را که برای دسترسی به مخزن Apigee استفاده می کنید، از Apigee دریافت کنید. اگر یک username:password برای سایت Apigee ftp دارید، می توانید از آن اعتبارنامه ها استفاده کنید.
      2. برای نصب Edge RPM به عنوان root وارد گره خود شوید
      3. SELinux را غیرفعال کنید .
      4. مخزن EPEL را فعال کنید .
      5. اگر روی RHEL 9/Rocky 9/Oracle 9 نصب می‌کنید، مراحل پیش‌نیازهای RHEL 9/Rocky 9/Oracle 9 را دنبال کنید.
      6. فایل Edge bootstrap_4.53.00.sh را در /tmp/bootstrap_4.53.00.sh دانلود کنید: 
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      7. ابزار و وابستگی های Edge apigee-service را نصب کنید:
        sudo bash /tmp/bootstrap_4.53.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*'
      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 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.53.00.sh را در /tmp/bootstrap_4.53.00.sh دانلود کنید: 
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      5. ابزار و وابستگی های Edge apigee-service را نصب کنید: 
        sudo bash /tmp/bootstrap_4.53.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. برای نصب ابزار apigee-service ، bootstrap_4.53.00.sh از مخزن محلی اجرا کنید: 
          sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.53.00.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 نصب کنید

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

      1. در گره دارای مخزن محلی، از دستور زیر برای بسته بندی مخزن محلی در یک فایل .tar به نام /opt/apigee/data/apigee-mirror/apigee-4.53.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. از apigee-service برای نصب ابزار apigee-setup استفاده کنید: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      7. از 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. در گره جدید، مطمئن شوید که مخزن EPEL به صورت محلی فعال است.
      5. در گره جدید، نسخه libdb4 خود را همانطور که در بالا توضیح داده شد بررسی کنید.
      6. در گره راه دور، ابزار Edge apigee-service و وابستگی ها را نصب کنید:
        sudo bash /tmp/bootstrap_4.53.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.53.00.sh را دانلود کرده و سپس یک همگام سازی جدید انجام دهید.

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

      1. فایل Edge bootstrap_4.53.00.sh را در /tmp/bootstrap_4.53.00.sh دانلود کنید: 
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      2. فایل Edge bootstrap_4.53.00.sh را اجرا کنید:
        sudo bash/tmp/bootstrap_4.53.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 بر روی یک گره، ابتدا ابزار Edge apigee-setup را نصب کنید. اگر در محیطی هستید که گره های شما اتصال اینترنت خارجی ندارند، باید یک نسخه محلی از مخزن Apigee را نیز نصب کنید.

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

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

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

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

    • برای غیرفعال کردن دائمی 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/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. فعال کردن بسته‌های اضافی برای لینوکس سازمانی (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. فعال کردن بسته‌های اضافی برای لینوکس سازمانی (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 و تغییرات پیش‌نصب OpenLDAP 2.4 را ببینید.

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

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

      1. نام کاربری و رمز عبوری را که برای دسترسی به مخزن Apigee استفاده می کنید، از Apigee دریافت کنید. اگر یک username:password برای سایت Apigee ftp دارید، می توانید از آن اعتبارنامه ها استفاده کنید.
      2. برای نصب Edge RPM به عنوان root وارد گره خود شوید
      3. SELinux را غیرفعال کنید .
      4. مخزن EPEL را فعال کنید .
      5. اگر روی RHEL 9/Rocky 9/Oracle 9 نصب می‌کنید، مراحل پیش‌نیازهای RHEL 9/Rocky 9/Oracle 9 را دنبال کنید.
      6. فایل Edge bootstrap_4.53.00.sh را در /tmp/bootstrap_4.53.00.sh دانلود کنید: 
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      7. ابزار و وابستگی های Edge apigee-service را نصب کنید:
        sudo bash /tmp/bootstrap_4.53.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*'
      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 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.53.00.sh را در /tmp/bootstrap_4.53.00.sh دانلود کنید: 
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      5. ابزار و وابستگی های Edge apigee-service را نصب کنید: 
        sudo bash /tmp/bootstrap_4.53.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. برای نصب ابزار apigee-service ، bootstrap_4.53.00.sh از مخزن محلی اجرا کنید: 
          sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.53.00.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 نصب کنید

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

      1. در گره دارای مخزن محلی، از دستور زیر برای بسته بندی مخزن محلی در یک فایل .tar به نام /opt/apigee/data/apigee-mirror/apigee-4.53.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. از apigee-service برای نصب ابزار apigee-setup استفاده کنید: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      7. از 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. در گره جدید، مطمئن شوید که مخزن EPEL به صورت محلی فعال است.
      5. در گره جدید، نسخه libdb4 خود را همانطور که در بالا توضیح داده شد بررسی کنید.
      6. در گره راه دور، ابزار Edge apigee-service و وابستگی ها را نصب کنید:
        sudo bash /tmp/bootstrap_4.53.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.53.00.sh را دانلود کرده و سپس یک همگام سازی جدید انجام دهید.

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

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