Dieser Abschnitt enthält Informationen über Änderungen an und Fehler in der Dokumentation in folgenden Abschnitten:
Für Version 2005Q4 von Instant Messaging wird folgende Version des Administrationshandbuchs verwendet:
Sun Java System Instant Messaging 7 2005Q1 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
Weiterer Schritt nach der Installation für Bereitstellungen mit Access Manager
Konfigurieren von Kalender-Popup-Erinnerungen für Instant Messenger
Aktivieren der Komponente Instant Messenger Archive Control für das Java Plug-In
Änderungen für die HTML-Applet-Seiten und die pluginLaunch.jsp -Dateien
So aktivieren Sie Instant Messenger Archive Control für Java Plug-In
Speichern von archivierten Nachrichten in einer nicht standardmäßigen Portal Server-Suchdatenbank
Konfigurieren des Servers für die Zulassung neuer Benutzerregistrierungen
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.
(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:
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/.
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.
(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.
Schritt 1 des Verfahrens "To Configure Instant Messaging Server" ist falsch. Es gibt kein Paket mit dem Namen SUNWiimag. Überspringen Sie diesen Schritt.
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.
(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.
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.
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
Öffnen Sie die .html-Dateien in einem Texteditor.
Fügen Sie folgende Zeile hinzu bzw. bearbeiten Sie sie:
<PARAM NAME="archive_control" VALUE="true" /> <EMBED archive_control=true;/> |
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/
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 |
Öffnen Sie iim.conf in einem Texteditor.
Fügen Sie die Konfigurationsparameter und die entsprechenden Werte hinzu, wie in Tabelle 3–4 beschrieben.
Schließen und speichern Sie iim.conf.
Aktualisieren Sie die Serverkonfiguration mithilfe des Befehlszeilendienstprogramms imadmin.
imadmin refresh server
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.
(Problem Nr.: 5070998) Ein zusätzlicher nicht dokumentierter Protokollierungsparameter wurde zu dieser Version hinzugefügt, um XMPP-Nachrichten in einer gesonderten Protokolldatei zu sammeln.
Ö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.
Aktivieren Sie folgende Zeile durch Entfernen der Kommentarzeichen:
iim.log4j.config=log4j.conf |
Wenn die Zeile nicht vorhanden ist, fügen Sie sie hinzu.
Schließen und speichern Sie iim.conf.
Erstellen Sie eine Datei mit dem Namen log4j.conf und speichern Sie sie im Konfigurationsverzeichnis.
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 |
Speichern und schließen Sie log4j.conf.
Aktualisieren Sie den Server:
imadmin refresh server |
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.
Die Deaktivierung der Erstellung separater XMPP-Protokolldateien bedeutet nicht, dass keine SMPP-Meldungen mehr ins Serverprotokoll geschrieben werden.
Dokumentation zu dieser Funktion finden Sie unter Konfigurieren von Instant Messaging für High Availability (Solaris Only).
Folgende Informationen finden Sie weder in der Online-Hilfe zum Produkt noch in der Kurzanleitung.
Im Startbildschirm wird Instant Messenger gestartet. Wenn Sie Java Web Start verwenden, klicken Sie auf die Startschaltfläche in der Bildschirmmitte. Wenn Sie Java Plug-In verwenden (nur bei Windows), klicken Sie auf die Java Plug-In-Schaltfläche oben im Bildschirm. Mithilfe der Schaltflächen für die Online-Hilfe und die Kurzanleitung können Sie die Produkthilfe für Endbenutzer anzeigen.