Guide de déploiement MSI d’Alchemy Player

Certaines entreprises préfèrent installer automatiquement les applications à partir d’un service informatique centralisé. .MSI est un package standard utilisé par Windows pour installer, gérer et supprimer des logiciels. Cela peut simplifier le processus lorsqu’il faut coordonner une installation sur de nombreux ordinateurs et emplacements. Il agit comme une base de données structurée contenant toutes les instructions et tous les fichiers nécessaires au bon fonctionnement d’un programme sur les ordinateurs de votre organisation.

Formats d’installation disponibles

• MSI - Déploiement d’entreprise via SCCM, Intune, GPO ou d’autres outils informatiques centralisés
• EXE - Installation manuelle par les utilisateurs finaux (package autonome, identique à celui du MSI)

Modèle de mise à jour : ce MSI est destiné uniquement aux clients qui effectuent les mises à jour manuellement. Les clients qui utilisent le service de mise à jour automatique d’Alchemy reçoivent les mises à jour automatiquement par l’intermédiaire du service de mise à jour; aucun redéploiement du MSI n’est nécessaire.

1. Éléments installés

Le MSI installe toujours les deux composants suivants ensemble; il n’est pas possible d’en installer un sans l’autre :

• Alchemy Player - Application de bureau principale (Alchemy.Sistem.Shell.exe) 
• Service de mise à jour d’Alchemy Player - Service Windows en arrière-plan qui gère les futures mises à jour de l’application. Veille à ce que le logiciel Alchemy Player soit à jour. Si ce service est désactivé, Alchemy Player ne pourra pas rechercher ni installer les mises à jour. Ce service se désinstalle automatiquement lorsqu’Alchemy Player n’est pas détecté sur l’ordinateur. 
  • Les mises à jour automatiques peuvent être désactivées pour les clients qui souhaitent gérer eux-mêmes toutes les mises à jour.

Systèmes d’exploitation Windows clients | Dans un environnement vierge avec uniquement l’installation de base de Windows : Windows 10 et 11 (aucun prérequis). Aucun environnement d’exécution .NET ou Visual C++ supplémentaire n’est requis.

Systèmes d’exploitation Windows clients | Windows 10 et 11 avec .NET 8.0 ou une version ultérieure déjà installé : le déploiement autonome n’entre pas en conflit avec les versions existantes de .NET sur l’ordinateur. Le programme d’installation fonctionne correctement dans les deux scénarios.

Si vous effectuez une mise à niveau, assurez-vous que Player n’est pas ouvert ni utilisé. Sinon, planifiez le déploiement en dehors des heures d’utilisation. Ils doivent inclure TOUS les fichiers et dossiers compris dans les fichiers du programme d’installation, et pas seulement le fichier AlchemyPlayerSetup.exe. Le non-respect de cette consigne peut causer des problèmes. Par exemple, si les fichiers de CoursePlayer ne sont pas inclus, les cours pourraient ne pas être lus correctement.

2. Raccourcis créés

Alchemy Player -> Bureau (cible : Alchemy.Sistem.Shell.exe)

Alchemy Player -> Menu Démarrer > Alchemy Systems (cible : Alchemy.Sistem.Shell.exe)

Client Media -> Bureau (cible : dossier CLIENT_MEDIA)

Client Media -> Menu Démarrer > Alchemy Systems (cible : dossier CLIENT_MEDIA)

3. Déploiement silencieux - Référence de la ligne de commande

Ancienne commande d’installation silencieuse EXE (à titre de référence) : AlchemyPlayerSetup.exe /s /v"/qn" 

Le MSI remplace cette commande par la syntaxe msiexec standard présentée ci-dessous.

  Important : les dossiers doivent exister avant l’exécution de toute commande : le moteur msiexec ne crée automatiquement aucun dossier. Si le répertoire indiqué n’existe pas, msiexec ne pourra pas démarrer l’installation. Dans les exemples ci-dessous, C:\Logs est utilisé; assurez-vous que ce dossier (ou le chemin de votre choix) existe sur l’ordinateur cible avant d’exécuter une commande.

  La journalisation détaillée est fortement recommandée pour tous les déploiements. Tous les exemples ci-dessous comprennent l’indicateur /l*v. Stockez les fichiers journaux dans un répertoire protégé dont l’accès en lecture est limité et supprimez-les après avoir confirmé la réussite du déploiement. Pour diagnostiquer un échec, recherchez value 3 après Return dans le journal — cela indique le point où une action personnalisée a échoué.

