Product Documentation

Herramientas

Feb 14, 2017

Puede utilizar las siguientes herramientas y utilidades para adaptar, acelerar y supervisar operaciones de PvD. 

Archivos de reglas personalizadas

Los archivos de reglas personalizadas que se proporcionan con PvD permiten modificar el comportamiento predeterminado de las actualizaciones de imagen de PvD de las siguientes maneras:
  • La visibilidad de los archivos en el disco PvD
  • Cómo se fusionan los cambios hechos en los archivos
  • Si los archivos permiten escritura

Para obtener instrucciones detalladas sobre los archivos de reglas personalizadas y la función CoW, consulte los comentarios en los propios archivos, que se encuentran en C:\ProgramData\Citrix\personal vDisk\Config, en la VM donde está instalado PvD. Los archivos llamados "custom_*" describen las reglas y cómo habilitarlas.

Scripts de cambio de tamaño y poolstats

Se ofrecen dos scripts para supervisar y administrar el tamaño de los discos PvD; se encuentran en la carpeta Support\Tools\Scripts, en los medios de instalación de XenDesktop. También puede utilizar la herramienta Personal vDisk Image Update Monitoring Tool (herramienta de supervisión de actualizaciones de imagen de Personal vDisk), que se encuentra en la carpeta Support\Tools\Scripts\PvdTool. Para obtener más información, consulte http://blogs.citrix.com/2014/06/02/introducing-the-pvd-image-update-monitoring-tool/.

Use resize-personalvdisk-pool.ps1 para aumentar el tamaño de los discos PvD en todos los escritorios de un catálogo. Los siguientes complementos y módulos del hipervisor deben estar instalados en la máquina donde se ejecuta Studio:
  • XenServer requiere XenServerPSSnapin
  • vCenter requiere vSphere PowerCli
  • System Center Virtual Machine Manager requiere la consola VMM

Use personal-vdisk-poolstats.ps1 para verificar el estado de las actualizaciones de imágenes y comprobar el espacio dedicado a aplicaciones y perfiles de usuarios en un grupo de escritorios con PvD. Ejecute este script antes de actualizar una imagen para comprobar si hay algún escritorio que esté quedándose sin espacio. Esto ayuda a prevenir errores durante el proceso de actualización. El script requiere que el firewall de Windows Management Instrumentation (WMI-In) esté habilitado en los escritorios con PvD. Puede habilitarlo en la imagen maestra o a través de un objeto de directiva de grupo (GPO).

Si una actualización de imagen falla, la entrada en la columna Update da información sobre el motivo del fallo.

Restablecimiento del área de aplicaciones

Si un escritorio queda dañado (después de instalar una aplicación defectuosa o por algún otro motivo), puede revertir el área de aplicaciones del disco PvD a su estado predeterminado de fábrica (vacío). La operación de restablecimiento deja intacta el área de datos de perfil de usuario.

Para restablecer el área de aplicaciones del disco PvD, use alguno de estos métodos:
  • Inicie una sesión como Administrador en el escritorio del usuario. Inicie un símbolo del sistema y ejecute el comando C:\Archivos de programa\Citrix\Personal vDisk\bin\CtxPvD.exe -s Reset.
  • Busque el escritorio del usuario en Citrix Director. Haga clic en Restablecer Personal vDisk y, a continuación, en Aceptar.

Exportación e importación de un inventario de PvD

El proceso de actualización de imagen forma parte de la implementación de imágenes nuevas en escritorios con PvD; este proceso incluye ajustar el disco Personal vDisk existente para que funcione con la nueva imagen base. En caso de implementaciones que usan Machine Creation Services (MCS), puede exportar el inventario de una VM activa a un punto compartido de red y, a continuación, importarlo en una imagen maestra. Se calcula un diferencial con este inventario en la imagen maestra. Aunque no sea obligatorio usar la función de exportación o importación de inventario, puede mejorar el rendimiento de todo el proceso de actualización de imágenes.

Para usar la función de importación o exportación de inventario, debe ser un administrador. Si fuera necesario, autentíquese en el recurso compartido de archivos usado para la exportación o importación con “net use”. El contexto de usuario debe tener acceso a los recursos compartidos de archivos usados para la importación o exportación.
  • Para exportar un inventario, ejecute el comando de exportación como administrador en una máquina que contenga un VDA con PvD habilitado (versión mínima 7.6):

    Ctxpvdsvc.exe exportinventory “<path-to-export-location>”

    El software detecta la ubicación del inventario actual y lo exporta a una carpeta denominada “ExportedPvdInventory” en la ubicación especificada. Esto es un extracto del resultado del comando:
    C:\Program Files\Citrix\personal vDisk\bin> .\CtxPvDSvc.exe exportinventory  \\share location\ExportedInventory Current inventory source location C:\CitrixPvD\Settings\Inventory\VER-LAS ... Exporting current inventory to location \\ …. ... Deleting any pre-existing inventory folder at \\ …. .Successfully exported current inventory to location \\ …. Error code = OPS 
  • Para importar un inventario ya exportado, ejecute el comando de importación como administrador en la imagen maestra:

