Home

Edit configuration files

 

+

Search Tips   |   Advanced Search

You can edit configuration files in two ways:

In both cases, first check out the configuration files and later check them back in using the wsadmin client.


To check out a configuration file

  1. Start wsadmin

  2. Access the feature configuration files:

    ...where <feature_py_file> is one of the following...

      Lotus Connections-wide: connectionsConfig.py
      Activities: activitiesAdmin.py
      Blogs: blogsAdmin.py
      Bookmarks: dogearAdmin.py
      Communities: communitiesAdmin.py
      Files: filesAdmin.py
      Home Page: homepageAdmin.py
      Profiles: profilesAdmin.py
      Search: searchAdmin.py
      Wikis: wikisAdmin.py

  3. When you are prompted to specify the server to connect to, type 1.

    This information is not used by the wsadmin client when you are making configuration changes.

  4. Check out the configuration file for the feature...

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

    ...where <service_name> is one of the following...

      LC-wide LCConfigService
      Activities ActivitiesConfigService
      Blogs The configuration settings for the Blogs feature are not made in a configuration file, so no files need to be checked out, updated, and checked back in for Blogs. Unlike the other features, when you edit Blogs configuration properties, the changes are written directly to the Blogs database tables.
      Bookmarks DogearCellConfig
      Communities CommunitiesConfigService
      Files FilesConfigService
      Home Page HomepageCellConfig
      Profiles ProfilesConfigService
      Search SearchConfigService
      Wikis WikisConfigService

    <working_directory> is the temporary working directory to which the configuration XML and XSD files are copied by the checkOutConfig command. The XML file contains the configuration settings and the corresponding XSD files is used to validate the XML file. The files are kept in this working while you make changes to them using the updateConfig command. When you run the checkInConfig command, the updated configuration file is copied from the temporary to where these files are located and overwrites the existing XML file. When you specify a path to the working on a system running Microsoft Windows, use a forward slash for the For example: "C:/temp".

    cell_name is the name of the WebSphere Application Server cell hosting the Lotus Connections feature. This argument is required even in stand-alone deployments. This argument is also case-sensitive, so type it with care. If you do not know the cell name, do one of the following to determine it:

    • Stand-alone deployment: From the file system...

        WAS_HOME\profiles\profile_name\config\cells\ 

    • Network deployment: Type the following command while in the wsadmin command processor:

        print AdminControl.getCell() 

    For example:

    • Common Lotus Connections properties:

        LCConfigService.checkOutConfig("C:/temp","foo01Cell01") 

    • Activities:

        ActivitiesConfigService.checkOutConfig("/temp","foo01Cell01") 

    • Bookmarks:

        DogearCellConfig.checkOutConfig("C:/temp","foo01Cell01") 

    • Communities:

        CommunitiesConfigService.checkOutConfig("/temp","foo01Cell01") 

    • Files:

        FilesConfigService.checkOutConfig("C:/temp","foo01Cell01") 

    • Home Page:

        HomepageCellConfig.checkOutConfig("/temp","foo01Cell01") 

    • Profiles:

        ProfilesConfigService.checkOutConfig("C:/temp","foo01Cell01") 

    • Search:

        SearchConfigService.checkOutConfig("/temp","foo01Cell01") 

    • Wikis:

        WikisConfigService.checkOutConfig("C:/temp","foo01Cell01") 

  5. Optional: To see current values of configuration properties...

  6. Edit the values of the configuration properties that you want to change. Some properties must be edited using the wsadmin client; others can only be edited by editing the configuration XML file directly. For example:

  7. After making edits, check the configuration files back in...

    You do not need to perform this step for the Blogs feature.

    Run the checkin during the same wsadmin session in which you ran the checkout command.

  8. Activities only: If you make a change to the configuration of a scheduled task, clear the existing jobs from memory and from the database...

      Scheduler.purgeJobs("local")  
      Scheduler.purgeJobs("cluster")
      

    All properties with names that begin with the term jobs. affect scheduled tasks, as do the following properties:

    • clusterScheduler.enabled
    • localScheduler.enabled

  9. Lotus Connections-wide configuration file changes made on network deployments only: After making updates, to deploy the changes:

      synchAllNodes()
      

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

  11. If you are making changes to a single feature, stop and restart the server hosting the edited Lotus Connections feature. If you are making changes to the Lotus Connections-wide configuration file, stop and restart all of the Lotus Connections feature servers.

    If you changed any Blogs configuration settings, the changes were written directly into the Blogs database tables. Therefore, you do not need to stop and restart the server hosting the Blogs feature for the changes to take effect.

For more experienced folks, if you do not want to use wsadmin.sh checkin/checkout, you can edit XML files directory. Make a backup of *.xml file first. Do not use an xml extension for your backup. After making changes use syncNode.sh to synchronize your changes to dmgr.


See also