Required?: NO
Authenticated Request?: YES
Request Arguments: Generic Proxy Tool Request Arguments, regpass, tcprofileurl
Sample Implementation: ReRegisterAction.java
Action on Failure return: Error message displayed to user and proxy tool left in unavailable state.
Action on Communications error: Same as failure (Error logged to file).
Action when proxy tool not available: Event sent.

If specified, the Blackboard Learn System Administrator has a reregister option associated with the tool. When chosen, a simple XML response request is sent to this method. Before calling this URL, the tool is put into an allowreregistration
state on the Blackboard Learn server. This allows a one-time re-registration of the tool
without having to clear the password; the registerTool operation is not permitted if the password is set for the tool.

If the tcprofileurl is specified then it can be used to load the current version of the Tool Consumer Profile and update the local configuration as required before calling the registerTool operation.

The servlet has to re-call ContextWS.registerTool and then return a success result (or failure of course - if the registerTool fails).

There is no automatic way to let the Blackboard Learn System Administrator know there is a new version of the proxy tool server. The current mechanisms for this notification include: Internal: If the Blackboard Learn System Administrator also manages the proxy tool server then they can tell themselves that they updated it. Include this step in the Proxy Tool Server installation documentation to remind them. Email/Regular Mail: If you are hosting a shared proxy tool server then notify all your subscribers that they must hit the reregister button via some notification mechanism of your own. Consider backwards-compatability when upgrading the server. Never assume everyone will hit the reregister at the same point in time when you upgrade your server.