Perform preliminary tasks

From m204wiki
Jump to navigation Jump to search

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 Janus Debugger 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 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 Janus Debugger sessions, the port number on that Online of the web server whose threads are to be debugged
  • For TN3270 Debugger sessions, the name of the client socket 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 Janus Debugger 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 TN3270 Debugger sessions, the workstation port is for communication between the Debugger Client and Model 204 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 the debuggerConfig.xml file, later.

4. For IE and Chrome browsers: if you want to use the Client PAC file option, where the Client acts as a proxy server only for requests for 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 TN3270 Debugger 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 Audit Trail tab in the Client main window, and click the Top 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