Troubleshooting WebFOCUS Business User Edition

Topics:

This topic describes how to troubleshoot the WebFOCUS BUE installation.

Starting the Reporting Server Service

If you receive a message during the installation process related to failure to start the Reporting Server service, perform either of the following steps after the installation completes:

  • Start the WebFOCUS BUE 82 Reporting Server service from the Windows Services.

    or

  • Use the Start WebFOCUS_BUE Services program shortcut.

Starting WebFOCUS BUE

If you are unable to launch WebFOCUS BUE, ensure that all services are running. If they are not, do the following:

  • Stop all services.
  • Restart the services, and launch WebFOCUS BUE.

If this does not work, stop the services again. Before you restart the services, ensure that the Hyperstage processes, ibengine.exe and postgres.exe, are also stopped. Restart your machine if you are still unable to restart the services.

Port Assignment

By default, ports in the range of 26000 to 26040 are checked for availability. If the installation program detects that no ports in that range are available, it then increases the range by 10 and checks again for availability. For example, if ports 26000 to 26040 are unavailable, ports 26010 to 26050 are then checked.

Default Port Assignment.

  • Ports 26000 to 26003 are used by the application server.
  • Port 26010 is used by the repository server.
  • Ports 26020 to 26023 and port 26040 are used by the Reporting Server
  • Port 26030 is used by the Distribution Server.

WebFOCUS Business User Edition Log Files

WebFOCUS BUE creates a log file in the following location for Windows 7:

drive:\Users\user_id\WebFOCUS_BUE82_Install_date_time.log

where:

user_id

Is your Windows user ID.

date_time

Is the date and time the log file was created. This log file provides information about the WebFOCUS BUE installation. If you contact Customer Support Services with an installation problem, have this file available.

Troubleshooting the Uninstall Process

How to:

If you choose to uninstall WebFOCUS BUE, and the uninstall process fails, you can follow one of the procedures in this section to clean up your machine before reinstalling the product.

Before performing one of the following procedures, ensure that you have uninstalled WebFOCUS BUE.

Procedure: How to Manually Uninstall WebFOCUS Business User Edition Components Using the Cleanup Utility

If the WebFOCUS BUE uninstall process fails, you can run the idis_cleanup.bat file to clean a damaged installation on your machine.

  1. Navigate to the following location on your machine:
    drive:\ibi\WebFOCUS_BUE82\WebFOCUS\utilities\install\
  2. Copy the idis_cleanup.bat file from the install directory to a different directory (for example, drive:\ibi\).
  3. Right-click idis_cleanup.bat, and then click Run as administrator.
  4. When prompted, type the location of the install directory to proceed.

    Note: By default, the utility will back up the Reporting Server apps and the Derby database.

Procedure: How to Manually Uninstall WebFOCUS Business User Edition Components

If the WebFOCUS BUE uninstall process fails, you can do the following to manually cleanup the remaining WebFOCUS BUE components on your machine.

  1. Stop any running WebFOCUS BUE services on the system
  2. Remove any remaining services from your machine.
    1. Locate the existing WebFOCUS BUE services. To get the service name, right-click the service in the Windows Services program and click Properties. The Properties dialog box opens, where you can right-click the service name and click Copy, as shown in the following image.
    2. To remove a service, open the Command Prompt as an Administrator and issue the following command:
      sc delete "service name"  

      where:

      service name

      Is the name of the service you are manually deleting. For example:

      C:\sc delete "WfBUE82AppSrv"

      Note: The service name must be enclosed in double quotation marks.

      Repeat this for the remaining services.

  3. Open Task Manager and ensure that the process ibengine.exe is not running.
  4. Remove files from disk, except for the Reporting Server application folders.

    For example, if WebFOCUS BUE is installed on the C:\ drive, remove all folders under C:\ibi\WebFOCUS_BUE82\ except for the C:\ibi\WebFOCUS_BUE82\data\ folder.

  5. Click Start, point to All Programs, and expand the Information Builders folder.
  6. Right-click the WebFOCUS Business User Edition 82 folder and click Delete.
  7. Launch the Windows Registry Editor, and remove the following registry keys.
    • HKEY_LOCAL_MACHINE\SOFTWARE\WebFOCUS_BUE82
    • HKEY_LOCAL_MACHINE\SOFTWARE\Information Builders\Derby\WfBUE82DbSrv
    • HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Apache Software Foundation\Procrun 2.0\WfBUE82AppSrv
    • HKEY_LOCAL_MACHINE\SOFTWARE\Information Builders\WebFOCUS BUE 82 Reporting Server
    • HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Information Builders\ReportCaster\WfBUE82DistSrv

WebFOCUS

Feedback