Fusionar varios sitios en uno
La compatibilidad con varios sitios para la Configuración automatizada proporciona un método para fusionar varios sitios locales en un único sitio en la nube.
La compatibilidad con varios sitios agrega prefijos y sufijos únicos a los nombres de los componentes por sitio local, lo que garantiza la exclusividad de los nombres al fusionar varios sitios locales en un solo sitio en la nube.
Se pueden asignar prefijos y sufijos para cada uno de estos componentes por sitio local.
AdminScope
AdminRole
ApplicationAdmin
ApplicationFolder
ApplicationGroup
ApplicationUser
DeliveryGroup
GroupPolicy
HostConnection
MachineCatalog
StoreFront
Tag
Las carpetas de aplicaciones admiten prefijos, sufijos y cambio de raíz. El cambio de raíz agrega una carpeta de nivel superior adicional a la estructura de carpetas de una aplicación.
Reglas de prefijos y sufijos
- Los prefijos y sufijos no pueden contener ninguno de los siguientes caracteres especiales:
\ , / ; : # . * ? = < > | ( ) " ' { } [ ]
- Los prefijos y sufijos pueden contener espacios al final, pero no al principio.
- Los prefijos y sufijos deben estar entre comillas dobles para contener espacios al final.
- Los prefijos y sufijos se aplican en el momento de importar, fusionar y agregar. Los archivos YML de origen nunca se modifican.
- El proceso de asignación de prefijos y sufijos agrega automáticamente estos a los nombres de los componentes dependientes cuando procede. Por ejemplo, si los nombres del catálogo de máquinas tienen el prefijo “East”, los grupos de entrega que hacen referencia a ellos también tienen el prefijo “East”.
- Si un nombre de componente ya empieza por el prefijo o sufijo, no se agregará ningún prefijo o sufijo. Los nombres de componentes no pueden contener prefijos o sufijos dobles idénticos.
- Los prefijos y sufijos se pueden usar individualmente o en combinación.
- El uso de un prefijo o un sufijo en un componente es opcional.
Nota:
Studio muestra los componentes por orden alfabético.
Agrupar por sitio
Utilice prefijos para agrupar visualmente componentes de un mismo sitio. Cada sitio se enumera en su propio grupo, con prefijo alfabético que controla el orden de los diferentes grupos del sitio.
Agrupar por nombre
Utilice sufijos para agrupar visualmente componentes con nombres similares de diferentes sitios. Los componentes con nombres similares de diferentes sitios se alternan visualmente.
Archivo SitePrefixes.yml
El prefijado de sitios comienza con el archivo SiteMerging.yml que contiene el prefijo del sitio y la asignación de sufijos para uno o varios sitios locales. Puede administrar el archivo SiteMerging.yml manualmente o con los cmdlets disponibles que se indican en la sección Cmdlets sobre la fusión de varios sitios locales.
Exportación, importación, fusión e incorporación
La fusión no puede comenzar hasta que haya exportado un sitio local. Para exportar un sitio local, consulte Migrar configuraciones locales a la nube.
Carpeta de destino de exportación central
Los métodos descritos en esta sección emplazan las exportaciones de varios sitios en una ubicación central de recursos compartidos. El archivo SiteMerging.yml, el archivo CustomerInfo.yml y todos los archivos de exportación residen en esa ubicación de recursos compartidos, lo que le permite realizar la importación desde una ubicación independiente de los sitios locales.
Las operaciones de acceso a la nube nunca hacen referencia a los sitios locales o a Active Directory, lo que le permite efectuar las operaciones de acceso a la nube desde cualquier lugar.
Recursos compartidos directos
Las operaciones de exportación, importación, fusión y nuevo/adición proporcionan un parámetro para usar como origen o destino una carpeta distinta de la predeterminada %HOMEPATH%\Documentos\Citrix\AutoConfig. En los siguientes ejemplos, se utiliza un recurso compartido central ubicado en \\share.central.net
, al que el administrador tiene acceso tras proporcionar las credenciales necesarias.
Para destinar la exportación a una carpeta específica del sitio, utilice el parámetro –TargetFolder
:
Desde el DDC East:
mkdir \\share.central.net\AutoConfig\SiteEast
Export-CvadAcToFile –TargetFolder \\share.central.net\AutoConfig\SiteEast
Desde el DDC West:
mkdir \\share.central.net\AutoConfig\SiteWest
Export-CvadAcToFile –TargetFolder \\share.central.net\AutoConfig\SiteWest
Una vez completadas las exportaciones, cree los archivos CustomerInfo.yml y SiteMerging.yml y colóquelos en \\share.central.net\AutoConfig
.
Nota:
No utilice el parámetro
SiteRootFolder
al crear el archivo SitePrefixes.yml cuando utilice este método de referencia para recursos compartidos directos.
Para importar, fusionar o agregar desde el recurso compartido directo, debe decidir desde qué máquina quiere efectuar la operación de acceso a la nube. Entre las opciones se incluyen:
- Uno de los DDC locales donde la herramienta ya está instalada.
- La máquina que aloja el recurso compartido.
- Una máquina diferente.
La Configuración automatizada debe estar instalada en la máquina con la que se accede a la nube. No se utilizan instancias de SDK de PowerShell, DDC ni Active Directory locales, por lo que los requisitos de ejecución para acceso a la nube son más simples que los requisitos de exportación.
Para fusionar el DDC East con la nube:
Merge-CvadAcToSite –SiteName East –SourceFolder \\share.central.net\AutoConfig\SiteEast -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Para fusionar el DDC West con la nube:
Merge-CvadAcToSite –SiteName West –SourceFolder \\share.central.net\AutoConfig\SiteWest -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
A continuación se muestra un archivo SitePrefixes.yml de muestra utilizado en el ejemplo 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: ""
Referencia de recurso compartido con SiteMerging.yml
Este método utiliza el miembro SiteRootFolder
del conjunto de prefijos del sitio. Aunque más involucrado que el método de recurso compartido directo, este método reduce las probabilidades de apuntar a una carpeta incorrecta al exportar, importar, fusionar o agregar.
En primer lugar, establezca SiteRootFolder
para cada sitio en el archivo SiteMerging.yml. Debe hacer esto en la ubicación compartida.
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
En este ejemplo, “East” es una especificación de carpeta completa y “West” es una especificación de carpeta relativa.
Para dirigir la exportación a una carpeta específica del sitio mediante el archivo SiteMerging.yml:
Desde el DDC East:
mkdir \\share.central.net\AutoConfig\SiteEast
Export-CvadAcToFile -SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Desde el DDC West:
mkdir \\share.central.net\AutoConfig\SiteWest
Export-CvadAcToFile -SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
El cmdlet de exportación utiliza la ubicación de la carpeta CustomerInfo.yml para localizar el archivo SiteMerging.yml. En el caso de “East”, SiteRootFolder
es una referencia completa. Se usa tal cual. En el caso de West, SiteRootFolder
no es una referencia completa. Se combina con la ubicación de la carpeta CustomerInfo.yml para obtener una ubicación de carpeta completa para “West”.
Para fusionar el DDC East con la nube:
Merge-CvadAcToSite –SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Para fusionar el DDC West con la nube:
Merge-CvadAcToSite –SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
A continuación se muestra un archivo SitePrefixes.yml de muestra utilizado en el ejemplo 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: ""
Si no se utiliza un método de recurso compartido central y la importación, fusión o adición se realiza desde los DDC individuales, cree y replique el archivo SiteMerging.yml en cada DDC que se migre a la nube. La ubicación predeterminada es %HOMEPATH%\Documentos\Citrix\AutoConfig. Debe especificar el parámetro –SiteName
para seleccionar los prefijos de sitio correctos.
Fusionar los sitios
Citrix recomienda realizar las operaciones en la nube por pasos y hacer una revisión completa de cada resultado antes de pasar a la siguiente operación en la nube. Por ejemplo, si se fusionan tres sitios en un único sitio en la nube:
- Para fusionar el sitio inicial en la nube, use el valor
SiteName
apropiado. - Revise los resultados en Studio.
- Si los resultados no son correctos, determine el problema y su causa, corríjalo y vuelva a ejecutar la fusión. Si es necesario, quite los componentes de la nube y comience desde cero; para ello, use
Remove-CvadAcFromSite
para el componente y los miembros seleccionados. Si los resultados son correctos, continúe. - Si la fusión inicial es correcta, fusiones el segundo sitio con el sitio único en la nube.
- Repita los pasos 2 y 3.
- Si la segunda fusión es correcta, fusione el tercer sitio con el sitio único en la nube.
- Repita los pasos 2 y 3.
- Revise los recursos desde la perspectiva del usuario y compruebe que la vista se encuentra en el estado deseado.
Quitar un componente con el prefijo del sitio
Para quitar de forma selectiva componentes de un solo sitio, use el prefijo en el parámetro –IncludeByName
del cmdlet Remove-CvadAcFromSite
. En el ejemplo siguiente, los grupos de entrega de DDC West no son correctos. Para quitar los grupos de entrega solo del sitio West:
Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”
Para quitar todos los componentes de West, ejecute los siguientes cmdlets en orden.
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 quitar directivas de grupo de los componentes de East, utilice el sufijo:
Remove-CvadAcFromSite –GroupPolicies –IncludeByName “*_east”