Cách di chuyển ISPConfig 2, ISPConfig 3.x, Confixx, CPanel hoặc Plesk sang ISPConfig 3.2 (máy chủ đơn)

[theanh]

Trong hướng dẫn này, chúng tôi sẽ chỉ cách sử dụng ISPConfig Migration Tool 2.0 để di chuyển một máy chủ duy nhất sang máy chủ ISPConfig 3.2 mới. Migration Tool là một phần của bộ công cụ ISPConfig Migration có tại đây.

Có thể sử dụng ISPConfig Migration Tool để di chuyển các Hosting Control Panel này sang máy chủ ISPConfig 3.2:

• ISPConfig 2
• ISPConfig 3 và 3,1
• Plesk 10 - 12.5
• Plesk Onyx
• Confixx
• Cpanel

Trong hướng dẫn này, chúng tôi sẽ di chuyển máy chủ ISPConfig 3.0 sang hệ thống mới chạy ISPConfig 3.2. Quá trình di chuyển từ các bảng điều khiển lưu trữ được hỗ trợ khác được thực hiện tương tự. Công cụ di chuyển sẽ hướng dẫn bạn từng bước trong suốt quá trình di chuyển.

Điều kiện tiên quyết và Ghi chú​

• ISPConfig 3.x trên máy chủ nguồn.
• ISPConfig 3.1.7 trở lên trên máy chủ đích.
• PHP 5.3+ có hỗ trợ JSON, mcrypt, OpenSSL và mbstring trên máy chủ nguồn.
• Máy chủ cũ và máy chủ mới không được kết nối với cùng một máy chủ chính. Nếu chúng được kết nối với cùng một máy chủ chính, hãy sử dụng ISPCopy thay thế (cũng là một phần của Migration Toolkit).
• Giấy phép Migration Toolkit.
• Chứng chỉ Let's Encrypt: Máy chủ cũ và mới phải sử dụng cùng một máy khách Let's Encrypt. Nếu máy chủ cũ của bạn sử dụng Certbot, hãy đảm bảo rằng hệ thống mới cũng sử dụng Certbot chứ không phải Acme.sh. Nếu bạn cài đặt máy chủ mới bằng trình cài đặt tự động ISPConfig và máy chủ cũ của bạn sử dụng certbot, hãy sử dụng công tắc dòng lệnh --use-certbot trong trình cài đặt tự động để cài đặt certbot thay vì acme.sh trên máy chủ mới.
• Thiết lập nhiều máy chủ: MigrationTool có khả năng di chuyển các thiết lập nhiều máy chủ ISPConfig. Mục tiêu của việc di chuyển này có thể là một thiết lập nhiều máy chủ khác hoặc bạn có thể hợp nhất một thiết lập nhiều máy chủ thành một thiết lập máy chủ duy nhất mới. MigrationTool phải được chạy trên từng nút (cũ) của thiết lập Multiserver lần lượt, hệ thống ISPConfig đích có thể là nút chính của thiết lập multiserver mới (sau đó MigrationTool sẽ hiển thị hộp thoại nơi bạn có thể chọn nút mới nào của thiết lập multiserver mà dữ liệu sẽ được di chuyển đến) hoặc máy chủ đơn mới.

Tạo người dùng từ xa trong ISPConfig​

Bạn cần một người dùng từ xa trên máy chủ ISPConfig đích.

Đi tới System -> Người dùng từ xa


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22550%22%20height=%22231%22%3E%3C/svg%3E


Nhấp vào nút Thêm người dùng mới.

Nhập tên người dùng và mật khẩu cho người dùng từ xa, ví dụ: "remoter" và đảm bảo bạn đã chọn tất cả hộp kiểm. Sau đó nhấp vào "lưu".


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22520%22%20height=%22550%22%3E%3C/svg%3E


Nếu bạn đang sử dụng ISPConfig phiên bản 3.1.11 trên máy chủ đích, hãy chỉnh sửa tệp /usr/local/ispconfig/security/security_settings.ini với tư cách là người dùng root:

nano/usr/local/ispconfig/security/security_settings.ini

