Deploying the management server WAR file on WebSphere Application Server Community Edition

You can use IBM® Installation Manager to install the management server and its associated databases and data files to an application server computer. However, installation is not complete until you deploy the management server Web archive (WAR) file to the application server. Use this task to deploy the management server WAR file on the English version of WebSphere® Application Server Community Edition.

When you deploy the management server WAR file to the application server, the application server creates an Apache Derby database called OptimServerDB.

The version of WebSphere Application Server Community Edition that is delivered with the manager is available only in English. You must configure this version of WebSphere Application Server Community Edition by using an English user interface. However, when you use the manager, the language setting of the browser determines the language of the manager user interface. The language setting of the browser also determines the language of the messages that are received from the management server and proxy.

Use the Administrative Console of WebSphere Application Server Community Edition to deploy the management server WAR file. The default location of the administrative console is http://hostname:8080/console, where hostname is the host name of the computer on which WebSphere Application Server Community Edition is installed.

To deploy the management server WAR file by using the Administrative Console of WebSphere Application Server Community Edition:

  1. Click Deploy New.
  2. Enter the location of the management server WAR file into Archive, and click Install. The management server WAR file is shared_installation_directory/server/app/management-server.war, where shared_installation_directory is the installation directory that you specified for the IBM Optim Shared package group. For example, the default location for the management server WAR file on Microsoft Windows is C:\Program Files\IBM Optim\shared\server\app\management-server.war. If you prefer, you can click Browse to browse for the management server WAR file. The management server WAR file can take several minutes to deploy.
After you deploy the management server WAR file, you can configure management server properties by editing the application server startup script. This script is located at the following location, where shared_installation_directory is the installation directory that you specified for the Optim Management Server installation package.
  • Windows computers: shared_installation_directory\WebSphere\AppServerCommunityEdition\bin\startup.bat
  • Linux or UNIX computers: shared_installation_directory/WebSphere/AppServerCommunityEdition/bin/startup.sh
If the WAR file fails to deploy because of java.lang.OutOfMemoryError: PermGen space errors, increase the amount of permanent generation memory available for objects in the Java Virtual Machine (VM) on the application server. To increase the available amount of permanent generation memory, edit the application server startup script. Open this script in a text editor and add the following argument to the end of the JAVA_OPTS parameter in the script. NNN is the initial amount of permanent generation memory in MB and MMM is the maximum amount of permanent generation memory in MB. The entire JAVA_OPTS parameter must be either on a single line or on consecutive lines that are connected with line-continuation characters. The line-continuation character is the caret (^) for Windows batch scripts or the backslash (\) for Linux or UNIX scripts.
-XX:PermSize=NNNm -XX:MaxPermSize=MMMm
For example, the following JAVA_OPTS parameter from a Windows batch script specifies 128 MB as the initial amount of permanent generation memory and 256 MB as the maximum amount of permanent generation memory.
@set JAVA_OPTS=%ADDITIONAL_JAVA_OPTS% %JAVA_OPTS% ^
               -Djavax.net.ssl.keyStore="%GERONIMO_HOME%\var\security\keystores\optim-management-server.jks" ^
               -Djavax.net.ssl.trustStore="%GERONIMO_HOME%\var\security\keystores\optim-management-server.jks" ^
               -Djavax.net.ssl.keyStorePassword=manager -Djavax.net.ssl.trustStorePassword=manager ^
               -XX:PermSize=128m -XX:MaxPermSize=256m
The following JAVA_OPTS parameter from a Linux or UNIX script specifies 128 MB as the initial amount of permanent generation memory and 256 MB as the maximum amount of permanent generation memory.
JAVA_OPTS=-Djavax.net.ssl.keyStore=$GHOME/../var/security/keystores/optim-management-server.jks \
          -Djavax.net.ssl.trustStore=$GHOME/../var/security/keystores/optim-management-server.jks \
          -Djavax.net.ssl.keyStorePassword=manager -Djavax.net.ssl.trustStorePassword=manager \
          -XX:PermSize=128m -XX:MaxPermSize=256m \
          $JAVA_OPTS

By default, the management server uses 64 MB of permanent generation memory. Setting memory sizes to a value larger than the amount of available physical memory on your machine severely degrades performance.

If the application server is on a computer that is set to a language that requires the use of double-byte characters, configure the application server to use UTF-8 encoding in its log files. To configure the application server to use UTF-8 encoding, add the following argument to the end of the JAVA_OPTS parameter in the application server startup script. The entire JAVA_OPTS parameter must be either on a single line or on consecutive lines that are connected with line-continuation characters. The line-continuation character is the caret (^) for Windows batch scripts or the backslash (\) for Linux or UNIX scripts.
-Dfile.encoding=UTF-8
If the WAR file fails to deploy to a Linux computer because of IOException: too many open files errors, increase the maximum number of open files on the computer. To increase the maximum number of open files, sign on as superuser and complete the following steps.
  1. Enter the following command:
    /sbin/sysctl -w fs.file-max=100000
  2. Add the following line to the /etc/sysctl.conf file so that the setting remains as it is after system reboot.
    fs.file-max = 100000
  3. Enter the following command so that the change to the /etc/sysctl.conf file takes effect.
    /sbin/sysctl -p
  4. Enter the following command to verify the settings.
    /sbin/sysctl fs.file-max
  5. Enter the following command to increase the maximum number of processes to 20,048.
    ulimit -n 20048
  6. Add the following line to the beginning of the shared_installation_directory/WebSphere/AppServerCommunityEdition/bin/startup.sh script so that the setting is set every time that you start the application server.
    ulimit -n 20048