Perform preliminary tasks - Revision history

Ekern at 17:12, 1 November 2022

2022-11-01T17:12:28Z

← Older revision		Revision as of 17:12, 1 November 2022
Line 14:		Line 14:
	* The port number of the Debugger Server </span>		* The port number of the Debugger Server </span>
	* For <var>Janus Debugger</var><span class="f_ListBul2"> sessions, the port number on that Online of the web server whose threads are to be debugged </span>		* For <var>Janus Debugger</var><span class="f_ListBul2"> sessions, the port number on that Online of the web server whose threads are to be debugged </span>
	* For <var>TN3270 Debugger</var><span class="f_ListBul2"> sessions, the name of the client socket [[~~define_clsock_port.html~~\|defined]] in the Online for the programs that are to be debugged </span>		* For <var>TN3270 Debugger</var><span class="f_ListBul2"> sessions, the name of the client socket [[Define and start a client socket port (TN3270 Debugger only)\|defined]] in the Online for the programs that are to be debugged </span>

	3. On this workstation, select a local TCP port number for the <span class="f_ListContinue">Debugger Client to listen on, if the </span><span class="f_ListNum1">default (8081) is not available. <span id="select_port_number" class="hmanchor"></span></span>		3. On this workstation, select a local TCP port number for the <span class="f_ListContinue">Debugger Client to listen on, if the </span><span class="f_ListNum1">default (8081) is not available. <span id="select_port_number" class="hmanchor"></span></span>

Ekern at 17:04, 1 November 2022

2022-11-01T17:04:01Z

← Older revision		Revision as of 17:04, 1 November 2022
Line 6:		Line 6:
	: If <span class="f_ListBul2">.NET 3.5 is </span><span class="f_ListContinue2">not on your machine at the time of Client installation, the installer program will </span>'''not'''<span class="f_ListContinue2"> complete, and it will inform you to download and install the Framework. </span><span class="f_ListContinue3">Which is available from the Microsoft website. </span>		: If <span class="f_ListBul2">.NET 3.5 is </span><span class="f_ListContinue2">not on your machine at the time of Client installation, the installer program will </span>'''not'''<span class="f_ListContinue2"> complete, and it will inform you to download and install the Framework. </span><span class="f_ListContinue3">Which is available from the Microsoft website. </span>
	* For <var>Janus Debugger</var><span class="f_ListBul2"> sessions, your browser must support proxy servers. </span>		* For <var>Janus Debugger</var><span class="f_ListBul2"> sessions, your browser must support proxy servers. </span>
	: Most, if not all, current popular browsers have this support. Consult your browser's documentation or "properties" information. The <span class="f_ListNum1">[[~~configure_test_browser.html~~\|"Configure the web browser"]]</span><span class="f_ListContinue2"> section describes how to set up a proxy for several popular browsers. </span>		: Most, if not all, current popular browsers have this support. Consult your browser's documentation or "properties" information. The <span class="f_ListNum1">[[Configure web browser (Janus Debugger only)\|"Configure the web browser"]]</span><span class="f_ListContinue2"> section describes how to set up a proxy for several popular browsers. </span>
	* It is assumed you are accessing the Debugger Client locally, that is, from the machine on which the software is installed. Accessing the Debugger Client and its online Help file from another workstation may be problematic. Microsoft security may prevent you from accessing the Debugger compiled Help file from a networked location.</span>		* It is assumed you are accessing the Debugger Client locally, that is, from the machine on which the software is installed. Accessing the Debugger Client and its online Help file from another workstation may be problematic. Microsoft security may prevent you from accessing the Debugger compiled Help file from a networked location.</span>

