Fusionar varios sitios en un solo sitio
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.
AdminScopeAdminRoleApplicationAdminApplicationFolderApplicationGroupApplicationUserDeliveryGroupGroupPolicyHostConnectionMachineCatalogStoreFrontEtiqueta
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
.ymlde 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: No
Studio muestra los componentes por orden alfabético.
Agrupar componentes 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 componentes 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 de asignación de prefijos y sufijos
El prefijado de sitios comienza con el archivo SiteMerging.yml que contiene la asignación de prefijos y sufijos de sitio 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.
Exportar sitio local
La fusión no puede comenzar hasta que haya exportado un sitio local. Para exportar un sitio local, consulte Exportar configuración local.
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.
Hay dos métodos para hacer esto:
- 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
- Referencia de recurso compartido con
SiteMerging.yml: Este método usa el miembroSiteRootFolderdel conjunto de prefijos del sitio y reduce las probabilidades de apuntar a la carpeta incorrecta al exportar, importar, fusionar o agregar.
Si no usa un recurso compartido central, realice la importación, la fusión o la adición desde los Delivery Controllers individuales. Cree y replique el archivo SiteMerging.yml en cada Delivery Controller 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.
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 usa un recurso compartido central ubicado en \\share.central.net, al que el administrador tiene acceso tras proporcionar las credenciales necesarias.
Para dirigir la exportación a una carpeta específica del sitio, use el parámetro –TargetFolder:
Desde el Delivery Controller East:
mkdir \\share.central.net\AutoConfig\SiteEast
Export-CvadAcToFile –TargetFolder \\share.central.net\AutoConfig\SiteEast
<!--NeedCopy-->
Desde el Delivery Controller West:
mkdir \\share.central.net\AutoConfig\SiteWest
Export-CvadAcToFile –TargetFolder \\share.central.net\AutoConfig\SiteWest`
<!--NeedCopy-->
Una vez completadas las exportaciones, cree los archivos CustomerInfo.yml y SiteMerging.yml y colóquelos en \\share.central.net\AutoConfig.
Nota: No
No use el parámetro
SiteRootFolderal crear el archivo SitePrefixes.yml cuando use 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 Delivery Controllers 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 usan instancias de SDK de PowerShell, Delivery Controller 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 Delivery Controller East en la nube:
Merge-CvadAcToSite –SiteName East –SourceFolder \\share.central.net\AutoConfig\SiteEast -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->
Para fusionar el Delivery Controller West en la nube:
Merge-CvadAcToSite –SiteName West –SourceFolder \\share.central.net\AutoConfig\SiteWest -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->
A continuación se muestra un archivo SitePrefixes.yml de muestra usado 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 usa 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.
Primero, configure 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
<!--NeedCopy-->
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 Delivery Controller East:
mkdir \\share.central.net\AutoConfig\SiteEast
Export-CvadAcToFile -SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->
Desde el Delivery Controller West:
mkdir \\share.central.net\AutoConfig\SiteWest
Export-CvadAcToFile -SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->
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 Delivery Controller East en la nube:
Merge-CvadAcToSite –SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->
Para fusionar el Delivery Controller West en la nube:
Merge-CvadAcToSite –SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
<!--NeedCopy-->
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: ""
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:
- Fusione el sitio inicial en la nube usando el valor
SiteNameapropiado. - 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 usando
Remove-CvadAcFromSitepara 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
Puede quitar selectivamente componentes de un solo sitio usando el prefijo en el parámetro –IncludeByName del cmdlet Remove-CvadAcFromSite. En el siguiente ejemplo, los grupos de entrega del Delivery Controller West no son correctos. Para quitar los grupos de entrega solo del sitio West:
Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”
<!--NeedCopy-->
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”
<!--NeedCopy-->