Notes de version de Sun Java System Communications Services 2005Q4

Mises à jour de la documentation

Cette section contient des informations sur les modifications et erreurs figurant dans la documentation dans les sections suivantes :

Ensemble de la documentation

La version 2005Q4 d'Instant Messaging utilise la version suivante du manuel Administration Guide (Guide d'administration) :

Sun Java System Instant Messaging 7 2005Q1 Administration Guide

Administration Guide

Cette section répertorie les modifications suivantes apportées au document Sun Java System Instant Messaging 7 2005Q1 Administration Guide.

Démarrage, arrêt et actualisation des composants dans un environnement HA

N'utilisez pas les commandes imadmin start, imadmin stop ou imadmin refresh dans un environnement HA (haute disponibilité) avec Sun Cluster. Utilisez à la place les utilitaires d'administration de Sun Cluster.

Étape postérieure à l'installation pour les déploiements avec Access Manager

(Numéro de problème : 6189148) Si vous installez Access Manager sur un hôte différent du serveur Instant Messaging, vous devez copier manuellement les fichiers imServices_* de l'hôte du serveur Instant Messaging vers l'hôte Access Manager après avoir exécuté l'utilitaire de configuration.

Pour ce faire, procédez comme suit :

  1. Repérez les fichiers imService_*.properties sur l'hôte du serveur Instant Messaging. Par défaut, ces fichiers se trouvent à l'emplacement /opt/SUNWiim/lib/ sous Solaris et /opt/sun/im/lib/ sous Linux.

  2. Copiez les fichiers dans le répertoire locale sur l'hôte Access Manager. Par défaut, ce répertoire se trouve à l'emplacement /opt/SUNWam/locale sous Solaris et /opt/sun/identity/locale sous Linux.

Modification de la valeur par défaut du paramètre iim_agent.enable.

(Numéro de problème : 5102072) Dans cette version, la valeur par défaut du paramètre iim_agent.enable est devenue false. Cette modification n'est pas signalée dans le Guide d'administration.

Configuration des rappels du calendrier pour Instant Messenger

L'étape 1 de la procédure “Configuration du serveur Instant Messaging” est incorrecte. Il n'existe aucun package portant le nom SUNWiimag. Ignorez cette étape.

Paramètre supprimé dans iim.conf

Le paramètre de configuration iim_server.msg_archive.auto n'est plus pris en charge bien qu'il figure, de manière anormale, dans la liste des paramètres du Guide d'administration.

Activation du composant Instant Messenger Archive Control pour le plug-in Java

(Numéro de problème : 6244099) La procédure du Guide d'administration pour l'activation du composant Instant Messenger Archive Control pour le plug-in Java est incorrecte. Utilisez à la place la procédure décrite dans Modifications des pages d'applet HTML et des fichiers pluginLaunch.jsp .

Modifications des pages d'applet HTML et des fichiers pluginLaunch.jsp

Si vous utilisez le plug-in Java pour lancer Instant Messenger, exécutez les étapes suivantes pour activer la fonctionnalité Instant Messenger Archive Control.

ProcedureActivation d'Instant Messenger Archive Control pour le plug-in Java

Étapes
  1. Placez-vous dans le répertoire racine de la documentation Instant Messenger et recherchez les fichiers im.html et imssl.html.

    Par défaut, ces fichiers sont installés à l'emplacement suivant :

    /etc/opt/SUNWps/desktop/default/IMProvider

  2. Ouvrez les fichiers .html dans un éditeur de texte.

  3. Ajoutez ou modifiez la ligne suivante, comme indiqué :


    <PARAM NAME="archive_control" VALUE="true" />
    <EMBED archive_control=true;/>

Stockage des messages archivés dans une base de données de recherche Portal Server autre que la base par défaut

Une erreur est survenue dans la procédure. Notamment, le répertoire suivant :

/etc/opt/SUNWps/desktop/default/IMProvider/

devrait être :

/etc/opt/SUNWps/desktop/default_locale/IMProvider/

Par exemple :

/etc/opt/SUNWps/desktop/default_ja/IMProvider/

Configuration du serveur pour l'enregistrement d'un nouvel utilisateur

La fonctionnalité d'enregistrement d'un nouvel utilisateur n'est pas entièrement décrite dans le Guide d'administration. Outre la personnalisation d'Instant Messenger, vous devez également procéder à la configuration du serveur pour permettre l'enregistrement de nouveaux utilisateurs.

Pour ce faire, vous devez ajouter quatre paramètres de configuration au fichier iim.conf puis actualiser la configuration du serveur. Le Tableau 3–4 décrit les paramètres de configuration.