Cómo importar

Ejecute el comando de importación como administrador en la imagen maestra.

Ctxpvdsvc.exe importinventory “<path-to-exported-inventory>”

La <ruta al inventario exportado> debe ser la ruta completa a los archivos del inventario; suele ser <ubicación de la red\ExportedPvdInventory>.

El inventario se obtiene a partir de la ubicación de importación (donde se exportó previamente mediante la opción exportinventory) y se importa al almacén de inventario de la imagen maestra. Esto es un extracto del resultado del comando:
C:\Program Files\Citrix\personal vDisk\bin> .\CtxPvDSvc.exe importinventory  \\share location\ExportedInventory\ExportedPvdInventory Importing inventory \\share location\ExportedInventory\ExportedPvdInventory … Successfully added inventory \\share location\ExportedInventory\ExportedPvdInventory to the  store at c:\ProgramData\Citrix\personal vDisk\InventoryStore
Después de la exportación, el punto compartido de red debería contener los siguientes nombres de archivo. Después de la importación, el almacén de inventario ubicado en la imagen maestra debe contener los mismos nombres de archivo.
  • Components.DAT
  • files_rules
  • folders_rules
  • regkey_rules
  • RINGTHREE.DAT
  • S-1-5-18.DAT
  • SAM.DAT
  • SECURITY.DAT
  • SNAPSHOT.DAT
  • SOFTWARE.DAT
  • SYSTEM.CurrentControlSet.DAT
  • VDCATALOG.DAT
  • vDiskJournalData

Copia de respaldo y restauración

Importante: Los scripts no trasladan los discos PvD a la nueva ubicación de almacenamiento. Esta operación debe realizarse de otro modo.
Hay dos scripts de PowerShell en los medios de instalación del producto (en la carpeta Support\Tools\Scripts) que le permiten realizar copias de seguridad y restaurar discos Personal vDisk. Use los scripts de copia de respaldo y restauración para migrar discos PvD y asociaciones de usuario existentes desde un catálogo a otro. Esto puede resultar útil si está cambiando su almacenamiento de PvD. El script de copia de respaldo crea un archivo .xml con metadatos de un catálogo existente. Estos metadatos contienen la ubicación actual de los discos PvD en el almacenamiento y las asociaciones de usuarios con los PvD. El script de restauración usa el archivo .xml para asociar los discos PvD con un nuevo catálogo y asignarles los usuarios correctos.
  • migration-backup.ps1 captura la asignación entre cada usuario y su disco Personal vDisk en un catálogo de máquinas y almacena esta información en un archivo .xml.
  • migration-restore.ps1 utiliza el archivo .xml para volver a crear el escritorio de un usuario en un catálogo de máquinas.
Antes de hacer copias de seguridad y llevar a cabo la restauración, tenga en cuenta lo siguiente:
  • Los scripts funcionan con la API del hipervisor, así que el complemento PowerShell del hipervisor debe estar instalado en el Controller donde se ejecutan los scripts.
  • Ejecute los scripts desde una ubicación que tenga acceso al Controller donde se creó el catálogo de máquinas.
  • Los scripts se admiten en las siguientes plataformas de hipervisor: Citrix XenServer, Microsoft Hyper-V y VMware ESX.

Crear una copia de seguridad de un catálogo de máquinas

Realice una copia de seguridad cuando se efectúe un cambio en un catálogo de máquinas. Puede realizar copias de seguridad mientras haya máquinas activas en el catálogo de máquinas.

