Version

    Chapter 15. Setup

    Before You Start
    Using Setup

    While it is possible to configure CloverDX Server by modifying the configuration file in a text editor, the Setup with a user-friendly GUI offers a much easier way of configuring basic properties according to your preferences and requirements. Setup is accessible from Server Console under ConfigurationSetup.

    It lets you configure:

    Remember that you should create a database for CloverDX Server and add a user/role for Clover with appropriate rights before you set up the connection to the database in the server's Setup GUI.

    CloverDX Server requires a working database connection for storing license information. Therefore, it allows you to access the Setup and configure the connection prior the Server activation - simply log in the Server Console and click the Close button. Otherwise, you would have to activate the server again, after switching from Derby to a new system database.

    [Important]Important

    To access the Setup section, you need the Server Setup permission.

    [Tip]Tip

    To keep your settings and data in the case of a database migration (e.g. from evaluation to production environment), see Server Configuration Migration.

    Before You Start

    Before you start using the Setup, you have to specify the path to the configuration file where the Setup saves the settings, and add required libraries to the classpath.

    1. Specify the Path to the Configuration File

      Setup uses the configuration file to save the server's settings. The path to the file is specified by the clover.config.file system property. Each application server has a different way to configure it; for more information, see the Specifying the Path to the Configuration File section.

    2. Add Libraries to the Classpath

      As the next step, you should place the libraries required for further configuration on the application server's classpath (in most cases, this is done by placing the files into a specific directory). You usually need a JDBC driver for the connection to the database or a .jar file with an encryption provider.

      For example, in the case of Apache Tomcat, copy the libraries to the TOMCAT/lib/ folder. Then, restart the application server.

    3. Configure Particular Items

      Now, you can use the Setup to configure the rest of the Server's features (see the following section). The configuration is then saved into a file defined in the clover.config.file property.

      If you wish to encrypt the sensitive data in you configuration file, set up the Encryption first.

    4. Restart the Server (if needed)

      Some changes require you to restart the Server. These changes are indicated by the icon. Other changes (e.g. License, Sandboxes, E-mail, LDAP) are applied immediately and do not require a restart.

    Using Setup

    Each setup page consists of a menu with setup tabs on the left, a main configuration part in the middle and a configuration status and text on the right side.

    The main configuration part contains several buttons:

    • Save saves changes made to the configuration file. The changes in the configuration must be valid.

    • Save Anyway saves the configuration even if it is invalid. For example, a database connection is considered invalid if a required library is missing.

    • Validate validates the configuration on a current tab. If you see the Save button disabled, use Validate to validate the configuration first.

    • Discard Changes discards unsaved changes and returns to currently used values.

    The following icons can appear in the Server GUI:

    configured tab

    inactive tab

    error

    warning

    restart required

    pending changes which have not been saved yet

    If an error/warning icon appears, a status message on the right side of the Setup GUI will provide relevant details.

    If you start the Server without configuration, you will see decorators pointing to the Setup. The decorators mark problems which require your attention. The displayed number corresponds to the number of items.

    Setup GUI with decorators

    Figure 15.1. Setup GUI with decorators


    Configuration File

    The Configuration tab displays the content of the configuration file. For basic setting, you do not have to edit the content of the file manually. Instead, use the particular Setup tab to configure the corresponding subsystem. For advanced setting, see Chapter 17, List of Configuration Properties.

    Example of the Server Configuration file

    Figure 15.2. Example of the Server Configuration file


    License

    The License tab lets you add/update, show or reload the license. The type of the license determines what CloverDX Server's features are activated.

    [Important]Important

    The license is stored in the database; therefore, you should configure the database prior activating the Server with a license. Otherwise, you will have to specify the license again.

    Similarly, if you change the database, you will be prompted to re-activate the Server.

    The License tab

    Figure 15.3. The License tab


    Database

    The Database tab lets you configure the connection to the database. You can connect via:

    • JDBC

      Under JDBC connection, choose your Database from the first drop-down list. This will enable you to choose a Database URL template from the second drop-down list. In this template (e.g. jdbc:postgresql://host:5432/dbname for PostgreSQL), replace the host and dbname keywords with proper values.

      Next, enter the User name and Password for your database (default User name/Password: clover/clover).

      [Note]Note
      An Apache Derby JDBC 4 compliant driver is bundled with CloverDX Server. If you use another database system, add a JDBC 4 compliant driver on the classpath.

    • JNDI

      With JNDI, you can access the Datasource on an application server level. Select your Database and choose a suitable item from a JNDI tree For more information, see JNDI DB Datasource.

    Database connection configuration for JDBC (left) and JNDI (right)

    Figure 15.4. Database connection configuration for JDBC (left) and JNDI (right)


    Worker

    The Worker tab lets you configure Worker properties.

    You can change Initial and Maximum heap size for Worker, include JVM arguments and set Port range for communication with Worker.

    Changes in Worker require restart - click on the Actions button in the right pane and select Finish jobs and restart or Restart now.

    The Worker tab

    Figure 15.5. The Worker tab


    Sandboxes

    The Sandboxes tab lets you configure a path to shared, local and partitioned sandboxes.

    Sandbox path configuration with Clustering disabled (left) and enabled (right)

    Figure 15.6. Sandbox path configuration with Clustering disabled (left) and enabled (right)


    Encryption

    To secure your sensitive data in the configuration file, you can use the Encryption feature. In the Encryption tab, choose a desired Encryption provider and Encryption algorithm; among the default algorithms, the PBEWithSHA1AndDESede is the strongest.

    However, since the default algorithms are generally weaker, we recommend using Bouncy Castle - a free custom JCE (Java Cryptography Extension) provider offering a higher strength of encryption.

    Note that in case you use a custom provider, the libraries have to be added on the classpath (in the same way as database libraries).

    Encryption configuration

    Figure 15.7. Encryption configuration


    E-Mail

    The E-mail tab lets you configure a connection to an SMTP server so the CloverDX Server can send an email reporting the Server status / events on the Server.

    To make sure the configuration of Outgoing SMTP Server is correct, you can check that the SMTP server can be reached by sending a test email from the dialog. If the protocol is set SMTP than STARTTLS is enabled automatically. For disabled this set "mail.smtp.starttls.enable" to false in Additional properties.

    E-mail configuration

    Figure 15.8. E-mail configuration


    LDAP

    The LDAP tab lets you use an existing LDAP database for user authentication.

    Specify a connection to the LDAP server and define a pattern for user DN. Login Test allows you to validate the login using any user matching the pattern.

    For more information, see LDAP Authentication.

    LDAP configuration

    Figure 15.9. LDAP configuration


    Cluster

    The Cluster tab lets you configure clustering features.

    In case your license does not allow clustering, the Enable clustering checkbox is grayed out and the note The license does not allow clustering. appears at the top.

    For more information, see Part VII, “Cluster”.

    Cluster configuration

    Figure 15.10. Cluster configuration