Como configurar usuários e configurações de teste de nó de observador

  • Artigo

Resumo: Configurar contas de usuário de teste e configurações de nó de observador para Skype for Business Server transações sintéticas.

Depois de configurar o computador que atuará como um nó do inspetor, você deve:

  1. Configurar contas de usuário de teste a serem usadas por esses nós de observador. Se você estiver usando o método Negociar autenticação, também deve usar o cmdlet Set-CsTestUserCredential para habilitar essas contas de teste para uso no nó do observador.

  2. Atualizar as definições de configuração do nó do inspetor.

Configurar contas de usuário de teste

As contas de teste não precisam representar pessoas reais, mas devem ser contas válidas do Active Directory. Além disso, essas contas devem ser habilitadas para Skype for Business Server, elas devem ter endereços SIP válidos e devem ser habilitadas para Enterprise Voice (para usar a transação sintética Test-CsPstnPeerToPeerCall).

Se você estiver usando o método de autenticação TrustedServer, tudo o que você precisa fazer é garantir que essas contas existam e configurá-las conforme observado. Atribua pelo menos dois usuários de teste para cada pool que você deseja testar. Se você estiver usando o método de autenticação negociada, também deve usar o cmdlet Set-CsTestUserCredential e o shell de gerenciamento Skype for Business Server para permitir que essas contas de teste funcionem com as transações sintéticas. Faça isso executando um comando semelhante ao seguinte (esses comandos supõem que as duas contas de usuário do Active Directory foram criadas e que essas contas estão habilitadas para Skype for Business Server):

Set-CsTestUserCredential -SipAddress "sip:watcher1@litwareinc.com" -UserName "litwareinc\watcher1" -Password "P@ssw0rd"
Set-CsTestUserCredential -SipAddress "sip:watcher2@litwareinc.com" -UserName "litwareinc\watcher2" -Password "P@ssw0rd"

É necessário incluir não apenas o endereço SIP, mas também o nome e a senha do usuário. Se você não incluir a senha, o cmdlet Set-CsTestUserCredential solicitará que você insira essas informações. O nome de usuário pode ser especificado usando-se o formato de nome de domínio\nome de usuário indicado no bloqueio do código anterior.

Para verificar se as credenciais do usuário de teste foram criadas, execute esses comandos no Shell de Gerenciamento Skype for Business Server:

Get-CsTestUserCredential -SipAddress "sip:watcher1@litwareinc.com"
Get-CsTestUserCredential -SipAddress "sip:watcher2@litwareinc.com"

Informações semelhantes às seguintes são retornadas para cada usuário:

Username Senha
Litwareinc\watcher1
 System.Security.SecureString

Configurar um nó básico do inspetor com as transações sintéticas padrão

Depois que os usuários de teste forem criados, você poderá criar um nó de observador usando um comando semelhante a este:

New-CsWatcherNodeConfiguration -TargetFqdn "atl-cs-001.litwareinc.com" -PortNumber 5061 -TestUsers @{Add= "sip:watcher1@litwareinc.com","sip:watcher2@litwareinc.com"}

Esse comando cria um novo nó do inspetor que usa as configurações padrão e executa o conjunto padrão de transações sintéticas. O novo nó de observador também usa os usuários watcher1@litwareinc.comde teste e watcher2@litwareinc.com. Se o nó do observador usar a autenticação TrustedServer, as duas contas de teste poderão ser contas de usuário válidas habilitadas para Active Directory e Skype for Business Server. Se o nó de observador usar o método de autenticação negociado, essas contas de usuário também deverão ser habilitadas para o nó de observador usando o cmdlet Set-CsTestUserCredential.

Para validar se a descoberta automática de pool de destino a ser inserida está configurada corretamente, ao invés de direcionar um pool diretamente, siga as etapas abaixo:

New-CsWatcherNodeConfiguration -UseAutoDiscovery $true -TargetFqdn "atl-cs-001.litwareinc.com" -PortNumber 5061 -TestUsers @{Add= "sip:watcher1@litwareinc.com","sip:watcher2@litwareinc.com"}

Configurando testes estendidos

