Sun GlassFish Enterprise Server 2.1 Quick Start Guide

HADB Preinstallation Steps

This procedure covers the most common preinstallation tasks. For information on other preinstallation topics, including prerequisites for installing HADB, configuring network redundancy, and file system support, see Chapter 10, Installing and Setting Up High Availability Database, in Sun GlassFish Enterprise Server 2.1 High Availability Administration Guide.

The recommended system configuration values in this section are sufficient for running up to six HADB nodes and do not take into consideration other applications on the system that also use shared memory.

ProcedureTo Configure Your System for HADB

  1. Get root access.

  2. Define variables related to shared memory and semaphores

    • On Solaris:

      1. Add these lines to the /etc/system file (or if these lines are in the file as comments, uncomment them and make sure that the values match these):

        set shmsys:shminfo_shmmax=0x80000000

        set shmsys:shminfo_shmseg=36

        set semsys:seminfo_semmnu=600

        Set shminfo_shmmax to the total memory in your system (in hexadecimal notation the value 0x80000000 shown is for 2 Gigabytes of memory).

        If the seminfo_* variables are already defined, increment them by the amounts shown. The default values for seminfo_semmni and seminfo_semmns do not need to be changed. The variable shminfo_shmeg is obsolete after Solaris 8.

      2. Reboot, using this command:

        sync; sync; reboot

    • On Linux:

      1. Add these lines to the /etc/sysctl.conf file (or if they are in the file as comments, uncomment them). Set the value to the amount physical memory on the machine. Specify the value as a decimal number of bytes. For example, for a machine having 2 GB of physical memory:

        echo 2147483648 > /proc/sys/shmmax

        echo 2147483648 > /proc/sys/shmall

      2. Reboot, using this command:

        sync; sync; reboot

    • On Windows: No special system settings are needed.

  3. If you used existing JDK software when you installed a standalone Enterprise Server, check the JDK version.

    HADB requires Sun JDK 1.4.1_03 or higher (for the latest information on JDK versions, see the Sun GlassFish Enterprise Server 2.1 Release Notes). Check the version installed, and if it is not done already, set the JAVA_HOME environment variable to the directory where the JDK is installed.

  4. If necessary after the reboot, restart the domain, Web Server, and node agent.

    To restart the domain, use the command asadmin start-domain domain1.

    To restart the Web Server, execute the start program in web_server_install_dir/https-hostname.

    To restart the node agent, use the command asadmin start-node-agent hostname. Replace the variable hostname with the name of the host where the Enterprise Server is running.