Settings in the server.xml file

Most of the settings in the server.xml file should not be modified and are not documented here. If you want information on server.xml settings not covered here, see the Tomcat Servlet/JSP Container documentation, referenced in Related publications.

The following abstraction from the XML for the server.xml file locates, in bold, the two <Context> elements that contain the parameters you may need to change. 

<Server ...> 
    <Listener ...>
 
        ...
 
    <Listener ...>
 
    <GlobalNamingResources ...> 
        <Service name="Tomcat-Standalone"> 
        <Connector ...>
 
            ...
 
        <Connector ...> 
        <Engine name="Standalone" ...> 
            <Logger .../> 
            <Host name="localhost" ...> 
                <Valve .../>
 
                    ...
 
                <Valve .../> 
                <Logger .../> 
                <Context path=/admin ...>
 
                    ...
 
                </Context> 
                <Context path=/device ...>
 
                    ...
 
                </Context> 
            </Host> 
        </Engine> 
    </Service> 
</Server>
Note

The two <Context> elements have exactly the same parameters. The parameters in <Context path=/admin ...> control the /admin context; those in <Context path=/device ...> control the /device context. All parameters are specified in the form, <Parameter name= param_name value= param_value />.

Caution

Do not edit the server.xml file directly. Instead, edit your changes into the server.xml.default file, then run the defaults_setup.bat script (Windows) or defaults_setup script (UNIX). See Editing configuration files.

Caution

The @@...@@ variables server.xml.default file must not be modified. Values for these variables are set globally in the defaults file; change the value of @@...@@ variables in the defaults file and run the defaults_setup.bat script (Windows) or defaults_setup script (UNIX) to update the values in server.xml.

Table 3. server.xml file settings

Parameter name

Description

 
JSoapConfig

Location of jsoapconfig.xml file. 

SoapServer

URL for SOAP server.

 
AuthKey

Used as the shared secret between the SOAP server and client to blowfish encrypt the session ID and user’s password during authentication. Only the first 40 characters are used, so make sure they are unique and random.

Note

You must set the same AuthKey in both the /admin and /device contexts. 

UpgradeBaseUrl

The base URL used in upgrades.

 
AllowSecureClientConnect

Allow clients to connect to server securely (using https://). This parameter affects incoming clients only. You must have sagd.so or sagd.dll installed for this setting to have any effect.

Note

You must uncomment this setting if SSL is enabled in sync.conf, and the setting for this parameter must match that in sync.conf. 

ConnectSecureOnly

Set this directive to true to force all inbound client-to-server connections to be secure.

Note

You must uncomment this setting if SSL is enabled in sync.conf, and the setting for this parameter must match that in sync.conf. 

SyncHost

The name of the machine running M-Business Sync Server.

 
SyncPort

The port at which to access M-Business Sync Server.

 
UIHost

The full name of the machine running the UI server. On UNIX, the UI server is the admin process. 

MALUserURL

URL of the home page for the server. If a user launches the M-Business Connect desktop application and clicks the Contents button, M-Business Connect accesses the server using the URL given here. Specify a URL relative to UIHost. 

UserFriendlyServerName

The server name that appears in M-Business Connect on the desktop and on the device. This setting also appears in the defaults file. 

DebugToTomcatOutput

Set to TRUE to show debugging output from the admin Web application.

Copyright © 2008, iAnywhere Solutions, Inc.