Migrate SolarWinds Orion products to a new server with a new IP and hostname
This guide has been revised to include 2016.2 and later steps supporting the new web-based license manager. Migrating with SolarWinds HA will be documented at a later time.
Last Updated: November 19, 2018 | Migration Guide
This information details how to migrate to a new server using a new IP and hostname different than the current server. You will install the product on the new server, move reports, import SSL certificates, reassign nodes, and redeploy agents.
Use these instructions if you are migrating any SolarWinds products, including NPM, SAM, NCM, and NTA.
If upgrading, please review the SolarWinds Upgrade Guide and the release notes for your products and complete the upgrades before starting a migration.
Be sure to check out this video: How to migrate SolarWinds products to a new server with a new IP and hostname.
Follow instructions according to the SolarWinds product versions you have installed based on the following:
- Orion Platform 2016.1 and earlier: These products include NPM 12.0 and earlier, SAM 6.2.4 and earlier, NCM 7.5 and earlier, NTA 4.2 and earlier, and SRM 6.3 and earlier
- Orion Platform 2016.2. and later: These products include NPM 12.0.1 and later, SAM 6.3 and later, NCM 7.5.1 and later, NTA 4.2.1 and later, and SRM 6.3.1 and later
- SFTP users created do not get carried over to the new App server, and you should also backup your SFTP_Root folder as well.
If you are migrating to a new server using the same IP and hostname, see this article.
Prepare your new server
Before backing up data or installing a product, you must prepare your new server. If you are migrating the SolarWinds Orion SQL database or NTA Flow Storage database, you should plan that database migration with your product migration.
Migrating the Orion SQL database? You need to complete the SQL migration before migrating products.
|1. Prep new hardware for the migration||
Build the new server including any changes to the architecture, hardware, and Operating System.
Review the minimum SolarWinds Orion platform requirements, multi-module guidelines, and specific product requirements (see release notes and admin guides) for your product.
Product requirements include:
For all port requirements, see Port Requirements for all SolarWinds products.
See URLs used by the Orion Platform for a list of URLs to add as exceptions to your firewall.
|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.|
During migration, SolarWinds recommends backing up your database. If you need software to perform database backups and maintenance, you can install SQL Management Studio Express for your specific version of Microsoft SQL on your Orion SQL database server.
Use the following links to download the installation for the latest version, which is backward compatible with older versions:
- SQL Management Studio Express 2017 (©2018 Microsoft, available at https://www.microsoft.com, obtained on October 4, 2018)
Migrate your product to the new server
Follow these step-by-step instructions to install your products to the new server. Depending on the products you migrate, you may have different steps to take such as importing 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.
Orion Platform 2016.2 and later products
In Orion Platform 2016.2 and later (example NPM 12.0.1, SAM 6.3), you must use the web-based License Manager when migrating your main Orion server.
If you are offline, save the deactivation receipt file, and then upload the deactivation file:
Orion Platform 2016.1 and earlier products
In Orion Platform 2016.1 and earlier (example NPM 12.0 and 11.5.3), certain products can deactivate licenses through the product internal licensing tool or the stand-alone License Manager.
If you are offline, you need to then upload the deactivation file:
The deactivated licenses are now available to activate on a new server.
|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 Orion 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 using the SQL Management Studio Express, do the following:
|6. Back up files (Optional)||
(Optional) If you use Report Writer reports (NPM 10.5 and earlier) or still have legacy reports, 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 Orion product.
Do not run the Configuration 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 Orion products.
Need more information? Check our SolarWinds 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 Orion services.
What you should do:
Need more information? Check our SolarWinds Upgrade Guide.
|10. Restart the SolarWinds Administration service||Restart the SolarWinds.Administration service on all servers in the environment.|
|11. Move the license store
Orion Platform 2016.2 - 2017.1
Complete this step if your products are on Orion Platform 2016.2 - 2017.1, such as NPM 12.0.1 and SAM 6.3. If not, continue to the next step.
If you are migrating the main Orion server, you must move the license store.
|12. Re-initialize the license store||If you are running Orion Platform 2017.3 and later, re-initialize the license store.|
|13. Enable the product license||
Enable the product license on the new server.
Orion Platform 2016.2 and later
In Orion Platform 2016.2 and later, you must use the web-based License Manager when migrating your main Orion server.
If you are offline, do the following:
Orion Platform 2016.1 and earlier
In Orion Platform 2016.1 and earlier, certain products can activate licenses through the product internal licensing tool or the stand-alone License Manager.
To activate using the License Manager:
If you are offline, you need to complete a few extra steps:
14. Redeploy or reconnect to Agents
You have multiple options for deploying or reconnecting to existing Agents during a migration. You can:
15. Copy legacy reports to the server, upgrade report schemas
Copy other files as needed
Copy the reports folder to the same directory as on the old server on the new server:
Orion Platform 2016.1 and earlier
You must upgrade the report schemas in the new install. Updating the report schemas allows Report Writer to display and use custom property information.
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):
|16. Validate SNMP and WMI requests||Validate all devices are set to allow SNMP and WMI requests from the new web address as appropriate.|
|17. Transfer your SSL
Generate a new self-signed SSL
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.
|18. Recreate your High Availability pool (Optional)||
(Optional) 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.
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.
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.
Subscriptions table showing original server
This applies to migrations to products running on Orion Platform 2016.1 and earlier. One possible issue that may occur is the original server showing in the subscriptions table of the database. This information is dynamic, created during service startup. If you see old info pointing to the original polling engine in the subscriptions table, change the following:
- In the database, go to the subscriptions table then the column
- Expand out to see hostname or ip of the server: port: subscription.
- If you see the old IP and host name, stop services and run the following SQL query:
DELETE from pendingnotifications DECLARE @oldHostname nvarchar(max) SET @oldHostname = 'Server1' DELETE FROM Subscriptions WHERE EndpointAddress LIKE ('%' + @oldHostname + '%') DELETE FROM SubscriptionTags Where Subscription_Id NOT IN (SELECT Id FROM Subscriptions)
- Restart SolarWinds InformationServiceV3 on the main Orion server.
Results: In the subscriptions table column
endpointaddress, you should see the new host name and IP in the database entries.
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.
Orion Platform 2016.2 migration and upgrade may not start Syslog and Traps Services
After migrating and upgrading an Orion Platform 2016.2 product (such as NPM 12.0.1 and SAM 6.3), Syslog and Traps services would not start and the Manage Nodes section/option in the Web Console is missing. For more information, see this article.
- 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:
SELECT NodeId, Caption, EngineId FROM Nodes WHERE EngineID NOT IN (SELECT EngineID from Engines)
- Cleanup obsolete entries from OrionServers.
- License server and
JobSchedulerHostshould be located on the Primary engine. Use this query to locate:
SELECT * FROM WebSettings WHERE SettingName IN ('JobSchedulerHost', 'LicensingMainServerName')
If they are not on the Primary engine, update the
JobSchedulerHostentry and follow the instructions for Migration.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.
Migrate your integration modules
When you migrate your Orion server to a new hostname and IP address, follow these step-by-step instructions to ensure that any integration module that links your Orion server to a separate SolarWinds application points to the correct server. These steps are performed after you have successfully migrated your Orion server.
If you have not installed an integration module, do not perform these steps.
DPA Integration Module v10.2 and later
|1. Show all DPA servers integrated with the Orion server||
View all DPA servers that are integrated with your Orion server.
2. Update the Orion server name
Update the hostname in the Orion database.
|Restart Orion services||
Open Orion Service Manager and restart the SolarWinds Orion Module Engine service.
DPA Integration Module v9.2 to 10.0.1
|1. Ensure you can reach the Orion server|
Log in to the DPA server and ensure you can reach the new Orion server from the DPA server using the new hostname or IP address by using the ping command.
|2. Update the Orion server name|
Update the Orion server name in the Orion database.
|3. Update the location of the Orion server in DPA|
Update the Orion server name in the DPA database.
|4. Update any Orion subscriptions in DPA|
Update the Orion subscriptions.
|5. Restart DPA||Restart DPA.|