Anwendungs-URLs ändern

Ändern Sie das Kontextstammverzeichnis von URLs, die auf IBM® Connections-Anwendungen verweisen.

Informationen zu diesem Vorgang

Die Webadresse einer IBM Connections-Anwendung enthält einen Standardwert für das Kontextstammverzeichnis. Sie können den Wert für dieses Kontextstammverzeichnis so ändern, dass er den unternehmensinternen Richtlinien entspricht, die einschränken, wo Serveranwendungen implementiert und wie sie aufgerufen werden können.

Die Anwendung "Blogs" ist z. B. standardmäßig über host_server/blogs verfügbar. Sie können diese Basisadresse beispielsweise in host_server/IBMConnectionsBlogs ändern, um diesen Blogging-Service von anderen zu unterscheiden oder um Unternehmensrichtlinien einzuhalten.

Gehen Sie wie folgt vor, um das Kontextstammverzeichnis einer Anwendung zu ändern:

Vorgehensweise

  1. Melden Sie sich an der WebSphere Application Server Integration Solutions Console an.
  2. Erweitern Sie die Option Anwendungen > Anwendungstypen und wählen Sie anschließend WebSphere-Unternehmensanwendungen aus.
  3. Klicken Sie auf den Namen der implementierten Anwendung und klicken Sie dann auf der Seite, die geladen wird, auf Kontextstammverzeichnis für Webmodule.
    Anmerkung: Führen Sie diesen Schritt für jede Anwendung aus, deren URL Sie ändern möchten.
  4. Bearbeiten Sie die Werte in der Spalte Kontextstammverzeichnis der Tabelle. Die Pfade müssen mit einem Schrägstrich (/) beginnen und dürfen keine Leerzeichen enthalten.

    Geben Sie keinen einzelnen Schrägstrich (/) als vollständiges Kontextstammverzeichnis an. Durch diese Spezifikation können die Anwendungen Atom-Feeds nicht ordnungsgemäß abrufen. Die Verwendung des standardmäßigen Anwendungskontexts ("/") wird nicht unterstützt.

  5. Klicken Sie auf OK und anschließend auf der Seite für Servereigenschaften auf OK, um die Änderung zu speichern.
  6. Starten Sie den wsadmin-Client im folgenden Verzeichnis des Systems, auf dem Sie den Deployment Manager installiert haben:
    app_server_root\profiles\dm_profile_root\bin
    Anmerkung: Sie müssen den Client von diesem Verzeichnis aus starten. Andernfalls werden die von Ihnen eingegebenen Befehle nicht ordnungsgemäß ausgeführt. Weitere Informationen hierzu finden Sie im Abschnitt wsadmin-Client starten.
  7. Aktualisieren Sie die IBM Connections-Konfigurationsdatei so, dass sie diese Änderung des Kontextstammverzeichnisses enthält. Verwenden Sie den wsadmin-Client, um auf die Datei zuzugreifen und sie auszuchecken.
    1. Verwenden Sie den folgenden Befehl, um die IBM Connections-Konfigurationsdatei zu laden: execfile("connectionsConfig.py")

      Wenn Sie zur Angabe eines Service aufgefordert werden, mit dem eine Verbindung hergestellt werden soll, geben Sie 1 ein, um den ersten Knoten in der Liste auszuwählen. Die meisten Befehle können auf jedem beliebigen Knoten ausgeführt werden. Wenn durch den Befehl Informationen mithilfe eines lokalen Dateipfades in eine Datei geschrieben oder aus einer Datei gelesen werden, müssen Sie den Knoten auswählen, auf dem die Datei gespeichert ist. Diese Informationen werden vom wsadmin-Client nicht verwendet, wenn Sie Konfigurationsänderungen vornehmen.

    2. Geben Sie den folgenden Befehl ein, um die IBM Connections-Konfigurationsdateien auszuchecken:

      LCConfigService.checkOutConfig("working_directory","cell_name")

      Dabei gilt Folgendes:
      • working_directory steht für das temporäre Arbeitsverzeichnis, in das die Konfigurationsdateien kopiert werden. Die Dateien werden in diesem Arbeitsverzeichnis aufbewahrt, während Sie sie bearbeiten.
        Notes:
        • Wenn Sie auf einem System, auf dem Microsoft Windows ausgeführt wird, einen Pfad zum Arbeitsverzeichnis angeben, verwenden Sie einen Schrägstrich für das Verzeichnis. Beispiel: "C:/temp".
        • Nur AIX und Linux: Das Verzeichnis muss Schreibberechtigungen erteilen. Andernfalls schlägt die Ausführung des Befehls fehl.
      • cell_name ist der Name der WebSphere Application Server-Zelle, die als Host der IBM Connections-Anwendung dient. Wenn Ihnen der Zellenname nicht bekannt ist, können Sie ihn anzeigen, indem Sie den folgenden Befehl im wsadmin-Client eingeben: print AdminControl.getCell()
        Anmerkung: Bei diesem Eingabeparameter müssen Sie die Groß-/Kleinschreibung beachten.
  8. Aktualisieren Sie den Wert des href-Präfixes mithilfe des folgenden Befehls:

    LCConfigService.updateConfig("<web_module_name.href.prefix", "new_context_root_value")

    Dabei gilt Folgendes:

    web_module_name ist der Name des Webmoduls für die Anwendung. Jede Anwendung verfügt über mindestens ein Webmodul (siehe Tabelle "Anwendungswebmodule") und

    new_context_root_value ist der Wert, den Sie für das Kontextstammverzeichnis für die Webbenutzerschnittstelle der Anwendung in Schritt 4 definiert haben. Verwenden Sie z. B. zum Ändern des Kontextstammverzeichnisses der Anwendung "Profile" die folgenden Befehle:

    LCConfigService.updateConfig("profiles.href.prefix","/contacts") LCConfigService.updateConfig("personTag.href.prefix","/contacts")

    Tabelle 1. Webmodule für Anwendungen
    Anwendungs- oder Servicename Webmodule
    Aktivitäten /activities

    /activities/quickrpicker

    Blogs /blogs
    Cognos cognos
    Allgemein /connections/bookmarklet
    /connections
    /connections/config
    /connections/oauth
    /connections/resources
    Communitys /communities

    /communities/calendar

    /communities/recomm

    ConnectionsProxy /connections/proxy
    Dogear /dogear
    Erweiterungen extensions
    Dateien /files
    FileNetEngine

    (Nur verfügbar, wenn FileNet Teil Ihrer Implementierung ist.)

    FileNet
    clientDownload
    P8CE
    wsi
    acce
    pewsi
    peengine
    ibmccepo
    Foren /forums
    Hilfe /help
    Homepage /homepage
    Kennzahlen /metrics

    /metrics/service

    Mobil /mobile

    /connections/filesync

    /connections/filediff

    Mobile Administration mobileAdmin
    Moderation /moderation

    /moderation/proxy

    Navigator

    (Nur verfügbar, wenn FileNet Teil Ihrer Implementierung ist.)

    dm
    Nachrichten /news
    URLPreview /connections/thumbnail

    /connections/opengraph

    Profile /profiles

    /profiles/ext/admin

    /profiles/seedlist

    PushNotification /push
    RichTextEditors /connections/rte
    Suche /search
    WidgetContainer /connections/opensocial
    Wikis wikis
    Anmerkung:
    • Diese Tabelle ist derzeit aktuell.

      Kontextstammverzeichnisse können sich von einem Release zum nächsten ändern, sodass Sie jede Definition manuell überprüfen sollten.

    • Einige Anwendungen enthalten in der Datei LotusConnections-config.xml ebenfalls mehrere Komponenten, sodass Sie diese möglicherweise auch aktualisieren müssen. Siehe die Beispiele in Tabelle 2:
    Tabelle 2. Komponenten in Anwendungen (Beispiel)
    Anwendung Komponente
    Allgemein /connections/bookmarklet
    /connections/opengraph
    /connections/thumbnail
    /connections/opensocial
    /connections/resources/socmail-client
    /connections/resources

    /connections/oauth

    /connections/opensocial
    Nachrichten /news/widgets/lw
    Profile /profiles/ibm_semanticTagServlet
  9. Checken Sie die Datei in derselben wsadmin-Sitzung wieder ein, in der Sie sie ausgecheckt haben. Weitere Informationen hierzu finden Sie im Abschnitt Änderungen allgemeiner Konfigurationseigenschaften übernehmen.
  10. (Nur bei "Dateien" und "Wikis") Gehen Sie wie folgt vor:
    1. Checken Sie die Konfigurationsdateien für die Anwendungen "Dateien" und "Wikis" aus. Weitere Informationen finden Sie unter Konfigurationseigenschaftswerte ändern in den Abschnitten Dateien verwalten und Wikis verwalten der Produktdokumentation.
    2. Suchen Sie die folgende Eigenschaft:
      <security>
         <logout href="/files/ibm_security_logout" />
      </security>
    3. Ändern Sie sie folgendermaßen:
      <security>
         <logout href="new_context_root_value>/ibm_security_logout" />
      </security>
  11. Generieren Sie die Datei plugin-cfg.xml erneut:
    1. Öffnen Sie die WebSphere Application Server Integrated Solutions Console.
    2. Erweitern Sie die Option Server > Servertypen und wählen Sie dann Web-Server aus.
    3. Aktivieren Sie das Kontrollkästchen neben dem IBM HTTP Server-Namen. Beispiel: webserver1.
    4. Klicken Sie auf Plug-in generieren.
    5. Klicken Sie ggf. auf die Option zum Verteilen von Plug-ins, um die Datei plugin-cfg.xml aus dem lokalen Verzeichnis auf das ferne System zu kopieren.
  12. Starten Sie IBM HTTP Server erneut.
  13. Löschen Sie den Suchindex. Die Indexierungstask wird standardmäßig alle 15 Minuten ausgeführt und erstellt den Index erneut, wenn Sie ihn gelöscht haben. Weitere Informationen hierzu finden Sie im Abschnitt Index löschen.
  14. Aktualisieren Sie die Clients, die keine Browser-Clients sind, so, dass sie auf die neue URL verweisen. Informationen zu den erforderlichen Schritten finden Sie in der Clientdokumentation.
  15. Führen Sie den Befehl BlogsAdminService.fixBrokenUrls aus, um die absoluten URLs zu korrigieren, die von integrierten Bildern und Anhängen in Blogs verwendet werden. Weitere Informationen finden Sie unter URLs in Blogs ersetzen.
  16. Optional: Erstellen Sie eine Landing-Page für die alte URL, über die auf die neue URL umgeleitet wird.