và thay đổi giá trị của ids_anon_enabled và ids_user_enabled từ 'yes' thành 'no'.

....
[ids]
ids_anon_enabled=no
ids_anon_log_level=1
ids_anon_warn_level=5
ids_anon_block_level=20
ids_user_enabled=no
ids_user_log_level=1
ids_user_warn_level=10
ids_user_block_level=25
ids_admin_enabled=no
ids_admin_log_level=1
ids_admin_warn_level=5
ids_admin_block_level=100
sql_scan_enabled=yes
sql_scan_action=warn
apache_directives_scan_enabled=yes
nginx_directives_scan_enabled=yes
....

IDS có thể được bật lại khi quá trình di chuyển hoàn tất. Nếu bạn sử dụng ISPConfig 3.1.12 hoặc mới hơn, thì không cần thay đổi này.

Tiếp theo, hãy kiểm tra xem mô-đun php-soap đã được cài đặt trên máy chủ đích chưa. Nếu chưa được cài đặt, hãy cài đặt ngay bây giờ. Trên Debian và Ubuntu, bạn có thể cài đặt mô-đun PHP Soap bằng apt:

apt-get install php-soap

Một điều kiện tiên quyết khác là máy chủ đích và máy chủ nguồn phải cài đặt rsync. Vui lòng kiểm tra với ví dụ:

rsync --version

trên cả hai nút rsync được cài đặt. Nếu chưa cài đặt, hãy cài đặt gói rsync của hệ điều hành. Ví dụ: với:

apt-get install rsync

trên Debian và Ubuntu hoặc với:

yum install rsync

trên CentOS.

Trên máy chủ đích, có thể có tệp /etc/ssh/sshd_config.d/custom.conf do trình cài đặt tự động ISPConfig tạo ra, tệp này ngăn công cụ Di chuyển hoạt động. Tệp này phải được xóa nếu nó tồn tại. Chạy lệnh này trên máy chủ đích với tư cách là người dùng root để xóa tệp:

rm /etc/ssh/sshd_config.d/custom.conf

Tất cả các bước sau đây được thực hiện trên máy chủ nguồn trừ khi được yêu cầu khác.

Tải xuống và trích xuất Migration Công cụ​

cd /root
mkdir migration
cd migration
wget https://www.ispconfig.org/downloads/ispconfig_migration_toolkit-latest.zip
unzipispconfig_migration_toolkit-latest.zip
mvispconfig_migration_toolkit/ispc3-migration-tool-*.tar.gz /root/migration/migtool.tar.gz
tar xzf migtool.tar.gz
rm -f migtool.tar.gz

Chuẩn bị đăng nhập không cần mật khẩu (tùy chọn)​

Trong quá trình di chuyển, sẽ có kết nối SSH để chuyển các thiết lập và dữ liệu từ máy chủ nguồn đến máy chủ đích. Để thực hiện được điều này, máy chủ nguồn phải có khả năng kết nối đến máy chủ đích mà không cần mật khẩu.

Bạn có thể:

• Tự thiết lập đăng nhập không cần mật khẩu (thêm khóa công khai của máy chủ nguồn vào tệp authorized_keys của máy chủ gốc đích).
• Hoặc cho phép máy chủ gốc truy cập qua ssh đến máy chủ đích bằng mật khẩu (tạm thời). Sau đó, Công cụ di chuyển sẽ gọi ssh-keygen và ssh-copy-id cho bạn. Đây là các lệnh gọi hệ thống trực tiếp, vì vậy nếu bạn được nhắc nhập mật khẩu gốc ssh của mục tiêu trong bước này, thì Công cụ di chuyển KHÔNG đọc dữ liệu đầu vào, mà là lệnh hệ thống ssh-copy-id nhắc trực tiếp.

Chạy di chuyển (chạy khô)​

./migrate

Nếu bạn muốn chạy công cụ trên phiên bản PHP cụ thể (Ví dụ: PHP 7.4 trên Ubuntu 22.04), hãy sử dụng lệnh này thay vào đó:

PHP=/usr/bin/php7.4 ./migrate

