Installation From Source Code

Prerequisites

In addition to the runtime dependencies (see runtime dependencies), the following components are required to build ToroDB Stampeded from the sources.

Description External links
Git It is the distributed version control system (DVCS) used to mange ToroDB Stampede source code. more info
Apache Maven The build tool used by ToroDB Stampede. more info
Docker A container management tool for Linux. It is used to test ToroDB Stampede. more info
Docker Compose A tool for defining and running multi-container Docker applications. It allow to run test scenarios like a ToroDB Stampede replicating from a MongoDB and connected to a PostgreSQL. more info

Linux/macOS

Download source code using Git:

cd /tmp

git clone https://github.com/torodb/stampede.git

Compile source code and build the distribution using Apache Maven:

cd stampede

mvn clean package -P assembler,prod

Create the .toropass file in the home directory (be sure the put the right password in):

echo "localhost:5432:torod:torodb:<password>" > ~/.toropass

Extract and launch ToroDB Stampede (replace $TOROHOME with the desired ToroDB Stampede installation directory).

cd "$TOROHOME"

tar xjf "$TOROHOME/stampede/main/target/dist/torodb-stampede-*.tar.bz2"

torodb-stampede-*/bin/torodb-stampede

Development branch

If you want to compile the devel branch (where version in pom has a -SNAPSHOT suffix) you will have to get the parent pom of the project from sonatype repository. This can be achieved by the following command (run it in a folder where no pom.xml is present or it may fail):

mvn org.apache.maven.plugins:maven-dependency-plugin:2.4:get \
  -DremoteRepositories=https://oss.sonatype.org/content/groups/public \
  -Dartifact=com.torodb:parent-pom:1.0.1-SNAPSHOT:pom

Windows

Download source code in a temporary directory:

C:\tmp\>git clone https://github.com/torodb/stampede.git

Compile source code and build the distribution using Apache Maven:

C:\tmp\>cd stampede

C:\tmp\stampede>mvn clean package -P assembler,prod

Create the .toropass file in the home directory (be sure the put the right password in):

localhost:5432:torod:torodb:<password>

Decompress the Zip file in C:\tmp\torodb\stampede\main\target\dist\torodb-stampede-<version>.zip (replace %TOROHOME% with the desired ToroDB Stampede installation directory) and execute the following command:

C:\>%TOROHOME%\bin\torodb-stampede

Alternatively, double-click on the torodb-stampede.bat file in the bin folder.

Development branch

If you want to compile the devel branch (where version in pom has a -SNAPSHOT suffix) you will have to get the parent pom of the project from sonatype repository. This can be achieved by the following command (run it in a folder where no pom.xml is present or it may fail):

C:\tmp>mvn org.apache.maven.plugins:maven-dependency-plugin:2.4:get \
  -DremoteRepositories=https://oss.sonatype.org/content/groups/public \
  -Dartifact=com.torodb:parent-pom:1.0.1-SNAPSHOT:pom