documentation:software:atlas:setup
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
documentation:software:atlas:setup [2016/08/19 15:42] jhardin |
documentation:software:atlas:setup [2019/05/30 20:47] (current) anthonysena |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ~~NOTOC~~ | ~~NOTOC~~ | ||
| - | ===== ATLAS Setup ===== | + | ===== IMPORTANT NOTE ===== |
| + | |||
| + | All ATLAS documentation has moved to [[https://github.com/OHDSI/ATLAS/wiki|GitHub]]. Please disregard the content below as it is legacy and kept for posterity. | ||
| + | |||
| + | ===== ATLAS Setup (LEGACY) ===== | ||
| The following sections detail the process for setting up Atlas and its dependencies. | The following sections detail the process for setting up Atlas and its dependencies. | ||
| Line 8: | Line 12: | ||
| === WebAPI === | === WebAPI === | ||
| - | The first prerequisite for ATLAS is to [[documentation:software:webapi:setup|Install the OHDSI WebAPI]] and configure the appropriate sources. The following figure provides an example topology to show the different elements involved in the WebAPI architecture and a visual representation of the [[documentation:software:webapi:source_configuration|source configuration]]. | + | The first prerequisite for ATLAS is to [[documentation:software:webapi:webapi_installation_guide|Install the OHDSI WebAPI]] and [[documentation:software:webapi:source_configuration|configure the appropriate sources]]. |
| - | + | ||
| - | **Note:** The example above does not represent a physical architecture. The WebAPI configuration allows you to physically and logically segregate these data sources based on the requirements of your environment. | + | |
| === ACHILLES === | === ACHILLES === | ||
| - | To use the [[documentation:software:atlas:data-sources|Data Sources]] feature within ATLAS you must first [[documentation:software:achilles|setup and execute ACHILLES]] in your environment. Once you have successfully generated summary statistics and have exported your data to JSON format, you are ready to configure ATLAS to use this information. | + | To use the [[documentation:software:atlas:data-sources|Data Sources]] feature within ATLAS you must first [[documentation:software:achilles|setup and execute ACHILLES]] in your environment. Once you have successfully generated summary statistics, you are ready to configure ATLAS to use this information. |
| - | ==== ATLAS Installation ==== | + | **Please note**: If you utilized Achilles prior to v1.4, please refer to the article [[documentation:software:atlas:achilles_v_1_5|Achilles v1.5.0 Dependencies For WebAPI/Atlas]] as Atlas/WebAPI v2.2.0 will require some additions to the Achilles output. |
| + | ==== ATLAS Installation (V2.2.0 and later) ==== | ||
| Begin by downloading the latest release of [[https://github.com/OHDSI/Atlas/releases/latest|ATLAS from GitHub]]. | Begin by downloading the latest release of [[https://github.com/OHDSI/Atlas/releases/latest|ATLAS from GitHub]]. | ||
| Line 23: | Line 26: | ||
| http://<your_webserver>/atlas | http://<your_webserver>/atlas | ||
| - | Under the Atlas root folder, edit the file /js/config.js to configure the following properties: | + | Under the Atlas root folder, create the file /js/config-local.js to configure the application. **Please note: the file /js/config-local.js is __not__ included in the Atlas repository. This is by design so that you may have environment-specific configuration. ** Config-local.js will override the settings found in /js/config.js as shown here: |
| <code javascript> | <code javascript> | ||
| define([], function () { | define([], function () { | ||
| - | var config = {}; | + | var configLocal = {}; |
| - | config.services = [{ | + | |
| - | name: '<YOUR ENVIRONMENT NAME>', | + | configLocal.api = { |
| - | url: 'http://your_webserver/WebAPI/' | + | name: 'My Organization Name', |
| - | }]; | + | url: 'https://webapi.server.com/WebAPI/' |
| - | + | }; | |
| - | config.webAPIRoot = config.services[0].url; | + | |
| - | + | return configLocal; | |
| - | config.dataSourcesLocation = '/achilles/data/datasources.json'; | + | |
| - | config.dataSourcesRoot = '/achilles/data'; | + | |
| - | + | ||
| - | return config; | + | |
| }); | }); | ||
| </code> | </code> | ||
| - | config.services: Edit this array to provide a name for your environment and the URL for the WebAPI that was set up in WebAPI section. | + | In the example above, the /js/config-local.js overrides the corresponding ".api" property found in /js/config.js and allows for custom configuration for your environment. The same pattern can be used to override the other settings in /js/config.js. |
| - | + | ||
| - | config.dataSourcesLocation & config.dataSourcesRoot: If you have set up your CDM statistics (Achilles), these properties should be set to the URL where your CDM statistics resides. In the configuration below, we are using a relative path since we assume you have hosted your CDM statistics on the same web server as ATLAS but under a different directory. | + | |
| - | You should now be able to navigate to ATLAS from your web browser. | + | Once this is complete, you should now be able to navigate to ATLAS from your web browser. |
| http://<your_webserver>/atlas | http://<your_webserver>/atlas | ||
| + | ==== ATLAS Installation Archive ==== | ||
| + | [[documentation:software:atlas:archive:atlas_setup_v1_x|ARCHIVE: ATLAS Setup (v2.1 or earlier)]] | ||
documentation/software/atlas/setup.1471621369.txt.gz · Last modified: 2016/08/19 15:42 by jhardin
Page Tools
