+

Search Tips   |   Advanced Search

Edit configuration files

We can edit configuration files either by using wsadmin.sh or by editing the files directly.

To edit a configuration file, check it out first.

Each configuration file is an XML that is paired with an XSD file. The XML file contains configuration settings and the corresponding XSD files is used to validate the XML file.

  1. start wsadmin.sh:

      cd app_server_root/profiles/Dmgr01/bin
      ./wsadmin.sh -lang jython -user admin_user_id -password admin_password -port SOAP_CONNECTOR_ADDRESS_PORT

    To get SOAP_CONNECTOR_ADDRESS_PORT, from the console, go to...

      System Administration | dmgr | Additional properties | Ports

  2. Access the configuration files:

      execfile("application_py_file")

    ...where application_py_file is one of the following values:

      IBM Connections-wide connectionsConfig.py
      Activities activitiesAdmin.py
      Blogs blogsAdmin.py
      Bookmarks dogearAdmin.py
      Communities communitiesAdmin.py
      Files filesAdmin.py
      Forums forumsAdmin.py
      Home page homepageAdmin.py
      News newsAdmin.py
      Profiles profilesAdmin.py
      Search searchAdmin.py
      Wikis wikisAdmin.py
      Metrics metricsAdmin.py

  3. Check out configuration file...

      service_name.checkOutConfig("/tmp", "cell_name")

    where:

    • service_name is one of the following values:

      IBM Connections-wide LCConfigService
      Activities ActivitiesConfigService
      Blogs The configuration settings for Blogs are not in a configuration file, so you do not have to edit a file. Unlike the other applications, when we edit Blogs configuration properties, the changes are written directly to the Blogs database.
      Bookmarks DogearCellConfig
      Communities CommunitiesConfigService
      Files FilesConfigService
      Forums ForumsConfigService
      News NewsCellConfig
      Profiles ProfilesConfigService
      Search SearchCellConfig
      Wikis WikisConfigService
      Metrics MetricsConfigService

    • /tmp is the temporary working directory to which configuration files are copied. The files are kept in this working directory while you edit them.

      • With Windows, use a forward slash for the directory. For example: "/tmp".
      • AIX, IBM i, and Linux only: The directory must grant write permissions or the command fails.

    • To determine: print AdminControl.getCell()

    For example:

    • Common IBM Connections properties:

        LCConfigService.checkOutConfig("/tmp","foo01Cell01")
        LCConfigService.checkOutNotificationConfig("/tmp","foo01Cell01")
        LCConfigService.checkOutOpensocialConfig("/tmp","fooCell01")

    • The events-config.xml file:

        LCConfigService.checkOutEventsConfig("/temp","foo01Cell01")
      This command is part of the LCConfig service, and checks out the events-config.xml file. See Edit the events-config.xml file.

      Activities ActivitiesConfigService.checkOutConfig("/temp","foo01Cell01")
      Bookmarks DogearCellConfig.checkOutConfig("/tmp","foo01Cell01")
      Communities CommunitiesConfigService.checkOutConfig("/temp","foo01Cell01")
      Files FilesConfigService.checkOutConfig("/tmp","foo01Cell01")
      Forums ForumsConfigService.checkOutConfig("/tmp","foo01Cell01")
      Metrics MetricsConfigService.checkOutConfig("/temp","foo01Cell01")
      News repository NewsCellConfig.checkOutConfig("/temp","foo01Cell01")
      Profiles ProfilesConfigService.checkOutConfig("/tmp","foo01Cell01")
      Search SearchCellConfig.checkOutConfig("/temp","foo01Cell01")

      The HomepageCellConfig.checkOutConfig command is superseded by the SearchCellConfig.checkOutConfig command.

      Wikis WikisConfigService.checkOutConfig("/tmp","foo01Cell01")

    • To see the current values of the configuration properties:

        service_name.showConfig()

      ...where service_name is one of the service names defined in step 4.

    • Edit the configuration properties to change.

      Some properties must be edited using wsadmin.sh; others can be edited only by editing the configuration XML file directly.

      For example:

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

      For more information about configuration properties that we can edit, see the documentation for the individual application sections.

    • To force users' browsers to pick up the changes to the configuration, update the value of the version stamp configuration property. See Required post-customization step.

    • Check in the configuration files:

        service_name.checkInConfig()

      We do not have to complete this step for the Blogs application. To check in the events-config.xml file, use...

        LCConfigService.checkInEventsConfig()

      Check in the file during the same wsadmin session in which you checked it out.

    • Deploy the changes by synchronizing the nodes:

        synchAllNodes()

    • To exit the wsadmin client, type exit at the prompt.

    • Stop and restart the servers that host the Connections applications.

      If we changed Blogs configuration settings only, you do not have to restart the servers.


See also


Parent topic:
Administration tools


Related:
Single sign-on
Export LTPA keys
Import LTPA keys
Required post-customization step