Verifying App Studio

In this section:

App Studio connects to a WebFOCUS environment in order to create and process requests.

Web and/or Application Server Verification

How to:

If Tomcat is configured for you, you should restart it to ensure all settings are correct. If you are using Tomcat with IIS, you should restart IIS as well.

Procedure: How to Start Apache Tomcat or Microsoft IIS

  1. Open the Services window by opening the Control Panel, Administrative Tools, and then Services.
  2. Right-click Apache Tomcat and/or IIS Admin Service and choose Start, Stop, or Restart. For IIS, also make sure the World Wide Web Publishing Service is started.

    Note:

    • If you install Tomcat with App Studio, the Tomcat service starts automatically with Windows. If you want to change this behavior, right-click Apache Tomcat in the Services window, choose Properties, and change the Startup type to Manual. However, be sure to start Tomcat before starting App Studio.
    • A WebFOCUS 81 Server for App Studio service appears in the Services windows. However, you should not start this server from here. This WebFOCUS Reporting Server cannot run as a service.

Procedure: How to Verify the Web Server

After starting or restarting your web server, confirm that it is running by accessing it through a browser.

  • For IIS, go to the following page in your browser:
    http://localhost
  • For Tomcat, go to the following page in your browser:
    http://localhost:8080

    When using Tomcat standalone, use port 8080 when accessing Tomcat in a web browser or through App Studio. When using Tomcat with IIS, you normally do not go through port 8080 when running App Studio, but you can go to this port to ensure Tomcat is running and configure Tomcat.

    The Tomcat home page should appear. If it does not, Tomcat may still be loading. Wait a few minutes and try again.

 

Procedure: How to Verify the WebFOCUS Web Application Deployment

The WebFOCUS web application is installed with App Studio in:

drive:\ibi\AppStudio81\webapps\webfocus

and

drive:\ibi\AppStudio81\webapps\webfocus.war

If you chose the automatic configuration option, Tomcat is configured to access the expanded webapps\webfocus directory when it receives a request for

/ibi_apps

If you are using IIS with Tomcat, then IIS receives the request for /ibi_apps and passes that request to Tomcat.

You should test this by going to the default WebFOCUS Sign In page. If you are not using the default ports, substitute accordingly.

  • If you are using Tomcat either standalone or with IIS, go to the following URL:
    http://localhost:8080/ibi_apps/
  • If you are using IIS with Tomcat, go to the following URL:
    http://localhost/ibi_apps/

    The WebFOCUS Sign In page should display, by default. If you have previously signed in to WebFOCUS, the Business Intelligence Portal displays.

    A WebFOCUS Sign In page that fails to display is an indication that the web and/or application server may not be running, or the WebFOCUS environment is not configured properly.

App Studio Web Server Configuration Verification Tool

How to:

A verification tool is installed along with App Studio as part of the WebFOCUS Administration Console.

Procedure: How to Run the Verification Tool

  1. Ensure that Apache Tomcat and/or IIS are started.
  2. From the Windows Start menu, select All Programs, Information Builders, WebFOCUS 81 App Studio, WebFOCUS App Studio Utilities, and then click WebFOCUS Administration Console.

    If you are using Apache Tomcat standalone, you can also go to:

    http://localhost:8080/ibi_apps/console/webfocusconsole.jsp?verification

    For IIS with Tomcat, you can go to:

    http://localhost/ibi_apps/console/webfocusconsole.jsp?verification

    The WebFOCUS Sign In page opens, as shown in the following image.

    WebFOCUS Sign In page

    If the WebFOCUS Sign In page does not appear, ensure that your web server is started. If the web server is started and this page does not appear, you may need to manually configure the web server, as explained in Configuring the Web Server or Application Server.

  3. Sign in using an administrator user ID. The initial default user name and password is admin.

    The WebFOCUS Administration Console opens, as shown in the following image.

    WebFOCUS Administration Console

    Using this console, you can edit various configuration settings. Information about the various settings in this console can be found by clicking Help. The WebFOCUS Administration Console contains a verification tool to further test the configuration.

  4. On the left of the WebFOCUS Administration Console, expand Diagnostics and then Verification, as shown in the following image.
    Diagnostics menu
  5. Click WebFOCUS Client.

    A page similar to the following image appears on the right with a list of tests. The list varies depending on your license and configuration. For a Tomcat standalone configuration, the Web/App Server tests may not appear.

  6. Review the test results and troubleshoot accordingly.

Additional verification tools are discussed in Troubleshooting App Studio.

Note: The WebFOCUS Administration Console does not have its own authentication mechanism, and by default, none is used. If you wish to set authentication for the console, you can choose to do it through the WebFOCUS Reporting Server or the web server. For more information, see the WebFOCUS Security and Administration manual.


WebFOCUS