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

{% block title %}Troubleshooting problems{% endblock %}

{% block body %}

	<style>ul.help li {

			margin-bottom: 8px;
		}</style>

    <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> Troubleshooting problems</h4>
					<hr>
<p class = "text-justify">
While DWARFG_LONG itself is not an overly complicated system, there are multiple parts it consists of. Also, the facts that the devices are external individual pieces of HW+SW and that network communication is never 100% reliable does bring more uncertainty into the mix.
</p>
<p class = "text-justify">
When you are experiencing a problem, your best resources are online. Therefore, a few online links are given below before we continue with some basic advices incorporated into the product.
<ul class="help">
   <li><a href="https://DWARFG_SHORT.dwarftech.cz/wiki">Online DWARFG_LONG resources</a></li>
   <li>If you have at least Basic level of support, you may proceed to the <a href="{{ path('admin_support_redirect')}}"> Support link </a></li>
</ul>
</p>
<p class = "text-justify">
If the online resources are not accessible, you can try to proceed according to the offline troubleshooting steps below to help identify and hopefully also resolve the problem:
<ul class="help">
	<li>Problems logging into DWARFG_LONG?</li>
		<ul><li>Are you able to see the login screen?</li>
			<ul><li>YES: credentials problem - either wrong username/password or a different server. Make sure the credentials has bot been changed, server was not reinstalled and your URL is correct.</li>
			<li>NO: bad URL or server is not running - either HW or OS or configuration problem. Contact your server administrator, service operator (in case of SAAS) or visit <a href="{{ path('admin_support_redirect')}}"> Support link </a></li></ul></ul>
	<li>Is DWARFG_LONG service status red?</li>
		<p class="text-justify">This means that DWARFG_LONG service is either not running or there are reasons blocking the service from working properly.</p>
			<ul><li>Go to the <a href="{{ path('admin_dashboard')}}"> Dashboard </a> and check which of the following applies:</li>
				<ul><li>Dashboard shows only a single red light and no other lights at all</li>
					<ul><li>The DWARFG_LONG daemon (DWARFG_SHORTd) is not running or some other service is blocking its port.</li>
						<ul><li>If you are on SAAS, contact your service operator (contacts are listed on the <a href="{{ path('admin_support_redirect')}}"> Support link </a>)</li>
						<li>If you are using managed deployment, contact your support (contacts are listed on the <a href="{{ path('admin_support_redirect')}}"> Support link </a>)</li>
						<li>If you are managing your own deployment, you need to inspect DWARFG_SHORTd logs (usually /srv/DWARFG_SHORT_&lt;domain&gt;/logs/log_DWARFG_SHORTd.txt but depends on install parameters used)</li></ul></ul>
					<li>The DWARFG_LONG daemon (DWARFG_SHORTd) is not running because your license file got overwritten or you have provided an invalid license file</li>
						<ul><li>Check your lincense on the <a href="{{ path('admin_system_license') }}"><b>System -&gt; License Management</b></a> page.</li></ul></ul>
				<li>Dashboard shows the first (biggest) light as red light but displays also other lights.</li>
					<ul><li>Your problem is probably connected with expired license or other license problem - verify that the third light is red and proceed based on short caption given directly below the light and a longer message below all lights.</li>
					<li>You may also have a look at <a href="{{ path('admin_system_license') }}"><b>System -&gt; License Management</b></a> to get details about your license.</li></ul></ul>
	<li>DWARFG_LONG service status is yellow</li>
		<ul><li>The light being yellow does not automatically mean there is a problem. The yellow light is lit always when one or more of your devices is not in the state that it is expected to be, which can be a sign of some problem but it could also cover a pre-mediated situation. For example, if there is a pending configuration change for any device, the status switches to yellow, indicating that something is not exactly as it should be. Once the device picks up the configuration change and reports it back to the server the light returns to green - everything is as expected.</li>
		<li>To find out the cause of the status light being yellow, go to the <a href="{{ path('admin_dashboard')}}"> Dashboard </a> and check what is the reason.</li>
			<ul><li>The caption directly below the main light should give a clue where is the source of the problem.</li>
			<li>If not clear, orient yourself based on which of the additional four lights is not green:</li>
				<ul><li>The first light represents number of free device slots (allowed by license). In case there are no free slots but no new device registration has been denied, the status is yellow (warning). In case there were registration requests from devices after all the free slots has been taken, the status is red and the counter shows number of declined registration requests as a negative number (since DWARFG_LONG service start). Your options are:</li>
					<ul><li>Upgrade to license with higher number of free slots. If you do not posses such license and would like to request it, please contact your distributor or <a href="https://DWARFG_SHORT.dwarftech.cz/contacts"> Dwarf Technologies </a> if your ditributor is not responding.</li>
					<li>Reduce the number of taken device slots by removing the no-longer valid devices. If you know about devices that have e.g. be removed or reinstalled and should not be taking up a device slot, go to device details and <b>Delete</b> the device.</li></ul>
				<li>The second light represents license status. If your license period is expired, the light goes red. If your license period is about to expire, light goes yellow. If you are on SAAS, contact your service provider. If you manage your own deployment, you need to upload another license. If you would like to request a license, please contact your distributor or <a href="https://DWARFG_SHORT.dwarftech.cz/contacts"> Dwarf Technologies </a> if your distributor is not responding.</li>
				<li>The third light captures the status of tunnels. If a device does not respond to the tunnel request, light goes to yellow or red. Please inspect <a href="../../admin/tunnel/web"> table of Webtunnels </a> and reset or remove the malfunctioning tunnel. Once removed, you may attempt to setup the tunnel again.</li>
				<li>The last light covers the status of devices - namely of all the monitoring groups. If there is for example a triggered alert for some device, the light goes from green to either yellow or red, depending on the particular situation.</li>
					<ul><li>The fastest way to locate the problem is to scroll down the dashboard and look for the monitoring group causing the problem. If the problem is with alert being triggered, note that alerts that are defined on a group are reported against that group. Alerts that are defined on a specific device are reported against the <b><i>All devices</i></b> group.</li></ul></ul>
			<li>The warnings are also listed below the main lights and the description should help with identifying the issue.</li>
			<li>There is also the list of triggered alerts attached below the group lights, providing a quick way how to access the respective alerts and the devices for which the alerts are triggered.</li></ul></ul>
	<li>Any other problem?</li>
		<p class="text-justify">There is a number of DWARFG_LONG resources available. You can access any of it starting <a href="https://DWARFG_SHORT.dwarftech.cz"> at the general DWARFG_LONG root page.</a> This way you can get to documentation, user forums and if you have some level of support, also to the ticketing system. Please note that if your support provider is different then Dwarf Technologies, you need to apply for support there. To access your support please follow <a href="{{ path('admin_support_redirect')}}"> the Support link </a>. To identify your support provider and level, visit <a href="{{ path('admin_system_license') }}"> License management </a> and inspect license information on the left side of the window.</p>
</p>
                </div>
            </div>
        </div>
    </div>

{% endblock body %}