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