Use migration-backup.ps1 para hacer una copia de seguridad de un catálogo de máquinas que contenga discos Personal vDisk. El script le solicitará el nombre del catálogo de máquinas y la información de conexión para el hipervisor. A continuación, recorre en iteración las máquinas asignadas a usuarios del catálogo de máquinas y almacena, para cada máquina, la asignación entre el almacenamiento de discos Personal vDisk y el usuario asignado. Esta información se encuentra en un archivo XML, el cual tiene la siguiente estructura:
<PVDMigration> <hypervisor> <type></type> </hypervisor> <PVD> <DiskId></DiskId> <DiskName></DiskName> <SRName></SRName> <SRID></SRID> <UserName></UserName> <UserSid></UserSid> <State></State> </PVD> </PVDMigration>
  • PvDMigration.hypervisor.Type es compatible con VMware ESX, Citrix XenServer y Microsoft Hyper-V.
  • PvDMigration.PVD almacena información sobre dónde se almacena el disco Personal vDisk y el usuario asociado a él.
  • PvDMigration.PVD.DiskId es el identificador único del disco vDisk del hipervisor en el que se realizó la copia de seguridad.
  • PvDMigration.PVD.DiskName es el nombre del archivo .vhd o .vmdk.
  • PvDMigration.PVD.SRName es el nombre del proveedor de almacenamiento cuando se realizó la copia de seguridad.
  • PvDMigration.PVD.SRID es el identificador único del proveedor de almacenamiento del hipervisor en el que se realizó la copia de seguridad.
  • PvDMigration.PVD.UserName es el nombre del usuario asociado a este disco vDisk.
  • PvDMigration.PVD.UserSid es el SID del usuario asociado a este disco vDisk.
  • PvDMigration.PVD.State indica el estado de este disco vDisk. Esto se puede "procesar" o "realizar una copia de seguridad" de ello. Se "realiza una copia de seguridad" después de la copia de seguridad inicial; el estado cambia a "procesado" después de que el archivo XML se utilice para la restauración con la ayuda de una copia de seguridad.

Restaurar un catálogo de máquinas

Antes de la restauración, tenga en cuenta lo siguiente:
  • Solo puede restaurar un catálogo de máquinas que comparta la misma imagen maestra que la de la copia de seguridad del catálogo de máquinas
  • Debe actualizar el inventario de la imagen maestra a partir de la cual se creó la copia de seguridad del catálogo de máquinas para crear una nueva imagen maestra.
Use migration-restore.ps1 para restaurar catálogos de máquinas que contengan discos Personal vDisk. El script procesa las siguientes entradas:
  • El archivo .xml creado durante el proceso de copia de seguridad.
  • El nombre del catálogo de máquinas a restaurar.
  • El nombre de la ubicación donde se almacenan los discos Personal vDisk desconectados. El archivo .xml contiene esto.
  • Información de conexión del hipervisor

El script migration-restore.ps1 busca máquinas sin asignar en el catálogo de máquinas y les asigna usuarios. También conecta discos Personal vDisk de los usuarios a las máquinas.

Ejemplo 1: Restaurar un catálogo de máquinas y sus discos Personal vDisk con nuevos nombres de máquina

En este caso, se restaura todo un catálogo de máquinas y los discos Personal vDisk conectados a las máquinas que contiene. Las máquinas obtienen nombres nuevos. Este caso puede darse cuando el hipervisor o el host de almacenamiento fallan o cuando migra a usuarios a una nueva infraestructura.
  1. Ejecute migration-backup.ps1 para capturar la asignación de usuarios con sus discos Personal vDisk en el archivo .xml.
  2. A través de una solución para copias de seguridad, traslade o capture los discos Personal vDisk del catálogo de máquinas a un disco:
    • VMware ESX o Microsoft Hyper-V: los discos Personal vDisk se encuentran en el espacio de almacenamiento especificado por el Controller, en una carpeta que contiene el nombre de la máquina a la que el disco vDisk está conectado.
    • Citrix XenServer: los discos Personal vDisk se encuentran en la raíz de la unidad de almacenamiento que especifica el Controller. El nombre de cada disco vDisk es un GUID.
  3. Restaure los discos Personal vDisk del catálogo de máquinas con una solución para copias de seguridad de almacenamiento:
    • ESX o Hyper-V: localice los discos vDisk en una nueva carpeta del nuevo recurso de almacenamiento. También puede dejar los discos vDisk en la ruta original, en el nuevo recurso de almacenamiento.
    • XenServer: localice los discos vDisk en la raíz del nuevo recurso de almacenamiento.
  4. Cree un disco vDisk de Provisioning Services o una instantánea de Machine Creation Services de la imagen maestra que utilizó para crear el catálogo de máquinas erróneo.
  5. Ejecute la opción Actualizar inventario del menú Inicio del disco vDisk o de la instantánea.
  6. Vuelva a crear el catálogo de máquinas en Studio con una convención de nomenclatura diferente al catálogo de máquinas erróneo (original). Esto genera un catálogo de nuevas máquinas, cada una con un nuevo disco Personal vDisk, que la base de datos del sitio reconoce.
  7. Compruebe que el catálogo de máquinas que se ha vuelto a crear está asignado al grupo de entrega correcto.
  8. Compruebe que el grupo de entrega se encuentra en modo de mantenimiento y que las máquinas que contiene están apagadas.
  9. Modifique el archivo .xml generado por el script de copia de seguridad:
    • ESX o Hyper-V: Si ha restaurado los discos vDisk en una nueva carpeta del nuevo recurso de almacenamiento del paso 3, para cada sección PVD del archivo, reemplace el nombre de la carpeta de DiskName con la ubicación de los discos vDisk restaurados. Si ha restaurado los discos vDisk en la ruta original en el nuevo almacenamiento, omita este paso.
    • XenServer: Omita este paso.
  10. En el Controller, ejecute migration-restore.ps1 y especifique el nombre del archivo XML y la ubicación donde se almacenan los discos vDisk de copia de seguridad.

