Supprimer une installation partielle de SQL Server

Version du produit d’origine : SQL Server

Numéro de base de connaissances d’origine : 955404

Summary

Une installation ou une mise à niveau ayant échoué SQL Server peut laisser une instance de SQL Server inactive qui bloque les tentatives d’installation ultérieures et peut entraîner l’erreur d’installation 1639. Cet article explique comment utiliser les journaux d’installation et le rapport de découverte des fonctionnalités installées pour identifier et supprimer une installation partielle sans supprimer les instances de travail. Il répertorie également les journaux de diagnostic à collecter si les méthodes de suppression prises en charge échouent.

Symptômes

Une fois qu’une installation ou une mise à niveau SQL Server échoue, une tentative ultérieure d’installation ou de mise à niveau du même SQL Server version sur le même ordinateur peut également échouer. Ce problème est le plus souvent rencontré après une mise à niveau sur place ayant échoué, où l’opération d’installation ayant échoué laisse une instance de SQL Server partiellement installée ou inactive sur l’ordinateur. Vous ne pouvez pas réinstaller SQL Server, car le programme d'installation trouve une instance partielle existante.

Vous pouvez observer un ou plusieurs des symptômes suivants :

  • Une instance apparaît comme <InstanceName>.INACTIVE dans le rapport de découverte des fonctionnalités installées SQL Server.
  • Le programme d’installation signale que l’ID d’instance est déjà utilisé par une instance de SQL Server inactive.
  • Le programme d’installation retourne l’erreur 1639 et le journal des composants contient « MSINEWINSTANCE requiert une nouvelle instance qui n’est pas installée ».
  • Summary.txt vous demande de désinstaller une ou plusieurs fonctionnalités avant de réexécuter le programme d’installation.
  • Une fonctionnalité échoue parce qu’une dépendance a échoué, et le premier échec dans les journaux indique une instance incomplète ou une source d’installation indisponible.

La cause

Si le programme d’installation de SQL Server échoue lors de l’installation, une instance partiellement installée peut rester sur l’ordinateur. Le programme d’installation de SQL Server n’annule pas toujours toutes les modifications apportées avant l’échec. Lorsque vous réexécutez le programme d’installation, le programme d’installation peut détecter l’instance partiellement installée. Cela peut empêcher le programme d’installation de déterminer ou de créer la configuration de l’instance requise pour la nouvelle installation.

L’échec d’installation initial peut avoir de nombreuses causes. Par exemple, un prérequis, une source d’installation, un package Windows Installer ou un autre composant d’installation peut avoir échoué. La suppression de l’installation partielle ne résout pas la cause initiale de l’échec. Vous devez corriger l’erreur initiale avant de relancer le programme d’installation.

Prérequis avant de supprimer une instance SQL Server inactive

  • Avant de commencer, vérifiez que vous disposez de sauvegardes valides de toutes les bases de données utilisateur et système pour chaque instance de SQL Server sur l’ordinateur.
  • Identifiez toutes les instances actives et consignez leurs noms d’instance, ID d’instance, éditions, versions et identifiants des fonctionnalités installées afin de les distinguer de l’instance inactive.
  • Copiez le dossier le plus récent des journaux du programme d’installation de SQL Server vers un emplacement sûr. Le chemin d’accès par défaut est : %ProgramFiles%\Microsoft SQL Server\<VersionNumber>\Setup Bootstrap\Log\<Timestamp>.
  • Utilisez le support d’installation pour la même version principale SQL Server qui a créé l’instance inactive, sauf si Summary.txt vous dirige explicitement vers différents médias.
  • Exécutez des commandes depuis une invite de commandes en tant qu’administrateur. Sur un serveur à plusieurs instances, validez le nom de l’instance, l’ID d’instance et la liste des fonctionnalités avant chaque commande de suppression.
  • Pour une instance de cluster de basculement, ne traitez pas un nœud de cluster comme une instance autonome. Utilisez la procédure de maintenance du cluster de basculement SQL Server et consultez les journaux du nœud concerné.

Important

Ne supprimez pas les clés du Registre, les services, les dossiers ou les fichiers de SQL Server comme méthode générale de nettoyage. Le nettoyage manuel du registre ou du système de fichiers peut supprimer des composants partagés ou endommager des installations en cours d’utilisation. Si les méthodes de suppression prises en charge échouent, collectez les journaux et contactez Support Microsoft.

Supprimer une instance de SQL Server inactive

