Een repeater activeren

Als u de repeaterverbinding wilt activeren, start u meestal eerst de server en start u vervolgens de repeater en start u vervolgens de client.

Het is ook mogelijk om eerst de repeater en vervolgens de server te starten. Maar tenzij u de clicon parameter gebruikt om een omgekeerde verbinding tot stand te brengen, moet de client altijd als laatste worden gestart.

Belangrijk

Er zijn belangrijke beveiligingsoverwegingen bij het gebruik van externe foutopsporing. Zie Security During Remote Debugging and Security Considerations for Windows Debugging Toolsvoor meer informatie, waaronder informatie over het inschakelen van de beveiligde modus.

Stap 1: de server starten

De server kan een foutopsporingsserver, een processerver of een KD-verbindingsserver zijn. U start dit zoals u normaal zou doen, behalve dat de transportprotocolinstellingen worden gebruikt om verbinding te maken met de repeater, niet de client. Zie Een foutopsporingsserver activeren, een processerver activerenof een KD-verbindingsserver activerenvoor meer informatie.

Als u een wachtwoord gebruikt bij het maken van de server, is dit wachtwoord vereist wanneer de client wordt gekoppeld, maar niet wanneer de repeater wordt gemaakt.

Als u de verborgen parameter gebruikt, wordt de server zoals gebruikelijk verborgen. De repeater zelf is altijd verborgen.

Stap 2: de repeater starten

De repeater die is opgenomen in Hulpprogramma's voor foutopsporing voor Windows, heet DbEngPrx (dbengprx.exe).

DbEngPrx begrijpt de volgende transportprotocollen: named pipe (NPIPE), TCP en COM-poort.

Als uw client en server gebruikmaken van het SSL-protocol (Secure Sockets Layer), moet u het TCP-protocol voor de repeater gebruiken. Als uw client en server het SPIPE-protocol (Secure Pipe) gebruiken, moet u het NPIPE-protocol voor de repeater gebruiken. De repeater geeft alle gegevens door die worden ontvangen. De gegevens worden niet geïnterpreteerd, versleuteld of ontsleuteld. Alle versleuteling en ontsleuteling worden uitgevoerd door de client en de server.

De syntaxis voor de DbEnPrx-opdrachtregel is als volgt:

dbengprx [-p] -cClientTransport-sServerTransport

De parameters in de vorige opdrachten hebben de volgende mogelijke waarden:

-p
Zorgt ervoor dat DbEngPrx blijft bestaan, zelfs nadat alle verbindingen met de database zijn verbroken.

ClientTransport-
Hiermee geeft u de protocolinstellingen die moeten worden gebruikt bij het maken van verbinding met de server. Het protocol moet overeenkomen met het protocol dat wordt gebruikt toen de server werd gemaakt. De protocolsyntaxis zijn als volgt:

npipe:server=Server,pipe=PipeName[,password=Password] 
tcp:server=Server,port=Socket[,password=Password][,ipversion=6] 
tcp:clicon=Server,port=Socket[,password=Password][,ipversion=6] 
com:port=COMPort,baud=BaudRate,channel=COMChannel[,password=Password] 

De protocolparameters hebben de volgende betekenissen:

Server
Dit is de netwerknaam of het IP-adres van de computer waarop de server is gemaakt. De twee eerste backslashes (\) zijn optioneel.

pipe=PipeName
Als het NPIPE- of SPIPE-protocol wordt gebruikt, is PipeName de naam die aan de pijp is gegeven toen de server werd gemaakt.

poort=Socket-
Als TCP- of SSL-protocol wordt gebruikt, is Socket hetzelfde poortnummer dat is gebruikt toen de server werd gemaakt.

clicon
Hiermee geeft u op dat de server probeert verbinding te maken met de repeater via een omgekeerde verbinding. ClientTransport moet clicon gebruiken als en alleen als de server clicongebruikt. In de meeste gevallen wordt de repeater gestart vóór de server wanneer een omgekeerde verbinding wordt gebruikt.

