Plesk 迁移的配置文件

Plesk for Linux 的配置文件

该配置文件只包括执行迁移必需的基本信息:

[GLOBAL]
源类型plesk
source-servers: pfu
目标类型plesk

[plesk]
ip:
os: unix

[pfu]
ip:
os: unix
ssh-password:

该配置文件包含高级设置,能够调整迁移的很多方面:

[GLOBAL]
# 该节会定义迁移前的全局设置。

# [mandatory, non-modifiable] 源类型
# 源服务器的产品类型。
#
# 这是一个配置文件的模板,用于从Plesk Panel 迁移到
# Plesk Panel. 对于其它的源或目标面板,请浏览其它提供的
# 配置模板并挑选一个适合您源类型的。
源类型plesk

# [mandatory] 源
# 一个以逗号隔开的节列表,用于描述源Plesk Panel
# 服务器。在该设置中您可以指定一个或多个Plesk for Unix
# 和/或 Plesk for Windows 服务器。
#
# 该列表中节名称的顺序很重要:Plesk 服务器,
# 节列举越靠前,在有冲突时享有优先权。
源:pfu

# [optional] session-dir
# 用于迁移工具临时文件的目录。
# 如未指定,临时文件会被放入 './migration-session'。
# session-dir: migration-session

# [optional] zones-ttl
# 时间,以秒为单位,迁移工具设置用作 SOA minimum TTL 和
# 新的DNS 服务器上的刷新间隔。
# 如未指定,会使用默认值:120
# zones-ttl: 120

# [optional] external-dns-server
# 允许递归 DNS 查询的外部DNS服务器的IPv4地址。
# 迁移工具会使用指定的地址测试常规互联网
# 用户是否可以为迁移的域名获取正确的DNS 记录。如果
# 未指定任何值,迁移工具将使用 Google DNS server (8.8.8.8)。
# 如指定 'none',迁移工具将跳过测试。
# external-dns-server: 8.8.8.8

# [optional] mail-messages-delta-limit
# 迁移后邮件检测会对比源
# 和目标邮箱中的信息数量。如果信息数量差异超过
# 在"mail-messages-delta-limit"中指定的,则视作一个错误。
# 如未指定该选项,则使用默认值:10
# mail-messages-delta-limit: 10

# [optional] website-availability-check-timeout
# 这是迁移器在迁移后测试网站可用性时使用
# 超时时间。如未指定,则会使用默认值:30
# website-availability-check-timeout: 30

# [optional] website-availability-depth
# 迁移后测试网站可用性时检查的链接的最大深度。
# 例如,深度2 表示检查主页面和所有子页面,而深度3 表示检查
# 主页面、主页面的子页面和子页面的子页面。
# 如未指定,会使用默认值:2. 增加值将会增加时间
# 要执行迁移后检查,但是将要扩大测试页面的覆盖度。
# website-availability-depth: 2

# [optional] website-availability-group-directories
# 迁移后测试页面可用性时是否按相同目录和文件扩展名
# 分组文件。如果启用,主要页面会包含 2 个链接 '/subdir/a.php' 和
# '/subdir/b.php', 将只检查其中一个。如果文件仍在不同的目录中
# (e.g. '/subdir1/a.php' and '/subdir2/b.php') 或有不同的扩展名
# (e.g. '/subdir/a.php' and '/subdir/b.aspx'), 都将被检查。
# 如未指定,默认值为false。启用该选项将会加速检查,但是
# 减少测试页面的覆盖度。
# website-availability-group-directories: false

# [optional] log-message-context-length
# 当记录多行输出 (API 请求,相应), 只显示前 N
# 和最后 N 行。默认值为 0,表示显示完整的API 请求。
# log-message-context-length: 10

# [optional] use-hosting-analyser
# 如果您要分析主机并检测复制内容的的最优算法,设置
# 该选项为 'True'。该选项的默认值为 'True'.
# use-hosting-analyser: True

# [optional] use-math-analyse
# 如果您要分析主机并检测复制内容的的最优算法,设置
# 该选项为'True'。该选项的默认值为 'True'.
# 否则将使用 "matrix of strategies" 算法
# use-math-analyse: True

