{% extends "base.html.twig" %}

{% block title %}DWARFG_LONG Overview{% endblock %}

{% block body %}

<div class="container-fluid">
    <div class="row">
        <div class="col-md-12">
            <div class="bgc-white bd bdrs-3 p-20 mB-20">
                <h4 class="c-grey-900"><i class="c-yellow-500 fas fa-question-circle"></i> DWARFG_LONG Overview</h4>
                <hr>
                <p class="text-justify">DWARFG_LONG is a tool that helps you handle your devices. <b>The most basic steps allowing you to properly monitor your devices are: </b></p>
<ol>
	<li> <p class="text-justify"> To connect device to the DWARFG_LONG so that you can work with it, you need to install so-called <b> agent </b> on the device. See <a href="{{ path('admin_help', {page: 'agents'}) }}"> Device agents </a> for more information or jump to the introduction video link below.</p></li>
	<li> <p class="text-justify"> Once you connect some devices, you can inspect all the information provided via agent by entering <i>Details</i> for a device by clicking on <b>Detail</b> button in the <a href="{{ path('admin_devices') }}"> Devices list </a></p> </li>
	<li> <p class="text-justify"> Inspecting each and every device is not very practical and the main usecase for a device administrator is to just see if there are some devices misbehaving. For this purpose you can use <a href="{{ path('admin_dashboard') }}"> the Dashboard </a> that gives overall status broken down into a few indicators and a list of device groups, their state and potential alerts. The Dashboard compiles a lot of information in one place so you may want to read the <a href="{{ path('admin_help', {page: 'dashboard'}) }}"> Dashboard Explained</a> help page so that you can maximize the information potencial offered there.</p></li>
</ol>
                <hr>
                <p class="text-justify">When you know how to use DWARFG_LONG for regular device monitoring, you can setup <b>more advanced and human-convenient functions like alerting and notification:</b> </p>
<ol>
	<li><p class="text-justify"> Instead of proactively monitor the Dashboard, you can <a href="{{ path('admin_help', {page: 'notifications'}) }}"> setup notifications </a> so that DWARFG_LONG would be able to notify you when something goes out of the ordinery. As of DWARFG_LONG 1.0, the e-mail and Slack notification channels are suported. </p></li>
	<li><p class="text-justify"> To detect when something goes out of the ordinary, DWARFG_LONG use so-called alerts. An alert is triggered when conditions are met. DWARFG_LONG comes with a few pre-defined alerts. While these may be just okay for you, you may deactivate these alerts and define your own at the <a href="{{ path('admin_alerts')}}"> alert table </a> More details about how does the alerting work and how to setup your own alert, please follow to <a href="{{ path('admin_help', {page: 'alerts'}) }}"> help on Alerts </a></p></li>
	<li><p class="text-justify"> An important and useful concept to not miss here are the Monitoring Groups. Monitoring Groups allows you to segment your devices, thus e.g. setting a different alerts for the all-present devices (cellular routers that should be 100% online) and another alert for desktop machines (that can e.g. be taken down for several days without causing an alert).</p> <p class="text-justify"> Also, every Monitoring Group gets automatically listed on the Dashboard, thus allowing for a quick overview. Don't forget about the omnipresent <b><i>All devices</i></b> Monitoring group that allways allows for a system-wide alert definition. </p> <p class="text-justify"> Visit <a href="{{ path('admin_help', {page: 'monitoringGroups'}) }}"> quick help on Monitoring groups </a> to learn more about them.</p>
</ol>
                <hr>
                <p class="text-justify"> Once you are happy with the monitoring setup, you may want to <b>manage your devices via DWARFG_LONG</b>. While a bit more detailed information is given in the <a href="{{ path('admin_help', {page: 'deviceConfig'}) }}"> Configuring devices </a> help section, the following provides an overview of the options provided: </p>
<ol>
	<li><p class="text-justify"> Direct management functions differ per device type. E.g. for Advantech cellular routers, DWARFG_LONG is able to perform reflash of the Firmware. You may request a reflash to be performed for any firmware version that is known, available and approved by administrator. Follow to <a href="{{ path('admin_help', {page: 'firmwares'}) }}">How to manage Firmware</a> to find out more.</p></li>
	<li><p class="text-justify"> Via the WebTunnel functionality, you are able to access the device local web interface and thus able to perform any regular management function like you would directly connect to the device. This functinality depends on complete ssh client being installed on device. By default, Linux distributions and e.g. Advantech routers do contain such ssh client. For other device types (Teltonika routers, OpenWRT devices), you may need to replace the limited ssh client there with a fully-featured one to make Webtunnels functionality operational from the device end. Follow to the <a href="{{ path('admin_help', {page: 'webTunnels'}) }}"> How to manage WebTunnels </a> to learn about how to explore this feature.</p></li>
	<li><p class="text-justify"> As for the automation functionality area, DWARFG_LONG offers the automated device agent deployment (available for all device types), agent profiles (any device type as well, see <a href="{{ path('admin_help', {page: 'agentProfiles'}) }}"> Agent profiles </a>) device configuration cloning (Advantech routers only) and also Analytics functions like Changes Tracker and Traffic Calculation. Configuration cloning is covered under the <a href="{{ path('admin_help', {page: 'deviceConfig'}) }}"> Configuring devices </a> section.</p></li>
</ol>
<p class="text-justify">To complete the basic overview of DWARFG_LONG you should keep in mind that whenever there is a topic you need some help with, there is in-app help, accessible either from the top bar via the help icon that would bring you to the <a href="{{ path('admin_help', {page: 'compendium'}) }}">DWARFG_LONG Resources Compendium</a> or via a contextual help icon situated directly next to the topic/feature name. Also, you may access any help page directly from the left menu under the Help section. In case you would experience a situation needing some troubleshooting, please remember that there is a <a href="{{ path('admin_help', {page: 'troubleshooting'}) }}"> dedicated troubleshooting help section </a> that could give you a hand or at least point you to additional resources.</p>
                </div>
            </div>
        </div>
    </div>

{% endblock body %}