Configuring Apache with WebSphere

Configuring Windows Apache 2.0/2.2 with Windows WebSphere

Installing PowerServer Web Component to the Apache document root

Run the Appeon 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

In WebSphere 5.1: Copy the mod_was_ap20_http.dll or mod_was_ap22_http.dll file from the %WAS_HOME%\bin\ folder to the %APACHE%\modules\ folder.

In WebSphere 6.0: Download the installation program and set up for Apache 2.0 or 2.2. For detailed information, refer to WebSphere user document.

Adding virtual host in WebSphere console
  1. Click Environment > Virtual Host in the navigation tree of the WebSphere Administrative Console.

  2. Click the New button in the page that displays.

  3. Input the IP address of the Web server in the Host Name field and port number in the Port field.

  4. Click Environment > Update Web Server Plug-in in the console navigation tree.

  5. Click OK to update the Web server plug-in.

  6. Save the new configuration and restart WebSphere server.

Configuring the plugin-cfg.xml file

Copy the plugin-cfg.xml file from the %WAS_HOME%\config\cells\ folder to the %APACHE%\conf\ folder and modify the following directives according to the PowerServer/WebSphere environment:

Configure the log file location. For example:

<Log LogLevel="Error" Name="%APACHE%/logs/http_plugin.log"/>

Configure the IP address and port number of the PowerServer\WebSphere. For example:

<Transport Hostname="192.0.0.39" Port="9080" Protocol="http"/>
<Transport Hostname="192.0.0.39" Port="9443" Protocol="https">
      <Property name="keyring" value="C:/Websphere/AppServer/etc/plugin-key.kdb"/>
      <Property name="stashfile" value="C:/Websphere/AppServer/etc/plugin-key.sth"/>
</Transport>

Configure the context path. For example:

<UriGroup Name="server1_Cluster_URIs">
     <Uri Name="/servlet/*"/>
     <Uri Name="/AEM/*"/>
</UriGroup>
Configuring the httpd.conf file
  1. Add the following scripts to the httpd.conf file (located in the %APACHE%\conf\ folder):

    Take was_ap20_module as an example:

    #Loading the plug-in file
    LoadModule was_ap20_module   modules/mod_was_ap20_http.dll
    WebSpherePluginConfig conf/plugin-cfg.xml
  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:

    Take modcache2.dll as an example:

    # 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/LINUX WebSphere

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

In WebSphere 5.1: Copy the mod_was_ap20_http.so or mod_was_ap22_http.so file from the $WAS_HOME/bin/ folder to the $APACHE/modules/ folder.

In WebSphere 6.0: Download the installation program and set up for Apache 2.0 or 2.2. For detailed information, refer to WebSphere user document.

