Info |
---|
Remove the ole-build.properties from your home directory. |
Commands
Full build
Info Run this from the trunk folder for the very first time to build the dependent projects such as ole-utility.jar etc..
Needed every iteration or whenever there is a version update.
No Format mvn clean install -DskipTests=true
Info CD into ole folder and run the subsequent commands from within.
Generate the local configuration file configured with default values
No Format mvn generate-resources -Plocal
The above command generates the file
No Format ~/.kuali/ole/fs/configuration.properties
- By default, the database vendor is MySQL with the
root
password set toNONE
. - You will need to update this file with the password for the MySQL
root
user on your system
Reset an OLE FS database
No Format mvn clean initialize -Pdb
Property Loading
Info | ||
---|---|---|
| ||
Order of property loading |
- Runtime property resolution is now possible for OLE FS!
- This means the exact same war file can be used for development as well as deployment without altering the binary
- Automatically loaded external configuration files are used to reconfigure the binary with machine specific configuration
- The default external directory used by OLE FS is now based on the system property
user.home
- To change this you only have to override one property -
ole.fs.home
- Properties pointing to other directories needed by OLE FS are expanded into their absolute path at runtime
- This way only a single property needs to be overridden (instead of all of them)
- The following external property locations are automatically checked and loaded, in this order, if they exist
No Format ~/.kuali/ole/fs/configuration.properties
- If the system property
olefs.configuration
is set, the properties file it points to is automatically loaded
- If the property
ole.fs.runtime.property.expansion=true
the following actions are also taken- After loading
classpath:configuration.properties
loadclasspath:olefs-default.properties
- Expand any properties containing placeholders into their fully resolved equivalents
- After loading
Logging
- A default logging configuration is now bundled into OLE FS
- This means logging will work out of the box without requiring you to point OLE FS at an external log4j.properties file
- You can still override the default log4j configuration if desired
set the property
No Format ole.fs.log4j.override=true
- This can be set as a system property
- Or as a property in one of the configuration files that gets automatically loaded
create a log4j.properties containing your custom settings at
No Format ~/.kuali/ole/fs/log4j.properties
- OLE FS will use settings from the custom log4j.properties
- The custom properties file is also monitored by a background thread and reloaded if changes are made
- Going forward, any new logging statements added to OLE FS should use the SLF4J logging api
- If existing code is modified, log4j logging calls should be replaced by SLF4J logging calls
Properties
Info |
---|
System properties are set by specifying the -D parameter in the VM arguments. Ex. -Dolefs.configuration=~/.kuali/ole/fs/custom-configuration.properties - This will tell the app to pick the properties from the above specified location |
...