Редактирования файла описания хостинга

Файл описания хостинга может иметь формат YAML или JSON и содержит список учетных записей клиентов, подписок, дополнительных доменов, почтовых ящиков и так далее, которые надо перенести с исходного сервера. Вы можете найти примеры файлов описания хостинга здесь. В этом разделе мы расскажем о том, как задать ряд часто используемых параметров, чтобы обеспечить успех миграции.

Указание пути к данным веб-контента

Чтобы указать путь к данным веб-контента на исходном и целевом серверах, используйте следующие параметры в разделе subscriptions:

  • source_webspace_root - абсолютный путь к папке, содержащей все файлы, доступные клиенту на исходном сервере. Может быть задан только на уровне подписки (например, /home/vhosts/example.com).
  • source_document_root - абсолютный путь к папке, содержащей только файлы, доступные по HTTP. Может быть задан на уровне подписки, дополнительного домена или субдомена (например, /home/vhosts/example.com/httpdocs).
  • target_document_root - папка, которая содержит файлы, доступные по HTTP на целевом сервере. Путь указывается относительно корня подписки на целевом сервере. Может быть задан на уровне подписки, дополнительного домена или субдомена (например, data/www. Если имя домена - example.com, а папка виртуальных серверов в Plesk - /var/www/vhosts, то абсолютный путь к корневой папке на целевом сервере будет /var/www/vhosts/example.com/data/www). Если не указывать этот параметр, будет использовано значение по умолчанию для Plesk.

Примечание. Если файл конфигурации не содержит информации о доступе к исходному серверу, папки source_webspace_root и source_document_root будут рассматриваться как локальные на целевом сервере.

Если вам необходимо исключить некоторые папки или файлы из миграции, используйте директиву exclude с параметрами source_webspace_root и source_document_root. Например:

subscriptions:
 -
 name: example.com
 source_webspace_root: 
 path: /home/vhosts/example.com
 exclude:
 -
 /bin
 - 
 /logs

Синтаксис правил исключения такой же, как используется в утилите rsync. Его описание можно найти в документации rsync - смотрите подробную информацию в разделе Include/Exclude Pattern Rules.

Если вам необходимо точно указать, в какой папке на целевом сервере будет расположен веб-контент из конкретной папки на исходном сервере, используйте сопоставление веб-файлов. Например:

subscriptions:
 -
 name: example.com
 target_document_root: data/www
 web_files:
 -
 source: /home/vhosts/example.com
 target: "{webspace_root}"
 -
 source: /home/vhosts/example.com/httpdocs
 target: "{document_root}"

Директива target используется, чтобы указать либо абсолютный путь на целевом сервере, либо строку формата, содержащую одну или более переменных-шаблонов из таблицы ниже.

Переменные-шаблоны и их значения для подписки – то есть для случая, когда элемент web_files находится непосредственно под элементом subscription:

Переменная-шаблон Значение Область применения

{anon_ftp_incoming}

Путь к папке, доступной для загрузки данных по анонимному FTP

Только Linux

{anon_ftp_pub}

Путь к папке, доступной для чтения по анонимному FTP

Только Linux

{cgi_bin}

Путь к папке cgi-bin подписки

Только Linux

{document_root}

Путь к корневой папке подписки - папке, доступной по HTTP

Linux и Windows

{logs}

Путь к папке с журналами (доступа к Apache, ошибок и т.п.)

Linux и Windows

{main_domain_private}

Частная папка основного домена

Только Windows

{main_domain_statistics}

Папка со статистикой основного домена (AWStats, Webalizer и т.п.)

Только Windows

{protected_dirs}

Путь к папке с настройками защищенных папок

Только Linux

{ssl_document_root}

Путь к защищенной корневой папке подписки - папке, доступной по HTTPS

Только Windows

{statistics}

Путь к папке с файлами статистики (AWStats, Webalizer и т.п.)

Только Linux

{webspace_idn}

Имя подписки, закодированное в punycode

Linux и Windows

{webspace_root}

Путь к корню подписки

Linux и Windows

{webspace}

Название подписки

Linux и Windows

Переменные-шаблоны и их значения для дополнительных доменов и субдоменов - то есть для случаев, когда элемент web_files находится под элементом addon domain или subdomain:

Переменная-шаблон Значение Область применения

{cgi_bin}

Путь к папке cgi-bin дополнительного домена/субдомена

Только Linux

{document_root}

Путь к корневой папке дополнительного домена/субдомена

