To make configuration changes to a Bookmarks deployment
you must first access the Bookmarks configuration file.
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:
Procedure
- Start the wsadmin client from the following directory of
the system on which you installed the deployment manager:
app_server_root\profiles\dm_profile_root\bin
where
app_server_root is the WebSphere Application Server installation directory and
dm_profile_root is the Deployment Manager 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.
- Start the Bookmarks Jython script interpreter by entering
the following command:
execfile("dogearAdmin.py")
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,
you must pick the node where the file is stored.
- To change properties, check out the configuration file, dogear-config-cell.xml,
with the following command:
DogearCellConfig.checkOutConfig( "<working_directory>", "<cell_name>")
where:
For example:
- AIX and
Linux:
DogearCellConfig.checkOutConfig("/opt/dogear/temp","DogearServerNode01Cell")
- Microsoft Windows:
DogearCellConfig.checkOutConfig("c:/dogear/temp","DogearServerNode01Cell")
This command should print out this message:
Bookmarks
Cell Level configuration file successfully checked out.
- To view a list of the valid Bookmarks
configuration settings and their current values, use the following
command:
DogearCellConfig.showConfig()
- 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:
DogearCellConfig.updateConfig("favIconService.favicon.queuesize", "50")
What to do next
After making changes, you must check the configuration files
back in and you must do so during the same wsadmin session in which
you checked them out for the changes to take effect. See Applying
property changes for details.