Configuring Apache with WebLogic

Configuring Windows Apache 2.0/2.2 with Windows WebLogic

Installing PowerServer Web Component to the Apache document root

Run the PowerServer setup program and install PowerServer Web Component to the document root of the Apache HTTP Server, for example, %Apache%\htdocs\.

If you have installed PowerServer Web Component to another location, then you should copy the entire appeon folder from the installation directory of PowerServer Web Component to the Apache document root.

Installing the redirector plug-in

Copy the mod_wl_20.so or mod_wl_22.so file from the %WebLogic%\server\bin\ to the %APACHE%\modules folder.

Configuring the httpd.conf file
  1. Add the following scripts to the httpd.conf file (located in the %APACHE%\conf folder):

    If PowerServer is installed to a WebLogic cluster, add the following scripts:

    #Load the Apache HTTP Server Plug-In
    LoadModule weblogic_module     modules/mod_wl_20.so
    
    #Configuring the Apache HTTP Server Plug-In
    ###########  WebLogic Cluster settings############
    <IfModule mod_weblogic.c>
      MatchExpression /AEM
      MatchExpression /servlet
      WebLogicCluster 192.0.3.140:7001,192.0.3.141:7001
    </IfModule>

    If PowerServer is installed to a single WebLogic, add the following scripts:

    #Load the Apache HTTP Server Plug-In
    LoadModule weblogic_module     modules/mod_wl_20.so
    
    #Configuring the Apache HTTP Server Plug-In<![endif]>
    ###########  Single WebLogic settings ############
    <IfModule mod_weblogic.c>
        MatchExpression /AEM
        MatchExpression /servlet
        WebLogicHost 192.0.3.141
        WebLogicPort 7001
    </IfModule>
  2. Specify an appropriate timeout period in the "Timeout" script in the httpd.conf file. The default value is 300 seconds.

Configuring for Appeon DataWindow Data Cache

Under the installation directory of PowerServer Web Component (for example, C:\Inetpub\wwwroot\appeon), there are Apache20Support and Apache22Support folders.

  1. Copy the appeoncache.conf file from the \Apache20Support\conf or \Apache22Support\conf folder to the %APACHE%\conf folder. 

    • The cachesize property is 100MB by default (and minimum). If you set the size to a value smaller than 100MB, the cache size will still be regarded as 100MB. For the Web server cache to keep enough DataWindow data, the larger the cache size, the better, but you need to make sure the cache size is no larger than the available memory on the server.

    • The cache_temp_dir property is "C:\tmp" by default. Make sure "C:\tmp" exists on your computer, or change the default value to the physical path of an existing directory.

    • The encoding formats for the cached data include UTF-8 and UTF-16LE. If you use the plug-in from the application server, DataWindow Data Cache will fail to cache data in UTF-8 and UTF-16LE at the same time, and requires you to set the encoding format. If the Appeon cluster plug-in is used, you must comment out the setting as shown in the code example below, so that DataWindow Data Cache can cache data in UTF-8 and UTF-16LE at the same time.

      #cache capacity, unit is M Bytes, must larger than 100
      cachesize 100
      #the switcher for print log info or not, on for use log, off close log;
      log on
      ## Working directory for temporary files and the compression cache
      ## if not specified, the following default values are used:
      ## [Win32=c:\tmp], [UNIX=/tmp], the directory must exist
      ## this item just for apache
      cache_temp_dir /tmp
      ## encoding type , it can be utf-8 or utf-16le, the default value is utf-8;
      ## if you use Appeon’s cluster plug-in,  you should comment  the setting
      encoding utf-8
  2. Copy the modcache2.dll or modcache22.dll file from the \Apache20Support\modules or \Apache22Support\modules folder to the %APACHE%\modules folder.

  3. Add the following script to the httpd.conf file in the %APACHE%\conf folder:

    # Cache Module Appeon Data Cache function, AX only
    #------mod_cache for web cache configuration-------#
    LoadModule data_cache_module modules/modcache2.dll
    <IfModule mod_cache.c>
    include conf/appeoncache.conf
    </IfModule>
    #-----------------End configuration----------------#

    The scripts load the modcache2.dll or modcache22.dll file and include the appeoncache.conf file.

Configuring UNIX Apache 2.0/2.2 with UNIX WebLogic

Installing PowerServer Web Component to the Apache document root

Install PowerServer Web Component to the document root of the Apache HTTP Server, for example, $APACHE/htdocs/, by following the instructions in Installation Guide for Appeon PowerServer.

