This commit is contained in:
cutemeli
2025-12-22 10:35:30 +00:00
parent 0bfc6c8425
commit 5ce7ca2c5d
38927 changed files with 0 additions and 4594700 deletions

View File

@@ -1,259 +0,0 @@
[GLOBAL]
# This section defines migrator's global settings.
# [mandatory, non-modifiable] source-type
# Source servers' product type.
#
# This is a template of configuration file for migration from Confixx to
# Plesk. For other source or target panels, browse other provided
# configuration templates and pick one that best suits your source type.
source-type: confixx
# [optional] session-dir
# A directory for migration tool's temporary files.
# If not specified, temporary files will be put into './migration-session'.
# session-dir: migration-session
# [optional] zones-ttl
# The time in seconds, which migration tool sets as the SOA minimum TTL and
# refresh interval on a new DNS server.
# If not specified, default value is assumed: 120
# zones-ttl: 120
# [optional] external-dns-server
# An IPv4 address of an external DNS server that allows recursive DNS queries.
# Migration tool uses the specified address to test whether general Internet
# users can obtain the correct DNS records for the transferred domains. If
# nothing is specified, migration tool will use Google DNS server (8.8.8.8).
# If 'none' is specified, migration tool will skip this test.
# external-dns-server: 8.8.8.8
# [optional] mail-messages-delta-limit
# The post-migration mail checks compare the number of messages in the source
# and the target mailboxes. If the number of messages differs more than it is
# specified in "mail-messages-delta-limit", it is considered an error.
# If the option is not specified, default value is assumed: 10
# mail-messages-delta-limit: 10
# [optional] website-availability-check-timeout
# This is the timeout, that migrator uses, when testing web site availability
# after migration. If not specified, default value is assumed: 30
# website-availability-check-timeout: 30
# [optional] website-availability-depth
# Maximum depth of links to check when testing web site availability after migration.
# For example depth 2 means to check main page and all child pages, depth 3 means to check
# main page, child pages of main page and child pages of child pages.
# If not specified, default value is assumed: 2. Increasing the value will increase time
# to perform post-migration checks, but will improve coverage of tested web pages.
# website-availability-depth: 2
# [optional] website-availability-group-directories
# Whether to group files with the same directory and file extension when testing web site
# availability after migration. If enabled, and main page contains 2 links '/subdir/a.php' and
# '/subdir/b.php', only one of them will be checked. Still if files are in different directories
# (e.g. '/subdir1/a.php' and '/subdir2/b.php') or have different extension
# (e.g. '/subdir/a.php' and '/subdir/b.aspx'), both of them will be checked.
# If not specified, default value is false. Enabling that option will speed up checks, but
# decrease coverage of tested web pages.
# website-availability-group-directories: false
# [optional] log-message-context-length
# When logging a multiline output (API request, response), show only top N
# and last N lines. Default value is 0, which means to display full API requests.
# log-message-context-length: 10
# [optional] use-hosting-analyser
# Set this option to 'True', if you need to analyse hosting and detect optimal
# algorithm to copy content. Default value of this option is 'True'.
# use-hosting-analyser: True
# [optional] hosting-analysis-ttl
# The time in seconds, which migration tool sets as minimum for hosting
# analysis results.
# If not specified, default value is assumed: 900
# hosting-analysis-ttl: 900
# [optional] event-scripts-dir
# Directory with scripts/executables that should be launched on migration events
# Default is $VAR_DIR/events, where VAR_DIR is /usr/local/psa/var/modules/panel-migrator/ for Unix
# event-scripts-dir:
# [optional] use-separate-log
# Write migrator logs to a session directory, not to global logs directory.
# By default is true.
# use-separate-log: true
# [optional] use-binary-log
# Write binary migrator logs, which are necessary to display logs in GUI.
# By default is true.
# use-binary-log: true
# [optional] adjust-applications
# Whether to fix configuration files of several commonly used web applications.
# The fix could include database connection changes, path fixes, and so on.
# By default this option is enabled. You could disable it if it breaks migration of some
# application, or if you need better speed of migration.
# adjust-applications: true
# [optional] skip-actions
# List of actions which should not be executed during migration.
# Be careful when setting this option - other actions may rely on results of skipped actions. So, skipping
# an action could lead to broken migration.
# List format: action identifiers separated by ",".
# If you want to skip action for specific subscription only, specify the subscription after action identifier
# separated by ":".
# Example value: convert-dns, fetch-source, copy-mail-content:example.com, copy-web-files:example.com
# In that case migrator will not execute "convert-dns" and "fetch-source" actions for all subscriptions
# and will not execute "copy-mail-content" and "copy-web-files" for subscription "example.com"
# (still content will be copied for all the other migrated subscriptions).
# By default no actions are skipped.
# To list all actions executed by migrator (with their identifiers and text descriptions),
# prepare configuration file (config.ini) and run "plesk-migrator print-workflow config.ini".
# skip-actions:
# [optional] restore-hosting-settings-poll-limit
# When restoring hosting settings (addon domains, mailboxes, PHP settings, etc) of subscriptions,
# a special restore hosting settings task is started asynchroniously. Migrator polls status of
# the task periodically and check whether it finished.
# This options specifies maximum number of attempts to poll the task before we consider the task hanged.
# Additionally see "restore-hosting-settings-poll-interval" option.
# Total timeout after which we consider that restore hosting task hanged is
# "restore-hosting-settings-poll-limit" multiplied by "restore-hosting-settings-poll-interval".
# restore-hosting-settings-poll-limit: 7200
# [optional] restore-hosting-settings-poll-interval
# When restoring hosting settings (addon domains, mailboxes, PHP settings, etc) of subscriptions,
# a special restore hosting settings task is started asynchroniously. Migrator polls status of
# the task periodically and check whether it finished
# This options specifies interval between poll attempts (in seconds). Less inteval gives more instant detection
# that task has finished, but a bit more load on CPU/disk.
# Additionally see "restore-hosting-settings-poll-limit" option.
# Total timeout after which we consider that restore hosting task hanged is
# "restore-hosting-settings-poll-limit" multiplied by "restore-hosting-settings-poll-interval".
# restore-hosting-settings-poll-interval: 1
# [optional] rsync-additional-args
# Additional arguments which will be passed to "rsync" utility when it transfers files
# from the source server.
# For example, here you could enable compression with "rsync-additional-args: -z"
# to optimize file transfer time.
# rsync-additional-args:
[plesk]
# This section defines target panel settings.
# [mandatory] ip
# An IPv4 address of the target Plesk server.
ip:
# [mandatory] os
# Server's operating system type, should be 'unix' for migration from confixx.
os: unix
# [optional] panel-username
# Panel administrator's login. If not specified, 'admin' is used.
# panel-username: admin
# [optional] panel-password
# Panel administrator password. If not specified, it is automatically detected.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]PANEL_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
# panel-password: setup
# [optional] panel-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# panel-password-type: plain
# [optional] session-dir
# A directory for temporary files on Plesk target server.
# Option makes sense only if you run Plesk Migrator on another server than target Plesk.
# If you run Plesk Migrator on the same server as target Plesk, all temporary files are placed
# to session directory according to [GLOBAL] section.
# If not specified, temporary files will be put into '/root/plesk_migrator'
# session-dir: /root/plesk_migrator
# [optional] is-local
# Whether migration tools are working on the same server as target Plesk.
# Default is true.
# is-local: true
# [optional] apache-restart-interval
# Minimum time interval, in seconds, between Apache restarts during a
# migration. If this interval is short, Apache will restart too often. This
# will cause long downtimes on Plesk target server. If this interval is long,
# existing users of Plesk target server will have to wait longer for their
# changes to be applied. To skip changing Apache restart interval set value to
# 'none'. If not specified, migration tool will skip changing the Apache
# restart interval.
# apache-restart-interval: none
[confixx]
# This section defines settings of source Confixx server.
# [mandatory] ip
# IP address or host name of the source server.
ip:
# [mandatory] os
# Server's operating system type, should be 'unix' for migration from Confixx.
os: unix
# [optional] ssh-username
# User name of the privileged system user on this server. If not specified, 'root' is used.
# ssh-username: root
# [optional] ssh-auth-type
# SSH authentication type.
# There are two authentication types supported: 'password' or 'key'. Default is 'password'.
# ssh-auth-type: password
# [optional] ssh-password
# Password of the privileged system user on this server.
# You must specify it, if you select SSH authentication type password.
# Note that the hash mark in password is treated as a regular symbol.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]SSH_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
ssh-password:
# [optional] ssh-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# ssh-password-type: plain
# [optional] ssh-key
# Path to SSH private key file. You can specify it if you select SSH
# authentication type 'key'. If not specified, "id_rsa" or "id_dsa" keys from
# the directory '~/.ssh' are used.
# ssh-key: /root/.ssh/id_rsa
# [optional] copy-mail-content
# This option specifies whether mail content should be copied from the server
# (the 'full' value) or not ('none'). If not specified, mail content will be
# copied.
# copy-mail-content: full
# [optional] copy-web-content
# This option specifies whether web content should be copied from the server
# (the 'full' value) or not ('none'). If not specified, web content will be
# copied.
# copy-web-content: full
# [optional] session-dir
# A directory for temporary files.
# If not specified, temporary files are put into /root/plesk_migrator.
# session-dir: /root/plesk_migrator
# [optional] mail-mapping
# The way to map mailboxes and e-mail addresses from Confixx to Plesk.
# Possible values:
# - 'default'. Mail mapping used by default (preferred option). In that case migrator will migrate
# mailboxes and e-mail addresses, so that after migration they are easily managed in Plesk.
# - 'shortnames'. In case short names for mail server is enabled in target Plesk,
# mail objects mapping can be done in such a way that end-users do not need
# to change their login information in mail client software to access their mailboxes in Plesk.
# Each mailbox 'webXpY' migrated to Plesk will have e-mail address starting from 'webXpY@' -
# for login purposes and e-mail username@maildomain.tld configured as e-mail forwarding or alias to this mailbox.
# Such scheme of mapping is much more complex than one used by default so it must be used only
# in case when the old way to login into end-customer mailboxes by
# short names "as is" in Confixx must be preserved.
# mail-mapping: default

View File

@@ -1,11 +0,0 @@
[GLOBAL]
source-type: confixx
[plesk]
ip:
os: unix
[confixx]
ip:
os: unix
ssh-password:

View File

@@ -1,278 +0,0 @@
[GLOBAL]
# This section defines migrator's global settings.
# [mandatory, non-modifiable] source-type
# Source servers' product type.
#
# This is a template of configuration file for migration from cPanel to Plesk.
# For other source or target panels, browse other provided
# configuration templates and pick one that best suits your source type.
source-type: cpanel
# [optional] session-dir
# A directory for migration tool's temporary files.
# If not specified, temporary files will be put into './migration-session'.
# session-dir: migration-session
# [optional] zones-ttl
# The time in seconds, which migration tool sets as the SOA minimum TTL and
# refresh interval on a new DNS server.
# If not specified, default value is assumed: 120
# zones-ttl: 120
# [optional] external-dns-server
# An IPv4 address of an external DNS server that allows recursive DNS queries.
# Migration tool uses the specified address to test whether general Internet
# users can obtain the correct DNS records for the transferred domains. If
# nothing is specified, migration tool will use Google DNS server (8.8.8.8).
# If 'none' is specified, migration tool will skip this test.
# external-dns-server: 8.8.8.8
# [optional] mail-messages-delta-limit
# The post-migration mail checks compare the number of messages in the source
# and the target mailboxes. If the number of messages differs more than it is
# specified in "mail-messages-delta-limit", it is considered an error.
# If the option is not specified, default value is assumed: 10
# mail-messages-delta-limit: 10
# [optional] website-availability-check-timeout
# This is the timeout, that migrator uses, when testing web site availability
# after migration. If not specified, default value is assumed: 30
# website-availability-check-timeout: 30
# [optional] website-availability-depth
# Maximum depth of links to check when testing web site availability after migration.
# For example depth 2 means to check main page and all child pages, depth 3 means to check
# main page, child pages of main page and child pages of child pages.
# If not specified, default value is assumed: 2. Increasing the value will increase time
# to perform post-migration checks, but will improve coverage of tested web pages.
# website-availability-depth: 2
# [optional] website-availability-group-directories
# Whether to group files with the same directory and file extension when testing web site
# availability after migration. If enabled, and main page contains 2 links '/subdir/a.php' and
# '/subdir/b.php', only one of them will be checked. Still if files are in different directories
# (e.g. '/subdir1/a.php' and '/subdir2/b.php') or have different extension
# (e.g. '/subdir/a.php' and '/subdir/b.aspx'), both of them will be checked.
# If not specified, default value is false. Enabling that option will speed up checks, but
# decrease coverage of tested web pages.
# website-availability-group-directories: false
# [optional] log-message-context-length
# When logging a multiline output (API request, response), show only top N
# and last N lines. Default value is 0, which means to display full API requests.
# log-message-context-length: 10
# [optional] use-hosting-analyser
# Set this option to 'True', if you need to analyse hosting and detect optimal
# algorithm to copy content. Default value of this option is 'True'.
# use-hosting-analyser: True
# [optional] hosting-analysis-ttl
# The time in seconds, which migration tool sets as minimum for hosting
# analysis results.
# If not specified, default value is assumed: 900
# hosting-analysis-ttl: 900
# [optional] skip-migrator-updates
# Do not check migrator repository for updates. Default value is 'False'
# skip-migrator-updates: False
# [optional] event-scripts-dir
# Directory with scripts/executables that should be launched on migration events
# Default is $VAR_DIR/events, where VAR_DIR is /usr/local/psa/var/modules/panel-migrator/ for Unix
# event-scripts-dir:
# [optional] use-separate-log
# Write migrator logs to a session directory, not to global logs directory.
# By default is true.
# use-separate-log: true
# [optional] use-binary-log
# Write binary migrator logs, which are necessary to display logs in GUI.
# By default is true.
# use-binary-log: true
# [optional] adjust-applications
# Whether to fix configuration files of several commonly used web applications.
# The fix could include database connection changes, path fixes, and so on.
# By default this option is enabled. You could disable it if it breaks migration of some
# application, or if you need better speed of migration.
# adjust-applications: true
# [optional] skip-actions
# List of actions which should not be executed during migration.
# Be careful when setting this option - other actions may rely on results of skipped actions. So, skipping
# an action could lead to broken migration.
# List format: action identifiers separated by ",".
# If you want to skip action for specific subscription only, specify the subscription after action identifier
# separated by ":".
# Example value: convert-dns, fetch-source, copy-mail-content:example.com, copy-web-files:example.com
# In that case migrator will not execute "convert-dns" and "fetch-source" actions for all subscriptions
# and will not execute "copy-mail-content" and "copy-web-files" for subscription "example.com"
# (still content will be copied for all the other migrated subscriptions).
# By default no actions are skipped.
# To list all actions executed by migrator (with their identifiers and text descriptions),
# prepare configuration file (config.ini) and run "plesk-migrator print-workflow config.ini".
# skip-actions:
# [optional] restore-hosting-settings-poll-limit
# When restoring hosting settings (addon domains, mailboxes, PHP settings, etc) of subscriptions,
# a special restore hosting settings task is started asynchroniously. Migrator polls status of
# the task periodically and check whether it finished.
# This options specifies maximum number of attempts to poll the task before we consider the task hanged.
# Additionally see "restore-hosting-settings-poll-interval" option.
# Total timeout after which we consider that restore hosting task hanged is
# "restore-hosting-settings-poll-limit" multiplied by "restore-hosting-settings-poll-interval".
# restore-hosting-settings-poll-limit: 7200
# [optional] restore-hosting-settings-poll-interval
# When restoring hosting settings (addon domains, mailboxes, PHP settings, etc) of subscriptions,
# a special restore hosting settings task is started asynchroniously. Migrator polls status of
# the task periodically and check whether it finished
# This options specifies interval between poll attempts (in seconds). Less inteval gives more instant detection
# that task has finished, but a bit more load on CPU/disk.
# Additionally see "restore-hosting-settings-poll-limit" option.
# Total timeout after which we consider that restore hosting task hanged is
# "restore-hosting-settings-poll-limit" multiplied by "restore-hosting-settings-poll-interval".
# restore-hosting-settings-poll-interval: 1
# [optional] rsync-additional-args
# Additional arguments which will be passed to "rsync" utility when it transfers files
# from the source server.
# For example, here you could enable compression with "rsync-additional-args: -z"
# to optimize file transfer time.
# rsync-additional-args:
[plesk]
# This section defines target panel settings.
# [mandatory] ip
# An IPv4 address of the target Plesk server.
ip:
# [mandatory] os
# Server's operating system type, should be 'unix' for migration from cpanel.
os: unix
# [optional] panel-username
# Panel administrator's login. If not specified, 'admin' is used.
# panel-username: admin
# [optional] panel-password
# Panel administrator password. If not specified, it is automatically detected.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]PANEL_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
# panel-password: setup
# [optional] panel-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# panel-password-type: plain
# [optional] session-dir
# A directory for temporary files on Plesk target server.
# Option makes sense only if you run Plesk Migrator on another server than target Plesk.
# If you run Plesk Migrator on the same server as target Plesk, all temporary files are placed
# to session directory according to [GLOBAL] section.
# If not specified, temporary files will be put into '/root/plesk_migrator'
# session-dir: /root/plesk_migrator
# [optional] is-local
# Whether migration tools are working on the same server as target Plesk.
# Default is true.
# is-local: true
# [optional] apache-restart-interval
# Minimum time interval, in seconds, between Apache restarts during a
# migration. If this interval is short, Apache will restart too often. This
# will cause long downtimes on Plesk target server. If this interval is long,
# existing users of Plesk target server will have to wait longer for their
# changes to be applied. To skip changing Apache restart interval set value to
# 'none'. If not specified, migration tool will skip changing the Apache
# restart interval.
# apache-restart-interval: none
[cpanel]
# This section defines settings of source cPanel server.
# [mandatory] ip
# IP address or host name of the source server.
ip:
# [mandatory] os
# Server's operating system type, should be 'unix' for migration from cPanel.
os: unix
# [optional] ssh-username
# User name of the privileged system user on this server. If not specified, 'root' is used.
# ssh-username: root
# [optional] ssh-auth-type
# SSH authentication type.
# There are two authentication types supported: 'password' or 'key'. Default is 'password'.
# ssh-auth-type: password
# [optional] ssh-password
# Password of the privileged system user on this server.
# You must specify it, if you select SSH authentication type password.
# Note that the hash mark in password is treated as a regular symbol.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]SSH_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
ssh-password:
# [optional] ssh-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# ssh-password-type: plain
# [optional] ssh-key
# Path to SSH private key file. You can specify it if you select SSH
# authentication type 'key'. If not specified, "id_rsa" or "id_dsa" keys from
# the directory '~/.ssh' are used.
# ssh-key: /root/.ssh/id_rsa
# [optional] copy-mail-content
# This option specifies whether mail content should be copied from the server
# (the 'full' value) or not ('none'). If not specified, mail content will be
# copied.
# copy-mail-content: full
# [optional] copy-web-content
# This option specifies whether web content should be copied from the server
# (the 'full' value) or not ('none'). If not specified, web content will be
# copied.
# copy-web-content: full
# [optional] session-dir
# A directory for temporary files.
# If not specified, temporary files are put into /root/plesk_migrator.
# session-dir: /root/plesk_migrator
# [optional] postgres-password
# Password of PostgreSQL superuser
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]POSTGRES_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
# postgres-password:
# [optional] postgres-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# postgres-password-type: plain
# [optional] convert-subdomain
# Possible values: 'subdomain', 'addon-domain', 'addon-domain-if-mail'
# - 'subdomain' means that each cPanel subdomain will be converted to Plesk subdomain.
# Mailboxes on subdomain will be lost during migration, as Plesk does not allow to have mail on subdomains.
# - 'addon-domain' means that each cPanel subdomain will be converted to Plesk addon domain.
# - 'addon-domain-if-mail' means that each cPanel subdomain which has mailboxes will be converted to Plesk addon domain,
# while cPanel subdomain without mailboxes will be converted to Plesk subdomain.
# Default is 'addon-domain-if-mail'.
# convert-subdomain: addon-domain-if-mail
# [optional] convert-alias
# Possible values: 'alias', 'addon-domain', 'addon-domain-if-mail'
# - 'alias' means that each cPanel alias will be converted to Plesk alias.
# Mailboxes on alias will be lost during migration, as Plesk does not allow to have separate mail on aliases.
# - 'addon-domain' means that each cPanel alias will be converted to Plesk addon domain.
# - 'addon-domain-if-mail' means that each cPanel alias which has mailboxes will be converted to Plesk addon domain,
# while cPanel alias without mailboxes will be converted to Plesk alias.
# Default is 'addon-domain-if-mail'.
# convert-alias: addon-domain-if-mail

View File

@@ -1,11 +0,0 @@
[GLOBAL]
source-type: cpanel
[plesk]
ip:
os: unix
[cpanel]
ip:
os: unix
ssh-password:

View File

