Docker

TimeBase Community Edition starts from TimeBase version 6.0.

• Install Docker
• Run container with TimeBase Server image timebase-server

# create a user-defined network
docker network create --driver bridge timebase-network

# make sure the network was created
docker network ls

# run the timebase server container
docker run --rm -d \ 
   --network timebase-network
   -p 8011:8011 \ 
   --name=timebase-server \ 
   --ulimit nofile=65536:65536 \ 
   finos/timebase-ce-server:6.1.9

TimeBase Web Admin

In TimeBase Web Admin you can manage and monitor all data stored in TimeBase.

1. Launch TimeBase Admin in a Docker container.
2. Get an official Docker image.
3. Open TimeBase Admin to view sample streams.

# make sure the timebase-network was created
docker network ls

# run the timebase web admin container
docker run --rm -d \ 
   --name timebase-admin \
   --network timebase-network
   -p 8099:8099 \ 
   -e "JAVA_OPTS=-Dtimebase.url=dxtick://timebase-server:8011" \
   --ulimit nofile=65536:65536 \
   epam/timebase-ws-server:1.1

info

Refer to TimeBase Web Admin to learn how to run and use this application.

Advanced Options

Attached Volume with Streams or a Custom Config

docker run --rm -d \ 
   -p MACHINE_PORT:8011 \ 
   --name=CONTAINER_NAME \ 
   --ulimit nofile=65536:65536 \ 
   -v VOLUME:/timebase-home \ 
   finos/timebase-ce-server:VERSION

• VOLUME - PATH to local TimeBase home volume with populated files such as Streams, Configs, etc.
• MACHINE_PORT - port on your machine that will be used for TimeBase.
• CONTAINER_NAME - the name of TimeBase container that will be shown in containers list docker ps.
• VERSION - TimeBase image version (tag), use tag latest for the latest version.

Example

It is strongly recommended defining a specific version instead of the latest.

docker run --rm -d \ 
   -p 80:8011 \ 
   --name=timebase-prod \ 
   -ulimit nofile=65536:65536 \ 
   -v /home/master/timebase:/timebase-home \ 
   finos/timebase-ce-server:6.1.9

Custom config

You can configure selected TimeBase properties in admin.properties configuration file and place it in /home/master/timebase folder. Mount this folder to use admin.properties configurations:

-v /home/master/timebase:/timebase-home \  

In admin.properties you can configure host, port, version, and other TimeBase parameters.

Example

# Example of admin.properties file
TimeBase.host=localhost
TimeBase.port=8011
TimeBase.version=5.0
TimeBase.enableRemoteAccess=true

Useful Scripts and Commands

• docker logs CONTAINER_NAME - will show TimeBase logs. Use flag -f to follow log output.
• docker images - show all images that downloaded in your system. To clear old/unused images use the command docker system prune -a -f.
• docker stats - display a live stream of container(s) resource usage statistics.
• docker exec -it CONTAINER_NAME sh - logging into the container's file system using sh shell.

Deployment with SSL

info

Refer to Deployment with SSL for more information.