Skip to main content

Installer

Supported Versions​

The installer supports the Windows, Linux, and MacOS platforms.

Running Installer​

To launch the installer:

  • Run the installer jar without parameters.

    java -jar deltix-windows-installer-online-<version>.jar

If you have a GUI-based operating system, the installer opens in the User Interface (UI) mode. For instructions on using UI mode for installation, see the UI Installer section.

If you have a headless operating system, the installer opens in console mode. For instructions on using console mode for installation, see the Command Line Installer section.

info

By default, running the installer requires administrator privileges. To find out how to run the installer without admin rights, refer to the Administrator Privileges section.

Console Mode​

To launch console mode, use the -console command line parameter with the installer jar: 

java -jar deltix-windows-installer-online-<version>.jar -console

Automation Mode​

On the last installation step in the interactive UI and console modes, you have the option save your installation script. Saving your script generates the auto-install.xml file, which the automation mode uses in future installations.

Automation mode silently runs the installer and retains the choices you made during the original installation. You can use this mode to deploy Deltix products on multiple machines.

Save Automation Script​

If using the interactive UI installer:

  • On the Installation Finished step, click Generate an automatic installation script.

If using the command line installer:

  • On the Installation Finished step, respond Y to the following prompt.

    -----------------------------------------
    Generate an automatic installation script
    -----------------------------------------
    Enter Y for Yes, N for No:
    Y

Run Automation Mode​

To run the automation mode, specify auto-install.xml (the properties file for automation mode) to the installer jar as a command line parameter: 

java -jar deltix-windows-installer.jar auto-install.xml

UI Installer​

Download and run TimeBase Installer. Use the following procedure to setup TimeBase on your machine.

You can also install TimeBase in Docker by following our Quick Start guide.

tip

TimeBase Installer requires Java 11 or newer to be installed on your machine.

Step 1: Launch Installation​

To launch the installer:

  1. If you haven't already, execute the following command: 

    java -jar deltix-windows-installer-online-<version>.jar

    The welcome window appears.

  2. Click Next.

Step 2: Licensing​

Accept the license agreement and click Next.

Step 3: Installation​

  1. Select the TimeBase installation folder and click Next.

  2. Enter your license key.

  1. Specify any other additional information.

Step 4: Deltix Components​

  1. Select other Deltix products you wish to install.
  2. Click Next to run the installation.

Step 5: Run TimeBase​

You have the option to save your selections for future installations by generating an automatic installation script. For more information on this option, see the Automation (Silent) Mode section.

Once the installation is completed successfully, you can launch QuantServer Architect.

Command Line Installer​

This section provides instructions on launching the command line installer, as well as the prompts you'll encounter in the installer along with the recommended responses.

Step 1: Launch Console​

To launch the command line installer, run one of the following commands that corresponds to your system.

Windows​

java -jar deltix-windows-installer-online-<version>.jar -console

On Windows systems, a new console window opens after you enter these commands.

Linux & MacOS​

java -jar deltix-linux-installer-online-<version>.jar -console

Step 2: Target Path​

When prompted for an installation path:

  • If you are installing TB for the first time, manually enter the path C:\Deltix\QS.
  • If you have performed an installation before, the previous path automatically appears.
Select the installation path: []
C:\Deltix\QS
-------------------------------------------------
Message

The target directory will be created:
C:\Deltix\QS
-------------------------------------------------
Enter O for OK, C to Cancel:
O

Press 1 to continue, 2 to quit, 3 to redisplay
1

Step 3: Serial Number & JDK​

  1. When prompted for a serial number:

    • If you are installing TB for the first time, manually enter the serial number provided to you by the Deltix team.
    • If you have performed an installation before, the previous serial number automatically appears.
    Serial number: [****]

  2. Enter 0 to decline the HTTP proxy and 1 to continue.

    [ ] Use HTTP Proxy to connect license server
    Enter 1 to select, 0 to deselect:
    0

    Press 1 to continue, 2 to quit, 3 to redisplay
    1

  3. Choose a JDK by entering the corresponding number.

    You can download JDK from https://adoptopenjdk.net
    Specify JDK:
    0  [x] Not Specified
    1  [ ] + Add JDK
    2  [ ] JDK 8.0.152.16 (C:\Program Files\Java\jdk1.8.0_152)
    3  [ ] JDK 11.0.11.9 (C:\Program Files\Java\jdk-11.0.11+9)
    4  [ ] JDK 11.0.17.8 (C:\Program Files\Java\jdk-11.0.17+8)
    5  [ ] JDK 17.0.1.12 (C:\Program Files\Java\jdk-17.0.1)

Step 4: Installation Name​

Since you can have several installations in the same folder, it's recommended to specify the installation version in the installation name.

Specify Installation Name:
 [5.5.89]
5.5.89
The Installation Name will be used to label program menu items, desktop shortcuts and OS services.
Leave empty to use default Installation Name.

Press 1 to continue, 2 to quit, 3 to redisplay
1

Step 5: Installation Packages​

caution

Selecting Y for the QuantServer pack is required.

Select the packs you want to install:

-----------------------------------------
  [x] Include pack 'QuantServer'
-----------------------------------------
Enter Y for Yes, N for No:
y
--------------------------------------
  [x] Include optional pack 'WebAdmin'
--------------------------------------
Enter Y for Yes, N for No:
y
Done!

Press 1 to continue, 2 to quit, 3 to redisplay
1

Step 6: Finish Installation​

Your installation is confirmed.

