Mesclar vários sites em um único site
O suporte multisite para configuração automatizada fornece um método para mesclar vários sites locais em um único site na nuvem.
O suporte a vários sites adiciona prefixos e sufixos exclusivos aos nomes de componentes por site local, garantindo a exclusividade do nome depois que vários sites locais são mesclados em um único site na nuvem.
Prefixos e sufixos podem ser atribuídos para cada um dos seguintes componentes por local.
AdminScopeAdminRoleApplicationAdminApplicationFolderApplicationGroupApplicationUserDeliveryGroupGroupPolicyHostConnectionMachineCatalogLojaEtiqueta
As pastas de aplicativos oferecem suporte à prefixação, sufixação e rerooting. O rerooting adiciona uma pasta extra de nível superior à estrutura de pastas existente de um aplicativo.
Regras de prefixo e sufixo
- Prefixos e sufixos não podem conter nenhum dos seguintes caracteres especiais:
\ , / ; : # . * ? = < > | ( ) " ' { } [ ] - Prefixos e sufixos podem conter espaços finais, mas não espaços iniciais.
- Prefixos e sufixos devem estar entre aspas duplas para conter espaços finais.
- Prefixos e sufixos são aplicados no momento da importação, mesclagem e adição. Os arquivos de origem
.ymlnunca são modificados. - O processo de prefixo e sufixo prefixa ou sufixa automaticamente os nomes dos componentes dependentes quando aplicável. Por exemplo, se os nomes de catálogos de máquinas tiverem o prefixo “Leste”, os grupos de entrega que os referenciam também terão o prefixo “Leste”.
- Se um nome de componente já começar com o prefixo ou sufixo, nenhum prefixo ou sufixo será adicionado. Os nomes dos componentes não podem conter prefixos ou sufixos idênticos.
- Prefixos e sufixos podem ser usados individualmente ou em combinação.
- O uso de um prefixo ou sufixo em um componente é opcional.
Observação:
O Studio exibe os componentes em ordem alfabética.
Agrupar componentes por site
Use prefixos para agrupar visualmente componentes de um único site. Cada site é listado em seu próprio grupo com prefixos em ordem alfabética controlando a ordenação dos diferentes grupos de sites.
Agrupar componentes por nome
Use sufixos para agrupar visualmente componentes com nomes semelhantes de vários sites. Componentes com nomes semelhantes de sites diferentes se alternam visualmente.
Arquivo de mapeamento de prefixo e sufixo
A prefixação do site começa com o arquivo SiteMerging.yml que contém o mapeamento de prefixo e sufixo do site para um ou mais sites locais. Você pode gerenciar o arquivo SiteMerging.yml manualmente ou usando os cmdlets disponíveis listados na seção Mesclando vários cmdlets de sites locais .
Exportar site local
A mesclagem não pode começar até que você tenha exportado um site local. Para exportar um site local, consulte Exportar configuração local.
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 residem 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 assim que você faça operações de acesso à nuvem de qualquer lugar.
Existem dois métodos para fazer isso:
- Compartilhamento direto de arquivos: 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
- Referência de compartilhamento de arquivo usando
SiteMerging.yml: Este método usa o membroSiteRootFolderdo conjunto de prefixos do site e reduz as chances de direcionar para a pasta errada ao exportar, importar, mesclar ou adicionar.
Se você não usar um método de compartilhamento de arquivos central, faça a importação, a mesclagem ou a adição dos Controladores de Entrega individuais. Crie e replique o arquivo SiteMerging.yml em cada Delivery Controller 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.
Compartilhamento direto de arquivos
As operações de exportação, importação, mesclagem e novo/adicionar fornecem um parâmetro para direcionar ou originar uma pasta diferente da pasta padrão, %HOMEPATH%\Documents\Citrix\AutoConfig. Os exemplos a seguir usam um compartilhamento de arquivos central em \\share.central.net ao qual o administrador já tem acesso, tendo fornecido credenciais conforme necessário.
Para direcionar a exportação para uma pasta específica do site, use o parâmetro –TargetFolder :
Do Controlador de Entrega Leste:
mkdir \\share.central.net\AutoConfig\SiteEast
Export-CvadAcToFile –TargetFolder \\share.central.net\AutoConfig\SiteEast
Do Controlador de Entrega do Oeste:
mkdir \\share.central.net\AutoConfig\SiteWest
Export-CvadAcToFile –TargetFolder \\share.central.net\AutoConfig\SiteWest`
Após a conclusão das exportações, crie os arquivos CustomerInfo.yml e SiteMerging.yml e coloque-os em \\share.central.net\AutoConfig.
Observação:
Não use o parâmetro
SiteRootFolderao criar o SitePrefixes.yml ao usar este método de referência de compartilhamento direto de arquivos.
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 Controladores de Entrega locais onde 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 local, o Delivery Controller nem o Active Directory 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 Delivery Controller à nuvem:
Merge-CvadAcToSite –SiteName East –SourceFolder \\share.central.net\AutoConfig\SiteEast -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Para mesclar o West Delivery Controller à nuvem:
Merge-CvadAcToSite –SiteName West –SourceFolder \\share.central.net\AutoConfig\SiteWest -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
O seguinte é um exemplo de arquivo SitePrefixes.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 arquivo usando SiteMerging.yml
Este 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 selecionar a pasta errada ao exportar, importar, mesclar ou adicionar.
Primeiro, defina 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 -SitePrefixesFolder \\share.central.net\AutoConfig
New-CvadAcSiteMergingInfo –SiteName West –SiteRootFolder SiteWest -SitePrefixesFolder \\share.central.net\AutoConfig
Neste exemplo, Leste é uma especificação de pasta totalmente qualificada e Oeste é uma especificação de pasta relativa.
Para direcionar a exportação para uma pasta específica do site usando o arquivo SiteMerging.yml:
Do Controlador de Entrega Leste:
mkdir \\share.central.net\AutoConfig\SiteEast
Export-CvadAcToFile -SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Do Controlador de Entrega do Oeste:
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 de East, o SiteRootFolder é totalmente qualificado. É usado como está. No caso de West, o SiteRootFolder não é 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 Delivery Controller à nuvem:
Merge-CvadAcToSite –SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Para mesclar o West Delivery Controller à nuvem:
Merge-CvadAcToSite –SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
A seguir está um arquivo de exemplo SitePrefixes.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: ""
Mesclar os sites
A Citrix recomenda executar as operações na nuvem em etapas e fazer uma revisão completa de cada resultado antes de executar a próxima operação na nuvem. Por exemplo, se estiver mesclando três sites em um único site na nuvem:
- Mescle o site inicial à nuvem usando o valor apropriado
SiteName. - Revise os resultados no Studio.
- Se os resultados estiverem incorretos, determine o problema e sua causa, corrija-o e execute a mesclagem novamente. 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 ao site de nuvem única.
- Repita os passos 2 e 3.
- Se a segunda mesclagem estiver correta, mescle o terceiro site ao site de nuvem única.
- Repita os passos 2 e 3.
- Revise os recursos da perspectiva do usuário e verifique se a visualização está no estado desejado.
Remover um componente usando o prefixo do site
Você pode remover seletivamente componentes de um único site usando o prefixo no parâmetro –IncludeByName do cmdlet Remove-CvadAcFromSite . No exemplo a seguir, os grupos de entrega do West Delivery Controller não estão corretos. Para remover os grupos de entrega apenas do site Oeste:
Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”
Para remover todos os componentes do 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 políticas de grupo dos componentes Leste, use o sufixo:
Remove-CvadAcFromSite –GroupPolicies –IncludeByName “*_east”