test

Sun Java System Communications Services 2005Q4 Versionshinweise

Administration Guide

In diesem Abschnitt werden folgende Änderungen am Sun Java System Instant Messaging 7 2005Q1 Administration Guide aufgeführt.

Starten, Anhalten und Aktualisieren von Komponenten in einer HA-Umgebung

Verwenden Sie nicht die Befehle imadmin start, imadmin stop oder imadmin refresh in einer HA-Umgebung mit Sun Cluster. Verwenden Sie stattdessen die Sun Cluster-Verwaltungsdienstprogramme.

Weiterer Schritt nach der Installation für Bereitstellungen mit Access Manager

(Problem Nr.: 6189148) Wenn Access Manager auf einem anderen Host als dem Instant Messaging-Server installiert wird, müssen Sie nach der Ausführung des Konfigurationsdienstprogramms die imServices_*-Dateien manuell von den Instant Messaging-Server-Hosts auf den Access Manager-Host kopieren.

Gehen Sie hierzu wie folgt vor:

  1. Suchen Sie die imService_*.properties-Dateien auf dem Instant Messaging-Server-Host. Diese Dateien befinden sich unter Solaris standardmäßig im Verzeichnis /opt/SUNWiim/lib/ und unter Linux im Verzeichnis /opt/sun/im/lib/.

  2. Kopieren Sie die Dateien in das Verzeichnis locale auf dem Access Manager-Host. Standardmäßig lautet dieses Verzeichnis /opt/SUNWam/locale unter Solaris und /opt/sun/identity/locale unter Linux.

Änderung am Standardwert für den Parameter iim_agent.enable

(Problem Nr.: 5102072) In dieser Version wurde der Standardwert des Parameters iim_agent.enable auf "false" geändert. Diese Änderung wird im Administrationshandbuch nicht berücksichtigt.

Konfigurieren von Kalender-Popup-Erinnerungen für Instant Messenger

Schritt 1 des Verfahrens "To Configure Instant Messaging Server" ist falsch. Es gibt kein Paket mit dem Namen SUNWiimag. Überspringen Sie diesen Schritt.

Parameter aus iim.conf entfernt

Der Konfigurationsparameter iim_server.msg_archive.auto wird nicht mehr unterstützt, obwohl er fälschlicherweise in die Liste der Parameter im Administrationshandbuch aufgenommen wurde.

Aktivieren der Komponente Instant Messenger Archive Control für das Java Plug-In

(Problem Nr.: 6244099) Das im Administrationshandbuch beschriebene Verfahren für die Aktivierung der Komponente Instant Messenger Archive Control für das Java Plug-In ist falsch. Verwenden Sie stattdessen das unter Änderungen für die HTML-Applet-Seiten und die pluginLaunch.jsp -Dateien beschriebene Verfahren.

Änderungen für die HTML-Applet-Seiten und die pluginLaunch.jsp -Dateien

Wenn Sie Java Plug-In zum Starten von Instant Messenger verwenden, müssen Sie folgende Shritte ausführen, um die Funktion Instant Messenger Archive Control in Instant Messenger zu aktivieren.

ProcedureSo aktivieren Sie Instant Messenger Archive Control für Java Plug-In

Schritte

  1. Wechseln Sie zum Stammverzeichnis der Instant Messenger-Dokumentation und suchen Sie die Dateien im.html und imssl.html.

    Standardmäßig werden die Dateien in folgendem Verzeichnis installiert:

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

  2. Öffnen Sie die .html-Dateien in einem Texteditor.

  3. Fügen Sie folgende Zeile hinzu bzw. bearbeiten Sie sie:


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

Speichern von archivierten Nachrichten in einer nicht standardmäßigen Portal Server-Suchdatenbank

Bei dem Vorgang tritt ein Fehler auf. Insbesondere muss das Verzeichnis

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

eigentlich folgendermaßen lauten:

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

Beispiel:

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

Konfigurieren des Servers für die Zulassung neuer Benutzerregistrierungen

Die Funktion für die Registrierung neuer Benutzer ist im Administrationshandbuch nicht vollständig beschrieben. Neben der Anpassung von Instant Messenger müssen Sie außerdem den Server so konfigurieren, dass die Registrierung neuer Benutzer zulässig ist.