In certain UNIX operating systems (such as Sun Solaris), the plug-in file requires libgsk7*.so to work. Download and install GSKit7.x from the IBM Website (http://www.ibm.com/).

Adding virtual host in WebSphere console
  1. Click Environment> Virtual Host in the navigation tree of the WebSphere Administrative Console.

  2. Click the New button in the page that displays.

  3. Input the IP address of the Web server in the Host Name field and port number in the Port field.

  4. Click Environment > Update Web Server Plug-in in the console navigation tree.

  5. Click OK to update the Web server plug-in.

  6. Save the new configuration and restart WebSphere server.

Configuring plugin-cfg.xml file

Copy the plugin-cfg.xml file from the $WAS_HOME/config/cells/ folder to the $APACHE/conf/ folder and modify the following directives according to the PowerServer/WebSphere environment:

Configure the log file location. For example:

<Log LogLevel="Error" Name="$APACHE/logs/http_plugin.log"/>

Configure the IP address and port number of the PowerServer\WebSphere. For example:

<Transport Hostname="192.0.0.39" Port="9080" Protocol="http"/>
<Transport Hostname="192.0.0.39" Port="9443" Protocol="https">
    <Property name="keyring" value="$WAS_HOME/etc/plugin-key.kdb"/>
    <Property name="stashfile" value="$WAS_HOME/etc/plugin-key.sth"/>
</Transport>

Configure the context path. For example:

<UriGroup Name="server1_Cluster_URIs">
     <Uri Name="/servlet/*"/>
     <Uri Name="/AEM/*"/>
</UriGroup>
Configuring httpd.conf file
  1. Add the following scripts to the httpd.conf file (located in the $APACHE/conf folder):

    Take mod_was_ap20_http.so as an example:

    #Loading the plug-in file
    LoadModule was_ap20_module   modules/mod_was_ap20_http.so
    WebSpherePluginConfig conf/plugin-cfg.xml
  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 WebSphere

Installing PowerServer Web Component to the Apache document root

Run the Appeon 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 redirector plug-in

Copy the mod_app_server_http.dll file from the %WAS_HOME%\bin to the %APACHE%\modules folder.

Adding virtual host in WebSphere console
  1. Click Environment > Virtual Host in the navigation tree of the WebSphere Administrative Console.

  2. Click the New button in the page that displays.

  3. Input the IP address of the Web server in the Host Name field and port number in the Port field.

  4. Click Environment > Update Web Server Plug-in in the console navigation tree.

  5. Click OK to update the Web server plug-in.

  6. Save the new configuration and restart WebSphere server.

Configuring the plugin-cfg.xml file

Copy the plugin-cfg.xml file from the %WAS_HOME%\config\cells\ folder to the %APACHE%\conf\ folder and modify the following directives according to the PowerServer\WebSphere environment:

Configure the log file location. For example:

<Log LogLevel="Error" Name="%APACHE%/logs/http_plugin.log"/>

Configure the IP address and port number of the PowerServer\WebSphere. For example:

<Transport Hostname="192.0.0.39" Port="9080" Protocol="http"/>
<Transport Hostname="192.0.0.39" Port="9443" Protocol="https">
  <Property name="keyring" value="C:/Websphere/AppServer/etc/plugin-key.kdb"/>
  <Property name="stashfile" value="C:/Websphere/AppServer/etc/plugin-key.sth"/>
</Transport>

Configure the context path. For example:

<UriGroup Name="server1_Cluster_URIs">
     <Uri Name="/servlet/*"/>
     <Uri Name="/AEM/*"/>
</UriGroup>
Configuring the httpd.conf file
  1. Add the following script to the httpd.conf file (located at the %APACHE%\conf\ folder):

    #Loading the plug-in file
    LoadModule app_server_http_module  modules/mod_app_server_http.dll
    WebSpherePluginConfig conf/plugin-cfg.xml
  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 is an Apache13Support folder.

  1. Copy the appeoncache.conf file from the Apache13Support\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.

      #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
  2. Copy the modcache.dll file from the %APACHE%\htdocs\appeon\Apache13Support\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/modcache.dll
    <IfModule mod_cache.c>
    include conf/appeoncache.conf
    </IfModule>
    #-----------------End configuration----------------#

    The scripts load the modcache.dll file and include the appeoncache.conf file.

Configuring UNIX Apache 1.3 with UNIX/LINUX WebSphere

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 the redirector plug-in

Copy the mod_app_server_http.so file from the $WAS_HOME/bin/ folder to the $APACHE/modules folder.

In certain UNIX operating systems (such as Sun Solaris), the plug-in file requires libgsk7*.so to work. Download and install GSKit7.x from the IBM Website (http://www.ibm.com/).

Adding virtual host in WebSphere console
  1. Click Environment > Virtual Host in the navigation tree of the WebSphere Administrative Console.

  2. Click the New button in the page that displays.

  3. Input the IP address of the Web server in the Host Name field and port number in the Port field.

  4. Click Environment > Update Web Server Plug-in in the console navigation tree.

  5. Click OK to update the Web server plug-in.

  6. Save the new configuration and restart WebSphere server.

Configuring the plugin-cfg.xml file
  1. Copy the plugin-cfg.xml file from the $WAS_HOME/config/cells/ folder to the $APACHE/conf/ folder and modify the following directives according to your PowerServer/WebSphere environments:

    Configure the log file location. For example:

    <Log LogLevel="Error" Name="$APACHE/logs/http_plugin.log"/>

    Configure the IP address and port number of the PowerServer\WebSphere. For example:

    <Transport Hostname="192.0.0.39" Port="9080" Protocol="http"/>
    <Transport Hostname="192.0.0.39" Port="9443" Protocol="https">
        <Property name="keyring" value="$WAS_HOME/etc/plugin-key.kdb"/>
        <Property name="stashfile" value="$WAS_HOME/etc/plugin-key.sth"/>
    </Transport>

    Configure the context path. For example:

    <UriGroup Name="server1_Cluster_URIs">
         <Uri Name="/servlet/*"/>
         <Uri Name="/AEM/*"/>
    </UriGroup>
  2. Specify an appropriate timeout period in the "Timeout" script in the httpd.conf file. The default value is 300 seconds.

Configuring the httpd.conf file

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

#Loading the plug-in file
LoadModule app_server_http_module   modules/mod_app_server_http.so
WebSpherePluginConfig conf/plugin-cfg.xml
Configuring for DataWindow Data Cache

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