In this section: |
A single installation program is provided to install the WebFOCUS Client and ReportCaster.
How to: |
As of WebFOCUS Version 8.0.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.
<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.
Review the following requirements before installing the WebFOCUS Client and ReportCaster.
How to: |
This section describes how to install the WebFOCUS Client on IBM i using the console installation mode. For demonstration purposes, the first procedure describes the steps for a typical install. In this typical install, a DB2 database is used for the WebFOCUS repository. The web and application server being used is Apache Tomcat Version 7.0.19, which is packaged with the installation. The second procedure describes the steps for a custom install.
Note: When entering values, use full values and names. Do not use shorthand, aliases or environment variables.
Tip: At anytime during the install, you may type QUIT to exit, or BACK to return to the previous section.
In a typical install, the following default values are used and you are not prompted to enter new values:
If you are required to use different values, you must run a custom WebFOCUS installation.
qsh
chmod 755 installWebFOCUS8001.jar
export JAVA_HOME=/QOpenSys/QIBM/ProdData/JavaVM/jdk626/32bit
Note: In many cases, this may be set in your system or user profile. You may verify the Java version by entering java -version at the qsh prompt.
java -jar installWebFOCUS8001.jar -i console
Tip: If you would like to record the installation values for future playback, add the following to the end of the above command:
-r /home/username/propertyfilename.properties
To later run the install using this silent properties file, use:
java -jar installWebFOCUS8001.jar -i silent -f /path/propertyfilename.properties
The Welcome to WebFOCUS 80 message displays.
The WebFOCUS License Agreement displays over several screens. Press Enter after reading each page of the license agreement. Press PageUp and PageDown to review the contents of each page.
The Choose Install Type prompt displays.
The License Code prompt displays.
The Choose Install Set prompt displays.
The Choose Destination Locations prompt displays.
If you accept the default value, press Enter. Otherwise, enter a specific path according to your requirements.
Note: The path must include the string /ibi/WebFOCUS80. Spaces are not allowed in any destination folder. If this string is not found in the path entered, the installation program will append it to the end of the entered value. You may enter trailing values after the /ibi/WebFOCUS80 string (for example, /ibi/WebFOCUS80test).
When prompted for a directory or device, type the full path name. Do not use environment variables such as $HOME, or shorthand such as pwd.
The Select Components to install prompt displays.
The WebFOCUS applications destination folder prompt displays.
A series of prompts for additional components are displayed.
Tip: Java 1.6 or higher is required to install Apache Tomcat. If the Java version detected is less than 1.6, the installation program will not prompt to install Apache Tomcat.
Note: This database library should have been created or confirmed, as described in WebFOCUS and ReportCaster Installation Requirements.
The Database Configuration for DB2 prompt displays.
If your DB2 library is on the local machine, you may enter localhost.
Note: The WebFOCUS repository can exist on a remote machine.
Note: DB2 connectivity on IBM i does not require a port number.
Note: This value will not be displayed on the screen.
Note: For this typical install, the IBM® Toolbox for Java JDBC driver is being used.
/QIBM/ProdData/HTTP/Public/jt400/lib/jt400.jar
Note: Your file may be found in a different folder. Your system administrator can confirm its location.
A pre-installation summary is displayed. You can type BACK to reenter values or type QUIT to exit the installation.
While the installation files are being copied and configured, a progress indicator is displayed and updated on the screen.
==========================================================Installing... ------------- [==================|==================|==================|=========== [------------------|------------------|-----------
After all of the files have been copied and configured, the installation program will attempt to start the services that were installed. This may include the Apache Tomcat application server and the WebFOCUS Distribution Server. The installation program will attempt to start each service for two minutes and status messages are displayed as attempts are being made.
In the following example, the HTTP port for Apache Tomcat (8080) was successfully started.
If any of the ports were not started, see Troubleshooting WebFOCUS and ReportCaster. One reason a service may not start is that the system may be experiencing some delays.
Installation Complete ---------------------------------------------------------------- Congratulations. WebFOCUS 80 has been successfully installed to: /home/ibi/webfocus PRESS <ENTER> TO EXIT THE INSTALLER:
The WebFOCUS install log is named:
WebFOCUS80_Install_mm_dd_yyyy_hh_mm_ss.log
The InstallAnywhere log file is named:
WebFOCUS80_yyyy_mm_yyThh_mm_ss_sss.log
These log files are placed in the home folder of the user ID that ran the installation program. You may need to refer to these files if there are any install issues.
This section describes how to install the WebFOCUS Client on IBM i using the custom prompts. During a custom installation, you can enter custom values for:
During this custom install, the WebFOCUS Client and Derby are installed. The WebFOCUS Distribution Server is installed on a different host machine. The application server will be an existing preconfigured IBM WebSphere instance.
Note: When entering values, use full values and names. Do not use shorthand, aliases or environment variables.
Tip: At anytime during the install, you may type QUIT to exit, or BACK to return to the previous section.
qsh
chmod 755 installWebFOCUS8001.jar
export JAVA_HOME=/QOpenSys/QIBM/ProdData/JavaVM/jdk626/32bit
Note: In many cases, this may be set in your system or user profile. You may verify the Java version by entering java -version at the qsh prompt.
java -jar installWebFOCUS8001.jar -i console
Tip: If you would like to record the installation values for future playback, add the following to the end of the above command:
-r /home/username/propertyfilename.properties
To later run the install using this silent properties file, use:
java -jar installWebFOCUS8001.jar -i silent -f /path/propertyfilename.properties
The Welcome to WebFOCUS 80 message displays.
The WebFOCUS License Agreement displays over several screens. Press Enter after reading each page of the license agreement. Press PageUp and PageDown to review the contents of each page.
The Choose Install Type prompt displays.
The License Code prompt displays.
The Choose Install Set prompt displays.
The Choose Destination Locations prompt displays.
If you accept the default value, press Enter. Otherwise, enter a new path.
Note: The path must include the string /ibi/WebFOCUS80. Spaces are not allowed in any destination folder. If this string is not found in the path entered, the installation program will append it to the end of the entered value. You may enter trailing values after the /ibi/WebFOCUS80 string (for example, /ibi/WebFOCUS80test).
When prompted for a directory or device, type the full path name. Do not use environment variables such as $HOME, or shorthand such as pwd.
The Select Components to install prompt displays.
The WebFOCUS applications destination folder prompt displays.
The default value will append /apps to the WebFOCUS destination entered in step 14.
A series of prompts for additional components are displayed.
Note: For demonstration purposes during this custom install, the Distribution Server will be installed on a remote host.
Note: For demonstration purposes during this custom install, an existing instance of IBM WebSphere Application Server will be used. For more information on configuring IBM WebSphere Application Server, see Configuring Web and Application Servers.
Tip: Java 1.6 or higher is required to install Apache Tomcat. If the Java version detected is less than 1.6, the installation program will not prompt to install Apache Tomcat.
The default value will append /Derby to your WebFOCUS destination entered in step 14.
The default value is webfocus.
Note: You will need to enter this value during the remote host installation of the Distribution Server.
The default value is webfocus.
Note: You will need to enter this value during the remote host installation of the Distribution Server.
Note: The following set of Advanced Configuration prompts appear only during custom installations.
Note: This prompt appears only when you are installing WebFOCUS.
For this custom install, we have chosen to install on a remote machine.
Note: You will need this value when installing the Distribution Server on the remote machine. This must match the database name entered during the remote installation.
Note: You will need this value when installing the Distribution Server on the remote machine. If the port number that you enter is active at install time, the installation program will prompt you to enter a different port number.
A pre-installation summary is displayed over several panels.
Use the PgUp and PgDn keys to review all of the values. If you want to change any values, type BACK. To exit the installation type QUIT. To proceed with the installation, press Enter.
While the installation files are being copied and configured, a progress indicator is displayed and updated on the screen.
==========================================================Installing... ------------- [==================|==================|==================|=========== [------------------|------------------|-----------
The installation program will attempt to start the Derby service for up to two minutes. Messages are displayed showing the status of the port.
Installation Complete ---------------------------------------------------------------- Congratulations. WebFOCUS 80 has been successfully installed to: /home/custom/ibi/WebFOCUS80 PRESS <ENTER> TO EXIT THE INSTALLER:
The WebFOCUS install log is named:
WebFOCUS80_Install_mm_dd_yyyy_hh_mm_ss.log
The InstallAnywhere log file is named:
WebFOCUS80_yyyy_mm_yyThh_mm_ss_sss.log
These log files are placed in the home folder of the user ID that ran the installation program. You may need to refer to these files if there are any install issues.
/home/custom/ibi/Derby
#derby.drda.host=0.0.0.0
/home/custom/ibi/Derby/bin
Wait for a message indicating that the service was stopped. For example:
$ Wed Sep 12 11:35:00 EDT 2012 : Apache Derby Network Server - 10.8.1.2 - (1095077) shutdown
Wait for a message indicating that the service was started. For example:
Wed Sep 12 11:56:52 EDT 2012 : Apache Derby Network Server - 10.8.1.2 - (1095077) started and ready to accept connections on port 6527
cd /home/custom/ibi/Derby/lib
This file contains necessary components to communicate with the Derby database. You will need to enter the location of this file during the installation of the Distribution Server on the remote machine.
CHGAUT OBJ('.../ibi/WebFOCUS80/config/resource_templates') USER(QEJBSVR) DTAAUT(*RWX) OBJAUT(*ALL) SUBTREE(*ALL)
where:
Is the full path to your WebFOCUS installation.
Note: If your IBM WebSphere Application Server runs under a user ID other than QEJBSVR, replace the USER value with the appropriate user name.
java -jar installWebFOCUS8001.jar -i console
The Welcome to WebFOCUS 80 message displays.
The WebFOCUS License Agreement displays over several screens. Press Enter after reading each page of the license agreement. Press PageUp and PageDown to review the contents of each page.
The Choose Install Type prompt displays.
The License Code prompt displays.
The Choose Install Set prompt displays.
The Choose Destination Locations prompt displays.
If you accept the default value, press Enter. Otherwise, enter a valid absolute path name.
Note: The path must include the string /ibi/WebFOCUS80. If this string is not found in the path entered, the installation program will append it to the end of the entered value. You may enter trailing values after the /ibi/WebFOCUS80 string (for example, /ibi/WebFOCUS80test).
When prompted for a directory or device, type the full path name. Do not use environment variables such as $HOME, or shorthand such as pwd.
The Select Components to install prompt displays.
The database selection prompt displays, as shown in the following image.
The Database Configuration pane for Apache Derby displays, as shown in the following image.
Note: This must match the value entered during the WebFOCUS component installation.
The DB Server Node prompt displays, as shown in the following image.
org.apache.derby.jdbc.ClientDriver
This file should have been copied from the WebFOCUS installation folders as described in step 40 of the custom installation of WebFOCUS.
Since the installation allows entry of more than one driver, enter a blank value to leave this prompt.
The Advanced Configuration pane displays, as shown in the following image.
Note: This must match the value entered during the WebFOCUS component installation.
Note: In order to start the Distribution Server, the Derby database must be started on the remote host. Additionally, all credentials entered must be correct.
A pre-installation summary is displayed over several panels.
Use the PgUp and PgDn keys to review all of the values. If you want to change any values, type BACK. To exit the installation type QUIT. To proceed with the installation, press Enter.
While the installation files are being copied and configured, a visual progress indicator is displayed and updated on the screen.
==========================================================Installing... ------------- [==================|==================|==================|=========== [------------------|------------------|-----------
After the installation is finished, the Installation Complete pane displays, as shown in the following image.
Two log files are created after the installation is finished. The WebFOCUS install log is named:
WebFOCUS80_Install_mm_dd_yyyy_hh_mm_ss.log
The InstallAnywhere log file is named:
WebFOCUS80_yyyy_mm_yyThh_mm_ss_sss.log
These log files are placed in the home folder of the user ID that ran the installation program. You may need to refer to these files if there are any install issues.
cd /home/custom/ibi/WebFOCUS80/ReportCaster/bin
Wait for a message, which indicates that the Distribution Server was started. For example:
$ Console ready Console is listening on port: 8215 Reader ready Dispatcher ready
For more information on configuring web and application servers, see Configuring Web and Application Servers. For more information on post-installation configuration and verification, see Post-Installation Verification and Configuration.
Most files created by the installation are placed in the directories you specify and are used for WebFOCUS operations or configuration. However, you should be aware of the following files created for debugging or upgrading purposes:
These appear in /installation_directory/ibi/WebFOCUS80/config. They display the parameters used for the installation. Editing these files normally has no effect on most operations, but do not delete them. If parameters are incorrect and you are unsure where they are set, uninstall and reinstall.
This appears in /installation_directory/ibi/WebFOCUS80/ReportCaster/log. This displays the parameters used for the installation. Editing this file has no effect on the operations but do not delete it.
Note: These files are only used when running a service pack upgrade. If you should update your database information after you installed WebFOCUS, you will need to manually update the install.cfg with the new repository information before you run a service pack update.
WebFOCUS |