Accessing the Bookmarks configuration file
To make configuration changes to a Bookmarks deployment you must first access the Bookmarks configuration file.
Before you begin
To edit configuration files, you must use the wsadmin client. See Starting the wsadmin client for details.
About this task
Procedure
- Start the wsadmin client from the following directory of
the system on which you installed the deployment manager:
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:app_server_root\profiles\dm_profile_root\bin
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:where:
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: The directory must grant write permissions or the command will not run successfully.
- cell_name is the name of the WebSphere® Application Server 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()
- AIX and
Linux:
DogearCellConfig.checkOutConfig("/opt/dogear/temp","DogearServerNode01Cell")
- Microsoft® Windows®:
DogearCellConfig.checkOutConfig("c:/dogear/temp","DogearServerNode01Cell")
- 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.
- 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")