This project is released under the A-GPL License (see enclosed LICENSE.txt)

---

0 - Credits

This project is heavily based on the official ansible-ubuntu project, released by the MONARC Project.

1 - What's this?

The goal of this project is to help users deploying a small instance of Monarc . By small, I mean that you're interested ONLY in the Monarc-FrontOffice component and you don't want to deploy all the other components (namely: the CFG, BOs and RPX components depicted here).

In short, you simply need to deploy a single FO (FrontOffice), just to start scratching the surface of your RiskAssessment process.

In such a case, this project include a set of ansible playbooks and roles that you can fire towards a freshly launched Debian 13, to get back a running Monarc FrontOffice instance, up-and-running.

2 - How this works?

To get your MonarcFO up-and-running, you simply need to:

1. clone this project;

2. set a MySQL password, by creating a _vault.yml file. A sample _vault.yml.sample is provided, so you can simply adapt it;

3. update the hosts file, by setting proper IP address of the freshly installed Debian 13 box. Eg.:

   [verzulli@XPS monarc_deployer]$ cat hosts
   ---
   all:
      children:
         monarc_standalone:
         hosts:
            10.215.73.119:
         vars:
            www_vhname: "monarcdemo.local"
            instance_name: "monarc@LOCAL"
            emailFrom: "[email protected]"
      vars:
         ansible_connection: ssh
         monarcfo_version: "v2.13.3-p1"
         monarcfo_release_url: "https://github.com/monarc-project/MonarcAppFO/releases/download/{{ monarcfo_version }}/MonarcAppFO-{{ monarcfo_version }}.tar.gz"
         db_user: "mon_user"
         twoFactorAuthEnforced: false
         monarc_enable_statsservice: false
         monarcfo_clean_cache: false
   [verzulli@XPS monarc_deployer]$
   

4. ensure you have SSH PASSWORDLESS ACCESS to your Linux box, and ensure you have NOPASS sudo permissions, like this:

   [verzulli@XPS monarc_deployer]$ ssh [email protected] 'sudo id'
   uid=0(root) gid=0(root) groups=0(root)
   [verzulli@XPS monarc_deployer]$ 
   

Now everything should be ready to fire ansible:

5. launch ansible playbook monarc_setup_fo.yml

[verzulli@XPS monarc_deployer]$ ansible-playbook -u ansible -l monarc_standalone monarc_setup_fo.yml

...and go getting a cup of coffee....

When finished, it should print something like:

[...]
PLAY RECAP ***************************************************************************************************************************************************************
monarc-standalone          : ok=43   changed=37   unreachable=0    failed=0    skipped=0    rescued=0    ignored=0   

[verzulli@XPS monarc_deployer]$

and you're running Monarc-FO should be ready in:

http://monarcdemo.local/

Please note that pre-configured admin account credentials, are the one mentioned in the official guide, namely, at the end of this paragraph