Access the Bookmarks configuration file 

To make configuration changes to a Bookmarks deployment first access the Bookmarks configuration file.

Before you begin

To edit configuration files, use the wsadmin client. See Starting the wsadmin client for details.

About this task

Configuration files are XML-formatted files that store configuration information. The file dogear-config-cell.xml stores properties that affect Bookmarks, such as determining thresholds for displaying active tag, person, and link data. Follow these steps to access one of the Bookmarks configuration files:


  1. Start the wsadmin client from the following directory of the system on which you installed the deployment manager:


      where <app_server_root> is the WAS installation directory and <dm_profile_root> is the dmgr profile directory, typically dmgr01. For example, on Windows:

      C:\Program Files\IBM\WebSphere\AppServer\profiles\Dmgr01\bin

      Attention: You must run the following command to start the wsadmin client from this specific directory because the Jython files for the product are stored here. If you try to start the client from a different directory, then the execfile() command that you subsequently call to initialize the administration environment for an IBM Connections component does not work correctly. See the topic Starting the wsadmin client.

  2. Start the Bookmarks Jython script interpreter by entering the following command:


      If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

  3. To change properties, check out the configuration file, dogear-config-cell.xml, with the following command:

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


      • <working_directory> is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.

          Note: AIX and Linux only: The directory must grant write permissions or the command will not run successfully.

      • <cell_name> is the name of the WAS cell hosting the IBM Connections application. This argument is case-sensitive, so type it with care. If you do not know the cell name, you can determine it by typing the following command in the wsadmin command processor:

          print AdminControl.getCell()

      For example:

      • AIX/Linux:


      • Microsoft Windows:


      This command should print out this message: Bookmarks Cell Level configuration file successfully checked out.

  4. To view a list of the valid Bookmarks configuration settings and their current values, use the following command:


  5. To change a Dogear configuration setting, use the following command:

      DogearCellService .updateConfig(" [property]", " [value]") where [property] is one of the editable Dogear properties and [value] is the new value to apply to the property. For example:

      DogearCellService.updateConfig("favIconService.favicon.queuesize", "50")

What to do next

After making changes, check the configuration files back in and do so during the same wsadmin session in which you checked them out for the changes to take effect. See Apply property changes for details.

Parent topic

Administer Bookmarks

Related tasks

Starting the wsadmin client