Configuring the management server on WebSphere Application Server Community Edition

After you deploy the management server to WebSphere® Application Server Community Edition, you can configure management server properties. To configure management server properties, edit the script that you use to start WebSphere Application Server Community Edition.

Location of startup script

When you install WebSphere Application Server Community Edition with the management server, Installation Manager automatically creates a startup script for WebSphere Application Server Community Edition. The startup 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

Setting the registry and repository locations

If you use more than one management server, each management server has its own registry and repository. To use a single registry and repository for all management servers, you must choose one management server to act as the registry and repository. You can then set all other management servers to use that registry and repository. To set a management server to use a registry and repository, add the following arguments to the JAVA_OPTS parameter in the 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.
-Dcom.ibm.optim.registry.url=registry_URL
-Dcom.ibm.optim.repository.url=repository_URL
  • registry_URL is the location of the registry.
  • repository_URL is the location of the repository.
For example, the following JAVA_OPTS parameter from a Windows batch script specifies http://mgmtserver1:8080/server/registry as the registry location and http://mgmtserver1:8080/server/repository as the repository location.
@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 ^
               -Dcom.ibm.optim.registry.url=http://mgmtserver1:8080/server/registry ^
               -Dcom.ibm.optim.repository.url=http://mgmtserver1:8080/server/repository
The following JAVA_OPTS parameter from a Linux or UNIX script specifies http://mgmtserver1:8080/server/registry as the registry location and http://mgmtserver1:8080/server/repository as the repository location.
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 \
          -Dcom.ibm.optim.registry.url=http://mgmtserver1:8080/server/registry \
          -Dcom.ibm.optim.repository.url=http://mgmtserver1:8080/server/repository \
          $JAVA_OPTS
If you assign IP addresses dynamically to computers, use the host name of the computer that hosts the registry and repository instead of the IP address.

Setting the host name and port for a management server

If you assign IP addresses dynamically to computers, or if the application server uses a port number other than 8080, set the host name and port that are used by the management server. To set the host name and port for the management server, add the following arguments to the JAVA_OPTS parameter in the 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.
-Dcom.ibm.optim.host.name=host_name
-Dcom.ibm.optim.host.port=host_port
  • host_name is the host name or IP address of the management server.
  • host_port is the port used by the management server.
For example, the following JAVA_OPTS parameter from a Windows batch script specifies mgmtserver as the host name of the management server and 8080 as the port number used by the management server.
@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 ^
               -Dcom.ibm.optim.host.name=mgmtserver ^
               -Dcom.ibm.optim.host.port=8080
The following JAVA_OPTS parameter from a Linux or UNIX script specifies mgmtserver as the host name of the management server and 8080 as the port number used by the management server.
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 \
          -Dcom.ibm.optim.host.name=mgmtserver \
          -Dcom.ibm.optim.host.port=8080 \
          $JAVA_OPTS

Setting the management server to use the https protocol

As one step in establishing a trust relationship between a management server and a proxy, you must set the management server to use the https protocol to communicate with other components. The management server uses the http protocol unless you set the management server to use the https protocol. To set the management server to use the https protocol, add the following argument to the JAVA_OPTS parameter in the 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.
-Dcom.ibm.optim.url.protocol=https
If a management server uses the https protocol, you must also set the registry and repository locations to use the https protocol.
For example, the following JAVA_OPTS parameter from a Windows batch script specifies https://mgmtserver1:8080/server/registry as the registry location and https://mgmtserver1:8080/server/repository as the repository location.
@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 ^
               -Dcom.ibm.optim.registry.url=https://mgmtserver1:8080/server/registry ^
               -Dcom.ibm.optim.repository.url=https://mgmtserver1:8080/server/repository ^
               -Dcom.ibm.optim.url.protocol=https
The following JAVA_OPTS parameter from a Linux or UNIX script specifies https://mgmtserver1:8080/server/registry as the registry location and https://mgmtserver1:8080/server/repository as the repository location.
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 \
          -Dcom.ibm.optim.registry.url=https://mgmtserver1:8080/server/registry \
          -Dcom.ibm.optim.repository.url=https://mgmtserver1:8080/server/repository \
          -Dcom.ibm.optim.url.protocol=https \
          $JAVA_OPTS