WebFOCUS Reporting Server Verification and Configuration

In this section:

After installing the WebFOCUS Reporting Server, you should verify that it runs properly by starting the server and viewing the Web Console as explained below. You can then use the Web Console to configure adapters.

Top of page

Starting, Configuring, Testing, and Stopping the WebFOCUS Reporting Server

How to:


There are several security levels in which you can start the WebFOCUS Reporting Server. For a description of these levels, see Security and User IDs for WebFOCUS and ReportCaster.

Procedure: How to Start the WebFOCUS Reporting Server
  1. Log on with the ID you used to install the server. Initially, this is the only user ID that can start the server. Do not start the server as root.
  2. Change your current directory to the EDACONF/bin directory. The default location for this directory is the following:
  3. Specify which security level to use by typing one of the following:
    export EDAEXTSEC=PTH
    export EDAEXTSEC=OFF


    • The server can only start with security OPSYS if you change ownership and permissions for tscom300.out, as explained in How to Enable Security.
    • If you change ownership and permissions for tscom300.out, the server starts with security OPSYS by default. Otherwise, the server starts with security OFF by default.
    • When the server runs with security OPSYS, log files and directories are created that are not compatible when running with security OFF or PTH. You must clear out these files or the server cannot start with security OFF or PTH. Use the following to clear files:
      ./edastart -cleardir

  4. Start the WebFOCUS Reporting Server by typing the following command and pressing Enter:
    ./edastart -start

    The Workspace Manager starts. The following is an example of the message displayed:

    Starting Workspace Manager in /home/iadmin/ibi/srv81/wfs
    Logging startup progress and errors in 
  5. You can further verify that the server is running by typing the following:
    ./edastart -show

    For a list of options for the edastart command, type the following:

    ./edastart -?

Note: If you see an error related to JSCOM3, you can troubleshoot this in How to Verify or Enable the JSCOM3 Listener.

Procedure: How to View the Web Console and Test the Server

The Web Console, sometimes referred to as the Server Console, provides an interface for configuring, monitoring, and testing the WebFOCUS Reporting Server. To access the Web Console and test the server, do the following:

  1. Start the WebFOCUS Reporting Server if it is not started.
  2. Using Internet Explorer, go to the following URL:



    Is the host name or IP address of the machine running the WebFOCUS Reporting Server.


    Is the HTTP port you specified during the installation. The default is 8121. This is the port of the LST_HTTP node in /install_directory/ibi/srv81/wfs/etc/odin.cfg.

  3. If you are running with security OPSYS, log on using the user ID you used when installing the server.

    The Web Console home page displays.

  4. Expand any of the folders in the Application Directories tree, right-click a procedure or a metadata file, and then select an action from the menu.

Procedure: How to Administer the Server, Configure Adapters, Create Metadata, and Edit Licenses

The procedures and steps to administer the server, configure adapters, and create metadata (synonyms, Master Files, and Access Files) are accessible from the Web Console Help. They are also available in the Server Administration manual.

To access these instructions, do the following:

  1. Sign in to the Reporting Server Web Console.
  2. If you have a license for Active Technologies, you must provide the Active Technologies license code by clicking Workspace on the main menu. Right-click the Workspace folder in the navigation pane and select License from the drop-down menu. Enter your Active Technologies license in the license_active_report field.
  3. Optionally, add your site code to the server configuration by entering your site code in the site_code field.
  4. Click Save and Restart Server.
  5. On top of the Web Console, click Help and then Contents and Search.

    The Web Console Help appears.

  6. On the left of the Web Console Help, expand Server Administration.
  7. To configure adapters, on the left of the Web Console Help, expand Adapters.
  8. Click the name of your adapter and follow the steps that appear.

Procedure: How to Verify or Enable the JSCOM3 Listener

JSCOM3 is a listener installed with the WebFOCUS Reporting Server that is used when the server creates Active Technologies for Adobe® Flash® or Flex® software, graphics, accesses data sources through JDBC, or launches other Java processes. It normally uses the fourth port used by the server. By default, this is port 8123. Although not all WebFOCUS functionality requires JSCOM3, it is a good idea to ensure it is available.

  1. Sign in to the Reporting Server Web Console.
  2. Click Workspace on the main menu.
  3. In the navigation pane, right-click the Java Services folder and select Agents.

    The Java Services Agents page opens.

  4. Right-click on the image to the left of the JSCOM ID and ensure that the Stop option appears.

    If the Stop option appears, then JSCOM3 is started.

    If the Start option appears, then JSCOM3 did not start. JSCOM3 cannot start unless it finds certain native files in JRE directories. The server can find these file automatically if you set a $JAVA_HOME environment variable as explained in Preliminary Installation Instructions. If you set $JAVA_HOME in your .profile, log off, log back on, and restart the WebFOCUS Reporting Server. If JSCOM3 still does not start, refer to the Server Installation WebFOCUS Reporting Server DataMigrator Server manual to manually to set your shared library path.

    If you are planning to run the Active Technologies for Flash or Flex software, ensure that enough memory is allocated to the JSCOM3 service for Java to compile Flash or Flex files. Perform the following steps to set the maximum Java heap size:

    1. Open the Web Console and click Workspace on the main menu.
    2. From the navigation pane, open the Java Services folder, right-click DEFAULT, and select Properties.

      The Java Services Configuration pane opens.

    3. Open the JVM Settings section, as shown in the following image.

      Java Services Configuration - Non-standard JVM options

    4. In the JVM_Options field, enter:
    5. In the Maximum Java Heap Size field, enter an appropriate value in Megabytes (Mb).

      Note: 1024 Mb (1Gb) should be a sufficient value, although this can depend on how much memory is available on the machine that is hosting the server.

    6. Click Save and Restart Java Services.
  5. Click Properties.

    A page appears where you can configure the JSCOM3 listener. You can click through the tabs to see additional options.

  6. Choose whether to use headless or set DISPLAY.

    To generate graphics, JSCOM3 must either use the headless option or a DISPLAY variable.

    • The headless option does not support GIF graphs or the older WebFOCUS GRAPH32 engine, but allows you to run without an X Windows server. The headless option is enabled by default on the JVM Settings tab.
    • The DISPLAY variable supports all WebFOCUS graph options, but requires an X Windows server. To use DISPLAY, first turn off the headless option by selecting the JVM Settings tab, deselecting Set java.awt.headless property, and clicking Save and Restart Special Service. Then stop the WebFOCUS Reporting Server and set a DISPLAY environment variable to an X Windows Server. You can set the variable in your .profile or in the edastart script. For example:
      export DISPLAY=XWindowsHost:0.0
      export TERM=xterm



      Is the host name needed to access the X Windows Server. The server must also accept the connection, which may require using the xhost command.

Reference: Stopping the WebFOCUS Reporting Server

You can stop the WebFOCUS Reporting Server using the Web Console or as follows:

  1. Change your current directory to the EDACONF/bin directory. The default location for this directory is the following:
  2. Stop the WebFOCUS Reporting Server by typing the following command and pressing Enter:
    ./edastart -stop

Top of page

WebFOCUS Reporting Server Directory Structure

After installation, the WebFOCUS Reporting Server directory structure is created. The default directory is /ibi and contains three subdirectories:


Contains space for applications and sample data.


Contains space for server profiles.


Contains the server.

Under srv81 are the EDAHOME (home) and EDACONF (wfs) subdirectories: