Skip to main content
Kinetic Community

Using Source Control for Kinetic Application Configurations

It is often beneficial to backup configurations and/or to track changes to configurations in production.  Below is a list of the files and directories that are used for configuration in Kinetic applications.

Kinetic Bridgehub

%DATA_DIR% is set based upon the com.kineticdata.bridgehub.dataDirectory environment variable.  If the environment variable is not defined, the default value is %TOMCAT_HOME%/webapps/kinetic-bridgehub/WEB-INF, assuming Apache Tomcat is the web server.

%DATA_DIR%/config this directory will be empty if the application is running with the default settings
%DATA_DIR%/db this directory may not exist if there are multiple Bridgehub instances being clustered

 

Kinetic Filehub

%DATA_DIR% is set based upon the com.kineticdata.filehub.dataDirectory environment variable.  If the environment variable is not defined, the default value is %TOMCAT_HOME%/webapps/kinetic-filehub/WEB-INF, assuming Apache Tomcat is the web server.

%DATA_DIR%/config this directory will be empty if the application is running with the default settings
%DATA_DIR%/db this directory may not exist if there are multiple Bridgehub instances being clustered

 

Kinetic Calendar v2.x

Kinetic Calendar v2 uses the web server file system to store configuration files instead of a database.

%/WEBAPP-DIR%/WEB-INF/web.xml

Provides optional initialization parameters to customize the application.  If not provided, the application assumes default values.

  • encryption.key - key value used when encrypting sensitive values.
  • logs.directory - custom directory to send log output files.  Default value is WEB-INF/logs in the deployed web application directory.
%/WEBAPP-DIR%/WEB-INF/admin.properties Stores the application administrator credentials to access the web consoles.
%/WEBAPP-DIR%/WEB-INF/application.properties Stores the application properties, which defines the configuration directory and the license key.
%Configuration Directory% This value is defined in the WEB-INF/application.properties file.  The calendar configurations are stored within this directory along with the adapter and connection configurations.  The default value is WEB-INF/configuration.
%/WEBAPP-DIR%/themes The themes directory contains any JSP files that may have been added to customize the look of the calendar application.

 

Kinetic Calendar v1.x

Kinetic Calendar v1 uses Remedy to store calendar configurations.  The Remedy connection configuration is stored in a property file on the web server.

%/WEBAPP-DIR%/WEB-INF/classes/KinCal.xml Configuration property values.
%/WEBAPP-DIR%/lang Contains any language translation files that may have been added to localize the calendar application.

 

Kinetic Schedule

%DATA_DIR% is set based upon the DataDirectory configuration property set in the %WEBAPP_DIR%/WEB-INF/classes/properties.xml file.  This value should point outside of %WEBAPP_DIR%.

%/WEBAPP-DIR%/WEB-INF/classes/properties.xml Configuration property values.
%/WEBAPP-DIR%/WEB-INF/classes/license.txt Application license file.
%/WEBAPP-DIR%/resources/lang Contains any language translation files that may have been added to localize the schedule application.
%/WEBAPP-DIR%/themes The themes directory contains any JSP files that may have been added to customize the look of the schedule application.

 

Kinetic Request CE v2.x

%DATA_DIR% is set based upon the com.kineticdata.core.dataDirectory environment variable.  If the environment variable is not defined, the default value is %TOMCAT_HOME%/webapps/kinetic/WEB-INF, assuming Apache Tomcat is the web server.

%DATA_DIR%/config  
%WEBAPP_DIR%/app this directory should contain the 'bundles', 'shared-bundles', and 'root-bundle' subdirectories

 

Kinetic Request RE

%DATA_DIR% is set based upon ???.

%DATA_DIR%/config  
%DATA_DIR%/???  

 

Kinetic Task v4.x

%DATA_DIR% is set based upon ???.

%DATA_DIR%/config  
%DATA_DIR%/consumers  
%DATA_DIR%/db this directory will only exist if Kinetic Task is being run with trial/development Embedded H2 database


Kinetic Task v3.x

%DATA_DIR% is set based upon the DATA_DIRECTORY context-param set in the %WEBAPP_DIR%/WEB-INF/web.xml file.

%DATA_DIR%/config.properties