====================
Installation started
Framework: 5.1.3-84aaf (IzPack)
Platform: windows,version=10.0,arch=x64,symbolicName=WINDOWS_10,javaVersion=11.0.17
[ Starting to unpack ]
[ Processing package: QuantServer (1/2) ]
Cleaning up the target folder ...
[ Processing package: WebAdmin (2/2) ]
Cleaning up the target folder ...
[ Unpacking finished ]
Installation finished

You have the option to save your selections for future installations by generating an automatic installation script. For more information on this option, see the Automation (Silent) Mode section.

-----------------------------------------
Generate an automatic installation script
-----------------------------------------
Enter Y for Yes, N for No:
Y

Additional Parameters​

Administrator Privileges​

The QS_INSTALL_UNPRIVILEGED property determines the privilege level required to run the installer. By default, running the installer requires administrator privileges.

To allow users to run the installer without admin rights, set QS_INSTALL_UNPRIVILEGED to true.

  • On Linux, use: 

    export QS_INSTALL_UNPRIVILEGED=true

  • On Windows, use: 

    set QS_INSTALL_UNPRIVILEGED=true

To enforce admin privileges to run the installer, set the property to false.

Debug Functionality​

The debug functionality provides the ability to debug your installer.

To run debug mode, launch the installer with the following command:

java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005 -DLicenseClient.timeout=10000 -jar deltix-windows-installer.jar

To debug the installer, use the remote debug configuration in Intellij IDEA.

Logging​

The installer automatically writes the log file into the directory/install.log install file.

To specify a log file, use the -logfile <log_file_path> command line parameter:

java -jar deltix-windows-installer.jar -logfile <log_file_path>

You can also pass a logging configuration file as system property to the JVM calling the installer:

java -Djava.util.logging.config.file=<log.properties> -jar deltix-windows-installer.jar

General Hardware & OS Recommendations​

  1. CPU

    Multi-core Processors: TimeBase leverages multi-threading for data ingestion and query processing. For production deployments, select CPUs with at least 8 cores. Consider clock cycles, bus speed, and cache size when purchasing CPUs. A faster clock speed and faster bus speed typically result in faster performance. Larger cache sizes can also benefit performance.

  2. Memory (RAM)

    Sufficient RAM: TimeBase benefits from large memory allocations for caching and indexing. A minimum of 32 GB RAM is recommended for moderate workloads; scale up to 128 GB or more for enterprise or high-frequency environments. ECC Memory: Use ECC RAM in mission-critical deployments to prevent data corruption and ensure reliability.

  3. Storage

    SSD/NVMe Drives: Fast storage is crucial for TimeBase’s real-time data ingestion and retrieval. Use enterprise-grade SSDs or NVMe drives for both data and log directories. RAID Configuration: RAID 10 is recommended for a balance of performance and redundancy. Capacity Planning: Estimate your data retention and ingestion rates to size storage appropriately, allowing for future growth.

  4. Network

    High Throughput: Deploy at least 1 Gbps network interfaces; 10 Gbps is recommended for clustered or high-ingest environments. Low Latency: Ensure low-latency networking, especially for distributed TimeBase clusters.

  5. Operating System and Security

Windows

64-bit Windows Server: For Windows deployments, use a supported 64-bit Windows Server version for best compatibility and performance.
Regular Updates: Keep the OS and all drivers updated to maintain security and stability.
For low-latency setups make sure that all hardware is correctly tuned.

Linux

Supported Distributions: Use enterprise-grade distributions such as Ubuntu LTS, CentOS, or Red Hat Enterprise Linux.
Kernel Version: Ensure you are running a recent, supported kernel version for optimal hardware compatibility and security.
Regular Updates: Keep the OS and all packages updated, especially security patches.
  1. Security Exclusions for TimeBase

Windows Defender Whitelisting

Windows Defender may impact TimeBase performance by scanning its executables and data directories. To avoid resource contention, whitelist the following:

Executables: 
Add JDK home folder to `Defender` exclusion list.
Add the TimeBase installation folder to the `Defender` exclusion list.

Data Directories:
Exclude the directories where TimeBase stores its data and log files. Usually it's called `TimeBase Home`.

Backup Locations:
If you use scheduled backups, exclude backup directories to prevent scan delays.

How to Add Exclusions in Windows Defender:

Open Windows Security.
Go to Virus & threat protection > Manage settings.
Scroll to Exclusions and select Add or remove exclusions.
Add the relevant files, folders, or processes.

Linux Security Exclusions

On Linux, real-time antivirus solutions (such as ClamAV, Sophos, or others) may also scan database files and impact performance. To avoid this:

Exclude TimeBase Executable and Service Paths:
Add the TimeBase binary and service directories to your antivirus exclusion list 

Exclude Data and Log Directories:
Exclude the directories where TimeBase stores its data and logs

Backup Locations:
Exclude backup directories from real-time scanning.

How to Add Exclusions (Example for ClamAV):

Edit the ClamAV configuration file (e.g., /etc/clamav/clamd.conf) and add:

ExcludePath ^/opt/timebase-home    

Restart the ClamAV service after making changes.

For other antivirus solutions, refer to their documentation for exclusion configuration.

Next Steps & References​

Install TimeBase as a systemd Service on Linux​

For information on installing TimeBase as a systemd service on Linux, refer to the How To page.

TimeBase Shell​

Use TimeBase TickDB Shell CLI to work with streams and run various maintenance and operational commands.

Launch tickdb.cmd from bin TimeBase folder to open TimeBase Shell. Run ? to get a list of available commands.

Solution Generator​

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

Samples​

For available samples, refer to the Client Libraries page.