-poort=COMPort-
Als het COM-protocol wordt gebruikt, geeft COMPort- de COM-poort op die moet worden gebruikt. Het voorvoegsel 'COM' is optioneel, bijvoorbeeld zowel 'com2' als '2'.

baud=BaudRate
Als het COM-protocol wordt gebruikt, moet BaudRate- overeenkomen met de baudrate die is gekozen toen de server werd gemaakt.

channel=COMChannel-
Als het COM-protocol wordt gebruikt, moet COMChannel- overeenkomen met het kanaalnummer dat is gekozen toen de server werd gemaakt.

wachtwoord=Wachtwoord
Als er een wachtwoord is gebruikt toen de server werd gemaakt, moet Wachtwoord worden opgegeven om de foutopsporingsclient te maken. Deze moet overeenkomen met het oorspronkelijke wachtwoord. Wachtwoorden zijn hoofdlettergevoelig. Als het verkeerde wachtwoord is opgegeven, geeft het foutbericht 'Fout 0x80004005' op.

ipversion=6
(Alleen hulpprogramma's voor foutopsporing voor Windows 6.6.07 en eerder) Dwingt het foutopsporingsprogramma om IP-versie 6 te gebruiken in plaats van versie 4 wanneer u TCP gebruikt om verbinding te maken met internet. In Windows Vista en latere versies probeert het foutopsporingsprogramma automatisch standaard ip-versie 6 te gebruiken, waardoor deze optie niet nodig is.

ServerTransport
Hiermee geeft u de protocolinstellingen op die worden gebruikt wanneer de client verbinding maakt met de repeater. De mogelijke protocolsyntaxis zijn:

npipe:pipe=PipeName[,hidden][,password=Password][,IcfEnable] 
tcp:port=Socket[,hidden][,password=Password][,IcfEnable] 
tcp:port=Socket,clicon=Client[,password=Password] 
com:port=COMPort,baud=BaudRate,channel=COMChannel[,hidden][,password=Password] 

De protocolparameters hebben de volgende betekenissen:

pipe=PipeName
Wanneer het NPIPE- of SPIPE-protocol wordt gebruikt, is PipeName een tekenreeks die fungeert als de naam van de pijp. Elke pijpnaam moet een unieke repeater identificeren. Als u een pijpnaam opnieuw probeert te gebruiken, wordt er een foutbericht weergegeven. PipeName- mag geen spaties of aanhalingstekens bevatten. PipeName kan een numerieke printf-style format code bevatten, zoals %x of %d. De repeater vervangt dit door de proces-id van DbEngPrx. Een tweede dergelijke code wordt vervangen door de thread-id van DbEngPrx.

poort=Socket-
Wanneer TCP- of SSL-protocol wordt gebruikt, is Socket het poortnummer van de socket.

Het is ook mogelijk om een bereik van poorten op te geven, gescheiden door een dubbele punt. DbEngPrx controleert elke poort in dit bereik om te zien of deze gratis is. Als er een gratis poort wordt gevonden en er geen fout optreedt, wordt de repeater gemaakt. De client moet de werkelijke poort opgeven die wordt gebruikt om verbinding te maken met de repeater. Als u de werkelijke poort wilt bepalen, zoekt u naar de repeater; wanneer deze repeater wordt weergegeven, wordt de poort gevolgd door twee getallen gescheiden door een dubbele punt. Het eerste getal is de werkelijke poort die wordt gebruikt; de tweede kan worden genegeerd. Als de poort bijvoorbeeld is opgegeven als poort=51:60en poort 53 daadwerkelijk is gebruikt, worden in de zoekresultaten 'port=53:60' weergegeven. (Als u de clicon parameter gebruikt om een omgekeerde verbinding tot stand te brengen, kan de client op deze manier een bereik van poorten opgeven, terwijl de repeater de werkelijke gebruikte poort moet opgeven.)

clicon=Client-
Wanneer TCP- of SSL-protocol wordt gebruikt en de clicon parameter is opgegeven, wordt er een omgekeerde verbinding geopend. Dit betekent dat de repeater verbinding probeert te maken met de client, in plaats van de client de contactpersoon te laten initiëren. Dit kan handig zijn als u een firewall hebt die een verbinding in de gebruikelijke richting verhindert. Client de netwerknaam of het IP-adres van de computer waarop de client bestaat of wordt gemaakt. De twee eerste backslashes (\) zijn optioneel.

Aangezien de repeater op zoek is naar één specifieke client, kunt u niet meerdere clients verbinden met de repeater als u deze methode gebruikt. Als de verbinding wordt geweigerd of verbroken, moet u de repeater opnieuw starten.

Wanneer clicon wordt gebruikt, kunt u de client het beste starten voordat de repeater wordt gemaakt, hoewel de gebruikelijke volgorde (repeater vóór client) ook is toegestaan.

-poort=COMPort-
Wanneer het COM-protocol wordt gebruikt, geeft COMPort de COM-poort op die moet worden gebruikt. Het voorvoegsel 'COM' is optioneel, bijvoorbeeld zowel 'com2' als '2'. U kunt dezelfde COM-poort niet gebruiken in de ClientTransport en de ServerTransport.

baud=BaudRate
Wanneer het COM-protocol wordt gebruikt, geeft BaudRate de baudrate op waarmee de verbinding wordt uitgevoerd. Elke baudrate die wordt ondersteund door de hardware is toegestaan. Als u com-protocol gebruikt in zowel de ClientTransport als de ServerTransport kunt u verschillende baudrates opgeven, maar natuurlijk is de tragere snelheid de limiet voor hoe snel de client en server met elkaar kunnen communiceren.

channel=COMChannel-
Als het COM-protocol wordt gebruikt, geeft COMChannel- het COM-kanaal op dat moet worden gebruikt bij de communicatie met de client. Dit kan elke waarde zijn tussen 0 en 254, inclusief. U kunt één COM-poort gebruiken voor meerdere verbindingen met behulp van verschillende kanaalnummers. (Dit verschilt van het gebruik van com-poorten voor een foutopsporingskabel. In dat geval kunt u geen kanalen binnen een COM-poort gebruiken.)

verborgen
Hiermee voorkomt u dat de server wordt weergegeven wanneer een ander foutopsporingsprogramma alle actieve servers weergeeft.

wachtwoord=Wachtwoord
Vereist dat een client het opgegeven wachtwoord opgeeft om verbinding te maken met de foutopsporingssessie. Wachtwoord kan elke alfanumerieke tekenreeks zijn.

IcfEnable-
Zorgt ervoor dat het foutopsporingsprogramma de benodigde poortverbindingen voor TCP- of benoemde pijpcommunicatie inschakelt wanneer de firewall voor internetverbinding actief is. De firewall voor internetverbinding schakelt standaard de poorten uit die door deze protocollen worden gebruikt. Wanneer IcfEnable wordt gebruikt met een TCP-verbinding, zorgt het foutopsporingsprogramma ervoor dat Windows de poort opent die is opgegeven door de parameter Socket. Wanneer IcfEnable wordt gebruikt met een benoemde pijpverbinding, zorgt het foutopsporingsprogramma ervoor dat Windows de poorten opent die worden gebruikt voor benoemde pijpen (poorten 139 en 445). Het foutopsporingsprogramma sluit deze poorten niet nadat de verbinding is beëindigd.

Stap drie: de client starten

De client moet een foutopsporingsclient of een slimme client zijn, afhankelijk van wat overeenkomt met uw servertype. Zie Een foutopsporingsclient activeren, Een slimme client activerenof een slimme client (kernelmodus) activerenvoor meer informatie.

Als de server de verbinding weigert (bijvoorbeeld als u een onjuist wachtwoord opgeeft), worden zowel de repeater als de client afgesloten. U moet beide opnieuw opstarten om opnieuw verbinding te maken met de server.