Chapter 3. Installing
This chapter describes two different server installations - Evaluation Server and Production Server - and provide instructions on installing the CloverETL Server License.
Evaluation Server
The Evaluation Server consists of CloverETL Server bundled with the Tomcat application container. The server performs basic configuration during the first startup and requires no additional database server. This option is recommended only for basic evaluation of CloverETL Server's functions.
However with further configuration, it is possible to evaluate other CloverETL Server features and even make the evaluation server ready for production environment. This process requires connection to an external, dedicated database and subsequent configuration of services (e.g. SMTP, LDAP, etc.).
![[Important]](figures/important.png) | Important |
|---|---|
| The Apache Derby DB, bundled with the evaluation server, is not recommended for production environment. Please use one of the supported external databases. |
Production Server
In case of Production Server, the CloverETL Server is installed on one of the several compatible application containers. This process requires additional configuration (e.g. memory allocation, database connection, etc.) but allows you to choose an application container and external database according to your preference.
Installation and configuration procedure
To create a fully working instance of Production CloverETL Server, you should:
Install an application server
CloverETL Server is compatible with several application containers. Following subsections offer detailed instructions on installation of the respective application servers and their subsequent configuration.
Set up limits on a number of opened files, memory allocation and firewall exceptions
CloverETL Server's graph transformations and evaluations may require more memory than the default limit set in the database as well as higher number of simultaneously opened files. Moreover, some components require firewall exceptions to be set. These instructions provide recommendation on adjusting both the Memory Settings and the Maximum Number of Open Files, as well as Firewall Exceptions.
Install CloverETL Server into application server
CloverETL Server is provided as a web archive (
.war) file for an easy deployment.Create a database dedicated to CloverETL server
Unlike the Evaluation server, the Production server requires that you have created a dedicated database for CloverETL Server. In the configuration phase of this manual, you will be guided to Chapter 8, Examples of DB Connection Configuration with instructions on how to properly configure the properties file of various databases.
Set up connection to the database
The CloverETL Server Console GUI lets you configure a number of items including database connection, license file, etc. Optionally, you can set up password encryption in configuration files for higher security. For details, see Chapter 7, Setup.
Install a license
To be able to execute graphs, you need to install a valid license. There are three options for CloverETL Server Activation.
Perform additional server configuration
Set up a master password for secure parameters
When handling sensitive information (e.g. passwords), it is advised to define secure graph parameters. This action requires a master password (see Chapter 13, Secure Parameters).
Set up SMTP server connection
CloverETL Server lets you configure an SMTP connection for reporting events on the server via e-mails.
Configure temp space
CloverETL Server works with temporary directories and files. To ensure the components work correctly, you should configure the
Temp spacelocation on the file system. For details, see Chapter 12, Temp Space Management.Configure sandboxes
Lastly, you should set the content security and user's permissions for sandboxes. For details and instructions, see Chapter 15, Server Side Job Files - Sandboxes.