@@ -1,301 +0,0 @@
[GLOBAL]
# This section defines migrator's global settings.
# [mandatory, non-modifiable] source-type
# Source servers' product type.
# This is a template of configuration file for migration from custom panel to Plesk.
# For other source or target panels, browse other provided
# configuration templates and pick one that best suits your source type.
source-type: custom
# [mandatory] sources
# A comma-separated list of the sections, that describe source hosting description files and servers
sources: myserver
# [optiona] db-servers
# A comma-separated list of the sections, that describe source database servers
db-servers: mysql1
# [optional] external-mail-servers
# A comma-separated list of the sections, that describe external source mail servers
external-mail-servers: mail1
# [optional] session-dir
# A directory for migration tool's temporary files.
# If not specified, temporary files will be put into './migration-session'.
# session-dir: migration-session
# [optional] log-message-context-length
# When logging a multiline output (API request, response), show only top N
# and last N lines. Default value is 0, which means to display full API requests.
# log-message-context-length: 10
# [optional] use-separate-log
# Write migrator logs to a session directory, not to global logs directory.
# By default is true.
# use-separate-log: true
# [optional] use-binary-log
# Write binary migrator logs, which are necessary to display logs in GUI.
# By default is true.
# use-binary-log: true
# [optional] adjust-applications
# Whether to fix configuration files of several commonly used web applications.
# The fix could include database connection changes, path fixes, and so on.
# By default this option is enabled. You could disable it if it breaks migration of some
# application, or if you need better speed of migration.
# adjust-applications: true
# [optional] skip-actions
# List of actions which should not be executed during migration.
# Be careful when setting this option - other actions may rely on results of skipped actions. So, skipping
# an action could lead to broken migration.
# List format: action identifiers separated by ",".
# If you want to skip action for specific subscription only, specify the subscription after action identifier
# separated by ":".
# Example value: convert-dns, fetch-source, copy-mail-content:example.com, copy-web-files:example.com
# In that case migrator will not execute "convert-dns" and "fetch-source" actions for all subscriptions
# and will not execute "copy-mail-content" and "copy-web-files" for subscription "example.com"
# (still content will be copied for all the other migrated subscriptions).
# By default no actions are skipped.
# To list all actions executed by migrator (with their identifiers and text descriptions),
# prepare configuration file (config.ini) and run "plesk-migrator print-workflow config.ini".
# skip-actions:
# [optional] restore-hosting-settings-poll-limit
# When restoring hosting settings (addon domains, mailboxes, PHP settings, etc) of subscriptions,
# a special restore hosting settings task is started asynchroniously. Migrator polls status of
# the task periodically and check whether it finished.
# This options specifies maximum number of attempts to poll the task before we consider the task hanged.
# Additionally see "restore-hosting-settings-poll-interval" option.
# Total timeout after which we consider that restore hosting task hanged is
# "restore-hosting-settings-poll-limit" multiplied by "restore-hosting-settings-poll-interval".
# restore-hosting-settings-poll-limit: 7200
# [optional] restore-hosting-settings-poll-interval
# When restoring hosting settings (addon domains, mailboxes, PHP settings, etc) of subscriptions,
# a special restore hosting settings task is started asynchroniously. Migrator polls status of
# the task periodically and check whether it finished
# This options specifies interval between poll attempts (in seconds). Less inteval gives more instant detection
# that task has finished, but a bit more load on CPU/disk.
# Additionally see "restore-hosting-settings-poll-limit" option.
# Total timeout after which we consider that restore hosting task hanged is
# "restore-hosting-settings-poll-limit" multiplied by "restore-hosting-settings-poll-interval".
# restore-hosting-settings-poll-interval: 1
# [optional] rsync-additional-args
# Additional arguments which will be passed to "rsync" utility when it transfers files
# from the source server.
# For example, here you could enable compression with "rsync-additional-args: -z"
# to optimize file transfer time.
# rsync-additional-args:
[plesk]
# This section defines target panel settings.
# [mandatory] ip
# An IPv4 address of the target Plesk server.
ip:
# [mandatory] os
# Server's operating system type, 'unix' or 'windows'.
os: unix
# [optional] panel-username
# Panel administrator's login. If not specified, 'admin' is used.
# panel-username: admin
# [optional] panel-password
# Panel administrator password. If not specified, it is automatically detected.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]PANEL_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
# panel-password: setup
# [optional] panel-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# panel-password-type: plain
# [optional] plesk-port
# Port of Plesk UI/API
# plesk-port: 8443
# [optional] session-dir
# A directory for temporary files on Plesk target server.
# Option makes sense only if you run Plesk Migrator on another server than target Plesk.
# If you run Plesk Migrator on the same server as target Plesk, all temporary files are placed
# to session directory according to [GLOBAL] section.
# If not specified, temporary files will be put into '/root/plesk_migrator'
# session-dir: /root/plesk_migrator
# [optional] is-local
# Whether migration tools are working on the same server as target Plesk.
# Default is true.
# is-local: true
# [optional] apache-restart-interval
# Minimum time interval, in seconds, between Apache restarts during a
# migration. If this interval is short, Apache will restart too often. This
# will cause long downtimes on Plesk target server. If this interval is long,
# existing users of Plesk target server will have to wait longer for their
# changes to be applied. To skip changing Apache restart interval set value to
# 'none'. If not specified, migration tool will skip changing the Apache
# restart interval.
# apache-restart-interval: none
[myserver]
# [mandatory] hosting-description
# Specify location of hosting description file
hosting-description: hosting-description.yaml
# [optional] description-format
# Specify format of hosting description file (json/yaml/xml). By default, hosting description
# file is treated as YAML
# description-format: yaml
# [optional] ip
# An IP v4 address of the source server. If specified, it is used to get web files, databases, and mail messages.
ip:
# [optional] os
# Server's operating system type, 'unix' or 'windows'.
os: unix
# [optional] ssh-username
# User name of the privileged system user on this source server. If not specified, 'root' is used.
# ssh-username: root
# [optional] ssh-auth-type
# SSH authentication type.
# There are two authentication types supported: 'password' or 'key'. Default is 'password'.
# ssh-auth-type: password
# [optional] ssh-password
# Password of the privileged system user.
# You must specify it, if you select SSH authentication type password.
# Note that the hash mark in password is treated as a regular symbol.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]SSH_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
ssh-password:
# [optional] ssh-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# ssh-password-type: plain
# [optional] ssh-key
# Path to SSH private key file. You can specify it if you select SSH
# authentication type 'key'. If not specified, "id_rsa" or "id_dsa" keys from
# the directory '~/.ssh' are used.
# ssh-key: /root/.ssh/id_rsa
# [optional] ssh-port
# Port number on which SSH service accepts incoming connections
# ssh-port: 22
# [optional] session-dir
# A directory for temporary files.
# If not specified, temporary files are put into /root/plesk_migrator.
# session-dir: /root/plesk_migrator
# [optional] ssh-authorized-keys-file
# This parameter specifies location of SSH authorized keys file for root user.
# This file is necessary for setting up key auth when copying files with rsync: copy web content, deploy agent, etc.
# By default, if this parameter is not specified, migrator will put public keys to
# '~/.ssh/authorized_keys' and '~/.ssh/authorized_keys2' files. So, in default configuration
# this option should not be touched. If you have troubles setting up key auth during migration,
# check AuthorizedKeysFile option in your SSH server's configuration file (usually /etc/ssh/sshd_config).
# ssh-authorized-keys-file: ~/.ssh/authorized_keys
# [optional] mail-target-log-enabled
# Whether additional logging is enabled for "mail-migrator" utility running on the target server for IMAP migrations
# Corresponding log will be put to:
# <session-dir>/mail/<domain-name>/<mail-name>/mail-imap-migration.log
# mail-target-log-enabled: false
# [optional] mail-target-additional-options
# Additional command line options to pass to "mail-migrator" utility running on the target server for IMAP migrations.
# Example of value (to specify IMAP port): --port=123
# mail-target-additional-options:
[mysql1]
# [mandatory] type
# Specify type of database server: 'mysql' for MySQL
type: mysql
# [mandatory] host
# Hostname or IP address of the server
host:
# [mandatory] port
# Database server's port
port: 3306
# [mandatory] login
# Administrator login of database server
login: admin
# [mandatory] password
# Administrator password of database server
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
password:
# [optional] password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# password-type: plain
[mail1]
# [optional] ip
# An IP v4 address of the mail source server.
ip:
# [optional] os
# Server's operating system type, 'unix' or 'windows'.
os: unix
# [optional] ssh-username
# User name of the privileged system user on this source server. If not specified, 'root' is used.
# ssh-username: root
# [optional] ssh-auth-type
# SSH authentication type.
# There are two authentication types supported: 'password' or 'key'. Default is 'password'.
# ssh-auth-type: password
# [optional] ssh-password
# Password of the privileged system user.
# You must specify it, if you select SSH authentication type password.
# Note that the hash mark in password is treated as a regular symbol.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]SSH_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
ssh-password:
# [optional] ssh-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# ssh-password-type: plain
# [optional] ssh-key
# Path to SSH private key file. You can specify it if you select SSH
# authentication type 'key'. If not specified, "id_rsa" or "id_dsa" keys from
# the directory '~/.ssh' are used.
# ssh-key: /root/.ssh/id_rsa
# [optional] ssh-port
# Port number on which SSH service accepts incoming connections
# ssh-port: 22
# [optional] session-dir
# A directory for temporary files.
# If not specified, temporary files are put into /root/plesk_migrator.
# session-dir: /root/plesk_migrator
# [optional] ssh-authorized-keys-file
# This parameter specifies location of SSH authorized keys file for root user.
# This file is necessary for setting up key auth when copying files with rsync: copy web content, deploy agent, etc.
# By default, if this parameter is not specified, migrator will put public keys to
# '~/.ssh/authorized_keys' and '~/.ssh/authorized_keys2' files. So, in default configuration
# this option should not be touched. If you have troubles setting up key auth during migration,
# check AuthorizedKeysFile option in your SSH server's configuration file (usually /etc/ssh/sshd_config).
# ssh-authorized-keys-file: ~/.ssh/authorized_keys

View File

@@ -1,13 +0,0 @@
[GLOBAL]
source-type: custom
sources: myserver
[plesk]
ip:
os: unix
[myserver]
hosting-description: hosting-description.yaml
ip:
os: unix
ssh-password:

View File

@@ -1,361 +0,0 @@
[GLOBAL]
# This section defines migrator's global settings.
# [mandatory, non-modifiable] source-type
# Source servers' product type.
# This is a template of configuration file for migration from custom panel to Plesk.
# For other source or target panels, browse other provided
# configuration templates and pick one that best suits your source type.
source-type: custom
# [mandatory] sources
# A comma-separated list of the sections, that describe source hosting description files and servers
sources: myserver
# [optional] db-servers
# A comma-separated list of the sections, that describe source database servers
db-servers: mysql1
# [optional] external-mail-servers
# A comma-separated list of the sections, that describe external source mail servers
external-mail-servers: mail1
# [optional] session-dir
# A directory for migration tool's temporary files.
# If not specified, temporary files will be put into './migration-session'.
# session-dir: migration-session
# [optional] log-message-context-length
# When logging a multiline output (API request, response), show only top N
# and last N lines. Default value is 0, which means to display full API requests.
# log-message-context-length: 10
# [optional] copy-mssql-content
# Select way to copy MSSQL content: native MSSQL dumps, text dumps or automatic selection (default).
# Possible values: 'native', 'text', 'auto'
# Native backups require direct access of migration tool to all MSSQL servers.
# 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
# Write migrator logs to a session directory, not to global logs directory.
# By default is true.
# use-separate-log: true
# [optional] use-binary-log
# Write binary migrator logs, which are necessary to display logs in GUI.
# By default is true.
# use-binary-log: true
# [optional] adjust-applications
# Whether to fix configuration files of several commonly used web applications.
# The fix could include database connection changes, path fixes, and so on.
# By default this option is enabled. You could disable it if it breaks migration of some
# application, or if you need better speed of migration.
# adjust-applications: true
# [optional] adjust-web-config-remove-absent-handlers
# Whether to remove absent handlers from web.config file during application adjustment.
# For example, it could be useful when you have some custom PHP handler on the source server,
# located at "C:\Custom-PHP\php-cgi.exe", but on the target server you want to use default
# PHP bundled with Plesk. In such case you do not install custom PHP on the target,
# enable this option, run migration, and "C:\Custom-PHP\php-cgi.exe"
# will be removed from all web.config files. Otherwise the site won't work.
# Application adjusment ("adjust-applications" option) should be enabled to use that option.
# adjust-web-config-remove-absent-handlers: false
# [optional] detect-scripting-settings
# Whether to detect scripting settings (PHP version, ASP.NET version, if ASP is enabled or not, etc)
# by uploading probe scripts to the source server.
# By default, this option is disabled, and migrator will take scripting settings as they are
# provided in hosting description.
# detect-scripting-settings: false
# [optional] skip-actions
# List of actions which should not be executed during migration.
# Be careful when setting this option - other actions may rely on results of skipped actions. So, skipping
# an action could lead to broken migration.
# List format: action identifiers separated by ",".
# If you want to skip action for specific subscription only, specify the subscription after action identifier
# separated by ":".
# Example value: convert-dns, fetch-source, copy-mail-content:example.com, copy-web-files:example.com
# In that case migrator will not execute "convert-dns" and "fetch-source" actions for all subscriptions
# and will not execute "copy-mail-content" and "copy-web-files" for subscription "example.com"
# (still content will be copied for all the other migrated subscriptions).
# By default no actions are skipped.
# To list all actions executed by migrator (with their identifiers and text descriptions),
# prepare configuration file (config.ini) and run "plesk-migrator print-workflow config.ini".
# skip-actions:
# [optional] restore-hosting-settings-poll-limit
# When restoring hosting settings (addon domains, mailboxes, PHP settings, etc) of subscriptions,
# a special restore hosting settings task is started asynchroniously. Migrator polls status of
# the task periodically and check whether it finished.
# This options specifies maximum number of attempts to poll the task before we consider the task hanged.
# Additionally see "restore-hosting-settings-poll-interval" option.
# Total timeout after which we consider that restore hosting task hanged is
# "restore-hosting-settings-poll-limit" multiplied by "restore-hosting-settings-poll-interval".
# restore-hosting-settings-poll-limit: 7200
# [optional] restore-hosting-settings-poll-interval
# When restoring hosting settings (addon domains, mailboxes, PHP settings, etc) of subscriptions,
# a special restore hosting settings task is started asynchroniously. Migrator polls status of
# the task periodically and check whether it finished
# This options specifies interval between poll attempts (in seconds). Less inteval gives more instant detection
# that task has finished, but a bit more load on CPU/disk.
# Additionally see "restore-hosting-settings-poll-limit" option.
# Total timeout after which we consider that restore hosting task hanged is
# "restore-hosting-settings-poll-limit" multiplied by "restore-hosting-settings-poll-interval".
# restore-hosting-settings-poll-interval: 1
# [optional] rsync-additional-args
# Additional arguments which will be passed to "rsync" utility when it transfers files
# from the source server.
# For example, here you could enable compression with "rsync-additional-args: -z"
# to optimize file transfer time.
# rsync-additional-args:
[plesk]
# This section defines target panel settings.
# [mandatory] ip
# An IPv4 address of the target Plesk server.
ip:
# [mandatory] os
# Server's operating system type, 'unix' or 'windows'.
os: windows
# [optional] panel-username
# Panel administrator's login. If not specified, 'admin' is used.
# panel-username: admin
# [optional] panel-password
# Panel administrator password. If not specified, it is automatically detected.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]PANEL_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
# panel-password: setup
# [optional] panel-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# panel-password-type: plain
# [optional] plesk-port
# Port of Plesk UI/API
# plesk-port: 8443
# [optional] session-dir
# A directory for temporary files on Plesk target server.
# Option makes sense only if you run Plesk Migrator on another server than target Plesk.
# If you run Plesk Migrator on the same server as target Plesk, all temporary files are placed
# to session directory according to [GLOBAL] section.
# If not specified, temporary files will be put into 'C:\plesk_migrator'
# session-dir: C:\plesk_migrator
# [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
# Whether migration tools are working on the same server as target Plesk.
# Default is true.
# is-local: true
[myserver]
# [mandatory] hosting-description
# Specify location of hosting description file
hosting-description: hosting-description.yaml
# [optional] description-format
# Specify format of hosting description file (json/yaml/xml). By default, hosting description
# file is treated as YAML
# description-format: yaml
# [optional] ip
# An IP v4 address of the source server. If specified, it is used to get web files, databases, and mail messages.
ip:
# [optional] os
# Server's operating system type, 'unix' or 'windows'.
os: windows
# [optional] windows-username
# User name of the privileged system user on the source server. Default is 'Administrator'.
# windows-username: Administrator
# [optional] windows-password
# Password of the privileged system user on the source server.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]WINDOWS_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
windows-password:
# [optional] windows-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# windows-password-type: plain
# [optional] session-dir
# A directory for temporary files.
# If not specified, temporary files are put into C:\plesk_migrator.
# session-dir: C:\plesk_migrator
# [optional] mail-source-log-enabled
# Whether additional logging is enabled for MailMigrator.exe utility running on the source server
# Corresponding log will be put to <session-dir>/mail/<domain-name>/<mail-name>/mail-backup.log
# mail-source-log-enabled: false
# [optional] mail-target-log-enabled
# Whether additional logging is enabled for MailMigrator.exe utility running on the target server
# Corresponding logs will be put to:
# <session-dir>/mail/<domain-name>/<mail-name>/mail-restore.log
# <session-dir>/mail/<domain-name>/<mail-name>/mail-list-messages.log
# <session-dir>/mail/<domain-name>/<mail-name>/mail-imap-migration.log
# mail-target-log-enabled: false
# [optional] mail-source-provider
# Override mail provider (mail server type) used by MailMigrator.exe utility running on the source server.
# Examples of possible values: "mailenable", "smartermail", "imap", and so on.
# For the full list of possible values, refer to "MailMigrator.exe help" output.
# mail-source-provider:
# [optional] mail-target-provider
# Override mail provider (mail server type) used by MailMigrator.exe utility running on the target server.
# Examples of possible values: "mailenable", "smartermail", "imap", and so on.
# For the full list of possible values, refer to "MailMigrator.exe help" output.
# mail-target-provider:
# [optional] mail-source-additional-options
# Additional command line options to pass to MailMigrator.exe utility running on the source server.
# Example of value (to specify IMAP port): --port=123
# mail-source-additional-options:
# [optional] mail-target-additional-options
# Additional command line options to pass to MailMigrator.exe utility running on the target server.
# Example of value (to specify IMAP port): --port=123
# mail-target-additional-options:
[mysql1]
# [mandatory] type
# Specify type of database server: 'mysql' for MySQL, 'mssql' for MSSQL
type: mysql
# [mandatory] host
# Hostname or IP address of the server
# For MSSQL named instance, specify with instance name, for example '192.168.1.34\SQLEXPRESS'
host:
# [mandatory] port
# Database server's port
port: 3306
# [mandatory] login
# Administrator login of database server
login: admin
# [mandatory] password
# Administrator password of database server
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
password:
# [optional] password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# password-type: plain
[mail1]
# [optional] ip
# An IP v4 address of the source mail server.
ip:
# [optional] os
# Server's operating system type, 'unix' or 'windows'.
os: windows
# [optional] windows-username
# User name of the privileged system user on the source server. Default is 'Administrator'.
# windows-username: Administrator
# [optional] windows-password
# Password of the privileged system user on the source server.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]WINDOWS_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
windows-password:
# [optional] windows-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# windows-password-type: plain
# [optional] session-dir
# A directory for temporary files.
# If not specified, temporary files are put into C:\plesk_migrator.
# session-dir: C:\plesk_migrator
# [optional] mail-source-log-enabled
# Whether additional logging is enabled for MailMigrator.exe utility running on the source server
# Corresponding log will be put to <session-dir>/mail/<domain-name>/<mail-name>/mail-backup.log
# mail-source-log-enabled: false
# [optional] mail-target-log-enabled
# Whether additional logging is enabled for MailMigrator.exe utility running on the target server
# Corresponding logs will be put to:
# <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
# Override mail provider (mail server type) used by MailMigrator.exe utility running on the source server.
# Examples of possible values: "mailenable", "smartermail", "imap", and so on.
# For the full list of possible values, refer to "MailMigrator.exe help" output.
# mail-source-provider:
# [optional] mail-target-provider
# Override mail provider (mail server type) used by MailMigrator.exe utility running on the target server.
# Examples of possible values: "mailenable", "smartermail", "imap", and so on.
# For the full list of possible values, refer to "MailMigrator.exe help" output.
# mail-target-provider:
# [optional] mail-source-additional-options
# Additional command line options to pass to MailMigrator.exe utility running on the source server.
# Example of value (to specify IMAP port): --port=123
# mail-source-additional-options:
# [optional] mail-target-additional-options
# Additional command line options to pass to MailMigrator.exe utility running on the target server.
# Example of value (to specify IMAP port): --port=123
# mail-target-additional-options:
[target-remote-smarter-mail]
# This optional section defines settings of target remote SmarterMail server
# [optional] ip
# An IPv4 address of the target remote SmarterMail server used for communications with it.
# Detected automatically if not specified.
# ip:
# [optional] windows-username
# User name of the privileged system user on this Plesk server. Default is 'Administrator'.
# windows-username: Administrator
# [optional] windows-password
# Password of the privileged system user on this server.
# The more secure way to pass a password is using the environment variable
# TARGET_REMOTE_SMARTER_MAIL_WINDOWS_PASSWORD. For that keep this option empty
# and set up the environment variable before the migrator run.
# windows-password:
# [optional] windows-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# windows-password-type: plain
# [optional] session-dir
# A directory for temporary files.
# If not specified, temporary files are put into C:\plesk_migrator.
# session-dir: C:\plesk_migrator

View File

@@ -1,13 +0,0 @@
[GLOBAL]
source-type: custom
sources: myserver
[plesk]
ip:
os: windows
[myserver]
hosting-description: hosting-description.yaml
ip:
os: windows
windows-password: password

View File

@@ -1,16 +0,0 @@
SET hd=%~dp0\hosting-description.yaml
echo customers: > %hd%
echo - >> %hd%
echo login: jsmith >> %hd%
echo password: 123qwe >> %hd%
echo contact_info: >> %hd%
echo name: John Smith >> %hd%
echo email: jsmith@example.com >> %hd%
echo subscriptions: >> %hd%
echo - >> %hd%
echo name: example.com >> %hd%
echo sys_user: >> %hd%
echo login: jsmith >> %hd%
echo password: 123qwe1 >> %hd%
mkdir %~dp0\output
echo done > %~dp0\output\log.txt

