The admin tool utility provides a simple, command-line interface for common administration tasks such as adding Associations to the registry and removing objects from the registry
This developer guide covers how to configure and extend the admin tool. For information on how to run the admin tool, see the admin tool user guide.
The following parameters that are not documented in the admin tool user guide are recognised when starting the admin tool:
The AdminTool object that you run when you execute the jar file calls an object that implements the AdminShell interface to do the work. You must specify which class to use either as the value of the omar.client.adminTool.AdminShellFactory.adminShellClass property in your jaxr-ebxml.properties file or on the command line using the -class parameter.
There is currently only one class provided for your use: org.freebxml.omar.client.adminTool.SimpleAdminShell.
The easiest way it to copy and modify one of the existing classes in org.freebxml.omar.client.adminTool.function.
Once you've written the class, add it to the org.freebxml.omar.client.adminTool.AdminShellFunctions properties file.
The help and quit commands are built into SimpleAdminShell because they require extra knowledge of the workings of the admin tool.
The methods in AdminFunction throw Exception rather than, say, AdminFunctionException because any exception is caught by the AdminShell implementation and, potentially, shown to the user. If AdminFunction methods caught and rethrew exceptions as AdminFunctionException it would just add unnecessary complexity to the stack trace seen by the user.
The admin tool uses multiple property files. At the time of this writing, they are:
Use the debug.adminTool target and attach your debugger to the port number stated in the output from the Ant task, typically 1044.
You have to specify the additional debugging parameters in the Java command line yourself, e.g:
java -Xdebug -Xrunjdwp:transport=dt_socket,address=<port>,server=y,suspend=y \ -jar build/lib/admin-tool.jar -alias <alias> -keypass <keypass>
You must attach your debugger to the port number that you specified in the address component of the runjdwp argument.