Troubleshooting

Resolving Issues with the Registration of OBAS Source Systems

Common Issues

Issue: The migration manager could not connect to 'domain.name' via the SSH protocol. Ensure that the server is up and that there are no firewall rules that may block SSH connection to the server.

Resolution:

Issue: The migration manager could not connect to 'domain.name' via the SMB protocol. Ensure that the server is up and that the SMB service is operating on the Windows server.

Resolution:

Issue: The following services are not running: <a list of services>. Please start them.

Resolution:

To start the services, execute the following command on the source server for each service listed in <list>:

Plesk Issues

Issue: The system could not connect to the Plesk XML API {PLESK_API_URL} on the server {HOSTNAME}. Check whether the firewall allows connections to the port 8443.

Resolution: Make sure that the TCP port 8443 is accessible on the source system. You can do so by executing the following command in the server console, on the host where the migration tool is installed:

[root@server1 ~]# </dev/tcp/{HOSTNAME}/8443 && echo OK || echo FAILED

OK

or

[root@server1 ~]# nc -vw5 {HOSTNAME} 8443

Ncat: Version 6.40 ( http://nmap.org/ncat )

Ncat: Connected to {HOSTNAME}:8443.

If the port is not accessible, run the following command on the source system:

[root@server1 ~]# iptables -A INPUT -p tcp --dport 8443 -j ACCEPT

Issue: The system could not connect to the Plesk XML API {PLESK_API_URL} on the server {HOSTNAME}.

Resolution:

Check whether all services critical for migration are running. (They are listed in the Readiness for migration section.)

The services that are critical for migration are listed below.

If any of these services are not running, start them as described in the knowledge base articles.

Issue: The license key for Plesk on the source node is invalid.

Resolution: Migration is possible only if a valid Plesk license is installed on the source Plesk server. To resolve issues with a Plesk license, log in to Plesk as admin and check the license key's expiration date:

If the key expiration date is in the future, check the system's date and time by running the date command in the Linux shell or date /T in the Windows console. If they are incorrect, correct them.

If the key expiration date is in the past, it means that the key is expired. Refer to this article for further troubleshooting: https://kb.plesk.com/115731.

Issue: Microsoft .NET Framework version 4 is not installed.

Resolution:

Plesk Migration Agent for Windows requires Microsoft .NET Framework 4 installed on the source server. To install Microsoft .NET Framework 4, follow the instructions at https://www.microsoft.com/en-us/download/details.aspx?id=17851.