Skip to main content

Quick Start Guide

info

You can also find a detailed quick start guide and a video demo in TimeBase Crypto Connectors GitHub repository.

Step 1: Start TimeBase

Run TimeBase in a Docker container.

tip

You can also make this step using TimeBase Installer.

Code example
docker run --rm -d \ 
-p 8011:8011 \
--name=timebase-server \
--ulimit nofile=65536:65536 \
finos/timebase-ce-server:6.1.9

Step 2: Generate Sample Data

Run the following command to generate a sample data into a new stream called "bars".

Start TimeBase Shell CLI
docker exec -it timebase-server /timebase-server/bin/tickdb.sh
Run the following commands in TimeBase Shell to generate sample data
set db dxtick://localhost:8011 
open
generate bars
exit
tip

You can also make this step using TimeBase Installer.

info

Please refer to TimeBase Tutorial for more information.

Step 3: Dependencies

info

Refer to Client Libraries to get artifacts repositories for clients.

Install the required dependencies.
//Gradle for Java  
dependencies {
api "org.finos.timebase-ce:timebase-client:6.0.21"
api "org.finos.timebase-ce:timebase-api:6.0.21"
api "org.finos.timebase-ce:timebase-pub:6.0.21"
api "org.finos.timebase-ce:timebase-aerondirect:6.0.21"

api "com.epam.deltix:containers:3.1.2"

implementation "com.epam.deltix:timebase-lang:6.0.61"
implementation "com.epam.deltix:timebase-util:6.0.61"
implementation "com.epam.deltix:timebase-messages:6.0.61"
implementation "com.epam.deltix:timebase-collections:6.0.61"
implementation 'com.epam.deltix:dfp:0.11.01'
implementation "com.epam.deltix:gflog-api:3.0.1"
}

info

Please refer to TimeBase Tutorial for more information.

Step 4: Read Data

Create a TimeBase Cursor to read data from a sample stream.

package deltix;
import deltix.qsrv.hf.tickdb.pub.*;

public class ReadStream {
public static void main(String[] args) {
DXTickDB db = TickDBFactory.createFromUrl ("dxtick://localhost:8011");
db.open (false);
DXTickStream stream = db.getStream("bars");

try (TickCursor cursor = stream.select(Long.MIN_VALUE, new SelectionOptions(true, false))) {
while (cursor.next()) {
System.out.println(cursor.getMessage());
}
}
}
}
info

Refer to Client Libraries to view more samples.

info

Please refer to TimeBase Tutorial for more information.

Step 5: Manage TimeBase in Admin Application

TimeBase Web Admin is a Web client you can use to manage TimeBase.

tip

You can also make this step using TimeBase Installer.

  1. Launch TimeBase Admin in a Docker container. Refer to Docker Compose to lauch TimeBase Server together with Web Admin.
  2. Get an official Docker image.
  3. Open TimeBase Admin to view sample streams.
tip

TimeBase Web Admin default credentials: admin/admin.

docker run --rm -d \ 
--name timebase-admin \
--link timebase-server:timebase \
-p 8099:8099 \
-e "JAVA_OPTS=-Dtimebase.url=dxtick://timebase:8011" \
--ulimit nofile=65536:65536 \
epam/timebase-ws-server:1.0
info

Refer to TimeBase Admin Deployment for more information.

Samples

info

Refer to Client Libraries for more information.

Solution Generator

Use TimeBase Solution Generator (Solgen) to generate ready-to-go code samples in several supported languages.

TimeBase Deployment Options

In the Deployment section you may find various TimeBase deployment options.