doc-fr/reference/oci8/fan.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: e9366ee458b2900c53a503b1ad97664e1d9a8859 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->

<chapter xml:id="oci8.fan" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>Support de FAN (Fast Application Notification : Application de notification Rapide) OCI8</title>
 <section>
  <para>
   Le support de FAN fournit un basculement de connexion rapide,
   une fonctionnalité de haute disponibilité pour la base de données Oracle.
   Il permet aux scripts PHP OCI8 d'être notifiés lorsqu'une machine
   de base de données ou une instance de base de données devient non
   disponible. Sans FAN, OCI8 peut se figer en cas d'atteinte du délai maximal
   TCP, et une erreur est retournée, ce qui peut prendre plusieurs minutes.
   L'activation de FAN en OCI8 permet aux applications de détecter les erreurs
   et de se re-connecter à une instance de connexion disponible sans
   que le serveur Web n'est besoin d'en connaître.
  </para>
  <para>
   Le support de FAN est disponible lorsque les bibliothèques clientes
   Oracle liées à PHP et la base de données Oracle sont en version
   10gR2 ou supérieures.
  </para>
  <para>
   FAN fait bénéficier aux utilisateurs de la technologie de cluster Oracle (RAC)
   car les connexions survivantes aux instances de base de données peuvent
   être effectuées immédiatement. Les utilisateurs de Data Guard Oracle avec un
   broker, vont voir les événements FAN générés lorsqu'une base de données
   passe en ligne. Les bases de données qui ne font pas parties de cluster
   vont envoyer des événements FAN lorsque la base de données redémarre.
  </para>
  <para>
   Pour les connexions actives, lorsqu'une machine ou une instance de
   base de données devient indisponibles, une erreur de connexion sera retournée
   par la fonction de l'extension OCI8 appelée. Lors d'une reconnexion
   d'un script sous-jacent PHP, une connexion à une instance de base de données
   survivantes sera établie. L'extension OCI8 va également, de façon transparente,
   nettoyer toutes les connexions inactives affectées par une machine de
   base de données ou une instance en échec, aussi, les appels de connexion PHP
   vont établir une nouvelle connexion sans que le script n'en connaisse,
   faisant ainsi aucune interruption de service.
  </para>
  <para>
   Lorsque <link linkend="ini.oci8.events">oci8.events</link>
   vaut <literal>On</literal>, il est suggéré de définir
   <link linkend="ini.oci8.ping-interval">oci8.ping_interval</link>
   à -1 pour désactiver le ping, sachant que l'activation des événements FAN
   fournit un gestionnaire de connexions pro-actif des connexions inactives
   devenues invalides par une interruption de service.
  </para>
  <para>
   Pour activer le support FAN en PHP OCI8, compilez PHP OCI8 avec les
   bibliothèques Oracle 10gR2 ou supérieures, puis, suivez ces étapes :
  </para>
  <para>
   <itemizedlist>
    <listitem>
     <simpara>
      Avec les privilèges d'administrateur de la base de données, utilisez
      un programme comme SQL*Plus pour activer le service de base de données
      pour poster les événements FAN ; par exemple :
     </simpara>
     <para>
      <informalexample>
       <screen>
<![CDATA[
    SQL> execute dbms_service.modify_service(
                   SERVICE_NAME        => 'sales',
                   AQ_HA_NOTIFICATIONS => TRUE);
]]>
       </screen>
      </informalexample>
     </para>
    </listitem>
    <listitem>
     <simpara>
      Editez le fichier php.ini et ajoutez :
     </simpara>
     <para>
      <informalexample>
       <screen>
<![CDATA[
    oci8.events = On
]]>
       </screen>
      </informalexample>
     </para>
    </listitem>
    <listitem>
     <simpara>
      Si l'application ne gère toujours pas les conditions d'erreur
      OCI8, modifiez le pour détecter les échecs. Ceci peut nécessité
      la re-connexion et la ré-exécution des requêtes.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Exécutez l'application, connectez-vous à la base de données
      Oracle 10gR2 ou supérieures.
     </simpara>
    </listitem>
   </itemizedlist>
  </para>
 </section>
</chapter>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->