Installation Checklist

This document serves as a checklist to outline the information needed for EDG installations. Please use this guide to pull in appropriate IT resources and gather needed information prior to installation. The links in this guide will be very useful for new customers. Please read them completely.

  1. Read the documentation for server installation at EDG Installation. Details on the below items will be found in this document.

  2. Provision Tomcat server with appropriate sizing for users and data, plan for growth. Follow the guidelines provided upon purchase. Contact TopQuadrant support if you need a new copy of this information.

  3. Decide where the workspace, properties file, and vault will be located. The workspace contains configuration, connector and data files.

  4. Ensure Tomcat has access to write to the directory for the workspace. For Debian based Linux distributions, see the notes for using Tomcat 10.

  5. Server must be running supported Tomcat and Java. See EDG Server Platform Considerations

  6. Decide on authentication mechanisms for end users and API clients, see Authentication Methods. For SSO methods, have the required IDP details ready.

  7. Decide on active database storage options. TDB will be contained in the workspace. Data Platform will enable all EDG collections to be synced between EDG nodes. See TopBraid Data Platform for specific instructions on setting up Data Platform. You cannot change this later without creating a new environment workspace.

  8. Implement a backup strategy for the workspace and/or database. Backup often. See EDG Backup and Restore.

  9. If implementing more than 1 server (for instance Explorer) both should have the ability to talk to each other.

  10. Obtain the .war file and license file from TopQuadrant Jira ticketing system. If the ticket is closed, you can still access it in the portal.

  11. After reading the installation guide and preparing the above information, you will be ready to deploy EDG application, setup users and rights management. See Rights Management Admin Page for Rights Management assistance. See The Governance Model and Workflows for using the governance collection to control user permissions as well.

  12. Follow the rest of the Server Administration Page guide for additional configurations in EDG. Please go through the Product Configuration Parameters Admin Page and the System Configuration Parameters Admin Page prior to use. These have important configurations such as the Mail Settings Section.

  13. Highly Recommended:

  • Monitoring software (such as Splunk, Zabbix, ELK)

  • Update the log4j.xml file in EDG/WEB-INF with appropriate parameters for rollover size

  • Create a playbook/runbook for deployment and installation of EDG for future use

  1. Security:

  • EDG will create temporary files (including potentially sensitive files such as uploaded documents) in the temp directory that is used by the Java VM. The specific location of that can be controlled using the system property java.io.tmpdir. If the temp files are deemed a security risk, the system administrator may elect to change the temp dir location and adjust permissions accordingly.

  • Hashicorp can be used for secure storage data encryption. See EDG Integration with Hashicorp Vault and related setup field reference

  • Several configuration settings exist to limit security risk for EDG, please check the Server Administration page in EDG and the setup field reference to enable/disable these settings.