Pour supprimer une instance de SQL Server inactive, effectuez les étapes suivantes dans l’ordre. Arrêtez-vous à l’étape où l’instance inactive n’apparaît plus dans le rapport de découverte.

  1. Passez en revue le résultat de l’installation et identifiez l’instance inactive

    Ouvrez Summary.txt à partir de la dernière tentative d’installation ayant échoué. Si Summary.txt fournit une commande pour supprimer l’installation ayant échoué ou inactive, utilisez cette commande comme première méthode de suppression. Notez la commande de désinstallation suggérée, le nom de l’instance ou l’identifiant d’instance, ainsi que les composants répertoriés dans la commande. Passez en revue Detail.txt et le premier journal des composants défaillants pour confirmer que l’échec provient de l’instance inactive.

    %ProgramFiles%\Microsoft SQL Server\<VersionNumber>\Setup Bootstrap\Log\<Timestamp>\Summary.txt

  2. Exécuter la commande de désinstallation suggérée par le programme d’installation

    Si Summary.txt fournit une commande de désinstallation, utilisez cette commande pour supprimer l’installation partielle.

    Ouvrez une invite de commandes avec élévation de privilèges et accédez au répertoire contenant setup.exe sur le support d’installation SQL Server approprié.

    Par exemple :

    cd /d "<Drive>:\<InstallationMediaFolder>"
    

    Exécutez ensuite la commande exacte fournie par Summary.txt.

    Par exemple :

    setup.exe /Q /ACTION=UNINSTALL /INSTANCEID=<InstanceId> /FEATURES=<FeatureList>
    

    Cette commande est un exemple uniquement. Ne remplacez pas l’ID d’instance ou la liste des fonctionnalités par des valeurs d’une autre installation ou d’un autre ordinateur. Utilisez les valeurs fournies par Summary.txt pour l’installation ayant échoué.

    Important

    Vérifiez l’ID d’instance avant d’exécuter la commande. Sur un ordinateur avec plusieurs instances SQL Server, l’exécution de la commande sur l’instance incorrecte peut supprimer une instance fonctionnelle.

    Pour plus d’informations, consultez Désinstaller une instance existante de SQL Server (programme d’installation).

  3. Générer le rapport de découverte des fonctionnalités installées

    Démarrez le Centre d'installation SQL Server à partir du support correspondant. Sélectionnez Outils>Rapport de découverte des fonctionnalités SQL Server installées. Passez en revue le rapport et déterminez si l’installation partielle est toujours répertoriée comme <InstanceName>.INACTIVE.

    Par exemple :

    MSSQLSERVER.INACTIVE
    

    Si l’instance inactive n’est plus répertoriée, vérifiez que les instances SQL Server opérationnelles et leurs fonctionnalités attendues sont toujours présentes. Vous pouvez ensuite passer aux étapes de résolution des problèmes de l’échec d’installation d’origine avant de réessayer l’installation.

    Si l’instance inactive est toujours répertoriée après avoir exécuté la commande de désinstallation fournie par Summary.txt, passez à l’étape suivante. Utilisez le code XML de découverte pour identifier les produits Windows Installer associés à l’instance inactive et supprimer uniquement ces produits vérifiés.

  4. Supprimer les produits Windows Installer restants pour l’instance inactive

    Si le rapport de découverte répertorie toujours l’instance inactive après avoir exécuté la commande de désinstallation depuis Summary.txt, recherchez et ouvrez le discovery XML. Identifiez les entrées associées à l’instance inactive et enregistrez le/la ProductCode pour chaque fonctionnalité applicable. Avant de supprimer un produit, vérifiez que le ProductCode appartient à l’instance inactive et non à une instance SQL Server opérationnelle ou à un composant partagé.

    ProductCode="{<ProductCodeGuid>}"

    Exécutez la commande suivante à partir d’une invite de commandes avec élévation de privilèges pour chaque code de produit vérifié :

    msiexec.exe /x {<ProductCodeGuid>}
    

    Répétez la commande pour chaque ProductCode.

    Caution

    Supprimez uniquement les entrées ProductCode associées à l’instance inactive. Ne désinstallez pas les produits en bloc simplement parce que leur nom d'affichage contient SQL Server. Un ordinateur peut contenir des produits et des composants partagés requis par des instances SQL Server en cours d’exécution.

  5. Vérifiez la suppression avant de réessayer l’installation

    • Régénérer le rapport de découverte des fonctionnalités installées SQL Server.
    • Vérifiez que l’instance inactive n’est plus répertoriée.
    • Vérifiez que toutes les instances de travail et leurs fonctionnalités attendues sont toujours répertoriées.
    • Passez en revue Programmes et fonctionnalités uniquement en tant que vérification secondaire ; n’utilisez pas de noms de produits seuls pour décider de ce qu’il faut supprimer.
    • Redémarrez l’ordinateur si l’opération de suppression le demande. Réexécutez ensuite l’installation d’origine ou la mise à niveau à partir d’un support local valide ou accessible de manière fiable.

