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

Edge for Private Cloud نسخه 4.17.09

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

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

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

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

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

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

     > sudo echo 0 > /selinux/enforce

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

     > sudo echo 1 > /selinux/enforce

  2. در سیستم عامل لینوکس 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 شما بستگی دارد:

• برای RedHat/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

• برای RedHat/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

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

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

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

> rpm -qa | grep libdb

اگر می بینید که نسخه libdb4 RPM دیرتر از نسخه 4.8 است، از دستور زیر برای جایگزینی RPM ها استفاده کنید:

> rpm -Uvh --oldpackage libdb4-cxx-4.8.30-13.el7.x86_64.rpm libdb4-4.8.30-13.el7.x86_64.rpm

اگر باید این RPM ها را دانلود کنید، می توانید آنها را از:

• http://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/l/libdb4-cxx-4.8.30-13.el7.x86_64.rpm
• http://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/l/libdb4-4.8.30-13.el7.x86_64.rpm

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

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

1. نام کاربری و رمز عبوری را که برای دسترسی به مخزن Apigee استفاده می کنید، از Apigee دریافت کنید. اگر یک نام کاربری: رمز عبور برای سایت 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 repo را فعال کنید.
6. اگر روی AWS نصب می‌کنید ، دستور yum-configure-manager زیر را اجرا کنید:

   > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

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

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

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

   > sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

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

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

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

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

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

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

   > sudo yum -v repolist 'apigee*'

9. از apigee-service برای نصب ابزار apigee-setup استفاده کنید:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

10. از apigee-setup برای نصب و پیکربندی اجزای Edge در گره استفاده کنید. برای اطلاعات بیشتر به نصب اجزای Edge روی یک گره مراجعه کنید.

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

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

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

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

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

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

1. نام کاربری و رمز عبوری را که برای دسترسی به مخزن Apigee استفاده می کنید، از Apigee دریافت کنید. اگر یک نام کاربری: رمز عبور برای سایت 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 repo را فعال کنید.
6. اگر روی AWS نصب می‌کنید ، دستور yum-configure-manager زیر را اجرا کنید:
   

   > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

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

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

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

   > sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

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

9. ابزار apigee-mirror را روی گره نصب کنید:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install

10. از ابزار 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 را از مخزن محلی توضیح می دهد.

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

       > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.17.09.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 نصب کنید:

1. در گره دارای مخزن محلی، از دستور زیر برای بسته بندی مخزن محلی در یک فایل .tar به نام /opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz استفاده کنید:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

2. فایل tar را در گره ای که می خواهید Edge را نصب کنید کپی کنید. به عنوان مثال، آن را در پوشه /tmp در گره جدید کپی کنید.
3. yum-utils و yum-plugin-priorities را نصب کنید:

   > sudo yum install yum-utils
   > sudo yum install yum-plugin-priorities

4. در گره جدید، SELinux را همانطور که در بالا توضیح داده شد غیرفعال کنید.
5. همانطور که در بالا توضیح داده شد EPEL repo را فعال کنید.
6. در گره جدید، فایل را در پوشه /tmp untar کنید:
   

   > tar -xzf apigee-4.17.09.tar.gz

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

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

   > sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

8. از apigee-service برای نصب ابزار apigee-setup استفاده کنید:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

9. از apigee-setup برای نصب و پیکربندی اجزای Edge در گره استفاده کنید. برای اطلاعات بیشتر به نصب اجزای Edge روی یک گره مراجعه کنید.

از مخزن با استفاده از وب سرور 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 repo را فعال کنید.
7. در گره راه دور، فایل Edge bootstrap_4.17.09.sh را در /tmp/bootstrap_4.17.09.sh دانلود کنید:

   > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh

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

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

   > sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName
     apigeepassword=pWord apigeeprotocol=http://

   که در آن uName:pWord نام کاربری و رمز عبور مخزن است.

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

   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

10. از apigee-setup برای نصب و پیکربندی اجزای Edge در گره راه دور استفاده کنید. برای اطلاعات بیشتر به نصب اجزای Edge روی یک گره مراجعه کنید.

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

برای به روز رسانی مخزن، باید آخرین فایل bootstrap_4.17.09.sh را دانلود کنید، سپس یک همگام سازی جدید انجام دهید:

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

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

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

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

اگر باید نصب‌های مربوط به Edge 4.16.0x یا 4.17.01/4.17.05 را در مخزن 4.17.09 نگهداری کنید، می‌توانید یک مخزن حاوی تمام نسخه‌ها نگهداری کنید. از آن مخزن، می توانید هر نسخه ای از Edge را نصب کنید.

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

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

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

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

   apigee-mirror-4.17.09-0.0.xyz

2. از ابزار apigee-mirror برای دانلود Edge 4.16.0x/4.17.01/4.17/05 در مخزن خود استفاده کنید. به نحوه پیشوند دستور با نسخه مورد نظر توجه کنید:

   > apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

   از همین دستور برای به روز رسانی مخازن 4.16.0x/4.17.05 با مشخص کردن شماره نسخه های مورد نیاز استفاده کنید.

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