Partager via

  • Article

Créer un fichier d’entrée de serveur Edge personnalisé

 

Dernière rubrique modifiée : 2011-04-05

La rubrique précédente, Définir le fichier d’entrée de serveur Edge, a défini les blocs de construction du fichier d’entrée requis pour la fusion de la topologie héritée à l’aide de Lync Server Management Shell. Cette rubrique approfondit la structure et la finalité du fichier input.xml. Elle décrit aussi les divers paramètres à définir lors de la création du fichier input.xml du serveur Edge.

Le fichier input.xml, qui peut être créé à l’aide de tout éditeur de texte, a l’apparence suivante :

<?xml version="1.0" encoding="utf-8"?>
<TopologyInput xmlns="urn:schema:Microsoft.Rtc.Management.Deploy.LegacyUserInput.2008"  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<EdgeClusters>
    <EdgeCluster AP="true" MR="true" DP="true" Version="OCS2007R2">
    <LoadBalancer InternalFqdn="edgeint.fqdn" ExternalDPFqdn="ExternalDP.Fqdn " />  
    <Machines>
      <Machine InternalFqdn = "node1.fqdn"/>
      <Machine InternalFqdn = "anothernode1.fqdn"/>
    </Machines>
    <Ports InternalAPPort="5061" InternalDPPort="8057"    ExternalDPPort="443"/>
    <DirectorOrEdgeNextHop Fqdn="director.fqdn.com " />
    </EdgeCluster>
</EdgeClusters>
    <RegistrarClusterPort EnableAutoDiscoveryOfPorts = "false" Port = "5065" />
</TopologyInput>

Et qu’est-ce que tout cela signifie ? Eh bien, d’abord votre fichier XML doit commencer par la déclaration XML suivante : <?xml version="1.0" encoding="utf-8"?>

noteRemarque :
Bien qu’elle soit facultative, cette déclaration XML permet d’éviter toute confusion concernant la version ou le type d’encodage utilisés dans le fichier.

Après la déclaration XML, vous devez insérer l’élément <TopologyInput>, comme cela :

<TopologyInput xmlns="urn:schema:Microsoft.Rtc.Management.Deploy.LegacyUserInput.2008"  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

Cet élément est très important : si <TopologyInput> n’est pas présent, alors la validation de schéma n’aura pas lieu. À la place, Merge-CsLegacyTopology pourrait essayer de fusionner un fichier XML mal formé. Dans la mesure où il s’agit d’un fichier XML, il est important que ce fichier soit correctement formé. Par conséquent, vous devez également ajouter une balise fermante pour l’élément <TopologyInput> : </TopologyInput>

Cela signifie que votre fichier XML a l’apparence suivante :

<?xml version="1.0" encoding="utf-8"?>
<TopologyInput xmlns="urn:schema:Microsoft.Rtc.Management.Deploy.LegacyUserInput.2008"  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
</TopologyInput>

Une fois cette structure de fichier de base en place, vous êtes prêt à identifier les composants du serveur Edge déployés dans Office Communications Server. Cela se fait à l’intérieur de l’élément <EdgeClusters>. En gardant cela à l’esprit, votre prochaine étape consiste à ajouter des balises ouvrantes et fermantes pour l’élément <EdgeClusters> dans le fichier XML :

<?xml version="1.0" encoding="utf-8"?>
<TopologyInput xmlns="urn:schema:Microsoft.Rtc.Management.Deploy.LegacyUserInput.2008"  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<EdgeClusters>

</EdgeClusters>

</TopologyInput>

