Fusionar varios sitios en un único sitio
La compatibilidad multisitio para la Configuración automatizada proporciona un método para fusionar varios sitios locales en un único sitio en la nube.
La compatibilidad multisitio agrega prefijos y sufijos únicos a los nombres de los componentes por cada sitio local, lo que garantiza la unicidad de los nombres después de que varios sitios locales se fusionen en un único sitio en la nube.
Se pueden asignar prefijos y sufijos para cada uno de los siguientes componentes por cada sitio local.
AdminScopeAdminRoleApplicationAdminApplicationFolderApplicationGroupApplicationUserDeliveryGroupGroupPolicyHostConnectionMachineCatalogStoreFront™Tag
Las carpetas de aplicaciones admiten el uso de prefijos, sufijos y el cambio de raíz. El cambio de raíz agrega una carpeta de nivel superior adicional a la estructura de carpetas existente 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 finales, pero no espacios iniciales.
- Los prefijos y sufijos deben ir entre comillas dobles para contener espacios finales.
- Los prefijos y sufijos se aplican en el momento de la importación, la fusión y la adición. Los archivos .yml de origen nunca se modifican.
- El proceso de prefijos y sufijos agrega automáticamente prefijos o sufijos a los nombres de los componentes dependientes cuando corresponde. Por ejemplo, si los nombres de los catálogos de máquinas tienen el prefijo “East”, los grupos de entrega que los referencian también tienen el prefijo “East”.
- Si el nombre de un componente ya comienza con el prefijo o el sufijo, no se agrega ningún prefijo ni sufijo. Los nombres de los componentes no pueden contener prefijos o sufijos idénticos duplicados.
- 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 en orden alfabético.
Agrupar componentes por sitio
Usa prefijos para agrupar visualmente los componentes de un único sitio. Cada sitio aparece en su propio grupo, y los prefijos controlan alfabéticamente el orden de los diferentes grupos de sitios.
Agrupar componentes por nombre
Usa sufijos para agrupar visualmente componentes con nombres similares de varios sitios. Los componentes con nombres similares de diferentes sitios se alternan visualmente.
Archivo de asignación de prefijos y sufijos
El prefijo del sitio comienza con el archivo SiteMerging.yml que contiene la asignación de prefijos y sufijos del sitio para uno o varios sitios locales. Puedes administrar el archivo SiteMerging.yml manualmente o mediante los cmdlets disponibles que se enumeran en la sección Cmdlets para fusionar varios sitios locales.
Exportar sitio local
La fusión no puede comenzar hasta que hayas exportado un sitio local. Para exportar un sitio local, consulta Exportar la configuración local..
Carpeta de destino de exportación central
Los métodos descritos en esta sección colocan varias exportaciones de sitios en una ubicación de recurso compartido de archivos central. El archivo SiteMerging.yml, el archivo CustomerInfo.yml y todos los archivos de exportación residen en esa ubicación de recurso compartido de archivos, lo que te 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 ni a Active Directory, lo que te permite realizar operaciones de acceso a la nube desde cualquier lugar.
Recurso compartido de archivos directo
Hay dos métodos para hacerlo:
- Recurso compartido de archivos directo: Para importar, fusionar o agregar desde el recurso compartido de archivos directo, debes decidir desde qué máquina quieres realizar la operación de acceso a la nube.
-
Referencia de recurso compartido de archivos mediante
SiteMerging.yml: Este método usa el miembroSiteRootFolderdel conjunto de prefijos del sitio y reduce las probabilidades de seleccionar la carpeta incorrecta al exportar, importar, fusionar o agregar.
Si no usas un método de recurso compartido de archivos central, entonces realiza la importación, la fusión o la adición desde los Delivery Controllers individuales. Crea y replica el archivo SiteMerging.yml en cada Delivery Controller que se migre a la nube. La ubicación predeterminada es %HOMEPATH%\Documents\Citrix\AutoConfig. Debes especificar el parámetro –SiteName para seleccionar los prefijos de sitio correctos.
Recurso compartido de archivos directo
Las operaciones de exportación, importación, fusión y nueva adición proporcionan un parámetro para seleccionar o especificar una carpeta diferente a la predeterminada, %HOMEPATH%\Documents\Citrix\AutoConfig. Los siguientes ejemplos usan un recurso compartido de archivos central ubicado en \\share.central.net al que el administrador ya tiene acceso, habiendo proporcionado las credenciales según sea necesario.
Para dirigir la exportación a una carpeta específica del sitio, usa el parámetro –TargetFolder:
Desde el Delivery Controller™ de East:
mkdir \\share.central.net\AutoConfig\SiteEast
Export-CvadAcToFile –TargetFolder \\share.central.net\AutoConfig\SiteEast
Desde el Delivery Controller de West:
mkdir \\share.central.net\AutoConfig\SiteWest
Export-CvadAcToFile –TargetFolder \\share.central.net\AutoConfig\SiteWest
Una vez completadas las exportaciones, crea los archivos CustomerInfo.yml y SiteMerging.yml y colócalos en \\share.central.net\AutoConfig.
Nota:
No uses el parámetro
SiteRootFolderal crearSitePrefixes.ymlcuando uses este método de referencia de recurso compartido de archivos directo.
Para importar, fusionar o agregar desde el recurso compartido de archivos directo, debes decidir desde qué máquina quieres realizar la operación de acceso a la nube. Las opciones incluyen:
- Uno de los Delivery Controllers locales donde la herramienta ya está instalada.
- La máquina que aloja el recurso compartido de archivos.
- Una máquina diferente.
La Configuración automatizada debe estar instalada en la máquina que accede a la nube. No se usan el SDK de PowerShell local, los Delivery Controllers ni Active Directory, por lo que los requisitos de ejecución de acceso a la nube son más sencillos que los requisitos de exportación.
Para fusionar los Delivery Controllers de East en la nube:
Merge-CvadAcToSite –SiteName East –SourceFolder \\share.central.net\AutoConfig\SiteEast -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Para fusionar los Delivery Controllers de West en 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 ejemplo 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: ""
<!--NeedCopy-->
Referencia de recurso compartido de archivos mediante SiteMerging.yml
Este método usa el miembro SiteRootFolder del conjunto de prefijos del sitio. Aunque es más complejo que el método directo de recurso compartido de archivos, este método reduce las probabilidades de seleccionar la carpeta incorrecta al exportar, importar, fusionar o agregar.
Primero, configura el SiteRootFolder para cada sitio en el archivo SiteMerging.yml. Debes 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 totalmente cualificada y West es una especificación de carpeta relativa.
Para dirigir la exportación a una carpeta específica del sitio usando el archivo SiteMerging.yml:
Desde el controlador de entrega de East:
mkdir \\share.central.net\AutoConfig\SiteEast
Export-CvadAcToFile -SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Desde el controlador de entrega de West:
mkdir \\share.central.net\AutoConfig\SiteWest
Export-CvadAcToFile -SiteName West -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
El cmdlet de exportación usa la ubicación de la carpeta CustomerInfo.yml para localizar el archivo SiteMerging.yml. En el caso de East, el SiteRootFolder está totalmente cualificado. Se usa tal cual. En el caso de West, el SiteRootFolder no está totalmente cualificado. Se combina con la ubicación de la carpeta CustomerInfo.yml para recuperar una ubicación de carpeta totalmente cualificada para West.
Para fusionar el controlador de entrega de East con la nube:
Merge-CvadAcToSite –SiteName East -CustomerInfoFileSpec \\share.central.net\AutoConfig\CustomerInfo.yml
Para fusionar el controlador de entrega de 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 ejemplo 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: ""
<!--NeedCopy-->
Si no se usa un método de recurso compartido de archivos central y la importación, fusión o adición se realiza desde los controladores de entrega individuales, entonces crea y replica el archivo SiteMerging.yml en cada controlador de entrega que se migre a la nube. La ubicación predeterminada es %HOMEPATH%\Documents\Citrix\AutoConfig. Debes 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 realizar la siguiente operación en la nube. Por ejemplo, si fusionas tres sitios en un único sitio en la nube:
- Fusiona el sitio inicial con la nube usando el valor
SiteNameapropiado. - Revisa los resultados en Studio.
- Si los resultados son incorrectos, determina el problema y su causa, corrígelo y luego vuelve a ejecutar la fusión. Si es necesario, quita los componentes de la nube y empieza de cero usando
Remove-CvadAcFromSitepara el componente y los miembros seleccionados. Si los resultados son correctos, continúa. - Si la fusión inicial es correcta, fusiona el segundo sitio con el único sitio en la nube.
- Repite los pasos 2 y 3.
- Si la segunda fusión es correcta, fusiona el tercer sitio con el único sitio en la nube.
- Repite los pasos 2 y 3.
- Revisa los recursos desde la perspectiva del usuario y verifica que la vista esté en el estado deseado.
Quitar un componente usando el prefijo del sitio
Puedes 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 controlador de entrega de West no son correctos. Para quitar los grupos de entrega solo para el sitio de West:
Remove-CvadAcFromSite –DeliveryGroups –IncludeByName “Western *”
Para quitar todos los componentes de West, ejecuta 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 las directivas de grupo de los componentes de East, usa el sufijo:
Remove-CvadAcFromSite –GroupPolicies –IncludeByName “*_east”