Troubleshooting tips for users

Note to Host On-Demand administrators: This troubleshooting checklist is intended for Host On-Demand clients who are having problems either starting or using Host On-Demand. We recommend customizing this checklist for your company environment and then passing it along directly to your clients or your support representatives.

Checklist

  1. Is the Host On-Demand window displaying as a gray, blank box?
  2. Are no icons appearing in the cached client?
  3. Are you receiving a message to work offline or try again?

  1. Is the Host On-Demand window displaying as a gray, blank box?
  2. When starting Host On-Demand, if only a gray box appears instead of the Host On-Demand window, try the following:

    1. Be sure that you say Yes when asked if you trust content from International Business Machines.
    2. Be sure that your browser is at a level supported by both Host On-Demand and your company.
    3. For Windows users, be sure that you have the appropriate Java Runtime Environment (JRE) installed on your PC. Host On-Demand ships a JRE for the client. See your administrator for details.
    4. For Windows users, be sure that you have set your JRE to allow Java applets to run.
    5. Be sure that you have downloaded all the latest service packs for your browser and operating system.
    6. If the problem is with a cached client, remove the cached client and then reinstall it. If you are not sure whether you are using the download or the cached client, call your support center.
    7. Completely uninstall Host On-Demand and reinstall the cached client.
    8. if neither of the previous steps correct the problem, enable the Java Console, and then attempt to start Host On-Demand again. Make a note of any Java exception messages in the Java Console and call your support center.

  3. Are no icons appearing in the cached client?
  4. This happens when the Host On-Demand configuration files on the local system have become corrupted or are missing. This can happen as a result of errors when installing the Host On-Demand cached client. It can also happen if you inadvertently deleted the session icon.

    To correct the problem, try the following:

    1. Close all browser windows.
    2. Locate the Windows Profile directory. This directory is usually found in the "C:\Documents and Settings\userid" directory, where userid is your user ID.
    3. Open the HODData folder in the Windows Profile directory. If necessary, use the Windows 'Search For Files or Folders' window to locate this directory.
    4. Within the HODData folder, locate the configuration folder that corresponds to the name of the Web page with the missing icon(s). If you do not know the name of the Web page, right click the background of the page and select Properties on the pop-up menu.
    5. Delete the Web page's configuration folder.
      Since uninstalling Host On-Demand removes your customized configuration settings such as keyboard remappings or macros, you should back up all the files in your HODData directory as well as any files in the C:\WINNT\java directory with a .cf file extension. Once you have reinstalled Host On-Demand, copy the saved files back to the appropriate directories.
    6. Restart Host On-Demand.
    7. If taking the previous steps do not correct the problem, try these steps:
      1. If the problem is with a cached client, remove the cached client and then reinstall it. If you are not sure whether you are using the download or the cached client, call your support center.
      2. Completely uninstall Host On-Demand and reinstall the cached client.
      3. if neither of the previous steps correct the problem, enable the Java Console, and then attempt to start Host On-Demand again. Make a note of any Java exception messages in the Java Console and call your support center.

  5. Are you receiving a message to work offline or try again?
  6. This problem is caused by an incorrect Internet Explorer option. Clicking 'Try Again' will allow Host On-Demand to work, provided 'Work Offline' was not previously clicked.

    If 'Work Offline' had been previously selected, it may be necessary to remove the cached client and reinstall it.

    To correct the problem, try the following:

    1. Open the Internet Options window.
    2. Select the Connections tab.
    3. Click the LAN Settings button.
    4. Check the 'Automatically detect settings' box.
    5. Click OK.
    6. Click OK again.
    7. Expand the File menu.
    8. If 'Work Offline' is checked, uncheck it.