Migrate SolarWinds Platform products to a new server with a new IP or hostname
Last Updated: November 22, 2022 | Migration Guide
Supports: Orion Platform 2020.2.6 and earlier and SolarWinds Platform 2022.2 and later
When migrating your SolarWinds Platform server to a new server using a new IP or hostname different than the current server, install the product on the new server, move reports, import SSL certificates, reassign nodes, and redeploy agents.
- If upgrading, please review the SolarWinds Installation and Upgrade Guide and the release notes for your products and complete the upgrades before starting a migration.
- If you are migrating to a new server using the same IP and hostname, see this article.
How do I migrate?
Task 1: Prepare the new server for the SolarWinds Platform server
Migrating the SolarWinds Platform database, NTA Flow Storage database, or both? Complete the database migration before migrating your SolarWinds Platform products.
1. Prep new hardware for the migration |
Build the new server including any changes to the architecture, hardware, and Operating System. Review the SolarWinds Platform requirements, in multi-module guidelines, and requirements for your product (see release notes and admin guides). Product requirements include:
For all port requirements, see Port Requirements for all SolarWinds products. |
|
2. Gather credentials | Gather the local admin credentials for the current and new server. | |
3. Get SolarWinds installation files | Download the SolarWinds product installation files from the Customer Portal. Copy the files to the new server. |
Task 2: Migrate your product to the new server
Depending on the products you migrate, you may have different steps to take such as transferring SSL certificates, redeploying agents, and moving files.
Note on Capitalization: Queries are case sensitive for the stored values in the database. Check the stored value capitalization prior to running queries in these steps. If a stored values for a hostname is in ALL CAPS, CamelCase, or all lower case, you must match the capitalization in your query.
1. Delete your High Availability pools (Optional) | If your server is a member of an HA pool, delete the pool. | |
2. Release the product license |
Release the product license on the original server. Use the web-based License Manager when migrating your main SolarWinds Platform server.
If you are offline, save the deactivation receipt file, and then upload the deactivation file:
|
|
3. Stop the SolarWinds High Availability Service | If HA is installed, go to services.msc and stop the SolarWinds.HighAvailability.Service on the old server. | |
4. Stop SolarWinds Platform services | Stop services on the original polling server. You can leave the original server running. | |
5. Back up your database |
Back up your current database before migration. If your SQL database is on a VM, create a snapshot of the VM. If your SQL database is on a server, you can use SQL Management Studio Express for your specific version of Microsoft SQL on your SolarWinds Platform database server. See the Microsoft article Create a Full Database Backup for details (©2019 Microsoft, available at https://www.microsoft.com, obtained on October 10, 2019). Use the following links to download the installation for the latest version, which is backward compatible with older versions:
SFTP users created do not get carried over to the new App server, and you should also backup your SFTP_Root folder as well. |
|
6. Back up files (Optional) |
(Optional) If you have legacy reports (Orion Platform 2020.2.6 or earlier), back up the reports folder to save your custom reports:
For NCM, you may need to back up the following folders (found in C:\Program Files\SolarWinds\Orion\NCM or C:\Program Files (x86)\SolarWinds\Orion\NCM):
|
|
7. Install products |
Unzip and install the new SolarWinds Platform Agent product. Do not run the Configuration wizard. If it launches automatically, cancel the wizard. If you migrate as part of an upgrade, follow the upgrade path for your upgrades. Depending on the upgrade path and requirements for new product versions, you may need to migrate to new servers and OS before upgrading SolarWinds Platform products. Need more information? Check our SolarWinds Platform Products Installation and Upgrade Guide. |
|
8. Update references to the old server and remove HA entries |
Replace all references to the old server with the new server name. You must use the NetBIOS short names to the old and new servers to complete this step. Run the hostname command from the command line to confirm the server names. If you have decommissioned the old server completely, look in the Engines table for this information.
|
|
9. Run the Configuration wizard |
Run the Configuration wizard on the new server and restart all SolarWinds services. What you should do:
Need more information? Check our SolarWinds Platform Products Installation and Upgrade Guide. |
|
10. Restart the SolarWinds Administration service | Restart the SolarWinds.Administration service on all servers in the environment. | |
11. Re-initialize the license store | If you are running Orion Platform 2017.3 and later, re-initialize the license store. | |
12. Enable the product license |
Enable the product license on the new server. Use the web-based License Manager when migrating your main SolarWinds Platform server.
If you are offline, do the following:
|
|
13. Redeploy or reconnect to Agents |
You have multiple options for deploying or reconnecting to existing Agents during a migration. You can:
|
|
14. Copy legacy reports to the server, upgrade report schemas Copy other files as needed (Optional for 2020.2.6 and earlier) |
(Optional for 2020.2.6 and earlier) Copy the reports folder to the same directory as on the old server on the new server: Copy over other files as needed. If you have migrated NCM, you may need to merge folder contents with the following (found in C:\Program Files\SolarWinds\Orion\NCM or C:\Program Files (x86)\SolarWinds\Orion\NCM):
|
|
15. Validate SNMP and WMI requests | Validate all devices are set to allow SNMP and WMI requests from the new web address as appropriate. | |
16. Transfer SSL certificates |
For website SSL certificates, you will need to transfer the certificate to the new server. Review the documentation from your SSL vendor to migrate the certificate. You will need the CSR, private key, and certificate. If you use a self-signed SSL certificate, you must create a new self-signed certificate for the new server IP and hostname. |
|
17. Recreate your High Availability pool |
If your server was an HA pool member, recreate your HA pool. This is for SolarWinds HA, not FailOver Engine HA. For details on SolarWinds HA, see this article. |
|
18. Update PDF engine settings | If you are using a third-party PDF engine to generate PDF reports and upgrade to 2022.4, update the PDF engine settings in the Registry Editor (Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\SolarWinds\Orion\Core\PdfEngineManager). |
Results
In the web console, you should see the node displaying the new IP and host name in Manage Nodes. All polling engines should be assigned to the new server.
Cleaning up
Uninstall the products from your original server to use the server for other needs and products.
Delete the product install zip files to save space.
Troubleshooting
Active Directory login issues
If you experience failures with Active Directory logins, please review the Active Directory login scenarios in the NPM Administrator Guide. You may need to remove an account or account group, and re-add it to Active Directory to successfully login on the new server.
RabbitMQ may require purging
After completing your migration, you may need to complete a purging of RabbitMQ data form the SwisPubSub queue. For details, see this article.
Engine troubleshooting
-
Engines table must contain just 1 primary poller. If still exists, move the nodes assigned to it to existing poller and remove the redundant one.
-
Nodes should not be assigned to an old or not existing engine. Use this query to locate the redundant engine:
SELECT NodeId, Caption, EngineId FROM Nodes WHERE EngineID NOT IN (SELECT EngineID from Engines)
-
Cleanup obsolete entries from OrionServers.
License troubleshooting
-
License server and
JobSchedulerHost
should be located on the Primary engine. Use this query to locate these:SELECT * FROM WebSettings WHERE SettingName IN ('JobSchedulerHost', 'LicensingMainServerName')
If they are not on the Primary engine, update the
JobSchedulerHost
entry and follow the instructions forMigration.exe /promote
on Main poller. -
Check product licenses are correctly assigned to the existing servers. Click Settings > All Settings > License Manager to open the web-based License Manager. If licenses are not assigned to existing servers, select the license and reassign to a new server.
-
Make sure the servers can talk to your new main poller. The licensing server should be accessible via NetBios hostnames. If you are unable to ensure the connection on the DNS side, modify the hosts file (
c:\Windows\System32\drivers\etc\hosts
) with the correct hostname.
The scripts are not supported under any SolarWinds support program or service. The scripts are provided AS IS without warranty of any kind. SolarWinds further disclaims all warranties including, without limitation, any implied warranties of merchantability or of fitness for a particular purpose. The risk arising out of the use or performance of the scripts and documentation stays with you. In no event shall SolarWinds or anyone else involved in the creation, production, or delivery of the scripts be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use of or inability to use the scripts or documentation.