Restoring Previous Version's Configurations

After installing Intellicus 25.x, you must reapply your previous custom configurations and files to maintain consistent behavior and appearance.

Important
Stop the Intellicus Report Server and Intellicus Portal before restoring any files.

Restore the `data` Folder

Replace the backed-up data folder only if a data connection was configured to use the H2-based DemoRepositoryDB.

Platform	Path

Platform	Path
Windows	`<installation folder>\Intellicus\ReportEngine\data`
Linux	`<installation folder>/Intellicus/reportengine/data`

Restore Customized Template Files

Replace template files only if they were customized in the previous version.

Platform	Path

Platform	Path
Windows	`<installation folder>\Intellicus\ReportEngine\templates`
Linux	`<installation folder>/Intellicus/reportengine/templates`

Restore Resource Bundles

Merge and replace the contents of the resourcebundles folder.

Platform	Path

Platform	Path
Windows	`<installation folder>\Intellicus\ReportEngine\resourcebundles`
Linux	`<installation folder>/Intellicus/reportengine/resourcebundles`

If you customized the en_US.xls file or created custom bundlers:

Platform	Path

Platform	Path
Windows	`<installation folder>\Intellicus\Jakarta\webapps\intellicus\client\lang`
Linux	`<installation folder>/Intellicus/jakarta/webapps/intellicus/client/lang`

Intellicus 25.x License

After restoring files, ensure you use a valid Intellicus 25.x license.

Configuration and File Restoration Matrix

File / Folder	Restoration Action

File / Folder	Restoration Action
`Encr_ReportEngine.dat`	Restore from backup
`rpg` folder	Restore from backup
`data` folder	Restore from backup (only if using H2/DemoRepositoryDB)
`cubedata` folder	Restore from backup (rebuild cubes after upgrade)
`mails` folder	Restore from backup
`templates` folder	Merge custom changes
Resource bundler files	Merge custom changes
`Localeconfiguration.xls`	Merge custom changes
`ReportEngine.properties`	✔ Windows: Prompt to restore during install✔ Linux/macOS: Restore manually
`ReportClient.properties`	✔ Windows: Prompt to restore during install✔ Linux/macOS: Restore manually
`run.bat` / `run.sh`	Merge into new version
`CategoryPropertiesInfo.xml`	Use newly installed version
`QOPropertiesInfo.xml`	Use newly installed version
`ReportPropertiesInfo.xml`	Use newly installed version
`exin_validations.xls`	Merge custom changes
`FormatMapping.xls`	Merge custom changes
`databasemapping.xls`	Merge custom changes
`integration.xml` (if embedded)	Replace or update in the new version
`web.xml` (if embedded)	Merge Intellicus-specific entries

Configuration File Handling in Intellicus 25.x

Intellicus 25.x introduces a new configuration handling approach:

Default values are now stored in two read-only files:
- ReportEngine_Default.properties
- ReportClient_Default.properties
Custom environment-specific values stored in:
- ReportEngine.properties
- ReportClient.properties

Intellicus now gives runtime preference to user-defined values. This eliminates the need to manually merge changes post-upgrade, as long as your property files are preserved.

Best Practice

Maintain version-controlled backups of all custom files and configurations before performing an upgrade.