Se você quiser habilitar o teste PSTN, que verifica a conectividade com a rede telefônica comutada pública, você precisa fazer alguma outra configuração ao configurar o nó de observador. Primeiro, você deve associar seus usuários de teste ao tipo de teste da PSTN executando um comando semelhante a este no Shell de Gerenciamento do Skype for Business Server:

$pstnTest = New-CsExtendedTest -TestUsers "sip:watcher1@litwareinc.com", "sip:watcher2@litwareinc.com" -Name "Contoso Provider Test" -TestType PSTN

Nota

Os resultados desse comando devem ser armazenados em uma variável. Neste exemplo, é uma variável chamada de $pstnTest.

Em seguida, você pode usar o cmdlet New-CsWatcherNodeConfiguration para associar o tipo de teste (armazenado na variável $pstnTest) a um pool de Skype for Business Server. Por exemplo, o comando a seguir cria uma nova configuração de nó de observador para o pool atl-cs-001.litwareinc.com, adicionando os dois usuários de teste criados anteriormente e adicionando o tipo de teste PSTN:

New-CsWatcherNodeConfiguration -TargetFqdn "atl-cs-001.litwareinc.com" -PortNumber 5061 -TestUsers @{Add= "sip:watcher1@litwareinc.com","sip:watcher2@litwareinc.com"} -ExtendedTests @{Add=$pstnTest}

O comando anterior falhará se você não tiver instalado os arquivos principais Skype for Business Server e o banco de dados RTCLocal no computador de nó do observador.

Para testar várias políticas de voz, você pode criar um teste estendido para cada política usando o cmdlet New-CsExtendedTest. Os usuários fornecidos devem ser configurados com as políticas de voz desejadas. Os testes estendidos são passados para o cmdlet New-CsWatcherNodeConfiguration separados por vírgula, como indicado:

-ExtendedTests @{Add=$pstnTest 1,$pstnTest 2,$pstnTest 3}

Como o cmdlet New-CsWatcherNodeConfiguration foi chamado sem usar o parâmetro Tests, apenas as transações sintéticas padrão (e a transação sintética estendida especificada) estão habilitadas para o novo nó de observador. Portanto, o nó de observador testa os seguintes componentes:

  • Registro

  • IM

  • GroupIM

  • P2PAV (sessões de áudio/vídeo ponto a ponto)

  • AvConference (áudio/conferência)

  • Presença

  • ABS (serviço do Catálogo de Endereços)

  • ABWQ (serviço Web do Catálogo de Endereços)

Os seguintes componentes não serão testados por padrão:

  • ASConference

  • AVEdgeConnectivity

  • DataConference

  • DialInConferencing

  • ExumConnectivity (Unificação de Mensagens do Exchange)

  • JoinLauncher

  • MCXP2PIM (mensagens instantâneas de dispositivo móvel herdado)

  • P2PVideoInteropServerSipTrunkAV

  • PersistentChatMessage

  • PSTN (chamadas de gateway PSTN, especificadas como um teste estendido)

  • UcwaConference

  • UnifiedContactStore

  • XmppIM

Adicionando e removendo transações sintéticas

Depois que um nó de observador for configurado, você poderá usar o cmdlet Set-CsWatcherNodeConfiguration para adicionar ou remover transações sintéticas do nó. Por exemplo, para adicionar o teste PersistentChatMessage ao nó do inspetor, use o método Add e um comando semelhante a este:

Set-CsWatcherNodeConfiguration -Identity "atl-cs-001.litwareinc.com" -Tests @{Add="PersistentChatMessage"}

É possível adicionar vários testes separando os nomes de teste com vírgulas. Por exemplo:

Set-CsWatcherNodeConfiguration -Identity "atl-cs-001.litwareinc.com" -Tests @{Add="PersistentChatMessage","DataConference","UnifiedContactStore"}

Ocorrerá um erro se um ou mais desses testes (por exemplo, DataConference) estiver habilitado no nó do observador. Nesse caso, você receberá uma mensagem de erro semelhante à seguinte:

Set-CsWatcherNodeConfiguration: há uma sequência de chaves duplicada 'DataConference' para a chave 'urn:schema:Microsoft.Rtc.Management.Settings.WatcherNode.2010:TestName' ou restrição de identidade exclusiva.

Quando esse erro ocorre, nenhuma alteração é aplicada. O comando deve ser executado novamente com o teste duplicado removido.

Para remover uma transação sintética do nó do inspetor, use o método Remove. Por exemplo, esse comando remove o teste ABWQ do nó do inspetor:

Set-CsWatcherNodeConfiguration -Identity "atl-cs-001.litwareinc.com" -Tests @{Remove="ABWQ"}

Você pode usar o método Substituir para substituir todos os testes habilitados no momento por um ou mais novos testes. Por exemplo, se desejar que apenas um nó do inspetor execute o teste IM, você pode configurar isso usando este comando:

Set-CsWatcherNodeConfiguration -Identity "atl-cs-001.litwareinc.com" -Tests @{Replace="IM"}

Quando você executa o comando anterior, todas as transações sintéticas no nó do inspetor especificado serão desativadas exceto para IM.

Exibindo e testando a configuração do nó do inspetor

Se quiser exibir os testes que foram atribuídos ao nó do inspetor, use um comando semelhante a este:

Get-CsWatcherNodeConfiguration -Identity "atl-cs-001.litwareinc.com" | Select-Object -ExpandProperty Tests

Esse comando retorna informações semelhantes a essa, dependendo das transações sintéticas atribuídas ao nó:

Registro IM GroupIM P2PAV AvConference Presence PersistentChatMessage DataConference

Ponta

Para exibir as transações sintéticas em ordem alfabética, use este comando:

Get-CsWatcherNodeConfiguration -Identity "atl-cs-001.litwareinc.com" | Select-Object -ExpandProperty Tests | Sort-Object

Para verificar se um nó do inspetor foi criado, digite o seguinte comando no Shell de Gerenciamento do Skype for Business Server:

Get-CsWatcherNodeConfiguration

Você obtém informações de volta semelhantes a esta:

Identidade: atl-cs-001.litwareinc.com
TestUsers: {sip:watcher1@litwareinc.com, sip:watcher2@litwareinc.com ...}
ExtendedTests: {TestUsers=IList<System.String>; Teste Name=PSTN; Te...}
TargetFqdn: atl-cs-001.litwareinc.com
PortNumber: 5061

Para verificar se o nó do observador está configurado corretamente, digite o seguinte comando do Shell de Gerenciamento Skype for Business Server:

Test-CsWatcherNodeConfiguration

Esse comando testa cada nó de observador em sua implantação e confirma se as seguintes ações estão concluídas:

  • A função Registrador necessária está instalada.

  • A chave de registro necessária é criada (concluída quando você executou o cmdlet Set-CsWatcherNodeConfiguration).

  • Seus servidores estão executando a versão correta do Skype for Business Server.

  • Suas portas estão configuradas corretamente.

  • Os usuários de teste atribuídos têm as credenciais necessárias.

Gerenciar nós do inspetor

Além de modificar as transações sintéticas que são executadas em um nó do inspetor, você também podem usar o cmdlet Set-CsWatcherNodeConfiguration para realizar duas outras tarefas importantes: habilitar e desabilitar o nó do inspetor e configurá-lo para usar URLs da Web internas ou externas durante a execução de testes.

Por padrão, os nós do inspetor são projetados para executar periodicamente todas as transações sintéticas habilitadas. Às vezes, no entanto, talvez você queira suspender essas transações. Por exemplo, se o nó de observador estiver temporariamente desconectado da rede, não haverá razão para executar as transações sintéticas. Sem conectividade de rede, essas transações falham. Para desabilitar o nó do inspetor temporariamente, execute um comando semelhante a este no Shell de Gerenciamento do Skype for Business Server:

Set-CsWatcherNodeConfiguration -Identity "atl-watcher-001.litwareinc.com" -Enabled $False

Esse comando desabilita a execução de transações sintéticas no nó observador do observador 001.litwareinc.com. Para retomar a execução das transações sintéticas, defina a propriedade Enabled novamente como True ($True):

Set-CsWatcherNodeConfiguration -Identity "atl-watcher-001.litwareinc.com" -Enabled $True

Nota

A propriedade Enabled pode ser usada para habilitar e desabilitar os nós do inspetor. Se você desejar excluir permanentemente um nó do inspetor, use o cmdlet Remove-CsWatcherNodeConfiguration :

