5.4.3 Configuration de SQL Server pour JBoss 5.1 préconfiguré par Adobe

Pour permettre à JBoss de se connecter à la base de données SQL Server contenant les données LiveCycle, vous devez créer un fichier de source de données SQL Server et le déployer sur l’instance de JBoss sur laquelle vous souhaitez déployer LiveCycle (par exemple, [racine du serveur d’applications]/server/lc_sqlserver/deploy).

Remarque : chiffrez le mot de passe dans les fichiers de source de données (adobe-ds.xml et mssql-ds.xml) et le fichier login-config.xml à l’aide de l’une des méthodes décrites à l’adresse http://community.jboss.org/wiki/EncryptingDataSourcePasswords. Vous pouvez également utiliser les instructions disponibles à http://blogs.adobe.com/livecycle/2009/10/livecycle_-_encrypting_clearte.html.

5.4.3.1 Modification du fichier adobe-ds.xml

  1. Ouvrez le fichier [racine du serveur d’applications]/server/lc_sqlserver/deploy/adobe-ds.xml dans un éditeur de texte et localisez la ligne suivante :

    <connection-url>jdbc:sqlserver://localhost:1433;DatabaseName=adobe</connection-url> 
    <driver-class>com.microsoft.sqlserver.jdbc.SQLServerDriver</driver-class> 
    <security-domain>MSSQLDbRealm</security-domain>
  2. Remplacez le texte suivant de la ligne ci-dessus par les valeurs propres à votre base de données :

    • localhost : nom, adresse IP ou chemin d’accès complet de l’ordinateur hébergeant la base de données. La valeur par défaut est localhost.

    • 1433 : port utilisé pour accéder à la base de données. Le port par défaut est 1433.

    • adobe : nom de la base de données contenant les données LiveCycle  Vous devez mettre à jour la valeur par défaut, adobe, à l’aide du nom de votre base de données.

  3. Dans les lignes qui suivent le paramètre <connection-url>, localisez les paramètres user-name et password, puis remplacez les valeurs par défaut par le nom d’utilisateur et le mot de passe qu’utilise le serveur d’applications pour accéder à la base de données.

  4. Vérifiez que les valeurs minimale et maximale des connexions à la source de données sont définies comme suit :

    • Pour IDP_DS :

      <min-pool-size>1</min-pool-size> 
      <max-pool-size>30</max-pool-size>
    • Pour EDC_DS :

      <min-pool-size>1</min-pool-size> 
      <max-pool-size>20</max-pool-size>
      Remarque : si votre serveur LiveCycle supporte une charge importante, augmentez le nombre maximum de connexions JDBC, afin de garantir le traitement de toutes les tâches. Dans ce cas, affectez une valeur de 50 ou plus au paramètre <max-pool-size> pour IDP_DS et EDC_DS.
  5. Enregistrez le fichier, puis fermez-le.

5.4.3.2 Modification du fichier mssql-ds.xml

Si vous exécutez LiveCycle avec une base de données Microsoft SQL Server, vous devez définir SQL Server comme source de données par défaut pour JBoss. Cette procédure repose sur le fait que le pilote JDBC SQL Server est installé dans le répertoire [racine du serveur d’applications]/server/lc_sqlserver/lib.

  1. Ouvrez le fichier [racine du serveur d’applications]/server/lc_sqlserver/deploy/mssql-ds.xml dans un éditeur de texte, puis définissez l’élément <local-tx-datasource> en fonction de vos paramètres de connexion SQL Server :

    <jndi-name>DefaultDS</jndi-name> 
    <connection-url>jdbc:sqlserver://localhost:1433;DatabaseName=adobe</connection-url> 
    <driver-class>com.microsoft.sqlserver.jdbc.SQLServerDriver</driver-class> 
    <security-domain>MSSQLDbRealm</security-domain>
  2. Remplacez le texte en gras des lignes ci-dessus par les valeurs propres à votre base de données :

    localhost : remplacez cette valeur par le nom d’hôte de votre serveur SQL Server.

    1433 : si vous n’utilisez pas le port SQL Server par défaut, remplacez cette valeur par le numéro de port approprié.

    adobe : remplacez cette valeur par le nom de votre base de données SQL Server.

  3. Dans les lignes qui suivent le paramètre <connection-url>, localisez les paramètres user-name et password, puis remplacez les valeurs par défaut par le nom d’utilisateur et le mot de passe qu’utilise le serveur d’applications pour accéder à la base de données.

    Remarque : le pilote JDBC relatif à SQL Server n’analyse pas les adresses numériques au format IPv6. Si vous utilisez SQL Server dans un environnement IPv6, vous devez indiquer le nom du serveur au format suivant :

    <connexion-url>jdbc:sqlserver://;serverName=<Adresse numérique au format IPv6 de l'hôte de la base de données>:1433;databaseName=<bdd></connexion-url>

    Remarque : lors de la spécification de l’adresse IPv6 du serveur dans ce format, notez que la chaîne de caractères ;serverName est un mot-clé ; il ne doit pas être remplacé par le nom du serveur.
  4. Enregistrez le fichier, puis fermez-le.

5.4.3.3 Modification du fichier login-config.xml

  1. Ouvrez le fichier [racine du serveur d’applications]/server/lc_sqlserver/conf/login-config.xml dans un éditeur de texte, puis modifiez le code suivant dans l’élément <policy> :

    <application-policy name="MSSQLDbRealm"> 
        <authentication> 
            <login-module 
            code="org.jboss.resource.security.SecureIdentityLoginModule" flag  
            = "required"> 
            <module-option name="principal">adobe</module-option> 
            <module-option name="userName">adobe</module-option> 
            <module-option name="password">adobe</module-option> 
            <module-option 
            name="managedConnectionFactoryName">jboss.jca:service=LocalTxCM, 
            name=DefaultDS</module-option> 
            </login-module> 
        </authentication> 
    </application-policy>
  2. Remplacez le texte en gras par les valeurs propres à votre base de données, de manière à ce que le serveur d’applications puisse accéder à votre base de données.

  3. Enregistrez le fichier, puis fermez-le.

  4. Démarrez JBoss.

5.4.3.4 Association de l’ouverture de session Windows à l’utilisateur de base de données LiveCycle 

  1. A l’aide de Microsoft SQL Server Management Studio, connectez-vous au serveur de base de données qui héberge la base de données LiveCycle 

  2. Définissez le mode d’authentification sur Authentification Windows.

  3. Dans Sécurité > Connexions, créez un compte pour l’utilisateur de domaine Windows et sélectionnez Windows authentication.

  4. Cliquez sur Mappage de l’utilisateur sur l’écran Nouvelle connexion, puis définissez la base de données et le schéma par défaut du nouvel utilisateur.

  5. Sélectionnez db_owner comme Rôle de base de données, puis cliquez sur OK.

Pour vérifier la création de l’utilisateur, développez la base de données LiveCycle dans l’arborescence, puis ouvrez Sécurité > Utilisateurs. Le nouvel utilisateur apparaît dans la liste des utilisateurs.

5.4.3.5 Installation du pilote de base de données SQL Server

Remarque : si ce n’est déjà fait, téléchargez le pilote SQL Server JDBC Driver 3.0 (pour toutes les plates-formes) à partir du Centre de téléchargements Microsoft ou copiez le pilote depuis le répertoire [racine DVD]/third_party/ dans le répertoire [racine du serveur d’applications]/server/<nom_profil>/lib.

Si vous effectuez l’installation à partir du Centre de téléchargements de Microsoft, suivez les instructions du site Web pour télécharger et installer le pilote. Notez le répertoire dans lequel vous installez le pilote sur votre système.

Remarque : utilisez SQL Server JDBC Driver 3.0 à la fois pour Microsoft SQL Server 2005 SP2 et pour Microsoft SQL Server 2008.

5.4.3.6 Configuration de la sécurité intégrée sous Windows

Remarque : vous devez exécuter le service JBoss en tant qu’utilisateur Windows configuré dans la section 5.4.3.4 Association de l’ouverture de session Windows à l’utilisateur de base de données LiveCycle . Si JBoss ne s’exécute pas en tant que service, vous devez vous connecter à Windows en tant que cet utilisateur spécifique avant de démarrer JBoss à partir d’une invite de commande.
  1. Dans les fichiers adobe-ds.xml et mssql-ds.xml du répertoire [racine du serveur d’applications]\server\lc_sqlserver\deploy, ajoutez integratedSecurity=true à l’URL de connexion, comme indiqué dans l’exemple suivant :

    jdbc:sqlserver://<serveurhôte>:<port>;databaseName=<nombdd>;integratedSecurity=true.

  2. Remplacez les valeurs en gras de l’exemple ci-dessus par les valeurs propres à votre serveur de base de données.

  3. Ajoutez le fichier sqljdbc_auth.dll au chemin d’accès du système Windows (C:\Windows) sur l’ordinateur exécutant JBoss. Le fichier sqljdbc_auth.dll se trouve avec les fichiers d’installation du pilote Microsoft SQL JDBC 3.0 (l’emplacement par défaut est [racine SQL]/sqljdbc_3.0/enu/auth/x86 pour les systèmes d’exploitation 32 bits et [racine SQL]/sqljdbc_3.0/enu/auth/x64 pour les systèmes d’exploitation 64 bits).

    Remarque : utilisez SQL Server JDBC Driver 3.0 pour Microsoft SQL Server 2008.
  4. Ouvrez les propriétés du service JBoss pour Adobe LiveCycle ES3 ou le service JBoss que vous avez configuré, puis cliquez sur l’onglet Connexion.

  5. Sélectionnez Cecompte et saisissez le compte utilisateur y étant associé dans 5.4.3.4 Association de l’ouverture de session Windows à l’utilisateur de base de données LiveCycle . Si vous exécutez JBoss à partir d’une ligne de commande, vous devez être connecté en tant que l’utilisateur concerné.