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

Edge for Private Cloud نسخه 4.16.05

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

ایجاد یک پیوند نمادین از /opt/apigee

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

قبل از ایجاد سیملینک، ابتدا باید یک کاربر و گروه با نام "apigee" ایجاد کنید. این همان گروه و کاربری است که توسط نصب کننده Edge ایجاد شده است.

برای ایجاد سیم لینک، این مراحل را قبل از دانلود فایل bootstrap_4.16.05.sh انجام دهید. شما باید تمام این مراحل را به عنوان روت انجام دهید:

1. کاربر و گروه "apigee" را ایجاد کنید:
   > groupadd -r apigee
   > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "کاربر پلتفرم Apigee" apigee
2. یک پیوند نمادین از /opt/apigee به ریشه نصب دلخواه خود ایجاد کنید:
   > ln -Ts /srv/myInstallDir /opt/apigee
   جایی که /srv/myInstallDir محل مورد نظر فایل های Edge است.
3. تغییر مالکیت root و symlink نصب به کاربر "apigee":
   > chown -h apigee:apigee /srv/myInstallDir /opt/apigee

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

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

• برای تنظیم موقت SELinux روی حالت مجاز، دستور زیر را اجرا کنید:
  1. در سیستم عامل لینوکس 6.x :
     echo 0 > /selinux/enforce
     
     برای فعال کردن مجدد SELinux پس از نصب Edge:
     echo 1 > /selinux/enforce
  2. در سیستم عامل لینوکس 7.x :
     setenforce 0
     
     برای فعال کردن مجدد SELinux پس از نصب Edge:
     نیروگاه 1
• برای غیرفعال کردن دائمی SELinux یا تنظیم آن در حالت مجاز:
  1. /etc/sysconfig/selinux را در یک ویرایشگر باز کنید.
  2. SELINUX=غیرفعال یا SELINUX=مجاز را تنظیم کنید
  3. ویرایش های خود را ذخیره کنید.
  4. گره را مجددا راه اندازی کنید.
  5. در صورت لزوم، SELinux را پس از نصب Edge با تکرار این روش برای تنظیم SELINUX=enabled دوباره فعال کنید.

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

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

1. نام کاربری و رمز عبوری را که برای دسترسی به مخزن Apigee استفاده می کنید، از Apigee دریافت کنید. اگر یک نام کاربری: رمز عبور برای سایت Apigee ftp دارید، می توانید از آن اعتبارنامه ها استفاده کنید.
2. برای نصب Edge RPM به عنوان root وارد گره خود شوید
   توجه : در حالی که نصب RPM به دسترسی ریشه نیاز دارد، می‌توانید پیکربندی Edge را بدون دسترسی ریشه انجام دهید.
3. همانطور که در بالا توضیح داده شد SELinux را غیرفعال کنید.
4. فایل Edge bootstrap_4.16.05.sh را در /tmp/bootstrap_4.16.05.sh دانلود کنید:
   > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
5. ابزار و وابستگی های Edge apigee-service را نصب کنید:
   > sudo bash /tmp/bootstrap_4.16.05.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*'
6. از apigee-service برای نصب ابزار apigee-setup استفاده کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
7. از apigee-setup برای نصب و پیکربندی اجزای Edge در گره استفاده کنید. برای اطلاعات بیشتر به نصب اجزای Edge روی یک گره مراجعه کنید.

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

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

توجه : Apigee همه وابستگی های شخص ثالث را در مخازن عمومی ما میزبانی نمی کند. شما باید این وابستگی ها را از مخازن در دسترس عموم دانلود و نصب کنید.

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

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

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

1. نام کاربری و رمز عبوری را که برای دسترسی به مخزن Apigee استفاده می کنید، از Apigee دریافت کنید. اگر یک نام کاربری: رمز عبور برای سایت Apigee ftp دارید، می توانید از آن اعتبارنامه ها استفاده کنید.
2. برای نصب RPM های Edge به عنوان root وارد گره RedHat یا CentOS خود شوید.
   توجه : در حالی که نصب RPM به دسترسی ریشه نیاز دارد، می‌توانید پیکربندی Edge را بدون دسترسی ریشه انجام دهید.
3. مطمئن شوید که آخرین نسخه yum-utils را دارید:
   > sudo yum به روز رسانی yum-utils
4. همانطور که در بالا توضیح داده شد SELinux را غیرفعال کنید.
5. فایل Edge bootstrap_4.16.05.sh را در /tmp/bootstrap_4.16.05.sh دانلود کنید:
   > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
6. ابزار و وابستگی های Edge apigee-service را نصب کنید:
   > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser= uName apigeepassword= pWord
   
   که در آن uName:pWord نام کاربری و رمز عبوری است که از Apigee دریافت کرده اید. اگر pWord را حذف کنید، از شما خواسته می شود آن را وارد کنید.
7. ابزار apigee-mirror را روی گره نصب کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
8. از ابزار apigee-mirror برای همگام سازی مخزن Apigee با پوشه /opt/apigee/data/apigee-mirror/repos/ استفاده کنید.
   
   برای به حداقل رساندن اندازه مخزن، RPM های --only-new-rpm را اضافه کنید تا فقط آخرین 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 را از مخزن محلی توضیح می دهد.
9. (اختیاری) اگر می خواهید Edge را از مخزن محلی روی همان گره ای که میزبان مخزن محلی است نصب کنید، ابتدا باید دستورات زیر را اجرا کنید:
   1. برای نصب ابزار apigee-service، bootstrap_4.16.05.sh را از مخزن محلی اجرا کنید:
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.16.05.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.16.05.tar.gz استفاده کنید:
   
   > /opt/apigee/apigee-service/bin/apigee-service بسته apigee-mirror
