Observability
Change the IP address of Network Collector server in SolarWinds Observability SaaS
This article describes the steps to perform on how to change the IP address of the Windows server hosting a SolarWinds Observability Network Collector and validate that services and agent plugins return to a healthy state afterward.
First published date
Last published date
Overview
You may be required to change the IP address of the Windows server hosting the Network Collector. Schedule this change accordingly during a maintenance window and coordinate with System Administration and Database Administration teams as needed.
Product section
Resolution
Resolution
-
Schedule the change during a maintenance window and coordinate with your System Administration and Database Administration teams as needed.
-
Back up the database before making any changes.
-
If the SQL database is on a virtual machine, a VM snapshot or copy of the VM is acceptable.
-
If not, use SSMS on the Network Collector server and create full backups of these databases:
-
SolarWindsOrion -
SolarWindsOrionLog -
SolarWindsFlowStorage
-
-
Microsoft’s backup guidance is here: Create a Full Database Backup.
-
If SSMS is not installed, use: Install SQL Server Management Studio.
-
-
Record the server’s current IP address before making the change.
-
Open SolarWinds Platform Service Manager and click Shutdown Everything. Confirm that all services under Services stop successfully.
-
In SolarWinds Platform Service Manager, under Dependencies, select SolarWinds Administration Service and click Stop.
-
Open
services.mscand stop these services:-
SolarWinds HighAvailability Service
-
SolarWinds UAMS Client
-
-
Update the Windows server IP address with help from your System Administration team.
-
Open Database Manager, click Add Orion Server, expand
SolarWindsOrion, and double-click any table such asAccountRightsto open a query window.
-
Delete the default query and run the following SQL statement, replacing
newipaddressherewith the new server IP address:
-- Scripts are not supported under any SolarWinds support program or service.
-- 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.
UPDATE dbo.Engines
SET IP = 'newipaddresshere'
-
Click Execute query.
-
Verify the change in Database Manager.
-
Under the
SolarWindsOriondatabase, locateEnginesand double-click it. -
Run the query shown for the
Enginestable and review the Results pane. -
Confirm that the
IPcolumn now shows the new IP address.
-
Run the Configuration Wizard.
-
Open Configuration Wizard.
-
Click Next through the wizard without changing settings and allow it to complete so database connections refresh properly.
-
Return to SolarWinds Platform Service Manager and confirm all SolarWinds services start and remain running.
-
Return to
services.mscand confirm the following services are started and running:
-
SolarWinds HighAvailability Service
-
SolarWinds UAMS Client
-
In SolarWinds Observability SaaS, go to Settings > Agents and locate the Windows server by name or IP. Confirm the Network Collector and its plugins do not show issues.
-
If any issues are found after the IP change, collect Network Collector diagnostic logs for further troubleshooting.
Notes
-
Network Collector uses an embedded SQL Server Express database by default for configuration and temporary data, which is why the database backup and
dbo.Enginesvalidation steps are important for this procedure. -
This procedure is for changing the IP on the existing Network Collector server. If you are performing a High Availability deployment or a database migration to a separate SQL Server, use the official Network Collector HA/database migration workflow instead.
-
Database backup and restore operations should be done with SQL Server Management Studio rather than Database Manager.