# [optional] hosting-analysis-ttl
# 时间(以秒为单位), 迁移工具设置用于主机
# 分析结果的最小时间。
# 如未指定,会使用默认值:900
# hosting-analysis-ttl: 900

# [optional] skip-migrator-updates
# 不要检查迁移器 repository 查看更新。默认值为'False'
# skip-migrator-updates: false

# [optional] event-scripts-dir
# 应在迁移事件进行中启动的带有脚本/可执行文件的目录
# 默认为 $VAR_DIR/events,其中 VAR_DIR 是 /usr/local/psa/var/modules/panel-migrator/ for Unix
# event-scripts-dir:

# [optional] use-separate-log
# 将迁移器日志写入会话目录而不是全局日志目录。
# 默认为true.
# use-separate-log: true

# [optional] adjust-applications
# 是否修复web应用常用的配置文件。
# 该修复包括数据库连接更改、路径修复,等等。
# 默认启用该选项。如果影响迁移某些应用,或您需要加快迁移可
# 禁用该选项。
# adjust-applications: true

# [optional] courier-to-dovecot-migration
# 当从Courier 迁移到 Dovecot 时是否转换邮件目录文件。
# 如果启用了该选项,而邮件目录文件未被转换,
# POP3 邮件客户端可能会在迁移后复制邮件信息。
# 默认启用该选项。
# courier-to-dovecot-migration: true

[plesk]
# 该节定义目标面板设置。

# [mandatory] ip
# 目标Plesk Panel 服务器的IPv4地址。
ip:

# [mandatory] os
# 服务器的操作系统类型,'unix' 或 'windows'.
os: unix

# [optional] panel-username
# 面板管理员的登录名如未指定,则使用'admin'。
# panel-username: admin

# [optional] panel-password
# 面板管理员的密码。如未指定,会自动检测。
# 通过密码的更安全的方式是使用环境变量 [SECTIONNAME_]PANEL_PASSWORD (该节
# 的名称是可选的)。因此保持该选项为空并在迁移器运行之前设置环境变量。
# panel-password: setup

# [optional] panel-password-type
# 可能的值:'plain', 'encrypted'. 默认为'plain'.
# panel-password-type: plain

# [optional] plesk-port
# Plesk Panel UI/API 的端口
# plesk-port: 8443

# [optional] session-dir
# Plesk 目标服务器上的临时文件目录。
# 如果您在其它服务器上而非Plesk上运行 Plesk Migrator 选该选项才有意义。
# 如果您在与目标Plesk相同的服务器上运行Plesk Migrator,所有临时文件会
# 根据 [GLOBAL] 节被放置到会话目录。
# 如未指定,临时文件将被放入 '/root/plesk_migrator'
# session-dir: /root/plesk_migrator

# [optional] skip-extensions
# 不要迁移 Plesk 扩展数据。默认值为 'false'.
# skip-extensions: false

# [optional] migrate-server-wide-extensions-data
# 是否迁移Plesk 扩展服务器范围的数据。默认值为 'false'.
# migrate-server-wide-extensions-data: false

# [optional] is-local
# 迁移工具是否在与目标 Plesk 相同的服务器上运行。
# 默认为 true.
# is-local: true

# [optional] apache-restart-interval
# 最小时间间隔,以秒为单位,Apache 在
# 迁移过程中的重启间隔。如该间隔太短,Apache 将会启动频繁。这
# 将会引起Plesk 目标服务器的长期宕机。如果该间隔太长,
# Plesk 目标服务器的现有用户将不得不等很久
# 才能等到更改被应用。跳过更改 Apache 重启间隔,设置值为
# 'none'. 若未指定,迁移工具将跳过更改Apache
# 重启间隔。
# apache-restart-interval: none

[pfu]
# 该节定义源Plesk Panel server 'pfu1'的设置

# [mandatory] ip
# 该源Plesk服务器的 IP v4 地址。
ip:

# [mandatory] os
# 服务器的操作系统类型,'unix' 或 'windows'.
os: unix

# [optional] panel-username
# 面板管理员的用户名如未指定,则使用'admin'。
# panel-username: admin

# [mandatory] panel-password
# 面板管理员的密码。如未指定,会自动检测。
# 通过密码的更安全的方式是使用环境变量 [SECTIONNAME_]PANEL_PASSWORD (该节
# 的名称是可选的)。因此保持该选项为空并在迁移器运行之前设置环境变量。
# panel-password:

# [optional] panel-password-type
# 可能的值:'plain', 'encrypted'. 默认为'plain'.
# panel-password-type: plain

# [optional] plesk-port
# Plesk Panel UI/API 的端口
# plesk-port: 8443

# [optional] ssh-username
# 该Plesk 服务器上优先级系统用户的用户名。如未指定,则使用'root'。
# ssh-username: root

# [optional] ssh-auth-type
# SSH 验证类型。
# 支持两种验证类型:'password' 或 'key'. 默认为'password'.
# ssh-auth-type: password

# [optional] ssh-password
# 该Plesk 服务器上优先级系统用户的密码。
# 如果您选择了 SSH 验证类型‘password’,则必须要指定该密码。
# 注意密码中的散列符号会被视作常规符号。
# 通过密码的更安全的方式是使用环境变量 [SECTIONNAME_]PANEL_PASSWORD (该节
# 的名称是可选的)。因此保持该选项为空并在迁移器运行之前设置环境变量。
ssh-password:

# [optional] ssh-password-type
# 可能的值:'plain', 'encrypted'. 默认为'plain'.
# ssh-password-type: plain

# [optional] ssh-key
# 进入SSH 私钥文件的路径。如果您选择 SSH 可以指定它
# 验证类型 'key'. 如未指定,会使用"id_rsa" 或 "id_dsa" 密钥(来自
# 目录'~/.ssh')。
# ssh-key: /root/.ssh/id_rsa

# [optional] ssh-port
# SSH服务接受传入连接的端口号
# ssh-port: 22

# [optional] session-dir
# 临时文件的目录。
# 如未指定,临时文件会被放入 C:\plesk_migrator.
# session-dir: /root/plesk_migrator

# [optional] copy-mail-content
# 该参数会指定应从服务器复制哪些邮件内容:
# 'full' 表示复制所有邮件内容,而'none' 是跳过复制。
# 如未指定则复制所有邮件内容。
# copy-mail-content: full

# [optional] copy-web-content
# 该参数会指定应从服务器复制哪些web内容:
# 'full' 表示复制所有web内容,而'none' 是跳过复制。
# 如未指定则复制所有web内容。
# copy-web-content: full

# [optional] ssh-authorized-keys-file
# 该参数会指定root用户的SSH 验证密钥文件的地址。
# 当通过 rsync 复制文件设置密钥验证时需要该文件:复制web内容,部署代理,等等。
# 如果未指定该参数,默认迁移器会将公共密钥放入
# '~/.ssh/authorized_keys' 和 '~/.ssh/authorized_keys2' 文件。因此,在默认配置中,
# 不用动该选项。如果您在迁移过程中遇到设置key验证的问题,
# 请检查您的SSH 服务器配置文件(通常是 /etc/ssh/sshd_config)中的 AuthorizedKeysFile 选项。
# ssh-authorized-keys-file: ~/.ssh/authorized_keys

Plesk for Windows的配置文件

该配置文件只包括执行迁移必需的基本信息:

[GLOBAL]
源类型plesk
source-servers: pfw
目标类型plesk

[plesk]
ip:
os: windows

[pfw]
ip:
os: windows
windows-password:

该配置文件包含高级设置,能够调整迁移的很多方面:

[GLOBAL]
# 该节会定义迁移前的全局设置。

# [mandatory, non-modifiable] 源类型
# 源服务器的产品类型。
#
# 这是一个配置文件的模板,用于从Plesk Panel 迁移到
# Plesk Panel. 对于其它的源或目标面板,请浏览其它提供的
# 配置模板并挑选一个适合您源类型的。
源类型plesk

# [mandatory] 源
# 一个以逗号隔开的节列表,用于描述源Plesk Panel
# 服务器。在该设置中您可以指定一个或多个Plesk for Unix
# 和/或 Plesk for Windows 服务器。
#
# 该列表中节名称的顺序很重要:Plesk 服务器,
# 节列举越靠前,在有冲突时享有优先权。
源:pfw

# [optional] external-db-servers
# 以逗号隔开的描述外部源数据库服务器的节列表。
# 强力建议为远程 MSSQL 指定外部数据库服务器 - 否则可能会有问题
# (在复制数据库内容时)。
# external-db-servers: mssql1

# [optional] session-dir
# 用于迁移工具临时文件的目录。
# 如未指定,临时文件会被放入 './migration-session'。
# session-dir: migration-session

# [optional] zones-ttl
# 时间,以秒为单位,迁移工具设置用作 SOA minimum TTL 和
# 新的DNS 服务器上的刷新间隔。
# 如未指定,会使用默认值:120
# zones-ttl: 120

# [optional] external-dns-server
# 允许递归 DNS 查询的外部DNS服务器的IPv4地址。
# 迁移工具会使用指定的地址测试常规互联网
# 用户是否可以为迁移的域名获取正确的DNS 记录。如果
# 未指定任何值,迁移工具将使用 Google DNS server (8.8.8.8)。
# 如指定 'none',迁移工具将跳过测试。
# external-dns-server: 8.8.8.8

# [optional] mail-messages-delta-limit
# 迁移后邮件检测会对比源
# 和目标邮箱中的信息数量。如果信息数量差异超过
# 在"mail-messages-delta-limit"中指定的,则视作一个错误。
# 如未指定该选项,则使用默认值:10
# mail-messages-delta-limit: 10

# [optional] website-availability-check-timeout
# 这是迁移器在迁移后测试网站可用性时使用
# 超时时间。如未指定,则会使用默认值:30
# website-availability-check-timeout: 30

# [optional] website-availability-depth
# 迁移后测试网站可用性时检查的链接的最大深度。
# 例如,深度2 表示检查主页面和所有子页面,而深度3 表示检查
# 主页面、主页面的子页面和子页面的子页面。
# 如未指定,会使用默认值:2. 增加值将会增加时间
# 要执行迁移后检查,但是将要扩大测试页面的覆盖度。
# website-availability-depth: 2

# [optional] website-availability-group-directories
# 迁移后测试页面可用性时是否按相同目录和文件扩展名
# 分组文件。如果启用,主要页面会包含 2 个链接 '/subdir/a.php' 和
# '/subdir/b.php', 将只检查其中一个。如果文件仍在不同的目录中
# (e.g. '/subdir1/a.php' and '/subdir2/b.php') 或有不同的扩展名
# (e.g. '/subdir/a.php' and '/subdir/b.aspx'), 都将被检查。
# 如未指定,默认值为false。启用该选项将会加速检查,但是
# 减少测试页面的覆盖度。
# website-availability-group-directories: false

# [optional] log-message-context-length
# 当记录多行输出 (API 请求,相应), 只显示前 N
# 和最后 N 行。默认值为 0,表示显示完整的API 请求。
# log-message-context-length: 10

# [optional] use-hosting-analyser
# 如果您要分析主机并检测复制内容的的最优算法,设置
# 该选项为 'True'。该选项的默认值为 'True'.
# use-hosting-analyser: True

# [optional] use-math-analyse
# 如果您要分析主机并检测复制内容的的最优算法,设置
# 该选项为'True'。该选项的默认值为 'True'.
# 否则将使用 "matrix of strategies" 算法
# use-math-analyse: True

# [optional] hosting-analysis-ttl
# 时间(以秒为单位), 迁移工具设置用于主机
# 分析结果的最小时间。
# 如未指定,会使用默认值:900
# hosting-analysis-ttl: 900

# [optional] skip-migrator-updates
# 不要检查迁移器 repository 查看更新。默认值为'False'
# skip-migrator-updates: false

