MonarcAppFO/wsl/README.md

Development environment for MONARC using WSL

WSL is convenient to use in order to setup your development environment on Windows OS.

WSL data can be accessible using \\wsl$ on File Explorer.

Prerequisites

• You must be running Windows 10 version 2004 and higher (Build 19041 and higher) or Windows 11.
• Virtual Machine Platform and Windows Subsystem for Linux are enabled

In PowerShell as Administrator run this commands

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux -NoRestart

Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -NoRestart

Installation of WSL

1. In PowerShell Launch install

wsl --install -d Ubuntu

2. Create WSL user (WSL shell)
3. Make sure that the Ubuntu distribution is set as default

wsl -s Ubuntu

Deployment of the front office

In WLS shell:

    $ cd ~
    $ git clone https://github.com/monarc-project/MonarcAppFO
    $ bash ./MonarcAppFO/wsl/installFO.sh

Once the VM will be configured by WSL, go to the address in the browser http://localhost/

The username is admin@admin.localhost and the password is admin.

The StatsService service will be configured, launched and accessible onhttp://localhost:5005

Deployment of the front office and back office together

NOTE : If you only want to intall the MONARC front office, just follow the instructions above.

In WLS shell:

    $ cd ~
    $ git clone https://github.com/monarc-project/MonarcAppFO
    $ git clone https://github.com/monarc-project/MonarcAppBO
    $ bash ./MonarcAppFO/wsl/installFull.sh

Once the VM will be configured by WSL:

• MONARC FrontOffice is ready and available at http://localhost
• MONARC BackOffice is ready and available at http://localhost:8080
• Stats service is ready and available at http://localhost:5005

The username is admin@admin.localhost and the password is admin.