Remove-CsWatcherNodeConfiguration -Identity "atl-watcher-001.litwareinc.com"

Esse comando remove todas as configurações de nó do inspetor do computador especificado, o que impede que o computador execute transações sintéticas automaticamente. No entanto, o comando não desinstala os arquivos do agente do System Center ou os arquivos do sistema Skype for Business Server.

Por padrão, os nós do inspetor usam as URLs da Web externas de uma organização durante a realização de seus testes. No entanto, também é possível configurá-los para usar as URLs da Web internas da organização. Isso permite que os administradores verifiquem o acesso a URLs para os usuários localizados dentro da rede de perímetro. Para configurar um nó do inspetor para usar as URLs internas em vez das externas, defina a propriedade UseInternalWebUrls como True ($True):

Set-CsWatcherNodeConfiguration -Identity "atl-watcher-001.litwareinc.com" -UseInternalWebUrls $True

Redefinir essa propriedade para o valor padrão de False ($False) faz com que o observador use novamente as URLs externas:

Set-CsWatcherNodeConfiguration -Identity "atl-watcher-001.litwareinc.com" -UseInternalWebUrls $False

Instruções Especiais de Configuração para Transações Sintéticas

A maioria das transações sintéticas pode ser executada em um nó do inspetor como está. Na maioria dos casos, assim que uma transação sintética é adicionada às configurações do nó do inspetor, o nó do inspetor pode começar usando essa transação sintética durante suas fases de teste. No entanto, existem algumas transações sintéticas que exigem instruções especiais de configuração, conforme discutido nas seções a seguir.

Transação Sintética de Conferência de Dados

Se o computador de nó do observador estiver localizado fora da rede de perímetro, você provavelmente não poderá executar a Transação Sintética de Conferência de Dados, a menos que você primeiro desabilite as configurações de proxy do navegador windows Internet Explorer ® internet para a conta do Serviço de Rede concluindo as seguintes etapas:

  1. No computador de nó do observador, selecione Iniciar, selecionar Todos os Programas, clique em Acessórios, clique com o botão direito do mouse em Prompt de Comando e clique em Executar como administrador.

  2. Na janela do console, digite o seguinte comando e pressione ENTER.

     bitsadmin /util /SetIEProxy NetworkService NO_PROXY

    Você verá a seguinte mensagem exibida na janela de comando:

     BITSAdmin is deprecated and is not guaranteed to be available in future versions of Windows. Administration tools for the BITS service are now provided by BITS PowerShell cmdlets.

 Internet proxy settings for account NetworkService set to NO_PROXY. 

 (connection = default)

    Esta mensagem indica que você desabilitou as configurações de proxy do Internet Explorer para a conta Serviço de Rede.

Transações sintéticas de Unificação de Mensagens do Exchange

A transação sintética de Unificação de Mensagens do Exchange verifica se usuários de teste podem se conectar a contas de correio de voz hospedadas no Exchange.

Os usuários de teste precisam ser pré-configurados com contas de caixa postal.

Transação Sintética de Chat Persistente

Para usar a transação sintética do chat persistente, você deve primeiro criar um canal e conceder aos usuários de teste permissões para usá-lo.

Você pode usar a transação sintética de chat persistente para configurar esse canal:

$cred1 = Get-Credential "contoso\testUser1"
$cred2 = Get-Credential "contoso\testUser2"

Test-CsPersistentChatMessage -TargetFqdn pool0.contoso.com -SenderSipAddress sip:testUser1@contoso.com -SenderCredential $cred1 -ReceiverSipAddress sip:testUser2@contoso.com -ReceiverCredential $cred2 -TestUser1SipAddress sip:testUser1@contoso.com -TestUser2SipAddress sip:testUser2@contoso.com -Setup $true

Execute essa tarefa de instalação de dentro da empresa:

  • Se ela for realizada de uma máquina que não é um servidor, o usuário que executar o cmdlet deverá ser um membro da função CsPersistentChatAdministrators do RBAC (Controle de Acesso Baseado em Função).

  • Se ela for realizada a partir do próprio servidor, o usuário que executar o cmdlet deverá ser um membro do grupo RTCUniversalServerAdmins.

Transações sintéticas de chamada ponto a ponto PSTN

