MonarcAppFO/wsl/README.md

2.0 KiB

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
  1. Create WSL user (WSL shell)
  2. 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.