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