Référence complète des commandes msiexec : pour obtenir la liste complète des commutateurs et options msiexec, consultez la documentation de Microsoft : https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/msiexec

3.1 Installation silencieuse (sans interface utilisateur)

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

• /quiet = silencieuse, sans interaction de l’utilisateur
• /l*v = journal détaillé (fortement recommandé pour tous les déploiements)

3.2 Installation silencieuse - Fermeture forcée de l’application désactivée (par défaut)

Comportement par défaut. Le programme d’installation ne forcera pas la fermeture de l’application :
msiexec /i "AlchemyPlayerSetup.msi" /quiet /norestart /l*v "C:\Logs\install.log"

3.3 Installation silencieuse - Fermeture forcée de l’application activée

Force la fermeture automatique d’Alchemy Player avant le début de l’installation. À utiliser lors du déploiement sur des ordinateurs où Player pourrait être en cours d’exécution :
msiexec /i "AlchemyPlayerSetup.msi" /quiet /forcerestart /l*v "C:\Logs\install.log"

3.4 Mise à niveau silencieuse (à partir de toute version précédente)

Aucune étape de désinstallation distincte n’est nécessaire. Le MSI supprime l’ancienne version et installe la nouvelle en une seule opération :
msiexec /i "AlchemyPlayerSetup.msi" /quiet /l*v "C:\Logs\AlchemyPlayer_upgrade.log“

3.5 Désinstallation silencieuse

La commande de désinstallation accepte la propriété PRESERVESETTINGS pour déterminer si la configuration et les données existantes sont conservées ou complètement supprimées.

• PRESERVESETTINGS=1 (par défaut) — Conserve la configuration existante, les données de contenu et les entrées de registre. Utilisez cette valeur pour les procédures standard de désinstallation/réinstallation afin d’éviter de perdre les paramètres du client.
• PRESERVESETTINGS=0 — Effectue une suppression complète de toutes les données d’Alchemy Player, notamment C:\ProgramData\Alchemy Systems\ et toutes les entrées de registre. Utilisez cette valeur pour mettre un ordinateur hors service ou effectuer une réinstallation complète.

Scénario 1 — Désinstallation en conservant les paramètres et les données (valeur par défaut recommandée) :

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

Scénario 2 — Désinstallation et suppression de tous les paramètres et données (suppression complète) :

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

3.6 Répertoire d’installation personnalisé

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

Dans cet exemple, INSTALLDIR sera créé lors de l’installation avec la commande msiexec.

4. Référence des propriétés MSI

INSTALLDIR :  Chemin  |  Valeur par défaut : C:\Program Files (x 86)\AlchemySystems/Player  | Répertoire d’installation de l’application

ALLUSERS :  1  |  Valeur par défaut : 1  |  Installation à l’échelle du système - ne pas modifier

PRESERVESETTINGS :  0 ou 1  |  Valeur par défaut : 1  |  Conserver la configuration existante lors de la mise à niveau

REBOOT :  Supprimer / Forcer / Demander  |  Valeur par défaut : Demander  |  Contrôle le comportement du redémarrage

TRANSFORMS :  Chemin du fichier .mst  |  Valeur par défaut : aucune  |  Appliquer une transformation linguistique (voir la section 6)

5. Prise en charge des langues - Fichiers de transformation (MST)

L’installation par défaut est en anglais (États-Unis). Transmettez le fichier MST correspondant au moyen de TRANSFORMS pour installer une version localisée.

Exemple - installation silencieuse en français : 

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

Changement de langue : la langue du MSI est définie au moment de l’installation au moyen de la propriété TRANSFORMS et ne peut pas être modifiée sans réinstaller le logiciel. Pour remplacer la langue d’un ordinateur déployé, effectuez une désinstallation silencieuse (section 9.5), puis une nouvelle installation silencieuse en indiquant la valeur TRANSFORMS souhaitée. Les paramètres et les données existants sont conservés par défaut (PRESERVESETTINGS=1) pendant ce processus.

Foire aux questions (FAQ)

Q : .NET doit-il être installé sur l’ordinateur avant le déploiement?

R : Non. Alchemy Player 8.4.0 et les versions ultérieures sont autonomes et ne nécessitent pas d’installation distincte de .NET. Il s’installe sur un ordinateur vierge sans aucun prérequis.

Q : Le logiciel entre-t-il en conflit avec .NET 8.0 ou une version ultérieure déjà installée sur l’ordinateur?

R : Non. Le logiciel a été validé sur des ordinateurs où .NET 8.0 ou une version ultérieure était préinstallé. Le modèle autonome coexiste correctement avec toute version existante de .NET.

Q : Que se passe-t-il si une version plus récente est déjà installée sur l’ordinateur?

R : Le programme d’installation détecte la version installée et bloque l’installation si une version plus récente est déjà présente. L’installation existante n’est pas modifiée.

Q : Quels pilotes sont inclus dans le programme d’installation? Les utilisateurs finaux doivent-ils installer les pilotes séparément?

R : Non. Les composants suivants sont inclus et installés silencieusement dans le cadre du MSI; les utilisateurs finaux n’ont aucune étape manuelle à effectuer :

Détails du pilote pour l’approbation préalable de la sécurité : fournisseur : Silicon Laboratories, Inc. | ID matériel :
SLABCOMM&10C4&EA60 | Certification : signé WHQL

Q : Qu’est-ce que SQLite DB Browser et pourquoi est-il installé?

R : Alchemy Player utilise SQLite comme base de données interne pour mettre en cache les données localement (renseignements sur les utilisateurs, inscriptions, dossiers de formation), ce qui réduit les appels continus au serveur Alchemy Manager. SQLite DB Browser est un outil d’affichage complémentaire inclus dans INSTALLDIR\Tools\ à des fins d’assistance et de diagnostic seulement; il n’est pas requis pour le fonctionnement normal d’Alchemy Player.

Q : Devrions-nous configurer des exclusions antivirus pour Alchemy Player?

R : Dans la plupart des environnements, aucune exclusion n’est nécessaire. Si l’analyse antivirus en temps réel entraîne des problèmes de performance (comme le ralentissement du lancement de l’application ou des délais d’accès aux fichiers), envisagez d’exclure :

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

Q : Quelles règles de pare-feu sont requises pour Alchemy Player?

R : Alchemy Player établit des connexions sortantes vers le serveur Alchemy Manager. Assurez-vous que les règles du pare-feu autorisent le trafic HTTPS sortant de l’ordinateur où le logiciel est installé vers l’hôte Manager. Aucun port entrant n’est requis.

Q : L’installation demandera-t-elle un redémarrage?

R : Habituellement, non.  Transmettez REBOOT=Suppress sur la ligne de commande pour garantir qu’aucun redémarrage n’aura lieu pendant le déploiement silencieux.

Q : Qu’arrive-t-il au contenu utilisateur pendant une mise à niveau?

R : Tout le contenu de C:\ProgramData\Alchemy Systems\Sistem\ est conservé. Les fichiers de configuration sont sauvegardés et restaurés automatiquement.

Q : Nous utilisons le service de mise à jour automatique d’Alchemy. Avons-nous besoin de ce MSI pour les mises à niveau de Player?

R : Pour les mises à niveau de version de Player, non. Les systèmes configurés pour utiliser le service de mise à jour automatique d’Alchemy reçoivent automatiquement les mises à jour de Player. Toutefois, le MSI peut quand même être utilisé pour les déploiements initiaux ou les premières installations.  

Q : Le MSI contient-il le même package que le programme d’installation EXE?

R : Oui. Les deux packages sont autonomes et installent la même application. Le MSI est fourni pour les environnements qui exigent un déploiement fondé sur MSI (SCCM, Intune, GPO).

Q : Pouvons-nous préparer à l’avance des fichiers de configuration personnalisés avant le déploiement?

R : Oui. Placez sistem_specific.xml et RF_CODES.txt dans le répertoire ClientConfig du programme d’installation avant d’exécuter le MSI.

Q : Qui dois-je contacter pour des questions supplémentaires ou particulières?

R : Équipe de mise en œuvre - Communiquez avec votre gestionnaire de mise en œuvre Alchemy
Soutien technique - Centre d’assistance Alchemy Client Services 888.988.8832 

Le PDF de cet article est disponible en téléchargement ci-dessous. Il est actuellement offert en anglais seulement.