Installing WebFOCUS Client

Removal of the ibi_html WebFOCUS Alias

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.

Top of page

Procedure: How to Configure Apache Tomcat to Use the ibi_html Soft Alias

Stop Apache Tomcat.
Make a copy of the approot.xml file, which is located in the following directory
```
<tomcat_home>conf\Catalina\localhost
```
where:
<tomcat_home>

Is the root location where Apache Tomcat is installed.

On Windows platforms, Apache Tomcat is installed by the WebFOCUS Client installation.
Rename the copy of approot.xml to ibi_html.xml or according to your custom alias (for example, ibi_html8.xml).
Edit the ibi_html.xml file and change the value specified by the <Context docBase> element to the full path to the ibi_html.war file. In addition, change the path value from /approot to /ibi_html.
For example:
```
<?xml version='1.0' encoding='utf-8'?>
<Context docBase="C:\ibi\WebFOCUS80\webapps\ibi_html.war" path="/ibi_html">
</Context>
```
Note: Do not replace /ibi_html with your custom alias (for example, ibi_html8).
Start Apache Tomcat.
You can now use your ibi_html alias.

Top of page

Procedure: How to Configure ibi_html With Installations Where IIS Is Configured With the Tomcat Connector (Plug-In)

To configure ibi_html with installations where IIS is configured with the Tomcat Connector (plug-in):

