# Administración del paquete de componentes de VSS para las instantáneas de EBS basadas en VSS de Windows
Antes de crear instantáneas de EBS basadas en VSS, asegúrese de tener instalada la última versión del paquete de componentes de VSS en su instancia de Windows. Existen varias formas de instalar el paquete `AwsVssComponents` en una instancia existente, como se indica a continuación:
+ (Recomendado) [Ejecute el documento de comandos AWSEC2-VssInstallAndSnapshot (recomendado)](create-vss-snapshots-ssm.md#create-with-AWSEC2-VssInstallAndSnapshot). Se instala o actualiza automáticamente, si es necesario, cada vez que se ejecuta.
+ [Instalación manual de los componentes de VSS en una instancia de Windows de EC2](#install-vss-comps).
+ [Actualización del paquete de componentes de VSS en su instancia de Windows de EC2](#update-vss-comps).
También puede crear una AMI con el Generador de imágenes de EC2 que use el componente administrado por `aws-vss-components-windows` a fin de instalar el paquete `AwsVssComponents` para la imagen. El componente administrado usa el Distribuidor de AWS Systems Manager para instalar el paquete. Una vez que el Generador de imágenes cree la imagen, todas las instancias que lance desde la AMI asociada tendrán el paquete VSS instalado. Para obtener más información sobre cómo crear una AMI con el paquete VSS instalado, consulte [Componentes administrados mediante paquetes del Distribuidor para Windows](https://docs.aws.amazon.com/imagebuilder/latest/userguide/mgdcomponent-distributor-win.html) en la *Guía del usuario del Generador de imágenes de EC2*.
**Topics**
+ [Instalación manual](#install-vss-comps)
+ [Actualización de componentes](#update-vss-comps)
## Instalación manual de los componentes de VSS en una instancia de Windows de EC2
Su instancia de EC2 de Windows debe tener componentes VSS instalados antes de poder crear instantáneas coherentes con las aplicaciones con Systems Manager. Si no ejecuta el documento de comandos `AWSEC2-VssInstallAndSnapshot` para instalar o actualizar automáticamente el paquete cada vez que crea instantáneas coherentes con las aplicaciones, debe instalar el paquete manualmente.
También debe realizar la instalación manualmente si piensa usar uno de los siguientes métodos para crear instantáneas coherentes con las aplicaciones a partir de su instancia de EC2.
+ Creación de instantáneas de VSS mediante AWS Backup
+ Creación de instantáneas de VSS con Amazon Data Lifecycle Manager
Si necesita realizar una instalación manual, le recomendamos que instale el paquete de componentes de AWS VSS más reciente para mejorar la fiabilidad y el rendimiento de las instantáneas coherentes con las aplicaciones en las instancias de EC2 de Windows.
**nota**
Para instalar o actualizar automáticamente el paquete `AwsVssComponents` cada vez que cree instantáneas coherentes con las aplicaciones, le recomendamos que utilice Systems Manager para ejecutar el documento `AWSEC2-VssInstallAndSnapshot`. Para obtener más información, consulte [Ejecute el documento de comandos AWSEC2-VssInstallAndSnapshot (recomendado)](create-vss-snapshots-ssm.md#create-with-AWSEC2-VssInstallAndSnapshot).
Para instalar los componentes de VSS en una instancia de Windows de Amazon EC2, siga los pasos de su entorno de preferencia.
------
#### [ Console ]
**Para instalar los componentes de VSS mediante el Distribuidor de SSM**
1. Abra la consola de AWS Systems Manager en [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. En el panel de navegación, elija **Ejecutar comando**.
1. Elija **Run command (Ejecutar comando)**.
1. En **Documento de comando**, seleccione el botón situado junto a **AWS-ConfigureAWSPackage**.
1. En **Parámetros de comando** haga lo siguiente:
1. Compruebe que **Acción** está establecido en **Instalar**.
1. En **Nombre**, escriba `AwsVssComponents`.
1. En **Versión**, escriba una versión o deje el campo vacío para que Systems Manager instale la versión más reciente.
1. En **Destinos**, identifique las instancias en las que desea ejecutar esta operación especificando las etiquetas o seleccione las instancias manualmente.
**nota**
Si decide seleccionar las instancias manualmente y una de las instancias que desea utilizar no figura en la lista, consulte [¿Dónde están mis instancias?](https://docs.aws.amazon.com/systems-manager/latest/userguide/troubleshooting-remote-commands.html#where-are-instances) en la *Guía del usuario de AWS Systems Manager* para obtener sugerencias sobre la solución del problema.
1. En **Otros parámetros**:
+ (Opcional) En **Comentario**, escriba la información acerca de este comando.
+ En **Tiempo de espera (segundos)**, especifique el número de segundos que tiene que esperar el sistema antes de indicar que se ha producido un error en la ejecución del comando general.
1. (Opcional) En **Control de velocidad**:
+ En **Concurrencia**, especifique un número o un porcentaje de las instancias en las que desea ejecutar el comando al mismo tiempo.
**nota**
Si selecciona destinos mediante la elección de etiquetas Amazon EC2 y no está seguro de cuántas instancias utilizan las etiquetas seleccionadas, limite el número de instancias que puede ejecutar el documento al mismo tiempo. Para ello, especifique un porcentaje.
+ En **Umbral de errores**, especifique cuándo desea parar la ejecución del comando en las demás instancias después de que haya fallado en un número o un porcentaje de las instancias. Por ejemplo, si especifica tres errores, Systems Manager dejará de enviar el comando cuando se reciba el cuarto error. Las instancias que estén procesando el comando todavía pueden enviar errores.
1. (Opcional) En la sección **Opciones de salida**, si desea guardar la salida del comando en un archivo, seleccione **Escribir la salida del comando en un bucket de S3**. Especifique el bucket y los nombres de prefijo (carpeta) (opcionales).
**nota**
Los permisos de S3 que conceden la capacidad de escribir datos en un bucket de S3 son los del perfil de instancia asignado a la instancia, no los del usuario que lleva a cabo esta tarea. Para obtener más información, consulte [Configuración de permisos de instancias de EC2](https://docs.aws.amazon.com/systems-manager/latest/userguide/setup-instance-permissions.html#instance-profile-add-permissions) en la *Guía para usuarios de AWS Systems Manager*.
1. (Opcional) Especifique las opciones de **Notificaciones SNS**.
Para obtener información acerca de la configuración de las notificaciones de Amazon SNS para Run Command, consulte [Configuración de las notificaciones de Amazon SNS para AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/monitoring-sns-notifications.html).
1. Elija **Ejecutar**.
------
#### [ AWS CLI ]
Siga el procedimiento que se indica a continuación para descargar e instalar el paquete de `AwsVssComponents` en sus instancias con Run Command desde la AWS CLI. El paquete instala dos componentes: un solicitante de VSS y un proveedor de VSS. El sistema copia estos componentes en un directorio de la instancia y, a continuación, registra la DLL del proveedor como proveedor de VSS.
**Para instalar el paquete VSS**
Ejecute el siguiente comando para descargar e instalar los componentes VSS requeridos para Systems Manager.
```
aws ssm send-command \
--document-name "AWS-ConfigureAWSPackage" \
--instance-ids "i-1234567890abcdef0" \
--parameters '{"action":["Install"],"name":["AwsVssComponents"]}'
```
------
#### [ PowerShell ]
Siga el procedimiento que se indica a continuación para descargar e instalar el paquete de `AwsVssComponents` en sus instancias con Run Command desde las herramientas para Windows PowerShell. El paquete instala dos componentes: un solicitante de VSS y un proveedor de VSS. El sistema copia estos componentes en un directorio de la instancia y, a continuación, registra la DLL del proveedor como proveedor de VSS.
**Para instalar el paquete VSS**
Ejecute el siguiente comando para descargar e instalar los componentes VSS requeridos para Systems Manager.
```
Send-SSMCommand `
-DocumentName "AWS-ConfigureAWSPackage" `
-InstanceId "i-1234567890abcdef0" `
-Parameter @{'action'='Install';'name'='AwsVssComponents'}
```
------
### Verificación de la firma en los componentes de VSS de AWS
Utilice el siguiente procedimiento para verificar la firma en el paquete `AwsVssComponents`.
1. Conéctese a la instancia de Windows. Para obtener más información, consulte [Conexión a una instancia de Windows de mediante RDP](connecting_to_windows_instance.md).
1. Vaya a C:\$1Program Files\$1Amazon\$1AwsVssComponents.
1. Abra el menú contextual de `ec2-vss-agent.exe` (con el botón derecho del ratón) y, a continuación, elija **Propiedades**.
1. Vaya a la pestaña **Firmas digitales** y compruebe que el nombre del firmante sea Amazon Web Services Inc.
1. Siga los pasos anteriores para verificar la firma en `Ec2VssInstaller` y `Ec2VssProvider.dll`.
## Actualización del paquete de componentes de VSS en su instancia de Windows de EC2
Le recomendamos que mantenga siempre actualizados los componentes de VSS con la versión más reciente recomendada. Existen varias formas diferentes de actualizar componentes cuando se inicia una nueva versión del paquete `AwsVssComponents`.
**Métodos de actualización**
+ Puede repetir los pasos descritos en [Instalación manual de los componentes de VSS en una instancia de Windows de EC2](#install-vss-comps) cuando se publique una nueva versión de los componentes de VSS de AWS.
+ Puede configurar una asociación de Systems Manager State Manager para descargar e instalar automáticamente componentes nuevos o actualizados de VSS cuando el paquete `AwsVssComponents` esté disponible.
+ Puede instalar o actualizar automáticamente el paquete `AwsVssComponents` siempre que cree instantáneas coherentes con las aplicaciones, cuando utilice Systems Manager para ejecutar el documento `AWSEC2-VssInstallAndSnapshot`.
**nota**
Se recomienda utilizar Systems Manager para ejecutar el documento de comandos `AWSEC2-VssInstallAndSnapshot`, que instala o actualiza automáticamente el paquete `AwsVssComponents` antes de crear las instantáneas coherentes con las aplicaciones. Para obtener más información, consulte [Ejecute el documento de comandos AWSEC2-VssInstallAndSnapshot (recomendado)](create-vss-snapshots-ssm.md#create-with-AWSEC2-VssInstallAndSnapshot).
Para crear una asociación de Systems Manager State Manager, siga los pasos del entorno que prefiera.
------
#### [ Console ]
Cuando cree una asociación de Systems Manager State Manager, hay dos opciones para actualizar el paquete `AwsVssComponents`, como sigue:
**Desinstalar y volver a instalar**
Este método descarga e instala el paquete sin requisitos previos adicionales.
**Actualización local**
Esto realiza una actualización local para el paquete, y tiene los siguientes requisitos previos:
+ La versión del agente SSM instalada en la instancia debe ser la versión `3.3.808.0` o posterior. Para obtener más información, consulte [Uso de SSM Agent en instancias de Amazon EC2 para Windows Server](https://docs.aws.amazon.com/systems-manager/latest/userguide/ssm-agent-windows.html) en la *Guía delAWS Systems Manager usuario*.
+ Si se especifica, la versión `AwsVssComponents` del paquete debe ser la versión `2.5.0` o posterior. Las versiones anteriores no admiten la actualización local.
Si la instancia no cumple con estos requisitos previos, la actualización local fallará. En su lugar, utilice la opción **Desinstalar y volver a instalar**.
**Para crear una asociación de State Manager**
1. Abra la consola de AWS Systems Manager en [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. En el panel de navegación, elija **Administrador de estados**.
O bien, si primero se abre la página de inicio de Systems Manager, abra el panel de navegación y, a continuación, seleccione **State Manager**.
1. Elija **Crear asociación**.
1. En el campo **Nombre**, ingrese un nombre descriptivo.
1. En la lista **Documento**, elija **AWS-ConfigureAWSPackage**.
1. En la sección **Parámetros**, elija **Instalar** en la lista **Acción**.
1. En **Tipo de instalación**, seleccione **Desinstalar y volver a instalar** o **Actualización local**.
1. En el campo **Nombre**, escriba `AwsVssComponents`. Puede mantener los campos **Versión** y **Argumentos adicionales** vacíos.
1. En la sección **Destinos**, elija una opción.
**nota**
Si elige dirigirse a las instancias mediante etiquetas y especifica etiquetas que se mapean a instancias de Linux, la asociación se realiza correctamente en la instancia de Windows, pero no en las instancias de Linux. El estado general de la asociación muestra **Failed**.
1. En la sección **Especificar programa**, elija una opción.
1. En la sección **Opciones avanzadas**, en **Gravedad de conformidad**, elija un nivel de gravedad para la asociación. Para obtener más información, consulte [Acerca del cumplimiento de asociaciones](https://docs.aws.amazon.com/systems-manager/latest/userguide/compliance-about.html). En **Calendarios de cambios**, seleccione un calendario de cambios preconfigurado. Para obtener más información, consulte [Calendario de cambios AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-change-calendar.html).
1. En **Control de velocidad**, haga lo siguiente:
+ En **Simultaneidad**, especifique un número o un porcentaje de los nodos administrados en los que desea ejecutar el comando al mismo tiempo.
+ En **Umbral de errores**, especifique cuándo desea parar la ejecución del comando en los demás nodos administrados después de que haya fallado en un número o un porcentaje de los nodos.
1. (Opcional) En **Opciones de salida**, para guardar la salida del comando en un archivo, seleccione **Permitir la escritura de salida en S3**. Ingrese los nombres del bucket y del prefijo (carpeta) en los cuadros.
1. Elija **Crear asociación** y, a continuación, **Cerrar**. El sistema intenta crear la asociación en las instancias y aplicar inmediatamente el estado.
**nota**
Si las instancias de EC2 de Windows Server tienen el estado **Error**, asegúrese de que SSM Agent se está ejecutando en la instancia y que esta se ha configurado como un rol de AWS Identity and Access Management (IAM) para Systems Manager. Para obtener más información, consulte [Configuración de AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-ec2.html).
------
#### [ AWS CLI ]
Utilice el comando de [create-association](https://docs.aws.amazon.com/cli/latest/reference/ssm/create-association.html) para actualizar un paquete del distribuidor de forma programada sin desconectar la aplicación asociada. Solo se reemplazan los archivos nuevos o actualizados del paquete.
**Para crear una asociación de State Manager**
Ejecute el siguiente comando para crear una asociación. El valor de `--name`, el nombre del documento, es siempre `AWS-ConfigureAWSPackage`. El comando siguiente utiliza la clave `InstanceIds` para especificar las instancias de destino.
```
aws ssm create-association \
--name "AWS-ConfigureAWSPackage" \
--parameters action=Install,installationType="Uninstall and reinstall",name=AwsVssComponents \
--targets Key=InstanceIds,Values=i-1234567890abcdef0,i-000011112222abcde
```
------
#### [ PowerShell ]
**Para crear una asociación de State Manager**
Utilice el cmdlet [New-SSMAssociation](https://docs.aws.amazon.com/powershell/latest/reference/items/New-SSMAssociation.html).
```
New-SSMAssociation `
-Name "AWS-ConfigureAWSPackage" `
-Parameter @{
"action" = "Install"
"installationType" = "Uninstall and reinstall"
"name" = "AwsVssComponents"
} `
-Target @{
"Key" = "InstanceIds"
"Values" = @("i-1234567890abcdef0", "i-000011112222abcde")
}
```
------