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

{% block title %}How to send Configuration (and other) SMS{% 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> How to send SMS </h4>
					<hr>
					<h5 style="margin-top: 30px;"> Sending SMS dialogue</h5>
					<p class = "text-justify">
						To send an SMS, the following must be configured:
						<ul>
							<li>At least one system device (device type: Advantech router) with working SIM card must be present.</li>
							<li>Authentication profile with valid certificates must be defined and assigned to that device.</li>
						</ul>
						For documentation on how to configure the above points please refer below. As for sending the SMS itself, there are basically two use cases covered:
						<ul>
							<li>Sending Configuration SMS to Advantech router device.</li>
							<ul>
								<li>To target the device, it must have a SIM card inserted and the MSISDN of that SIM card must be known.</li>
							</ul>
							<li>Sending SMS with arbitrary text to any MSISDN.</li>
						</ul>
					</p>
					<p class = "text-justify">
						Both use cases are covered by the Send SMS dialogue. To send SMS you need:
					</p>
					<ul>
						<li>Select SMS type (any of the supported configuration SMSes or arbitrary text SMS).</li>
						<li>(Optional) specify SMS text if arbitrary text SMS has been selected.</li>
						<li>Select target</li>
						<ul>
							<li>Device ID (for configuration SMS) - NOTE it must have a SIM card inserted and MSISDN of this SIM card must be filled.</li>
							<li>MSISDN - you can provide any MSISDN as target.</li>
						</ul>
						<li>Select system device, to which an SSH connection is opened and where the SMS sending command is executed.</li>
					</ul>
					<h5 style="margin-top: 30px;">Configuration elements</h5>
					<h6 style="margin-top: 30px;">System Device</h6>
					<p class = "text-justify">
						The system device needs to be an Advantech router and to send an SMS it must be reachable from the DWARFG_LONG server so that the server can connect via SSH to that device.
					</p>
					<p class = "text-justify">
						Once you have such device ready (the DWARFG_LONG agent is running on the device), assign the system label <b>sms</b> to that device. You can do that in the <i>Device Details</i>.
					</p>
					<h6 style="margin-top: 30px;">Authentication Profile</h6>
					<p class = "text-justify">
						Next you need to provide credentials to access the chosen device. If you don't have a suitable Authentication Profile, you need to create one:
					</p>
					<ul>
						<li>
							Go to <b>Tools -&gt; Auth Management</b> You need to provide either SSH password or SSH key together with a username to an account on the device that is allowed to execute the SMS command (Command: <b>sms</b> on Advantech cellular routers).
						</li>
						<li>
							Click on <b>+ Add Auth Profile</b> button.
						</li>
						<li>
							Choose some <b>Name</b> that is descriptive enough so that later on you recognize the purpose of this profile.
						</li>
						<li>
							As for username, you need some user that is allowed to send SMS on the Router device. For Advantech routers, that is typically the root user.
						</li>
						<li>
							You need to provide only one of <b>SSH Password</b> and <b>SSH Key</b>. This will be used when connecting to the router device via ssh to execute the sms sending command (<b>sms</b> for Advantech routers).
						</li>
					</ul>
					<p class = "text-justify">
						Once the proper Authentication Profile is available, assign the profile to the selected system device in its <b>Device Details</b> under <b>Auth Profile</b>
					</p>
					<h6 style="margin-top: 30px;">Connection Interface</h6>
					<p class = "text-justify">
						The system needs to recognize which of the router Network Interfaces should it connect to - more in general, which IP address out of all the Router IP addresses is the one it should connect to using SSH.
					</p>
					<ul>
						<li>
							Go to <b>Device Details</b> of the system device.
						</li>
						<li>
							Under <b>Network Interfaces</b>, select exaclty one of the interfaces as <i>Linkable</i>
						</li>
						<li>
							Confirm by clicking <b>Update Settings</b> under the table.
						</li>
					</ul>
					<hr>
				</div>
			</div>
		</div>
	</div>

{% endblock body %}