2. فایل tar را در گره ای که می خواهید Edge را نصب کنید کپی کنید. به عنوان مثال، آن را در پوشه /tmp در گره جدید کپی کنید.
3. در گره جدید، SELinux را همانطور که در بالا توضیح داده شد غیرفعال کنید.
4. در گره جدید، فایل را در پوشه /tmp untar کنید:
   > tar -xzf apigee-4.16.05.tar.gz
   
   این دستور یک دایرکتوری جدید به نام repos در دایرکتوری حاوی فایل tar ایجاد می کند. به عنوان مثال /tmp/repos.
5. ابزار و وابستگی های Edge apigee-service را از /tmp/repos نصب کنید:
   > sudo bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
   
   توجه داشته باشید که مسیر دایرکتوری repos را در این دستور قرار داده اید.
6. از apigee-service برای نصب ابزار apigee-setup استفاده کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
7. از 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 راه اندازی مجدد
3. به طور پیش فرض، مخزن به یک نام کاربری: رمز عبور admin:admin نیاز دارد. برای تغییر این اعتبار، متغیرهای محیطی زیر را تنظیم کنید:
   MIRROR_USERNAME=uName
   MIRROR_PASSWORD=pWord
4. در گره جدید، SELinux را همانطور که در بالا توضیح داده شد غیرفعال کنید.
5. در گره راه دور، فایل Edge bootstrap_4.16.05.sh را در /tmp/bootstrap_4.16.05.sh دانلود کنید:
   > /usr/bin/curl http:// uName:pWord @ remoteRepo :3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
   
   که در آن uName:pWord نام کاربری و رمز عبوری است که در بالا برای مخزن تنظیم کرده اید و remoteRepo آدرس IP یا نام DNS گره repo است.
6. در گره راه دور، ابزار Edge apigee-service و وابستگی ها را نصب کنید:
   > sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost= remoteRepo :3939 apigeeuser= uName apigeepassword= pWord apigeeprotocol=http://
   
   که در آن u Name:pWord نام کاربری و رمز عبور مخزن است.
7. در گره راه دور، از apigee-service برای نصب ابزار apigee-setup استفاده کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
8. از apigee-setup برای نصب و پیکربندی اجزای Edge در گره راه دور استفاده کنید. برای اطلاعات بیشتر به نصب اجزای Edge روی یک گره مراجعه کنید.

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

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

1. فایل Edge bootstrap_4.16.05.sh را در /tmp/bootstrap_4.16.05.sh دانلود کنید:
   > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
2. انجام همگام سازی:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
3. اگر می خواهید کل مخزن را دانلود کنید:
   > /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.01 را در مخزن 4.16.05 اضافه یا به روز کنید

اگر باید نصب‌ها را برای Edge 4.16.05 و 4.16.01 حفظ کنید، می‌توانید یک مخزن حاوی هر دو نسخه نگهداری کنید. از آن مخزن، می توانید Edge 4.16.05 و 4.16.01 را نصب کنید.

برای افزودن 4.16.01 به مخزن 4.15.05:

1. مطمئن شوید که نسخه 4.16.05 ابزار apigee-mirror را نصب کرده اید:
   > /opt/apigee/apigee-service/bin/apigee-service نسخه apigee-mirror
   
   شما باید یک نتیجه را در فرم زیر مشاهده کنید، جایی که xyz شماره ساخت است:
   apigee-mirror- 4.16.05-0.0. xyz
2. از ابزار apigee-mirror برای دانلود Edge 4.16.01 در مخزن خود استفاده کنید. به نحوه پیشوند دستور با apigeereleasever=4.16.01 توجه کنید:
   > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
   
   از همین دستور برای آپدیت کردن مخزن 4.16.01 استفاده کنید.
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 شخص ثالث
   
   توجه کنید که چگونه یک فایل بوت استرپ برای هر دو نسخه Edge دارید. دایرکتوری apigee همچنین شامل دایرکتوری های جداگانه برای هر نسخه از Edge است.
4. برای بسته بندی مخزن در یک فایل tar، از دستور زیر استفاده کنید:
   > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service بسته apigee-mirror
   
   این دستور مخازن 4.16.05 و 4.16.01 را در یک فایل tar بسته بندی می کند. شما نمی توانید تنها بخشی از مخزن را بسته بندی کنید.

برای نصب Edge از فایل repo یا .tar محلی، فقط مطمئن شوید که فایل بوت استرپ صحیح را با استفاده از یکی از دستورات زیر اجرا کنید:

• در صورت نصب از فایل tar، فایل بوت استرپ صحیح را از مخزن اجرا کنید:
  > sudo bash /tmp/repos/ bootstrap_4.16.0X.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  برای تکمیل نصب، مراحل باقی مانده از «نصب از فایل .tar» در بالا را دنبال کنید.
• در صورت نصب با استفاده از وب سرور Nginx، فایل بوت استرپ صحیح را از مخزن دانلود و اجرا کنید:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/ bootstrap_4.16.0X.sh -o /tmp/ bootstrap_4.16.0X.sh
  > sudo bash /tmp/ bootstrap_4.16.0X.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  برای تکمیل نصب، مراحل باقی مانده از «نصب از مخزن با استفاده از وب سرور Nginx» در بالا را دنبال کنید.