Installation and base directories
The rest of this guide refers to two locations: the installation directory and the base directory.
Installation directory
Holds the application code. It applies only to pre-deployed Tomcat installations. The pre-deployed package's installation directory contains these folders by default:
apache-tomcat-x.x.xx igrafxdata jre-11.x.x windows
Base directory
Holds files and folders that must survive between platform versions — mostly configuration, plus temporary data and logs. In a pre-deployed Tomcat installation it's the igrafxdata directory. Every installation type (EAR, WAR, pre-deployed) needs a base directory; you point the application server at it with the Java system property igrafx.basedirectory at startup.
Key files
Back up these configuration files when you upgrade or move to another server.
| File | Purpose |
|---|---|
<base directory>/dbconfig.xml | How the platform connects to the database. Edit it directly to adjust the location when you move the database server, rename the database, and so on. |
<base directory>/igrafx.properties | Configuration for the authentication method and other advanced options. The file created during installation documents each property and when to use it. |
<base directory>/log4j2.xml | Basic logging settings and locations. You can edit it, but most of the time it's better to use Administration → Support → Logging Settings in the application. |
<installation directory>/apache-tomcat-x.x.xx/conf/server.xml | Used with Tomcat: which ports to use, whether to serve HTTPS on Tomcat, and the URL when the server is behind a reverse proxy. |
server.xml isn't in the base directory, so if you've modified it from the default, back it up before upgrading. After the upgrade, reapply your customizations to the new version's server.xml — follow the specific upgrade instructions to confirm whether you can overwrite the new file with yours.