test

Sun Java System Application Server Enterprise Edition 8.2 Release Notes for Microsoft Windows

Installation

This section describes known installation issues and associated solutions.

Java Enterprise System 5 Installer for Minimal Application Server 8.x Load Balancer Does Not Install Properly (ID 6478047)

Apache and IIS cannot be configured through Java ES 5 Installer. You need to manually configure Apache and IIS on the Windows platform.

Solution

To configure Load Balancer Apache or IIS, follow these steps.

    To Configure Apache 2.x:

  1. Install Apache 2.x.

    Apache is installed in the APDIR=C:\Apache2\Apache2 directory

  2. Install JES5 with minimal installation.

    Deselect all components but loadbalancer. Java ES 5 is installed in the JES5DIR=C:\Program Files\Sun\JavaES5 directory.

    The

  3. Create the resource and errorpages directories in the Apache2 directory.

    mkdir %APDIR%\modules\resource

    mkdir %APDIR%\modules\errorpages

  4. Copy the resource file to the resource directory.

    cd %APDIR%\modules\resource

    copy %JES5DIR%\appserver\lib\webserver-plugin\windows\apache2\LBPlugin*.res .

  5. Copy the load balancer DLL to the modules directory.

    cd %APDIR%\modules

    copy %JES5DIR%\appserver\lib\webserver-plugin\windows\apache2\mod_loadbalancer.dll .

  6. Copy the template errorpages to the errorpages directory.

    cd %APDIR%\modules\errprpages

    copy %JES5DIR%appserver\lib\webserver-plugin\windows\iws\errorpages .

  7. Copy the loadbalancer template and the other DTD to the Apache config directory.

    cd %APDIR%\config

    copy %JES5DIR%\appserver\lib\install\templates\loadbalancer.xml.template .

    copy %JES5DIR%\appserver\lib\dtds\sun-loadbalancer* .

  8. Create a backup of the httpd.conf file.

    cd %APDIR%\config

    copy httpd.conf httpd.conf.orig

  9. Edit the httpd.conf file.

    Append the following lines to the httpd.conf file:

    ##BEGIN EE LB Plugin Parameters
LoadModule apachelbplugin_module modules/mod_loadbalancer.dll
<IfModule mod_apache2lbplugin.cpp>
		config-file "C:\Apache2\Apache2/conf/loadbalancer.xml"
		locale en
</IfModule>
<VirtualHost 10.12.8.107>
DocumentRoot "C:\Apache2\Apache2/htdocs"
ServerName vm07
</VirtualHost>
##END EE LB Plugin Parameters

  10. Replace C:\Apache2\Apache2 with the actual %APDIR% directory.

    Also replace the IP, ServerName, and DocumentRoot directory.

  11. Create a new sec_db_filesdirectory in the %APDIR%.

    cd %APDIR%

    mkdir sec_db_files

  12. Copy NSS key store to the %APDIR%\sec_db_files directory.

    cd %APDIR%\sec_db_files

    copy %JES5DIR%\appserver\lib\webserver-plugin\windows\iis\*.db .

  13. Set the PATH to include the required libraries.

    Prepend the following extra path:

    PATH %JES5DIR%\share\lib;%JES5DIR%\appserver\lib;%JES5DIR%\appserver\bin

  14. Replace %JES5DIR% with the actual Java ES 5 directory.

  15. Add the NSPR_NATIVE_THREADS_ONLY variable with value 1 in the system environment.

  16. Reboot and test Apache 2 (after configuring loadbalancer.xml).

    To configure IIS LBPlugin:

  1. Create the sun-passthrough directory in the c:\inetpub\wwwroot directory.

    cd c:\inetpub\wwwroot

    mkdir sun-passthrough

  2. Createerrorpages, resource and sec_db_files directories in the c:\inetpub\wwwroot\sun-passthrough directory.

    cd c:\inetpub\wwwroot\sun-passthrough

    mkdir errorpages

    mkdir resources

    mkdir sec_db_files

  3. Copy DLL files to the sun-passthrough directory.

    copy <as_install_dir>/appserver/lib/webserver-plugin/iis/*.dll c:\inetpub\wwwroot\sun-passthrough\

  4. Copy DTDs to the sun-passthrough directory.

    copy <as_install_dir>/appserver/lib/dtds/sun-loadbalancer*.dtd c:\inetpub\wwwroot\sun-passthrough\

  5. Copy the sun-passthrough.properties fileto the sun-passthrough directory.

    copy <as_install_dir>/appserver/lib/webserver-plugin/iis c:\inetpub\wwwroot\sun-passthrough\

  6. Copy security DB files to the sun-passthrough directory.

    copy <as_install_dir>/appserver/lib/webserver-plugin/iis/*.db c:\inetpub\wwwroot\sun-passthrough\sec_db_files\

  7. Copy resource files to the sun-passthrough directory.

    copy <as_install_dir>/appserver/lib/webserver-plugin/iws/*.res c:\inetpub\wwwroot\sun-passthrough\resource\

  8. Copy error pages to the sun-passthrough directory.

    copy <as_install_dir>/appserver/lib/webserver-plugin/iws/errorpages/*.html c:\inetpub\wwwroot\sun-passthrough\errorpages\

  9. Copy the loadbalancer.xml.example template to the sun-passthrough directory.

    copy <as_install_dir>/appserver/lib/install/templates/loadbalancer.xml.example c:\inetpub\wwwroot\sun-passthrough\

  10. Edit the sun-passthrough.properties file.

    ##BEGIN EE LB Plugin Parameters
log-file = C:\InetPub\wwwroot\sun-passthrough\lb.log
### The valid options for different logging levels are FATAL, SEVERE, WARNING, INFO and FINE.
log-level = INFO
lb-config-file = C:\InetPub\wwwroot\sun-passthrough\loadbalancer.xml
##END EE LB Plugin Parameters
Note –

If you are configuring IIS6, ensure that you set the permissions and perform additional steps as described in the AS82 documentation. You might also need to set the IIS6 isolation mode to IIS5 compatible.

imq Directory Needs to Be Created During Installation. (ID 6199697)

On the Windows platform, immediately after the installation of Application Server Enterprise Edition, the Message Queue broker fails on startup. A error message is displayed stating that the directory drive:\as\domains\domain1\imq does not exist.

Note that if the broker is started after starting domain1, the directory is created by the Application Server and the problem does not occur.

Solution

  1. Create the var_home_dir_location before creating the broker:


    $imqbrokerd -varhome var_home_dir_location

    For example:


    $imqbrokerd -varhome D:\as\domains\domain1\imq