In this section: |
This section explains how to set up IBM WebSphere Application Server for use with WebFOCUS and ReportCaster. It is assumed that WebSphere components are installed and configured. For additional information, see the WebSphere documentation. In WebFOCUS 8.0, you can easily use WebSphere Application Server without the external IBM HTTP Server by deploying the approot.war file.
How to: |
As of WebFOCUS Version 8, Java Version 1.6 is required on the system that is hosting the application server where the WebFOCUS Reporting Server and ReportCaster Distribution Server are deployed.
The default Java version for IBM WebSphere 8 is Version 1.6. If your Java version is lower, then you must set it to Version 1.6, as explained in the following section.
The Custom Properties page opens.
com.ibm.ws.jsp.jdksourcelevel
16
The WebSphere Integrated Solutions Console opens.
Node=xxxxx,Server=xxxxx
where:
Is the name of your application server instance.
The Create a new JDBC Provider wizard opens, as shown in the following image.
For more information on configuring JDBC providers, see your IBM WebSphere Application Server documentation.
How to: |
You must assign read, write, and execute authorities to new files created by the Java programs. This will define Public access to files created by the Java programs.
Name |
Value |
---|---|
os400.dir.create.auth |
RWX |
os400.file.create.auth |
RWX |
How to: |
Before deploying WebFOCUS web applications, you should configure WebSphere for WebFOCUS graphs and for the ReportCaster Repository.
To generate graphs, WebFOCUS Servlets either need access to an X Windows Server (through the DISPLAY variable), or they can use the Java VM headless option.
DISPLAY. If an X Windows Server is available, you should set a DISPLAY environment variable.
DISPLAY hostname:n.0
XAUTHORITY /pathname/.Xauthority
where:
Is the display number of the X Server.
Is the location of the X Server .Xauthority file.
Note: Graphs are not actually displayed on the machine you set to DISPLAY, but WebFOCUS must access this X Server to generate graphs. For additional information on configuring and starting an X Server, see Verifying and Troubleshooting Server Side Graphics (PCHOLD).
Headless. If an X Windows Server is not available, you can set the headless Java option using the WebSphere Administrative Console. However, be aware that headless does not support GIF files or the older WebFOCUS GRAPH32 engine.
The CLASSPATH variable must include the JDBC driver of your repository. You can set CLASSPATH using the WebSphere Administrative Console.
The Java Virtual Machine page opens.
For DB2:
/QIBM/ProdData/HTTP/Public/jt400/lib/jt400.jar
For Apache Derby:
/home/custom/ibi/derby/derbyclient.jar
Note: Your driver locations may differ. For additional information, consult the documentation for your database repository.
How to: |
Use the WebSphere Administrative Console, to deploy (install) the WebFOCUS web application. Repeat this procedure for each web application you need to deploy.
The web applications are located in the following directory:
/install_directory/ibi/WebFOCUS80/webapps
Web Application | Purpose |
---|---|
webfocus.war | Always deploy this web application. |
ibi_help.war | Always deploy this web application. |
approot.war | Deploy this web application if you are using an application server only configuration. |
You can use the default WebSphere instance or create a new instance using the WebSphere Administrative Console. See your IBM documentation if you wish to create new instances or virtual hosts.
https://hostname:9060/admin
Note: If you want to deploy new instances of WebFOCUS but keep your old version, you must install WebFOCUS with different ports and new context roots.
/install_directory/ibi/WebFOCUS80/webapps/webfocus.war
/install_directory/ibi/WebFOCUS80/webapps/ibi_help.war
and
/install_directory/ibi/WebFOCUS80/webapps/approot.war
This process may take some time to complete.
The Preparing for the application installation page opens.
The Map modules to servers page opens.
Warning: It is critical that you select both the application server and the web server in the Clusters and Servers text area.
The Map virtual hosts for Web modules page opens.
If you created a new virtual host, select it from the drop-down menu, check the Select checkbox for your web module, then click Next.
The Map context roots for Web modules page opens.
Web Application |
Default Context Root |
---|---|
webfocus.war |
ibi_apps |
ibi_help.war |
ibi_help |
approot.war |
approot |
The summary page appears.
Information appears while the installation takes place.
webfocus_war
How to: |
After finishing the configuration, run test calls to verify operability.
http://hostname:port/ibi_apps/
where:
Are the host name and port of the web server. However, if you use an application server only configuration, then these are the host name and HTTP port of the application server. For Tomcat standalone configurations, the default port is 8080. If you require SSL, use https instead of http.
The WebFOCUS Sign In page opens, as shown in the following image.
The WebFOCUS Business Intelligence Portal Welcome page opens in your web browser. Your Welcome page may have different folders displayed.
The WebFOCUS Administration Console opens.
The following page opens, which lists your WebFOCUS Reporting Server instance if it is available.
If your WebFOCUS Reporting Server is running with Security enabled (ON), then you are prompted for WebFOCUS Reporting Server credentials, as shown in the following image.
If you receive an error, ensure that your WebFOCUS Reporting Server is running and that valid credentials are used.
The Run a Stored Procedure page opens, as shown in the following image.
A procedure is normally launched using the WebFOCUS Servlet and a sample report should display. You can also call the servlet directly to run a specific procedure, such as carinst.fex. For example:
http://host:port/ibi_apps/WFServlet?IBIF_ex=carinst
Be aware that you may need to increase your Java memory settings if you are using InfoAssist. For more information, see Java Memory Issues.
WebFOCUS |