In this section: How to: |
The following procedures describe how to install WebFOCUS Client.
Note: If you are running on a 32-bit machine, select the 32-bit installer. If you are running on a 64-bit machine, whether you intend to use 32-bit Java or 64-bit Java, you must use the 64-bit installer. There will be a selection option during the 64-bit installation if the installer detects a 32-bit Java on your machine. You can then choose to install either the 32-bit or 64-bit version.
How to: |
As of WebFOCUS Release 8.0 Version 01, the ibi_html alias has been removed from WebFOCUS packaging. If you are upgrading, this section describes how to configure your web and application server settings (for example, Apache Tomcat) if ibi_html references exist in your earlier applications as custom aliases.
<catalina_home>\conf\Catalina\localhost
where:
Is the root location where Apache Tomcat is installed.
On Windows platforms, Apache Tomcat is installed by the WebFOCUS Client installation.
For example:
<?xml version='1.0' encoding='utf-8'?> <Context docBase="C:\ibi\WebFOCUS81\webapps\ibi_html.war" path="/ibi_html"> </Context>
Note: Do not replace /ibi_html with your custom alias (for example, ibi_html8).
You can now use your ibi_html alias.
To configure ibi_html with installations where IIS is configured with the Tomcat Connector (plug-in):
/ibi_html/*=ajp13w
On the Tomcat server, a context is also needed for ibi_html. This needs to be configured to point to the ibi_html.war file located in the following directory:
install_drive:\ibi\WebFOCUS81\webapps
To configure other application servers (for example, Oracle WebLogic or IBM WebSphere) as a plug-in with the ibi_html alias:
This is similar to the configuration performed for the ibi_apps alias.
For example, if the custom alias being used is ibi_html8 then call it ibi_html8.
The Welcome to WebFOCUS 8.1 window opens, recommending that you quit all programs before continuing with the installation.
The License Agreement dialog box opens.
The License Code dialog box opens.
The Choose Install Set dialog box opens.
The Select Program Folder dialog box opens.
Note: You can specify any path on the local machine or use a Universal Naming Convention (UNC) path. The path must end in \ibi and cannot contain any spaces.
The Select Components to Install dialog box opens, as shown in the following image.
Note: If you specified a UNC path for the WebFOCUS application folder, then the ReportCaster Distribution Server must be installed separately. In the Select Components to install dialog box, the ReportCaster Distribution Server check box will be disabled. In the Advanced Configuration dialog box, you must provide the ReportCaster Distribution Server host and port values that correspond to the system where you are going to install the ReportCaster Distribution Server.
Note:
If the installer detects an existing Derby installation on the machine, the JDBC Path will be populated automatically. Otherwise, the JDBC Path text box will be blank, and the user will have to enter the full path to the jar files.
The Pre-Installation Summary window opens.
As WebFOCUS is being configured on your system, the Please Wait window is displayed.
After WebFOCUS is configured, the Installing WebFOCUS 8.1 dialog box opens. As WebFOCUS is being installed, the Installing WebFOCUS 8.1 dialog box informs you about the installation tasks that are being performed.
When the installation is complete, the Run Verification Utility dialog box appears.
The Install Complete window opens, listing the installation directory, as shown in the following image.
The Welcome to WebFOCUS 8.1 window opens, recommending that you quit all programs before continuing with the installation.
The License Agreement dialog box opens.
The License Code dialog box opens.
The Choose Install Set dialog box opens.
The Select Program Folder dialog box opens.
The Choose Destination Locations dialog box opens.
Note: You can specify any path on the local machine or use a Universal Naming Convention (UNC) path.
The Select Components to Install dialog box opens, as shown in the following image.
Note: If you specified a UNC path for the WebFOCUS application folder, then the ReportCaster Distribution Server must be installed separately. In the Select Components to install dialog box, the ReportCaster Distribution Server check box will be disabled. In the Advanced Configuration dialog box, you must provide the ReportCaster Distribution Server host and port values that correspond to the system where you are going to install the ReportCaster Distribution Server.
Notice that the Derby 10.9.1.0 option is not selected. In this case, a pre-existing database must be selected and configured.
Note: If want to use an existing WebFOCUS repository that already has tables defined, then uncheck the Create WebFOCUS Repository option. After the installation is completed, you must drop and recreate the existing tables in the repository.
If want to use a web or application server other than Apache Tomcat, then uncheck the Configure Apache Tomcat option. The Configure WebFOCUS Client area will appear and you must enter the port number that is currently used by your web server in the corresponding field.
The Database Configuration dialog box opens, as shown in the following image. In this example, Apache Derby is being configured, since it was the pre-existing database that was selected.
Note:
If the installer detects an existing Derby installation on the machine, the JDBC Path will be populated automatically. Otherwise, the JDBC Path text box will be blank, and the user will have to enter the full path to the jar files.
The Advanced Configuration dialog box opens, as shown in the following image.
The Pre-Installation Summary window opens.
As WebFOCUS is being configured on your system, the Please Wait window is displayed.
After WebFOCUS is configured, the Installing WebFOCUS 8.1 dialog box opens. As WebFOCUS is being installed, the Installing WebFOCUS 8.1 dialog box informs you about the installation tasks that are being performed.
When the installation is complete, the Run Verification Utility dialog box appears.
The Install Complete window opens, listing the installation directory, as shown in the following image.
installWebFOCUS81nn.exe -r drive:\fullpath\filename.properties
Note:
installWebFOCUS81nn.exe -i silent -f drive:\fullpath\filename.properties
The upgrade installation installs WebFOCUS 8.1 over your existing 8.0 release. This will carry over all WebFOCUS data, including the licensing information, allowing you to skip some of the steps required in the typical install. Because the architecture of WebFOCUS Portals and Favorites has changed in 8.1, the upgrade also requires that Portals and Favorites be converted for use in the new architecture. You can allow the installer to perform this conversion during installation or run the conversion tools manually after the upgrade.
It is strongly recommended that you back up your WebFOCUS Repository before performing the upgrade.
Note: You cannot run WebFOCUS 8.0 and WebFOCUS 8.1 against the same Repository simultaneously. If you plan to maintain separate WebFOCUS 8.0 and WebFOCUS 8.1 installations, each WebFOCUS installation must run against a different Repository database.
The Welcome to WebFOCUS 8.1 window opens, recommending that you quit all programs before continuing with the installation.
The License Agreement dialog box opens.
Note: The conversion does not occur immediately. First, the installer upgrades the WebFOCUS software. Once the rest of the installation is complete, WebFOCUS will automatically convert Favorites and Portals to the 8.1 format.
If the database connection fails or the credentials are not valid, you will be offered several options:
The Install Complete dialog box opens, listing the installation directory.
If you are going to run the conversion utilities manually, proceed to Converting WebFOCUS Portals and Favorites When Upgrading.
The upgrade installs WebFOCUS Release 8.1 Version 05 over your existing WebFOCUS installation. This will carry over all WebFOCUS data, including the licensing information, allowing you to skip some of the steps required in the typical install. The upgrade also requires that Favorites be converted for use in the new architecture. You run the Favorites conversion tool after the installation is complete.
It is strongly recommended that you back up your WebFOCUS Repository before performing the upgrade.
The Welcome to WebFOCUS 8.1 window opens, recommending that you quit all programs before continuing with the installation.
The License Agreement dialog box opens.
When the installation is finished, the Install Complete dialog box opens, listing the installation directory.
After installation, if you encounter any issues, check the installation logs located in the following directories:
C:\Documents and Settings\userprofile\WebFOCUS81_inst_date_######.log
C:\Documents and Settings\userprofile\ WebFOCUS81_Install_inst_date_######.log
These are the main trace files for the installation. The names are generated with a date and random number, where userprofile is the user ID logged on during the installation.
Note: If you are using Windows 7 or Windows 2008, these installation logs are located in the following directories:
C:\Users\userprofile\WebFOCUS81_inst_date_######.log
C:\Users\userprofile\WebFOCUS81_Install_inst_date_######.log
If the server cannot find the Java VM, the JSCOM Listener will not be able to start and the messages will be written to the server log file (edaprint.log), stating that the Java VM cannot be found. To resolve this issue, specify the location of the Java VM in JDK_HOME or IBI_JNIPATH. For more information, see the Server Installation WebFOCUS Reporting Server DataMigrator Server manual.
WebFOCUS |