View File

@@ -1,7 +0,0 @@
<migrator-extension>
<source-panel-title>Demo panel (Windows executable agent)</source-panel-title>
<show-in-gui>windows</show-in-gui>
<version>1.0</version>
<entry-point>agent.bat</entry-point>
<execution>executable</execution>
</migrator-extension>

View File

@@ -1,18 +0,0 @@
HD=$(dirname "$0")/hosting-description.yaml
echo "customers:" > $HD
echo " -" >> $HD
echo " login: jsmith" >> $HD
echo " password: 123qwe" >> $HD
echo " contact_info:" >> $HD
echo " name: John Smith" >> $HD
echo " email: jsmith@example.com" >> $HD
echo " subscriptions:" >> $HD
echo " -" >> $HD
echo " name: example.com" >> $HD
echo " sys_user:" >> $HD
echo " login: jsmith" >> $HD
echo " password: 123qwe1" >> $HD
if [ ! -d "$(dirname "$0")/output" ]; then
mkdir $(dirname "$0")/output
fi
echo "done" > $(dirname "$0")/output/log.txt

View File

@@ -1,7 +0,0 @@
<migrator-extension>
<source-panel-title>Demo panel (Unix executable agent)</source-panel-title>
<show-in-gui>unix</show-in-gui>
<version>1.0</version>
<entry-point>agent.sh</entry-point>
<execution>executable</execution>
</migrator-extension>

View File

@@ -1,33 +0,0 @@
import yaml
import os
if __name__ == '__main__':
data = {
'customers': [
{
'login': 'jsmith',
'password': '123qwe',
'contact_info': {
'name': 'John Smith',
'email': 'jsmith@example.com'
},
'subscriptions': [
{
'name': 'example.com',
'sys_user': {
'login': 'jsmith',
'password': '123qwe1'
}
}
]
}
]
}
script_dir = os.path.dirname(os.path.abspath(__file__))
with open(os.path.join(script_dir, 'hosting-description.yaml'), 'w') as f:
yaml.safe_dump(data, f, encoding='utf-8', allow_unicode=True)
output_dir = os.path.join(script_dir, 'output')
if not os.path.isdir(output_dir):
os.mkdir(output_dir)
with open(os.path.join(script_dir, 'output', 'log.txt'), 'w') as f:
f.write('done')

View File

@@ -1,7 +0,0 @@
<migrator-extension>
<source-panel-title>Demo panel (Python script agent)</source-panel-title>
<show-in-gui>all</show-in-gui>
<version>1.0</version>
<entry-point>agent.py</entry-point>
<execution>migrator-python</execution>
</migrator-extension>

View File

@@ -1,20 +0,0 @@
{
"subscriptions": [
{
"name": "remotemail.tld",
"sys_user": {
"login": "remotemail"
},
"mail_service": {
"mail_server": "mail1",
"mail_users": [
{
"name": "sales",
"password": "qweqwe",
"directory": "/var/qmail/mailnames/remotemail.tld/sales"
}
]
}
}
]
}

View File

@@ -1,26 +0,0 @@
# An example of the hosting description file. All hosting description file settings are enumerated in
# '{PLESK_DIR}/admin/plib/modules/panel-migrator/backend/lib/python/parallels/plesk/hosting_description/schema.json'.
# This example describes how to specify external mail server, in case when server
# with web files and server with mail messages are different servers.
subscriptions:
-
name: remotemail.tld
sys_user:
login: remotemail
mail_service:
# Here is a reference for mail server on which mail messages of that subscription are located.
# Name "mail1" is just an identifier, that must be described in configuration file
# of Plesk Migrator (config.ini) in two places:
# - in "external-mail-servers" option of [GLOBAL] section.
# - as a separate section, where you describe IP address, server credentials and other options.
# Check configuration file examples ("custom-unix.ini" and "custom-windows.ini") for more details.
mail_server: mail1
# Here we describe mail users as usual:
mail_users:
-
name: sales
password: qweqwe
# For Unix, specify location of mail directory, in the same way as if you have web and mail
# services on a single server. For Windows, there is no such need.
directory: /var/qmail/mailnames/remotemail.tld/sales

View File

@@ -1,23 +0,0 @@
{
"subscriptions": [
{
"name": "mail.tld",
"mail_service": {
"mail_users": [
{
"mail_ip": "192.168.1.1",
"name": "sales",
"password": "qweqwe"
},
{
"mail_ip": "192.168.1.2",
"name": "admin",
"password": "qweqwe",
"source_full_name": "user@another-domain.tld",
"source_password": "123qwe"
}
]
}
}
]
}

View File

@@ -1,45 +0,0 @@
# An example of the hosting description file. All hosting description file settings are enumerated in
# '{PLESK_DIR}/admin/plib/modules/panel-migrator/backend/lib/python/parallels/plesk/hosting_description/schema.json'.
# This example describes how to perform mail migration by IMAP
subscriptions:
-
# Mail will be migrated to specified subscription. If it does not exist - it will be created.
name: mail.tld
mail_service:
# Here we describe mail users as usual:
mail_users:
# Simple example, when you migrate mail account that has the same e-mail and password
# both on source and target servers.
-
# Specify IP address of the source mail server.
mail_ip: 192.168.1.1
# Account name - everything before '@' in e-mail address.
# If account does not exist - it will be created.
name: sales
# Password of the mail account on both source and target server.
# It will be used to:
# - create mail account on the target server
# - connect by IMAP to the source server
# If you need different passwords for source and target servers - check the next mail
# account example below.
# Correct password is required to perform mail migration by IMAP.
password: qweqwe
# Example, when you migrate mail account that has different e-mail or password on source
# and target servers.
-
# Specify IP address of the source mail server.
mail_ip: 192.168.1.2
# Target account name - everything before '@' in e-mail address.
# If account does not exist - it will be created.
name: admin
# Password of the mail account on the target server.
password: qweqwe
# Here we specify that we want to migrate mail
# from "user@another-domain.tld" to "admin@mail.tld"
# (if that option is not specified, migration
# from "admin@mail.tld" to "admin@mail.tld" is performed).
source_full_name: user@another-domain.tld
# Password of mail account on the source server.
# Correct password is required to perform mail migration by IMAP.
source_password: 123qwe

View File

@@ -1,24 +0,0 @@
{
"subscriptions": [
{
"name": "example.tld",
"source_webspace_root": "/var/www/vhosts/example.tld",
"sys_user": {
"login": "dsmith"
},
"databases": [
{
"type": "mysql",
"name": "dsmithdb",
"server": "mysql1",
"users": [
{
"login": "dsmith",
"password": "123qwe"
}
]
}
]
}
]
}

View File

@@ -1,18 +0,0 @@
# An example of the hosting description file. All hosting description file settings are enumerated in
# '{PLESK_DIR}/admin/plib/modules/panel-migrator/backend/lib/python/parallels/plesk/hosting_description/schema.json'.
subscriptions:
-
name: example.tld
source_webspace_root: /var/www/vhosts/example.tld
sys_user:
login: dsmith
databases:
-
type: mysql
name: dsmithdb
# The database server name is defined in the file 'config.ini'
server: mysql1
users:
-
login: dsmith
password: 123qwe

View File

@@ -1,20 +0,0 @@
{
"subscriptions": [
{
"name": "example.tld",
"source_webspace_root": "/var/www/vhosts/example.tld",
"sys_user": {
"login": "dsmith"
},
"mail_service": {
"mail_users": [
{
"name": "dsmith",
"password": "qweqwe",
"directory": "/var/qmail/mailnames/example.tld/dsmith"
}
]
}
}
]
}

View File

@@ -1,14 +0,0 @@
# An example of the hosting description file. All hosting description file settings are enumerated in
# '{PLESK_DIR}/admin/plib/modules/panel-migrator/backend/lib/python/parallels/plesk/hosting_description/schema.json'.
subscriptions:
-
name: example.tld
source_webspace_root: /var/www/vhosts/example.tld
sys_user:
login: dsmith
mail_service:
mail_users:
-
name: dsmith
password: qweqwe
directory: /var/qmail/mailnames/example.tld/dsmith

View File

@@ -1,11 +0,0 @@
{
"subscriptions": [
{
"name": "example.tld",
"source_webspace_root": "/var/www/vhosts/example.tld",
"sys_user": {
"login": "dsmith"
}
}
]
}

View File

@@ -1,8 +0,0 @@
# An example of the hosting description file. All hosting description file settings are enumerated in
# '{PLESK_DIR}/admin/plib/modules/panel-migrator/backend/lib/python/parallels/plesk/hosting_description/schema.json'.
subscriptions:
-
name: example.tld
source_webspace_root: /var/www/vhosts/example.tld
sys_user:
login: dsmith

View File

@@ -1,121 +0,0 @@
{
"subscriptions": [
{
"name": "example.tld",
"source_webspace_root": "/var/www/vhosts/example.tld",
"sys_user": {
"login": "dsmith",
"password": "123qwe"
},
"ftp_users": [
{
"login": "dsmithftp",
"password": "qweasd"
}
],
"web_users": [
{
"login": "dsmithweb",
"password": "asdasd"
}
],
"protected_directories": [
{
"path": "documents",
"users": [
{
"login": "dsmithdoc",
"password": "azsxdc"
}
]
}
],
"mail_service": {
"mail_users": [
{
"name": "dsmith",
"password": "qweqwe",
"directory": "/var/qmail/mailnames/example.tld/dsmith"
}
]
},
"addon_domains": [
{
"name": "example.com",
"protected_directories": [
{
"path": "files",
"users": [
{
"login": "dsmithfiles",
"password": "qawsed"
}
]
}
],
"mail_service": {
"mail_users": [
{
"name": "dsmith",
"password": "1q2w3e",
"directory": "/var/qmail/mailnames/example.com/dsmith"
}
]
},
"aliases": [
{
"name": "example.net"
}
]
}
],
"subdomains": [
{
"name": "sub.example.tld",
"protected_directories": [
{
"path": "video",
"users": [
{
"login": "dsmithvideo",
"password": "azsxdc"
}
]
}
]
}
],
"aliases": [
{
"name": "example.info"
}
],
"databases": [
{
"type": "mysql",
"name": "dsmithdb",
"server": "mysql1",
"users": [
{
"login": "dsmith",
"password": "123qwe"
}
]
}
],
"database_users": [
{
"login": "dsmithall",
"password": "azsxdc",
"server": "mysql1"
}
],
"scheduled_tasks": [
{
"type": "exec",
"command": "uptime"
}
]
}
]
}

View File

@@ -1,80 +0,0 @@
# An example of the hosting description file. All hosting description file settings are enumerated in
# '{PLESK_DIR}/admin/plib/modules/panel-migrator/backend/lib/python/parallels/plesk/hosting_description/schema.json'.
subscriptions:
-
name: example.tld
source_webspace_root: /var/www/vhosts/example.tld
sys_user:
login: dsmith
password: 123qwe
ftp_users:
-
login: dsmithftp
password: qweasd
web_users:
-
login: dsmithweb
password: asdasd
protected_directories:
-
path: documents
users:
-
login: dsmithdoc
password: azsxdc
mail_service:
mail_users:
-
name: dsmith
password: qweqwe
directory: /var/qmail/mailnames/example.tld/dsmith
addon_domains:
-
name: example.com
protected_directories:
-
path: files
users:
-
login: dsmithfiles
password: qawsed
mail_service:
mail_users:
-
name: dsmith
password: 1q2w3e
directory: /var/qmail/mailnames/example.com/dsmith
aliases:
-
name: example.net
subdomains:
-
name: sub.example.tld
protected_directories:
-
path: video
users:
-
login: dsmithvideo
password: azsxdc
aliases:
-
name: example.info
databases:
-
type: mysql
name: dsmithdb
server: mysql1
users:
-
login: dsmith
password: 123qwe
database_users:
-
login: dsmithall
password: azsxdc
server: mysql1
scheduled_tasks:
-
type: exec
command: uptime

View File

@@ -1,161 +0,0 @@
{
"reseller_plans": [
{
"name": "Default Reseller",
"guid": "42726525-7185-2cd7-a54d-b7fca6fd44d8"
}
],
"hosting_plans": [
{
"name": "Default Domain",
"guid": "8797eb49-60ff-050b-f469-eddec76fbec0"
}
],
"resellers": [
{
"login": "jsmith",
"password": "123qwe",
"subscription_info": {
"plans": [
{
"guid": "42726525-7185-2cd7-a54d-b7fca6fd44d8"
}
]
},
"users": [
{
"login": "msmith",
"password": "qweqwe",
"role": "Mail Manager"
}
],
"roles": [
{
"name": "Mail Manager"
}
],
"hosting_plans": [
{
"name": "Default Domain",
"guid": "4efc302d-7459-6636-3d29-d1ce80785213"
}
],
"customers": [
{
"login": "asmith",
"password": "asdasd",
"users": [
{
"login": "rsmith",
"password": "zxczxc",
"role": "Backup Manager"
}
],
"roles": [
{
"name": "Backup Manager"
}
],
"subscriptions": [
{
"name": "asmith.example.tld",
"source_webspace_root": "/var/www/vhosts/asmith.example.tld",
"sys_user": {
"login": "asmith",
"password": "1q2w3e"
},
"subscription_info": {
"plans": [
{
"guid": "4efc302d-7459-6636-3d29-d1ce80785213"
}
]
}
}
]
}
],
"subscriptions": [
{
"name": "jsmith.example.tld",
"source_webspace_root": "/var/www/vhosts/jsmith.example.tld",
"sys_user": {
"login": "jsmith",
"password": "azsxdc"
},
"subscription_info": {
"plans": [
{
"guid": "4efc302d-7459-6636-3d29-d1ce80785213"
}
]
}
}
]
}
],
"customers": [
{
"login": "bsmith",
"password": "qawsed",
"users": [
{
"login": "csmith",
"password": "azsxdc",
"role": "DNS Manager"
}
],
"roles": [
{
"name": "DNS Manager"
}
],
"subscriptions": [
{
"name": "bsmith.example.tld",
"source_webspace_root": "/var/www/vhosts/bsmith.example.tld",
"sys_user": {
"login": "bsmith",
"password": "zxczxc"
},
"subscription_info": {
"plans": [
{
"guid": "8797eb49-60ff-050b-f469-eddec76fbec0"
}
]
}
}
]
}
],
"subscriptions": [
{
"name": "example.tld",
"source_webspace_root": "/var/www/vhosts/example.tld",
"sys_user": {
"login": "dsmith",
"password": "qzwxec"
},
"subscription_info": {
"plans": [
{
"guid": "8797eb49-60ff-050b-f469-eddec76fbec0"
}
]
}
}
],
"users": [
{
"login": "ssmith",
"password": "asdasd",
"role": "Database Manager"
}
],
"roles": [
{
"name": "Database Manager"
}
]
}

View File

@@ -1,106 +0,0 @@
# An example of the hosting description file. All hosting description file settings are enumerated in
# '{PLESK_DIR}/admin/plib/modules/panel-migrator/backend/lib/python/parallels/plesk/hosting_description/schema.json'.
reseller_plans:
-
name: Default Reseller
guid: 42726525-7185-2cd7-a54d-b7fca6fd44d8
hosting_plans:
-
name: Default Domain
guid: 8797eb49-60ff-050b-f469-eddec76fbec0
resellers:
-
login: jsmith
password: 123qwe
subscription_info:
plans:
-
guid: 42726525-7185-2cd7-a54d-b7fca6fd44d8
users:
-
login: msmith
password: qweqwe
role: Mail Manager
roles:
-
name: Mail Manager
hosting_plans:
-
name: Default Domain
guid: 4efc302d-7459-6636-3d29-d1ce80785213
customers:
-
login: asmith
password: asdasd
users:
-
login: rsmith
password: zxczxc
role: Backup Manager
roles:
-
name: Backup Manager
subscriptions:
-
name: asmith.example.tld
source_webspace_root: /var/www/vhosts/asmith.example.tld
sys_user:
login: asmith
password: 1q2w3e
subscription_info:
plans:
-
guid: 4efc302d-7459-6636-3d29-d1ce80785213
subscriptions:
-
name: jsmith.example.tld
source_webspace_root: /var/www/vhosts/jsmith.example.tld
sys_user:
login: jsmith
password: azsxdc
subscription_info:
plans:
-
guid: 4efc302d-7459-6636-3d29-d1ce80785213
customers:
-
login: bsmith
password: qawsed
users:
-
login: csmith
password: azsxdc
role: DNS Manager
roles:
-
name: DNS Manager
subscriptions:
-
name: bsmith.example.tld
source_webspace_root: /var/www/vhosts/bsmith.example.tld
sys_user:
login: bsmith
password: zxczxc
subscription_info:
plans:
-
guid: 8797eb49-60ff-050b-f469-eddec76fbec0
subscriptions:
-
name: example.tld
source_webspace_root: /var/www/vhosts/example.tld
sys_user:
login: dsmith
password: qzwxec
subscription_info:
plans:
-
guid: 8797eb49-60ff-050b-f469-eddec76fbec0
users:
-
login: ssmith
password: asdasd
role: Database Manager
roles:
-
name: Database Manager

View File

@@ -1,43 +0,0 @@
<migrator-extension>
<!-- Name of the source panel -->
<source-panel-title>mypanel</source-panel-title>
<!--
Whether to show this extension in migrator GUI.
For extensions that require complex configuration that could not be handled by GUI, this option should be set to false.
Available vales:
- 'all',
- 'unix',
- 'windows'
- 'false'
-->
<show-in-gui>all</show-in-gui>
<!-- Version of the extension -->
<version>1.0</version>
<!--
Field describing which file should be started to create hosting description.
If not specified, migrator will try to guess:
- For Linux it will try "create-hosting-description" and "create-hosting-description.sh"
- For Windows it will try "create-hosting-description.exe" and "create-hosting-description.bat"
- For all OSes it will try "create-hosting-description.py". In that case, before script execution, migrator will deploy migrator SDK Python.
-->
<entry-point>mypanel.py</entry-point>
<!--
How entry point should be executed.
Available values:
- 'executable' (run as usual executable on the target OS),
- 'migrator-python' (deploy migrator SDK Python and run script with it).
If not specified, migrator will try to guess by entry point.
-->
<execution>migrator-python</execution>
<!-- Hosting description file name. -->
<hosting-description>hosting-description.yaml</hosting-description>
<!--
Hosting description file format.
Available vales:
- 'yaml',
- 'json',
- 'xml'
If not specified, migrator will try to guess by hosting description file name.
-->
<hosting-description-format>yaml</hosting-description-format>
</migrator-extension>

View File