Line 22:		Line 22:
	: If you are going to change this port number, have the new number ready when you [[Customize debuggerConfig file\|customize the debuggerConfig.xml file]], later. </span>		: If you are going to change this port number, have the new number ready when you [[Customize debuggerConfig file\|customize the debuggerConfig.xml file]], later. </span>

	4. <span id="port4pac" class="hmanchor"></span><span class="f_ListNum1">For IE and Chrome browsers: if you want to use the Client [[~~configure_test_browser.html~~#~~pacfile~~\|PAC file option]], where the Client acts </span><span class="f_Para">as a proxy server </span>''only''<span class="f_Para"> for requests for [[Customize debuggerConfig file#Basic configuration steps\|Client-configured]] hosts but for no other browser requests, you may want to find an additional port number on the Debugger host workstation or on another suitable machine that can service HTTP requests. </span>		4. <span id="port4pac" class="hmanchor"></span><span class="f_ListNum1">For IE and Chrome browsers: if you want to use the Client [[Configure web browser (Janus Debugger only)#Setting up an HTTP server for PAC files\|PAC file option]], where the Client acts </span><span class="f_Para">as a proxy server </span>''only''<span class="f_Para"> for requests for [[Customize debuggerConfig file#Basic configuration steps\|Client-configured]] hosts but for no other browser requests, you may want to find an additional port number on the Debugger host workstation or on another suitable machine that can service HTTP requests. </span>

	5. For <var>TN3270 Debugger</var><span class="f_ListNum1"> sessions, determine the host identification of the workstation where the Debugger Client will run. <span id="workstation_hostid" class="hmanchor"></span> </span>		5. For <var>TN3270 Debugger</var><span class="f_ListNum1"> sessions, determine the host identification of the workstation where the Debugger Client will run. <span id="workstation_hostid" class="hmanchor"></span> </span>
	: This may be either an IP number or DNS name. Two ways to obtain the IP number are: </span>		: This may be either an IP number or DNS name. Two ways to obtain the IP number are: </span>

	* Select the </span><var>Audit Trail</var><span class="f_ListBul2"> tab in the Client main window, and click the </span><var>Top</var><span class="f_ListBul2"> button. Approximately the fourth line from the top displays the </span><~~span class="f_Monospace"~~>Local IP address</~~span~~><span class="f_ListBul2"> of the Client workstation.</span>		* Select the </span><var>Audit Trail</var><span class="f_ListBul2"> tab in the Client main window, and click the </span><var>Top</var><span class="f_ListBul2"> button. Approximately the fourth line from the top displays the </span><var>Local IP address</var><span class="f_ListBul2"> of the Client workstation.</span>
	* Open an MS DOS box, and issue the </span><span class="~~f_Monospace~~">IPCONFIG</span><span class="f_ListBul2"> command. You will see output similar to this: </span>		* Open an MS DOS box, and issue the </span><span class="term">IPCONFIG</span><span class="f_ListBul2"> command. You will see output similar to this: </span>

	<p class="syntax"><span class="f_CodeExList2">Ethernet adapter .... </span><br />		<p class="syntax"><span class="f_CodeExList2">Ethernet adapter .... </span><br />

Ekern: Created page with "TOC 1. Make sure your workstation environment is adequate for the Debugger Client: * The operating system must be Windows 7 or higher. * The target drive of the workstatio..."

2022-11-01T16:56:15Z

Created page with "__TOC__ 1. Make sure your workstation environment is adequate for the Debugger Client: * The operating system must be Windows 7 or higher. * The target drive of the workstatio..."

New page

__TOC__
1. Make sure your workstation environment is adequate for the Debugger Client:
* The operating system must be Windows 7 or higher.
* The target drive of the workstation must have at least fifteen megabytes of free disk space.
* The Microsoft .NET Framework (3.5 SP1) must be installed on your machine. Version 3.5 is included with Windows 7.
: If .NET 3.5 is not on your machine at the time of Client installation, the installer program will '''not''' complete, and it will inform you to download and install the Framework. Which is available from the Microsoft website. 
* For <var>Janus Debugger</var> sessions, your browser must support proxy servers. 
: Most, if not all, current popular browsers have this support. Consult your browser's documentation or "properties" information. The [[configure_test_browser.html|"Configure the web browser"]] section describes how to set up a proxy for several popular browsers. 
* It is assumed you are accessing the Debugger Client locally, that is, from the machine on which the software is installed. Accessing the Debugger Client and its online Help file from another workstation may be problematic. Microsoft security may prevent you from accessing the Debugger compiled Help file from a networked location.

2. Obtain the following information from the system manager of the Online running the web or 3270/Batch2 threads that are to be debugged:
* Confirmation that the Debugger Server is running 
* The host name (or IP number) of the Online 
* The port number of the Debugger Server 
* For <var>Janus Debugger</var> sessions, the port number on that Online of the web server whose threads are to be debugged 
* For <var>TN3270 Debugger</var> sessions, the name of the client socket [[define_clsock_port.html|defined]] in the Online for the programs that are to be debugged 

3. On this workstation, select a local TCP port number for the Debugger Client to listen on, if the default (8081) is not available. 
: For <var>Janus Debugger</var> sessions, the Client acts as a proxy server between the local web browser and the Janus Web Server; it's "address" is ''localhost'':''port'', where ''localhost'' is the workstation machine's host name or IP address, and ''port'' is the listening port number. For <var>TN3270 Debugger</var> sessions, the workstation port is for communication between the Debugger Client and <var>Model 204</var> Online. 
: If you are already using port 8081 for something else, or if you cannot use 8081 for some other reason, you must select a new port number. Port numbers in the 8000 range are often used for proxies, but any unused port number is acceptable. 
: For information about the TCP ports that are currently active on your workstation, you can issue the NETSTAT command from an MS DOS command box on your machine. 
: If you are going to change this port number, have the new number ready when you [[Customize debuggerConfig file|customize the debuggerConfig.xml file]], later. 

4. For IE and Chrome browsers: if you want to use the Client [[configure_test_browser.html#pacfile|PAC file option]], where the Client acts as a proxy server ''only'' for requests for [[Customize debuggerConfig file#Basic configuration steps|Client-configured]] hosts but for no other browser requests, you may want to find an additional port number on the Debugger host workstation or on another suitable machine that can service HTTP requests. 

5. For <var>TN3270 Debugger</var> sessions, determine the host identification of the workstation where the Debugger Client will run. 
: This may be either an IP number or DNS name. Two ways to obtain the IP number are: 

* Select the <var>Audit Trail</var> tab in the Client main window, and click the <var>Top</var> button. Approximately the fourth line from the top displays the Local IP address of the Client workstation.
* Open an MS DOS box, and issue the IPCONFIG command. You will see output similar to this: 

Ethernet adapter .... 
 Connection-specific DNS Suffix . : 
 IP Address. . . . . . . . . . . . : x.x.x.x <== you want this 
 Subnet Mask . . . . . . . . . . . : y.y.y.y 
 Default Gateway . . . . . . . . . : z.z.z.z 

[[Category:Debugger Home]]

Perform preliminary tasks - Revision history

Ekern at 17:12, 1 November 2022

Ekern at 17:04, 1 November 2022

Ekern: Created page with "__TOC__ 1. Make sure your workstation environment is adequate for the Debugger Client: * The operating system must be Windows 7 or higher. * The target drive of the workstatio..."

Ekern: Created page with "TOC 1. Make sure your workstation environment is adequate for the Debugger Client: * The operating system must be Windows 7 or higher. * The target drive of the workstatio..."