پشتیبان‌گیری از درگاه

این بخش نحوه پشتیبان‌گیری و بازیابی نصب داخلی درگاه «سرویس‌های توسعه‌دهنده Apigee» (یا به‌طور خلاصه، درگاه) را بااستفاده از فرمان‌های Postgres pg_dump و pg_restore شرح می‌دهد.

قبل‌از پشتیبان‌گیری

قبل‌از اینکه بتوانید از پورتال پشتیبان‌گیری کنید، باید نام پایگاه داده پورتال را بدانید.

ویژگی PG_NAME در فایل پیکربندی نصب درگاه، نام پایگاه داده درگاه را مشخص می‌کند. فایل پیکربندی نمونه در دستورالعمل‌های نصب درگاه از نام «devportal» استفاده می‌کند. اگر از نام پایگاه داده مطمئن نیستید، فایل پیکربندی را بررسی کنید یا از فرمان psql زیر برای نمایش فهرست پایگاه‌های داده استفاده کنید:

psql -h localhost -d apigee -U postgres -l

که -U نام کاربری Postgres را که درگاه برای دسترسی به پایگاه داده استفاده می‌کند مشخص می‌کند. این مقدار ویژگی DRUPAL_PG_USER در فایل پیکربندی نصب درگاه است. گذرواژه پایگاه داده از شما درخواست خواهد شد.

این فرمان فهرست پایگاه‌های داده زیر را نمایش می‌دهد:

    Name     | Owner  | Encoding |   Collate   |    Ctype    |  Access privileges  
-------------+--------+----------+-------------+-------------+---------------------
 apigee      | apigee | UTF8     | en_US.UTF-8 | en_US.UTF-8 | =Tc/apigee         +
             |        |          |             |             | apigee=CTc/apigee  +
             |        |          |             |             | postgres=CTc/apigee
 devportal   | apigee | UTF8     | en_US.UTF-8 | en_US.UTF-8 | 
 newportaldb | apigee | UTF8     | en_US.UTF-8 | en_US.UTF-8 | 
 postgres    | apigee | UTF8     | en_US.UTF-8 | en_US.UTF-8 | 
 template0   | apigee | UTF8     | en_US.UTF-8 | en_US.UTF-8 | =c/apigee          +
             |        |          |             |             | apigee=CTc/apigee
 template1   | apigee | UTF8     | en_US.UTF-8 | en_US.UTF-8 | =c/apigee          +
             |        |          |             |             | apigee=CTc/apigee

پشتیبان‌گیری از درگاه

برای پشتیبان‌گیری از درگاه:

1. به فهرست Drupal بروید، /opt/apigee/apigee-drupal به‌طور پیش‌فرض:

   cd /opt/apigee/apigee-drupal

2. بااستفاده از فرمان pg_dump، از نمونه پایگاه داده Drupal خود پشتیبان‌گیری کنید:

   pg_dump --dbname=portal_db --host=host_IP_address --username=drupaladmin
     --password --format=c > /tmp/portal.bak

   مکان:

   • portal_db نام پایگاه داده است. این ویژگی PG_NAME در فایل پیکربندی نصب پورتال است. اگر از نام پایگاه داده مطمئن نیستید، پیش‌از پشتیبان‌گیری را ببینید.
   • host_IP_address نشانی IP گره درگاه است.
   • drupaladmin نام کاربری Postgres است که درگاه برای دسترسی به پایگاه داده استفاده می‌کند. این مورد را با ویژگی DRUPAL_PG_USER در فایل پیکربندی نصب درگاه تعریف کرده‌اید.

   وقتی pg_dump از شما گذرواژه کاربر Postgres را درخواست کرد، از گذرواژه‌ای استفاده کنید که با ویژگی DRUPAL_PG_PASS در فایل پیکربندی نصب درگاه مشخص کرده‌اید.

   فرمان pg_dump نسخه‌ای از پایگاه داده ایجاد می‌کند.

3. از کل دایرکتوری ریشه وب Drupal خود نسخه پشتیبان تهیه کنید. مکان پیش‌فرض webroot /opt/apigee/apigee-drupal/wwwroot است.
4. از فایل‌های عمومی نسخه پشتیبان تهیه کنید. به‌طور پیش‌فرض، این فایل‌ها در /opt/apigee/apigee-drupal/wwwroot/sites/default/files قرار دارند. اگر مکان درست باشد، در «مرحله ۳» پشتیبان‌گیری خواهند شد. اگر آن‌ها را از مکان پیش‌فرض منتقل کرده‌اید، باید صریحاً از آن‌ها پشتیبان‌گیری کنید.
5. از فایل‌های خصوصی در /opt/apigee/data/apigee-drupal-devportal/private نسخه پشتیبان تهیه کنید.

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

بازیابی درگاه

پس‌از پشتیبان‌گیری از درگاه، می‌توانید بااستفاده از فرمان pg_restore، از نسخه پشتیبان بازیابی کنید.

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

pg_restore --clean --dbname=portal_db --host=localhost --username=apigee < /tmp/portal.bak

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

pg_restore --clean --create --dbname=portal_db --host=localhost --username=apigee < /tmp/portal.bak

همچنین می‌توانید فایل‌های پشتیبان را در دایرکتوری ریشه وب Drupal و فایل‌های خصوصی بازیابی کنید.