The following are general upgrade considerations and product changes for installing and configuring WebFOCUS:

• Upgrading the ReportCaster Interface.

  During an upgrade, the ApplicationPreferences.xml and SchedulePreferences.xml files in WebFOCUS77/config/caster are saved.

  When the upgrade finishes, the original preferences files are restored and the files created during the upgrade are renamed Application/SchedulePreferences_new.xml.

  To match the interface to a new installation, rename ApplicationPreferences.xml and SchedulePreferences.xml as ApplicationPreferences_old.xml and SchedulePreferences_old.xml.

  Then rename ApplicationPreferences_new.xml and SchedulePreferences_new.xml as ApplicationPreferences.xml and SchedulePreferences.xml.

  The interface should now look and behavior like a new installation.

• As of Version 7 Release 7.03, for security purposes, the Tomcat Manager, Host Manager, Docs, and Examples web applications are not included in the Tomcat installation by Developer Studio. If you need any of these web applications, you can download a full version of Tomcat from the Apache Tomcat website at http://tomcat.apache.org.
• As of Version 7 Release 7.03, the WebFOCUS CGI and ISAPI client is no longer distributed. The WebFOCUS CGI and ISAPI client from an earlier 7.7.x release or 7.6.x release is available and is supported with WebFOCUS 7.7.x.
• As of Version 7 Release 7.02, the webfocus77/template directory has been removed. Template files are located in the /webfocus77/ibi_html/template directory.
• As of Version 7 Release 7.02, if you have changed the default olap skins, you must go to the Admininstration Console after a service pack upgrade and reselect your customized settings. The service pack upgrade will not retain your changes.

  You can change the Skin Name and the Skin Text Color from the WebFOCUS Administration Console by selecting Client Settings, OLAP, and then Olap Skins.

• As of Version 7 Release 7, on Windows, if you uninstall WebFOCUS, the entire WebFOCUS directory will be uninstalled. This means that any non-standard WebFOCUS files will be removed. For example, if you have backed up files under the WebFOCUS directory, you should move them before running an uninstall. Otherwise, they will be deleted. This includes the basedir file and all files under the WebFOCUS directory.

• Before running a Service Pack upgrade, be sure to stop the WebFOCUS application server or the WebFOCUS Web applications running on the application server.
• If you run a full installation or a service pack upgrade, you must clear the cache in your application server after the installation is complete. 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, \ibi_help), which are located under the tomcat\work directory. For example:

  \ibi\tomcat\work\Catalina\localhost

• As of WebFOCUS Version 7 Release 7, the WebFOCUS CGI and ISAPI client communication for WebFOCUS Self-Service applications is functionally stabilized. Applications using the CGI or ISAPI client are still supported but should be converted to use the WebFOCUS Servlet.

  View this advisory online at http://techsupport.informationbuilders.com/tech/wbf/wbf_rln_77_rcaster.html

• As of Version 7 Release 7, the WebFOCUS and ReportCaster Web applications have been combined into one Web application. In prior releases, the two applications were deployed separately with unique context roots whose default values were ibi_apps and rcaster. In WebFOCUS 7.7, there is only one context root for WebFOCUS and ReportCaster, with a default value of ibi_apps.

  Applications that use cgipath.js to obtain the value of the ReportCaster specific context root will not be affected by this change. Applications that contain a hard-coded reference to rcaster or a ReportCaster specific context root will be affected.

  If you have developed applications with URLs that contain rcaster or a custom ReportCaster context root value specified during the WebFOCUS Client and ReportCaster installation, then see the following advisory for options to accommodate this change:

  http://techsupport.informationbuilders.com/tech/wbf/wbf_rln_77_rcaster.html

• As of Version 7 Release 7, when installing WebFOCUS with a license key that includes Managed Reporting and ReportCaster, Trusted MR Sign-On is enabled by default.

  When you install the Distribution Server separately (that is, at a later time or on a different machine than the WebFOCUS installation), the installation process enables Trusted MR Sign-On, but does not populate the Trusted key value in the ReportCaster configuration file. In this case, the Distribution Server will start in console mode and an appropriate message is provided in the Scheduler log file.

  After installing the Distribution Server, you must set the Trusted key value, as follows:

  1. Start the Distribution Server and Application Server.
  2. Log on to the WebFOCUS Administration Console.
  3. In the left pane, expand ReportCaster and select Configuration.

     A message appears at the top of the Configuration pane, stating that the Trusted key is blank, as shown in the following image.

     

  4. Click Save. The Trusted key value is now set.