A transação sintética de Test-CSPstnPeerToPeerCall verifica a capacidade de realizar e receber chamadas através de uma PSTN (rede telefônica pública comutada).

Para executar essa transação sintética, você deve configurar:

  • Dois usuários de teste habilitados em UC (um chamador e um receptor).

  • Números DID (Discagem Interna Direta) para cada conta de usuário.

  • Políticas voIP e rotas de voz que permitem que chamadas para o número do receptor cheguem ao gateway PSTN.

  • Um gateway PSTN que aceita chamada e mídia que roteia a chamada de volta para o pool inicial de um receptor, com base no número discado.

Transações Sintéticas do Repositório Unificado de Contatos

A transação sintética do Unified Contact Store verifica a capacidade de Skype for Business Server recuperar contatos em nome de um usuário do Exchange.

Para usar essa transação sintética, as seguintes condições devem ser atendidas:

  • A autenticação de servidor para servidor do Lyss-Exchange deve ser configurada.

  • Os usuários de teste devem ter uma caixa de entrada válida do Exchange.

Depois que essas condições forem atendidas, você poderá executar o seguinte cmdlet Windows PowerShell para migrar as listas de contatos dos usuários de teste para o Exchange:

Test-CsUnifiedContactStore -TargetFqdn pool0.contoso.com -UserSipAddress sip:testUser1@contoso.com -RegistrarPort 5061 -Authentication TrustedServer -Setup

Pode levar algum tempo para que as listas de contatos do usuário de teste migrem para o Exchange. Para monitorar o progresso da migração, a mesma linha de comando pode ser executada sem o sinalizador -Setup:

Test-CsUnifiedContactStore -TargetFqdn pool0.contoso.com -UserSipAddress sip:testUser1@contoso.com -RegistrarPort 5061 -Authentication TrustedServer

Esta linha de comando será bem-sucedida após a conclusão da migração.

Transação Sintética XMPP

A transação sintética de IM do protocolo XMPP (Extensible Messaging and Presence Protocol) exige que o recurso XMPP seja configurado com um ou mais domínios federados.

Para habilitar a transação sintética XMPP, um parâmetro XmppTestReceiverMailAddress deve ser fornecido com uma conta de usuário em um domínio XMPP roteável. Por exemplo:

Set-CsWatcherNodeConfiguration -Identity pool0.contoso.com -Tests @{Add="XmppIM"} -XmppTestReceiverMailAddress user1@litwareinc.com

Neste exemplo, uma regra Skype for Business Server precisa existir para rotear mensagens para litwareinc.com para um gateway XMPP.

Nota

Os gateways e proxies XMPP estão disponíveis no Skype for Business Server 2015, mas não têm mais suporte no Skype for Business Server 2019. Para obter mais informações, confira Migrando a federação XMPP.

Transação sintética do Servidor de Interoperabilidade de Vídeo (VIS)

A transação sintética do VIS (Video Interop Server) exige que você baixe e instale os arquivos de suporte de transação sintética (VISSTSupportPackage.msi).

Para instalar VISSTSupportPackage.msi, verifique se as dependências (em Requisitos do Sistema) para o msi já estão instaladas. Execute VISSTSupportPackage.msi para fazer uma instalação. O .msi instala todos os arquivos no seguinte caminho: "%ProgramFiles%\Vis Synthetic Transaction Support Package".

Para obter mais informações sobre como executar a Transação Sintética vis, consulte o cmdlet Test-CsP2PVideoInteropServerSipTrunkAV .

Alterar a Frequência de Execução para Transações Sintéticas

Por padrão, as transações sintéticas são executadas com os usuários configurados a cada 15 minutos. As transações sintéticas são executados em sequência dentro de um conjunto de usuários para evitar que duas transações sintéticas entrem em conflito. Um intervalo mais longo é necessária para permitir que todas as transações sintéticas sejam concluídas a tempo.

Se for desejável executar transações sintéticas com mais frequência, o número de transações sintéticas executadas com um determinado conjunto de usuários deve ser reduzido para que os testes possam ser concluídos no intervalo de tempo desejado com algum buffer para atrasos ocasionais de rede. Se executar mais transações sintéticas for desejável, crie mais conjuntos de usuários para executar outras transações sintéticas.

