Install DARE

Marketcetera provides binaries that you can use to install the DARE routing server. To install and run DARE locally, follow these steps.

Latest Packages

4.1.1 21-Sep-2023

• Docker
• Linux amd64
• OSX
• Windows x64

MD5 (Marketcetera_docker_4_1_1.tar.bz2) = 49d518623503f7a5f443748745f35784
MD5 (Marketcetera_linux_amd64_4_1_1.sh) = 7f909d74aa44010742794adac664eae2
MD5 (Marketcetera_macos_4_1_1.dmg) = 89e78cf4cf849ff2c96f6201b2d06475
MD5 (Marketcetera_windows-x64_4_1_1.exe) = 3fcf8e1da05661ad88e9d7b75ac2d89d

Prerequisites

To install and run DARE, you need the following:

• The ability to use the command line to navigate directories and run executables
• A directory to put the installation files. Place this where it makes sense for you. If you don't want to install with sudo, put it in your home directory.
• A connection to a database, as described in the following section

Example: configure PostgreSQL

So that it can access persistent data, DARE requires access to an ACID-compliant database. Our recommendation is PostgreSQL.

To set up PostgreSQL for DARE, follow these steps:

1. Install PostgreSQL (if you haven't already) and start the service.

2. Ensure that the database can receive TCP/IP connections from localhost. You can check this in your postgresql.conf file:

   #------------------------------------------------------------------------------
   # CONNECTIONS AND AUTHENTICATION
   #------------------------------------------------------------------------------
   
   # - Connection Settings -
   
   # listen_addresses = 'localhost'     # what IP address(es) to listen on;

   To find and edit your configuration file, refer to the Postgres documentation on Storage file layout and Connections and authentication.

3. Use the psql interface to add a new user and a database. To keep the installer defaults, use the name metc. For example:

   CREATE USER metc WITH PASSWORD 'pw4metc';
   CREATE DATABASE metc WITH OWNER metc;

Steps to Install DARE

1. Download the binary for your operating system.

2. Use your terminal to change to the directory where you downloaded the shell script that contains the binary.

3. Run the script. To do so, either make it executable, or run something like:

   $ bash ./Marketcetera_linux_amd64_4_1_1.sh

If the script succeeds, a Marketcetera install wizard appears on your desktop. Finish the installation with these steps:

1. Accept the agreement.

2. Enter the directory where you want to install.

3. Choose your database. We recommend PostgreSQL, as described in the previous section.

4. Enter the database details (you can probably keep the defaults) along with the DB user and credentials.

5. Type the FIX sender comp ID.

   This ID is usually provided by your broker and does not change. If you are using a simulation broker, you can add any name.

6. Select Next and Finish.

If successful, Marketcetera finishes installing DARE and closes the installer. To confirm it works, start the DARE server.

Start DARE

The DARE server runs on port 9000.

To start DARE, follow these steps:

1. Navigate to the directory where you installed.
2. Run ./startServerComponents.sh.
3. Verify that it's running with tail -f dare/logs/dare-instance1.log. The output should look something like this:

!      Ports in Use      !
+------------------------+
! Port !   Description   !
+------+-----------------+
! 9000 !   RPC Server    !
+------+-----------------+
! 9020 ! DARE Web Server !
+------+-----------------+
! 9030 !   DARE Acceptor  !
+------+-----------------+

25 Sep 2023 14:25:30,222  INFO [pool-4-thread-1] marketcetera.core.HikariMonitor (HikariMonitor.java:137) - HikariPool: active: 0 idle: 10 total: 10 max: 10