~~NOTOC~~

===== ARCHIVE: ATLAS Setup (v2.1 or earlier) =====

The following sections detail the process for setting up Atlas and its dependencies.

==== Prerequisites ====

=== WebAPI ===
The first prerequisite for ATLAS is to [[documentation:software:webapi:webapi_installation_guide|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]].

**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 ===
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.

==== ATLAS Installation ====

Begin by downloading the latest release of [[https://github.com/OHDSI/Atlas/releases/latest|ATLAS from GitHub]].

Install the release onto a web server such that the application will be reachable via a URL such as: 

  http://<your_webserver>/atlas

Under the Atlas root folder, edit the file /js/config.js to configure the following properties:

<code javascript>
define([], function () {
  var config = {};
  config.services = [{
    name: '<YOUR ENVIRONMENT NAME>',
    url: 'http://your_webserver/WebAPI/'
  }];
            
  config.webAPIRoot = config.services[0].url;
        
  config.dataSourcesLocation = '/achilles/data/datasources.json';
  config.dataSourcesRoot = '/achilles/data';
 		
  return config;
});
</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.

config.dataSourcesLocation & config.dataSourcesRoot **//(v1.x of Atlas - these configuration settings are no longer required in v2.0)//**: 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. 

  http://<your_webserver>/atlas