Tableau 3–4 Paramètres de configuration du serveur pour l'enregistrement de nouveaux utilisateurs

Paramètre 

Description 

iim.register.enable

Si la valeur est TRUE, le serveur autorise les nouveaux utilisateurs d'Instant Messaging à s'enregistrer eux-mêmes (à s'ajouter au répertoire) à l'aide d'Instant Messenger.

iim_ldap.register.enable

Si la valeur est TRUE, le serveur autorise les nouveaux utilisateurs d'Instant Messaging à s'enregistrer eux-mêmes (à s'ajouter au répertoire) à l'aide d'Instant Messenger.

iim_ldap.register.basedn

Si l'auto-enregistrement est activé, la valeur de ce paramètre correspond au DN de l'emplacement de l'annuaire LDAP où sont stockées les entrées de l'utilisateur. Par exemple : 

"ou=people,dc=siroe,dc=com"

iim_ldap.register.domain

Domaine dans lequel seront ajoutés les nouveaux utilisateurs. Par exemple : 

directory.siroe.com

ProcedureConfiguration du serveur pour l'enregistrement d'un nouvel utilisateur

Étapes
  1. Ouvrez le fichier iim.conf dans un éditeur de texte.

  2. Ajoutez les paramètres de configuration et les valeurs indiqués dans le Tableau 3–4.

  3. Enregistrez et fermez le fichier iim.conf.

  4. Actualisez la configuration du serveur en faisant appel à l'utilitaire de ligne de commande imadmin.

    imadmin refresh server


    Attention – Attention –

    N'utilisez pas les commandes imadmin start, imadmin stop ou imadmin refresh dans un environnement HA avec Sun Cluster. Utilisez à la place les utilitaires d'administration de Sun Cluster.


Paramètre de journalisation supplémentaire pour le trafic XMPP

(Numéro de problème : 5070998) Un paramètre supplémentaire de journalisation non décrit a été ajouté à cette version afin de collecter les messages XMPP dans un fichier journal distinct.

ProcedureConfiguration du serveur pour la création d'un journal de messages XMPP

Étapes
  1. Ouvrez le fichier iim.conf.

    Par défaut, le fichier iim.conf est installé dans le répertoire de configuration comme suit :

    • Sous Solaris :

      /etc/opt/SUNWiim/default/config/iim.conf

    • Sous Linux :

      /etc/opt/sun/im/default/config/iim.conf

    Si vous avez créé plusieurs instances d'Instant Messaging, le nom du répertoire /default sera différent selon l'instance.

  2. Activez la ligne suivante en supprimant les caractères de mise en commentaire :


    iim.log4j.config=log4j.conf

    Si la ligne n'existe pas, ajoutez-la.

  3. Enregistrez et fermez le fichier iim.conf.

  4. Créez un fichier nommé log4j.conf et enregistrez-le dans le répertoire de configuration.

  5. Ajoutez les instructions suivantes dans le fichier log4j.conf :


    log4j.logger.xmppd=INFO, A1
    
    # DEFAULT TO RollingFileAppender
    log4j.appender.A1=org.apache.log4j.RollingFileAppender
    log4j.appender.A1.file=${logdir}/xmppd.log
    log4j.appender.A1.append=true
    log4j.appender.A1.maxBackupIndex=7
    log4j.appender.A1.maxFileSize=5mb
    # More example appenders..
    # Straight to console..
    # log4j.appender.A1=org.apache.log4j.ConsoleAppender
    # log4j.appender.A1.ImmediateFlush=true
    # Rollover at midnight..
    # log4j.appender.A1=org.apache.log4j.DailyRollingFileAppender
    # log4j.appender.A1.DatePattern='.'yyyy-MM-dd
    # log4j.appender.A1.file=${logdir}/xmppd.log
    # log4j.appender.A1.ImmediateFlush=true
    # log4j.appender.A1.append=true
    # Send to SMTP..
    # log4j.appender.A1=org.apache.log4j.SMTPAppender
    
    # PATTERN LAYOUT AND OPTIONS
    
    # DEFAULT TO PatternLayout
    log4j.appender.A1.layout=org.apache.log4j.PatternLayout
    # For full dates..
    log4j.appender.A1.layout.ConversionPattern=[%d{DATE}] %-5p %c [%t] %m%n
    # IM traditional output format..
    #log4j.appender.A1.layout.ConversionPattern=%d{HH:mm:ss,SSS} %-5p %c [%t] %m%n
    # More example layouts
    # XMLLayout for chainsaw consumption
    # log4j.appender.A1.layout=org.apache.log4j.xml.XMLLayout
    # TTCCLayout for NDC information
    # log4j.appender.A1.layout=org.apache.log4j.xml.TTCCLayout
    # log4j.appender.A1.layout.DateFormat=ISO8601
    # log4j.appender.A1.layout.TimeZoneID=GMT-8:00
    # log4j.appender.A1.layout.CategoryPrefixing=false
    # log4j.appender.A1.layout.ThreadPrinting=false
    # log4j.appender.A1.layout.ContextPrinting=false
    
    # Now we list logger/appender/layout for the other default loggers, but
    # only the defaults..
    log4j.logger.iim_wd=ERROR, A2
    log4j.appender.A2=org.apache.log4j.RollingFileAppender
    log4j.appender.A2.file=${logdir}/iim_wd.log
    log4j.appender.A2.append=true
    log4j.appender.A2.maxBackupIndex=7
    log4j.appender.A2.maxFileSize=5mb
    log4j.appender.A2.layout=org.apache.log4j.PatternLayout
    log4j.appender.A2.layout.ConversionPattern=[%d{DATE}] %-5p %c [%t] %m%n
    
    # For separate xmpp traffic log, disabled by default.
    log4j.logger.xmppd.xfer=DEBUG, A3
    #log4j.appender.A3=org.apache.log4j.varia.NullAppender
    # Select next block instead of previous line to enable separate transfer log
    log4j.appender.A3=org.apache.log4j.RollingFileAppender
    # log4j.appender.A3.file=${logdir}/xfer.log
    # log4j.appender.A3.append=true
    # log4j.appender.A3.maxBackupIndex=7
    # log4j.appender.A3.maxFileSize=5mb
    # log4j.appender.A3.layout=org.apache.log4j.PatternLayout
    # # Note, simpler default output than above 3 loggers:
    # log4j.appender.A3.layout.ConversionPattern=[%d{DATE}] %-5p %c [%t] %m%n
    
    log4j.logger.agent-calendar=ERROR, A4
    log4j.appender.A4=org.apache.log4j.RollingFileAppender
    log4j.appender.A4.file=${logdir}/agent-calendar.log
    log4j.appender.A4.append=true
    log4j.appender.A4.maxBackupIndex=7
    log4j.appender.A4.maxFileSize=5mb
    log4j.appender.A4.layout=org.apache.log4j.PatternLayout
    log4j.appender.A4.layout.ConversionPattern=[%d{DATE}] %-5p %c [%t] %m%n
    
    log4j.logger.net.outer_planes.jso.BasicStream=OFF, A5
    log4j.appender.A5=org.apache.log4j.RollingFileAppender
    log4j.appender.A5.file=${logdir}/jso.log
    log4j.appender.A5.append=true
    log4j.appender.A5.maxBackupIndex=7
    log4j.appender.A5.maxFileSize=5mb
    log4j.appender.A5.layout=org.apache.log4j.PatternLayout
    log4j.appender.A5.layout.ConversionPattern=[%d{DATE}] %-5p %c [%t] %m%n
  6. Enregistrez et fermez le fichier log4j.conf.

  7. Actualisez le serveur :


    imadmin refresh server
    

    Attention – Attention –

    N'utilisez pas les commandes imadmin start, imadmin stop ou imadmin refresh dans un environnement HA avec Sun Cluster. Utilisez à la place les utilitaires d'administration de Sun Cluster.


ProcedureDésactivation de la création d'un fichier journal XMPP distinct

Désactiver la création du fichier journal distinct n'empêche pas l'écriture des messages XMPP dans le journal du serveur.

Étapes
  1. Ouvrez log4j.conf.

  2. Commentez la ligne suivante :


    log4j.logger.xmppd.xfer=DEBUG, A3

Haute disponibilité pour Instant Messaging

La documentation concernant cette fonctionnalité est disponible sous Configuration d'Instant Messaging pour la haute disponibilité (Solaris uniquement).

Aide en ligne

Les informations suivantes ne sont décrites ni dans l'aide en ligne du produit ni dans le guide de référence rapide.

Écran de démarrage

L'écran de démarrage lance Instant Messenger. Si vous utilisez Java Web Start, cliquez sur le bouton Démarrer au centre de l'écran. Si vous utilisez le plug-in Java (utilisateurs de Windows uniquement), cliquez sur le bouton Plug-in Java en haut de l'écran. Les boutons d'aide en ligne et de référence rapide affichent l'aide du produit pour l'utilisateur final.