Server administration settings

This field shows the filepath and filename of the Java virtual machine (VM) used to process your service calls. This must be a Java VM that is accessible to the physical server machine. Typically, it is the local VM, for example:

C:\usd90-install-dir\JAVA\SUN\JRE\BIN\java.exe

By default, this attribute is set to the filepath and filename leading to your local Java VM.

The filename part of a Java Location value is always java.exe.

In this field you can supply a list of .JAR files that you want to include. If you want to include more than one .JAR file, use a colon (;) as a separator, for example:

companyutils.jar;ojdbc6.jar

When this box is checked, clients are allowed browsing of Generic Resources. Generic resources are predefined resources that USoft adds to each REST service and may be found in the .wadl file (press the Browse Description button in the top right corner of the Services window or tab). An example of a generic resource is version.

The default is Yes (= checked). You need to uncheck this box to block client access to generic resources.

When this box is checked, clients are allowed browsing of Admin Resources. Browsing Admin resources gives you a list of services advertised at the server. This is the list that appears when you press the Browse Resources button in the top right corner of the Services window or tab.

The default is Yes (= checked): you need to uncheck this box to block client access to Admin resources. If this box is unchecked:

•Authenticator settings have no effect.

•The services are not advertised in the .wadl file (which you can inspect in Service Definer by pressing the Browse Description button).

When this box is checked, clients are allowed browsing of the server's log information. This is the information that appears when you press the Browse Logs button in the top right corner of the Services window or tab.

The default is Yes (= checked). You need to uncheck this box to block client access to log information.

This field shows how client access to Admin REST resources is controlled. These have an effect only if the "Allow browsing of Admin Resources" box is checked.

The values in this dropdown list box are the Name values of the records in the Authenticator window. You are free to edit or extend this list. To open the Authenticator window or tab, choose View, Objects from the main menu and then double-click on Authenticators.

Authenticator objects have a Validating Agent attribute. For each Authenticator, this attribute must have 1 of the values explained in the table below.

Authenticator objects also have a URL attribute. This URL attribute is relevant if the Authenticator attribute is set to Directory Service or to USoft Authorization, as explained in the table below.

NOTE: The Condition attribute for Authenticators is not currently passed. It will be passed in the future as a further restriction on the directory service request if Authenticator = Directory Service, or as a further restriction on application rights if Authenticator = USoft Authorization.

To help you make Authenticator settings, samples are initially present for Fixed Password and for Directory Service.

This field shows the filepath and filename that identify the server's .CMD file. At development time, you can use this file to run the server from a command box. This is an alternative to starting the server as a Windows service:

Running the server from a command box allows you, at development time, to see detailed output information that can help when you are debugging. For example, details about how a class is coded wrongly.

Unfortunately, errors causing a premature end will not normally be visible since the command box closes as soon as the server stops. One way to prevent this is to start the .CMD file from a command box (instead of pressing the Run Command button). Another solution is to prepend the body text in the .CMD file by:

cmd.exe /K "

(noting the double quote at the end) and to add another double quote character at the very end of the text body:

"

Using the second technique, pressing the Run Command button will give you a command box that stays open even when the server ends its life. Note, however, that when you (re)publish the server, all manual edits to the .CMD file identified in the Command Line field will be overwritten.

It is possible to limit the number of requests that your server is allowed to handle concurrently. If the number of accepted requests exceeds this limit, further incoming requests will be ignored and a response with response code 429 will be sent giving a message that the server is busy and that the user should try again later.

To enable this throttling functionality:

NOTE: You can add your own text to the default response message by using the functional type ThrottlingHook in a class.