Skip to main content
Version: 0.4 · current

Quickstart: add an availability group

QuickstartReviewed October 11, 2026
Applies to:Excubius 0.4Roles: Entity admin
PlansFree · Pro · EnterpriseDeploymentSelf-hosted

In this quickstart you add a two-replica availability group of Ciguapa Inc. to Excubius and see it on the Overview. It takes about 15 minutes once the monitoring login exists.

Before you begin​

  • The monitoring login exists on every replica with the same SID. See Prerequisites.
  • You are Entity admin on the entity that will hold the group, for example Ciguapa Inc. › Production.
  • The Excubius server reaches the listener and both replicas on the SQL port.

In the examples, the replicas are sql-ventas-01.ciguapa.example and sql-ventas-02.ciguapa.example, and the group is ag-ventas.

1. Store the login once​

A credential stored on Ciguapa Inc. is usable by every resource below it.

  1. Open Settings › Credentials and choose Ciguapa Inc. in the entity picker.
  2. Select Add credential, kind SQL login.
  3. Enter the name sql-monitoring, the user usr_monitoring and the password.
  4. Select Save. The password is encrypted and never shown again.

2. Add each replica as an instance​

  1. Open Resources › Add resource.
  2. Type: SQL Server instance.
  3. Place and name: Ciguapa Inc. › Production, name sql-ventas-01.
  4. Connection: host sql-ventas-01.ciguapa.example, port 1433.
  5. Tags: env:prod, role:sql, client:ciguapa; criticality 4.
  6. Credential: sql-monitoring.
  7. Review, then Create resource.

Repeat for sql-ventas-02.

The default checks of a SQL Server instance are set up at once; the first values arrive within a minute or two.

3. Test the connection​

On the first replica, select Test connection. A successful test shows the server name, version, edition and latency, and lists any missing permission.

ResultMeansFix
authLogin failed, or SQL logins are disabledCheck the password and that the instance accepts SQL logins (mixed mode)
unreachableName, firewall or portCheck DNS and the firewall from the Excubius server
timeoutNo answer in timeCheck the network path and the SQL port
Warning: login is sysadminWorks, but is not least privilegeRecreate the login from Prerequisites

4. Discover the availability group​

On one replica only, select Discover. Discovery reads the server, its availability groups with their replicas, roles and listener, its databases and linked servers, and adds them as child resources with their own checks. Run it again whenever the topology changes; children that disappear are marked missing, never deleted.

5. See it on the Overview​

Open the Overview for Ciguapa Inc.. The ag-ventas card shows the listener, the primary, both replicas with their synchronization health and the databases. Both replicas should read Healthy.

Clean up​

To remove what you added, delete the two instances from Resources; their discovered children, checks, metrics and alerts go with them. Delete the credential last, once nothing uses it.

Next steps​