Run Bookmarks administrative commands 

Run administrative commands from the wsadmin command line to directly interact with Bookmarks. You do not have to check out files or restart the server for changes to take effect.


Before you begin

To run administrative commands, use the wsadmin client. See Starting the wsadmin client for details.


About this task

Administrative commands require you to start the wsadmin command line processor. From there, you run Jython scripts to administer the Bookmarks application. These config-admin scripts get and set properties using the AdminConfig object (wsadmin) available in WAS to interact with the Bookmarks server. Unlike with configuration properties, when you use administrative commands to change server administration properties, you do not have to check out any files nor restart the server. Your changes take effect immediately.

When executing the MBean commands, if the command encounters an input that is not valid, such as a missing quote or incorrect file path, the following exception can be returned in the wsadmin console:

com.ibm.ws.scripting.ScriptingException com.ibm.ws.scripting.ScriptingException: 
javax.management.RuntimeMBeanException:
resetTasks 

To determine what went wrong, you can examine the SystemOut.log file. It should show an exception entered as a result of the Mbean command responsible for the exception.

To change Bookmarks administrative settings...


Procedure

  1. 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 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:

      execfile("dogearAdmin.py")

      Use administrative commands
      The commands described here manipulate managed Java™ beans (MBeans) to make changes to various operational data on a Bookmarks server.


Parent topic

Administer Bookmarks


Related tasks


Starting the wsadmin client


   

 

});