If you have installed PowerServer Web Component to another location, then you should copy the entire appeon folder from the installation directory of PowerServer Web Component to the Apache document root.

Installing redirector plug-in

Go to the $WebLogic/server/lib/ folder and select the folder indicating the operating system of the PowerServer/WebLogic in use.  For example, if PowerServer runs on WebLogic on Sun Solaris, click the "solaris" folder under the $WebLogic/server/lib/ folder and copy the mod_wl_20.so or mod_wl_22.so file to the $APACHE/modules/ folder.

Configuring httpd.conf file
  1. Add the following scripts to the httpd.conf file (located in the $APACHE/conf/ folder):

    If PowerServer is installed to a WebLogic cluster, add the following scripts (take mod_wl_20.so as an example):

    #Load the Apache HTTP Server Plug-In
    LoadModule weblogic_module     modules/mod_wl_20.so
     
    #Configuring the Apache HTTP Server Plug-In
    ###########  WebLogic Cluster settings ############
    <IfModule mod_weblogic.c>
      MatchExpression /AEM
      MatchExpression /servlet
      WebLogicCluster 192.0.3.140:7001,192.0.3.141:7001
    </IfModule>

    If PowerServer is installed to a single WebLogic, add the following scripts (take mod_wl_20.so as an example):

    #Load the Apache HTTP Server Plug-In
    LoadModule weblogic_module     modules/mod_wl_20.so
     
    #Configuring the Apache HTTP Server Plug-In
    ###########  Single WebLogic settings ############
    <IfModule mod_weblogic.c>
        MatchExpression /AEM
        MatchExpression /servlet
        WebLogicHost 192.0.3.141
        WebLogicPort 7001
    </IfModule>
  2. Specify an appropriate timeout period in the "Timeout" script in the httpd.conf file. The default value is 300 seconds.

Configuring for DataWindow Data Cache 

The DataWindow data cache feature is not available in UNIX and Linux.

Configuring Windows Apache 1.3 with Windows WebLogic

Note that if PowerServer is installed to WebLogic 8.1.6 on Windows, Apache 1.3 on Windows cannot be used as the Web server because WebLogic 8.1.6 on Windows does not provide appropriate redirector plug-ins for it, instead, use Apache 1.3 on UNIX or Apache 2.0.

Configuring UNIX Apache 1.3 with UNIX/LINUX WebLogic

Installing PowerServer Web Component to the Apache document root

Install PowerServer Web Component to the document root of the Apache HTTP Server, for example, $APACHE/htdocs/, by following the instructions in the Installation Guide for Appeon PowerServer.

If you have installed PowerServer Web Component to another location, then you should copy the entire appeon folder from the installation directory of PowerServer Web Component to the Apache document root.

Installing redirector plug-in

Go to the $WebLogic/server/lib/ folder and select the folder indicating the operating system of the PowerServer/WebLogic in use. For example, if PowerServer runs on WebLogic for Sun Solaris, click the "solaris" folder under the $WebLogic/server/lib/ directory and copy the mod_wl.so file to the $APACHE/modules folder.

Configuring httpd.conf file
  1. Add the following scripts to the httpd.conf file (located in the $APACHE/conf folder):

    If PowerServer is installed to a WebLogic cluster, add the following script:

    #Load the Apache HTTP Server Plug-In
    LoadModule weblogic_module     modules/mod_wl.so
     
    #Configuring the Apache HTTP Server Plug-In
    ###########  WebLogic Cluster settings############
    <IfModule mod_weblogic.c>
      MatchExpression /AEM
      MatchExpression /servlet
      WebLogicCluster 192.0.3.140:7001,192.0.3.141:7001
    </IfModule>

    If PowerServer is installed to a single WebLogic, add the following script:

    #Load the Apache HTTP Server Plug-In
    LoadModule weblogic_module     modules/mod_wl.so
     
    #Configuring the Apache HTTP Server Plug-In
    ###########  Single WebLogic settings ############
    <IfModule mod_weblogic.c>
        MatchExpression /AEM
        MatchExpression /servlet
        WebLogicHost 192.0.3.141
        WebLogicPort 7001
    </IfModule>
  2. Specify an appropriate timeout period in the "Timeout" script in the httpd.conf file.  The default value is 300 seconds.

Configuring for DataWindow Data Cache

The DataWindow data cache feature is not available in UNIX and Linux.