Skip to content

Commit 6c991b2

Browse files
authored
Update subscription-exists-linux-containers-transactional.md
Edit review per CI 8115
1 parent ee5e8d0 commit 6c991b2

1 file changed

Lines changed: 11 additions & 10 deletions

File tree

support/sql/database-engine/replication/subscription-exists-linux-containers-transactional.md

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -6,36 +6,37 @@ ms.custom: sap:Replication, Change Tracking, Change Data Capture\Errors or unexp
66
ms.date: 11/03/2025
77
---
88

9-
# Configuring transactional replication on multiple SQL Server Linux containers fails
9+
# Configuring transactional replication fails on multiple SQL Server Linux containers
1010

11-
This article provides troubleshooting guidance for an issue that might occur when configuring two SQL Servers running in Linux containers on the same machine as replication subscribers.
11+
This article provides troubleshooting guidance for an issue that occurs when you configure two Microsoft SQL Server-based servers that run in Linux containers on the same computer as replication subscribers.
1212

1313
## Symptoms
1414

15-
When configuring **Transactional Replication** on SQL Server 2022 running in Linux containers, you might encounter the following error message:
15+
When you configure **Transactional Replication** on SQL Server 2022 running in Linux containers, you receive the following error message:
1616

1717
> The subscription already exists.
1818
1919
This issue usually occurs when:
2020

21-
- Two SQL Server instances are hosted in separate containers on the same Linux machine.
21+
- Two SQL Server instances are hosted in separate containers on the same Linux-based computer.
2222
- Both instances are added as subscribers to the same publisher.
2323
- The connection strings use the same hostname but different port numbers (for example, `LINUXHOST,5455` and `LINUXHOST,5465`).
2424

2525
## Cause
2626

27-
The issue occurs because subscriber metadata doesn't honor port numbers during persistence. Only the hostname is stored, causing the second subscriber to be seen as a duplicate of the first.
28-
This behavior is specific to Linux container environments where named instances don't exist and connections rely on hostname and port mapping.
27+
This issue occurs because subscriber metadata doesn't honor port numbers during persistence. Only the hostname is stored. This behavior causes the second subscriber to be seen as a duplicate of the first.
28+
29+
This behavior is specific to Linux container environments in which named instances don't exist and connections rely on hostname and port mapping.
2930

3031
## Workaround
3132

32-
To successfully add multiple subscribers on the same machine but in different containers, follow these steps:
33+
To successfully add multiple subscribers on the same computer but in different containers, follow these steps:
3334

3435
1. Install [Cumulative Update 20 (CU20) for SQL Server 2022](https://www.catalog.update.microsoft.com/Search.aspx?q=KB5059390).
3536

3637
1. Enable trace flag [15005](/sql/t-sql/database-console-commands/dbcc-traceon-trace-flags-transact-sql#tf15005). This trace flag enables using a subscriber with a nondefault port for transactional replication.
3738

38-
1. Perform the following manual cleanup and configuration steps in Transact-SQL. Replace the `@hostname`, `@port_sub1`, `@port_sub2`, `@PublicationName`, `@SubscriberDb_Sub1`, and `@SubscriberDb_Sub2` variables with values specific to your environment:
39+
1. Perform the following manual cleanup and configuration steps in Transact-SQL. In this script, replace the `@hostname`, `@port_sub1`, `@port_sub2`, `@PublicationName`, `@SubscriberDb_Sub1`, and `@SubscriberDb_Sub2` variables with values that are specific to your environment:
3940

4041
```sql
4142
DECLARE @hostname AS SYSNAME = 'LinuxSubscriberHostName',
@@ -166,9 +167,9 @@ To successfully add multiple subscribers on the same machine but in different co
166167

167168
## Resolution
168169

169-
Currently, no permanent fix is available. Use the previous [workaround](#workaround).
170+
Currently, no permanent fix is available. Instead, see the ["Workaround"](#workaround) section.
170171

171-
The product team is evaluating potential fixes for future releases. This article will be updated when a permanent fix is available.
172+
The product team is evaluating potential fixes for future releases. This article will be updated when a solution becomes available.
172173

173174
## Related content
174175

0 commit comments

Comments
 (0)