WebFOCUS Client Upgrade Configuration

How to:

If you choose to upgrade your existing WebFOCUS Client and ReportCaster installation rather than performing a new installation, then there are two major steps that you must perform:

  1. Select the Update Existing Install option during the WebFOCUS and ReportCaster installation process, as described in the WebFOCUS and ReportCaster Installation and Configuration manual for your platform.
  2. Run the Upgrade Configuration utility, as described in this section.

Running this utility is essential to an upgrade because it upgrades the cgivars.wfs, install.cfg, and bid-config.xml files. In addition, it will merge the entries in the existing files with the new files that are installed by the upgrade.

Note: If any of these files were manually customized prior to running the WebFOCUS Client Upgrade, the changes are not retained and the customizations have to be performed again after the Upgrade Configuration is completed.
Top of page
x
Procedure: How to Run the WebFOCUS Client Upgrade Configuration

To run the Upgrade Configuration utility in the WebFOCUS Administration Console:

  1. Access the WebFOCUS Administration Console by entering the following URL in your Web browser: 
    http://hostname:port/ibi_apps/

    where:

    hostname:port

    Is the host name and HTTP port of the Web server or application server. For Tomcat standalone configurations, the default is hostname:8080. If you require SSL, use https instead of http.

    The WebFOCUS Welcome page opens.

  2. Click the WebFOCUS Administration Console link and log on using an administrator user ID.

    The WebFOCUS Administration Console opens, as shown in the following image. The Upgrade Configuration option appears when you have performed an upgrade and need to run the Upgrade Configuration utility.

  3. Click Upgrade Configuration.

    You are prompted to run the Upgrade Configuration utility, as shown in the following image.

  4. Click Upgrade Now.

    The upgrade configuration begins by verifying that the WebFOCUS configuration files are read and write accessible, as shown in the following image.

  5. After all of the tests have passed, click Continue.

    Note: If you encounter any failures, you can attempt to fix the problem and run the Upgrade Configuration utility again.

    The Upgrading Configuration information appears, as shown in the following image.

    Note: A parameter with an asterisk (*) next to it indicates that it is a new parameter that has been added in the cgivars.wfs file.

  6. Scroll to the bottom of the screen, as shown in the followng image, and click Save.

    This saves all of the changes that were made to the cgivars.wfs file. The following confirmation message window opens.

  7. Click OK to complete the upgrade.

    When you log back into the WebFOCUS Administration Console, the Upgrade Configuration option will no longer appear.

    Important: After the upgrade is complete, you must clear the cache in your application server. For example, if you are using Apache Tomcat, the cache can be cleared by manually deleting any subdirectories that correspond to the context roots that you deployed (for example, \ibi_apps, \ibi_html, and \rcaster), which are located in the following directory:

    \Apache Software Foundation\Tomcat\work\Catalina\localhost
WebFOCUS