Editing configuration files

M-Business Server includes several configuration files. These files are located in the <M-Business_Home>/conf directory, where <M-Business_Home> is the M-Business home directory that is created under the location that you specify during installation.

Caution

Do not modify the @@...@@ variables in sync.conf.default, agsoap.conf.default, and server.xml.default files. 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 sync.conf.

Table 1. Configuration files

File name

Description

sync.conf

This file contains both Apache and M-Business Anywhere-specific configuration directives for the Sync Server, which runs when users synchronize their devices with M-Business Server.

agsoap.conf

This file contains both Apache and M-Business Anywhere-specific configuration directives for M-Business SOAP Server, which supports creation of the M-Business Administrator Console.

server.xml

This file contains both Apache and M-Business Anywhere-specific configuration directives for the Tomcat Server, which acts as the Web server for the default Administrator Console UI.

The directives in each configuration file come from an associated default configuration file.

Table 2. Default configuration files

File name

Description

defaults

Contains variable definitions that are used to build the configuration files. The most commonly changed configuration settings are in this file.

Use the defaults file to set:

  • Host names of computers running Admin, Sync, and SQL Anywhere services

  • Names of log files

  • User and group IDs used to run the server processes

  • Account names and passwords used by M-Business Server to access the database

  • Limits on the number of connections the database will accept and the number of retries for database accesses

  • E-mail address displayed on error pages

  • URL of the home page for the server

sync.conf.default

Used to create sync.conf. This file uses the variables defined in the defaults file.

agsoap.conf.default

Used to create agsoap.conf. This file uses the variables defined in the defaults file.

server.xml.default

Used to create server.xml. This file uses the variables defined in the defaults file.

To edit configuration files

  1. Change the directive’s variable definition in the defaults, sync.conf.default, agsoap.conf.default, or server.xml.default file.

    These files are located in the <M-Business_Home>/conf directory.

    For information on specific settings in these files, see Configuring M-Business Server.

  2. Run the appropriate script for your platform.

    Windows: defaults_setup.bat

    UNIX: defaults_setup

    The script scans all files in the <M-Business_Home>/conf directory that have the extension .default, makes the appropriate variable definition substitutions, and saves the changes to the associated configuration file—sync.conf, agsoap.conf, or server.xml.

  3. Stop and restart M-Business Server services.

    See Starting, stopping, and restarting M-Business Server.

    Caution

    If you have already made changes to any of the associated configuration files, those changes are overwritten when you run the defaults_setup script. Use the above instructions to correctly edit the configuration files.

To learn more about the settings in the configuration default files:

For a complete list of M-Business Anywhere-specific directives and what they do, see Configuring M-Business Server.

Copyright © 2008, iAnywhere Solutions, Inc.