Solucionar problemas de configuração automatizada e informações adicionais
Importante:
Para ver as mensagens de erro que ocorrem com frequência para a Configuração automatizada e as soluções correspondentes, consulte troubleshooting FAQ no artigo do Centro de Conhecimento CTX277730.
Erros da ferramenta Automated configuration
Às vezes, as operações da ferramenta Automated configuration podem produzir erros. Quando isso acontece, podem ocorrer falhas ao processar componentes como catálogos de máquinas, grupos de entrega ou políticas de grupo, por exemplo. O uso de OnErrorAction
e parâmetros de continuação permitem que você detecte erros durante o processamento, resolva-os e continue de onde parou.
O valor padrão OnErrorAction
é StopCompEnd
. Quando ocorre um erro, a ferramenta termina de processar o componente atual. Nenhum componente adicional é processado e os erros não são transferidos para os componentes dependentes posteriores. Depois de resolver os erros, você pode executar novamente seus cmdlets com qualquer parâmetro de continuação aplicado.
Parâmetro OnErrorAction
Você pode definir valores do parâmetro OnErrorAction
nos cmdlets de migração para controlar como a ferramenta responde aos erros encontrados ao processar componentes.
Esta tabela mostra os valores dos parâmetros e suas descrições:
Valor | Descrição |
---|---|
Continue |
Tenta processar o máximo possível de todos os componentes. |
Pause |
Pausa no final do processamento e solicita que você continue ou pare. |
StopCompEnd |
Tenta processar o máximo possível do componente. Para após a conclusão do componente. (Padrão) |
StopImmediately |
O processamento é interrompido quando um erro é encontrado. |
Cmdlets de migração
Você pode aplicar o parâmetro OnErrorAction
aos seguintes cmdlets de migração:
Compare-CvadAcToSite
Import-CvadAcToSite
Merge-CvadAcToSite
New-CvadAcToSite
Restore-CvadAcToSite
Exemplo: Merge-CvadAcToSite -OnErrorAction StopImmediately
Parâmetros Resume
Esses parâmetros definem como a ferramenta é retomada após uma pausa ou interrupção da operação devido a um erro.
Você pode aplicar parâmetros Resume aos cmdlets de migração que incluam um dos seguintes valores de parâmetro OnErrorAction
:
Pause
StopCompEnd
StopImmediately
Esta tabela mostra os valores dos parâmetros e suas descrições:
Valor | Descrição |
---|---|
-AllRemaining |
Requer um componente inicial. O processamento começa no componente inicial e processa todos os componentes restantes. Vários componentes são processados. |
-Resume |
Usa o componente do CurrentComponent.txt como ponto de partida. All Remaining é definido como true. Vários componentes são processados. |
-Repeat |
Usa o componente do CurrentComponent.txt como ponto de partida. All Remaining é definido como false. Somente um componente é processado. |
O último componente processado é armazenado no arquivo CurrentComponent.txt na pasta AutoConfig. Não é recomendado editar esse arquivo.
Se você especificar -Resume
ou -Repeat
e CurrentComponent.txt estiver ausente ou for inválido, o processamento será interrompido e você será solicitado a selecionar um componente.
Configurando o OnErrorAction no arquivo CustomerInfo.yml
Você também pode definir valores OnErrorAction
no arquivo CustomerInfo.yml. Defina os valores usando os seguintes cmdlets:
- Para um novo arquivo:
New-CvadAcCustomerInfoFile -OnErrorAction Continue | Pause | StopCompEnd | StopImmediately
- Para um arquivo existente:
Set-CvadAcCustomerInfoFile -OnErrorAction Continue | Pause | StopCompEnd | StopImmediately
Logs
A execução de qualquer cmdlet resulta na criação de um arquivo de log e em uma entrada no arquivo de log do histórico principal. Todos os arquivos de log de operação são colocados em uma pasta de backup. Todos os nomes de arquivos de log começam com CitrixLog
e mostram a operação de configuração automática e a data e o carimbo de data/hora da execução do cmdlet. Os logs não são excluídos automaticamente.
O registro do histórico principal está localizado em %HOMEPATH%\Documents\Citrix\AutoConfig, no arquivo chamado History.Log. Cada execução de cmdlet resulta em uma entrada de log principal contendo a data, a operação, o resultado, o backup e os locais do arquivo de log da execução.
Você também pode usar o cmdlet New-CvadAcZipInfoForSupport
para coletar logs que devem ser enviados à Citrix para suporte. Esse cmdlet compacta todos os arquivos de log e .yml em um único arquivo zip. Informações confidenciais do consumidor (CustomerInfo.yml e CvadAcSecurity.yml) não estão incluídas no zip. O arquivo Icon.yml também é excluído devido ao seu tamanho. O arquivo zip é colocado em %HOMEPATH%\Documents\Citrix\AutoConfig e nomeado CvadAcSupport_yyyy_mm_dd_hh_mm_ss.zip, com base na data e no carimbo de data/hora. Esse arquivo zip também pode funcionar como um backup.
Cada arquivo de log inclui o seguinte:
- O nome da operação e se o modo de verificação está ativado
- A data e a hora de início e término
- Várias entradas para as ações de cada componente e notificações de sucesso/falha
- Resumo das ações realizadas, incluindo várias contagens de objetos criados
- Correções sugeridas, quando aplicável
- Local da pasta de backup, quando aplicável
- Local do registro principal
- Duração
Arquivos de diagnóstico
Os arquivos de diagnóstico ajudam você a determinar e resolver problemas. Os arquivos a seguir são criados quando a operação é executada. Eles estão localizados na subpasta específica da ação em %HOMEPATH%\Documents\Citrix\AutoConfig. Inclua esses arquivos ao fornecer informações para suporte à resolução de problemas.
Exportar
PoshSdk_yyyy_mm_dd_hh_mm_ss.ps1
Esse arquivo conta todas as chamadas do Broker PowerShell SDK feitas para exportar a configuração do site para arquivos.
Importar, mesclar, restaurar, sincronizar, fazer backup, comparar
Transaction_yyyy_mm_dd_hh_mm_ss.txt
Esse arquivo documenta cada chamada da API Rest e as informações relacionadas.
RestApiContent_yyyy_mm_dd_hh_mm_ss.txt
Esse arquivo contém todo o conteúdo da API Rest Add
, Update
e Delete
.
Problemas resultantes de dependências
Importações e mesclagens podem falhar devido à falta de dependências. Alguns problemas comuns são:
- As Políticas de Grupo não têm filtros de grupo de entrega. As causas usuais são grupos de entrega que não foram importados.
- Os aplicativos não conseguem importar ou mesclar. A causa usual é a falta de grupos de entrega ou grupos de aplicativos que não foram importados.
- Os grupos de aplicativos não têm um RestrictToTag. As causas usuais são tags que não foram importadas.
- As conexões do host falham. A causa usual é falta de informações de segurança no arquivo CvadAcSecurity.yml.
- Os catálogos de máquinas falham. A causa usual são as conexões de host que não foram importadas.
- Máquinas ausentes em catálogos de máquinas e grupos de entrega. A causa usual são máquinas que não foram encontradas no Active Directory.
- Usuários ausentes nos grupos de entrega. A causa comum são os usuários que não foram encontrados no Active Directory.
Recomendações, em Recommendations
- Não execute mais de uma instância de Automated configuration por vez. A execução de várias instâncias simultâneas produz resultados imprevisíveis no site da nuvem. Se isso ocorrer, execute novamente uma instância de Automated configuration para trazer o site para o estado esperado.
- Não trabalhe nem altere dados na guia Manage em Full Configuration ao executar a Automated configuration.
- Sempre verifique visualmente os resultados de mesclagem/importação/restauração em Full Configuration para garantir que o site da nuvem atenda às expectativas.
Pastas
Local de raiz da pasta padrão
Todas as operações da ferramenta Automated configuration ocorrem na pasta raiz ou em subpastas dentro dela. A pasta raiz está localizada em %HOMEPATH%\Documents\Citrix\AutoConfig.
Exportar
Todos os arquivos exportados são colocados em dois locais de pasta, proporcionando facilidade de uso e um histórico de exportações. As exportações são sempre colocadas na pasta raiz. As cópias são colocadas em uma subpasta chamada Exportar com a data e a hora da exportação.
A pasta raiz sempre contém a configuração de site local exportada mais recente. Cada subpasta Export contém a exportação feita na data e hora indicadas, o que mantém um histórico de exportações. Você pode usar qualquer subpasta Export para configurar o site da nuvem. A configuração automatizada não exclui nem modifica subpastas de exportação existentes.
Importar/Mesclar/Sincronizar/Comparar
As operações Import
, Merge
e Compare
sempre são originadas de arquivos localizados na pasta raiz. Cada operação resulta na criação de uma subpasta para a qual os arquivos na pasta raiz são copiados, fornecendo um histórico de alteração dos arquivos de origem do site na nuvem.
Restaurar
A operação Restore
usa uma subpasta existente para configurar o site da nuvem. A pasta de origem é especificada no parâmetro -RestoreFolder
necessário. Ao contrário de outros comandos, nenhuma nova subpasta é criada porque a operação Restore
usa uma subpasta existente. A pasta de restauração pode ser a pasta raiz, mas ainda deve ser especificada no parâmetro -RestoreFolder
.
Backups
A Configuração automatizada inicializa, atualiza e faz backup de uma configuração de site na nuvem. Quando usadas ao longo do tempo, muitas configurações diferentes podem mudar no site da nuvem. Para facilitar o uso a longo prazo e preservar as alterações do histórico, a Configuração Automatizada usa um esquema de preservação para salvar esse histórico de alterações e fornecer um método para restaurar estados anteriores.
Os backups de configuração do site em nuvem são sempre feitos em uma subpasta chamada Backup com os dados e a hora do backup. A Configuração Automatizada não exclui nem modifica subpastas de exportação existentes.
Você pode usar os backups para restaurar componentes específicos ou toda a configuração. Para restaurar todo o grupo de entrega e os componentes do catálogo de máquinas, use o cmdlet:
Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss -DeliveryGroups -MachineCatalogs
Nota:
As informações do arquivo de backup no cmdlet anterior são baseadas em seus próprios backups.
Para restaurar toda a configuração do site de nuvem, use o cmdlet:
Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss
Nota:
As informações do arquivo de backup no cmdlet anterior são baseadas em seus próprios backups.
Alteração da pasta raiz padrão
As operações Export
, Import
, Merge
, Sync
e Compare
podem alterar a pasta raiz padrão por meio do parâmetro –AlternateFolder
. A criação e o gerenciamento de subpastas por operação permanecem os mesmos descritos anteriormente.
Arquivos copiados para subpastas
Todos os arquivos com uma extensão “.yml” são copiados para as subpastas de operação, exceto o seguinte:
- CustomerInfo.yml
- ZoneMapping.yml
- CvadAcSecurity.yml
Backups automatizados de sites em nuvem à prova de falhas
Um backup da configuração atual do site na nuvem é feito antes de executar operações que alteram a configuração. Isso inclui os parâmetros Import
, Merge
, Sync
e Restore
. O backup está sempre em uma subpasta abaixo da subpasta operacional.
No caso de Restore
, a pasta de backup é uma subpasta da pasta especificada no parâmetro -RestoreFolder
.
Automação
Os cmdlets da ferramenta Automated configuration podem ser executados em scripts de automação sem a intervenção do administrador, suprimindo os prompts e a exibição dos resultados do log na conclusão do cmdlet. Você também pode definir parâmetros para fazer o mesmo usando o arquivo CustomerInfo.yml.
Adicione o parâmetro a seguir aos cmdlets de modificação da nuvem para suprimir a exibição de prompts.
-Confirm $false
Adicione o seguinte parâmetro aos cmdlets para suprimir a exibição do log na conclusão do cmdlet.
-DisplayLog $false
Adicione o seguinte parâmetro aos cmdlets para suprimir o registro na janela de comando do PowerShell.
-Quiet
Como outro método, os seguintes parâmetros podem ser colocados no arquivo CustomerInfo.yml.
Confirm: False
DisplayLog: False
Exportar de PCs que não sejam o Delivery Controller
A ferramenta Automated configuration usa vários SDKs do Citrix PowerShell para exportar a configuração do site local para arquivos. Esses SDKs são instalados automaticamente no Delivery Controller, permitindo que a ferramenta seja executada no Delivery Controller sem ações extras. Ao executar em máquinas que não são Delivery Controller, é necessário instalar o conjunto de SDKs do Citrix PowerShell necessários para a ferramenta. Esse conjunto de SDK faz parte do Citrix Studio, que pode ser instalado a partir da mídia de instalação do Citrix Virtual Apps and Desktops.
Nota:
A configuração automatizada não pode ser executada no Cloud Connector.
Mudança para o Citrix Cloud Government e o Japan Control Plane
Os ambientes Citrix Cloud Government e Japan Control Plane usam diferentes pontos de acesso para autenticar e alocar tokens de acesso. Esse requisito exclusivo se aplica a qualquer ferramenta Automated configuration que acesse a nuvem. Execute as etapas a seguir para usar a Configuração automatizada nesses ambientes.
- Na pasta %HOMEPATH%\Documents\Citrix\AutoConfig, edite CustomerInfo.yml.
-
Adicione uma das seguintes linhas, dependendo do ambiente ao qual você deseja se conectar, a CustomerInfo.yml (ou altere-a, se já estiver presente).
Environment: 'ProductionGov'
ou
Environment: 'ProductionJP'
A Configuração Automatizada agora pode ser usada nesses ambientes.
Coleta de dados do Citrix Cloud
Para obter informações sobre quais informações o Citrix Cloud coleta, consulte Citrix Cloud Services Customer Content and Log Handling.
Recursos adicionais
Fórum de discussão
Visite o Citrix Discussion forum for Automated Configuration.
Vídeo
Assista Under the Hood of the Automated Configuration Tool for Citrix Virtual Apps and Desktops no YouTube.
Treinamento
O Cloud Learning Center contém guias de vídeo passo a passo para criar uma implantação de serviço, incluindo as tarefas descritas neste artigo. Consulte Migrating Citrix Virtual Apps and Desktops to Citrix Cloud Learning Path.
Neste artigo
- Erros da ferramenta Automated configuration
- Logs
- Arquivos de diagnóstico
- Problemas resultantes de dependências
- Recomendações, em Recommendations
- Pastas
- Backups
- Automação
- Exportar de PCs que não sejam o Delivery Controller
- Mudança para o Citrix Cloud Government e o Japan Control Plane
- Coleta de dados do Citrix Cloud
- Recursos adicionais