Kết quả của bất kỳ lệnh nào ở trên sẽ như thế này:

Welcome to the ISPConfig3 Migration Tool V2 Version 2.0.0
Although this tool does not alter anything on the source server, you should
ALWAYS make a BACKUP of all your data before migrating to a new server!
You need to have some prerequisites set up to use this tool: * create an remote user (system -> remote users) in your TARGET ISPConfig3 system and grant ALL rights to it * make sure this (the SOURCE system) can reach the remoting api of the TARGET system
*** Disclaimer of Warranties ***
ISPConfig disclaims to the fullest extent authorized by law any and all other warranties, whether express or implied,
including, without limitation, any implied warranties of title, non-infringement, integration, merchantability or
fitness for a particular purpose.
By continuing to use this software, you agree to this.
First of all the most important question:
Do you want to make a real migration or a dry run? (dry, migrate): dry

Trước tiên, chúng ta muốn chạy ở chế độ chạy thử, vì vậy chúng ta nhập dry ở đây.

The following modules are available: 1. Confixx to ISPConfig 3 migrator (confixx) 2. Plesk (10.5 - 17.5) to ISPConfig 3 migrator (plesk) 3. ISPConfig 2 to 3 migrator (ispconfig2) 4. ISPConfig 3 to ISPConfig 3 migrator (ispconfig3)
Which one is the one matching your SOURCE system? (confixx, plesk, ispconfig2, ispconfig3): ispconfig3

Công cụ di chuyển cần biết bạn đang sử dụng bảng điều khiển nào trên máy chủ nguồn của mình. Công cụ này cố gắng nhận dạng mô-đun cần thiết trên máy chủ nguồn, vì vậy thông thường bạn chỉ cần nhấn ENTER.

Enter this (SOURCE) server's ip that is used for outgoing connections [192.168.10.10]: 123.123.123.123

Công cụ di chuyển cần biết địa chỉ IP nào trên máy chủ nguồn được sử dụng cho các kết nối đi, tức là địa chỉ IP nào mà các máy chủ khác sẽ thấy khi nguồn kết nối với chúng. Công cụ này cố gắng đoán địa chỉ IP nhưng bạn có thể cần thay đổi giá trị nếu bạn đang sử dụng mạng riêng chẳng hạn.

Name of the remote user of TARGET ISPConfig3 system []: remoterPassword for this remote user []: yourremotepasswordURL to the remote system (e. g. https://yourdomain.com:8080/remote/) []: https://www.example.com:8080/remote/You gave me remote user 'remoter' with password 'yourremotepassword'
And I shall connect to 'https://www.example.com:8080/remote/'
Is this correct? (y, n): y

Cung cấp cho Công cụ di chuyển dữ liệu của người dùng từ xa mà bạn đã tạo trên mục tiêu và xác nhận đầu vào của bạn bằng "y". Sau đó, Công cụ di chuyển sẽ cố gắng kết nối với API từ xa của hệ thống mục tiêu của bạn.

I will now have to make some changes in your ISPConfig3 TARGET system config. 1.) Enable domain module if needed 2.) Remove client prefixes (will be undone automatically at the end) 3.) Enable login for mail accounts if needed
Testing MySQL connection ... OK
What is the main public(!) ip of the target server www.example.com? [123.123.123.123]: [ENTER]

Công cụ di chuyển sẽ thay đổi một số thiết lập ISPConfig trên mục tiêu (những thay đổi này sẽ không được thực hiện khi chạy ở chế độ chạy thử) và kiểm tra kết nối với máy chủ MySQL. Công cụ này cố gắng đoán thông tin xác thực MySQL bằng cách xem một số tệp hệ thống nhưng cuối cùng, bạn sẽ được nhắc nhập mật khẩu gốc MySQL.

Tiếp theo, bạn cần cung cấp IP công khai của máy chủ mục tiêu. Nó sẽ được lấy trước từ DNS, nhưng bạn có thể cần phải điều chỉnh nó, đặc biệt là nếu bạn sử dụng cùng một tên máy chủ trên nguồn và đích.