Ejemplo 2: Restaurar un catálogo de máquinas y sus discos Personal vDisk volviendo a utilizar nombres de máquinas existentes

En este caso, se restaura todo un catálogo de máquinas y los discos Personal vDisk conectados a las máquinas que contiene. Se vuelven a utilizar nombres de máquinas existentes (erróneas). Este caso puede darse cuando el hipervisor o un host de almacenamiento fallan.
  1. Ejecute migration-backup.ps1 para capturar la asignación de usuarios con sus discos Personal vDisk.
  2. A través de una solución para copias de seguridad, traslade o capture los discos Personal vDisk del catálogo de máquinas a un disco:
    • ESX o Hyper-V: los discos Personal vDisk se encuentran en la unidad de almacenamiento especificada por el Controller, en una carpeta que contiene el nombre de la máquina a la que el disco vDisk está conectado.
    • XenServer: los discos Personal vDisk se encuentran en la raíz de la unidad de almacenamiento que especifica el Controller. El nombre de cada disco vDisk es un GUID.
  3. Restaure los discos Personal vDisk del catálogo de máquinas con una solución para copias de seguridad de almacenamiento:
    • ESX o Hyper-V: localice los discos vDisk en una nueva carpeta del nuevo recurso de almacenamiento.
    • XenServer: localice los discos vDisk en la raíz del nuevo recurso de almacenamiento.
  4. Cree un disco vDisk de Provisioning Services o una instantánea de Machine Creation Services de la imagen maestra que utilizó para crear el catálogo de máquinas erróneo.
  5. Ejecute la opción Actualizar inventario del menú Inicio del disco vDisk o de la instantánea.
  6. Vuelva a crear el catálogo de máquinas en Studio con la misma convención de nomenclatura que el catálogo de máquinas erróneo. Esto genera un catálogo de nuevas máquinas, cada una con un nuevo disco Personal vDisk, que la base de datos del sitio reconoce.
  7. Compruebe que el catálogo de máquinas que se ha vuelto a crear está asignado al grupo de entrega correcto.
  8. Compruebe que el grupo de escritorios se encuentra en modo de mantenimiento y las máquinas que contiene están apagadas.
  9. Modifique el archivo .xml generado por el script de copia de seguridad:
    • ESX o Hyper-V: Por cada sección PVD del archivo, reemplace el nombre de la carpeta de DiskName con la ubicación de los discos vDisk restaurados.
    • XenServer: Omita este paso.
  10. Ejecute el script migration-restore.ps1 en el Controller con el archivo XML modificado como entrada. El script conecta los discos vDisk sin moverlos de lugar.
  11. Compruebe que los datos de los usuarios se han restaurado correctamente.

Ejemplo 3: Restaurar un subconjunto de discos Personal vDisk de un catálogo de máquinas

En este caso, algunos de los discos Personal vDisk, aunque no todos, de un catálogo de máquinas tienen errores y se restaurarán. No se ha producido ningún error en las máquinas virtuales del catálogo.
  1. Ejecute migration-backup.ps1 para capturar la asignación de usuarios con sus discos Personal vDisk en el archivo .xml.
  2. El archivo .xml tiene una sección PVD para cada usuario del catálogo de máquinas. Para los usuarios cuyos discos Personal vDisk no se necesitan restaurar, quite a los usuarios y sus secciones asociadas del archivo.
  3. Restaure los discos Personal vDisk del catálogo de máquinas original con una solución para copias de seguridad, tal y como se describe en el primero de los demás casos:
    • Para usar nuevos nombres de máquina, siga el ejemplo 1.
    • Para mantener los nombres de las máquinas, siga el ejemplo 2.
  4. Asegúrese de que hay suficientes máquinas sin asignar en el catálogo. Agregue máquinas si es necesario. Necesita una nueva máquina para cada usuario cuyo disco vDisk desea restaurar.
  5. Compruebe que el grupo de escritorios se encuentra en modo de mantenimiento y las máquinas que contiene están apagadas.
  6. En el Controller, ejecute migration-restore.ps1 con el archivo XML modificado como entrada.
  7. Compruebe que los datos de los usuarios se han restaurado correctamente.