enhancement
critical
major
minor
minor
Until now, when you build a WAR file for an application and deploy it to a container, the application does not start up by default unless you add an external configuration file and define the database connection there.
Improvement
A default deployment generates a WAR that starts up without errors using an H2 database in WEB-INF.
Code Migration
Configuration variables used during deployment to reference a directory on the web server are now interpreted as directories rather than File Manager pseudo-URLs. This means that these variables must now specify a direct file system path on the target server (without the `file://` prefix). The variable names have been changed from *_DIR to *_PATH. The following are affected:
- %DATA_DIR% -> %DATA_PATH%
- %STORAGE_DIR% -> %STORAGE_PATH%
- %LOG_DIR% -> %LOG_PATH%
- %IMPORT_LOG_DIR% -> %IMPORT_LOG_PATH%
- %VAR_DIR% -> %VAR_PATH%
- %TMP_DIR% -> %TMP_PATH%
- %DOCUMENTS_DIR% -> %DOCUMENTS_PATH%
- %REPOSITORY_DIR% -> %REPOSITORY_PATH%
- %ATTIC_DIR% -> %ATTIC_PATH%
- %VARIANTS_DIR% -> %VARIANTS_PATH%
- %FONT_DIR% -> %FONT_PATH%
- %FAM_DATA_DIR% -> %FAM_DATA_PATH%
- %LUCENE_DIR% -> %LUCENE_PATH%
- %CONF_DATA_DIR% -> %CONF_DATA_PATH%
The same applies to the environment variable used to set the root directory of the application's data directory:
- tl_storage_dir -> tl_storage_path
Accordingly, the interpretation of the following configuration properties has changed (now file system path, previously pseudo-file-manager URL):
- com.top_logic.base.administration.LoggerAdminBean#config-dir
- com.top_logic.basic.io.BasicFileLog#basicPath
- com.top_logic.dsa.repos.file.FileRepository#attic
- com.top_logic.dsa.repos.file.FileRepository#path
- com.top_logic.dsa.repos.file.FileRepository#workarea
- com.top_logic.basic.util.ResourcesModule#dynamic-bundle#storage
- com.top_logic.knowledge.indexing.lucene.LuceneIndex#index-location
- com.top_logic.dsa.file.FilesystemDataSourceAdaptor#home
The following configuration property has been removed; the value is hard-coded (/WEB-INF/conf/resources):
- com.top_logic.basic.util.ResourcesModule#static-bundles#storage
Test
- Create a new application named myapp.
- Execute the WAR target within it.
- Select the default answer for all prompts.
- Deploy the WAR to the local Tomcat server.
- Expected result: The application starts up and you can log in.
- The monitor displays "reasonable" paths for the database, repository, and image temp dir components: