WebUI

Overview

In BBj 25.10 and higher, the WebUI client allows BBj programs to run in a web browser.

Configuration

To enable or disable WebUI deployment, check or uncheck the WebUI Enabled checkbox in EM: App Deployment > Global Settings in the WebUI Only section. On the same page, you can also modify the WebUI context mapping.

To configure WebUI settings for specific applications, go to EM: App Deployment > Applications and find the WebUI Only section at the bottom.

Headless Linux Server Configuration

Using WebUI applications on a headless Linux server requires some additional configuration. Use the steps below as a guide, modifying them if necessary to suit your specific operating system.

  1. Install xwindows support on the machine

    apt-get install libxext6 libxi6 libxtst6 libxrender1 libpangoft2-1.0-0

  2. Install xvfb if desired (would be required on AIX and on linux with glibc < 2.18)

    apt-get install xvfb (Package name may be different on different distributions)

  3. Install BBj

  4. Update BBj.properties if desired

    BBj.properties setting Description

    webui.display="\:99"

    By default, BBjServices exports "DISPLAY=:99". This property overrides the default setting.

    webui.enabled=true

    Set by the installer and EM.

    webui.isheadless=true

    Can be used to force BBjServices to run in headless mode. By default, BBjServices only runs in headless mode if DISPLAY is not set.

    webui.virtualdisplay.prog=<virtual display program>

    By default BBjServices uses ${BBjHome}/webui/xheadless/xheadless as the virtual display program on Linux, and /usr/bin/xvfb-run as the program on AIX. This property allows you to specify the program to use. This can be xheadless, xvfb or another program that creates a virtual display to use.

    You can use this property to specify command line arguments in addition to the program name.

    By default, xheadless/xvfb is used if all of the following is true

    • WebUI is installed

    • webui.enabled is true

    • the DISPLAY environment variable is not set

    • the virtual display program to run exists.

    Additionally, xheadless/xvfb is used if the webui.isheadless property is set to true.

 

See Also

EM: App Deployment > Global Settings

EM: App Deployment > Applications

Dynamic Web Client (DWC) Overview

Browser User Interface (BUI) Overview