Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

M-Business Anywhere Redirector

The following setup instructions are written for M-Business Anywhere on Windows, Solaris, or Linux.

For information about version support, see Redirector in  SQL Anywhere 10.0.1 Components by Platform.

To configure the M-Business Anywhere Redirector

1. Complete the steps in Configuring Redirector properties (for Redirectors that don't support server groups).

2. Copy the file mod_iaredirect.dll or mod_iaredirect.so to the M-Business Anywhere \bin directory on the computer that holds the web server. This file is located in the MobiLink\redirector\MBusinessAnywhere subdirectory of your SQL Anywhere installation.

3. If your web server is on a separate computer from the Redirector, you must copy the following files to that computer and ensure that they are in your path (Windows) or shared path (Unix). What files you need depends on what, if any, encryption you are using. The following file locations are relative to your SQL Anywhere installation:

   Setup	Files required
   ECC encryption	Windows: win32\mlcecc10.dll Unix: lib32/libmlcecc10_r.so
   RSA encryption	Windows: win32\mlcrsa10.dll Unix: lib32/libmlcrsa10_r.so
   RSA encryption with FIPS	Windows: win32\mlcrsafips10.dll and win32\sbgse2.dll Unix: lib32/libmlcrsafips10_r.so and libsbgse2_r.so

4. For Windows, update the M-Business Anywhere web server configuration file sync.conf as follows:

   • In the LoadModule section, add the following line:

     LoadModule iaredirect_module path/bin/mod_iaredirect.dll

     where path is the location of the M-Business Anywhere bin directory.

   • In the SyncLoadFile section, add the following line:

     SyncLoadFile path/bin/mod_iaredirect.dll

     where path is the location of the M-Business Anywhere bin directory.

   • Add the following section to the file:

     <Location /iaredirect/ml>
        SetHandler iaredirect-handler
        iaredirectorConfigFile location/redirector.config
     </Location>

     where /iaredirect/ml is the path that you will use to invoke the Redirector, and location is the directory where redirector.config is located.

5. For Solaris and Linux, update the M-Business Anywhere web server configuration file sync.conf as follows:

   • In the LoadModule section, add the following line:

     LoadModule iaredirect_module path/bin/mod_iaredirect.so

     where path is the location of the M-Business Anywhere bin directory.

   • Add the following section to the file:

     <Location /iaredirect/ml>
        SetHandler iaredirect-handler
        iaredirectorConfigFile location/redirector.config
     </Location>

     where /iaredirect/ml is the relative URL path that you will use to invoke the Redirector, and location is the directory where redirector.config is located.

   • You may also want to add the following optional directives to the <Location> section you just created:

     • MaxSyncUsers number  The maximum number of MobiLink users synchronizing through the Redirector. This number is used to allocate necessary resources to the Redirector. This number cannot be less than 60. The default is 1000. Only change this setting if the default number of users is less than the actual number.

     • ShmemDiagnosis on|off   If set to on, allows debugging of the memory resource. The default is off.

6. To help with debugging, you may want to increase the amount of logging information that the Redirector outputs. To do this, modify the LogLevel directive in sync.conf and set it to LogLevel info. The log level can be (from most to least verbose): debug, info, notice, warn, error, crit, alert, and emerg.

7. Restart your M-Business Sync Server for the changes to take effect.

Following are examples of the sections of sync.conf that configure the M-Business Anywhere web server to route requests to the MobiLink server.

This example works on Windows:

LoadModule iaredirect_module "c:\program files\M-Business Anywhere/bin/mod_iaredirect.dll"
...
SyncLoadFile "c:\program files\M-Business Anywhere/bin/mod_iaredirect.dll"
...
<Location \iaredirect\ml>
    SetHandler iaredirect-handler
    iaredirectorConfigFile "c:\AvantGoServer\conf/redirector.config"
</Location>

The following example works on UNIX and Linux:

LoadModule iaredirect_module modules/mod_iaredirect.so
...
<Location /iaredirect/ml>
    SetHandler iaredirect-handler
    iaredirectorConfigFile "/redirector.config"
</Location>

To test your configuration

1. Call the Redirector using the following syntax:

   http://host:port/iaredirect/ml/

   where iaredirect is the path you specified in the <Location> tag of sync.conf.

2. Check the log files sync_access.log and sync_error.log to verify that the Redirector logged a request.

   Note: This test does not make a connection to the MobiLink server.