À l’intérieur de l’élément <EdgeClusters>, vous ajoutez alors jusqu’à cinq éléments enfants :

  • <EdgeCluster>   L’élément <EdgeCluster> est l’endroit où vous définissez les différents rôles du serveur Edge dans votre topologie Office Communications Server existante. Il existe trois rôles dont vous devez vous soucier :

    • Serveur Edge d’accès Lync   Anciennement connu sous le nom de serveur proxy d’accès, le serveur Edge d’accès se charge de traiter l'ensemble du trafic SIP qui traverse le pare-feu de votre organisation. Si votre topologie inclut un serveur Edge d’accès, vous devez ajouter cet attribut à l’élément <EdgeCluster> : AP="true"

    • Serveur Edge de conférence Web   Le serveur Edge de conférence Web (également connu sous le nom de serveur proxy de données) relaie le trafic entre le serveur de conférence A/V et les clients externes. Si votre topologie inclut un serveur Edge d’accès, vous devez ajouter cet attribut à l’élément <EdgeCluster> : DP="true"

    • Serveur Edge A/V   Le serveur Edge A/V (également connu sous le nom de serveur relais multimédia) fournit un point de connexion unique qui active le trafic multimédia entrant et sortant afin d’aider les pare-feu et les appareils NAT (Network Address Translation). Si votre topologie inclut un serveur Edge d’accès, vous devez ajouter cet attribut à l’élément <EdgeCluster> : MR="true"

      Spécifiez ensuite la version d’Office Communications Server qui s’exécute dans votre domaine hérité. Pour Office Communications Server 2007 R2, utilisez cet attribut et cette valeur d’attribut : Version="OCS2007R2"

      Enfin, si vous avez activé la fédération dans Office Communications Server, vous devez ajouter l’attribut FederationEnabled à l’élément <EdgeCluster> : FederationEnabled="true"

      Un élément <EdgeCluster> terminé a l’apparence suivante :

      <EdgeCluster AP="true" MR="true" DP="true" Version="OCS2007R2">

  • <LoadBalancer>   L’élément <LoadBalancer> contient les noms de domaine complets à la fois pour votre programme d’équilibrage de la charge du serveur Edge interne et vos programmes d’équilibrage de la charge du serveur Edge externe. Notez que pour les programmes d’équilibrage de la charge externes, vous devez spécifier tous vos programmes d’équilibrage de la charge, notamment les programmes d’équilibrage de la charge Edge d’accès (AP), de conférence Web (DP) et Edge A/V (MR). Une balise <LoadBalancer> complète a l’apparence suivante :

    <LoadBalancer InternalFqdn="edgeint.fqdn " ExternalDPFqdn="ExternalDP.Fqdn" />

    Si vous n’utilisez pas de programme d’équilibrage de la charge du serveur Edge, vous pouvez alors omettre cet élément.

  • <Machine>   L’élément <Machine> contient le nom de domaine complet de votre serveur Edge (notez qu’il doit s’agir du nom interne du serveur). Par exemple : <Machine InternalFqdn="node1.fqdn " />

  • <Ports>   Utilisez l’élément <Ports> pour indiquer les ports utilisés par vos serveurs Edge. Un APPort indique un serveur Edge d’accès, un DPPort indique un serveur Edge de conférence Web et un MRPort indique un serveur relais multimédia. Assurez-vous de faire la distinction entre les ports internes et les ports externes. L’exemple suivant définit les ports InternalAPPort, InternalDPPort et ExternalDPPort :

    <Ports InternalAPPort="5061" InternalDPPort="8057" ExternalDPPort="443"/>

  • <DirectorOrEdgeNextHop>   L’élément <DirectorOrEdgeNextHop> contient le nom de domaine complet du serveur de tronçon suivant de votre serveur Edge : <DirectorOrEdgeNextHop Fqdn="director.fqdn.com " /> Si le serveur de tronçon suivant est un directeur, vous devez ajouter l’attribut IsDirector="true":

    <DirectorOrEdgeNextHop Fqdn=" director.fqdn.com " IsDirector="true" />

    Si l’attribut IsDirector n’a pas la valeur True, Lync Server 2010 ne sera pas en mesure d’utiliser le directeur Office Communications Server 2007 R2 pour la fédération.

    À la fin, l’élément a l’apparence suivante :

    <EdgeClusters>
      <EdgeCluster AP="true" MR="true" DP="true" Version="OCS2007R2">
     <LoadBalancer InternalFqdn="edgeint.fqdn" ExternalDPFqdn="ExternalDP.Fqdn  />
     <Machines>
      <Machine InternalFqdn = "node1.fqdn"/>
      <Machine InternalFqdn = "anothernode1.fqdn"/>
     </Machines>
     <Ports InternalAPPort="5061" InternalDPPort="8057" ExternalDPPort="443"/>
       <DirectorOrEdgeNextHop Fqdn="director.fqdn.com " />    
      </EdgeCluster>
</EdgeClusters>

Il ne nous reste plus qu’à ajouter l’élément <RegistrarClusterPort> ; il s’agit de la section du fichier XML dans laquelle vous définissez le port et le type de transport pour votre cluster Serveur d’inscriptions. Un élément <RegistrarClusterPort> terminé, qui définit le port 5065 et le type de transport MTLS, a l’apparence suivante :

<RegistrarClusterPort EnableAutoDiscoveryOfPorts = "false" Port = "5065" />

Les conditions suivantes s’appliquent au paramètre EnableAutoDiscoveryOfPorts :

  • EnableAutoDiscoveryOfPorts est un paramètre obligatoire mais Port est un paramètre facultatif.

  • Si EnableAutoDiscoveryOfPorts a la valeur True et que Port est fourni, alors la valeur de Port est ignorée.

  • Si EnableAutoDiscoveryOfPorts a la valeur False et que Port est fourni, alors la valeur de Port est utilisée.

  • If EnableAutoDiscoveryOfPorts a la valeur False et que Port n’est pas fourni, une erreur est enregistrée car il s’agit d’une configuration non prise en charge.

Finalement, nous obtenons un fichier XML qui peut être utilisé avec l’applet de commande Merge-CsLegacyTopology :

<?xml version="1.0" encoding="utf-8"?>
<TopologyInput xmlns="urn:schema:Microsoft.Rtc.Management.Deploy.LegacyUserInput.2008"  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<EdgeClusters>
   <EdgeCluster AP="true" MR="true" DP="true" Version="OCS2007R2" FederationEnabled="true">
    <LoadBalancer InternalFqdn="edgeint.fqdn" ExternalDPFqdn="ExternalDP.Fqdn " />
    <Machines>
      <Machine InternalFqdn = "node1.fqdn"/>
      <Machine InternalFqdn = "anothernode1.fqdn"/>
    </Machines>
    <Ports InternalAPPort="5061" InternalDPPort="8057" ExternalDPPort="443"/> 
    <DirectorOrEdgeNextHop Fqdn="director.fqdn.com " />
   </EdgeCluster>
</EdgeClusters>
   <RegistrarClusterPort EnableAutoDiscoveryOfPorts = "false" Port = "5065" /> 
</TopologyInput>