Déploiement d'un complément

Cette dernière section du didacticiel de la programmation Windows Home Server explique comment déployer un composant additionnel de Windows Home Server. Pour que votre composant fonctionne, vous devez copier les fichiers du composant dans le répertoire %systemdrive%\Program Files\Windows Home Server\ du serveur. L'application que vous avez créée tout au long de ce didacticiel consiste en un fichier .dll unique qui contient un onglet Console et un onglet Paramètres pour Windows Home Server. Pour que votre composant soit utilisable, vous devez le déployer sur l'ordinateur qui exécute Windows Home Server.

La méthode conseillée pour ce déploiement est de créer un package MSI. Cette section décrit deux méthodes classiques pour créer un package MSI : l'une est fondée sur WiX (Windows Installer XML) et elle utilise le système de déeloppement Visual Studio 2005, l'autre est un projet de configuration Visual Studio 2005.

Pour créer un package MSI fondé sur WiX, suivez les étapes de la prochaine section. Les étapes pour créer un package MSI via un projet de configuration Visual Studio ne sont pas dans la documentation mais des instructions sont fournies pour modifier un package MSI construit via un projet de configuration Visual Studio ; ainsi, le package MSI peut être reconnu par Windows Home Server comme un composant additionnel.

Pour créer un package MSI fondé sur WiX

Pour créer un package MSI fondé sur WiX en utilisant Visual Studio, vous devez télécharger Votive. Cet outil crée des packages MSI fondés sur WiX en s'appuyant sur l'IDE (environnement de développement intégré) de Visual Studio 2005. Pour apprendre à utiliser Votive, consultez la page "Windows Installer XML Toolset Deployment" sur le site Web MSDN (http://go.microsoft.com/fwlink/?LinkId=94639).

Étape 1. Ajoutez un projet WiX à la solution SDKSample sous Visual Studio 2005

Après avoir téléchargé et installé Votive, ajoutez un projet WiX à la solution SDKSample que vous avez créée.

Pour créer un projet WiX

  1. Le projet SDKSample étant ouvert dans Visual Studio 2005, cliquez droit sur Solution 'SDKSample' (1 projet), pointez sur Ajouter, puis cliquez sur Nouveau projet.

  2. Cliquez sur Projet à côté de Créer pour créer un nouveau projet WiX Visual Studio 2005.

  3. Dans Types de projet, cliquez sur Projets WiX.

  4. Dans Modèles, cliquez sur Projet WiX.

  5. Nommez votre projet InstallSDKSample, puis cliquez sur OK.

  6. Cliquez droit sur Product.wxs, puis choisissez Renommer. Renommez le fichier en SDKSample.wxs.

  7. Double-cliquez le fichier SDKSample.wxs dans l'Explorateur de solution. Vous êtes désormais prêt à modifier le fichier pour votre composant.

Étape 2. Ajoutez le code pour créer le package MSI

Pour ajouter le code afin de créer le package MSI fondé sur WiX, remplacez le code dans SDKSample.wxs par celui ci-dessous, et modifiez les noms et les chemins des fichiers pour qu'ils correspondent à ceux dans votre projet, ainsi que les GUID (identificateurs uniques) :

Exemple de fichier wxs
<?xml version="1.0" encoding="utf-8"?>
<Wix xmlns="http://schemas.microsoft.com/wix/2003/wi">
  <Product
    Name="My Windows Home Server SDK Sample"
    Id="put-guid1-here"
    UpgradeCode="put-guid2-here"
    Manufacturer="Your Company"
    Version="1.0.0"
    Language="1033"
    Codepage="1252">
    <Package
      Id="put-guid3-here"
      Manufacturer="Your Company"
      InstallerVersion="200"
      Platforms="Intel"
      Languages="1033"
      Compressed="yes"
      SummaryCodepage="1252" />
    <Media Id="1" EmbedCab="yes" Cabinet="SDKSample_cab" />

    <Property Id="WHSLogo">1</Property>

    <Condition Message="[ProductName] nécessite Windows Home Server. Pour des informations complémentaires, veuillez consulter le Guide de l'utilisateur.">VersionNT = 502</Condition>

    <Directory Id="TARGETDIR" Name="SourceDir">
      <Directory Id="ProgramFilesFolder" Name="PFiles">
        <Directory Id="WHS" Name="WHSgrp" LongName="Windows Home Server">
          <Component Id="HomeServerConsoleTab.SDKSample.dll" Guid=" put-guid4-here ">
            <File Id="HomeServerConsoleTab.SDKSample.dll" Name="Sample.dll" LongName="HomeServerConsoleTab.SDKSample.dll" Source="..\SDKSample\bin\release\HomeServerConsoleTab.SDKSample.dll" Vital="yes" KeyPath="yes" DiskId="1"/>
          </Component>
        </Directory>
      </Directory>
    </Directory>

    <Feature Id="DefaultFeature" Level="1">
      <ComponentRef Id="HomeServerConsoleTab.SDKSample.dll" />
    </Feature>
  </Product>
</Wix>

Quelques points importants :

  • L'élément <Property Id="WHSLogo">1</Property> précise qu'il s'agit d'un composant Windows Home Server.
  • L'élément <Condition Message="[ProductName] nécessite Windows Home Server. Pour des informations complémentaires, veuillez consulter le Guide de l'utilisateur.">VersionNT = 502</Condition> est important car il empêche l'installation du package MSI sur un système d'exploitation autre que Windows Home Server ou Windows Server 2003.
  • Vous devriez remplacer tous les GUID du fichier d'exemple. Utilisez le générateur de GUID de Visual Studio pour créer de nouveau identifiants.

Étape 3. Compilez la solution SDKSample

Après avoir saisi le code du projet WiX et celui du projet SDKSample, vous pouvez générer la solution complète.

Pour générer la solution SDKSample

  1. Dans le menu principal, cliquez sur Fichier, puis cliquez sur Tout enregistrer.

  2. Dans le menu principal, cliquez sur Générer puis sur Gestionnaire de configurations.

  3. Dans le Gestionnaire de configurations, dans Configuration, cliquez sur InstallSDKSample, puis sur Version. Faites la même chose pour SDKSample.

  4. Cliquez sur Fermer pour fermer le Gestionnaire de configuration.

  5. Cliquez droit sur Solution 'SDKSample' (2 projets), puis cliquez sur Générer la solution. (Si une erreur se produit, corrigez-la avant de poursuivre.)

  6. Quand la génération s'est bien terminée, naviguez vers VosProjetsVisualStudio\SDKSample\InstallSDKSample\bin\Release (où VosProjetsVisualStudio est l'emplacement de vos projets Visual Studio 2005).

  7. Vérifiez que le fichier SDKSample.msi est créé. Vous copierez ce fichier sur le serveur, à la section "Pour déployer le package MSI" plus loin dans cette page.