@@ -1,502 +0,0 @@
[GLOBAL]
# This section defines global settings and lists the source servers.
# [mandatory, non-modifiable] source-type
# Source servers product type.
# The other parameters in this configuration template are listed for this particular type, expand. Rather than changing the source-type here, browse the provided configuration templates and pick one that best suits your source type.
source-type: expand
# [mandatory] sources
# Comma-separated list of the sections describing source Plesk servers connected to Expand.
# An arbitrary number of Plesk for Unix servers can be listed here.
# Order is important: Plesk server whose section is listed earlier in this list
# will have priority during conflict resolution.
sources: pfu1, pfu2
# [optional] external-db-servers
# Comma-separated list of the sections describing external source database servers.
# It is required to specify external database servers for remote PostgreSQL - otherwise databases will not be copied.
# external-db-servers: pgsql1
# [optional] centralized-mail-servers
# Comma-separated list of the sections describing centralized mail servers
# assigned to the listed source Plesk servers. If the source Plesk servers listed
# in 'sources' setting are using a centralized mail server, you must list
# it here. If not specified, migration tool will not transfer the mailboxes and
# other settings located on the centralized mail servers.
# centralized-mail-servers: cm1
# [optional] centralized-dns-servers
# Comma-separated list of the sections describing centralized DNS servers assigned to the listed source Plesk servers.
# If not specified, the DNS forwarding will not be set up on the centralized DNS servers.
# centralized-dns-servers: cd1
# [optional] session-dir
# A directory for migration tool's temporary files.
# If not specified, temporary files will be put into 'migration-session'.
# session-dir: migration-session
# [optional] zones-ttl
# The time in seconds, which migration tool sets as the SOA minimum TTL and refresh interval on a new DNS server.
# If not specified, default value is assumed: 120
# zones-ttl: 120
# [optional] external-dns-server
# An IP v4 address of an external DNS server that allows recursive DNS queries.
# Migration tool uses the specified address to test whether general Internet users can obtain the correct DNS records for the transferred domains.
# If nothing is specified, migration tool will use Google DNS server (8.8.8.8).
# If 'none' is specified, migration tool will skip this test.
# external-dns-server: 8.8.8.8
# [optional] mail-messages-delta-limit
# The post-migration mail checks compare the number of messages in the source and the target mailboxes.
# If the number of messages differs more than it is specified in "mail-messages-delta-limit", it is considered an error.
# If not specified, default value is assumed: 10
# mail-messages-delta-limit: 10
# [optional] website-availability-check-timeout
# Timeout on site response in seconds. When check the availability of site, limit response time.
# If not specified, default value is assumed: 30
# website-availability-check-timeout: 30
# [optional] website-availability-depth
# Maximum depth of links to check when testing web site availability after migration.
# For example depth 2 means to check main page and all child pages, depth 3 means to check
# main page, child pages of main page and child pages of child pages.
# If not specified, default value is assumed: 2. Increasing the value will increase time
# to perform post-migration checks, but will improve coverage of tested web pages.
# website-availability-depth: 2
# [optional] website-availability-group-directories
# Whether to group files with the same directory and file extension when testing web site
# availability after migration. If enabled, and main page contains 2 links '/subdir/a.php' and
# '/subdir/b.php', only one of them will be checked. Still if files are in different directories
# (e.g. '/subdir1/a.php' and '/subdir2/b.php') or have different extension
# (e.g. '/subdir/a.php' and '/subdir/b.aspx'), both of them will be checked.
# If not specified, default value is false. Enabling that option will speed up checks, but
# decrease coverage of tested web pages.
# website-availability-group-directories: false
# [optional] log-message-context-length
# When logging a multiline output (API request, response), show only top N
# and last N lines. Default value is 0, which means to display full API requests.
# log-message-context-length: 10
# [optional] event-scripts-dir
# Directory with scripts/executables that should be launched on migration events
# Default is $VAR_DIR/events, where VAR_DIR is /usr/local/psa/var/modules/panel-migrator/ for Unix
# event-scripts-dir:
# [optional] use-separate-log
# Write migrator logs to a session directory, not to global logs directory.
# By default is true.
# use-separate-log: true
# [optional] use-binary-log
# Write binary migrator logs, which are necessary to display logs in GUI.
# By default is true.
# use-binary-log: true
# [optional] adjust-applications
# Whether to fix configuration files of several commonly used web applications.
# The fix could include database connection changes, path fixes, and so on.
# By default this option is enabled. You could disable it if it breaks migration of some
# application, or if you need better speed of migration.
# adjust-applications: true
# [optional] skip-actions
# List of actions which should not be executed during migration.
# Be careful when setting this option - other actions may rely on results of skipped actions. So, skipping
# an action could lead to broken migration.
# List format: action identifiers separated by ",".
# If you want to skip action for specific subscription only, specify the subscription after action identifier
# separated by ":".
# Example value: convert-dns, fetch-source, copy-mail-content:example.com, copy-web-files:example.com
# In that case migrator will not execute "convert-dns" and "fetch-source" actions for all subscriptions
# and will not execute "copy-mail-content" and "copy-web-files" for subscription "example.com"
# (still content will be copied for all the other migrated subscriptions).
# By default no actions are skipped.
# To list all actions executed by migrator (with their identifiers and text descriptions),
# prepare configuration file (config.ini) and run "plesk-migrator print-workflow config.ini".
# skip-actions:
# [optional] restore-hosting-settings-poll-limit
# When restoring hosting settings (addon domains, mailboxes, PHP settings, etc) of subscriptions,
# a special restore hosting settings task is started asynchroniously. Migrator polls status of
# the task periodically and check whether it finished.
# This options specifies maximum number of attempts to poll the task before we consider the task hanged.
# Additionally see "restore-hosting-settings-poll-interval" option.
# Total timeout after which we consider that restore hosting task hanged is
# "restore-hosting-settings-poll-limit" multiplied by "restore-hosting-settings-poll-interval".
# restore-hosting-settings-poll-limit: 7200
# [optional] restore-hosting-settings-poll-interval
# When restoring hosting settings (addon domains, mailboxes, PHP settings, etc) of subscriptions,
# a special restore hosting settings task is started asynchroniously. Migrator polls status of
# the task periodically and check whether it finished
# This options specifies interval between poll attempts (in seconds). Less inteval gives more instant detection
# that task has finished, but a bit more load on CPU/disk.
# Additionally see "restore-hosting-settings-poll-limit" option.
# Total timeout after which we consider that restore hosting task hanged is
# "restore-hosting-settings-poll-limit" multiplied by "restore-hosting-settings-poll-interval".
# restore-hosting-settings-poll-interval: 1
# [optional] rsync-additional-args
# Additional arguments which will be passed to "rsync" utility when it transfers files
# from the source server.
# For example, here you could enable compression with "rsync-additional-args: -z"
# to optimize file transfer time.
# rsync-additional-args:
[plesk]
# This section defines target panel settings.
# [mandatory] ip
# An IPv4 address of the target Plesk server.
ip:
# [mandatory] os
# Server's operating system type, 'unix' or 'windows'.
os: unix
# [optional] panel-username
# Panel administrator's login. If not specified, 'admin' is used.
# panel-username: admin
# [optional] panel-password
# Panel administrator password. If not specified, it is automatically detected.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]PANEL_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
# panel-password: setup
# [optional] panel-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# panel-password-type: plain
# [optional] session-dir
# A directory for temporary files on Plesk target server.
# Option makes sense only if you run Plesk Migrator on another server than target Plesk.
# If you run Plesk Migrator on the same server as target Plesk, all temporary files are placed
# to session directory according to [GLOBAL] section.
# If not specified, temporary files will be put into '/root/plesk_migrator'
# session-dir: /root/plesk_migrator
# [optional] is-local
# Whether migration tools are working on the same server as target Plesk.
# Default is true.
# is-local: true
# [optional] apache-restart-interval
# Minimum time interval, in seconds, between Apache restarts during a
# migration. If this interval is short, Apache will restart too often. This
# will cause long downtimes on Plesk target server. If this interval is long,
# existing users of Plesk target server will have to wait longer for their
# changes to be applied. To skip changing Apache restart interval set value to
# 'none'. If not specified, migration tool will skip changing the Apache
# restart interval.
# apache-restart-interval: none
[expand]
# This section defines the settings of Expand control panel server.
# [mandatory] ip
# An IP v4 address of the Expand control panel server.
# It does not matter whether this IP address is external or internal, as long as migration tool can connect to the server at this address.
ip:
# [mandatory] panel-username
# Expand administrator user name.
panel-username: root
# [mandatory] panel-password
# Expand administrator password.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]PANEL_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
panel-password:
# [optional] panel-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# panel-password-type: plain
# [optional] ssh-username
# User name of the privileged system user on Expand control panel server. If not specified, 'root' is used.
# ssh-username: root
# [optional] ssh-auth-type
# SSH authentication type.
# There are two authentication types supported: 'password' or 'key'. Default is 'password'.
# ssh-auth-type: password
# [optional] ssh-password
# Password of the privileged system user on Expand control panel server.
# You must specify it, if you select SSH authentication type password.
# Note that the hash mark in password is treated as a regular symbol.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]SSH_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
ssh-password:
# [optional] ssh-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# ssh-password-type: plain
# [optional] ssh-key
# Path to SSH private key file. You can specify it if you select SSH
# authentication type 'key'. If not specified, "id_rsa" or "id_dsa" keys from
# the directory '~/.ssh' are used.
# ssh-key: /root/.ssh/id_rsa
[pfu1]
# This section defines settings of source Plesk server 'pfu1'.
# [mandatory] ip
# An IP v4 address of this Plesk server.
ip:
# [mandatory] os
# Server's operating system type, 'unix' or 'windows'. Defines which other parameters are required in this section.
os: unix
# [optional] panel-username
# Panel administrator user name. If not specified, 'admin' is used.
# panel-username: admin
# [optional] panel-password
# Panel administrator password. If not specified, it is automatically detected.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]PANEL_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
# panel-password:
# [optional] panel-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# panel-password-type: plain
# [optional] ssh-username
# User name of the privileged system user on this Plesk server. If not specified, 'root' is used.
# ssh-username: root
# [optional] ssh-auth-type
# SSH authentication type.
# There are two authentication types supported: 'password' or 'key'. Default is 'password'.
# ssh-auth-type: password
# [optional] ssh-password
# Password of the privileged system user on this Plesk server.
# You must specify it, if you select SSH authentication type password.
# Note that the hash mark in password is treated as a regular symbol.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]SSH_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
ssh-password:
# [optional] ssh-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# ssh-password-type: plain
# [optional] ssh-key
# Path to SSH private key file. You can specify it if you select SSH
# authentication type 'key'. If not specified, "id_rsa" or "id_dsa" keys from
# the directory '~/.ssh' are used.
# ssh-key: /root/.ssh/id_rsa
# [optional] session-dir
# A directory for temporary files.
# If not specified, temporary files are put into /root/plesk_migrator.
# session-dir: /root/plesk_migrator
[pfu2]
# This section defines settings of source Plesk server 'pfu2'.
# [mandatory] ip
# An IP v4 address of this Plesk server.
ip:
# [mandatory] os
# Server's operating system type, 'unix' or 'windows'. Defines which other parameters are required in this section.
os: unix
# [optional] panel-username
# Panel administrator user name. If not specified, 'admin' is used.
# panel-username: admin
# [optional] panel-password
# Panel administrator password. If not specified, it is automatically detected.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]PANEL_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
# panel-password:
# [optional] panel-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# panel-password-type: plain
# [optional] ssh-username
# User name of the privileged system user on this Plesk server. If not specified, 'root' is used.
# ssh-username: root
# [optional] ssh-auth-type
# SSH authentication type.
# There are two authentication types supported: 'password' or 'key'. Default is 'password'.
# ssh-auth-type: password
# [optional] ssh-password
# Password of the privileged system user on this Plesk server.
# You must specify it, if you select SSH authentication type password.
# Note that the hash mark in password is treated as a regular symbol.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]SSH_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
ssh-password:
# [optional] ssh-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# ssh-password-type: plain
# [optional] ssh-key
# Path to SSH private key file. You can specify it if you select SSH
# authentication type 'key'. If not specified, "id_rsa" or "id_dsa" keys from
# the directory '~/.ssh' are used.
# ssh-key: /root/.ssh/id_rsa
# [optional] session-dir
# A directory for temporary files.
# If not specified, temporary files are put into /root/plesk_migrator.
# session-dir: /root/plesk_migrator
[pgsql1]
# This optional section defines settings of external PostgreSQL database server 'pgsql1'.
# Fill this section's settings and list it in the 'external-db-servers'
# setting of GLOBAL section to get the databases copied from this server.
# Remove this section otherwise.
# [mandatory] host
# The address of this database server, exactly as displayed in Plesk (usually it equals to database server's IP address).
host:
# [mandatory] type
# Type of the database server, the only allowed value is 'postgresql'
type: postgresql
# [mandatory] ip
# An IP v4 address of this database server.
ip:
# [optional] ssh-username
# User name of the privileged system user on this database server. If not specified, 'root' is used.
# ssh-username: root
# [optional] ssh-auth-type
# SSH authentication type.
# There are two authentication types supported: 'password' or 'key'. Default is 'password'.
# ssh-auth-type: password
# [optional] ssh-password
# Password of the privileged system user on this database server.
# You must specify it, if you select SSH authentication type password.
# Note that the hash mark in password is treated as a regular symbol.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]SSH_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
ssh-password:
# [optional] ssh-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# ssh-password-type: plain
# [optional] ssh-key
# Path to SSH private key file. You can specify it if you select SSH
# authentication type 'key'. If not specified, "id_rsa" or "id_dsa" keys from
# the directory '~/.ssh' are used.
# ssh-key: /root/.ssh/id_rsa
[cm1]
# This optional section defines settings of centralized mail server 'cm1'.
# Fill this section's settings and list it in the 'centralized-mail-servers' setting of GLOBAL section
# to get the mail settings and content transferred from this server.
# Remove this section otherwise.
# [mandatory] ip
# An IP v4 address of this Plesk server.
ip:
# [mandatory] os
# Server's operating system type, 'unix' or 'windows'. Defines which other parameters are required in this section.
os: unix
# [optional] panel-username
# Panel administrator user name. If not specified, 'admin' is used.
# panel-username: admin
# [optional] panel-password
# Panel administrator password. If not specified, it is automatically detected.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]PANEL_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
# panel-password:
# [optional] panel-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# panel-password-type: plain
# [optional] ssh-username
# User name of the privileged system user on this Plesk server. If not specified, 'root' is used.
# ssh-username: root
# [optional] ssh-auth-type
# SSH authentication type.
# There are two authentication types supported: 'password' or 'key'. Default is 'password'.
# ssh-auth-type: password
# [optional] ssh-password
# Password of the privileged system user on this Plesk server.
# You must specify it, if you select SSH authentication type password.
# Note that the hash mark in password is treated as a regular symbol.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]SSH_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
ssh-password:
# [optional] ssh-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# ssh-password-type: plain
# [optional] ssh-key
# Path to SSH private key file. You can specify it if you select SSH
# authentication type 'key'. If not specified, "id_rsa" or "id_dsa" keys from
# the directory '~/.ssh' are used.
# ssh-key: /root/.ssh/id_rsa
# [optional] session-dir
# A directory for temporary files.
# If not specified, temporary files are put into /root/plesk_migrator.
# session-dir: /root/plesk_migrator
[cd1]
# This optional section defines settings of centralized DNS server 'cd1'.
# Fill this section's settings and list it in the 'centralized-dns-servers' setting of GLOBAL section to get the DNS forwarding set up on this server.
# Remove this section otherwise.
# [mandatory] ip
# An IP v4 address of this centralized DNS server.
ip:
# [optional] ssh-username
# User name of the privileged system user on this centralized DNS server. If not specified, 'root' is used.
# ssh-username: root
# [optional] ssh-auth-type
# SSH authentication type.
# There are two authentication types supported: 'password' or 'key'. Default is 'password'.
# ssh-auth-type: password
# [optional] ssh-password
# Password of the privileged system user on this centralized DNS server.
# You must specify it, if you select SSH authentication type password.
# Note that the hash mark in password is treated as a regular symbol.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]SSH_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
ssh-password:
# [optional] ssh-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# ssh-password-type: plain
# [optional] ssh-key
# Path to SSH private key file. You can specify it if you select SSH
# authentication type 'key'. If not specified, "id_rsa" or "id_dsa" keys from
# the directory '~/.ssh' are used.
# ssh-key: /root/.ssh/id_rsa

View File