Para alterar a frequência de execução das transações sintéticas, siga estas etapas:

  1. Abra o System Center Operations Manager. Selecione Seção Criação. Clique na seção Regras (em Criação).

  2. Na seção Regras, localize a regra com o nome "Regra de Coleção de Desempenho do Gerenciador de Transações Sintéticas Principal".

  3. Clique com o botão direito do mouse na regra e selecione Substituições, selecione Substituir a Regra e selecione "Para Todos os objetos da classe: Observador de Pool".

  4. No janela Propriedades de substituição, selecione Nome do parâmetro "Frequência" e defina o Valor de Substituição como o desejado.

  5. Na mesma janela, selecione o pacote Gerenciamento ao qual essa substituição precisa ser aplicada.

Usando Registro Avançado em Log para Transações Sintéticas

Transações sintéticas são muito úteis para ajudar a identificar problemas com o sistema. Por exemplo, o cmdlet Test-CsRegistration pode alertar os administradores para o fato de que usuários estavam enfrentando dificuldades de registro com o Skype for Business Server. No entanto, mais detalhes podem ser necessários para determinar a causa real de uma falha.

Por esse motivo, as transações sintéticas oferecem registro avançado em log. Com o registro avançado em log, para cada atividade assumida por uma transação sintética, as seguintes informações são registradas:

  • A hora em que a atividade foi iniciada.

  • A hora em que a atividade foi concluída.

  • A ação que foi executada (por exemplo, criar, participar ou sair de uma conferência; fazer logon no Skype for Business Server; enviar uma mensagem instantânea).

  • Mensagens informativas, verbosas, de aviso ou de erro geradas quando a atividade foi executada.

  • Mensagens de registro de SIP.

  • Registros de exceção ou códigos de diagnóstico gerados quando a atividade foi executada.

  • O resultado líquido da execução da atividade.

Essas informações são geradas automaticamente sempre que uma transação sintética for executada, mas não são exibidas automaticamente ou salvas em um arquivo de log. Se você estiver executando manualmente uma transação sintética, você pode usar o parâmetro OutLoggerVariable para especificar uma variável do Windows PowerShell no qual as informações serão armazenadas. A partir daqui, você tem a opção de usar um dos dois métodos a seguir para salvar e/ou visualizar mensagens de erro em log avançado no formato XML ou HTML.

Para recuperar as informações sobre a solução, especifique o parâmetro OutLoggerVariable, seguido por um nome da variável que você escolher:

Test-CsRegistration -TargetFqdn atl-cs-001.litwareinc.com -OutLoggerVariable RegistrationTest

Nota

Não prefigurar o nome da variável com o caractere $. Use um nome de variável como RegistrationTest (não $RegistrationTest).

Quando executar este comando, você verá um resultado semelhante ao seguinte:

Destino Fqdn : atl-cs-001.litwareinc.com Resultado : Latência de Falha : 00:00:00 Mensagem de erro : este computador não tem certificados atribuídos. Diagnóstico :Você pode acessar informações muito mais detalhadas para essa falha do que apenas a mensagem de erro mostrada aqui.

Para acessar essas informações em formato HTML, use um comando semelhante a este para salvar as informações armazenadas na variável RegistrationTest em um arquivo HTML:

$RegistrationTest.ToHTML() | Out-File C:\Logs\Registration.html

Como alternativa, é possível usar o método ToXML() para salvar os dados em um arquivo XML:

$RegistrationTest.ToXML() | Out-File C:\Logs\Registration.xml

Você pode exibir esses arquivos usando o Windows Internet Explorer, o Microsoft Visual Studio ou qualquer outro aplicativo capaz de abrir arquivos HTML/XML.

Transações sintéticas executadas de dentro do System Center Operations Manager gerarão automaticamente esses arquivos de log para falhas. Esses logs não serão gerados se a execução falhar antes que o Skype for Business Server PowerShell seja capaz de carregar e executar a transação sintética.

Importante

Por padrão, Skype for Business Server salva arquivos de log em uma pasta que não é compartilhada. Para tornar esses logs prontamente acessíveis, é preciso compartilhar essa pasta. Por exemplo: \atl-watcher-001.litwareinc.com\WatcherNode.