This file (owareapps\installprops\lib\ contains defaults installed with your package. An example of this file appears below. Installation automates the insertion of the [host name] variable:


# The following properties override those found in *

# oware/lib/*.properties in order to establish valid *

# properties for this installation. *

#************************************************************[host name | partition name]

com.dorado.bom_dbms.preferred_db_type=rdbms[Package Name]

oware.installed.package.version=[Package Version]

OWARE.CONTEXT.SERVER.URL=jnp://[host name]:1099


The OWARE.CONTEXT.SERVER.URL, when present, disables an otherwise dynamic lookup of this server. Devices that do not support multicast (for example, some Dell switches) require this be a static address--the URL in this property. You would have to use this property when connecting to an application server through a VPN that restricts multicast traffic. You must list all additional servers, comma-delimited (OWARE.CONTEXT.SERVER.URL=jnp://[host1]:1099, jnp://[host2]:1099...), if you have a clustered installation.

Simple installations explicitly set the server URL on clients. This URL assumes the application server is running on the default port range. If ports conflict, use the
-n [Node Number] parameter in a command line to start application server so it uses something other than a default port range.

If your client cannot connect and the server log shows it cannot bind to port 1099 (or 11099, and so on), then stopping application server from the client does not work; client applications cannot communicate with the application server. In this case, to stop application server, you must kill the java.exe processes on the server machine. The tray icon should then indicate the application server is stopped.

To change the port range for application server, modify the node number property for appserver in oware\lib\pmstartup.dat. By default (upon installation) the property is as follows:


To use a different part range, change zero (0) to 1, 2 or 3.

Once the application server starts and listens (no bind errors), you still have to change port settings for the client connections. For each installation (server and client) modify a URL setting in owareapps\installprops\lib An example of default setting (hostname varies) would be as follows:


The application server node number should prefix the 1099 port if greater than 0. For example, using application.server.node.number=1 in pmstartup.dat would imply all installations need the following setting in



For a complete list of port settings and protocols used by this application, see Ports Used.