View source for Providing updated versions of the Debugger Client

__TOC__
<span class="f_Para">You can configure the Debugger to obtain updated builds of the Client from a central address, say, the URL of a local server. Then a Client menu item invokes a program </span><span class="term">(updateGet.exe)</span><span class="f_Para"> from which you download a new executable file </span><span class="term">(JanusDebugger.exe)</span><span class="f_Para"> to replace your existing Client. </span>

<span class="f_Para">This update maintenance feature assumes that each Client user has completed the initial Client installation, then uses this tool to refresh the executable as needed for fixes and enhancements. Currently, the Client does no checking of the version of the updated executable file, so you are responsible for determining when it is appropriate to download a new copy. </span>

<span class="f_Para">The updated executable file may be packaged in a zip file. If the file in the central URL has a .zip extension, the JanusDebugger.exe file is automatically extracted from it (an </span><span class="term">unzip.exe</span><span class="f_Para"> program is distributed). </span>

<span class="f_Para">To configure the feature: </span>

1.</span><span class="f_ListNum1">Determine the URL where you will store updated Client executable files and prepare the mechanism by which the files are to be served from this URL. </span>
: The updating program sends an HTTP GET call for the JanusDebugger.exe or .zip file to this URL. You must provide code at this URL to respond to the GET. 

2. <span class="f_ListNum1">In </span><span class="f_Para">the Debugger [[Customize debuggerConfig file|Client configuration file]] </span><span class="term">(debuggerConfig.xml)</span><span class="f_ListNum1">, insert an </span><span class="term">&lt;updateURL&gt;</span><span class="f_ListNum1"> element as a child of the </span><span class="term">&lt;debuggerConfig&gt; </span><span class="f_ListNum1">element.  </span>
: This element must contain the URL (which must ''not'' be for an SSL port) >at which you make available the updated Client executable file (and you may specify a .zip file). 
: When complete, your configuration file should have a structure like the following:

<p class="syntax"><span class="f_CodeExList">&lt;debuggerConfig version=&quot;1.0&quot;&gt;</span>
<span class="f_CodeExList">   &lt;serverList&gt;</span>
<span class="f_CodeExList">       .</span>
<span class="f_CodeExList">       .</span>
<span class="f_CodeExList">       .</span>
<span class="f_CodeExList">   &lt;/serverList&gt;</span>
<span class="f_CodeExList">   &lt;proxy&gt;</span>
<span class="f_CodeExList">       .</span>
<span class="f_CodeExList">       .</span>
<span class="f_CodeExList">       .</span>
<span class="f_CodeExList">   &lt;/proxy&gt;</span>
<span class="f_CodeExList">   &lt;updateURL&gt;http://rocketsoftware.com:3224/janusdebugger.exe&lt;/updateURL&gt;</span>
<span class="f_CodeExList">       .</span>
<span class="f_CodeExList">       .</span>
<span class="f_CodeExList">       .</span>
<span class="f_CodeExList">&lt;/debuggerConfig&gt; </span></p>

3. Check that the Debugger Client <var>Help</var><span class="f_ListNum1"> menu now contains the </span><var>Updates</var><span class="f_ListNum1"> option: </span>

[[File:updates1a_zoom60.gif|517x200px|updates1a]]<span class="f_ListContinue"> </span>

<span class="f_Para">To get an updated version of the Client: </span>

1.</span><span class="f_ListNum1">In the Client </span><var>Help</var><span class="f_ListNum1"> menu, click </span><var>Updates</var><span class="f_ListNum1">. </span>
: The <var>Debugger Client Update</var><span class="f_ListContinue"> dialog box (updateGet.exe program) is invoked, and it is passed the URL you specified in the </span><span class="term">&lt;updateURL&gt;</span><span class="f_ListContinue"> tag in </span><span class="term">debuggerConfig.xml:</span><span class="f_ListContinue"> </span>

[[File:updates2_zoom50.gif|513x213px|updates2]]<span class="f_ListContinue"> </span>

2. <span class="f_ListNum1">Close the Client; then press the </span><var>Get It</var><span class="f_ListNum1"> button. </span>
: The current JanusDebugger.exe is replaced with the new one. Closing the Client first avoids a file locking error. 
: You should see a confirmation message like the following: 

[[File:updates3_zoom50.gif|509x209px|updates3]]<span class="f_ListContinue"> </span>

[[Category:Debugger Home]]