Guía de implementación de MSI de Alchemy Player

Algunas empresas prefieren instalar aplicaciones automáticamente desde un servicio de TI centralizado. .MSI es un paquete estándar que Windows utiliza para instalar, mantener y eliminar software. Esto puede simplificar el proceso cuando se necesita coordinar una instalación en muchas computadoras y ubicaciones. Actúa como una base de datos estructurada que contiene todas las instrucciones y archivos necesarios para que un programa funcione correctamente en las computadoras de su organización.

Formatos de instalador disponibles

• MSI - Implementación empresarial mediante SCCM, Intune, GPO u otras herramientas centrales de TI
• EXE - Instalación manual por parte de los usuarios finales (carga incluida autocontenida e idéntica a la del MSI)

Modelo de actualización: Este MSI es solo para clientes que realizan actualizaciones manuales. Los clientes del servicio de actualización automática de Alchemy reciben las actualizaciones automáticamente mediante el servicio Updater; no es necesario volver a implementar el MSI.

1. Qué se instala

El MSI siempre instala juntos los dos componentes siguientes; no existe la opción de instalar uno sin el otro:

• Alchemy Player - Aplicación principal de escritorio (Alchemy.Sistem.Shell.exe) 
• Alchemy Player Updater Service - Servicio de Windows en segundo plano que administra las futuras actualizaciones de la aplicación. Garantiza que el software de Alchemy Player esté actualizado. Si este servicio está deshabilitado, Alchemy Player no podrá buscar ni instalar actualizaciones. Este servicio se desinstala automáticamente cuando no se detecta Alchemy Player en la máquina. 
  • Las actualizaciones automáticas se pueden deshabilitar para los clientes que desean controlar todas las actualizaciones por sí mismos.

Sistemas operativos Windows para clientes | En un entorno limpio con solo la instalación base de Windows: Windows 10 y 11 (sin requisitos previos). No se requieren tiempos de ejecución adicionales de .NET ni de Visual C++.

Sistemas operativos Windows para clientes | Windows 10 y 11 con .NET 8.0+ ya instalado: La implementación autocontenida no entra en conflicto con ninguna versión existente de .NET en la máquina. El instalador funciona correctamente en ambos escenarios.

Si realiza una actualización, asegúrese de que Player no esté abierto ni en uso. De lo contrario, programe la implementación fuera del horario laboral. Deben empaquetar TODOS los archivos y carpetas incluidos con los archivos del instalador, y no solo el archivo AlchemyPlayerSetup.exe. No hacerlo puede causar problemas. Por ejemplo, si los archivos de CoursePlayer no se incluyen, es posible que los cursos no se reproduzcan correctamente.

2. Accesos directos creados

Alchemy Player -> Escritorio (destino: Alchemy.Sistem.Shell.exe)

Alchemy Player -> Menú Inicio > Alchemy Systems (destino: Alchemy.Sistem.Shell.exe)

Client Media -> Escritorio (destino: carpeta CLIENT_MEDIA)

Client Media -> Menú Inicio > Alchemy Systems (destino: carpeta CLIENT_MEDIA)

3. Implementación silenciosa: referencia de la línea de comandos

Comando anterior de instalación silenciosa de EXE (como referencia): AlchemyPlayerSetup.exe /s /v"/qn" 

El MSI lo reemplaza con la sintaxis estándar de msiexec que se muestra a continuación.

  Importante: las carpetas deben existir antes de ejecutar cualquier comando: El motor de msiexec no crea automáticamente ninguna carpeta. Si el directorio especificado no existe, msiexec no podrá iniciar la instalación. En los ejemplos siguientes se utiliza C:\Logs; asegúrese de que esta carpeta (o la ruta que elija) exista en la máquina de destino antes de ejecutar cualquier comando.

  Se recomienda ampliamente el registro detallado para todas las implementaciones. Todos los ejemplos siguientes incluyen la marca /l*v. Almacene los archivos de registro en un directorio protegido con acceso de lectura restringido y elimínelos después de confirmar que la implementación se realizó correctamente. Para diagnosticar un error, busque en el registro Return value 3; esto marca el punto en el que falló una acción personalizada.

Referencia completa de msiexec: Para obtener la lista completa de modificadores y opciones de msiexec, consulte la documentación de Microsoft: https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/msiexec

