Troubleshooting Guide

Table of contents

Microsoft Windows troubleshooting checklist

Did you receive a JVM error message when installing the local client or the Deployment Wizard on a Windows 95 machine?

If you attempt to install the local client or the Deployment Wizard on a Windows 95 machine, you may get an error message stating that you do not have a suitable JVM. This is because the 1.4 JRE is not supported on this platform. To avoid this, upgrade the operating system.

Configuring the Microsoft Proxy Server on Windows NT

This note discusses how to configure the Microsoft Proxy Server on Windows NT to work with Host On-Demand. Please note that this example is based on a system running Windows NT Server. This example has not been tested with Windows 2000 Server.

Installation

Follow these steps:

  1. Install the Web server, IIS, on your server machine if you have not already done so. You must install IIS before installing the Microsoft Proxy Server.
  2. Install and set up the Microsoft Proxy Server on your server machine.

Configuring Microsoft Proxy Server on your server machine
Follow these steps:
  1. Bring up the Properties panel for the Winsock Proxy computer.
    Here are the steps to follow to bring up the Properties panel:

    1. Click Start > Programs > Microsoft Proxy Server > Internet Service Manager.
    2. The following default services should be listed in the Internet Service Manager panel. Note that a default service will not be listed if the administrator has turned it off.
      • Socks Proxy
      • Winsock Proxy
      • Web Proxy
      • WWW
      • Gopher
      • FTP
    3. Click on the computer name in the Winsock Proxy line.
    4. Open the properties.
  2. Add a Protocol Definition for each special port required by Host On-Demand.
    Here are the steps to follow to create a protocol definition. Note that https (443) and telnet (23) are already defined.

    1. Click the Protocol tab.
    2. Click Add...
    3. Enter a descriptive name such as "HOD port 8999".
    4. Enter the port number required by HOD, such as 8999.
    5. Enter a connection type of TCP. All Protocol Definitions for HOD will have TCP as the connection type.
    6. Enter a direction of Outbound. All Protocol Definitions for HOD will have a direction of Outbound.

  3. Configure the users and machines that can access the ports that you have configured.
    Follow these steps:
    1. Click the Permissions tab.
    2. The settings here depend on how you, as the network administrator, use Windows in your own network environment. You should give all users access to port 8999 if you want them to be able to read configuration data from the Host On-Demand server.
Configuring the clients

The Proxy Server Client code must be installed on the workstations where you want to use the Host On-Demand client.

It is not enough to configure the Host On-Demand ports on the Proxy Server. Every client machine must have this code unless the client workstation is only used for web, port 80, traffic. This Proxy Client allows the workstation to use Telnet type programs, like Host On-Demand, with the Proxy Server. If this code is not installed on the client, Host On-Demand will not be able to get through the Proxy Server to the host machine.

The Microsoft Proxy Client software will show up on the client machine in two places: in Start > Programs and in Start > Settings > Control Panel > Add/Remove Programs. When troubleshooting, check these places to verify that this client code is installed.

From a command prompt on the client, type

net use * \\proxy_server_name\mspclnt
Run setup from this network share to install the proxy client.

For a Host On-Demand client to successfully connect to a host machine, the following TCP ports are needed:

Additional ports that you might want to configure are:

Only port 80 will work from the client machine through the Proxy Server without the Proxy client code installed. If the administrator does not have this code installed on the client, then the client will be able to download and install the Host On-Demand client, but will not be able to do the Host On-Demand logon. The Host On-Demand logon will fail with the LOG001 popup window.

Top of page Table of contents