Команда RenameDT

Статья
11/05/2008

Обновлен: Ноябрь 2007

Команда RenameDT используется для изменения имени сервера уровня данных для Team Foundation Server.

Важное примечание.
Для успешного выполнения команды RenameDT должны быть запущены следующие пулы приложений и программы.

Пул приложений Team Foundation Server (пул приложений)

ReportServer (пул приложений)

Примечание.
Управление пулом приложений ReportServer осуществляется в службах IIS для SQL Server 2005, но не для SQL Server 2008.

Службы отчетов SQL Server (программа)

Необходимые разрешения

Для использования команды RenameDT необходимо быть членом группы Администраторы Team Foundation на сервере уровня приложений Team Foundation и группы sysadmin в SQL Server на сервере уровня данных Team Foundation. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.

Примечание.
Даже если вход в систему выполнен с учетными данными администратора, необходимо открыть окно командной строки с повышенными правами, чтобы выполнить эту функцию на сервере под управлением Windows Server 2008. Чтобы открыть командную строку с повышенными правами, нажмите кнопку Пуск, щелкните правой кнопкой мыши Командная строка и выберите Запуск от имени администратора. Дополнительные сведения см. на веб-узле корпорации Майкрософт.

Даже если вход в систему выполнен с учетными данными администратора, необходимо открыть окно командной строки с повышенными правами, чтобы выполнить эту функцию на сервере под управлением Windows Server 2008. Чтобы открыть командную строку с повышенными правами, нажмите кнопку Пуск, щелкните правой кнопкой мыши Командная строка и выберите Запуск от имени администратора. Дополнительные сведения см. на веб-узле корпорации Майкрософт.

TFSAdminUtil RenameDT servername

Параметры

Аргумент	Описание
servername	Указывает имя конечного компьютера уровня данных. Ниже перечислены способы идентификации компьютера. IP-адрес IP-адрес должен иметь формат: aaa.bbb.ccc.ddd. По имени компьютера. В имени недопустимы пробелы или специальные знаки, например ";:<>*, а разрешены только символы [A-Z \| 0-9 \| -]. Имя не может полностью состоять из цифр. Оно может состоять не более чем из 15 символов в обычной кодировке ASCII или 7 символов в более длинной символьной кодировке. Дополнительные сведения см. в разделе Ограничение имен для Team Foundation Server. По адресу домена. Например, Myserver.location.mycompanyt.com.

servername

Указывает имя конечного компьютера уровня данных. Ниже перечислены способы идентификации компьютера.

IP-адрес

IP-адрес должен иметь формат: aaa.bbb.ccc.ddd.
По имени компьютера.

В имени недопустимы пробелы или специальные знаки, например ";:<>*, а разрешены только символы [A-Z | 0-9 | -]. Имя не может полностью состоять из цифр. Оно может состоять не более чем из 15 символов в обычной кодировке ASCII или 7 символов в более длинной символьной кодировке. Дополнительные сведения см. в разделе Ограничение имен для Team Foundation Server.
По адресу домена.

Например, Myserver.location.mycompanyt.com.

Заметки

Важное примечание.
Рекомендуется сделать резервные копии баз данных на сервере уровня данных Team Foundation Server.

Строки TFSNameUrl и TFS Name в файле конфигурации служб Web.config, который находится в каталоге Диск:\Program Files\Microsoft Visual Studio 2008 Team Foundation Server\Web Services на сервере уровня данных, должны ссылаться на текущий сервер уровня данных Team Foundation Server. В противном случае произойдет сбой команды RenameDT без оповещения.

Уровню приложений Team Foundation Server для обращения к серверу уровня данных необходимо его точное имя или адрес. Имя и адрес сервера уровня данных хранится в нескольких местах в Team Foundation Server, в базах данных уровня приложений и уровня данных. Когда возникает необходимость переключиться на новый сервер уровня данных, администратору следует убедиться, что в Team Foundation Server указано имя или адрес нового сервера уровня данных.

Команда RenameDT программы командной строки TFSAdminUtil автоматизирует процесс переименования уровня данных, обновляя Team Foundation Server, чтобы там указывалось новое имя или адрес. Команду RenameDT также можно добавить в сценарий, чтобы переименовывать уровень данных автоматически или по расписанию.

Команду RenameDT можно выполнять только на уровне приложений, потому что она осуществляет поиск файла web.config на том компьютере, на котором она запущена. Эта команда не предусматривает возможность удаленного взаимодействия и не принимает каких-либо других параметров, задающих конечный компьютер уровня приложений.

Примеры сценариев использования

Администраторы могут использовать команду RenameDT в различных сценариях. Ниже перечислены примеры таких сценариев:

Администратору необходимо выполнить плановое обслуживание уровня данных и перевести его в автономный режим, подменив его другим временным уровнем данных во избежание простоя.
Администратор выполняет команду RenameDT программы командной строки TFSAdminUtil и теперь Team Foundation Server подключается к новому временному уровню данных. После завершения обслуживания администратор снова запускает эту программу, чтобы изменить уровень данных на исходный.
Произошел сбой уровня данных и он не работает.
Администратор выполняет команду RenameDT, чтобы указать для Team Foundation Server новый резервный сервер.
Уровень данных обновляется на новый сервер.
Администратор выполняет команду RenameDT, чтобы указать для Team Foundation Server новый сервер уровня данных.
Новые операционные политики устанавливают специальные стандарты именования компьютеров, которым должен отвечать уровень данных.
Администратор использует команду RenameDT, чтобы переименовать уровень данных, указав для него более подходящее имя.
Предприятие или бизнес стали больше и нуждаются в переходе с односерверного решения га двухсерверное.
После настройки нового независимого уровня данных администратор выполняет команду RenameDT, чтобы указать для Team Foundation Server новый сервер.