Dazu müssen Sie vier Konfigurationsparameter zu iim.conf hinzufügen und anschließend die Serverkonfiguration aktualisieren. In Tabelle 3–4 werden die Konfigurationsparameter beschrieben.

Tabelle 3–4 Serverkonfigurationsparameter für die Registrierung neuer Benutzer

Parameter 

Beschreibung 

iim.register.enable

Wenn TRUE, ermöglicht der Server neuen Instant Messaging-Endbenutzern sich mithilfe von Instant Messenger zu registrieren (sich selbst zum Verzeichnis hinzuzufügen).

iim_ldap.register.enable

Wenn TRUE, ermöglicht der Server neuen Instant Messaging-Endbenutzern sich mithilfe von Instant Messenger zu registrieren (sich selbst zum Verzeichnis hinzuzufügen).

iim_ldap.register.basedn

Wenn die Selbstregistrierung aktiviert ist, ist der Wert dieses Parameters der DN des Speicherorts im LDAP-Verzeichnis, in dem Personeneinträge gespeichert werden. Beispiel: 

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

iim_ldap.register.domain

Die Domäne, zu der die neuen Benutzer hinzugefügt werden. Beispiel: 

directory.siroe.com

ProcedureSo konfigurieren Sie den Server für die Zulassung neuer Benutzerregistrierungen

Schritte

  1. Öffnen Sie iim.conf in einem Texteditor.

  2. Fügen Sie die Konfigurationsparameter und die entsprechenden Werte hinzu, wie in Tabelle 3–4 beschrieben.

  3. Schließen und speichern Sie iim.conf.

  4. Aktualisieren Sie die Serverkonfiguration mithilfe des Befehlszeilendienstprogramms imadmin.

    imadmin refresh server

    Achtung – Achtung –

    Verwenden Sie nicht die Befehle imadmin start, imadmin stop oder imadmin refresh in einer HA-Umgebung mit Sun Cluster. Verwenden Sie stattdessen die Sun Cluster-Verwaltungsdienstprogramme.

Zusätzliche Protokollierungsparamter für XMPP-Verkehr

(Problem Nr.: 5070998) Ein zusätzlicher nicht dokumentierter Protokollierungsparameter wurde zu dieser Version hinzugefügt, um XMPP-Nachrichten in einer gesonderten Protokolldatei zu sammeln.

ProcedureSo konfigurieren Sie den Server für die Erstellung des XMPP- Meldungsprotokolls

Schritte

  1. Öffnen Sie iim.conf.

    Standardmäßig wird die Datei iim.conf wie folgt im Konfigurationsverzeichnis installiert:

    • Unter Solaris:

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

    • Unter Linux:

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

    Wenn Sie mehrere Instanzen von Instant Messaging erstellt haben, variiert der Name des Verzeichnisses /default je nach Instanz.

  2. Aktivieren Sie folgende Zeile durch Entfernen der Kommentarzeichen:


    iim.log4j.config=log4j.conf

    Wenn die Zeile nicht vorhanden ist, fügen Sie sie hinzu.

  3. Schließen und speichern Sie iim.conf.

  4. Erstellen Sie eine Datei mit dem Namen log4j.conf und speichern Sie sie im Konfigurationsverzeichnis.

  5. Fügen Sie folgenden Text zu log4j.conf hinzu:


    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. Speichern und schließen Sie log4j.conf.

  7. Aktualisieren Sie den Server:


    imadmin refresh server
    Achtung – Achtung –

    Verwenden Sie nicht die Befehle imadmin start, imadmin stop oder imadmin refresh in einer HA-Umgebung mit Sun Cluster. Verwenden Sie stattdessen die Sun Cluster-Verwaltungsdienstprogramme.

ProcedureSo können Sie die Erstellung separater XMPP-Protokolldateien deaktivieren

Die Deaktivierung der Erstellung separater XMPP-Protokolldateien bedeutet nicht, dass keine SMPP-Meldungen mehr ins Serverprotokoll geschrieben werden.

Schritte

  1. Öffnen Sie log4j.conf.

  2. Setzen Sie folgende Zeile auf Kommentar:


    log4j.logger.xmppd.xfer=DEBUG, A3

High Availability for Instant Messaging

Dokumentation zu dieser Funktion finden Sie unter Konfigurieren von Instant Messaging für High Availability (Solaris Only).