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. 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.