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

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

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

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

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

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

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

    sudo echo 0 > /selinux/enforce

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

    sudo echo 1 > /selinux/enforce

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

    sudo setenforce 0

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

    sudo setenforce 1

• برای غیرفعال کردن دائمی 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. پایتون 2 را نصب کنید:

   sudo dnf install -y python2

ابزار 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.52.02.sh را در /tmp/bootstrap_4.52.02.sh دانلود کنید:

    curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh

11. ابزار و وابستگی های Edge apigee-service را نصب کنید:

    sudo bash /tmp/bootstrap_4.52.02.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

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

nc -v software.apigee.com 443

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

telnet software.apigee.com 443

curl -i -u username:password https://software.apigee.com/apigee-repo.rpm

echo $http_proxy
echo $https_proxy

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

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

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

• مخزن Apigee Edge: همانطور که در Create a local Apigee repository توضیح داده شد.
• مخزن Yum (برای ابزارهایی مانند yum-utils و yum-plugin-priorities ): تیم ops شما باید بتواند این را برای شما تنظیم کند.
• بسته های اضافی برای لینوکس سازمانی (یا EPEL) : تیم عملیات شما باید بتواند این را برای شما تنظیم کند.

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

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

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

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

1. نام کاربری و رمز عبوری را که برای دسترسی به مخزن Apigee استفاده می کنید، از Apigee دریافت کنید. اگر یک نام کاربری: رمز عبور برای سایت Apigee ftp دارید، می توانید از آن اعتبارنامه ها استفاده کنید.
2. برای نصب Edge RPM به عنوان root وارد گره خود شوید.
   
3. همانطور که در بالا توضیح داده شد SELinux را غیرفعال کنید.
4. فایل Edge bootstrap_4.52.02.sh را در /tmp/bootstrap_4.52.02.sh دانلود کنید:

   curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh

5. ابزار و وابستگی های Edge apigee-service را نصب کنید:
   

   sudo bash /tmp/bootstrap_4.52.02.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 ها را دانلود کنید.

8. (اختیاری) اگر می خواهید Edge را از مخزن محلی روی همان گره ای که میزبان مخزن محلی است نصب کنید، ابتدا باید دستورات زیر را اجرا کنید:
   1. برای نصب ابزار apigee-service bootstrap_4.52.02.sh را از مخزن محلی اجرا کنید:

      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.52.02.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.52.02.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.52.02.tar.gz

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

11. ابزار و وابستگی های Edge apigee-service را از /tmp/repos نصب کنید:

    sudo bash /tmp/repos/bootstrap_4.52.02.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.52.02.sh را در /tmp/bootstrap_4.52.02.sh دانلود کنید:

   curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh

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

9. در گره راه دور، ابزار Edge apigee-service و وابستگی ها را نصب کنید:

   sudo bash /tmp/bootstrap_4.52.02.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.52.02.sh را دانلود کرده و سپس یک همگام سازی جدید انجام دهید.

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

1. فایل Edge bootstrap_4.52.02.sh را در /tmp/bootstrap_4.52.02.sh دانلود کنید:

   curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh

2. فایل Edge bootstrap_4.52.02.sh را اجرا کنید:

   sudo bash/tmp/bootstrap_4.52.02.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.52.02 اضافه یا به روز کنید

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

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

1. مطمئن شوید که نسخه 4.52.02 ابزار apigee-mirror را نصب کرده اید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

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

   apigee-mirror-4.52.02-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» در بالا را دنبال کنید.