@@ -1,580 +0,0 @@
[GLOBAL]
# This section defines global settings and lists the source servers.
# [mandatory, non-modifiable] source-type
# Source servers product type.
# The other parameters in this configuration template are listed for this
# particular type, expand. Rather than changing the source-type here, browse the
# provided configuration templates and pick one that best suits your source type.
source-type: expand
# [mandatory] sources
# Comma-separated list of the sections describing source Plesk servers connected to Expand.
# An arbitrary number of Plesk for Windows servers can be listed here.
# Order is important: Plesk server whose section is listed earlier in this list
# will have priority during conflict resolution.
sources: pfw1, pfw2
# [optional] external-db-servers
# Comma-separated list of the sections describing external source database servers.
# It is highly recommended to specify external database servers for remote MSSQL - otherwise there could be issues
# when copying database content.
# external-db-servers: mssql1
# [optional] centralized-mail-servers
# Comma-separated list of the sections describing centralized mail servers assigned to the listed source Plesk servers.
# If the source Plesk servers listed in 'sources' setting are using a centralized mail server, you must list it here.
# If not specified, migration tool will not transfer the mailboxes and other settings located on the centralized mail servers.
# centralized-mail-servers: cm1
# [optional] centralized-dns-servers
# Comma-separated list of the sections describing centralized DNS servers assigned to the listed source Plesk servers.
# If not specified, the DNS forwarding will not be set up on the centralized DNS servers.
# centralized-dns-servers: cd1
# [optional] session-dir
# A directory for migration tool's temporary files.
# If not specified, temporary files will be put into 'migration-session'.
# session-dir: migration-session
# [optional] zones-ttl
# The time in seconds, which migration tool sets as the SOA minimum TTL and refresh interval on a new DNS server.
# If not specified, default value is assumed: 120
# zones-ttl: 120
# [optional] external-dns-server
# An IP v4 address of an external DNS server that allows recursive DNS queries.
# Migration tool uses the specified address to test whether general Internet users can obtain the correct DNS records for the transferred domains.
# If nothing is specified, migration tool will use Google DNS server (8.8.8.8).
# If 'none' is specified, migration tool will skip this test.
# external-dns-server: 8.8.8.8
# [optional] mail-messages-delta-limit
# The post-migration mail checks compare the number of messages in the source and the target mailboxes.
# If the number of messages differs more than it is specified in "mail-messages-delta-limit", it is considered an error.
# If not specified, default value is assumed: 10
# mail-messages-delta-limit: 10
# [optional] website-availability-check-timeout
# Timeout on site response in seconds. When check the availability of site, limit response time.
# If not specified, default value is assumed: 30
# website-availability-check-timeout: 30
# [optional] website-availability-depth
# Maximum depth of links to check when testing web site availability after migration.
# For example depth 2 means to check main page and all child pages, depth 3 means to check
# main page, child pages of main page and child pages of child pages.
# If not specified, default value is assumed: 2. Increasing the value will increase time
# to perform post-migration checks, but will improve coverage of tested web pages.
# website-availability-depth: 2
# [optional] website-availability-group-directories
# Whether to group files with the same directory and file extension when testing web site
# availability after migration. If enabled, and main page contains 2 links '/subdir/a.php' and
# '/subdir/b.php', only one of them will be checked. Still if files are in different directories
# (e.g. '/subdir1/a.php' and '/subdir2/b.php') or have different extension
# (e.g. '/subdir/a.php' and '/subdir/b.aspx'), both of them will be checked.
# If not specified, default value is false. Enabling that option will speed up checks, but
# decrease coverage of tested web pages.
# website-availability-group-directories: false
# [optional] log-message-context-length
# When logging a multiline output (API request, response), show only top N
# and last N lines. Default value is 0, which means to display full API requests.
# log-message-context-length: 10
# [optional] copy-mssql-content
# Select way to copy MSSQL content: native MSSQL dumps, text dumps or automatic selection (default).
# Possible values: '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
# Write migrator logs to a session directory, not to global logs directory.
# By default is true.
# use-separate-log: true
# [optional] use-binary-log
# Write binary migrator logs, which are necessary to display logs in GUI.
# By default is true.
# use-binary-log: true
# [optional] adjust-applications
# Whether to fix configuration files of several commonly used web applications.
# The fix could include database connection changes, path fixes, and so on.
# By default this option is enabled. You could disable it if it breaks migration of some
# application, or if you need better speed of migration.
# adjust-applications: true
# [optional] skip-actions
# List of actions which should not be executed during migration.
# Be careful when setting this option - other actions may rely on results of skipped actions. So, skipping
# an action could lead to broken migration.
# List format: action identifiers separated by ",".
# If you want to skip action for specific subscription only, specify the subscription after action identifier
# separated by ":".
# Example value: convert-dns, fetch-source, copy-mail-content:example.com, copy-web-files:example.com
# In that case migrator will not execute "convert-dns" and "fetch-source" actions for all subscriptions
# and will not execute "copy-mail-content" and "copy-web-files" for subscription "example.com"
# (still content will be copied for all the other migrated subscriptions).
# By default no actions are skipped.
# skip-actions:
# [optional] restore-hosting-settings-poll-limit
# When restoring hosting settings (addon domains, mailboxes, PHP settings, etc) of subscriptions,
# a special restore hosting settings task is started asynchroniously. Migrator polls status of
# the task periodically and check whether it finished.
# This options specifies maximum number of attempts to poll the task before we consider the task hanged.
# Additionally see "restore-hosting-settings-poll-interval" option.
# Total timeout after which we consider that restore hosting task hanged is
# "restore-hosting-settings-poll-limit" multiplied by "restore-hosting-settings-poll-interval".
# restore-hosting-settings-poll-limit: 7200
# [optional] restore-hosting-settings-poll-interval
# When restoring hosting settings (addon domains, mailboxes, PHP settings, etc) of subscriptions,
# a special restore hosting settings task is started asynchroniously. Migrator polls status of
# the task periodically and check whether it finished
# This options specifies interval between poll attempts (in seconds). Less inteval gives more instant detection
# that task has finished, but a bit more load on CPU/disk.
# Additionally see "restore-hosting-settings-poll-limit" option.
# Total timeout after which we consider that restore hosting task hanged is
# "restore-hosting-settings-poll-limit" multiplied by "restore-hosting-settings-poll-interval".
# restore-hosting-settings-poll-interval: 1
# [optional] rsync-additional-args
# Additional arguments which will be passed to "rsync" utility when it transfers files
# from the source server.
# For example, here you could enable compression with "rsync-additional-args: -z"
# to optimize file transfer time.
# rsync-additional-args:
[plesk]
# This section defines target panel settings.
# [mandatory] ip
# An IPv4 address of the target Plesk server.
ip:
# [mandatory] os
# Server's operating system type, 'unix' or 'windows'.
os: windows
# [optional] panel-username
# Panel administrator's login. If not specified, 'admin' is used.
# panel-username: admin
# [optional] panel-password
# Panel administrator password. If not specified, it is automatically detected.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]PANEL_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
# panel-password: setup
# [optional] panel-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# panel-password-type: plain
# [optional] session-dir
# A directory for temporary files on Plesk target server.
# Option makes sense only if you run Plesk Migrator on another server than target Plesk.
# If you run Plesk Migrator on the same server as target Plesk, all temporary files are placed
# to session directory according to [GLOBAL] section.
# If not specified, temporary files will be put into 'C:\plesk_migrator'
# session-dir: C:\plesk_migrator
# [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
# Whether migration tools are working on the same server as target Plesk.
# Default is true.
# is-local: true
[expand]
# This section defines the settings of Expand control panel server.
# [mandatory] ip
# An IP v4 address of the Expand control panel server.
# It does not matter whether this IP address is external or internal, as long as migration tool can connect to the server at this address.
ip:
# [mandatory] panel-username
# Expand administrator user name.
panel-username: root
# [mandatory] panel-password
# Expand administrator password.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]PANEL_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
panel-password:
# [optional] panel-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# panel-password-type: plain
# [optional] ssh-username
# User name of the privileged system user on Expand control panel server. If not specified, 'root' is used.
# ssh-username: root
# [optional] ssh-auth-type
# SSH authentication type.
# There are two authentication types supported: 'password' or 'key'. Default is 'password'.
# ssh-auth-type: password
# [optional] ssh-password
# Password of the privileged system user on Expand control panel server.
# You must specify it, if you select SSH authentication type password.
# Note that the hash mark in password is treated as a regular symbol.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]SSH_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
ssh-password:
# [optional] ssh-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# ssh-password-type: plain
# [optional] ssh-key
# Path to SSH private key file. You can specify it if you select SSH
# authentication type 'key'. If not specified, "id_rsa" or "id_dsa" keys from
# the directory '~/.ssh' are used.
# ssh-key: /root/.ssh/id_rsa
[pfw1]
# This section defines settings of source Plesk server 'pfw1'.
# [mandatory] ip
# An IP v4 address of this Plesk server.
ip:
# [mandatory] os
# Server's operating system type, 'unix' or 'windows'. Defines which other parameters are required in this section.
os: windows
# [optional] panel-username
# Panel administrator user name. If not specified, 'admin' is used.
# panel-username: admin
# [optional] panel-password
# Panel administrator password. If not specified, it is automatically detected.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]PANEL_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
# panel-password:
# [optional] panel-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# panel-password-type: plain
# [optional] windows-username
# User name of the privileged system user on this Plesk server. Default is 'Administrator'.
# windows-username: Administrator
# [mandatory] windows-password
# Password of the privileged system user on this Plesk server.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]WINDOWS_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
windows-password:
# [optional] windows-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# windows-password-type: plain
# [optional] session-dir
# A directory for temporary files.
# 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] mail-source-log-enabled
# Whether additional logging is enabled for MailMigrator.exe utility running on the source server
# Corresponding log will be put to <session-dir>/mail/<domain-name>/<mail-name>/mail-backup.log
# mail-source-log-enabled: false
# [optional] mail-target-log-enabled
# Whether additional logging is enabled for MailMigrator.exe utility running on the target server
# Corresponding logs will be put to:
# <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
# Override mail provider (mail server type) used by MailMigrator.exe utility running on the source server.
# Examples of possible values: "mailenable", "smartermail", "imap", and so on.
# For the full list of possible values, refer to "MailMigrator.exe help" output.
# mail-source-provider:
# [optional] mail-target-provider
# Override mail provider (mail server type) used by MailMigrator.exe utility running on the target server.
# Examples of possible values: "mailenable", "smartermail", "imap", and so on.
# For the full list of possible values, refer to "MailMigrator.exe help" output.
# mail-target-provider:
# [optional] mail-source-additional-options
# Additional command line options to pass to MailMigrator.exe utility running on the source server.
# Example of value (to specify IMAP port): --port=123
# mail-source-additional-options:
# [optional] mail-target-additional-options
# Additional command line options to pass to MailMigrator.exe utility running on the target server.
# Example of value (to specify IMAP port): --port=123
# mail-target-additional-options:
[pfw2]
# This section defines settings of source Plesk server 'pfw2'.
# [mandatory] ip
# An IP v4 address of this Plesk server.
ip:
# [mandatory] os
# Server's operating system type, 'unix' or 'windows'. Defines which other parameters are required in this section.
os: windows
# [optional] panel-username
# Panel administrator user name. If not specified, 'admin' is used.
# panel-username: admin
# [optional] panel-password
# Panel administrator password. If not specified, it is automatically detected.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]PANEL_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
# panel-password:
# [optional] panel-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# panel-password-type: plain
# [optional] windows-username
# User name of the privileged system user on this Plesk server. Default is 'Administrator'.
# windows-username: Administrator
# [mandatory] windows-password
# Password of the privileged system user on this Plesk server.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]WINDOWS_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
windows-password:
# [optional] windows-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# windows-password-type: plain
# [optional] session-dir
# A directory for temporary files.
# 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] mail-source-log-enabled
# Whether additional logging is enabled for MailMigrator.exe utility running on the source server
# Corresponding log will be put to <session-dir>/mail/<domain-name>/<mail-name>/mail-backup.log
# mail-source-log-enabled: false
# [optional] mail-target-log-enabled
# Whether additional logging is enabled for MailMigrator.exe utility running on the target server
# Corresponding logs will be put to:
# <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
# Override mail provider (mail server type) used by MailMigrator.exe utility running on the source server.
# Examples of possible values: "mailenable", "smartermail", "imap", and so on.
# For the full list of possible values, refer to "MailMigrator.exe help" output.
# mail-source-provider:
# [optional] mail-target-provider
# Override mail provider (mail server type) used by MailMigrator.exe utility running on the target server.
# Examples of possible values: "mailenable", "smartermail", "imap", and so on.
# For the full list of possible values, refer to "MailMigrator.exe help" output.
# mail-target-provider:
# [optional] mail-source-additional-options
# Additional command line options to pass to MailMigrator.exe utility running on the source server.
# Example of value (to specify IMAP port): --port=123
# mail-source-additional-options:
# [optional] mail-target-additional-options
# Additional command line options to pass to MailMigrator.exe utility running on the target server.
# Example of value (to specify IMAP port): --port=123
# mail-target-additional-options:
[cm1]
# This optional section defines settings of centralized mail server 'cm1'.
# Fill this section's settings and list it in the 'centralized-mail-servers' setting of GLOBAL section
# to get the mail settings and content transferred from this server.
# Remove this section otherwise.
# [mandatory] ip
# An IP v4 address of this centralized mail server.
ip:
# [mandatory] os
# Server's operating system type, 'unix' or 'windows'. Defines which other parameters are required in this section.
os: windows
# [optional] panel-username
# Panel administrator user name. If not specified, 'admin' is used.
# panel-username: admin
# [optional] panel-password
# Panel administrator password. If not specified, it is automatically detected.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]PANEL_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
# panel-password:
# [optional] panel-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# panel-password-type: plain
# [optional] windows-username
# User name of the privileged system user on this centralized mail server. Default is 'Administrator'.
# windows-username: Administrator
# [mandatory] windows-password
# Password of the privileged system user on this centralized mail server.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]WINDOWS_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
windows-password:
# [optional] windows-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# windows-password-type: plain
# [optional] mail-source-log-enabled
# Whether additional logging is enabled for MailMigrator.exe utility running on the source server
# Corresponding log will be put to <session-dir>/mail/<domain-name>/<mail-name>/mail-backup.log
# mail-source-log-enabled: false
# [optional] mail-target-log-enabled
# Whether additional logging is enabled for MailMigrator.exe utility running on the target server
# Corresponding logs will be put to:
# <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
# Override mail provider (mail server type) used by MailMigrator.exe utility running on the source server.
# Examples of possible values: "mailenable", "smartermail", "imap", and so on.
# For the full list of possible values, refer to "MailMigrator.exe help" output.
# mail-source-provider:
# [optional] mail-target-provider
# Override mail provider (mail server type) used by MailMigrator.exe utility running on the target server.
# Examples of possible values: "mailenable", "smartermail", "imap", and so on.
# For the full list of possible values, refer to "MailMigrator.exe help" output.
# mail-target-provider:
# [optional] mail-source-additional-options
# Additional command line options to pass to MailMigrator.exe utility running on the source server.
# Example of value (to specify IMAP port): --port=123
# mail-source-additional-options:
# [optional] mail-target-additional-options
# Additional command line options to pass to MailMigrator.exe utility running on the target server.
# Example of value (to specify IMAP port): --port=123
# mail-target-additional-options:
[cd1]
# This optional section defines settings of centralized DNS server 'cd1'.
# Fill this section's settings and list it in the 'centralized-dns-servers' setting of GLOBAL section to get the DNS forwarding set up on this server.
# Remove this section otherwise.
# [mandatory] ip
# An IP v4 address of this centralized DNS server.
ip:
# [optional] ssh-username
# User name of the privileged system user on this centralized DNS server. If not specified, 'root' is used.
# ssh-username: root
# [optional] ssh-auth-type
# SSH authentication type.
# There are two authentication types supported: 'password' or 'key'. Default is 'password'.
# ssh-auth-type: password
# [optional] ssh-password
# Password of the privileged system user on this centralized DNS server.
# You must specify it, if you select SSH authentication type password.
# Note that the hash mark in password is treated as a regular symbol.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]SSH_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
ssh-password:
# [optional] ssh-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# ssh-password-type: plain
# [optional] ssh-key
# Path to SSH private key file. You can specify it if you select SSH
# authentication type 'key'. If not specified, "id_rsa" or "id_dsa" keys from
# the directory '~/.ssh' are used.
# ssh-key: /root/.ssh/id_rsa
[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
# The host of this database server as displayed in the panel, with mandatory instance name appended.
# For MSSQL it usually consists of IP address and instance name, for example:
# 192.168.1.1\MSSQLSERVER2008
host:
# [mandatory] type
# Type of the database server, the only allowed value is 'mssql'
type: mssql
# [mandatory] ip
# An IP v4 address of this database server.
ip:
# [optional] windows-username
# User name of the privileged system user on this centralized mail server. Default is 'Administrator'.
# windows-username: Administrator
# [mandatory] windows-password
# Password of the privileged system user on this database server.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]WINDOWS_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
windows-password:
# [optional] windows-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# windows-password-type: plain
[target-remote-smarter-mail]
# This optional section defines settings of target remote SmarterMail server
# [optional] ip
# An IPv4 address of the target remote SmarterMail server used for communications with it.
# Detected automatically if not specified.
# ip:
# [optional] windows-username
# User name of the privileged system user on this Plesk server. Default is 'Administrator'.
# windows-username: Administrator
# [optional] windows-password
# Password of the privileged system user on this server.
# The more secure way to pass a password is using the environment variable
# TARGET_REMOTE_SMARTER_MAIL_WINDOWS_PASSWORD. For that keep this option empty
# and set up the environment variable before the migrator run.
# windows-password:
# [optional] windows-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# windows-password-type: plain
# [optional] session-dir
# A directory for temporary files.
# If not specified, temporary files are put into C:\plesk_migrator.
# session-dir: C:\plesk_migrator

View File

@@ -1,382 +0,0 @@
[GLOBAL]
# This section defines global settings and lists the source CP servers.
# [mandatory, non-modifiable] source-type
# Source servers product type.
# The other parameters in this configuration template are listed for this particular type, plesk. Rather than changing the source-type here, browse the provided configuration templates and pick one that best suits your source type.
source-type: helm3
# [optional] sources
# Comma-separated list of the sections describing source Helm servers.
# An arbitrary number of Helm servers can be listed here.
sources: helm3, helm3-other-server
# [optional] external-db-servers
# Comma-separated list of the sections describing external source database servers.
# It is highly recommended to specify external database servers for remote MSSQL - otherwise there could be issues
# when copying database content.
# external-db-servers: mssql1
# [optional] session-dir
# A directory for migration tool's temporary files.
# If not specified, temporary files will be put into 'migration-session'.
# session-dir: migration-session
# [optional] zones-ttl
# The time in seconds, which migration tool sets as the SOA minimum TTL and refresh interval on a new DNS server.
# If not specified, default value is assumed: 120
# zones-ttl: 120
# [optional] external-dns-server
# An IP v4 address of an external DNS server that allows recursive DNS queries.
# Migration tool uses the specified address to test whether general Internet users can obtain the correct DNS records for the transferred domains.
# If nothing is specified, migration tool will use Google DNS server (8.8.8.8).
# If 'none' is specified, migration tool will skip this test.
# external-dns-server: 8.8.8.8
# [optional] mail-messages-delta-limit
# The post-migration mail checks compare the number of messages in the source and the target mailboxes.
# If the number of messages differs more than it is specified in "mail-messages-delta-limit", it is considered an error.
# If not specified, default value is assumed: 10
# mail-messages-delta-limit: 10
#
# [optional] website-availability-check-timeout
# Timeout on site response in seconds. When check the availability of site, limit response time.
# If not specified, default value is assumed: 30
# website-availability-check-timeout: 30
# [optional] website-availability-depth
# Maximum depth of links to check when testing web site availability after migration.
# For example depth 2 means to check main page and all child pages, depth 3 means to check
# main page, child pages of main page and child pages of child pages.
# If not specified, default value is assumed: 2. Increasing the value will increase time
# to perform post-migration checks, but will improve coverage of tested web pages.
# website-availability-depth: 2
# [optional] website-availability-group-directories
# Whether to group files with the same directory and file extension when testing web site
# availability after migration. If enabled, and main page contains 2 links '/subdir/a.php' and
# '/subdir/b.php', only one of them will be checked. Still if files are in different directories
# (e.g. '/subdir1/a.php' and '/subdir2/b.php') or have different extension
# (e.g. '/subdir/a.php' and '/subdir/b.aspx'), both of them will be checked.
# If not specified, default value is false. Enabling that option will speed up checks, but
# decrease coverage of tested web pages.
# website-availability-group-directories: false
# [optional] log-message-context-length
# When logging a multiline output (API request, response), show only top N
# and last N lines. Default value is 0, which means to display full API requests.
# log-message-context-length: 10
# [optional] copy-mssql-content
# Select way to copy MSSQL content: native MSSQL dumps, text dumps or automatic selection (default).
# Possible values: '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
# Write migrator logs to a session directory, not to global logs directory.
# By default is true.
# use-separate-log: true
# [optional] use-binary-log
# Write binary migrator logs, which are necessary to display logs in GUI.
# By default is true.
# use-binary-log: true
# [optional] adjust-applications
# Whether to fix configuration files of several commonly used web applications.
# The fix could include database connection changes, path fixes, and so on.
# By default this option is enabled. You could disable it if it breaks migration of some
# application, or if you need better speed of migration.
# adjust-applications: true
# [optional] skip-actions
# List of actions which should not be executed during migration.
# Be careful when setting this option - other actions may rely on results of skipped actions. So, skipping
# an action could lead to broken migration.
# List format: action identifiers separated by ",".
# If you want to skip action for specific subscription only, specify the subscription after action identifier
# separated by ":".
# Example value: convert-dns, fetch-source, copy-mail-content:example.com, copy-web-files:example.com
# In that case migrator will not execute "convert-dns" and "fetch-source" actions for all subscriptions
# and will not execute "copy-mail-content" and "copy-web-files" for subscription "example.com"
# (still content will be copied for all the other migrated subscriptions).
# By default no actions are skipped.
# To list all actions executed by migrator (with their identifiers and text descriptions),
# prepare configuration file (config.ini) and run "plesk-migrator print-workflow config.ini".
# skip-actions:
# [optional] restore-hosting-settings-poll-limit
# When restoring hosting settings (addon domains, mailboxes, PHP settings, etc) of subscriptions,
# a special restore hosting settings task is started asynchroniously. Migrator polls status of
# the task periodically and check whether it finished.
# This options specifies maximum number of attempts to poll the task before we consider the task hanged.
# Additionally see "restore-hosting-settings-poll-interval" option.
# Total timeout after which we consider that restore hosting task hanged is
# "restore-hosting-settings-poll-limit" multiplied by "restore-hosting-settings-poll-interval".
# restore-hosting-settings-poll-limit: 7200
# [optional] restore-hosting-settings-poll-interval
# When restoring hosting settings (addon domains, mailboxes, PHP settings, etc) of subscriptions,
# a special restore hosting settings task is started asynchroniously. Migrator polls status of
# the task periodically and check whether it finished
# This options specifies interval between poll attempts (in seconds). Less inteval gives more instant detection
# that task has finished, but a bit more load on CPU/disk.
# Additionally see "restore-hosting-settings-poll-limit" option.
# Total timeout after which we consider that restore hosting task hanged is
# "restore-hosting-settings-poll-limit" multiplied by "restore-hosting-settings-poll-interval".
# restore-hosting-settings-poll-interval: 1
# [optional] rsync-additional-args
# Additional arguments which will be passed to "rsync" utility when it transfers files
# from the source server.
# For example, here you could enable compression with "rsync-additional-args: -z"
# to optimize file transfer time.
# rsync-additional-args:
[plesk]
# This section defines Plesk-related settings.
# [mandatory] ip
# An IP v4 address of the Plesk node.
# It does not matter whether this IP address is external or internal, as long as migration tool can connect to Plesk node at this address.
ip:
# [mandatory] os
# Server's operating system type, 'unix' or 'windows'. Defines which other parameters are required in this section.
os: windows
# [optional] panel-username
# Plesk administrator user name. If not specified, 'admin' is used.
# panel-username: admin
# [optional] panel-password
# Plesk administrator password. If not specified, it is automatically detected.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]PANEL_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
# panel-password: setup
# [optional] panel-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# panel-password-type: plain
# [optional] session-dir
# A directory for temporary files on Plesk target server.
# Option makes sense only if you run Plesk Migrator on another server than target Plesk.
# If you run Plesk Migrator on the same server as target Plesk, all temporary files are placed
# to session directory according to [GLOBAL] section.
# If not specified, temporary files will be put into 'C:\plesk_migrator'
# session-dir: C:\plesk_migrator
# [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
# Whether migration tools are working on the same server as target Plesk.
# Default is true.
# is-local: true
[helm3]
# This section defines the settings of Helm3 control panel server.
# [mandatory] ip
# An IP v4 address of this Helm CP server.
ip:
# [optional] windows-username
# User name of the privileged system user on this Helm server. Default is 'HELM_ADMIN'.
# windows-username: HELM_ADMIN
# [mandatory] windows-password
# Password of the privileged system user on this Helm server.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]WINDOWS_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
windows-password: password
# [optional] windows-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# windows-password-type: plain
# [optional] copy-mail-content
# This parameter specifies what mail content should be copied from the server:
# 'full' to copy all mail content, 'messages' to copy only messages from the Inbox folders, and 'none' to skip copying.
# Note that if the server does not support IMAP, it is possible to copy only Inbox messages using the 'messages' option.
# If not specified, all mail content is copied.
# copy-mail-content: full
# [optional] copy-web-content
# This parameter specifies what web content should be copied from the server:
# 'full' to copy all web content, and 'none' to skip copying.
# If not specified, all web content is copied.
# copy-web-content: full
# [optional] session-dir
# A directory for temporary files. If not specified temporary files are put into C:\plesk_migrator.
# session-dir: C:\plesk_migrator
# [optional] mail-source-log-enabled
# Whether additional logging is enabled for MailMigrator.exe utility running on the source server
# Corresponding log will be put to <session-dir>/mail/<domain-name>/<mail-name>/mail-backup.log
# mail-source-log-enabled: false
# [optional] mail-target-log-enabled
# Whether additional logging is enabled for MailMigrator.exe utility running on the target server
# Corresponding logs will be put to:
# <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
# Override mail provider (mail server type) used by MailMigrator.exe utility running on the source server.
# Examples of possible values: "mailenable", "smartermail", "imap", and so on.
# For the full list of possible values, refer to "MailMigrator.exe help" output.
# mail-source-provider:
# [optional] mail-target-provider
# Override mail provider (mail server type) used by MailMigrator.exe utility running on the target server.
# Examples of possible values: "mailenable", "smartermail", "imap", and so on.
# For the full list of possible values, refer to "MailMigrator.exe help" output.
# mail-target-provider:
# [optional] mail-source-additional-options
# Additional command line options to pass to MailMigrator.exe utility running on the source server.
# Example of value (to specify IMAP port): --port=123
# mail-source-additional-options:
# [optional] mail-target-additional-options
# Additional command line options to pass to MailMigrator.exe utility running on the target server.
# Example of value (to specify IMAP port): --port=123
# mail-target-additional-options:
[helm3-other-server]
# This section defines the settings of Helm3 remote server.
# [mandatory] ip
# An IP v4 address of this Helm server.
ip:
# [optional] windows-username
# User name of the privileged system user on this Helm server.
# Specify if username is different from username on control server.
# windows-username: HELM_ADMIN
# [optional] windows-password
# Password of the privileged system user on this Helm server.
# Specify if password is different from password on control server.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]WINDOWS_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
# windows-password: password
# [optional] windows-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# windows-password-type: plain
# [optional] session-dir
# A directory for temporary files. If not specified temporary files are put into C:\plesk_migrator.
# session-dir: C:\plesk_migrator
[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
# The host of this database server as displayed in the panel, with mandatory instance name appended.
# For MSSQL it usually consists of IP address and instance name, for example:
# 192.168.1.1\MSSQLSERVER2008
host:
# [mandatory] type
# Type of the database server, the only allowed value is 'mssql'
type: mssql
# [mandatory] ip
# An IP v4 address of this database server.
ip:
# [optional] windows-username
# User name of the privileged system user on this centralized mail server. Default is 'Administrator'.
# windows-username: Administrator
# [mandatory] windows-password
# Password of the privileged system user on this database server.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]WINDOWS_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
windows-password:
# [optional] windows-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# windows-password-type: plain
# [optional] mail-source-log-enabled
# Whether additional logging is enabled for MailMigrator.exe utility running on the source server
# Corresponding log will be put to <session-dir>/mail/<domain-name>/<mail-name>/mail-backup.log
# mail-source-log-enabled: false
# [optional] mail-target-log-enabled
# Whether additional logging is enabled for MailMigrator.exe utility running on the target server
# Corresponding logs will be put to:
# <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
# Override mail provider (mail server type) used by MailMigrator.exe utility running on the source server.
# Examples of possible values: "mailenable", "smartermail", "imap", and so on.
# For the full list of possible values, refer to "MailMigrator.exe help" output.
# mail-source-provider:
# [optional] mail-target-provider
# Override mail provider (mail server type) used by MailMigrator.exe utility running on the target server.
# Examples of possible values: "mailenable", "smartermail", "imap", and so on.
# For the full list of possible values, refer to "MailMigrator.exe help" output.
# mail-target-provider:
# [optional] mail-source-additional-options
# Additional command line options to pass to MailMigrator.exe utility running on the source server.
# Example of value (to specify IMAP port): --port=123
# mail-source-additional-options:
# [optional] mail-target-additional-options
# Additional command line options to pass to MailMigrator.exe utility running on the target server.
# Example of value (to specify IMAP port): --port=123
# mail-target-additional-options:
[target-remote-smarter-mail]
# This optional section defines settings of target remote SmarterMail server
# [optional] ip
# An IPv4 address of the target remote SmarterMail server used for communications with it.
# Detected automatically if not specified.
# ip:
# [optional] windows-username
# User name of the privileged system user on this Plesk server. Default is 'Administrator'.
# windows-username: Administrator
# [optional] windows-password
# Password of the privileged system user on this server.
# The more secure way to pass a password is using the environment variable
# TARGET_REMOTE_SMARTER_MAIL_WINDOWS_PASSWORD. For that keep this option empty
# and set up the environment variable before the migrator run.
# windows-password:
# [optional] windows-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# windows-password-type: plain
# [optional] session-dir
# A directory for temporary files.
# If not specified, temporary files are put into C:\plesk_migrator.
# session-dir: C:\plesk_migrator

View File

@@ -1,11 +0,0 @@
[GLOBAL]
source-type: helm3
[plesk]
ip:
os: windows
[helm3]
ip:
windows-username: HELM_ADMIN
windows-password:

View File

@@ -1,68 +0,0 @@
[GLOBAL]
# This section defines migrator's global settings.
# [mandatory, non-modifiable] source-type
# Source servers' product type.
# This is a template of configuration file for mail migration by IMAP to Plesk.
# For other configurations, browse other provided configuration templates and pick
# one that best suits your source type.
source-type: custom
# [mandatory] sources
# A comma-separated list of the sections, that describe source hosting description files
sources: myserver
# [optional] session-dir
# A directory for migration tool's temporary files.
# If not specified, temporary files will be put into './migration-session'.
# session-dir: migration-session
# [optional] skip-actions
# List of actions which should not be executed during migration.
# Be careful when setting this option - other actions may rely on results of skipped actions. So, skipping
# an action could lead to broken migration.
# List format: action identifiers separated by ",".
# If you want to skip action for specific subscription only, specify the subscription after action identifier
# separated by ":".
# Example value: convert-dns, fetch-source, copy-mail-content:example.com, copy-web-files:example.com
# In that case migrator will not execute "convert-dns" and "fetch-source" actions for all subscriptions
# and will not execute "copy-mail-content" and "copy-web-files" for subscription "example.com"
# (still content will be copied for all the other migrated subscriptions).
# By default no actions are skipped.
# To list all actions executed by migrator (with their identifiers and text descriptions),
# prepare configuration file (config.ini) and run "plesk-migrator print-workflow config.ini".
# skip-actions:
[plesk]
# This section defines target panel settings.
# [mandatory] ip
# An IPv4 address of the target Plesk server.
ip:
# [mandatory] os
# Server's operating system type, 'unix' or 'windows'.
os: unix
[myserver]
# [mandatory] hosting-description
# Specify location of hosting description file
hosting-description: hosting-description.yaml
# [optional] description-format
# Specify format of hosting description file (json/yaml/xml). By default, hosting description
# file is treated as YAML
# description-format: yaml
# [optional] mail-target-log-enabled
# Whether additional logging is enabled for "mail-migrator" utility running on the target server for IMAP migrations
# Corresponding log will be put to:
# <session-dir>/mail/<domain-name>/<mail-name>/mail-imap-migration.log
# mail-target-log-enabled: false
# [optional] mail-target-additional-options
# Additional command line options to pass to "mail-migrator" utility running on the target server for IMAP migrations.
# Example of value (to specify IMAP port on the source server): --source-port=123
# mail-target-additional-options:

View File

@@ -1,10 +0,0 @@
[GLOBAL]
source-type: custom
sources: myserver
[plesk]
ip:
os: unix
[myserver]
hosting-description: hosting-description.yaml

View File

@@ -1,67 +0,0 @@
[GLOBAL]
# This section defines migrator's global settings.
# [mandatory, non-modifiable] source-type
# Source servers' product type.
# This is a template of configuration file for mail migration by IMAP to Plesk.
# For other configurations, browse other provided configuration templates and pick
# one that best suits your source type.
source-type: custom
# [mandatory] sources
# A comma-separated list of the sections, that describe source hosting description files
sources: myserver
# [optional] session-dir
# A directory for migration tool's temporary files.
# If not specified, temporary files will be put into './migration-session'.
# session-dir: migration-session
# [optional] skip-actions
# List of actions which should not be executed during migration.
# Be careful when setting this option - other actions may rely on results of skipped actions. So, skipping
# an action could lead to broken migration.
# List format: action identifiers separated by ",".
# If you want to skip action for specific subscription only, specify the subscription after action identifier
# separated by ":".
# Example value: convert-dns, fetch-source, copy-mail-content:example.com, copy-web-files:example.com
# In that case migrator will not execute "convert-dns" and "fetch-source" actions for all subscriptions
# and will not execute "copy-mail-content" and "copy-web-files" for subscription "example.com"
# (still content will be copied for all the other migrated subscriptions).
# By default no actions are skipped.
# To list all actions executed by migrator (with their identifiers and text descriptions),
# prepare configuration file (config.ini) and run "plesk-migrator print-workflow config.ini".
# skip-actions:
[plesk]
# This section defines target panel settings.
# [mandatory] ip
# An IPv4 address of the target Plesk server.
ip:
# [mandatory] os
# Server's operating system type, 'unix' or 'windows'.
os: windows
[myserver]
# [mandatory] hosting-description
# Specify location of hosting description file
hosting-description: hosting-description.yaml
# [optional] description-format
# Specify format of hosting description file (json/yaml/xml). By default, hosting description
# file is treated as YAML
# description-format: yaml
# [optional] mail-target-log-enabled
# Whether additional logging is enabled for MailMigrator.exe utility running on the target server
# Corresponding log will be put to:
# <session-dir>/mail/<domain-name>/<mail-name>/mail-imap-migration.log
# mail-target-log-enabled: false
# [optional] mail-target-additional-options
# Additional command line options to pass to MailMigrator.exe utility running on the target server.
# Example of value (to specify IMAP port on the source server): --source-port=123
# mail-target-additional-options:

View File

@@ -1,10 +0,0 @@
[GLOBAL]
source-type: custom
sources: myserver
[plesk]
ip:
os: windows
[myserver]
hosting-description: hosting-description.yaml

View File

@@ -1,317 +0,0 @@
[GLOBAL]
# This section defines migrator's global settings.
# [mandatory, non-modifiable] source-type
# Source servers' product type.
#
# This is a template of configuration file for migration from Plesk to Plesk Multi Server.
# For other source or target panels, browse other provided
# configuration templates and pick one that best suits your source type.
source-type: plesk
# [mandatory] sources
# A comma-separated list of the sections, that describe source Plesk
# servers. In this setting you may specify one or more Plesk for Unix servers.
#
# The order of the section names in this list is significant: Plesk server,
# which section is listed earlier, has priority in conflict resolution.
sources: pfu
# [optional] pms-service-nodes
# A comma-separated list of the sections, that describe target Plesk Multi Server nodes.
# There is no need to specify the nodes in explicit way, use it to customize SSH connection settings
# (SSH port) to the nodes.
# pms-service-nodes: pms1, pms2
# [optional] session-dir
# A directory for migration tool's temporary files.
# If not specified, temporary files will be put into './migration-session'.
# session-dir: migration-session
# [optional] zones-ttl
# The time in seconds, which migration tool sets as the SOA minimum TTL and
# refresh interval on a new DNS server.
# If not specified, default value is assumed: 120
# zones-ttl: 120
# [optional] external-dns-server
# An IPv4 address of an external DNS server that allows recursive DNS queries.
# Migration tool uses the specified address to test whether general Internet
# users can obtain the correct DNS records for the transferred domains. If
# nothing is specified, migration tool will use Google DNS server (8.8.8.8).
# If 'none' is specified, migration tool will skip this test.
# external-dns-server: 8.8.8.8
# [optional] mail-messages-delta-limit
# The post-migration mail checks compare the number of messages in the source
# and the target mailboxes. If the number of messages differs more than it is
# specified in "mail-messages-delta-limit", it is considered an error.
# If the option is not specified, default value is assumed: 10
# mail-messages-delta-limit: 10
# [optional] website-availability-check-timeout
# This is the timeout, that migrator uses, when testing web site availability
# after migration. If not specified, default value is assumed: 30
# website-availability-check-timeout: 30
# [optional] website-availability-depth
# Maximum depth of links to check when testing web site availability after migration.
# For example depth 2 means to check main page and all child pages, depth 3 means to check
# main page, child pages of main page and child pages of child pages.
# If not specified, default value is assumed: 2. Increasing the value will increase time
# to perform post-migration checks, but will improve coverage of tested web pages.
# website-availability-depth: 2
# [optional] website-availability-group-directories
# Whether to group files with the same directory and file extension when testing web site
# availability after migration. If enabled, and main page contains 2 links '/subdir/a.php' and
# '/subdir/b.php', only one of them will be checked. Still if files are in different directories
# (e.g. '/subdir1/a.php' and '/subdir2/b.php') or have different extension
# (e.g. '/subdir/a.php' and '/subdir/b.aspx'), both of them will be checked.
# If not specified, default value is false. Enabling that option will speed up checks, but
# decrease coverage of tested web pages.
# website-availability-group-directories: false
# [optional] log-message-context-length
# When logging a multiline output (API request, response), show only top N
# and last N lines. Default value is 0, which means to display full API requests.
# log-message-context-length: 10
# [optional] use-hosting-analyser
# Set this option to 'True', if you need to analyse hosting and detect optimal
# algorithm to copy content. Default value of this option is 'True'.
# use-hosting-analyser: True
# [optional] use-math-analyse
# Set this option to 'True', if you need to analyse hosting and detect optimal
# algorithm to copy content with math algorithm. Default value of this option is 'True'.
# Otherwise, the "matrix of strategies" algorithm would be used
# use-math-analyse: True
# [optional] hosting-analysis-ttl
# The time in seconds, which migration tool sets as minimum for hosting
# analysis results.
# If not specified, default value is assumed: 900
# hosting-analysis-ttl: 900
# [optional] skip-migrator-updates
# Do not check migrator repository for updates. Default value is 'False'
# skip-migrator-updates: False
# [optional] event-scripts-dir
# Directory with scripts/executables that should be launched on migration events
# Default is $VAR_DIR/events, where VAR_DIR is /usr/local/psa/var/modules/panel-migrator/ for Unix
# event-scripts-dir:
# [optional] use-separate-log
# Write migrator logs to a session directory, not to global logs directory.
# By default is true.
# use-separate-log: true
# [optional] use-binary-log
# Write binary migrator logs, which are necessary to display logs in GUI.
# By default is true.
# use-binary-log: true
# [optional] adjust-applications
# Whether to fix configuration files of several commonly used web applications.
# The fix could include database connection changes, path fixes, and so on.
# By default this option is enabled. You could disable it if it breaks migration of some
# application, or if you need better speed of migration.
# adjust-applications: true
# [optional] courier-to-dovecot-migration
# Whether to convert mail directory files when migrating mail from Courier to Dovecot.
# If option is not enabled and mail directory files are not converted, then
# POP3 mail clients could get mail messages duplicated after migration.
# By default is enabled.
# courier-to-dovecot-migration: true
# [optional] skip-actions
# List of actions which should not be executed during migration.
# Be careful when setting this option - other actions may rely on results of skipped actions. So, skipping
# an action could lead to broken migration.
# List format: action identifiers separated by ",".
# If you want to skip action for specific subscription only, specify the subscription after action identifier
# separated by ":".
# Example value: convert-dns, fetch-source, copy-mail-content:example.com, copy-web-files:example.com
# In that case migrator will not execute "convert-dns" and "fetch-source" actions for all subscriptions
# and will not execute "copy-mail-content" and "copy-web-files" for subscription "example.com"
# (still content will be copied for all the other migrated subscriptions).
# By default no actions are skipped.
# To list all actions executed by migrator (with their identifiers and text descriptions),
# prepare configuration file (config.ini) and run "plesk-migrator print-workflow config.ini".
# skip-actions:
# [optional] restore-hosting-settings-poll-limit
# When restoring hosting settings (addon domains, mailboxes, PHP settings, etc) of subscriptions,
# a special restore hosting settings task is started asynchroniously. Migrator polls status of
# the task periodically and check whether it finished.
# This options specifies maximum number of attempts to poll the task before we consider the task hanged.
# Additionally see "restore-hosting-settings-poll-interval" option.
# Total timeout after which we consider that restore hosting task hanged is
# "restore-hosting-settings-poll-limit" multiplied by "restore-hosting-settings-poll-interval".
# restore-hosting-settings-poll-limit: 7200
# [optional] restore-hosting-settings-poll-interval
# When restoring hosting settings (addon domains, mailboxes, PHP settings, etc) of subscriptions,
# a special restore hosting settings task is started asynchroniously. Migrator polls status of
# the task periodically and check whether it finished
# This options specifies interval between poll attempts (in seconds). Less inteval gives more instant detection
# that task has finished, but a bit more load on CPU/disk.
# Additionally see "restore-hosting-settings-poll-limit" option.
# Total timeout after which we consider that restore hosting task hanged is
# "restore-hosting-settings-poll-limit" multiplied by "restore-hosting-settings-poll-interval".
# restore-hosting-settings-poll-interval: 1
# [optional] rsync-additional-args
# Additional arguments which will be passed to "rsync" utility when it transfers files
# from the source server.
# For example, here you could enable compression with "rsync-additional-args: -z"
# to optimize file transfer time.
# rsync-additional-args:
[plesk]
# This section defines target panel settings.
# [mandatory] ip
# An IPv4 address of the target Plesk server.
ip:
# [mandatory] os
# Server's operating system type, 'unix' or 'windows'.
os: unix
# [optional] panel-username
# Panel administrator's login. If not specified, 'admin' is used.
# panel-username: admin
# [optional] panel-password
# Panel administrator password. If not specified, it is automatically detected.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]PANEL_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
# panel-password: setup
# [optional] panel-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# panel-password-type: plain
# [optional] plesk-port
# Port of Plesk UI/API
# plesk-port: 8443
# [optional] session-dir
# A directory for temporary files on Plesk target server.
# Option makes sense only if you run Plesk Migrator on another server than target Plesk.
# If you run Plesk Migrator on the same server as target Plesk, all temporary files are placed
# to session directory according to [GLOBAL] section.
# If not specified, temporary files will be put into '/root/plesk_migrator'
# session-dir: /root/plesk_migrator
[pfu]
# This section defines settings of source Plesk server 'pfu1'.
# [mandatory] ip
# An IP v4 address of this source Plesk server.
ip:
# [mandatory] os
# Server's operating system type, 'unix' or 'windows'.
os: unix
# [optional] panel-username
# Panel administrator user name. If not specified, 'admin' is used.
# panel-username: admin
# [mandatory] panel-password
# Panel administrator password. If not specified, it is automatically detected.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]PANEL_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
# panel-password:
# [optional] panel-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# panel-password-type: plain
# [optional] plesk-port
# Port of Plesk UI/API
# plesk-port: 8443
# [optional] ssh-username
# User name of the privileged system user on this Plesk server. If not specified, 'root' is used.
# ssh-username: root
# [optional] ssh-auth-type
# SSH authentication type.
# There are two authentication types supported: 'password' or 'key'. Default is 'password'.
# ssh-auth-type: password
# [optional] ssh-password
# Password of the privileged system user on this Plesk server.
# You must specify it, if you select SSH authentication type password.
# Note that the hash mark in password is treated as a regular symbol.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]SSH_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
ssh-password:
# [optional] ssh-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# ssh-password-type: plain
# [optional] ssh-key
# Path to SSH private key file. You can specify it if you select SSH
# authentication type 'key'. If not specified, "id_rsa" or "id_dsa" keys from
# the directory '~/.ssh' are used.
# ssh-key: /root/.ssh/id_rsa
# [optional] ssh-port
# Port number on which SSH service accepts incoming connections
# ssh-port: 22
# [optional] session-dir
# A directory for temporary files.
# If not specified, temporary files are put into /root/plesk_migrator.
# session-dir: /root/plesk_migrator
# [optional] copy-mail-content
# This parameter specifies what mail content should be copied from the server:
# 'full' to copy all mail content, and 'none' to skip copying.
# If not specified, all mail content is copied.
# copy-mail-content: full
# [optional] copy-web-content
# This parameter specifies what web content should be copied from the server:
# 'full' to copy all web content, and 'none' to skip copying.
# If not specified, all web content is copied.
# copy-web-content: full
# [optional] ssh-authorized-keys-file
# This parameter specifies location of SSH authorized keys file for root user.
# This file is necessary for setting up key auth when copying files with rsync: copy web content, deploy agent, etc.
# By default, if this parameter is not specified, migrator will put public keys to
# '~/.ssh/authorized_keys' and '~/.ssh/authorized_keys2' files. So, in default configuration
# this option should not be touched. If you have troubles setting up key auth during migration,
# check AuthorizedKeysFile option in your SSH server's configuration file (usually /etc/ssh/sshd_config).
# ssh-authorized-keys-file: ~/.ssh/authorized_keys
[pms1]
# This section defines settings of target Plesk Multi Server service node 'pms1'.
# [mandatory] ip
# An IP v4 address of this service node (as it is displayed in Plesk Multi Server GUI).
ip:
# [optional] ssh-port
# Port number on which SSH service accepts incoming connections
# ssh-port: 2222
[pms2]
# This section defines settings of target Plesk Multi Server service node 'pms2'.
# [mandatory] ip
# An IP v4 address of this service node (as it is displayed in Plesk Multi Server GUI).
ip:
# [optional] ssh-port
# Port number on which SSH service accepts incoming connections
# ssh-port: 2200

View File

@@ -1,313 +0,0 @@
[GLOBAL]
# This section defines migrator's global settings.
# [mandatory, non-modifiable] source-type
# Source servers' product type.
#
# This is a template of configuration file for migration from Plesk to Plesk.
# For other source or target panels, browse other provided
# configuration templates and pick one that best suits your source type.
source-type: plesk
# [mandatory] sources
# A comma-separated list of the sections, that describe source Plesk
# servers. In this setting you may specify one or more Plesk for Unix
# and/or Plesk for Windows servers.
#
# The order of the section names in this list is significant: Plesk server,
# which section is listed earlier, has priority in conflict resolution.
sources: pfu
# [optional] session-dir
# A directory for migration tool's temporary files.
# If not specified, temporary files will be put into './migration-session'.
# session-dir: migration-session
# [optional] zones-ttl
# The time in seconds, which migration tool sets as the SOA minimum TTL and
# refresh interval on a new DNS server.
# If not specified, default value is assumed: 120
# zones-ttl: 120
# [optional] external-dns-server
# An IPv4 address of an external DNS server that allows recursive DNS queries.
# Migration tool uses the specified address to test whether general Internet
# users can obtain the correct DNS records for the transferred domains. If
# nothing is specified, migration tool will use Google DNS server (8.8.8.8).
# If 'none' is specified, migration tool will skip this test.
# external-dns-server: 8.8.8.8
# [optional] mail-messages-delta-limit
# The post-migration mail checks compare the number of messages in the source
# and the target mailboxes. If the number of messages differs more than it is
# specified in "mail-messages-delta-limit", it is considered an error.
# If the option is not specified, default value is assumed: 10
# mail-messages-delta-limit: 10
# [optional] website-availability-check-timeout
# This is the timeout, that migrator uses, when testing web site availability
# after migration. If not specified, default value is assumed: 30
# website-availability-check-timeout: 30
# [optional] website-availability-depth
# Maximum depth of links to check when testing web site availability after migration.
# For example depth 2 means to check main page and all child pages, depth 3 means to check
# main page, child pages of main page and child pages of child pages.
# If not specified, default value is assumed: 2. Increasing the value will increase time
# to perform post-migration checks, but will improve coverage of tested web pages.
# website-availability-depth: 2
# [optional] website-availability-group-directories
# Whether to group files with the same directory and file extension when testing web site
# availability after migration. If enabled, and main page contains 2 links '/subdir/a.php' and
# '/subdir/b.php', only one of them will be checked. Still if files are in different directories
# (e.g. '/subdir1/a.php' and '/subdir2/b.php') or have different extension
# (e.g. '/subdir/a.php' and '/subdir/b.aspx'), both of them will be checked.
# If not specified, default value is false. Enabling that option will speed up checks, but
# decrease coverage of tested web pages.
# website-availability-group-directories: false
# [optional] log-message-context-length
# When logging a multiline output (API request, response), show only top N
# and last N lines. Default value is 0, which means to display full API requests.
# log-message-context-length: 10
# [optional] use-hosting-analyser
# Set this option to 'True', if you need to analyse hosting and detect optimal
# algorithm to copy content. Default value of this option is 'True'.
# use-hosting-analyser: True
# [optional] use-math-analyse
# Set this option to 'True', if you need to analyse hosting and detect optimal
# algorithm to copy content with math algorithm. Default value of this option is 'True'.
# Otherwise, the "matrix of strategies" algorithm would be used
# use-math-analyse: True
# [optional] hosting-analysis-ttl
# The time in seconds, which migration tool sets as minimum for hosting
# analysis results.
# If not specified, default value is assumed: 900
# hosting-analysis-ttl: 900
# [optional] skip-migrator-updates
# Do not check migrator repository for updates. Default value is 'False'
# skip-migrator-updates: False
# [optional] event-scripts-dir
# Directory with scripts/executables that should be launched on migration events
# Default is $VAR_DIR/events, where VAR_DIR is /usr/local/psa/var/modules/panel-migrator/ for Unix
# event-scripts-dir:
# [optional] use-separate-log
# Write migrator logs to a session directory, not to global logs directory.
# By default is true.
# use-separate-log: true
# [optional] use-binary-log
# Write binary migrator logs, which are necessary to display logs in GUI.
# By default is true.
# use-binary-log: true
# [optional] adjust-applications
# Whether to fix configuration files of several commonly used web applications.
# The fix could include database connection changes, path fixes, and so on.
# By default this option is enabled. You could disable it if it breaks migration of some
# application, or if you need better speed of migration.
# adjust-applications: true
# [optional] courier-to-dovecot-migration
# Whether to convert mail directory files when migrating mail from Courier to Dovecot.
# If option is not enabled and mail directory files are not converted, then
# POP3 mail clients could get mail messages duplicated after migration.
# By default is enabled.
# courier-to-dovecot-migration: true
# [optional] skip-actions
# List of actions which should not be executed during migration.
# Be careful when setting this option - other actions may rely on results of skipped actions. So, skipping
# an action could lead to broken migration.
# List format: action identifiers separated by ",".
# If you want to skip action for specific subscription only, specify the subscription after action identifier
# separated by ":".
# Example value: convert-dns, fetch-source, copy-mail-content:example.com, copy-web-files:example.com
# In that case migrator will not execute "convert-dns" and "fetch-source" actions for all subscriptions
# and will not execute "copy-mail-content" and "copy-web-files" for subscription "example.com"
# (still content will be copied for all the other migrated subscriptions).
# By default no actions are skipped.
# To list all actions executed by migrator (with their identifiers and text descriptions),
# prepare configuration file (config.ini) and run "plesk-migrator print-workflow config.ini".
# skip-actions:
# [optional] restore-hosting-settings-poll-limit
# When restoring hosting settings (addon domains, mailboxes, PHP settings, etc) of subscriptions,
# a special restore hosting settings task is started asynchroniously. Migrator polls status of
# the task periodically and check whether it finished.
# This options specifies maximum number of attempts to poll the task before we consider the task hanged.
# Additionally see "restore-hosting-settings-poll-interval" option.
# Total timeout after which we consider that restore hosting task hanged is
# "restore-hosting-settings-poll-limit" multiplied by "restore-hosting-settings-poll-interval".
# restore-hosting-settings-poll-limit: 7200
# [optional] restore-hosting-settings-poll-interval
# When restoring hosting settings (addon domains, mailboxes, PHP settings, etc) of subscriptions,
# a special restore hosting settings task is started asynchroniously. Migrator polls status of
# the task periodically and check whether it finished
# This options specifies interval between poll attempts (in seconds). Less inteval gives more instant detection
# that task has finished, but a bit more load on CPU/disk.
# Additionally see "restore-hosting-settings-poll-limit" option.
# Total timeout after which we consider that restore hosting task hanged is
# "restore-hosting-settings-poll-limit" multiplied by "restore-hosting-settings-poll-interval".
# restore-hosting-settings-poll-interval: 1
# [optional] rsync-additional-args
# Additional arguments which will be passed to "rsync" utility when it transfers files
# from the source server.
# For example, here you could enable compression with "rsync-additional-args: -z"
# to optimize file transfer time.
# rsync-additional-args:
[plesk]
# This section defines target panel settings.
# [mandatory] ip
# An IPv4 address of the target Plesk server.
ip:
# [mandatory] os
# Server's operating system type, 'unix' or 'windows'.
os: unix
# [optional] panel-username
# Panel administrator's login. If not specified, 'admin' is used.
# panel-username: admin
# [optional] panel-password
# Panel administrator password. If not specified, it is automatically detected.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]PANEL_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
# panel-password: setup
# [optional] panel-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# panel-password-type: plain
# [optional] plesk-port
# Port of Plesk UI/API
# plesk-port: 8443
# [optional] session-dir
# A directory for temporary files on Plesk target server.
# Option makes sense only if you run Plesk Migrator on another server than target Plesk.
# If you run Plesk Migrator on the same server as target Plesk, all temporary files are placed
# to session directory according to [GLOBAL] section.
# If not specified, temporary files will be put into '/root/plesk_migrator'
# session-dir: /root/plesk_migrator
# [optional] skip-extensions
# Do not migrate Plesk extensions data. Default value is 'false'.
# skip-extensions: false
# [optional] skip-external-id
# Do not migrate external IDs for resellers, customers and subscriptions. Default value is 'false'.
# skip-external-id: false
# [optional] is-local
# Whether migration tools are working on the same server as target Plesk.
# Default is true.
# is-local: true
# [optional] apache-restart-interval
# Minimum time interval, in seconds, between Apache restarts during a
# migration. If this interval is short, Apache will restart too often. This
# will cause long downtimes on Plesk target server. If this interval is long,
# existing users of Plesk target server will have to wait longer for their
# changes to be applied. To skip changing Apache restart interval set value to
# 'none'. If not specified, migration tool will skip changing the Apache
# restart interval.
# apache-restart-interval: none
[pfu]
# This section defines settings of source Plesk server 'pfu1'.
# [mandatory] ip
# An IP v4 address of this source Plesk server.
ip:
# [mandatory] os
# Server's operating system type, 'unix' or 'windows'.
os: unix
# [optional] panel-username
# Panel administrator user name. If not specified, 'admin' is used.
# panel-username: admin
# [mandatory] panel-password
# Panel administrator password. If not specified, it is automatically detected.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]PANEL_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
# panel-password:
# [optional] panel-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# panel-password-type: plain
# [optional] plesk-port
# Port of Plesk UI/API
# plesk-port: 8443
# [optional] ssh-username
# User name of the privileged system user on this Plesk server. If not specified, 'root' is used.
# ssh-username: root
# [optional] ssh-auth-type
# SSH authentication type.
# There are two authentication types supported: 'password' or 'key'. Default is 'password'.
# ssh-auth-type: password
# [optional] ssh-password
# Password of the privileged system user on this Plesk server.
# You must specify it, if you select SSH authentication type password.
# Note that the hash mark in password is treated as a regular symbol.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]SSH_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
ssh-password:
# [optional] ssh-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# ssh-password-type: plain
# [optional] ssh-key
# Path to SSH private key file. You can specify it if you select SSH
# authentication type 'key'. If not specified, "id_rsa" or "id_dsa" keys from
# the directory '~/.ssh' are used.
# ssh-key: /root/.ssh/id_rsa
# [optional] ssh-port
# Port number on which SSH service accepts incoming connections
# ssh-port: 22
# [optional] session-dir
# A directory for temporary files.
# If not specified, temporary files are put into /root/plesk_migrator.
# session-dir: /root/plesk_migrator
# [optional] copy-mail-content
# This parameter specifies what mail content should be copied from the server:
# 'full' to copy all mail content, and 'none' to skip copying.
# If not specified, all mail content is copied.
# copy-mail-content: full
# [optional] copy-web-content
# This parameter specifies what web content should be copied from the server:
# 'full' to copy all web content, and 'none' to skip copying.
# If not specified, all web content is copied.
# copy-web-content: full
# [optional] ssh-authorized-keys-file
# This parameter specifies location of SSH authorized keys file for root user.
# This file is necessary for setting up key auth when copying files with rsync: copy web content, deploy agent, etc.
# By default, if this parameter is not specified, migrator will put public keys to
# '~/.ssh/authorized_keys' and '~/.ssh/authorized_keys2' files. So, in default configuration
# this option should not be touched. If you have troubles setting up key auth during migration,
# check AuthorizedKeysFile option in your SSH server's configuration file (usually /etc/ssh/sshd_config).
# ssh-authorized-keys-file: ~/.ssh/authorized_keys

View File

@@ -1,12 +0,0 @@
[GLOBAL]
source-type: plesk
sources: pfu
[plesk]
ip:
os: unix
[pfu]
ip:
os: unix
ssh-password:

View File

@@ -1,450 +0,0 @@
[GLOBAL]
# This section defines migrator's global settings.
# [mandatory, non-modifiable] source-type
# Source servers' product type.
#
# This is a template of configuration file for migration from Plesk to Plesk.
# For other source or target panels, browse other provided
# configuration templates and pick one that best suits your source type.
source-type: plesk
# [mandatory] sources
# A comma-separated list of the sections, that describe source Plesk
# servers. In this setting you may specify one or more Plesk for Unix
# and/or Plesk for Windows servers.
#
# The order of the section names in this list is significant: Plesk server,
# which section is listed earlier, has priority in conflict resolution.
sources: pfw
# [optional] external-db-servers
# Comma-separated list of the sections describing external source database servers.
# It is highly recommended to specify external database servers for remote MSSQL - otherwise there could be issues
# when copying database content.
# external-db-servers: mssql1
# [optional] session-dir
# A directory for migration tool's temporary files.
# If not specified, temporary files will be put into './migration-session'.
# session-dir: migration-session
# [optional] zones-ttl
# The time in seconds, which migration tool sets as the SOA minimum TTL and
# refresh interval on a new DNS server.
# If not specified, default value is assumed: 120
# zones-ttl: 120
# [optional] external-dns-server
# An IPv4 address of an external DNS server that allows recursive DNS queries.
# Migration tool uses the specified address to test whether general Internet
# users can obtain the correct DNS records for the transferred domains. If
# nothing is specified, migration tool will use Google DNS server (8.8.8.8).
# If 'none' is specified, migration tool will skip this test.
# external-dns-server: 8.8.8.8
# [optional] mail-messages-delta-limit
# The post-migration mail checks compare the number of messages in the source
# and the target mailboxes. If the number of messages differs more than it is
# specified in "mail-messages-delta-limit", it is considered an error.
# If the option is not specified, default value is assumed: 10
# mail-messages-delta-limit: 10
# [optional] website-availability-check-timeout
# This is the timeout, that migrator uses, when testing web site availability
# after migration. If not specified, default value is assumed: 30
# website-availability-check-timeout: 30
# [optional] website-availability-depth
# Maximum depth of links to check when testing web site availability after migration.
# For example depth 2 means to check main page and all child pages, depth 3 means to check
# main page, child pages of main page and child pages of child pages.
# If not specified, default value is assumed: 2. Increasing the value will increase time
# to perform post-migration checks, but will improve coverage of tested web pages.
# website-availability-depth: 2
# [optional] website-availability-group-directories
# Whether to group files with the same directory and file extension when testing web site
# availability after migration. If enabled, and main page contains 2 links '/subdir/a.php' and
# '/subdir/b.php', only one of them will be checked. Still if files are in different directories
# (e.g. '/subdir1/a.php' and '/subdir2/b.php') or have different extension
# (e.g. '/subdir/a.php' and '/subdir/b.aspx'), both of them will be checked.
# If not specified, default value is false. Enabling that option will speed up checks, but
# decrease coverage of tested web pages.
# website-availability-group-directories: false
# [optional] log-message-context-length
# When logging a multiline output (API request, response), show only top N
# and last N lines. Default value is 0, which means to display full API requests.
# log-message-context-length: 10
# [optional] use-hosting-analyser
# Set this option to 'True', if you need to analyse hosting and detect optimal
# algorithm to copy content. Default value of this option is 'True'.
# use-hosting-analyser: True
# [optional] use-math-analyse
# Set this option to 'True', if you need to analyse hosting and detect optimal
# algorithm to copy content with math algorithm. Default value of this option is 'True'.
# Otherwise, the "matrix of strategies" algorithm would be used
# use-math-analyse: True
# [optional] hosting-analysis-ttl
# The time in seconds, which migration tool sets as minimum for hosting
# analysis results.
# If not specified, default value is assumed: 900
# hosting-analysis-ttl: 900
# [optional] skip-migrator-updates
# Do not check migrator repository for updates. Default value is 'False'
# skip-migrator-updates: False
# [optional] copy-mssql-content
# Select way to copy MSSQL content: native MSSQL dumps, text dumps or automatic selection (default).
# Possible values: '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
# Write migrator logs to a session directory, not to global logs directory.
# By default is true.
# use-separate-log: true
# [optional] use-binary-log
# Write binary migrator logs, which are necessary to display logs in GUI.
# By default is true.
# use-binary-log: true
# [optional] adjust-applications
# Whether to fix configuration files of several commonly used web applications.
# The fix could include database connection changes, path fixes, and so on.
# By default this option is enabled. You could disable it if it breaks migration of some
# application, or if you need better speed of migration.
# adjust-applications: true
# [optional] skip-actions
# List of actions which should not be executed during migration.
# Be careful when setting this option - other actions may rely on results of skipped actions. So, skipping
# an action could lead to broken migration.
# List format: action identifiers separated by ",".
# If you want to skip action for specific subscription only, specify the subscription after action identifier
# separated by ":".
# Example value: convert-dns, fetch-source, copy-mail-content:example.com, copy-web-files:example.com
# In that case migrator will not execute "convert-dns" and "fetch-source" actions for all subscriptions
# and will not execute "copy-mail-content" and "copy-web-files" for subscription "example.com"
# (still content will be copied for all the other migrated subscriptions).
# By default no actions are skipped.
# To list all actions executed by migrator (with their identifiers and text descriptions),
# prepare configuration file (config.ini) and run "plesk-migrator print-workflow config.ini".
# skip-actions:
# [optional] restore-hosting-settings-poll-limit
# When restoring hosting settings (addon domains, mailboxes, PHP settings, etc) of subscriptions,
# a special restore hosting settings task is started asynchroniously. Migrator polls status of
# the task periodically and check whether it finished.
# This options specifies maximum number of attempts to poll the task before we consider the task hanged.
# Additionally see "restore-hosting-settings-poll-interval" option.
# Total timeout after which we consider that restore hosting task hanged is
# "restore-hosting-settings-poll-limit" multiplied by "restore-hosting-settings-poll-interval".
# restore-hosting-settings-poll-limit: 7200
# [optional] restore-hosting-settings-poll-interval
# When restoring hosting settings (addon domains, mailboxes, PHP settings, etc) of subscriptions,
# a special restore hosting settings task is started asynchroniously. Migrator polls status of
# the task periodically and check whether it finished
# This options specifies interval between poll attempts (in seconds). Less inteval gives more instant detection
# that task has finished, but a bit more load on CPU/disk.
# Additionally see "restore-hosting-settings-poll-limit" option.
# Total timeout after which we consider that restore hosting task hanged is
# "restore-hosting-settings-poll-limit" multiplied by "restore-hosting-settings-poll-interval".
# restore-hosting-settings-poll-interval: 1
# [optional] rsync-additional-args
# Additional arguments which will be passed to "rsync" utility when it transfers files
# from the source server.
# For example, here you could enable compression with "rsync-additional-args: -z"
# to optimize file transfer time.
# rsync-additional-args:
[plesk]
# This section defines target panel settings.
# [mandatory] ip
# An IPv4 address of the target Plesk server.
ip:
# [mandatory] os
# Server's operating system type, 'unix' or 'windows'.
os: windows
# [optional] panel-username
# Panel administrator's login. If not specified, 'admin' is used.
# panel-username: admin
# [optional] panel-password
# Panel administrator password. If not specified, it is automatically detected.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]PANEL_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
# panel-password: setup
# [optional] panel-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# panel-password-type: plain
# [optional] plesk-port
# Port of Plesk UI/API
# plesk-port: 8443
# [optional] session-dir
# A directory for temporary files on Plesk target server.
# Option makes sense only if you run Plesk Migrator on another server than target Plesk.
# If you run Plesk Migrator on the same server as target Plesk, all temporary files are placed
# to session directory according to [GLOBAL] section.
# If not specified, temporary files will be put into 'C:\plesk_migrator'
# session-dir: C:\plesk_migrator
# [optional] skip-extensions
# Do not migrate Plesk extensions data. Default value is 'false'.
# skip-extensions: false
# [optional] skip-external-id
# Do not migrate external IDs for resellers, customers and subscriptions. Default value is 'false'.
# skip-external-id: 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
# Whether migration tools are working on the same server as target Plesk.
# Default is true.
# is-local: true
[pfw]
# This section is an example of settings for source Plesk for Windows.
# [mandatory] ip
# An IP v4 address of this source Plesk server.
ip:
# [mandatory] os
# Server's operating system type, 'unix' or 'windows'.
os: windows
# [optional] panel-username
# Panel administrator user name. If not specified, 'admin' is used.
# panel-username: admin
# [optional] panel-password
# Panel administrator password. If not specified, it is automatically detected.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]PANEL_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
# panel-password:
# [optional] panel-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# panel-password-type: plain
# [optional] plesk-port
# Port of Plesk UI/API
# plesk-port: 8443
# [optional] windows-username
# User name of the privileged system user on this Plesk server. Default is 'Administrator'.
# windows-username: Administrator
# [mandatory] windows-password
# Password of the privileged system user on this Plesk server.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]WINDOWS_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
windows-password:
# [optional] windows-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# windows-password-type: plain
# [optional] session-dir
# A directory for temporary files.
# 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
# This parameter specifies what mail content should be copied from the server:
# 'full' to copy all mail content, and 'none' to skip copying.
# If not specified, all mail content is copied.
# copy-mail-content: full
# [optional] copy-web-content
# This parameter specifies what web content should be copied from the server:
# 'full' to copy all web content, and 'none' to skip copying.
# If not specified, all web content is copied.
# copy-web-content: full
# [optional] mail-source-log-enabled
# Whether additional logging is enabled for MailMigrator.exe utility running on the source server
# Corresponding log will be put to <session-dir>/mail/<domain-name>/<mail-name>/mail-backup.log
# mail-source-log-enabled: false
# [optional] mail-target-log-enabled
# Whether additional logging is enabled for MailMigrator.exe utility running on the target server
# Corresponding logs will be put to:
# <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
# Override mail provider (mail server type) used by MailMigrator.exe utility running on the source server.
# Examples of possible values: "mailenable", "smartermail", "imap", and so on.
# For the full list of possible values, refer to "MailMigrator.exe help" output.
# mail-source-provider:
# [optional] mail-target-provider
# Override mail provider (mail server type) used by MailMigrator.exe utility running on the target server.
# Examples of possible values: "mailenable", "smartermail", "imap", and so on.
# For the full list of possible values, refer to "MailMigrator.exe help" output.
# mail-target-provider:
# [optional] mail-source-additional-options
# Additional command line options to pass to MailMigrator.exe utility running on the source server.
# Example of value (to specify IMAP port): --port=123
# mail-source-additional-options:
# [optional] mail-target-additional-options
# Additional command line options to pass to MailMigrator.exe utility running on the target server.
# Example of value (to specify IMAP port): --port=123
# mail-target-additional-options:
# [optional] remote-mssql-session-dir
# A directory for temporary files on source 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
[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
# The host of this database server as displayed in the panel, with mandatory instance name appended.
# For MSSQL it usually consists of IP address and instance name, for example:
# 192.168.1.1\MSSQLSERVER2008
host:
# [mandatory] type
# Type of the database server, the only allowed value is 'mssql'
type: mssql
# [mandatory] ip
# An IP v4 address of this database server.
ip:
# [optional] windows-username
# User name of the privileged system user on this centralized mail server. Default is 'Administrator'.
# windows-username: Administrator
# [mandatory] windows-password
# Password of the privileged system user on this database server.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]WINDOWS_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
windows-password:
# [optional] windows-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# windows-password-type: plain
[target-remote-smarter-mail]
# This optional section defines settings of target remote SmarterMail server
# [optional] ip
# An IPv4 address of the target remote SmarterMail server used for communications with it.
# Detected automatically if not specified.
# ip:
# [optional] windows-username
# User name of the privileged system user on this Plesk server. Default is 'Administrator'.
# windows-username: Administrator
# [optional] windows-password
# Password of the privileged system user on this server.
# The more secure way to pass a password is using the environment variable
# TARGET_REMOTE_SMARTER_MAIL_WINDOWS_PASSWORD. For that keep this option empty
# and set up the environment variable before the migrator run.
# windows-password:
# [optional] windows-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# windows-password-type: plain
# [optional] session-dir
# A directory for temporary files.
# If not specified, temporary files are put into C:\plesk_migrator.
# session-dir: C:\plesk_migrator
[pfw-remote-smarter-mail]
# This optional section defines settings of source remote SmarterMail server corresponding to
# Plesk server defined by "pfw" section
# [optional] ip
# An IPv4 address of the source remote SmarterMail server used for communications with it.
# Detected automatically if not specified.
# ip:
# [optional] windows-username
# User name of the privileged system user on this server. Default is 'Administrator'.
# windows-username: Administrator
# [optional] windows-password
# Password of the privileged system user on this server.
# The more secure way to pass a password is using the environment variable
# [SECTIONNAME_]PANEL_PASSWORD. For that keep this option empty and set up
# the environment variable before the migrator run.
# windows-password:
# [optional] windows-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# windows-password-type: plain
# [optional] session-dir
# A directory for temporary files.
# If not specified, temporary files are put into C:\plesk_migrator.
# session-dir: C:\plesk_migrator
# [optional] mail-source-log-enabled
# Whether additional logging is enabled for MailMigrator.exe utility running on the source server
# Corresponding log will be put to <session-dir>/mail/<domain-name>/<mail-name>/mail-backup.log
# mail-source-log-enabled: false
# [optional] mail-target-log-enabled
# Whether additional logging is enabled for MailMigrator.exe utility running on the target server
# Corresponding logs will be put to:
# <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-target-provider
# Override mail provider (mail server type) used by MailMigrator.exe utility running on the target server.
# Examples of possible values: "mailenable", "smartermail", "imap", and so on.
# For the full list of possible values, refer to "MailMigrator.exe help" output.
# mail-target-provider:
# [optional] mail-source-additional-options
# Additional command line options to pass to MailMigrator.exe utility running on the source server.
# Example of value (to specify IMAP port): --port=123
# mail-source-additional-options:
# [optional] mail-target-additional-options
# Additional command line options to pass to MailMigrator.exe utility running on the target server.
# Example of value (to specify IMAP port): --port=123
# mail-target-additional-options:

View File

@@ -1,12 +0,0 @@
[GLOBAL]
source-type: plesk
sources: pfw
[plesk]
ip:
os: windows
[pfw]
ip:
os: windows
windows-password:

View File

@@ -1,233 +0,0 @@
[GLOBAL]
# This section defines migrator's global settings.
# [mandatory, non-modifiable] source-type
# Source servers' product type.
#
# This is a template of configuration file for migration from PPCPL to
# Plesk. For other source or target panels, browse other provided
# configuration templates and pick one that best suits your source type.
source-type: ppcpl
# [optional] session-dir
# A directory for migration tool's temporary files.
# If not specified, temporary files will be put into './migration-session'.
# session-dir: migration-session
# [optional] zones-ttl
# The time in seconds, which migration tool sets as the SOA minimum TTL and
# refresh interval on a new DNS server.
# If not specified, default value is assumed: 120
# zones-ttl: 120
# [optional] external-dns-server
# An IPv4 address of an external DNS server that allows recursive DNS queries.
# Migration tool uses the specified address to test whether general Internet
# users can obtain the correct DNS records for the transferred domains. If
# nothing is specified, migration tool will use Google DNS server (8.8.8.8).
# If 'none' is specified, migration tool will skip this test.
# external-dns-server: 8.8.8.8
# [optional] mail-messages-delta-limit
# The post-migration mail checks compare the number of messages in the source
# and the target mailboxes. If the number of messages differs more than it is
# specified in "mail-messages-delta-limit", it is considered an error.
# If the option is not specified, default value is assumed: 10
# mail-messages-delta-limit: 10
# [optional] website-availability-check-timeout
# This is the timeout, that migrator uses, when testing web site availability
# after migration. If not specified, default value is assumed: 30
# website-availability-check-timeout: 30
# [optional] website-availability-depth
# Maximum depth of links to check when testing web site availability after migration.
# For example depth 2 means to check main page and all child pages, depth 3 means to check
# main page, child pages of main page and child pages of child pages.
# If not specified, default value is assumed: 2. Increasing the value will increase time
# to perform post-migration checks, but will improve coverage of tested web pages.
# website-availability-depth: 2
# [optional] website-availability-group-directories
# Whether to group files with the same directory and file extension when testing web site
# availability after migration. If enabled, and main page contains 2 links '/subdir/a.php' and
# '/subdir/b.php', only one of them will be checked. Still if files are in different directories
# (e.g. '/subdir1/a.php' and '/subdir2/b.php') or have different extension
# (e.g. '/subdir/a.php' and '/subdir/b.aspx'), both of them will be checked.
# If not specified, default value is false. Enabling that option will speed up checks, but
# decrease coverage of tested web pages.
# website-availability-group-directories: false
# [optional] log-message-context-length
# When logging a multiline output (API request, response), show only top N
# and last N lines. Default value is 0, which means to display full API requests.
# log-message-context-length: 10
# [optional] event-scripts-dir
# Directory with scripts/executables that should be launched on migration events
# Default is $VAR_DIR/events, where VAR_DIR is /usr/local/psa/var/modules/panel-migrator/ for Unix
# event-scripts-dir:
# [optional] use-separate-log
# Write migrator logs to a session directory, not to global logs directory.
# By default is true.
# use-separate-log: true
# [optional] use-binary-log
# Write binary migrator logs, which are necessary to display logs in GUI.
# By default is true.
# use-binary-log: true
# [optional] adjust-applications
# Whether to fix configuration files of several commonly used web applications.
# The fix could include database connection changes, path fixes, and so on.
# By default this option is enabled. You could disable it if it breaks migration of some
# application, or if you need better speed of migration.
# adjust-applications: true
# [optional] skip-actions
# List of actions which should not be executed during migration.
# Be careful when setting this option - other actions may rely on results of skipped actions. So, skipping
# an action could lead to broken migration.
# List format: action identifiers separated by ",".
# If you want to skip action for specific subscription only, specify the subscription after action identifier
# separated by ":".
# Example value: convert-dns, fetch-source, copy-mail-content:example.com, copy-web-files:example.com
# In that case migrator will not execute "convert-dns" and "fetch-source" actions for all subscriptions
# and will not execute "copy-mail-content" and "copy-web-files" for subscription "example.com"
# (still content will be copied for all the other migrated subscriptions).
# By default no actions are skipped.
# To list all actions executed by migrator (with their identifiers and text descriptions),
# prepare configuration file (config.ini) and run "plesk-migrator print-workflow config.ini".
# skip-actions:
# [optional] restore-hosting-settings-poll-limit
# When restoring hosting settings (addon domains, mailboxes, PHP settings, etc) of subscriptions,
# a special restore hosting settings task is started asynchroniously. Migrator polls status of
# the task periodically and check whether it finished.
# This options specifies maximum number of attempts to poll the task before we consider the task hanged.
# Additionally see "restore-hosting-settings-poll-interval" option.
# Total timeout after which we consider that restore hosting task hanged is
# "restore-hosting-settings-poll-limit" multiplied by "restore-hosting-settings-poll-interval".
# restore-hosting-settings-poll-limit: 7200
# [optional] restore-hosting-settings-poll-interval
# When restoring hosting settings (addon domains, mailboxes, PHP settings, etc) of subscriptions,
# a special restore hosting settings task is started asynchroniously. Migrator polls status of
# the task periodically and check whether it finished
# This options specifies interval between poll attempts (in seconds). Less inteval gives more instant detection
# that task has finished, but a bit more load on CPU/disk.
# Additionally see "restore-hosting-settings-poll-limit" option.
# Total timeout after which we consider that restore hosting task hanged is
# "restore-hosting-settings-poll-limit" multiplied by "restore-hosting-settings-poll-interval".
# restore-hosting-settings-poll-interval: 1
# [optional] rsync-additional-args
# Additional arguments which will be passed to "rsync" utility when it transfers files
# from the source server.
# For example, here you could enable compression with "rsync-additional-args: -z"
# to optimize file transfer time.
# rsync-additional-args:
[plesk]
# This section defines target panel settings.
# [mandatory] ip
# An IPv4 address of the target Plesk server.
ip:
# [mandatory] os
# Server's operating system type, should be 'unix' for migration from PPCPL.
os: unix
# [optional] panel-username
# Panel administrator's login. If not specified, 'admin' is used.
# panel-username: admin
# [optional] panel-password
# Panel administrator password. If not specified, it is automatically detected.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]PANEL_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
# panel-password: setup
# [optional] panel-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# panel-password-type: plain
# [optional] session-dir
# A directory for temporary files on Plesk target server.
# Option makes sense only if you run Plesk Migrator on another server than target Plesk.
# If you run Plesk Migrator on the same server as target Plesk, all temporary files are placed
# to session directory according to [GLOBAL] section.
# If not specified, temporary files will be put into '/root/plesk_migrator'
# session-dir: /root/plesk_migrator
# [optional] is-local
# Whether migration tools are working on the same server as target Plesk.
# Default is true.
# is-local: true
# [optional] apache-restart-interval
# Minimum time interval, in seconds, between Apache restarts during a
# migration. If this interval is short, Apache will restart too often. This
# will cause long downtimes on Plesk target server. If this interval is long,
# existing users of Plesk target server will have to wait longer for their
# changes to be applied. To skip changing Apache restart interval set value to
# 'none'. If not specified, migration tool will skip changing the Apache
# restart interval.
# apache-restart-interval: none
[ppcpl]
# This section defines settings of source PPCPL server.
# [mandatory] ip
# IP address or host name of the source server.
ip:
# [mandatory] os
# Server's operating system type, should be 'unix' for migration from PPCPL.
os: unix
# [optional] ssh-username
# User name of the privileged system user on this server. If not specified, 'root' is used.
# ssh-username: root
# [optional] ssh-auth-type
# SSH authentication type.
# There are two authentication types supported: 'password' or 'key'. Default is 'password'.
# ssh-auth-type: password
# [optional] ssh-password
# Password of the privileged system user on this server.
# You must specify it, if you select SSH authentication type password.
# Note that the hash mark in password is treated as a regular symbol.
# The more secure way to pass a password is using the environment variable [SECTIONNAME_]SSH_PASSWORD (the section
# name is optional). For that keep this option empty and set up the environment variable before the migrator run.
ssh-password:
# [optional] ssh-password-type
# Possible values: 'plain', 'encrypted'. Default is 'plain'.
# ssh-password-type: plain
# [optional] ssh-key
# Path to SSH private key file. You can specify it if you select SSH
# authentication type 'key'. If not specified, "id_rsa" or "id_dsa" keys from
# the directory '~/.ssh' are used.
# ssh-key: /root/.ssh/id_rsa
# [optional] copy-mail-content
# This option specifies whether mail content should be copied from the server
# (the 'full' value) or not ('none'). If not specified, mail content will be
# copied.
# copy-mail-content: full
# [optional] copy-web-content
# This option specifies whether web content should be copied from the server
# (the 'full' value) or not ('none'). If not specified, web content will be
# copied.
# copy-web-content: full
# [optional] session-dir
# A directory for temporary files.
# If not specified, temporary files are put into /root/plesk_migrator.
# session-dir: /root/plesk_migrator

View File

@@ -1,11 +0,0 @@
[GLOBAL]
source-type: ppcpl
[plesk]
ip:
os: unix
[ppcpl]
ip:
os: unix
ssh-password:

View File

@@ -1,77 +0,0 @@
# This configuration sample describes advanced options for Windows RPC agent, specified at Plesk Migrator side.
#
# Windows RPC agent is a program, uploaded to a remote server (usually source one),
# which allows Plesk Migrator to execute commands on the server, upload and download files to/from
# the server, and perform other activities required to perform migration.
# Communication between Plesk Migrator and Windows RPC agent works via TCP.
#
# All of the options below are advanced and should be avoided to use for regular migrations.
# Use them at your own risk.
# Add any of advanced options to a section of a server, where Windows RPC agent is installed or
# expected to be installed.
# [windows-server-with-rpc-agent]
# TCP port on which Windows RPC agent listens on remote server.
# If you customize that option, ensure you allowed the port for incoming connections
# in the Windows Firewall.
# If you customize that option, reconfigure Windows RPC agent at the remote server accordingly.
# [optional] windows-agent-port
# windows-agent-port: 10155
# Whether to use secure SSL connection for communication with Windows RPC agent.
# When set to false, all data is transferred unencrypted, and no authentication is performed,
# which makes all communications completely insecure.
# If you customize that option, reconfigure Windows RPC agent at the remote server accordingly.
# [optional] windows-agent-use-ssl
# windows-agent-use-ssl: true
# Path to SSL certificate, used by Plesk Migrator for secure SSL connection.
# By default, certificate from %VAR_DIR%\rpc-agent\certificates\migration-node.crt is used,
# where %VAR_DIR% is a "VAR" directory of migrator.
# If you customize that option, reconfigure Windows RPC agent at the remote server accordingly.
# [optional] windows-agent-client-cert
# windows-agent-client-cert:
# Path to SSL private key, used by Plesk Migrator for secure SSL connection.
# By default, key from %VAR_DIR%\rpc-agent\certificates\migration-node.key is used,
# where %VAR_DIR% is a "VAR" directory of migrator.
# If you customize that option, reconfigure Windows RPC agent at the remote server accordingly.
# [optional] windows-agent-client-key
# windows-agent-client-key:
# Path to SSL certificate, used by Windows RPC agent for secure SSL connection.
# By default, certificate from %VAR_DIR%\rpc-agent\certificates\source-node.crt is used,
# where %VAR_DIR% is a "VAR" directory of migrator.
# If you customize that option, reconfigure Windows RPC agent at the remote server accordingly.
# [optional] windows-agent-server-cert
# windows-agent-server-cert:
# Path to Windows RPC agent directory on the source server.
# Default value is %SESSION_DIR%/rpc-agent, where %SESSION_DIR% is a directory for temporary migrator
# files on the remote server.
# [optional] windows-agent-path
# windows-agent-path:
# Time (in seconds) to avoid dropping of idle TCP connections to Windows RPC agent.
# Migrator may perform long operations on the local target server, while nothing is send to or received
# from remote Windows RPC agent at that time. To avoid dropping TCP connection to the agent, TCP keepalive
# time is configured. See https://msdn.microsoft.com/en-us/library/dd877220%28v=vs.85%29.aspx for details.
# Default value is 5 minutes.
# [optiona] windows-agent-tcp-keepalive-time
# windows-agent-tcp-keepalive-time: 30000
# Whether to perform additional logging when communicating with Windows RPC agent in piped mode.
# Piped mode is used to transfer mail messages between servers. Enable this option if you want to
# debug communications with Windows RPC agent during mail messages transfer.
# Consider that debug log of migrator may grow very fast if that option is enabled.
# [optional] windows-agent-piped-command-full-logging
# windows-agent-piped-command-full-logging: false
# Whether to skip automatic deployment of Windows RPC agent.
# When set to true, which is the default, Plesk Migrator will try to upload and start Windows RPC agent
# on the remote server automatically with the help of "paexec" utility.
# When set to false, no automatic deployement and start is performed, Windows RPC agent must
# be already started on the remote server.
# [optional] windows-agent-skip-deployment
# windows-agent-skip-deployment: false

View File

@@ -1,2 +0,0 @@
from pkgutil import extend_path
__path__ = extend_path(__path__, __name__)

View File

@@ -1,238 +0,0 @@
import os
import time
import subprocess
import threading
from io import BytesIO
from pipes import quote
from parallels.core import messages
from parallels.core.logging import get_logger
from parallels.core.utils.common import safe_format, popen_no_inherit, is_run_on_windows
from parallels.core.utils.common.string_utils import safe_utf8_encode, safe_str_decode
logger = get_logger(__name__)
class MigrationError(Exception):
def __init__(self, message, error_id=None, details=None):
"""Class constructor
:type message: str
:type error_id: str | None
:type details: Any | None
"""
super(Exception, self).__init__(message)
self._message = message
self._error_id = error_id
self._details = details
@property
def message(self):
"""
:rtype: str
"""
return self._message
@property
def error_id(self):
"""Error ID - a string identifying the error for other components"""
return self._error_id
@property
def details(self):
"""
:rtype: str | None
"""
return self._details
class ParallelExecutionError(MigrationError):
def __init__(self):
super(MigrationError, self).__init__(messages.EXCEPTION_PARALLEL_EXECUTION)
class CommandExecutionError(MigrationError):
"""Exception occurred when executing some command on some host"""
def __init__(self, message, stdout='', stderr='', host_description='', cause=''):
super(MigrationError, self).__init__(message)
self._stdout = stdout
self._stderr = stderr
self._host_description = host_description
self._cause = cause
@property
def stdout(self):
"""stdout of the command"""
return self._stdout
@property
def stderr(self):
"""stderr of the command"""
return self._stderr
@property
def host_description(self):
"""Description of the host where the command was executed"""
return self._host_description
@property
def cause(self):
"""Root cause of the error - exception caused command execution to fail"""
return self._cause
class APIError(MigrationError):
"""Exception occurred when executing some request through external API"""
@property
def how_to_reproduce(self):
"""User-friendly description on how to reproduce API request"""
raise NotImplementedError()
class MigrationConfigurationFileError(MigrationError):
pass
class MigrationNoContextError(MigrationError):
pass
class InvalidCredentials(MigrationNoContextError):
pass
class MigratorInterruptException(MigrationError):
def __init__(self):
super(MigratorInterruptException, self).__init__(messages.INTERRUPT_EXCEPTION)
class MigrationNoRepeatError(MigrationError):
"""Exception explicitly stating that there is no sense to repeat failed operation for the object
For example, if subscription creation failed because such subscription already exists,
there is no sense to try to create subscription any more times.
"""
pass
class MigrationStopError(MigrationError):
"""Exception for situations when migration should be stopped, for example failed essential pre-migration checks"""
pass
def local_command_exec(
command, stdin_content=None, output_codepage='utf-8', error_policy='backslashreplace', env=None, working_dir=None,
umask=None, stop_mark=None, stop_poll_interval=None
):
stdin_content_prepared = stdin_content
if isinstance(stdin_content_prepared, str):
stdin_content_prepared = stdin_content_prepared.encode('utf-8')
if type(command) is list or type(command) is tuple:
command_str = ' '.join([quote(c) for c in command])
command_encoded = [safe_utf8_encode(c) for c in command]
else:
command_str = command
command_encoded = safe_utf8_encode(command)
command_env = os.environ.copy()
command_env['LANG'] = 'en_US.utf-8'
if env is not None:
command_env.update(env)
kwargs = dict(
stdin=subprocess.PIPE,
stdout=subprocess.PIPE,
stderr=subprocess.PIPE,
env=command_env,
cwd=working_dir
)
if umask is not None:
kwargs['umask'] = umask
if stop_mark is not None:
kwargs['start_new_session'] = True
try:
p = popen_no_inherit(
command_encoded,
**kwargs
)
if stop_mark is not None:
if stdin_content_prepared is not None:
p.stdin.write(stdin_content_prepared)
p.stdin.close()
stdout_data = BytesIO()
stderr_data = BytesIO()
read_buffer_size = 1024
def consume_stdout():
while p.returncode is None:
p.poll()
stdout_part = p.stdout.read(read_buffer_size)
stdout_data.write(stdout_part)
def consume_stderr():
while p.returncode is None:
p.poll()
stderr_part = p.stderr.read(read_buffer_size)
stderr_data.write(stderr_part)
thread_stdout = threading.Thread(target=consume_stdout)
thread_stdout.start()
thread_stderr = threading.Thread(target=consume_stderr)
thread_stderr.start()
while True:
if p.returncode is not None:
thread_stdout.join()
thread_stderr.join()
stdout_last_part = p.stdout.read()
stdout_data.write(stdout_last_part)
stderr_last_part = p.stderr.read()
stderr_data.write(stderr_last_part)
stdout_str = stdout_data.getvalue()
if output_codepage is not None:
stdout_str = stdout_str.decode(output_codepage, error_policy)
stderr_str = stderr_data.getvalue()
if output_codepage is not None:
stderr_str = stderr_str.decode(output_codepage, error_policy)
return p.returncode, stdout_str, stderr_str
if stop_mark.is_set():
if is_run_on_windows():
subprocess.call(
['taskkill', '/F', '/T', '/PID', str(p.pid)],
stdout=subprocess.PIPE, stderr=subprocess.PIPE
)
p.kill()
else:
import signal
os.killpg(os.getpgid(p.pid), signal.SIGTERM)
p.wait()
raise MigratorInterruptException()
time.sleep(stop_poll_interval)
else:
stdout_str, stderr_str = p.communicate(stdin_content_prepared)
if output_codepage is not None:
stdout_str = stdout_str.decode(output_codepage, error_policy)
if output_codepage is not None:
stderr_str = stderr_str.decode(output_codepage, error_policy)
return p.returncode, stdout_str, stderr_str
except MigratorInterruptException:
raise
except Exception as e:
logger.exception()
raise Exception(safe_format(messages.FAILED_TO_EXECUTE_LOCAL_COMMAND, command=command_str, reason=e))
def version_tuple(version):
"""Convert string product version to a tuple of ints"""
return tuple(map(int, version.split('.')))

View File

@@ -1,105 +0,0 @@
import os
from parallels.core import messages
from parallels.core import safe_format
from parallels.core.actions.base.subscription_action import SubscriptionAction
from parallels.core.logging import get_logger
from parallels.core.migrator_config import read_adjust_applications_enabled, \
read_adjust_applications_remove_absent_handlers_enabled
from parallels.core.reports.model.issue import Issue
from parallels.core.utils.common import format_multiline_list, is_empty
from parallels.core.utils.web_config_file import WebConfigFile
logger = get_logger(__name__)
class AdjustWebConfigAbsentHandlers(SubscriptionAction):
"""Remove absent handlers from web.config files of the migrated sites
Example of handler in web config file:
<handlers>
<add
name="PHP_via_FastCGI" path=".php" verb="" modules="FastCgiModule"
scriptProcessor="C:\PHP5.3\php-cgi.exe" resourceType="Unspecified" requireAccess="Script" />
</handlers>
In that example, if "C:\PHP5.3\php-cgi.exe" file is absent on the target server,
corresponding "add" XML node will be removed from web.config file.
"""
def get_description(self):
"""Get short description of action as string
:rtype: str
"""
return messages.ACTION_ADJUST_WEB_CONFIG_ABSENT_HANDLERS_DESCRIPTION
def get_failure_message(self, global_context, subscription):
"""
:type global_context: parallels.core.global_context.GlobalMigrationContext
:type subscription: parallels.core.migrated_subscription.MigratedSubscription
"""
return messages.ACTION_ADJUST_WEB_CONFIG_ABSENT_HANDLERS_FAILURE
def is_critical(self):
"""If action is critical or not"""
return False
def filter_subscription(self, global_context, subscription):
"""
:type global_context: parallels.core.global_context.GlobalMigrationContext
:type subscription: parallels.core.migrated_subscription.MigratedSubscription
"""
# filter only subscriptions on windows physical servers
source_info = subscription.get_source_info()
if not source_info.is_server or not source_info.is_windows:
return False
return (
read_adjust_applications_enabled(global_context.config) and
read_adjust_applications_remove_absent_handlers_enabled(global_context.config)
)
def run(self, global_context, subscription):
"""Run action on given subscription
:type global_context: parallels.core.global_context.GlobalMigrationContext
:type subscription: parallels.core.migrated_subscription.MigratedSubscription
:rtype: None
"""
for domain in subscription.converted_dump.iter_domains():
if not domain.is_virtual_hosting:
continue
for web_config_file in WebConfigFile.iter_for_domain(subscription, domain):
nodes_to_remove = []
absent_script_processors = set()
for handler_node in web_config_file.xml.findall('.//handlers'):
for add_node in handler_node:
if 'scriptProcessor' not in add_node.attrib:
continue
if is_empty(add_node.attrib['scriptProcessor']):
continue
if not os.path.exists(add_node.attrib['scriptProcessor']):
absent_script_processors.add(add_node.attrib['scriptProcessor'])
nodes_to_remove.append((handler_node, add_node))
if len(absent_script_processors) > 0:
for parent, node_to_remove in nodes_to_remove:
parent.remove(node_to_remove)
web_config_file.save()
subscription_report = global_context.application_adjust_report.subtarget(
'Subscription', subscription.name
)
subscription_report.add_issue(
'web_config_absent_handler',
Issue.SEVERITY_INFO, safe_format(
messages.REMOVED_ABSENT_HANDLER_WEB_CONFIG_FILE, filename=web_config_file.filename,
script_processors=format_multiline_list(absent_script_processors)
)
)

View File

@@ -1 +0,0 @@
"""Common actions on Plesk backup files"""

Some files were not shown because too many files have changed in this diff Show More