Konfigurationsdateien bearbeiten

Sie können die Konfigurationsdateien mithilfe des wsadmin-Clients und durch direktes Bearbeiten der Dateien bearbeiten.

1. Starten Sie den wsadmin-Client, indem Sie wie folgt vorgehen:
   1. Öffnen Sie eine Eingabeaufforderung und wechseln Sie dann in das folgende Verzeichnis des Systems, auf dem Sie den Deployment Manager installiert haben:

      app_server_root/profiles/dm_profile_root/bin

      Dabei ist dm_profile_root das Deployment Manager-Profilverzeichnis. Dieses Verzeichnis heißt normalerweise dmgr01. Unter Windows etwa ist das Verzeichnis C:\Programme\IBM\WebSphere\AppServer\profiles\Dmgr01\bin.

      Achtung: Sie müssen den Befehl ausführen, um den wsadmin-Client von diesem speziellen Verzeichnis aus zu starten, da die Jython-Dateien für das Produkt dort gespeichert sind. Wenn Sie den Client von einem anderen Verzeichnis aus starten, funktioniert der Befehl "execfile()" nicht ordnungsgemäß.
   2. Geben Sie den folgenden Befehl ein, um den wsadmin-Client zu starten:
      • AIX und Linux: ./wsadmin.sh -lang jython -user admin_user_id -password admin_password -port SOAP_CONNECTOR_ADDRESS_PORT
      • Microsoft Windows: wsadmin -lang jython -user admin_user_id -password admin_password -port SOAP_CONNECTOR_ADDRESS_PORT
      Dabei gilt Folgendes:

      • admin_user_id ist der Benutzername für die Administratorrolle für IBM WebSphere Application Server. Dieser Administrator muss auf Zellebene, nicht auf Cluster-, Knoten- oder Serverebene konfiguriert werden.
      • admin_password ist das Kennwort des WebSphere Application Server-Administrators.
      • SOAP_CONNECTOR_ADDRESS_PORT ist der SOAP-Port für den Deployment Manager-Server von WebSphere Application Server. Der Standardwert des SOAP-Ports ist 8879. Wenn Sie den Standardportwert verwenden, müssen Sie diesen Parameter nicht angeben. Wenn Sie den Standardwert nicht verwenden und die Portnummer nicht kennen, finden Sie diesen Wert in der Integrated Solutions Console von WebSphere Application Server. Gehen Sie wie folgt vor, um die SOAP-Portnummer zu suchen:
        1. Öffnen Sie Integrated Solutions Console von WebSphere Application Server für den Deployment Manager und wählen Sie dann Systemadministration > Deployment Manager aus.
        2. Erweitern Sie im Abschnitt mit den zusätzlichen Eigenschaften die Option Ports und suchen Sie dann den Eintrag für den Port der SOAP-CONNECTOR-ADRESSE, um die Portnummer zu bestimmen.
      Zum Beispiel:

      • AIX oder Linux: ./wsadmin.sh -lang jython -username primaryAdmin -password p@assword -port 8879
      • Microsoft Windows: wsadmin -lang jython -username primaryAdmin -password p@assword -port 8879
2. Verwenden Sie den folgenden Befehl, um auf die Konfigurationsdateien zuzugreifen:

   execfile("application_py_file")

   Dabei steht application_py_file für einen der folgenden Werte:

   • In IBM Connections: connectionsConfig.py
   • In der Anwendung "Aktivitäten": activitiesAdmin.py
   • In der Anwendung "Blogs": blogsAdmin.py
   • In der Anwendung "Lesezeichen": dogearAdmin.py
   • In der Anwendung "Communitys": communitiesAdmin.py
   • In der Anwendung "Dateien": filesAdmin.py
   • In der Anwendung "Foren": forumsAdmin.py
   • In der Anwendung "Homepage": homepageAdmin.py
   • In der Anwendung "Nachrichten": newsAdmin.py
   • In der Anwendung "Profile": profilesAdmin.py
   • In der Anwendung "Suche": searchAdmin.py
   • In der Anwendung "Wikis": wikisAdmin.py
   • In der Anwendung "Kennzahlen": metricsAdmin.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.

