.. include:: /includes.rst.txt

.. comments - headings

   # with overline, for parts
   * with overline, for chapters
   = for sections
   - for subsections
   ^ for subsubsections
   " for paragraphs
   * for H5
   + for H6

.. _edg_server_platform_considerations:

EDG Server Platform Considerations
----------------------------------

These sections describe some aspects of the server platform to consider prior to installing the EDG server. 

Application Server and Supported Platforms
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

The EDG server uses Apache Tomcat running on Java. 

.. seealso:: For the details of your EDG server version, see the `Supported Platforms`_ page for compatible platform components (e.g., Java, database, etc.). 
 This also includes sections with details and suggested configurations for installing on Linux or Windows Server. 

Suggested Java Configuration
""""""""""""""""""""""""""""

If you are using both TopBraid EDG and another TopBraid server application such as Explorer on the same machine, we recommend that you run each in a separate JVM by running them with separate instances of Tomcat.

It is necessary to ensure that you have adequate physical memory to run EDG and that you have configured your Web Application Server to use it. 
During the purchasing process you should have received a guide to Server Sizing Specifications. 
Please set these appropriate to your data and users. 
If you did not receive this, please contact TopQuadrant support.

See the installation instructions below for your operating system for more details concerning how to set the parameters.

Operating Systems
^^^^^^^^^^^^^^^^^

Installation on Linux
"""""""""""""""""""""

This section describes details and suggested configurations when using Linux as the base operating system and Tomcat as the Web Application Server.

A suggested configuration for Enterprise Data Governance is as follows:

.. list-table:: 
   :header-rows: 1
   :widths: 20 80
   :class: tight-table
 
   * - Operating Systems
     - Current version of Linux with 2.6 or higher kernel
   * - Java Runtime Environment
     - Java 11
   * - Web Application Server
     - * Apache Tomcat 9 latest (For Debian based Linux distributions, see the notes for using Tomcat 9: https://salsa.debian.org/java-team/tomcat9/blob/master/debian/README.Debian)
       * Apache Tomcat 8.5 latest: see `Supported Platforms`_ for specific versions
   * - Permissions
     - Full access to the Tomcat configuration area is required.

Enterprise Data Governance also requires that the ``nofile`` limit be increased as it opens a large number of JAR files, and each TDB database also has a large number of files. 
The default is 1024 open files and sockets. 
Reset this by adding the following two lines to the /etc/security/limits.conf configuration file:

::

 tomcat8         soft    nofile          2048
 tomcat8         hard    nofile          8192

Installation on Windows Server
""""""""""""""""""""""""""""""

This section describes details and suggested configurations when using Windows Server as the base operating system and Tomcat as the Web Application Server.

A suggested configuration for Enterprise Data Governance is as follows:

.. list-table::
   :widths: 20 80
   :class: tight-table
 
   * - Operating Systems
     - * Windows Server, (e.g. 2008, 2012, 2016)
       * Administrator access is required for installation
   * - Java Runtime Environment
     - Java 11
   * - Web Application Server
     - * Apache Tomcat 9 latest
       * Apache Tomcat 8.5 latest

       See `Supported Platforms`_ for specific versions

.. _Supported Platforms: https://www.topquadrant.com/supported-platforms/