Configure deployed Network Collector for High Availability installation
By default, the Network Collector uses an embedded SQL Server Express to store configuration and temporary data.
To set up High Availability for Network Collector, you need to migrate the database to a separate SQL Server. Both the active and backup Network Collectors use this SQL Server to share configuration and temporary data.
Migrating allows you to keep all relevant configurations. Historical data are not fully preserved, and this is not needed as the metrics, topology data, flows, and other historical data are persisted in the cloud.
SolarWinds provides High Availability on the application level. It is the customer’s responsibility to provide High Availability for the SQL Server.
High Availability Requirements/Prerequisites
-
Network Collector 2024.1 or later
-
A separate MS SQL Server 2022
Recommendations
-
Use SQL Server Authentication with the
sa
login and password to ensure that the SolarWinds Platform can access the SolarWinds Platform database, even if it is hosted remotely on a separate server. -
Use Standard or Enterprise editions of SQL Server 2022 (including installations on Linux).
The Express edition is also supported for the production environment but does not provide the Always On availability groups feature. For the upgrade, only SQL Server 2022 or newer is supported because SQL Server Express 2022 is embedded.
-
For the fresh installation, the Network Collector also supports older versions of SQL Server. The full list of supported SQL versions is:
- SQL Server 2022 (including installations on Linux)
- SQL Server 2019 (including installations on Linux)
- SQL Server 2017 (including installations on Linux)
- SQL Server 2016 SP1 or SP2
-
Support for Microsoft SQL Server Service Packs and Cumulative Updates is assumed unless otherwise noted.
Migrate the embedded SQL version to a new database server
-
Prepare your new database server.
Build the new database server including any changes to the architecture, hardware, and operating system.
-
Stop Network Collector services.
On the server where Network Collector is installed, open the SolarWinds Platform Service Manager application and stop all SolarWinds services.
-
SolarWinds recommends discussing database migrations with a DBA. You should also schedule a maintenance window to migrate, during non-peak hours (recommended), and notify your company when taking services offline to migrate.
-
When you migrate your database, your services are down and not collecting polling data.
-
Back up the SQL database. On the machine where Network Collector is installed, run the SQL Server Management Studio (SSMS) and back up the following databases:
- SolarWindsOrion
- SolarWindsOrionLog
- SolarWindsFlowStorage
-
Restore the database to the new server. Copy and restore the database to the new server, for example using the SQL Management Studio.
-
On the Network Collector, run the Configuration Wizard to update the database connections. Perform the following steps:
-
Run the Configuration Wizard to update the database location.
-
On Database Settings, specify your new database server in the SQL Server field.
-
Select the user with sufficient rights to the migrated database (db_owner) or select a user with privileges to create a new user. Click Next to continue. See SQL permission role requirements on the SolarWinds Platform.
-
To use the currently logged-in user, select Authenticate as currently logged-in user. The user needs to have sufficient privileges.
-
To use a different user, select Switch user (Windows, Azure Active Directory or SQL Server Authentication), provide credentials, and click Next.
-
Select Use an Existing Database and select or type the database name and click Next. When prompted to use the existing database, click Yes.
-
On Database account, specify the account for accessing the database.
SolarWinds recommends that you create a new account to ensure that the SolarWinds Platform has required access to the database.
-
Select Create a New Account and provide a New Account name.
-
Provide and confirm an account Password and click Next.
-
Complete the wizard.
-
Start services. Using the SolarWinds Platform Service Manager, start all services on the Network Collector.
See the Microsoft article Create a Full Database Backup for details.
If you do not have SSMS installed on the Network Collector server, use the following link to download SQL Management Studio: https://learn.microsoft.com/en-us/sql/ssms/download-sql-server-management-studio-ssms?view=sql-server-ver16.
The Network Collector uses the new database on a separate server and is ready for the installation of the High Availability backup server.
Set up High Availability for your Network Collector
-
In SolarWinds Observability SaaS, click Add Data at the top.
-
On the Add Data dialog Intro, click Monitor my on-premise network and infrastructure.
-
Click Add a network device.
-
On Select Network Collector, select Deploy new Network Collector and click Next.
-
On Prepare Ingestion Token, select a token to identify the Agent when sending the data into SolarWinds Observability SaaS and click Next.
-
To create a new token, select Generate New Token and provide a name for the new token.
-
To use an existing token, select Use Existing Token and select a token from the list.
Not sure? See Create a new or use an existing ingestion API token?
-
-
On Security Recommendations, click the boxes to display links to documents (security requirements and license agreement), confirm that you have reviewed them, and click Next to continue.
The Next button becomes available when both check boxes are selected.
-
Review the secure configuration guide and system requirements and confirm that you have reviewed both documents.
-
Review the license and confirm that you have reviewed the document.
-
-
On Credential Selection, specify credentials to be used for accessing the Network Collector web console and click Next:
-
To create a new set of credentials for the admin account, select Create new credentials manually, provide a display name and a password.
-
To generate credentials automatically, select Generate credentials automatically. The credentials will be generated during the installation and saved in
%ProgramData%\Solarwinds\UAMSClient\plugin-storage\network-collector-deployment-plugin\SilentConfigWizardSoc.xml
. -
To select existing credentials, choose Select existing credentials and select a credentials set from the drop-down list.
-
-
On the Install Network Collector screen, select how to install the Network Collector.
Script
-
On Script, consider setting up a host name. Click the Set up host name toggle and type a host name into the provided field. The specified host name is added to the script.
-
Copy the provided script to clipboard, log in to the host to install the Network Collector using and account with administrative privileges and run the copied PowerShell script.
When the installation is complete, it will be indicated in the UI, next to the Status label. You can continue to the Agents page or go to Events to review messages on the silent installation.
Installer
-
On Installer, consider setting up proxy. Click the Set up proxy toggle and provide a proxy for the Agent. See Configure proxy for SolarWinds Observability Agents.The specified proxy is included in the script.
-
Consider setting up a host name. Click the Set up host name toggle and type a host name into the provided field. The specified host name is added to the script.
-
Copy the PowerShell script to clipboard.
-
Download the MSI file.
-
-
Transfer the MSI file to the server you want to use as a backup.
-
Run the copied PowerShell script as Administrator to start the installation wizard.
-
In Installation Type, select High Availability for an existing collector.
-
On Server Connect, provide the IP address or host name of your primary Network Collector server, your user name and password.
-
Paste the API token and complete the installation wizard. For details on completing the installation, see Install the Network Collector.
In case of failover, your Network Collector will switch to the secondary server in the pool. To see details about your High Availability setup in SolarWinds Observability, click Settings > High Availability.