Dépanner les scénarios courants de désinstallation et les erreurs d’installation

Scenario Ce que vous pouvez voir Action recommandée
Configuration des blocs d’instance inactifs Le rapport de découverte affiche <InstanceName>.INACTIVE, ou le programme d’installation indique que l’ID d’instance est déjà utilisé. Suivez la section Supprimer une instance de SQL Server inactive. Utilisez la commande de désinstallation depuis Summary.txt, puis supprimez uniquement les entrées ProductCode vérifiées qui appartiennent à l’instance inactive.
Erreur 1639 / MSINEWINSTANCE Un journal des composants indique qu’une instance spécifiée est déjà installée et MSINEWINSTANCE nécessite une nouvelle instance. Corrélez le produit ou la transformation avec l’instance inactive. Ne traitez pas « ligne de commande non valide » comme preuve que la syntaxe d’installation entrée par l’utilisateur est la seule cause.
La dépendance échoue avec l’erreur 53 ou le chemin d’accès réseau introuvable Summary.txt signale un échec de dépendance et un journal des composants signale qu’un chemin d’accès source ou réseau n’est pas disponible. Restaurez l’accès à la source requise ou utilisez un média local valide. Supprimez ensuite l’instance inactive si le programme d’installation en a créé un. Réessayez uniquement une fois le problème source corrigé.
MSI ou MSP manquant dans Windows cache du programme d’installation Réparer, corriger, mettre à niveau ou désinstaller nécessitent un fichier MSI/MSP introuvable, ou une fonctionnalité n’est pas disponible pour la sélection. Utilisez la procédure Microsoft Learn pour restaurer les fichiers manquants du cache de Windows Installer. Ne copiez pas un fichier à partir d’un autre ordinateur, sauf si la validation documentée confirme qu’il s’agit du package exact requis.
Le pilote ou le package d’exécution est la première défaillance Le premier package défaillant est un pilote ODBC, un pilote OLE DB ou un package d’exécution Visual C++. Réparez ou désinstallez la dépendance affectée par le biais de son workflow d’installation pris en charge, en fonction de son journal MSI et de sa version installée. Ne supprimez pas tous les pilotes par défaut.
Instance de cluster de basculement L’opération ayant échoué implique un nœud FCI ou une instance en cluster. Utilisez les actions de maintenance du cluster du programme d’installation de SQL Server, telles que Remove node, le cas échéant. Conservez la configuration du cluster et collectez les journaux sur chacun des nœuds concernés.
La suppression assistée continue d’échouer La commande Summary.txt de désinstallation et la suppression confirmée ProductCode échouent toutes deux, ou l’entrée inactive demeure. Arrêter le nettoyage manuel. Conservez les journaux d’installation, les rapports de découverte, les journaux MSI et un instantané de configuration système, puis contactez Support Microsoft.

Quand arrêter la suppression et recueillir les journaux

Interrompez la tentative de suppression si l’une de ces conditions s’applique et collectez les journaux de diagnostic et les informations sur l’instance avant de contacter le support Microsoft.

  • Vous ne pouvez pas mapper en toute confiance un ProductCode à l’instance inactive.
  • L’ordinateur héberge d’autres instances SQL Server en cours d’exécution ou des fonctionnalités partagées, et la suppression proposée risque de les affecter.
  • L’instance inactive appartient à un cluster de basculement et l’action normale de maintenance du cluster échoue.
  • La commande de désinstallation échoue à plusieurs reprises, Windows Installer signale des fichiers sources manquants ou la suppression msiexec échoue.
  • L’option restante nécessiterait la suppression manuelle des clés de Registre, des services, des fichiers du cache du programme d’installation ou des dossiers SQL Server.

Collecte des journaux de diagnostic de SQL Server et des informations d’instance

Collectez les informations suivantes avant d’apporter des modifications supplémentaires à l’ordinateur :

Remarque

SQL LogScout est un outil de collecte de diagnostics. Pour les problèmes SQL Server liés à la configuration ou à l’installation, utilisez le scénario Installation/Setup afin que les journaux d’installation et les informations de diagnostic pertinents soient collectés. Pour plus d’informations, consultez Les outils de dépannage et de diagnostic pour SQL Server dans des scénarios locaux et hybrides.