Do you want me to overwrite/update existing entries with the same name? (y, n): yYou can now set entry names, that shall NOT be overwritten.
You should use this if you plan to import several server's data to a multi-server installation.
If this tool finds a name that is already present, it UPDATES the data with the SOURCE data!
If this tool finds a name that you marked as not to overwrite, it either - appends a _2, _3 etc. to this name and creates a new entry, or - prepends a server prefix if specified by --server-prefix argument

Công cụ di chuyển cho phép hợp nhất nhiều máy chủ thành một đích. Khi thực hiện việc này, có thể có những tên người dùng xung đột trên các máy chủ nguồn, ví dụ: nếu bạn có hai cơ sở dữ liệu có tên "testdatabase". Nếu bạn trả lời "y" cho câu hỏi này, thì cơ sở dữ liệu thứ hai sẽ thay thế cơ sở dữ liệu đầu tiên. Nếu bạn trả lời "n" thì nó sẽ đổi tên cơ sở dữ liệu thứ hai thành "testdatabase_2".

Hãy chắc chắn trả lời "y" khi thực hiện di chuyển máy chủ đơn lẻ vì nếu không, bạn sẽ tạo ra các bản sao nếu chạy công cụ di chuyển nhiều lần trên cùng một nguồn.

You currently have 0 FTP username name(s) marked:
You can now add further names to this list. Just enter them one by one or provide a comma-separated list.
To delete one or more names from the list, prepend a /DELETE to your input.
To clear all names from the list, type /CLEAR.
A blank input proceeds to the next step.
Your choice : [ENTER]

Công cụ di chuyển cho phép bạn đánh dấu một số tên người dùng cho FTP, cơ sở dữ liệu, máy khách, v.v. là "đã đặt trước". Điều này có nghĩa là chúng sẽ không bị ghi đè như đã đề cập trong phần trên. Thông thường, bạn sẽ để trống mục này, nhưng trong một số trường hợp, bạn có thể ngăn không cho nhập các tên người dùng như "admin" hoặc "administrator". Vì vậy, bạn có thể nhập chúng ở đây, điều này sẽ dẫn đến việc đổi tên các tên đã nhập thành "admin_2" v.v.

Câu hỏi được lặp lại cho các loại dịch vụ khác nhau (FTP, cơ sở dữ liệu, máy khách, người dùng email).

What is the database name of your SOURCE ISPConfig 3 installation? [dbispconfig]: [ENTER]

Bây giờ, công cụ sẽ yêu cầu tên cơ sở dữ liệu trên máy chủ nguồn lưu trữ dữ liệu của bảng điều khiển. Vui lòng kiểm tra xem cơ sở dữ liệu được nhận dạng có đúng không và thay đổi nếu cần.

Do you want to migrate only some services or everything?
Valid services are: client, web, mail, ftp, database, cronjob, dns, billing
Please enter one or more services (comma-separated) or leave blank for all: [ENTER]

Công cụ di chuyển mới chỉ có thể di chuyển một tập hợp con các dịch vụ, ví dụ: chỉ di chuyển tài khoản email và bỏ qua trang web, v.v.

Chúng tôi muốn di chuyển tất cả các dịch vụ nên chúng tôi chỉ để trống mục nhập và nhấn ENTER.

To copy over web data, I need SSH access to the target webserver.
Please make sure that root login via SSH is allowed. On the target open /etc/ssh/sshd_config
and set PermitRootLogin to yes or without-password.
You can revert this once the migration is complete.
What is the ip for the target web server to connect via SSH? [123.123.123.123]: [ENTER]What is the SSH port? [22]: [ENTER]

Để sao chép dữ liệu web, email và db, Công cụ di chuyển yêu cầu quyền truy cập SSH không cần mật khẩu vào máy chủ đích. Bạn cần cung cấp ip và cổng mà nguồn sẽ kết nối tới. Nếu bạn chưa thiết lập quyền truy cập không cần mật khẩu, bạn sẽ được nhắc nhập mật khẩu SSH gốc của máy chủ đích.