# [optional] copy-mssql-content
# Select way to copy MSSQL content: native MSSQL dumps, text dumps or automatic selection (default).
# 可能的值:'native', 'text', 'auto'
# Native backups require direct access of migration tool to all MSSQL servers, so make sure that you provided
# access to all external MSSQL servers in 'external-db-servers' option.
# Native backup is the most reliable way to copy MSSQL database content.
# Text dumps have an advantage that they do not require physical access to the servers. Only access by MSSQL
# protocols is required. But such way may fail in case of complex MSSQL databases with stored procedures, triggers, etc.
# If automatic selection is specified, panel migrator will use native backups if we have direct access to the servers
# with MSSQL, and text dumps otherwise.
# copy-mssql-content: auto

# [optional] use-separate-log
# 将迁移器日志写入会话目录而不是全局日志目录。
# 默认为true.
# use-separate-log: true

# [optional] adjust-applications
# 是否修复web应用常用的配置文件。
# 该修复包括数据库连接更改、路径修复,等等。
# 默认启用该选项。如果影响迁移某些应用,或您需要加快迁移可
# 禁用该选项。
# adjust-applications: true

[plesk]
# 该节定义目标面板设置。

# [mandatory] ip
# 目标Plesk Panel 服务器的IPv4地址。
ip:

# [mandatory] os
# 服务器的操作系统类型,'unix' 或 'windows'.
os: windows

# [optional] panel-username
# 面板管理员的登录名如未指定,则使用'admin'。
# panel-username: admin

# [optional] panel-password
# 面板管理员的密码。如未指定,会自动检测。
# 通过密码的更安全的方式是使用环境变量 [SECTIONNAME_]PANEL_PASSWORD (该节
# 的名称是可选的)。因此保持该选项为空并在迁移器运行之前设置环境变量。
# panel-password: setup

# [optional] panel-password-type
# 可能的值:'plain', 'encrypted'. 默认为'plain'.
# panel-password-type: plain

# [optional] plesk-port
# Plesk Panel UI/API 的端口
# plesk-port: 8443

# [optional] session-dir
# Plesk 目标服务器上的临时文件目录。
# 如果您在其它服务器上而非Plesk上运行 Plesk Migrator 选该选项才有意义。
# 如果您在与目标Plesk相同的服务器上运行Plesk Migrator,所有临时文件会
# 根据 [GLOBAL] 节被放置到会话目录。
# If not specified, temporary files will be put into 'C:\plesk_migrator'
# session-dir: C:\plesk_migrator

# [optional] skip-extensions
# 不要迁移 Plesk 扩展数据。默认值为 'false'.
# skip-extensions: false

# [optional] migrate-server-wide-extensions-data
# 是否迁移Plesk 扩展服务器范围的数据。默认值为 'false'.
# migrate-server-wide-extensions-data: false

# [optional] remote-mssql-session-dir
# A directory for temporary files on target remote MSSQL servers which were
# not specified by 'external-db-servers' option.
# MSSQL database dumps will be put into that path.
# remote-mssql-session-dir: C:\plesk_migrator

# [optional] is-local
# 迁移工具是否在与目标 Plesk 相同的服务器上运行。
# 默认为 true.
# is-local: true

[pfw]
# This section is an example of settings for source Plesk Panel for Windows.

# [mandatory] ip
# 该源Plesk服务器的 IP v4 地址。
ip:

# [mandatory] os
# 服务器的操作系统类型,'unix' 或 'windows'.
os: windows

# [optional] panel-username
# 面板管理员的用户名如未指定,则使用'admin'。
# panel-username: admin

# [optional] panel-password
# 面板管理员的密码。如未指定,会自动检测。
# 通过密码的更安全的方式是使用环境变量 [SECTIONNAME_]PANEL_PASSWORD (该节
# 的名称是可选的)。因此保持该选项为空并在迁移器运行之前设置环境变量。
# panel-password:

# [optional] panel-password-type
# 可能的值:'plain', 'encrypted'. 默认为'plain'.
# panel-password-type: plain

# [optional] plesk-port
# Plesk Panel UI/API 的端口
# plesk-port: 8443

# [optional] windows-username
# 该Plesk 服务器上优先级系统用户的用户名。Default is 'Administrator'.
# windows-username: Administrator

