In this section: How to: |
This following procedure provides the steps for installing the WebFOCUS Client on UNIX.
Note: Before beginning the installation, verify that all prerequisites are met. In particular, this installation requires knowledge of the Primary ReportCaster Distribution Server machine name and port number.
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.
To configure Apache Tomcat to use the ibi_html soft alias:
<tomcat_home>conf/Catalina/localhost
where:
Is the root location where Apache Tomcat is installed.
For example:
<?xml version='1.0' encoding='utf-8'?> <Context docBase="../ibi/WebFOCUS80/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.
This section describes how to install WebFOCUS Client on UNIX using the console installation mode. For demonstration purposes, a custom install is performed using an Oracle 11g database for the repository. The web and application server being used is Apache Tomcat 7.0.33, which is packaged with the installation.
Note: Before you run the WebFOCUS Client installation, set the ulimit on the user ID that is going to run the installation program as follows:
ulimit=8192
chmod 755 installWebFOCUS8010.bin
Note: The installer file must be accessible from this machine.
./installWebFOCUS8010.bin -i console
The Welcome to WebFOCUS 8.0 message displays, as shown in the following image.
The WebFOCUS License Agreement displays in sections.
The Choose Install Type prompt is displayed, as shown in the following image.
The License Code prompt is displayed, as shown in the following image.
The Choose Install Set prompt is displayed, as shown in the following image.
The Choose Destination Locations prompt is displayed, as shown in the following image.
Note: Do not include spaces in the path.
The Select Components to install prompt is displayed, as shown in the following image.
Note: Do not include spaces in the path.
Note: If you want to install the ReportCaster Distribution Server on different machine, Type N.
A list of supported databases is displayed that can be used to configure the WebFOCUS repository.
The database choices are:
The Advanced Configuration prompts display, as shown in the following image.
This prompt will appear for license keys with ReportCaster, and if we chose to install ReportCaster on this machine.
Tomcat Server Shutdown Port: (DEFAULT: 8009):
Tomcat AJP Port: (DEFAULT: 8005):
The Tomcat prompts will appear if we choose to install and configure Tomcat during installation.
The Pre-Installation Summary prompt for the Distribution Server, Reporting Server, Database, Tomcat, Context Roots and Alias, and Mail Host is displayed, as well as Disk Space information.
Note: If any of the Advanced Configuration parameters are incorrect, type BACK to reenter values for the settings.
The Installation Complete prompt is displayed once the installation has finished, as shown in the following image.
This section describes how to perform a typical install for the WebFOCUS Client on UNIX using the GUI installation mode.
To use the GUI installation, ensure that the installer has access to an X Windows Server (through the DISPLAY variable). If an X Windows Server is available, you must set a DISPLAY environment variable before you start the installer. For example:
DISPLAY=xserver_host:0.0
export DISPLAY
TERM=xterm
export TERM
where:
Is the host name or IP Address of a machine that is running an X Server.
The Welcome to the WebFOCUS installation program window opens, as shown in the following image.
After the WebFOCUS installation initializes, the Welcome to WebFOCUS 8.0 window opens, recommending that you quit all programs before continuing with the installation.
The License Agreement dialog box opens, as shown in the following image.
The Choose Install Type dialog box opens, as shown in the following image.
The License Code dialog box opens, as shown in the following image.
The Choose Install Set dialog box opens, as shown in the following image.
The Choose Destination Locations dialog box opens, as shown in the following image.
Note: Do not include any spaces in the path. In addition, provide a path to a unique destination folder. If you provide a path to an existing directory, then the following error message is displayed:
The Select Components to install dialog box opens, as shown in the following image.
The Pre-Installation Summary dialog box opens, as shown in the following image.
As WebFOCUS is being configured on your system, the Please Wait window informs you about which configuration tasks are being performed.
After WebFOCUS is configured, the Installing WebFOCUS 8.0 window opens. As WebFOCUS is being installed, the Installing WebFOCUS 8.0 window informs you about which installation tasks are being performed.
After the installation is complete, the Install Complete window opens, as shown in the following image.
This section describes how to perform a custom install for the WebFOCUS Client on UNIX using the GUI installation mode.
To use the GUI installation, ensure that the installer has access to an X Windows Server (through the DISPLAY variable). If an X Windows Server is available, you must set a DISPLAY environment variable before you start the installer. For example:
DISPLAY=xserver_host:0.0
export DISPLAY
TERM=xterm
export TERM
where:
Is the host name or IP Address of a machine that is running an X Server.
The Welcome to the WebFOCUS installation program window opens, as shown in the following image.
After the WebFOCUS installation initializes, the Welcome to WebFOCUS 8.0 window opens, recommending that you quit all programs before continuing with the installation.
The License Agreement dialog box opens, as shown in the following image.
The Choose Install Type dialog box opens, as shown in the following image.
The License Code dialog box opens, as shown in the following image.
The Choose Install Set dialog box opens, as shown in the following image.
The Choose Destination Locations dialog box opens, as shown in the following image.
Note: Do not include any spaces in the path. In addition, provide a path to a unique destination folder. If you provide a path to an existing directory, then the following error message is displayed:
The Select Components to install dialog box opens, as shown in the following image.
Notice that the Derby 10.9.10 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 Apache Tomcat 7.0.33 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 Web Server Port 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:
The Advanced Configuration dialog box opens, as shown in the following image.
Note: The Web/App Server Ports area will appear only if you chose to install and configure Tomcat.
As WebFOCUS is being configured on your system, the Please Wait window informs you about which configuration tasks are being performed.
The Pre-Installation Summary dialog box opens, as shown in the following image.
As WebFOCUS is being configured on your system, the Please Wait window informs you about which configuration tasks are being performed.
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, the Install Complete window opens, as shown in the following image.
Note: The WebFOCUS Client must be installed before running the stand-alone ReportCaster Distribution Server installation.
To install a stand-alone ReportCaster Distribution Server on a separate machine from the WebFOCUS Client:
Note: The installer file (installWebFOCUS8010.bin) must be accessible from this machine.
./installWebFOCUS8010.bin -i console
The installation will provide a series of command-line prompts.
The WebFOCUS License Agreement displays in sections.
Note: Do not include spaces in the path.
The installer will display the message:
You have chosen to install ReportCaster Distribution Server only, WebFOCUS will not be installed
Select an existing database from the list of databases provided. Select the same database which the WebFOCUS Client will be using.
In the Database Configuration pane, provide the necessary information for the existing database.
The Advanced Configuration prompts display.
The configurations for the Distribution Server and Database are displayed.
Note: If any of the Advanced Configuration parameters are incorrect, type back to reenter values for the settings.
WebFOCUS |