Testing MySQL connection ... OK
Starting API calls.
[50/74]  processing mydomain.com

Bây giờ, công cụ sẽ bắt đầu tạo/cập nhật tất cả các mục nhập trên ISPConfig đích. Tất nhiên, khi chạy thử, nó sẽ không thay đổi hoặc sao chép bất kỳ mục nào. Chờ các lệnh gọi API hoàn tất.

Processing of entries done.
=============
Migration tool run completed.

Sau khi công cụ di chuyển hoàn tất quá trình chạy thử mà không có lỗi, chúng ta có thể tiếp tục di chuyển thực sự.

Chạy di chuyển​

./migrate

Nếu bạn muốn chạy công cụ trên một phiên bản PHP cụ thể (Ví dụ: PHP 7.4 trên Ubuntu 22.04), thì hãy sử dụng lệnh này thay thế:

PHP=/usr/bin/php7.4 ./migrate

Kết quả của bất kỳ lệnh nào ở trên sẽ như thế này:

Welcome to the ISPConfig3 Migration Tool V2 Version 2.0.0rc2
Although this tool does not alter anything on the source server, you should
ALWAYS make a BACKUP of all your data before migrating to a new server!
You need to have some prerequisites set up to use this tool: * create an remote user (system -> remote users) in your TARGET ISPConfig3 system and grant ALL rights to it * make sure this (the SOURCE system) can reach the remoting api of the TARGET system
*** Disclaimer of Warranties ***
ISPConfig disclaims to the fullest extent authorized by law any and all other warranties, whether express or implied,
including, without limitation, any implied warranties of title, non-infringement, integration, merchantability or
fitness for a particular purpose.
By continuing to use this software, you agree to this.
First of all the most important question:
Do you want to make a real migration or a dry run? (dry, migrate): migrate

Lần này, chúng ta trả lời lời nhắc bằng "di chuyển" và trả lời các câu hỏi giống như chúng ta đã làm trong quá trình chạy thử. Công cụ sẽ điền sẵn dữ liệu đầu vào từ bản chạy thử, do đó, về cơ bản, bạn có thể nhấn ENTER.

Testing MySQL connection ... OK
Copying Let'sEncrypt files to target ... OK
Starting API calls.
[9/11]  processing [emailprotected] (web213p41)

Lần này, quá trình sẽ mất nhiều thời gian hơn vì có các lệnh gọi API thực sự đang được thực hiện. Chờ quá trình hoàn tất.

Processing of entries done.
Target ISPConfig job queue has 35 entries left. Waiting ..

Để đảm bảo tất cả các đường dẫn được tạo trên đích, Công cụ di chuyển sẽ đợi ISPConfig xử lý tất cả các yêu cầu trước khi tiếp tục.

[INFO] Target ISPConfig job queue has completed. Continuing.
[19/935] Syncing /var/www/clients/client26/web21/web to /var/www/clients/client1424/web21/

Bây giờ công cụ sẽ đồng bộ hóa tất cả các đường dẫn (web, thư) và sao chép nội dung cơ sở dữ liệu vào máy chủ đích. Quá trình này có thể mất một thời gian tùy thuộc vào lượng dữ liệu bạn có.

Nếu bạn muốn thực hiện đồng bộ hóa dữ liệu thực tế trong một bước riêng, bạn có thể bỏ qua bằng cách chạy ./migrate --no-syncjobs thay vì chỉ chạy ./migrate

Các bước cuối cùng​

Công cụ di chuyển sẽ đặt lại các giá trị đã thay đổi lúc đầu (ví dụ: tiền tố máy khách).

Tùy thuộc vào bảng điều khiển nguồn của bạn, Công cụ di chuyển sẽ kích hoạt mô-đun tên miền trên ISPConfig mục tiêu của bạn. Điều này có nghĩa là tên miền chỉ có thể được sử dụng cho các trang web, tên miền email, v.v. nếu chúng đã được quản trị viên chỉ định trước (sử dụng Máy khách -> Tên miền). Nếu bạn không muốn sử dụng mô-đun tên miền, bạn có thể tắt mô-đun này trong Hệ thống -> Cài đặt giao diện -> Tab "Domains".

