Mesclar vários sites em um único site
O suporte a vários sites para a Configuração Automatizada fornece um método para mesclar vários sites locais em um único site de nuvem.
O suporte a vários sites adiciona prefixos e sufixos exclusivos aos nomes dos componentes por site local, garantindo a exclusividade do nome depois que vários sites locais são mesclados em um único site na nuvem.
Podem ser atribuídos prefixos e sufixos a cada um dos seguintes componentes por site local.
AdminScopeAdminRoleApplicationAdminApplicationFolderApplicationGroupApplicationUserDeliveryGroupGroupPolicyHostConnectionMachineCatalogStoreFrontTag
As pastas de aplicativos suportam prefixo, sufixo e rerooting. O rerooting adiciona uma pasta de nível superior extra à estrutura de pastas já existente de um aplicativo.
Regras de prefixação e sufixo
- Os prefixos e sufixos não podem conter nenhum dos seguintes caracteres especiais:
\ , / ; : # . * ? = < > | ( ) " ' { } [ ] - Os prefixos e sufixos podem conter espaços à direita, mas não espaços à esquerda.
- Os prefixos e sufixos devem ter aspas duplas para conter espaços à direita.
- Os prefixos e sufixos são aplicados no momento da importação, mesclagem e adição. Os arquivos .yml de origem nunca são modificados.
- O processo de prefixação e sufixação automaticamente prefixa ou sufixa nomes de componentes dependentes quando aplicável. Por exemplo, se os nomes de catálogo de máquinas forem prefixados com “East”, os grupos de entrega que fazem referência a eles também serão prefixados com “East”.
- Se o nome de um componente já começar com o prefixo ou o sufixo, nenhum prefixo ou sufixo será adicionado. Os nomes dos componentes não podem conter prefixos ou sufixos duplos idênticos.
- Os prefixos e sufixos podem ser usados individualmente ou em combinação.
- O uso de um prefixo ou sufixo em um componente é opcional.
Nota:
A interface Full Configuration exibe os componentes em ordem alfabética.
Agrupar por site
Use o prefixo para agrupar visualmente componentes de um único site. Cada site é listado em seu próprio grupo, com prefixo, controlando alfabeticamente a ordem de diferentes grupos de sites.
Agrupar por nome
Use o sufixo para agrupar visualmente componentes com nomes semelhantes de vários sites. Componentes com nomes semelhantes de diferentes sites alternam visualmente.
Arquivo SiteMerging.yml
O prefixo do site começa com o arquivo SiteMerging.yml que contém o prefixo do site e o mapeamento de sufixos para um ou mais sites locais. Você pode gerenciar o arquivo SiteMerging.yml manualmente ou usando os cmdlets disponíveis listados na seção Mesclagem de vários cmdlets de sites locais .
Exportar, importar, mesclar e adicionar
A mesclagem não pode começar até que você tenha exportado um site local. Para exportar um site local, consulte Migração do local para a nuvem.
Pasta de destino de exportação central
Os métodos descritos nesta seção colocam várias exportações de sites em um local central de compartilhamento de arquivos. O arquivo SiteMerging.yml, o arquivo CustomerInfo.yml e todos os arquivos de exportação permanecem nesse local de compartilhamento de arquivos, permitindo que você faça a importação de um local independente dos sites locais.
As operações de acesso à nuvem nunca fazem referência aos sites locais ou ao Active Directory, permitindo que você faça operações de acesso à nuvem de qualquer lugar.
Compartilhamento direto de arquivos
As operações de exportação, importação, mesclagem e novo/adição fornecem um parâmetro para direcionar ou criar uma pasta diferente da pasta padrão, %HOMEPATH%\Documents\Citrix\AutoConfig. Os exemplos a seguir usam um compartilhamento de arquivos central localizado em \\share.central.net, local a que o administrador já tem acesso, tendo fornecido as credenciais conforme o necessário.
Para direcionar a exportação para uma pasta específica do site, use o parâmetro –TargetFolder:
Do East DDC:
mkdir \\share.central.net\AutoConfig\SiteEast
Export-CvadAcToFile –TargetFolder \\share.central.net\AutoConfig\SiteEast
Do West DDC:
mkdir \\share.central.net\AutoConfig\SiteWest
Export-CvadAcToFile –TargetFolder \\share.central.net\AutoConfig\SiteWest
Depois que as exportações forem concluídas, crie os arquivos CustomerInfo.yml e SiteMerging.yml e coloque-os em \\share.central.net\AutoConfig.
Nota:
Não use o parâmetro
SiteRootFolderao criar o SiteMerging.yml ao usar esse método de referência de compartilhamento de arquivo direto.
Para importar, mesclar ou adicionar do compartilhamento direto de arquivos, você deve decidir de qual máquina deseja fazer a operação de acesso à nuvem. As opções são:
- Um dos DDCs locais em que a ferramenta já está instalada.
- A máquina que hospeda o compartilhamento de arquivos.
- Uma máquina diferente.
A Configuração Automatizada deve ser instalada na máquina que acessa a nuvem. Nem o PowerShell SDK, o DDC nem o Active Directory no local são usados, portanto, os requisitos de execução de acesso à nuvem são mais simples do que os requisitos de exportação.
Para mesclar o East DDC com a nuvem:
Merge-CvadAcToSite –SiteName East –SourceFolder \\share.central.net\AutoConfig\SiteEast -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Para mesclar o West DDC com a nuvem:
Merge-CvadAcToSite –SiteName West –SourceFolder \\share.central.net\AutoConfig\SiteWest -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Veja a seguir um exemplo de arquivo SiteMerging.yml usado no exemplo anterior.
East:
SiteRootFolder: "" # Important: leave this empty
AdminScopePrefix: "East_"
AdminRolePrefix: "East_"
ApplicationAdminPrefix: "East_"
ApplicationFolderPrefix: "" # Note that a new parent root folder is used instead
ApplicationFolderRoot: "East"
ApplicationGroupPrefix: "East_"
ApplicationUserPrefix: "East_"
DeliveryGroupPrefix: "East_"
GroupPolicyPrefix: "East_"
HostConnectionPrefix: "East_"
MachineCatalogPrefix: "East_"
StoreFrontPrefix: "East_"
TagPrefix: "East_"
AdminScopeSuffix: "_east"
AdminRoleSuffix: "_east"
ApplicationAdminSuffix: "_east"
ApplicationFolderSuffix: "_east"
ApplicationGroupSuffix: "_east"
ApplicationUserSuffix: "_east"
DeliveryGroupSuffix: "_east"
GroupPolicySuffix: "_east"
HostConnectionSuffix: "_east"
MachineCatalogSuffix: "_east"
StoreFrontSuffix: "_east"
TagSuffix: "_east"
West:
SiteRootFolder: "" # Important: leave this empty
AdminScopePrefix: "Western "
AdminRolePrefix: "Western "
ApplicationAdminPrefix: "Western "
ApplicationFolderPrefix: "" # Note that a new parent root folder is used instead
ApplicationFolderRoot: "Western"
ApplicationGroupPrefix: "Western "
ApplicationUserPrefix: "Western "
DeliveryGroupPrefix: "Western "
GroupPolicyPrefix: "Western "
HostConnectionPrefix: "Western "
MachineCatalogPrefix: "Western "
StoreFrontPrefix: "Western "
TagPrefix: "Western "
AdminScopeSuffix: ""
AdminRoleSuffix: ""
ApplicationAdminSuffix: ""
ApplicationFolderSuffix: ""
ApplicationGroupSuffix: ""
ApplicationUserSuffix: ""
DeliveryGroupSuffix: ""
GroupPolicySuffix: ""
HostConnectionSuffix: ""
MachineCatalogSuffix: ""
StoreFrontSuffix: ""
TagSuffix: ""
Referência de compartilhamento de arquivos usando SiteMerging.yml
Esse método usa o membro SiteRootFolder do conjunto de prefixos do site. Embora seja mais complexo do que o método de compartilhamento direto de arquivos, esse método reduz as chances de direcionar a pasta errada ao exportar, importar, mesclar ou adicionar.
Primeiro, defina o SiteRootFolder para cada site no arquivo SiteMerging.yml Você deve fazer isso no local compartilhado.
New-CvadAcSiteMergingInfo –SiteName East –SiteRootFolder \\share.central.net\AutoConfig\SiteEast -TargetFolder \\share.central.net\AutoConfig
New-CvadAcSiteMergingInfo –SiteName West –SiteRootFolder SiteWest -TargetFolder \\share.central.net\AutoConfig
Neste exemplo, East é uma especificação de pasta totalmente qualificada e West é uma especificação de pasta relativa.
Para direcionar a exportação para uma pasta específica do site usando o arquivo SiteMerging.yml:
Do East DDC:
mkdir \\share.central.net\AutoConfig\SiteEast
Export-CvadAcToFile -SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Do West DDC:
mkdir \\share.central.net\AutoConfig\SiteWest
Export-CvadAcToFile -SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
O cmdlet de exportação usa o local da pasta CustomerInfo.yml para localizar o arquivo SiteMerging.yml. No caso do East, o SiteRootFolder é totalmente qualificado. Ele é usado como está. No caso de West, o não SiteRootFolder está totalmente qualificado. Ele é combinado com o local da pasta CustomerInfo.yml para recuperar um local de pasta totalmente qualificado para West.
Para mesclar o East DDC com a nuvem:
Merge-CvadAcToSite –SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Para mesclar o West DDC com a nuvem:
Merge-CvadAcToSite –SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Veja a seguir um exemplo de arquivo SiteMerging.yml usado no exemplo anterior.
East:
SiteRootFolder: "\\\\share.central.net\\AutoConfig\\SiteEast"
AdminScopePrefix: "East_"
AdminRolePrefix: "East_"
ApplicationAdminPrefix: "East_"
ApplicationFolderPrefix: "" # Note that a new parent root folder is used instead
ApplicationFolderRoot: "East"
ApplicationGroupPrefix: "East_"
ApplicationUserPrefix: "East_"
DeliveryGroupPrefix: "East_"
GroupPolicyPrefix: "East_"
HostConnectionPrefix: "East_"
MachineCatalogPrefix: "East_"
StoreFrontPrefix: "East_"
TagPrefix: "East_"
AdminScopeSuffix: "_east"
AdminRoleSuffix: "_east"
ApplicationAdminSuffix: "_east"
ApplicationFolderSuffix: "_east"
ApplicationGroupSuffix: "_east"
ApplicationUserSuffix: "_east"
DeliveryGroupSuffix: "_east"
GroupPolicySuffix: "_east"
HostConnectionSuffix: "_east"
MachineCatalogSuffix: "_east"
StoreFrontSuffix: "_east"
TagSuffix: "_east"
West:
SiteRootFolder: "\\\\share.central.net\\AutoConfig\\SiteWest"
AdminScopePrefix: "Western "
AdminRolePrefix: "Western "
ApplicationAdminPrefix: "Western "
ApplicationFolderPrefix: "" # Note that a new parent root folder is used instead
ApplicationFolderRoot: "Western"
ApplicationGroupPrefix: "Western "
ApplicationUserPrefix: "Western "
DeliveryGroupPrefix: "Western "
GroupPolicyPrefix: "Western "
HostConnectionPrefix: "Western "
MachineCatalogPrefix: "Western "
StoreFrontPrefix: "Western "
TagPrefix: "Western "
AdminScopeSuffix: ""
AdminRoleSuffix: ""
ApplicationAdminSuffix: ""
ApplicationFolderSuffix: ""
ApplicationGroupSuffix: ""
ApplicationUserSuffix: ""
DeliveryGroupSuffix: ""
GroupPolicySuffix: ""
HostConnectionSuffix: ""
MachineCatalogSuffix: ""
StoreFrontSuffix: ""
TagSuffix: ""
Se um método central de compartilhamento de arquivos não for usado e a importação, mesclagem ou adição for feita a partir dos DDCs separadamente, crie e replique o arquivo SiteMerging.yml em cada DDC que está sendo migrado para a nuvem. O local padrão é %HOMEPATH%\Documents\Citrix\AutoConfig. Você deve especificar o parâmetro –SiteName para selecionar os prefixos de site corretos.
Mesclagem de sites
A Citrix recomenda realizar as operações de nuvem em etapas e fazer uma revisão completa de cada resultado antes de realizar a próxima operação de nuvem. Por exemplo, ao mesclar três sites em um único site de nuvem:
- Mescle o site inicial com a nuvem usando o valor de
SiteNameapropriado. - Analise os resultados na interface de gerenciamento Full Configuration.
- Se os resultados estiverem incorretos, determine o problema e sua causa, corrija-o e execute novamente a mesclagem. Se necessário, remova os componentes da nuvem e comece do zero usando
Remove-CvadAcFromSitepara o componente e os membros selecionados. Se os resultados estiverem corretos, continue. - Se a mesclagem inicial estiver correta, mescle o segundo site com o único site de nuvem.
- Repita as etapas 2 e 3.
- Se a segunda mesclagem estiver correta, mescle o terceiro site com o único site de nuvem.
- Repita as etapas 2 e 3.
- Revise os recursos da perspectiva do usuário e verifique se a exibição está no estado desejado.
Remover um componente usando o prefixo do site
Você pode remover seletivamente componentes de site único usando o prefixo no parâmetro –IncludeByName do cmdlet Remove-CvadAcFromSite. No exemplo a seguir, os grupos de entrega do West DDC não estão corretos. Para remover os grupos de entrega apenas para o site West:
Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”
Para remover todos os componentes West, execute os seguintes cmdlets em ordem.
Remove-CvadAcFromSite –GroupPolicies –IncludeByName “Western *”
Remove-CvadAcFromSite –Applications –IncludeByName “Western *”
Remove-CvadAcFromSite – ApplicationGroups –IncludeByName “Western *”
Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”
Remove-CvadAcFromSite –MachineCatalogs –IncludeByName “Western *”
Remove-CvadAcFromSite –HostConnections –IncludeByName “Western *”
Remove-CvadAcFromSite –Tags –IncludeByName “Western *”
Para remover as políticas de grupo dos componentes East, use o sufixo:
Remove-CvadAcFromSite –GroupPolicies –IncludeByName “*_east”