3.1 Instalación silenciosa (sin interfaz de usuario)

msiexec /i "AlchemyPlayerSetup.msi" /quiet /l*v "C:\Logs\AlchemyPlayer_install.log"

• /quiet = silenciosa, sin interacción del usuario
• /l*v = registro detallado (se recomienda ampliamente para todas las implementaciones)

3.2 Instalación silenciosa: cierre forzado de la aplicación deshabilitado (predeterminado)

Comportamiento predeterminado. El instalador no cerrará la aplicación a la fuerza:
msiexec /i "AlchemyPlayerSetup.msi" /quiet /norestart /l*v "C:\Logs\install.log"

3.3 Instalación silenciosa: cierre forzado de la aplicación habilitado

Fuerza el cierre automático de Alchemy Player antes de continuar con la instalación. Úselo cuando realice implementaciones en máquinas donde Player podría estar ejecutándose:
msiexec /i "AlchemyPlayerSetup.msi" /quiet /forcerestart /l*v "C:\Logs\install.log"

3.4 Actualización silenciosa (desde cualquier versión anterior)

No se necesita un paso de desinstalación independiente. El MSI elimina la versión anterior e instala la nueva en una sola operación:
msiexec /i "AlchemyPlayerSetup.msi" /quiet /l*v "C:\Logs\AlchemyPlayer_upgrade.log“

3.5 Desinstalación silenciosa

El comando de desinstalación acepta la propiedad PRESERVESETTINGS para controlar si se conservan o se eliminan por completo la configuración y los datos existentes.

• PRESERVESETTINGS=1 (predeterminado) — Conserva la configuración existente, los datos de contenido y las entradas del registro. Úselo para los flujos de trabajo estándar de desinstalación/reinstalación a fin de evitar perder la configuración del cliente.
• PRESERVESETTINGS=0 — Realiza una eliminación completa de todos los datos de Alchemy Player, incluidos C:\ProgramData\Alchemy Systems\ y todas las entradas del registro. Úselo para retirar una máquina o realizar una reinstalación desde cero.

Escenario 1 — Desinstalar conservando la configuración y los datos (predeterminado recomendado):

          msiexec /x "AlchemyPlayerSetup.msi" /quiet PRESERVESETTINGS=1 /l*v"C:\Logs\uninstall.log"

Escenario 2 — Desinstalar y eliminar toda la configuración y los datos (eliminación limpia):

        msiexec /x "AlchemyPlayerSetup.msi" /quiet PRESERVESETTINGS=0 /l*v"C:\Logs\uninstall.log"

3.6 Directorio de instalación personalizado

msiexec/i"AlchemyPlayerSetup.msi"/quietINSTALLDIR="D:\Apps\AlchemyPlayer\"/l*v"C:\Logs\install.log"

En este ejemplo, INSTALLDIR se creará durante la instalación con el comando msiexec.

4. Referencia de propiedades del MSI

INSTALLDIR:  Ruta | Predeterminado: C:\Program Files (x 86)\AlchemySystems/Player | Directorio de instalación de la aplicación

ALLUSERS:  1 | Predeterminado: 1 | Instalación para todo el sistema; no cambiar

PRESERVESETTINGS:  0 o 1 | Predeterminado: 1 | Conserva la configuración existente durante la actualización

REBOOT:  Suppress / Force / Prompt | Predeterminado: Prompt | Controla el comportamiento del reinicio

TRANSFORMS:  Ruta del archivo .mst | Predeterminado: ninguno | Aplica una transformación de idioma (consulte la sección 6)

5. Compatibilidad con idiomas: archivos de transformación (MST)

La instalación predeterminada está en inglés (EE. UU.). Pase el archivo MST correspondiente mediante TRANSFORMS para instalar una versión localizada.

Ejemplo: instalación silenciosa en francés: 

msiexec /i"AlchemyPlayerSetup.msi"TRANSFORMS="AlchemyPlayer_1036.mst"/quiet/l*v"C:\Logs\install.log"

Cambio de idioma: El idioma del MSI se establece durante la instalación mediante la propiedad TRANSFORMS y no se puede cambiar sin volver a instalar. Para cambiar el idioma de una máquina implementada, realice una desinstalación silenciosa (sección 9.5) seguida de una instalación silenciosa nueva que especifique el valor TRANSFORMS deseado. La configuración y los datos existentes se conservan de forma predeterminada (PRESERVESETTINGS=1) durante este proceso.

