Oracle WebLogic Server
|Installation of CloverDX Server on Oracle WebLogic|
|Configuration of CloverDX Server on Oracle WebLogic|
Before installation, check the software requirements, currently supported Oracle WebLogic versions and required Java version in the Software Requirements section.
If you encounter any problems during the installation, see Chapter 10, Troubleshooting for a possible solution.
Installation of CloverDX Server on Oracle WebLogic
Download and install Oracle WebLogic from the official download page.
WebLogic has to be running and a domain has to be configured. You can check it by connecting to Administration Console:
http://localhost:7001/console/. Username and password are specified during installation.
It is strongly recommended to adjust the default limits for Memory allocation (see the Memory Settings section).
You can set the initial and maximum memory heap size by adjusting the "Xms" and "Xmx" JVM parameters and classloaders memory limit by adjusting the "XX:MaxMetaspaceSize" parameter:
Edit the start script and add:
export JAVA_OPTIONS='$JAVA_OPTIONS -Xms512m -Xmx2048m -XX:MaxMetaspaceSize=512m'
It is strongly recommended to double-check any third-party JDBC drivers you are planning to use with CloverDX Server, as many of them come pre-installed with WebLogic Server (but in outdated versions) and consider updating to a more recent version. See Using Third-Party JDBC Drivers for guidelines.
For example, if using MySQL 5 as a system database, it is recommended to update to MySQL JDBC driver of version >= 5.1.48.
Go to the download section of your CloverDX account and download the
clover.war(web archive) file containing CloverDX Server for Oracle WebLogic Server.
Change HTTP Basic Authentication configuration
When WebLogic finds an "Authentication" header in an HTTP request, it tries to find a user in its own realm. This behavior has to be disabled so CloverDX could authenticate users itself.
Edit the configuration file
<security-configuration>element (just before the end tag).
clover.war(or an application directory).
Use the WebLogic Server Administration Console. See the Oracle Fusion Middleware Administrator's Guide for details.
Configure a license and other properties. See Configuration of CloverDX Server on Oracle WebLogic for details.
Log in CloverDX Server.
http://localhost:7001/cloverin the browser.
Activate the CloverDX Server.
Use the default administrator credentials to access the web GUI:
Configuration of CloverDX Server on Oracle WebLogic
The default installation (without any configuration) is only recommended for evaluation purposes. For production use, at least a dedicated, system database and SMTP server configuration is recommended.
For an easy configuration of CloverDX Server, use a Setup GUI in which you can configure various properties, including the connection to the database, username and password, path to the license file, private properties, Clusters and much more (see Chapter 17, List of Configuration Properties and Chapter 51, Cluster Configuration). We recommend you place the file in a specified location and specify the path to the file with a system property.
The content of such a file (example with a PostgreSQL database):
datasource.type=JDBC jdbc.driverClassName=org.postgresql.Driver jdbc.url=jdbc:postgresql://127.0.0.1/clover_db?charSet=UTF-8 jdbc.username=yourUsername jdbc.password=yourPassword jdbc.dialect=org.hibernate.dialect.PostgreSQLDialect
Properties File in Specified Location
cloverServer.propertiesfile in a directory readable by WebLogic. (If you need an example of connection to any of the supported database systems, see Chapter 16, System Database Configuration.)
The configuration file should contain DB datasource configuration, SMTP connection configuration, etc. For details, see Part III, “Configuration”.
clover_config_filesystem property (or environment variable) pointing to the configuration properties file.
Set the JAVA_OPTIONS variable in the WebLogic domain start script
Restart WebLogic for changes to take effect.
Note: When CloverDX Server is deployed on WebLogic and JNDI Datasource pointing to Oracle DB is used, there must be an extra configuration property in the configuration file:
Continue with: Chapter 8, Postinstallation Configuration