-
Notifications
You must be signed in to change notification settings - Fork 8
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* issue-586: fix missing '/' in the studyURL (cherry picked from commit c84df3a) * Update version to 1.13.1 (#590) * 1.14.0-QA (#595) * New version: 1.14.0 * ARACHNE-2541. Fixed selection of deleted datasources * ARACHNE-2541. Reverted Access Denied log * ARACHNE-2541. Fixed selection of deleted datasources * Moved Java migration mechanism to commons (#548) * ARACHNE-2563. Changed order of elements in achilles report (#556) * fixes failed tests (#558) * Fixes Manual datanode creation (#559) * ARACHNE-2552 - Correct text in email to admin (#554) (#564) (cherry picked from commit 89fb264) * ARACHNE-2494 - Soft deleting for ds' tenants (cherry picked from commit 6f7ea00) * ARACHNE-2550 Datanode: DS health check fails (prod env) (cherry picked from commit 211c7e9) * ARACHNE-2564. Added new reg form fields [back_merge] (#568) * fix user reg test * ARACHNE-2591. Fixed failing import of Cohort entity [back_merge] (#576) * ARACHNE-2618. Added default locale equal to US (#580) * Arachne-2598. Added vocabulary_database_schema for PLP * ARACHNE-2610. Replaced string message with constant (#581) * ARACHNE-2607. Added sorting for study participants (#584) * issue-586: fix missing '/' in the studyURL * Update SqlRender version * Adds import of new Estimation and Prediction analyses (#585) * ARACHNE-593. Allow listing and managing manual Node's users from Central (#594) * Implements new CC import (#592) * QA-1.14 * Preserve Analysis sorting order during Study - StudyDTO conversion (#597) (cherry picked from commit a63045e) * Removed duplication of @EnableGlobalMethodSecurity (#599) * QA 1.15.0 (#630) * Study type mandatory - validation message * Disable Heracles analysis type due to dysfunctional Packrat (#634) * Fixes summary info parsing for IRs with multiple target/outcome cohorts (#636) * Removes packrat from IR (#632) * user's workspace should not be visible for inviting experts (#638) * Workspace should not be visible for inviting experts * Workspace should not be visible for inviting experts - code review comments * Hides Pathway analysis type
- Loading branch information
Showing
80 changed files
with
1,024 additions
and
2,155 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1 +1,93 @@ | ||
# ArachneCentralAPI | ||
#Arachne Community Edition build and run manual | ||
|
||
##Prerequisites | ||
For building and run the Arachne please install following applications: | ||
- [Apache Maven 3](https://maven.apache.org/download.cgi) | ||
- [JDK 8](https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) | ||
- [LibreOffice 6](https://www.libreoffice.org/download/download/) - for running the ArachneCentralAPI only | ||
- [Apache Solr 7](http://lucene.apache.org/solr/downloads.html) | ||
- [Postgres DBMS 9.6+](https://www.postgresql.org/download/windows/) | ||
|
||
####Prepare databases: | ||
Please create ohdsi user and 2 databases: arachne_portal and datanode. That can achieved by running following command in psql console: | ||
``` | ||
create role ohdsi with LOGIN password 'ohdsi'; | ||
create database arachne_portal owner ohdsi; | ||
create database datanode owner ohdsi; | ||
``` | ||
|
||
##Getting sources | ||
Arachne network consists of two applications – Datanode and CentralApi. Sources are located in the github repositories. Please checkout: | ||
[ArachneCentralAPI](https://github.com/OHDSI/ArachneCentralAPI) | ||
[ArachneNodeAPI](https://github.com/OHDSI/ArachneNodeAPI) | ||
The latest released version can be found in the master branch. | ||
|
||
##Solr Configuration | ||
Download solr 7 binaries. | ||
Solr configuration is stored in ArachneCentralAPI/solr-config. Please run command to create and configure cores: | ||
``` | ||
solr start -c && \ | ||
solr create_collection -c users -n arachne-config && \ | ||
solr create_collection -c data-sources -n arachne-config && \ | ||
solr create_collection -c studies -n arachne-config && \ | ||
solr create_collection -c analyses -n arachne-config && \ | ||
solr create_collection -c analysis-files -n arachne-config && \ | ||
solr create_collection -c papers -n arachne-config && \ | ||
solr create_collection -c paper-protocols -n arachne-config && \ | ||
solr create_collection -c paper-files -n arachne-config && \ | ||
solr create_collection -c submissions -n arachne-config && \ | ||
solr create_collection -c insights -n arachne-config && \ | ||
solr create_collection -c result-files -n arachne-config && \ | ||
solr create_collection -c study-files -n arachne-config && \ | ||
solr zk upconfig -n arachne-config -d /$PATHTO/ArachneCentralAPI/solr_config -z localhost:9983 && \ | ||
solr stop -all | ||
``` | ||
Start solr application by running following command in the terminal: | ||
``` | ||
solr start -c && \ | ||
solr zk upconfig -n arachne-config -d /$PATHTO/ArachneCentralAPI/solr_config -z localhost:9983 | ||
``` | ||
Solr console should be available at: http://localhost:8983/solr | ||
|
||
|
||
|
||
####Build ArachneCentralAPI and ArachneNodeApi | ||
Arachne application property files contains few configuration profiles. For this manual we use DEV. Please review available options in the: | ||
- ArachneCentralAPI/src/main/resources | ||
- ArachneNodeAPI/src/main/resources | ||
|
||
1. Open command prompt terminal in the ArachneCentralAPI/ folder and run: | ||
mvn clean package -DskipTests -DskipDocker -P dev | ||
|
||
2. Open command prompt terminal in the ArachneNodeAPI/ folder and run: | ||
mvn clean package -DskipTests -DskipDocker -P dev | ||
|
||
Two artifacts should be created: ArachneCentralAPI/target/portal-exec.jar and ArachneNodeAPI/target/datanode-exec.jar which are spring-boot fat jars and contains all the required dependencies. | ||
|
||
####Start ArachneCentralAPI | ||
Create folder and grant RW access: mkdir -p /var/arachne/files/jcr/workspaces. | ||
Arachne applications expect jasypt encryption for passwords. Please generate values using e.g.: | ||
[jasypt online encoder](https://www.devglan.com/online-tools/jasypt-online-encryption-decryption) | ||
|
||
|
||
Start application using following command: | ||
``` | ||
java -jar ArachneCentralAPI/target/portal-exec.jar --office.home=/usr/lib/libreoffice/ --jasypt.encryptor.password=dummy "--spring.datasource.password=ENC(3b0hKjcVNZjGGLwd85Q+tw==)" "--spring.mail.password=ENC(O8Of4J1ejz9r7tZo05CS/Q==)" --portal.urlWhiteList=https://localhost:8080 | ||
``` | ||
spring.mail.password and spring.mail.username contains dummy values in this example, please replace them with your settings, otherwise send mail functionality will not work. Please encrypt email and database passwords with the same jasypt password. You can do it via [online](https://www.devglan.com/online-tools/jasypt-online-encryption-decryption) or via [jasypt cli](http://www.jasypt.org/cli.html) | ||
|
||
ArachneCentralAPI should be available at: https://localhost:8080 | ||
|
||
####Start ArachneNodeAPI | ||
|
||
Arachne DataNodeAPI application at start registers in ArachneCentralAPI. In current scenario it should be running on https://localhost:8080 | ||
|
||
``` | ||
java -jar target/datanode-exec.jar --datanode.arachneCentral.host=https://localhost --datanode.arachneCentral.port=8080 --jasypt.encryptor.password=dummy "--spring.datasource.password=ENC(3b0hKjcVNZjGGLwd85Q+tw==)" "--spring.mail.password=ENC(O8Of4J1ejz9r7tZo05CS/Q==)" --spring.datasource.url=jdbc:postgresql://localhost:5432/datanode | ||
``` | ||
ArachneNodeAPI should be available at: https://localhost:8880 | ||
|
||
|
||
Supply your mail sender configuration parameters otherwise emails will not work. | ||
|
||
You may override any configuration parameter using “--name=value” spring boot notation. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.