Lorsque votre fichier MSI a été créé avec succès, allez à la section "Pour déployer le package MSI" plus loin dans cette page.

Pour créer un package MSI en utilisant le projet de configuration Visual Studio et ORCA

À la place de Votive pour créer un package MSI, vous pouvez utiliser un modèle de projet de configuration Visual Studio. Vous créez ainsi un package MSI puis vous utilisez ORCA pour modifier les propriétés de ce package. Cela vous permet d'ajouter la propriété WHSLogo. Le fait d'ajouter cette propriété et de lui attribuer la valeur 1 permet à Windows Home Server de reconnaître ce package comme un composant additionnel. Pour savoir comment télécharger et utiliser ORCA, visitez le site Web MSDN (http://go.microsoft.com/fwlink/?LinkId=94640).

Pour modifier un package MSI avec ORCA

  1. ORCA étant ouvert, cliquez sur Fichier, puis sur Ouvrir, naviguez jusqu'à l'emplacement du fichier MSI qui contient votre composant puis cliquez sur Ouvrir.

  2. Dans la colonne Tables, cliquez sur Propriété.

  3. Cliquez droit n'importe où dans la région où apparaissent les colonnes Propriétéet Valeur, puis cliquez sur Ajouter une ligne.

  4. Dans la boîte de dialogue Ajouter une ligne, saisissez WHSLogo pour la Propriété, cliquez sur Valeur, puis tapez 1. Cliquez sur OK pour fermer la boîte de dialogue.

  5. Cliquez sur Fichier, puis sur Enregistrer et sur Quitter pour fermer ORCA.

Pour déployer le package MSI

Pour déployer le composant SDKSample, copiez simplement le fichier MSI SDKSample.msi de votre ordinateur de développement sur l'ordinateur Windows Home Server, dans le dossier \\NomServeur\Software\Add-ins\ .

Testez ensuite le composant.

Pour tester le composant SDKSample

  1. Connectez-vous à l'ordinateur qui exécute Windows Home Server en utilisant un compte d'administrateur.

    Remarque
    Généralement, Windows Home Server s'administre à distance, sans clavier ni souris ni écran directement reliés au serveur. Les utilisateurs ouvrent une session via le logiciel Windows Home Server Connector. Dans le cadre de ce didacticiel, si vous n'avez pas de poste client installé, vous pouvez vous connecter soit directement au serveur (en lui reliant un écran, un clavier et une souris) soit en passant par une session Terminal Services.

  2. Double cliquez sur Console Windows Home Server sur le bureau du serveur. La console s'ouvre.

  3. L'onglet SDK Sample doit apparaître (avec l'image SDKSampleImg) dans la liste des onglets Console. Cliquez sur l'onglet SDK Sample. Le volet droit change pour afficher le contrôle personnalisé que vous avez créé.

  4. Cliquez sur Afficher infos WHS. Des informations sur les disques, les volumes et les dossiers partagés Windows Home Server s'affichent.

  5. Cliquez sur Effacer l'affichage pour effacer les informations affichées..

  6. Cliquez sur Ouvrir les paramètres. La boîte de dialogue Paramètres Windows Home Server s'ouvre. SDK Sample est dans la liste des onglets Paramètres.

  7. Cliquez sur SDK Sample. Le volet droit de la page Paramètres change et affiche le contrôle "SDK Sample Settings".

Voir aussi

Page view tracker