This is a lite, open-source version of the kraken.
This repository depends on a git submodule, kraken-common, so it is important to correctly initialize it immediately after cloning, to avoid compilation errors.
To do so, launch the following commands:
git clone git@github.com:icure/kraken-lite.git
cd kraken-lite
git submodule init
git submodule update
./gradlew :lite-core:buildAfter that, if the operation completes successfully, the repository and all its submodules will be correctly initialized.
If you are migrating from a version of the sdk that is less than 8 to the SDK v8 or greater, there are some properties that need to be added for the kraken-lite to work correctly.
By default, the new CouchDB views required by the SDK v8 are not enabled. To enable them, add this property when running the kraken-lite:
-Dicure.dao.useDataOwnerPartition=trueYou can set this property at any time by calling the following endpoint:
curl -v -X PUT http://localhost:16043/rest/v2/icure/lite/config/useDataOwnerPartition/falseSome views were moved to the Maurice partition, and so they will not be usable until the partitioned design Docs finish indexing. However, the old views are kept in the default design document for compatibility. If you don't want to force the indexation of the Maurice views, you can enable the redirection to the compatibility views by setting the following property:
-Dicure.dao.useObsoleteViews=trueYou can set this property at any time by calling the following endpoint:
curl -v -X PUT http://localhost:16043/rest/v2/icure/lite/config/useObsoleteViews/falseWhen a new view is created, CouchDB will start the indexation process in background. You can control the number of workers allocated to indexation by setting the following property (default is 1):
-Dicure.dao.backgroundIndexationWorkers=<ANY_NUMBER>The more workers, the faster the views will index but also more resources will be used. You can change the number of workers for indexation at any time, by calling the following endpoint:
curl -v -X PUT http://localhost:16043/rest/v2/icure/couchdb/config/ken/batch_channels?value=<ANY_NUMBER>If you are using an old couchdb version, then the indexation of the views will not happen in background. In this case,
you can force the indexation of the views at startup by setting the following option to true:
-Dicure.dao.forceForegroundIndexation=trueYou can also specify a limited set of Design Documents to index at startup. You can provide them as a comma-separated list to the following property
-Dicure.dao.viewsToIndexAtStartup=Code_Maurice,Contact_DataOwnerThe syntax for each element in the property is {nameOfTheEntity}_{nameOfThePartition}.
To trigger the foreground view indexation for any entity, you have to make a POST request towards the following endpoint
http://localhost:16043/rest/v2/icure/dd/<ENTITY_NAME>?warmup=true where <ENTITY_NAME> is the name of the entity
which Design Documents you want to index.
For example, if you want to index the Design Documents for the Contact entity, you can do so by using the following call
curl -X POST http://localhost:16043/rest/v2/icure/dd/Contact?warmup=trueThis will trigger the indexation and warmup (for older CouchDB versions) for all the Design Documents of the Contact entity of any partition.
All the endpoints on kraken-lite needs authentication. The only endpoints that can be accessed without authentication are:
/rest/*/auth/login
/rest/*/auth/refresh
/rest/*/auth/invalidate
/rest/*/user/forgottenPassword/*
/rest/*/icure/v
/rest/*/icure/p
/rest/*/icure/check
/rest/*/icure/okBy default, only HCP users can use the authenticated endpoints. To allow also other types of users (e.g. patients, devices) to authenticate, you have to set the following property to true:
-Dicure.security.allowOnlyHcp=trueTo include SAM and Kmehr module, two steps are needed:
When building the -Dicure.optional.regions=be option should be set:
./gradlew -x test :lite-core:build -Dicure.optional.regions=beWhen running the generated jar, the spring profiles kmehr (to include kmehr module) and sam (to include the SAM module) should be added:
-Dspring.profiles.active=app,kmehr,samWhen SAM module is activated, three options can be provided:
-Dicure.couchdb.sam.suffix=v5-Dicure.couchdb.sam.nextVersionSuffix=v6-Dicure.sam.updaterUrl=https://drugsv6.icure.cloud
In the above configuration, the drugs will be obtained from an icure-drugs-v5 database but a new icure-drugs-v6 database will be created and updated to prepare for a switch. The icure-drugs-v6 will not be automatically indexed. It is of your responsibility to either set KEN or to call the views to trigger the indexing. To activate the switch you must restart kraken-lite with the following options
-Dicure.couchdb.sam.suffix=v6-Dicure.sam.updaterUrl=https://drugsv6.icure.cloud
When running the kraken-lite through IntelliJ, it fails to rebuild it before running including the Kmehr and SAM libraries
even if the properties have been set.
To circumvent this problem and run the kraken-lite from IntelliJ, navigate to the lite-core subproject and open the
build.gradle.kts file.
Inside it, at the very end, you will find this function:
fun DependencyHandlerScope.injectOptionalJars() {
val regions = System.getProperty("icure.optional.regions")?.lowercase()?.split(",") ?: emptyList()
if (regions.contains("be")) {
implementation(liteLibs.samModule)
implementation(liteLibs.kmehrModule)
implementation(liteLibs.bundles.kmehrDependencies)
}
}Update it to bypass the check on the region property to include the dependencies:
fun DependencyHandlerScope.injectOptionalJars() {
val regions = System.getProperty("icure.optional.regions")?.lowercase()?.split(",") ?: emptyList()
if (regions.contains("be") || true) {
implementation(liteLibs.samModule)
implementation(liteLibs.kmehrModule)
implementation(liteLibs.bundles.kmehrDependencies)
}
}In order to use external design documents, two steps are required:
All the external views must be signed, as specified in the external views template repository.
To add the public key to verify the signature, the following property must be set in the application-app.properties file:
-Dicure.couchdb.external.loading.publicSigningKey=<THE_PUBLIC_KEY>It is possible to set up multiple source as external repositories for views, as long as they follow the external views template repository.
To set them up, you must define multiple properties with the prefix icure.couchdb.external.repos + the partition name, where
the value is the github URL of the repository (that must be public) up to the branch name:
-Dicure.couchdb.external.repos.PartitionOne=https://github.com/icure/external-design-doc-template/main -Dicure.couchdb.external.repos.AnotherPartition=https://github.com/icure/an-external-repo-for-views/mainTo add plugin jars, put them into a single folder. Then, set the following property to that folder:
-Dicure.lite.plugins.sourceFolder=/path/to/plugin/folderTo use kraken-lite with a kraken cloud CouchDB database, you have to start it with the following options:
-Dicure.couchdb.username=<YOUR_GROUP_USERNAME>
-Dicure.couchdb.password=<YOUR_GROUP_PASSWORD>
-Dicure.couchdb.prefix=icure-<YOUR_GROUP_NAME> # Notice the `icure-` prefix before the group name
-Dicure.couchdb.url=<REMOTE_COUCHDB_URL>
-Dicure.couchdb.populateDatabaseFromLocalXmls=false
-Dicure.objectstorage.icureCloudUrl=http://127.0.0.1:16043If you are getting this issue, this means that kraken-lite is not able to find some classes that are auto-generated upon build. To ensure that they exist, run the following commands in the project directory:
./gradlew clean
./gradlew :kraken-common:mapper:kspKotlinIf the commands complete successfully, the filter will be generated, and you will be able to start the kraken-lite.