Linux и Windows

{logs}

Путь к папке с журналами (доступа к Apache, ошибок и т.п.) дополнительного домена/субдомена

Только Linux

{protected_dirs}

Путь к папке с настройками защищенных папок дополнительного домена/субдомена

Только Linux

{site_idn}

Имя дополнительного домена/субдомена, закодированное в punycode

Linux и Windows

{site}

Имя дополнительного домена/субдомена

Linux и Windows

{statistics}

Путь к папке с файлами статистики (AWStats, Webalizer и т.п.) дополнительного домена/субдомена

Linux и Windows

{webspace_anon_ftp_incoming}

Путь к папке, доступной для загрузки данных по анонимному FTP, в родительской подписке

Только Linux

{webspace_anon_ftp_pub}

Путь к папке, доступной для чтения по анонимному FTP, в родительской подписке

Только Linux

{webspace_cgi_bin}

Путь к папке cgi-bin родительской подписки

Только Linux

{webspace_document_root}

Путь к корню родительской подписки

Linux и Windows

{webspace_idn}

Имя родительской подписки, закодированное в punycode

Linux и Windows

{webspace_logs}

Путь к папке с журналами (доступа к Apache, ошибок и т.п.) родительской подписки

Linux и Windows

{webspace_protected_dirs}

Путь к папке с настройками защищенных папок родительской подписки

Только Linux

{webspace_root}

Путь к корню родительской подписки

Linux и Windows

{webspace_ssl_document_root}

Путь к защищенной корневой папке родительской подписки - папке, доступной по HTTPS

Только Windows

{webspace_statistics}

Путь к папке с файлами статистики (AWStats, Webalizer и т.п.) родительской подписки

Только Linux

{webspace}

Название родительской подписки

Linux и Windows

Указание пути к данным почтового контента

Механизм переноса почтового контента с исходного сервера на целевой работает по-разному в Linux и в Windows.

В Linux вам надо указать информацию о почтовых ящиках, которые надо перенести, в разделе mail_users:

mail_users:
  -
    name: johndoe
    password: 123qwe
    directory: /var/qmail/mailnames/johndoe

где "directory" означает абсолютный путь к папке, где хранится почтовый контент на исходном сервере, или куда он был помещен после переноса вручную на целевой сервер.

В Windows в файле описания хостинга ничего указывать не надо. Весь почтовый контент будет перенесен с использованием механизмов резервного копирования и восстановления Plesk.

Примечание. В Windows Plesk Migrator не имеет возможности импортировать почтовый контент, который был вручную перенесен на целевой сервер. Чтобы перенести почтовый контент, необходимо иметь доступ к исходному серверу.

Указание пути к базам данных

Plesk Migrator позволяет переносить базы данных MySQL и Microsoft SQL Server во время миграции с других платформ. Есть два способа копирования содержимого баз данных:

  • Скопировать содержимое напрямую, если имеется доступ к серверу баз данных.
  • Восстановить содержимое из файла дампа базы данных.

Для того, чтобы можно было скопировать содержимое напрямую с сервера баз данных, необходимо перечислить это содержимое в конфигурационном файле Plesk Migrator и указать информацию, необходимую для доступа к серверу. Используйте параметр server в разделе databases:

databases:
  -
    server: mysql-db
    name: wordpress_9
    users:
      -
        login: exdbuser1
        password: 123qwe
  -
    server: mssql-db
    name: drupal_2
    users:
      -
        login: exdbuser2
        password: 123qwe

или

-
  name: wordpress_9
  dump: wordpress_9.sql
  users:
    -
      login: exdbuser1

Для восстановления содержимого из файла дампа базы данных необходимо, чтобы дамп был создан в специальном формате:

  • Для MySQL дамп можно создать, например, с помощью утилиты mysqldump.
  • Для Microsoft SQL Server используйте конструкцию "BACKUP" языка T-SQL.

Чтобы восстановить дамп, укажите опцию dump, как в этом примере:

-
 name: wordpress_9
 dump: wordpress_9.sql
 user:
 login: exdbuser1

Примечание. Перенос баз данных Microsoft SQL Server возможен, только если имя хоста экземпляра Microsoft SQL Server на исходном сервере может быть определено с целевого сервера.

 

Leave your feedback on this topic here

If you have questions or need support, please visit the Plesk forum or contact your hosting provider.
The comments below are for feedback on the documentation only. No timely answers or help will be provided.