A full OpenCGA installation requires three configuration files, all of them are written in YAML format:
- configuration.yml: general configuration for different OpenCGA components such as Catalog or Servers
- storage-configuration.yml: storage-related configuration settings to index and query genomic data
The first two files (configuration.yml and storage-configuration.yml) are needed for running the server, while the third one (client-configuration.yml) is required only by CLI and client libraries to interact with the REST or gRPC services. You can find all the configuration files in the conf folder of the OpenCGA installation.
Configuring at run time
After installing OpenCGA you will have to edit the different configuration files. You can find more information about how to do this in the pages in the section:
Configuring at build time with Maven
In order to make easier the deployment we have defined several Maven Properties to automatically set the values when building OpenCGA form source code. These are defined in a default Maven Profile at main OpenCGA pom.xml. Note that you can define several maven profiles at ~/.m2/settings.xml, each of these profiles can set different values for different environments, e.g. test or production cluster can have different hosts or passwords. You can easily activate one profile when building using maven -P option.:
By doing this maven will automatically substitute the maven property value in the corresponding configuration file. For example, in the client configuration file we can find the following section:
Both OPENCGA.CLIENT.REST.HOST and OPENCGA.CLIENT.REST.TIMEOUT will be replaced for the corresponding value in the maven properties in your profile:
The names of the Maven properties have been designed to indicate in which file the property will be injected. Properties starting with OPENCGA.STORAGE will go to storage-configuration.yml while properties starting with OPENCGA.CLIENT will go to client-configuration.yml. The rest of the properties go to configuration.yml.
At this moment this is the default profile at main pom.xml file:
Table of Contents:
- No labels