3. Checken Sie mit dem folgenden Befehl die Konfigurationsdatei für eine Anwendung aus:

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

   Dabei gilt Folgendes:

   • service_name steht für einen der folgenden Werte:
     • In IBM Connections: LCConfigService
     • In der Anwendung "Aktivitäten": ActivitiesConfigService
     • In der Anwendung "Blogs": Die Konfigurationseinstellungen für die Anwendung "Blogs" sind nicht in einer Konfigurationsdatei enthalten, sodass Sie keine Datei bearbeiten müssen. Anders als bei den anderen Anwendungen werden Ihre Änderungen direkt in die Blogs-Datenbank geschrieben, wenn Sie die Konfigurationseigenschaften der Anwendung "Blogs" bearbeiten.
     • In der Anwendung "Lesezeichen": DogearCellConfig
     • In der Anwendung "Communitys": CommunitiesConfigService
     • In der Anwendung "Dateien": FilesConfigService
     • In der Anwendung "Foren": ForumsConfigService
     • In der Anwendung "Nachrichten": NewsCellConfig
     • In der Anwendung "Profile": ProfilesConfigService
     • In der Anwendung "Suche": SearchCellConfig
     • In der Anwendung "Wikis": WikisConfigService
     • In der Anwendung "Kennzahlen": MetricsConfigService
   • 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.
   Zum Beispiel:
   • Allgemeine IBM Connections-Eigenschaften: LCConfigService.checkOutConfig("C:/temp","foo01Cell01") LCConfigService.checkOutNotificationConfig("C:/temp","foo01Cell01") LCConfigService.checkOutOpensocialConfig("C:/temp","fooCell01")
   • Die Datei events-config.xml: LCConfigService.checkOutEventsConfig("/temp","foo01Cell01")

     Dieser Befehl gehört zum LCConfig-Service und checkt die Datei events-config.xml aus. Weitere Informationen hierzu finden Sie im Abschnitt Datei "events-config.xml" bearbeiten.

   • In der Anwendung "Aktivitäten": ActivitiesConfigService.checkOutConfig("/temp","foo01Cell01")
   • In der Anwendung "Lesezeichen": DogearCellConfig.checkOutConfig("C:/temp","foo01Cell01")
   • In der Anwendung "Communitys": CommunitiesConfigService.checkOutConfig("/temp","foo01Cell01")
   • In der Anwendung "Dateien": FilesConfigService.checkOutConfig("C:/temp","foo01Cell01")
   • In der Anwendung "Foren": ForumsConfigService.checkOutConfig("C:/temp","foo01Cell01")
   • In der Anwendung "Kennzahlen": MetricsConfigService.checkOutConfig("/temp","foo01Cell01")
   • Im Nachrichten-Repository: NewsCellConfig.checkOutConfig("/temp","foo01Cell01")
   • In der Anwendung "Profile": ProfilesConfigService.checkOutConfig("C:/temp","foo01Cell01")
   • In der Anwendung "Suche": SearchCellConfig.checkOutConfig("/temp","foo01Cell01")
     Anmerkung: Der Befehl "HomepageCellConfig.checkOutConfig" wird durch den Befehl "SearchCellConfig.checkOutConfig" ersetzt.
   • In der Anwendung "Wikis": WikisConfigService.checkOutConfig("C:/temp","foo01Cell01")
4. Optional: Verwenden Sie den folgenden Befehl, um die aktuellen Werte der Konfigurationseigenschaften anzuzeigen:

   service_name.showConfig()

   Dabei steht service_name für einen der Servicenamen, die in Schritt 4 definiert wurden.
5. Bearbeiten Sie die Konfigurationseigenschaften, die Sie ändern möchten. Manche Eigenschaften müssen mithilfe des wsadmin-Clients bearbeitet werden. Andere wiederum können nur durch direktes Bearbeiten der XML-Konfigurationsdatei geändert werden.

   Zum Beispiel:

   service_name.updateConfig("property_name","new_value")

   Weitere Informationen zu den Konfigurationseigenschaften, die Sie bearbeiten können, finden Sie in der Dokumentation in den jeweiligen Abschnitten zu den einzelnen Anwendungen.

6. Um zu erzwingen, dass die Browser der Benutzer die Konfigurationsänderungen übernehmen, müssen Sie den Wert der Konfigurationseigenschaft für die Versionsmarke aktualisieren. Weitere Informationen finden Sie unter Erforderlicher Schritt nach der Anpassung.
7. Checken Sie die Konfigurationsdateien ein: service_name.checkInConfig()
   Dabei steht service_name für einen der Servicenamen, die in Schritt 4 definiert wurden. Sie müssen diesen Schritt für die Anwendung "Blogs" nicht durchführen. Verwenden Sie zum Einchecken der Datei events-config.xml den Befehl "LCConfigService.checkInEventsConfig()".

   Anmerkung: Sie müssen die Datei in derselben wsadmin-Sitzung einchecken, in der Sie sie ausgecheckt haben.
8. Implementieren Sie die Änderungen durch das Synchronisieren der Knoten: synchAllNodes()
9. Geben Sie in der Eingabeaufforderung exit ein, um den wsadmin-Client zu verlassen.
10. Stoppen und starten Sie die Server erneut, auf denen die IBM Connections-Anwendungen gehostet werden.
    Anmerkung: Wenn Sie nur die Blogs-Konfigurationseinstellungen geändert haben, müssen Sie die Server nicht erneut starten.