.. _installlhcbwebapp:

==========================
Installing LHCbWebAppDIRAC
==========================

The installation requires two steps:

#. Install the machine:

The machine should be installed using the ``webportal`` puppet template. LHCbWepAppDIRAC is using ``Nginx`` for better performance, which is also puppetized.
The main configuration file used to install ``Nginx`` can be found `in this gitlab repository <hhttps://gitlab.cern.ch/ai/it-puppet-hostgroup-volhcb/-/blob/master/code/manifests/diracvobox/webportal/nginx.pp>`_ .
The ``site.conf`` configuration file is used for handling the user requests and pass to the ``Tornado`` based LHCbWebAppDIRAC component. The configuration file can be found in `this repository <https://gitlab.cern.ch/ai/it-puppet-module-dirac/-/blob/qa/code/templates/site.conf.erb>`_ .

#. Installing LHCbWebAppDIRAC extension::

    cd /home/dirac
    curl -O https://raw.githubusercontent.com/DIRACGrid/DIRAC/integration/Core/scripts/install_site.sh
    chmod +x install_site.sh
    Edit install_site.sh add the Release = <version>
    ./install_site.sh install.cfg

Note: install.cfg file must exists in the /home/dirac directory, and it is also generated by puppet.

NOTEs:

* You may need to execute the commands above more than once (for example if you change the certificate).
* Most probably, it may not work. Ask Joel to create the correct dirac.cfg file. The dirac.cfg file content must be the same as the existing web machine.