# [mandatory] windows-password
# 该Plesk 服务器上优先级系统用户的密码。
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]WINDOWS_PASSWORD (the section
# 的名称是可选的)。因此保持该选项为空并在迁移器运行之前设置环境变量。
windows-password:

# [optional] windows-password-type
# 可能的值:'plain', 'encrypted'. 默认为'plain'.
# windows-password: plain

# [optional] session-dir
# 临时文件的目录。
# Note, that for MySQL database content to be copied, this directory should be
# exported on rsync server as "migrator".
# If not specified, temporary files are put into C:\plesk_migrator.
# session-dir: C:\plesk_migrator

# [optional] copy-mail-content
# 该参数会指定应从服务器复制哪些邮件内容:
# 'full' 表示复制所有邮件内容,而'none' 是跳过复制。
# 如未指定则复制所有邮件内容。
# copy-mail-content: full

# [optional] copy-web-content
# 该参数会指定应从服务器复制哪些web内容:
# 'full' 表示复制所有web内容,而'none' 是跳过复制。
# 如未指定则复制所有web内容。
# copy-web-content: full

# [optional] mail-source-log-enabled
# 是否为在源服务器上运行的 MailMigrator.exe 工具启用额外的日志记录
# 相应的日志将会被放入 <session-dir>/mail/<domain-name>/<mail-name>/mail-backup.log
# mail-source-log-enabled: false

# [optional] mail-target-log-enabled
# 是否为在目标服务器上运行的 MailMigrator.exe 工具启用额外的日志记录
# 相应的日志将会被放入:
# <session-dir>/mail/<domain-name>/<mail-name>/mail-restore.log
# <session-dir>/mail/<domain-name>/<mail-name>/mail-list-messages.log
# mail-target-log-enabled: false

# [optional] mail-source-provider
# 覆盖在源服务器上运行的 MailMigrator.exe 工具使用的邮件服务器类型。
# 可能的值示例:"mailenable", "smartermail", "imap", 等等。
# 要了解所有可能的值,请参阅 "MailMigrator.exe help" 输出。
# mail-source-provider:

# [optional] mail-target-provider
# 覆盖在目标服务器上运行的 MailMigrator.exe 工具使用的邮件服务器类型。
# 可能的值示例:"mailenable", "smartermail", "imap", 等等。
# 要了解所有可能的值,请参阅 "MailMigrator.exe help" 输出。
# mail-target-provider:

# [optional] mail-source-additional-options
# 传递到在源服务器上运行的 MailMigrator.exe 工具的其它命令选项。
# 示范值(要指定 IMAP 端口):--port=123
# mail-source-additional-options:

# [optional] mail-target-additional-options
# 传递到在目标服务器上运行的 MailMigrator.exe 工具的其它命令选项。
# 示范值(要指定 IMAP 端口):--port=123
# mail-target-additional-options:

[mssql1]
# This optional section defines settings of external MSSQL database server 'mssql1'.
# Fill this section's settings and list it in the 'external-db-servers'
# setting of GLOBAL section to get the MSSQL databases copied from this server with native MSSQL backup.
# Remove this section otherwise.

# [mandatory] host
# 该数据库服务器的主机(正如在 Plesk Panel 中显示的)。
# 对于MSSQL 这通常由 IP 地址和示例名组成,例如:
# 192.168.1.1\MSSQLSERVER2008
# 对于其它服务器,这通常等同于数据库服务器的 IP 地址。
host:

# [mandatory] type
# 数据库服务器的类型,只允许值 'mssql'
类型:mssql

# [mandatory] ip
# 该数据库服务器的 IP v4 地址。
ip:

# [optional] windows-username
# 该集中式邮件服务器上优先级系统用户的用户名。默认为 'Administrator'.
# windows-username: 管理

# [mandatory] windows-password
# 该数据库服务器上的优先级系统用户的密码。
# 要通过一个密码更为安全的方式是使用环境变量 [SECTIONNAME_]WINDOWS_PASSWORD (该节
# 的名称是可选的)。因此保持该选项为空并在迁移器运行之前设置环境变量。
windows-password:

# [optional] windows-password-type
# 可能的值:'plain', 'encrypted'. 默认为'plain'.
# windows-password: plain
 

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.