Skip to main content

ACTUS Quick Start

GitHub Version

This guide provides a step-by-step approach to quickly set up and use the ACTUS framework using Docker.

Prerequisites

Ensure the following conditions are met before beginning the installation:

  • Docker Desktop is installed and running.
  • The following ports are free and available:
    • 8083: ACTUS service
    • 8082: Risk service
    • 27018: MongoDB

Installation

Follow these steps to install and run ACTUS:

  1. Clone the repository:

    git clone https://github.com/actusfrf/actus-docker-networks
  2. Navigate to the directory where the repository was cloned (actus-docker-networks will be the name of the directory created).

  3. Run the following command to start the Docker containers:

    docker compose -f quickstart-docker-actus-rf20.yml -p quickstart-docker-actus-rf20 up

  4. Verify that the services are running by checking the logs for the following confirmation message:

    Risksrv3Application Started Risksrv3Application in X.XXX seconds

image

Populating the Risk Factor Database

Populate the database with sample risk factor definitions for a US Treasury 5-Year Falling scenario.

  1. Navigate to the test files directory:
    <ROOT-INSTALL-DIR>/actus-docker-networks/test
  2. Run the command to populate the risk database:
    source putUst5Y_falling.txt
  3. Verify successful execution by checking for this message:
    ReferenceIndex added Successfully
  4. Confirm the database population by issuing a curl command:
    curl -v http://localhost:8082/findAllReferenceIndexes

This will display the reference data that has been created and saved.

Running a Sample ACTUS Simulation

To execute an ACTUS simulation using the risk factors sent inline: This is to check that the ACTUS service works (without looking up the risk DB in the ACTUS external risk service)

  1. Run the following command:
   source l3ANNwRF.txt
  1. Upon successful execution, you should see this message:
  "status": "Success"

To execute an ACTUS simulation using the populated data in the risk service DB: This is to check that the ACTUS service in turn calls the ACTUS risk service, and works (looking up the risk DB in the ACTUS external risk service) and using it for the scenario simulation.

  1. Running a test to call the risk server DB and use that to run a scenario simulation:
  source putMSFT_rising.txt
source test/putScn01.txt
  1. Run the scenario simulation:

    source scn01ANNwRF_ss.txt
  2. Upon successful execution, you should see this message:

  "status": "Success"

Completion

Congratulations! You have successfully:

  1. Installed the ACTUS framework.

  2. Populated the database with sample risk factors.

  3. Run an ACTUS simulation.

Visit the ACTUS GitHub Repository periodically for updates and additional resources.