Cuối cùng, hãy kiểm tra migrate.log đã tạo cho các mục có dấu [ERROR] hoặc [WARNING]. Những dấu này chỉ ra sự cố trong quá trình di chuyển.

Đồng bộ lại mục tiêu của bạn​

Đồng bộ lại tài khoản và cài đặt​

Nếu mọi thứ thay đổi trên bảng điều khiển nguồn sau khi bạn thực hiện di chuyển, bạn chỉ cần chạy lại. Công cụ di chuyển sẽ cập nhật tất cả các mục bằng các cài đặt mới từ máy chủ nguồn của bạn. Và thêm các mục mới được tạo trong thời gian đó. Các mục đã xóa trên nguồn sẽ không bị xóa trên mục đích!.

Đồng bộ lại dữ liệu​

Nếu bạn chỉ muốn đồng bộ lại dữ liệu cho web, email và cơ sở dữ liệu, bạn có thể chạy ./migrate --syncjobs. Thao tác này sẽ bỏ qua tất cả các bước di chuyển và chỉ chạy đồng bộ hóa các trang web, cơ sở dữ liệu và email.

Bạn cũng chỉ có thể đồng bộ lại một trong các dịch vụ, ví dụ: ./migrate --syncjobs --only=database. Thao tác này sẽ bỏ qua việc đồng bộ lại dữ liệu trang web và email.

Tùy chọn nâng cao​

Để có danh sách các tùy chọn nâng cao cho phép di chuyển, ví dụ: các trang web đơn lẻ, tên miền email hoặc máy khách, hãy sử dụng tùy chọn --help.

./migrate --help

Các tùy chọn hiện tại là:

Usage: migrate  List of options: --help Show this screen --server-prefix=
 Use given prefix for conflicting usernames, if further
conflicts occur, add _2 _3 _4 ... to username --source-temp-dir= Set a different temp directory for actions on the source
server than /tmp --target-temp-dir= Set a different temp directory for actions on the target
server than /tmp --syncjobs Don't run the migration process, just re-sync all data
(web files, database contents) --no-syncjobs Only do the migration, don't copy any data files or
database contents to target --ignore-sync-errors Don't abort syncjobs processing if an error occurs. This
can be helpful for example if a command like chattr does not work correctly on the
target server. --confixx-no-domain On a confixx migration (source server) do not create a
dummy website that contains all other domains of that client as alias domains. Confixx uses a different approach for storing and
managing domains, so there is no "main" domain, but a hosting instead, that has all
domains assigned. On confixx servers where clients only have a single
domain it can be better to not create a dummy website with a single alias, but use the
domain as website instead. --only=client|web|mail|ftp|database|cronjob|dns|billing Only migrate the given service(s) and skip the others.
Can be provided multiple times. --exclude=client|web|mail|ftp|database|cronjob|dns|billing Migrate all services but the given one(s). Can be
provided multiple times. --only=/--exclude= on --syncjobs run When limiting the resync to single services, only web,
mail, database, system are valid. --only-client= Only migrate a single client and it's data (web, mail
etc.). This can be used together with --only= / --exclude= to limit the migrated data
even further. --only-web= Only migrate the given domain and it's assigned
databases, ftp accounts etc. This can be used together with the other
--only-x/--exclude-x and --only=/--exclude= options to specify the data to be migrated. --only-mail= Only migrate the given mail domain and it's assigned
mail accounts, spam filter etc. This can be used together with the other
--only-x/--exclude-x and --only=/--exclude= options to specify the data to be migrated. --only-database= Only migrate the given database and it's parent website. This can be used together with the other
--only-x/--exclude-x and --only=/--exclude= options to specify the data to be migrated. --only-dns= Only migrate the given DNS zone and it's assigned DNS
records. The above options can also be used in the opposite way,
using --exclude-client, --exclude-web, --exclude-mail, --exclude-database, --exclude-dns WARNING! Clients ALWAYS have to be migrated otherwise
you will have all migrated data assigned to the admin user instead of the client!