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
# 該集中式郵件伺服器上優先順序系統使用者的用戶名。Default is 'Administrator'.
# windows-username: Administrator

# [mandatory] windows-password
# 該資料庫伺服器上的優先順序系統使用者的密碼。
# 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
 

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.