Активация повтора

Чтобы активировать подключение повторителя, обычно сначала запустите сервер, а затем запустите повторитель, а затем запустите клиент.

Кроме того, можно сначала запустить повторитель, а затем сервер. Но если вы не используете параметр clicon для установления обратного подключения, клиент всегда должен быть запущен последним.

Важный

При использовании удаленной отладки необходимо учитывать важные аспекты безопасности. Дополнительные сведения о включении безопасного режима см. в разделе Безопасность во время удаленной отладки и вопросы безопасности для средств отладки Windows.

Шаг 1. Запуск сервера

Сервер может быть сервером отладки, сервером обработки или сервером подключения KD. Вы запускаете это, как правило, за исключением того, что параметры протокола транспорта будут использоваться для подключения к повторителеру, а не клиенту. Дополнительные сведения см. в разделе активациисервера отладки, активациисервера обработки или активациисервера подключения KD.

Если при создании сервера используется пароль, этот пароль будет необходим при присоединении клиента, но не при создании повторителя.

Если вы используете скрытый параметр, сервер будет скрыт как обычно. Сам ретранслятор всегда скрыт.

Шаг 2. Запуск повторителя

Повторитель, включенный в средства отладки для Windows, называется DbEngPrx (dbengprx.exe).

DbEngPrx понимает следующие транспортные протоколы: именованный канал (NPIPE), TCP и COM-порт.

Если клиент и сервер используют протокол SSL, следует использовать протокол TCP для повторителя. Если клиент и сервер используют протокол secure pipe (SPIPE), следует использовать протокол NPIPE для повторителя. Повторитель передает все полученные данные. Он не интерпретирует, шифрует или расшифровывает какие-либо данные. Все шифрование и расшифровка будут выполнены клиентом и сервером.

Синтаксис командной строки DbEnPrx выглядит следующим образом:

dbengprx [-p] -cClientTransport-sServerTransport

Параметры в предыдущих командах имеют следующие возможные значения:

-p
Приводит к тому, что DbEngPrx продолжает существовать даже после удаления всех подключений.

ClientTransport
Указывает параметры протокола, используемые при подключении к серверу. Протокол должен соответствовать протоколу, используемому при создании сервера. Синтаксисы протокола приведены следующим образом:

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] 

Параметры протокола имеют следующие значения:

сервера
Это сетевое имя или IP-адрес компьютера, на котором был создан сервер. Два начальных обратных косых шеи (\) являются необязательными.

pipe=PipeName
Если используется протокол NPIPE или SPIPE, PipeName — это имя, которое было присвоено каналу при создании сервера.

port=Socket
Если используется протокол TCP или SSL, сокетов совпадает с номером порта сокета, который использовался при создании сервера.

clicon
Указывает, что сервер попытается подключиться к повторителеру через обратное подключение. ClientTransport должен использовать clicon, если сервер использует clicon. В большинстве случаев повторитель запускается перед сервером при использовании обратного подключения.

порт =COMPort
Если используется протокол COM, COMPort указывает используемый com-порт. Префикс COM является необязательным. Например, допустимы как com2, так и "2".

baud=BaudRate
Если используется протокол COM, BaudRate должен соответствовать скорости baud, выбранной при создании сервера.

канал =COMChannel
Если используется com-протокол, COMChannel должны соответствовать номеру канала, выбранному при создании сервера.

password=Password
Если при создании сервера использовался пароль, необходимо предоставить пароля , чтобы создать клиент отладки. Он должен соответствовать исходному паролю. Пароли чувствительны к регистру. Если указан неправильный пароль, сообщение об ошибке будет указывать "Ошибка 0x80004005".

ipversion=6
(Только средства отладки для Windows 6.6.07 и более ранних версий) Принудительно отладчик использовать IP-адрес версии 6, а не версию 4 при использовании TCP для подключения к Интернету. В Windows Vista и более поздних версиях отладчик пытается автоматически использовать IP-версию 6, что делает этот параметр ненужным.

ServerTransport
Указывает параметры протокола, которые будут использоваться при подключении клиента к повторителем. Возможные синтаксисы протокола:

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] 

Параметры протокола имеют следующие значения:

pipe=PipeName
Если используется протокол NPIPE или SPIPE, PipeName — это строка, которая будет служить именем канала. Каждое имя канала должно определять уникальный повторитель. При попытке повторного использования имени канала появится сообщение об ошибке. PipeName не должны содержать пробелы или кавычки. PipeName может включать числовый код форматирования-style, например %x или %d. Повторитель заменит его идентификатором процесса DbEngPrx. Второй такой код будет заменен идентификатором потока DbEngPrx.

port=Socket
Если используется протокол TCP или SSL, сокетом является номером порта сокета.

Также можно указать диапазон портов, разделенных двоеточием. DbEngPrx проверяет каждый порт в этом диапазоне, чтобы узнать, является ли он бесплатным. Если он находит свободный порт и не возникает ошибок, повторитель будет создан. Клиенту потребуется указать фактический порт, используемый для подключения к повторителеру. Чтобы определить фактический порт, найдите повторитель; При отображении этого повторителя за портом будут следовать два числа, разделенные двоеточием. Первое число будет фактическим используемым портом; Второй можно игнорировать. Например, если порт был указан как port=51:60, а порт 53 фактически использовался, результаты поиска будут отображать "port=53:60". (Если для установки обратного подключения используется параметр clicon , клиент может указать диапазон портов таким образом, а повторитель должен указать фактически используемый порт.)

clicon=клиента
Если используется протокол TCP или SSL и указан параметр clicon clicon, откроется обратное подключение. Это означает, что повторитель попытается подключиться к клиенту, а не позволить клиенту инициировать контакт. Это может быть полезно, если у вас есть брандмауэр, который предотвращает подключение в обычном направлении. клиент указывает сетевое имя или IP-адрес компьютера, на котором существует или будет создан клиент. Два начальных обратных косых шеи (\) являются необязательными.

Так как повторитель ищет один конкретный клиент, вы не можете подключить несколько клиентов к повторителеру, если вы используете этот метод. Если подключение откажется или не работает, необходимо перезапустить повторитель.

Если используется clicon, лучше всего запустить клиент перед созданием повторителя, хотя обычный порядок (повторитель перед клиентом) также разрешен.

порт =COMPort
При использовании com-протокола COMPort указывает используемый com-порт. Префикс COM является необязательным. Например, допустимы как com2, так и "2". Вы не можете использовать тот же COM-порт в ClientTransport и ServerTransport.

baud=BaudRate
Если используется протокол COM, BaudRate указывает скорость выполнения соединения. Разрешена любая скорость baud, поддерживаемая оборудованием. Если вы используете COM-протокол как в ClientTransport, так и в ServerTransport вы можете указать разные скорости работы, но, естественно, более медленная скорость будет ограничением на то, как быстро клиент и сервер могут взаимодействовать друг с другом.

канал =COMChannel
Если используется протокол COM, COMChannel указывает канал COM, используемый при взаимодействии с клиентом. Это может быть любое значение от 0 до 254 включительно. Вы можете использовать один COM-порт для нескольких подключений с использованием разных номеров каналов. (Это отличается от использования COM-портов для отладочного кабеля. В этой ситуации нельзя использовать каналы в com-порту.)

скрытые
Предотвращает отображение сервера, когда другой отладчик отображает все активные серверы.

password=Password
Требует от клиента предоставить указанный пароль для подключения к сеансу отладки. пароль может быть любой буквенно-цифровой строкой.

IcfEnable
Вызывает отладчик включить необходимые подключения портов для tcp или именованного канала связи, если брандмауэр подключения к Интернету активен. По умолчанию брандмауэр подключения к Интернету отключает порты, используемые этими протоколами. Если IcfEnable используется с TCP-подключением, отладчик заставляет Windows открыть порт, указанный параметром сокета . Если IcfEnable используется с именованным подключением к каналу, отладчик заставляет Windows открывать порты, используемые для именованных каналов (порты 139 и 445). Отладчик не закрывает эти порты после завершения подключения.

Шаг 3. Запуск клиента

Клиент должен быть отладчиком или смарт-клиентом, независимо от типа сервера. Дополнительные сведения см. в активацииклиента отладки, активациисмарт-клиента или активациисмарт-клиента (режим ядра).

Если сервер отклоняет подключение (например, если вы указали неверный пароль), то повторитель и клиент завершаются. Вам придется перезапустить оба из них, чтобы восстановить контакт с сервером.