Citrix DaaS

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

  1. Los prefijos y sufijos no pueden contener ninguno de los siguientes caracteres especiales: \ , / ; : # . * ? = < > | ( ) " ' { } [ ]
  2. Los prefijos y sufijos pueden contener espacios al final, pero no al principio.
  3. Los prefijos y sufijos deben estar entre comillas dobles para contener espacios al final.
  4. Los prefijos y sufijos se aplican en el momento de importar, fusionar y agregar. Los archivos YML de origen nunca se modifican.
  5. 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”.
  6. 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.
  7. Los prefijos y sufijos se pueden usar individualmente o en combinación.
  8. 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:

  1. Para fusionar el sitio inicial en la nube, use el valor SiteName apropiado.
  2. Revise los resultados en Studio.
  3. 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.
  4. Si la fusión inicial es correcta, fusiones el segundo sitio con el sitio único en la nube.
  5. Repita los pasos 2 y 3.
  6. Si la segunda fusión es correcta, fusione el tercer sitio con el sitio único en la nube.
  7. Repita los pasos 2 y 3.
  8. 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”

Fusionar varios sitios en uno