Skip to content

README.md

Latest commit

 

History

History
82 lines (60 loc) · 3.35 KB

README.md

File metadata and controls

82 lines (60 loc) · 3.35 KB

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: "damiano@verzulli.it"
   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 ansible@10.215.73.119 'sudo id'
uid=0(root) gid=0(root) groups=0(root)
[verzulli@XPS monarc_deployer]$

Now everything should be ready to fire ansible:

  1. 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