Enterprise Manager Java App: Web Configuration
In BBj 9.0 and higher, the Enterprise Manager introduces Web Configuration with three tabs; Webserver for general configuration, Applications for Web Start configuration, Web Services for creating and configuring Web Services.
Webserver
Description
The Webserver tab configures general BBj Webserver settings that apply to the Web features.
Start Webserver |
Turns on the built-in Webserver. |
Log File |
Full path of the log file where all Webserver logs will appear. |
Host Name |
The name of the computer on which BBj is installed. |
Port |
The port name. |
Keystore |
Full path to the keystore used for signing jars. Applications deployed via Java Web Start must be digitally signed. BBj automatically signs the jars with an example keystore provided with the installation. To use a different keystore, provide it here. |
Keystore Password |
Password To sign jars automatically, BBj requires the keystore password. |
Private Key |
Each keystore may have multiple keys, specify the name of the key you wish to use. |
Run Enterprise Manager |
Enterprise Manager is configured to run automatically via Web Start; disable running of Enterprise Manager here. |
Enterprise Manager Link |
The URL for accessing Enterprise Manager. |
Applications
Description
The Applications tab shows all applications currently configured to run in BBj. Additionally, this tab provides management tools for configuring BBj applications to run in the Web Start environment.
Application List |
A list of all applications configured to run in Java Web start. |
New |
Create a new configuration, to run an application under Java Web start. |
Edit |
Modify an existing configuration. See the section "Edit" below. |
Delete |
Remove an unwanted configuratiocxn. |
Edit
Edit the configuration details of BBj applications running in Webstart
.
Name |
Name of the application URL. |
Title |
Title of the application displayed to the user at launch time. |
Vendor |
Title of the vendor displayed to the user at launch time. |
Short Description |
Description displayed to the user on the launch splash screen. |
User |
User specified by the -u flag; may be left blank for default Web user. |
Config File |
The configuration file to use, normally specified by the -c option. |
Program |
The BBj program to run. |
Link |
The URL where BBj will publish your application. |
Jars |
List of additional jars to be included in the jnlp file. |
Arguments |
Additional arguments to the program. |
Web Services
Description
Displays a list of the Web Services currently configured that publish automatically when BBj starts.
Web Services list |
The list of available services. |
New Service |
Create a new Web service. |
Edit Service |
Add and remove methods from existing services. |
Delete Service |
Remove an unwanted service. |
Publish Service |
The configuration file to use, normally specified by the -c option. |
Edit Service
Add and remove methods of a Web service. Each method call will start a new BBj Interpreter and call the program you specify. Various configuration options may be passed to that interpreter.
Name |
Name of the service. |
Working directory |
Specifies the working directory for the interpreter that executes the program. |
Config file |
Path to the config file for the interpreter that executes the programs. |
New Method |
Add a new method to the Web service. |
Edit Method |
Changes the details of the existing method. |
Delete Method |
Deletes the method. |
Ok |
Returns to the Web Services overview screen. |
Edit Method
Web Services calls map to a CALL with ENTER of a BBj program. The Webserver and interpreter need specific details the enter statement to call the implementing function correctly.
Name |
Name of the method published to the world. |
Call |
The source file and label to call when a request is handled. |
Return Index |
Index of the argument to return; zero based. |
Argument List |
A list of all argument types that will be passed to the ENTER. |
BBjString |
Add a string argument. |
BBjNumber |
Add a numeric argument. |
BBjInt |
Add an integer argument. |
(text box) |
Allows the entry of a Java type. |
Custom |
Adds the type specified in the textbox. |
Ok |
Return to the Web Service editing screen. |
Your Web Service will be available in the built-in jetty server after publishing.
The host name, port number, and Web Service name combine to produce a
wsdl file available at this address http://
<hostname>:<port>/webservice/<web service name>?wsdl.
For example, a Web Service named example deployed on a host named myserver
would be available at this url: http://myserver:8888/webservice/example?wsdl.