این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

پورتال را ارتقا دهید، پورتال را ارتقا دهید

این روش نحوه ارتقاء یک پورتال موجود Apigee Developer Services (یا به سادگی، پورتال ) را در محل نصب توضیح می دهد.

توجه: تمام نصب های جدید پورتال از نسخه 4.17.01 به بعد از Postgres به عنوان پایگاه داده و Nginx به عنوان وب سرور استفاده می کنند. با این حال، نسخه های قبلی پورتال از MySQL/MariaDB به عنوان پایگاه داده و وب سرور آپاچی استفاده می کنند. این بدان معناست که پورتال فعلی شما ممکن است از یکی از تنظیمات زیر استفاده کند:

Nginx/Postgres برای همه نصب‌های جدید 4.17.0x، 4.18.0x و 4.50.00
Apache/MySQL 5.0.15 یا بالاتر برای همه سیستم عامل های 6.x قبلی تا 4.17.01
Apache/MariaDB 5.1.38 یا جدیدتر برای همه سیستم عامل های 7.x قبلی تا 4.17.01

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

روش صحیح به روز رسانی را تعیین کنید

روشی که برای به روز رسانی پورتال استفاده می کنید بر اساس نصب فعلی شما است:

اگر نصب شما از Nginx/Postgres استفاده می کند ، از ارتقاء یک پورتال با استفاده از RPM های زیر استفاده کنید.
اگر نصب شما از Apache/MySQL یا Apache/MariaDB استفاده می کند ، سپس به تبدیل پورتال مبتنی بر tar به پورتال مبتنی بر RPM مراجعه کنید.

نوع نصب فعلی خود را تعیین کنید

اگر در مورد نوع نصب فعلی خود مطمئن نیستید، از دستور زیر برای تعیین آن استفاده کنید:

```
ls /opt
```
اگر از Nginx/Postgres استفاده می کنید، دایرکتوری های زیر را مشاهده خواهید کرد: /opt/apigee و /opt/nginx .
اگر از Apache/MySQL یا Apache/MariaDB استفاده می کنید، این دایرکتوری ها نباید وجود داشته باشند.

/opt/apigee/apigee-service/bin/apigee-all status

اگر از Nginx/Postgres استفاده می کنید، خروجی زیر را مشاهده خواهید کرد:

+ apigee-service
apigee-drupal-devportal status
OK: apigee-drupal-devportal is up and running
+ apigee-service apigee-lb status
apigee-service: apigee-lb: OK
+ apigee-service apigee-postgresql status
apigee-service: apigee-postgresql: OK

```
apachectl -S
```
اگر از Apache/MySQL یا Apache/MariaDB استفاده می کنید، این دستور باید دایرکتوری ریشه وب پورتال را به شکل زیر برگرداند:
```
*:80
192.168.56.102 (/etc/httpd/conf/vhosts/devportal.conf:1)
```

دایرکتوری نصب پیش فرض

فرآیند ارتقاء فرض می کند که پورتال در این آدرس نصب شده است:

4.17.05 و جدیدتر: /opt/apigee/apigee-drupal/wwwroot
قبل از 4.17.05: /opt/apigee/apigee-drupal (Nginx) یا /var/www/html (Apache)

اگر پورتال را در دایرکتوری پیش فرض نصب نکرده اید، مسیرهای رویه زیر را برای استفاده از دایرکتوری نصب خود تغییر دهید.

نسخه های ارتقاء پشتیبانی شده

این روش ارتقا در نسخه های پورتال OPDK-17-01.x و جدیدتر پشتیبانی می شود.

برای تعیین نسخه پورتال خود، URL زیر را در مرورگر باز کنید:

http:// yourportal.com /buildInfo

توجه: اگر به دلایلی فایل buildInfo حذف کردید، می توانید نسخه را از فایل profiles/apigee/apigee.info تعیین کنید. محل نصب پیش‌فرض /var/www/html/profiles/apigee/apigee.info است، اما اگر پورتال را در پوشه‌ای غیر از /var/www/html نصب کرده باشید، ممکن است در زمان نصب آن را تغییر داده باشید. فایل apigee.info حاوی یک خط به شکل زیر است که حاوی نسخه است:

version = "OPDK-4.17.05"

قبل از آپدیت

برای نصب‌های موجود، اگر کدی را در هسته دروپال یا هر ماژول غیر سفارشی تغییر داده باشید، تغییرات شما رونویسی می‌شوند. این شامل موارد دیگر، هر تغییری است که ممکن است در .htaccess . شما باید فرض کنید که هر چیزی خارج از فهرست /sites متعلق به دروپال است. یک استثنا از این قانون robots.txt است. اگر این فایل در ریشه وب وجود داشته باشد، برای شما حفظ خواهد شد.

قبل از ادامه نصب، از کل فهرست اصلی وب دروپال خود یک نسخه پشتیبان تهیه کنید. پس از انجام مراحل نصب شرح داده شده در زیر، می توانید سفارشی سازی های خود را از پشتیبان بازیابی کنید.

یک پورتال را با استفاده از RPM ارتقا دهید

برای به روز رسانی RPM پورتال در یک گره:

به طور پیش فرض به دایرکتوری دروپال، /opt/apigee/apigee-drupal تغییر دهید:
```
cd /opt/apigee/apigee-drupal
```
از نمونه پایگاه داده دروپال خود نسخه پشتیبان تهیه کنید. دستور pg_dump یک کپی از پایگاه داده ایجاد می کند:
```
pg_dump --dbname=devportal --host=host_IP_address --username=drupaladmin
  --password --format=c > /tmp/portal.dmp
```
کجا:
- devportal نام پایگاه داده است که توسط ویژگی PG_NAME در فایل پیکربندی نصب پورتال مشخص شده است.
- host_IP_address آدرس IP گره پورتال است.
- drupaladmin نام کاربری Postgres است که توسط پورتال برای دسترسی به پایگاه داده همانطور که توسط ویژگی DRUPAL_PG_USER در فایل پیکربندی نصب پورتال مشخص شده است استفاده می کند.
از شما خواسته می شود رمز عبور کاربر Postgres را همانطور که توسط ویژگی DRUPAL_PG_PASS در فایل پیکربندی نصب پورتال تعریف شده است، وارد کنید.
اگر بعداً می خواهید از نسخه پشتیبان بازیابی کنید، از دستور زیر استفاده کنید:
```
pg_restore --clean --dbname=devportal --host=localhost  --username=apigee < /tmp/portal.dmp
```
از کل فهرست اصلی وب دروپال خود یک نسخه پشتیبان تهیه کنید. محل نصب پیش فرض /opt/apigee/apigee-drupal است، اما ممکن است آن را تغییر داده باشید.
اگر از مکان این دایرکتوری مطمئن نیستید، از دستور drush status یا Configuration > Media > File entry در منوی Drupal برای تعیین مکان سیستم فایل عمومی و مسیر سیستم فایل خصوصی (برای مرحله بعدی) استفاده کنید.
نکته: قبل از پشتیبان‌گیری، بررسی کنید که آیا هدف پشتیبان‌گیری، پیوند نرم (یا پیوند نمادین) به فایل‌های واقعی است یا خیر. برای انجام این کار، زمانی که محتوای یک فهرست را فهرست می کنید، به دنبال نوع فایل l بگردید. در مثال زیر، دایرکتوری های دوم و چهارم پیوندهای نمادین هستند (نوع فایل در ابتدای لیست مجوزها نشان داده شده است):
```
ls -l /opt/apigee
drwxr-xr-x. 16 apigee   apigee  195 Jan 29 15:49 edge-qpid-server-4.19.06-0.0.20013
lrwxrwxrwx.  1 apigee   apigee   41 Jan 12 08:18 edge-router -> /opt/apigee/edge-router-4.19.06-0.0.20013
drwxr-xr-x. 15 apigee   apigee  195 Jan 29 15:50 edge-router-4.19.06-0.0.20013
lrwxrwxrwx.  1 apigee   apigee   37 Jan  9 17:13 edge-ui -> /opt/apigee/edge-ui-4.19.06-0.0.20115
```
اگر هدفی که می‌خواهید از آن نسخه پشتیبان تهیه کنید، یک لینک نرم‌افزاری است، پس باید پیوندها را برای پشتیبان‌گیری از محتوای واقعی حذف کنید. نحوه انجام این کار به ابزاری که برای انجام پشتیبان استفاده می کنید بستگی دارد. به عنوان مثال، اگر از tar استفاده می کنید، از گزینه -h استفاده کنید، همانطور که در مثال زیر نشان داده شده است:
```
tar -hcfz /etc/my-drupal-backup.tar.gz /opt/apigee/apigee-drupal
```
یک نسخه پشتیبان از فایل ها در /opt/apigee/data/apigee-drupal-devportal/private تهیه کنید.
دروپال را روی حالت نگهداری تنظیم کنید:
1. در منوی دروپال گزینه Configuration را انتخاب کنید.
2. در صفحه پیکربندی ، حالت Maintenance را در قسمت توسعه انتخاب کنید.
3. کادر Put site into maintenance mode را انتخاب کنید.
4. پیامی را وارد کنید که کاربران در حین نگهداری مشاهده می کنند.
5. Save configuration را انتخاب کنید.
همانطور که در Install the Edge apigee-setup utility توضیح داده شد SELinux را غیرفعال کنید.
به پوشه /opt تغییر دهید:
```
cd /opt
```
برای ارتقا در سرور با اتصال اینترنت:
1. فایل Edge 4.50.00 bootstrap_4.50.00.sh را در /tmp/bootstrap_4.50.00.sh دانلود کنید:
```
curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
```
2. ابزار Edge 4.50.00 apigee-service و وابستگی ها را نصب کنید:
```
sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
```
  جایی که uName و pWord نام کاربری و رمز عبوری است که از Apigee دریافت کرده‌اید. اگر pWord حذف کنید، از شما خواسته می شود آن را وارد کنید.
  به طور پیش فرض، نصب کننده بررسی می کند که جاوا 1.8 را نصب کرده اید. برای ادامه بدون نصب جاوا می توانید از گزینه "C" استفاده کنید.
برای ارتقا در سرور بدون اتصال به اینترنت:
1. یک مخزن محلی 4.50.00 همانطور که در Create a local Apigee repository توضیح داده شده است ایجاد کنید.
  توجه : اگر قبلاً یک مخزن موجود دارید، می‌توانید مخزن 4.50.00 را همانطور که در «به‌روزرسانی یک مخزن محلی Apigee» در نصب ابزار Edge apigee-setup توضیح داده شده است، به آن اضافه کنید.
2. برای نصب apigee-service از فایل tar :
  1. در گره دارای مخزن محلی، از دستور زیر برای بسته بندی مخزن محلی در یک فایل .tar به نام /opt/apigee/data/apigee-mirror/apigee-4.50.00.tar.gz استفاده کنید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
  2. فایل tar را در گره ای که می خواهید Edge را به روز کنید کپی کنید. به عنوان مثال، آن را در پوشه /tmp در گره جدید کپی کنید.
  3. در گره جدید، فایل را در پوشه /tmp untar کنید:
```
tar -xzf apigee-4.50.00.tar.gz
```
    این دستور یک دایرکتوری جدید به نام repos در دایرکتوری حاوی فایل tar ایجاد می کند. به عنوان مثال /tmp/repos.
  4. ابزار و وابستگی های Edge apigee-service از /tmp/repos نصب کنید:
```
sudo bash /tmp/repos/bootstrap_4.50.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
    توجه داشته باشید که مسیر دایرکتوری repos را در این دستور قرار داده اید.
3. برای نصب apigee-service با استفاده از وب سرور Nginx:
  1. وب سرور Nginx را همانطور که در «نصب از مخزن با استفاده از وب سرور Nginx» در نصب ابزار Edge apigee-setup توضیح داده شده پیکربندی کنید.
  2. در گره راه دور، فایل Edge bootstrap_4.50.00.sh را در /tmp/bootstrap_4.50.00.sh دانلود کنید:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.50.00.sh
  -o /tmp/bootstrap_4.50.00.sh
```
    جایی که uName و pWord نام کاربری و رمز عبوری است که در بالا برای مخزن تنظیم کرده‌اید، و remoteRepo آدرس IP یا نام DNS گره repo است.
  3. در گره راه دور، ابزار Edge apigee-service و وابستگی ها را نصب کنید:
```
sudo bash /tmp/bootstrap_4.50.00.sh apigeerepohost=remoteRepo:3939
  apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
    جایی که uName و pWord نام کاربری و رمز عبور مخزن هستند.
از apigee-service برای به روز رسانی ابزار apigee-setup استفاده کنید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
ابزار update را در گره Postgres خود اجرا کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
جایی که configFile فایل پیکربندی است که برای نصب پایگاه داده Postgres استفاده کردید. تنها مورد نیاز فایل پیکربندی این است که فایل پیکربندی باید توسط کاربر "apigee" قابل دسترسی یا خواندن باشد.