The Tomcat plug-in needs to be installed and configured on the machine where the web server is installed, as described in Configuring IIS to Use the Tomcat Connector (Plug-In).
In order to route IIS requests to Tomcat, the uriworkermap.properties file needs to be updated to include the additional WebFOCUS context root for ibi_html:
```
/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_directory\ibi\WebFOCUS80\webapps\

Top of page

Procedure: How to Configure Oracle WebLogic or IBM WebSphere as a Plug-in With the ibi_html Alias

To configure other application servers (for example, Oracle WebLogic or IBM WebSphere) as a plug-in with the ibi_html alias:

Deploy the ibi_html.war file that is located in the \WebFOCUS80\webapps\ directory to the application server.
Create an ibi_html alias on your web server to be redirected to the application server ibi_html context root.
This is similar to the configuration performed for the ibi_apps alias.
Provide a name for this alias that matches your custom ibi_html alias.
For example, if the custom alias being used is ibi_html8 then call it ibi_html8.

Procedure: How to Install the Typical Version of WebFOCUS

Download the WebFOCUS Client installation file, as described in the WebFOCUS 8.0 download email for the WebFOCUS Client.
To start the WebFOCUS Client installation, double-click the installWebFOCUS8002.exe file.
The InstallAnywhere window opens, as shown in the following image.

After InstallAnywhere initializes, the following window opens.
Choose the appropriate language from the drop-down list and click OK.
The Welcome to WebFOCUS 80 window opens, recommending that you quit all programs before continuing with the installation, as shown in the following image.
Click Next to continue the installation.
The License Agreement dialog box opens, as shown in the following image.
Read the license agreement, select the radio button to accept the terms of the license agreement, and click Next to continue the installation.
The License Code dialog box opens, as shown in the following image.
Enter the License Code and Site Code that were delivered with your WebFOCUS software, and click Next to continue the installation.
The Choose Install Set dialog box opens, as shown in the following image.
Select Typical and click Next to continue the installation.
The Select Program Folder dialog box opens, as shown in the following image.
Click Next to accept the default Program Folder, WebFOCUS 80.
The Choose Destination Locations dialog box opens, as shown in the following image.
Perform the following steps:
1. Specify a path for the WebFOCUS application folder.
  Note: You can specify any path on the local machine or use a Universal Naming Convention (UNC) path.
2. Specify whether the system on which you are installing WebFOCUS uses a 32-bit or 64-bit Java configuration.
3. Choose the appropriate disk from the Disk Space Information drop-down list and click Next.
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.
On the Select Components to install dialog box:
1. Type the host name or IP address for your mail server.
2. Click Next to accept the default installation components.
The Database Configuration for Apache Derby dialog box opens, as shown in the following image.

Note:
- The Database Configuration for Apache Derby dialog box opens if you have an existing version of Derby installed on your system. In this case, the Derby 10.9.1.0 check box will be disabled in the Select Components to install dialog box. The Database Configuration for Apache Derby dialog box also opens if you uncheck the Derby 10.9.1.0 check box and select the option to use an existing Derby installation.
  If the installation 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.
- For security reasons, the DB Server Node is set to 127.0.0.1. If you are running on multiple environments and want to access this Derby from another location, change 127.0.0.1 to the machine name.
Click Next to continue the installation.
The Pre-Installation Summary window opens, as shown in the following image.
Verify that all of the information is correct and click Install to continue with the configuration and installation.
As WebFOCUS is being configured on your system, the Please Wait window is displayed.

After WebFOCUS is configured, the Installing WebFOCUS 80 window opens. As WebFOCUS is being installed, the Installing WebFOCUS 80 window informs you about which installation tasks are being performed.

After the installation is complete, you can run the Console Verification Utility or review the WebFOCUS Online Documentation, as shown in the following image.
Click Next to continue the installation.
The Install Complete window opens, confirming that the installation is complete.
Click Done to exit the installation.

Procedure: How to Install the Custom Version of WebFOCUS

Download the WebFOCUS 8 installation file, as described in the WebFOCUS 8 download email for the WebFOCUS Client.
To start the WebFOCUS Client installation, double-click the installWebFOCUS8002.exe file.
The InstallAnywhere window opens, as shown in the following image.

After InstallAnywhere initializes, the following window opens.
Choose the appropriate language from the drop-down list and click OK.
The Welcome to WebFOCUS 80 window opens, recommending that you quit all programs before continuing with the installation, as shown in the following image.
Click Next to continue the installation.
The License Agreement dialog box opens, as shown in the following image.
Read the license agreement, select the radio button to accept the terms of the license agreement, and click Next to continue the installation.
The License Code dialog box opens, as shown in the following image.
Enter the License Code and Site Code that were delivered with your WebFOCUS software and click Next to continue the installation.
The Choose Install Set dialog box opens, as shown in the following image.
Select Custom and click Next to continue the installation.
The Select Program Folder dialog box opens, as shown in the following image.
Accept the default program folder (WebFOCUS 80) or specify a different program folder name. Then, click Next.
The Choose Destination Locations dialog box opens, as shown in the following image.
Perform the following steps:
1. Specify a path for the WebFOCUS application folder. The default is c:\ibi.
  Note: You can specify any path on the local machine or use a Universal Naming Convention (UNC) path.
2. Specify whether the system on which you are installing WebFOCUS uses a 32-bit or 64-bit Java configuration.
3. Choose the appropriate disk from the Disk Space Information drop-down list and click Next.
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.
Perform the following steps:
1. In the WebFOCUS component area, type the host name or IP address for your mail server in the Mail Server Host Name field.
  Notice that the Derby 10.9.1.0 option is not selected. In this case, a pre-existing database must be selected and configured.
2. Type a path where WebFOCUS applications will be saved in the Choose Applications Path field or accept the default location (C:\ibi\apps).
3. Select an existing database (for example, Apache Derby) from the Configure pre-existing Database drop-down list.
  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.
4. Click Next to accept the remaining default installation components and configuration settings.
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:
- The Database Configuration for Apache Derby dialog box opens if you have an existing version of Derby installed on your system. In this case, the Derby 10.9.1.0 check box will be disabled in the Select Components to install dialog box. The Database Configuration for Apache Derby dialog box also opens if you uncheck the Derby 10.9.1.0 check box and select the option to use an existing Derby installation.
  If the installation 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.
- For security reasons, the DB Server Node is set to 127.0.0.1. If you are running on multiple environments and want to access this Derby from another location, change 127.0.0.1 to the machine name.
Click Next.
The Advanced Configuration dialog box opens, as shown in the following image.
Perform the following steps:
1. In the WebFOCUS Application Context field, type a context root or accept the default (ibi_apps).
2. In the WebFOCUS Help Context field, type a help context root or accept the default (ibi_help).
3. In the WebFOCUS Reporting Server Host field, type a host name or accept the default. The default WebFOCUS Reporting Server host is the name of the machine where WebFOCUS is being installed.
4. In the WebFOCUS Reporting Server Port field, type a server port or accept the default (8120).
5. In the Distribution Server Host field, type a host name. The default Distribution Server host is the name of the machine where WebFOCUS is being installed.
6. In the Distribution Server Port field, type a server port or accept the default (8200).
7. In the Web/App Server Ports area, specify the port values that are being used by your application server.
Click Next to continue the installation.
The Pre-Installation Summary window opens, as shown in the following image.
Verify that all of the information is correct, and click Install to continue with the configuration and installation.
As WebFOCUS is being configured on your system, the Please Wait window is displayed.

After WebFOCUS is configured, the Installing WebFOCUS 80 window opens. As WebFOCUS is being installed, the Installing WebFOCUS 80 window informs you about which installation tasks are being performed.

After the installation is complete, you can run the Configuration Utility or review the WebFOCUS Online Documentation, as shown in the following image.
Click Next to continue the installation.
The Install Complete window opens, confirming that the installation is complete.
Click Done to exit the installation.

Procedure: How to Install WebFOCUS Client Using the Silent Install

To generate the silent install properties file from the command prompt, navigate to the directory where the installWebFOCUS80nn.exe file resides.
Enter the following command:
```
installWebFOCUS80nn.exe -r drive:\fullpath\filename.properties
```
Note:
- Replace nn with the specific WebFOCUS 80 release, for example, installWebFOCUS8002.exe
- Always generate the properties file before performing the silent install to ensure that the properties are correct.
- The properties file has the extension *.properties.
- You need to specify the full path to where the properties file will be created.
To install in silent mode, navigate to the directory where the installWebFOCUS80nn.exe file resides and enter the following command:
```
installWebFOCUS80nn.exe -i silent -f drive:\fullpath\filename.properties
```

Troubleshooting the Installation

After installation, if you encounter any issues, check the installation logs located in the following directories:

C:\Documents and Settings\userprofile\WebFOCUS80_inst_date_######.log

C:\Documents and Settings\userprofile\WebFOCUS80_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\WebFOCUS80_inst_date_######.log

C:\Users\userprofile\WebFOCUS80_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.