Preguntas frecuentes (FAQ)

P: ¿Es necesario que .NET esté instalado en la máquina antes de realizar la implementación?

R: No. Alchemy Player 8.4.0 y las versiones posteriores son autocontenidos y no requieren una instalación independiente de .NET. Se instala en una máquina limpia sin requisitos previos.

P: ¿Entra en conflicto con .NET 8.0+ ya instalado en la máquina?

R: No. Se validó en máquinas con .NET 8.0+ preinstalado. El modelo autocontenido coexiste correctamente con cualquier versión existente de .NET.

P: ¿Qué ocurre si la máquina ya tiene instalada una versión más reciente?

R: El instalador detecta la versión instalada y bloquea la instalación si ya existe una versión más reciente. La instalación existente no se modifica.

P: ¿Qué controladores se incluyen con el instalador? ¿Los usuarios finales deben instalar los controladores por separado?

R: No. Los siguientes componentes se incluyen y se instalan silenciosamente como parte del MSI; los usuarios finales no necesitan realizar ningún paso manual:

Detalles del controlador para aprobación previa de seguridad: Proveedor: Silicon Laboratories, Inc. | ID de hardware:
SLABCOMM&10C4&EA60 | Certificación: firmado por WHQL

P: ¿Qué es SQLite DB Browser y por qué se instala?

R: Alchemy Player utiliza SQLite como su base de datos interna para almacenar datos localmente en caché (información del usuario, inscripción y registros de capacitación), lo que reduce las llamadas continuas al servidor de Alchemy Manager. SQLite DB Browser es una herramienta de visualización complementaria incluida en INSTALLDIR\Tools\ únicamente para fines de soporte y diagnóstico; no es necesaria para el funcionamiento normal de Alchemy Player.

P: ¿Debemos configurar exclusiones del antivirus para Alchemy Player?

R: En la mayoría de los entornos no se necesitan exclusiones. Si el análisis antivirus en tiempo real causa problemas de rendimiento (como un inicio lento de la aplicación o retrasos en el acceso a los archivos), considere excluir:

•C:\Program Files (x86)\Alchemy Systems\Player\ •C:\ProgramData\Alchemy Systems\Sistem\

P: ¿Qué reglas de firewall se requieren para Alchemy Player?

R: Alchemy Player se conecta de salida al servidor de Alchemy Manager. Asegúrese de que las reglas del firewall permitan el tráfico HTTPS saliente desde la máquina instalada al host de Manager. No se requieren puertos entrantes.

P: ¿La instalación solicitará un reinicio?

R: Por lo general, no. Pase REBOOT=Suppress en la línea de comandos para garantizar que no haya ningún reinicio durante la implementación silenciosa.

P: ¿Qué sucede con el contenido del usuario durante una actualización?

R: Todo el contenido de C:\ProgramData\Alchemy Systems\Sistem\ se conserva. Los archivos de configuración se respaldan y restauran automáticamente.

P: Usamos el servicio de actualización automática de Alchemy. ¿Necesitamos este MSI para actualizar Player?

R: Para las actualizaciones de versión de Player, no. Los sistemas configurados para usar el servicio de actualización automática de Alchemy reciben las actualizaciones de Player automáticamente. Sin embargo, el MSI aún se puede utilizar para implementaciones iniciales o instalaciones por primera vez.  

P: ¿El MSI incluye la misma carga que el instalador EXE?

R: Sí. Ambos son autocontenidos e instalan la misma aplicación. El MSI se proporciona para entornos que requieren una implementación basada en MSI (SCCM, Intune, GPO).

P: ¿Podemos preparar archivos de configuración personalizados antes de la implementación?

R: Sí. Coloque sistem_specific.xml y RF_CODES.txt en el directorio ClientConfig del instalador antes de ejecutar el MSI.

P: ¿Con quién debo comunicarme si tengo preguntas adicionales o específicas?

R: Equipo de implementación - Comuníquese con su gerente de implementación de Alchemy
Soporte técnico - Mesa de ayuda de Alchemy Client Services 888.988.8832 

El PDF de este artículo está disponible para descargar a continuación. Actualmente solo está disponible en inglés.