1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
|
# GenomicsDB - Build and Install
Experimental scripts to build and install GenomicsDB libraries and tools.
## JVM
GenomicsDB jars bundled with pre-built native libraries are regularly published to [](https://mvnrepository.com/artifact/org.genomicsdb). These artifacts can be included as dependencies appropriate to the build(maven/gradle/sbt) system in use. See [Examples](../example/java/) on java/spark usage.
## Bash
Scripts [install_prereqs.sh](prereqs/install_prereqs.sh) is meant to work with Docker, but should work on any Linux distribution from a bash shell. Most of the code is self-explanatory, feel free to modify the scripts as desired. Note that [install_prereqs.sh](prereqs/install_prereqs.sh) requires sudoable access.
```bash
# Install the prerequisites to build GenomicsDB and create a genomicsdb_prereqs.sh in $HOME
sudo prereqs/install_prereqs.sh
source $HOME/genomicsdb_prereqs.sh
cmake -DCMAKE_INSTALL_PREFIX=$HOME /path/to/GenomicsDB # simplest
# Build and install the include/lib/bin files to $HOME
make && make install
```
## Docker
To build and install GenomicsDB using Docker, specify the following *optional* build arguments
| Build Argument | Default |
| --- | --- |
| os=ubuntu:trusty\|centos:7\|\<linux_base:ver\> | centos:7 |
| user=<user_name> | genomicdb |
| install_dir=<my_install_dir> | /usr/local |
| distributable_jar=true\|false | false |
| enable_bindings=java | none |
Note that the Dockerfile is at the repository root so all the example commands below should be executed there.
Examples:
```
docker build --build-arg os=ubuntu:trusty --build-arg install_dir=/home/$USER -t genomicsdb:build .
```
To run and enter the bash shell:
```
# Use the -t argument value used with docker build ...
docker run -it genomicsdb:build
```
To build and copy all built artifacts from the docker image:
```
export docker_os=centos
export docker_repo=genomicsdb
export docker_tag=`date "+%Y-%m-%d-%H:%M:%S"`
docker build --build-arg os=$docker_os --build-arg install_dir=/tmp/artifacts -t $docker_repo:$docker_tag .
docker create -it --name genomicsdb $docker_repo:$docker_tag bash
docker cp genomicsdb:/tmp/artifacts $docker_os
docker rm -fv genomicsdb
```
|
