View source for Sending emails via command line

==Summary==

This chapter provides a guide on how to send emails via command line.

==Email service provider parameters==

First off, you'll need to be aware of some information about your email service (the one you'll be using to send the emails). The parameters in question are: '''SMTP Server''', '''SMTP Server port''', whether it uses '''SSL/TLS''', login '''username''' and '''password'''. You can find your email service provider's SMTP Server information online. For example, Gmail's SMTP settings are:

 Gmail SMTP server address        smtp.gmail.com.
 Gmail SMTP username              Full Gmail address (e.g. yourusername@gmail.com)
 Gmail SMTP password              Gmail password.
 Gmail SMTP port (TLS)            587
 Gmail SMTP port (SSL)            465
 Gmail SMTP TLS/SSL required      yes

You probably already know your username and password and you can find the rest of the settings with a quick search. Just type '''"email_provider_name smtp settings"''' into the search field of your preferred engine.

==Logging in to the router==

Once you have all the necessary email information, choose your favourite method of sending command line queries or the one that is currently available to you and log in to your router accordingly. The most common methods of doing so are '''[[CLI]]'''('''Command Line Interface''') and SSH.

'''Note''': in further examples of this guide we will be demonstrating how to send email using SSH. Feel free to follow the guide step by step whichever method you choose, because the commands used are identical and the only thing that is different is the GUI (Graphical User Interface).
===CLI===
----
CLI can be reached through the router's WebUI. To reach the router's WebUI, simply enter the router's LAN IP address ('''192.168.1.1''' by default) into your browser's URL bar and press "Enter". Next, type in the router's login infromation (username: '''admin'''; password: '''admin01''' by default) and click "Login":

[[File:Rut login page.png]]
----

Next, navigate to the '''[[RUT955_Services_section|Services]]''' menu and click on the '''CLI''' option from the drop-down list:

[[File:How to cli.png]]
----

In the next window, type in the username '''root''' and press "Enter". Then type in the router's password (same one you used for logging in to the router), press "Enter" and you should be greeted with a window such as this:

[[Image:Cli.PNG]]

Once this is done, you will able to execute commands via CLI.
===SSH===
----
To log in to a RUT router via SSH, download the free '''PuTTY''' app if you're using Windows; if you're using a Linux based OS, just use the '''Terminal''' app. In both cases you will need to know three things: the router's LAN IP address, user name and password. The default LAN IP address for all RUT routers is '''192.168.1.1'''; the default login information is username: '''root'''; password: '''admin01''' (NOTE: the user name used for SSH connections (i.e., root) is not the same as the user name used to log in to the router's WebUI (i.e., admin)).

If you're using PuTTY, enter the router's LAN IP address into the '''Host Name (or IP address)''' field, select SSH Connection type and click '''Open''':

[[File:P.PNG]]

After this you will be prompted to enter the username and password. 
----
If you're using Linux, open a Terminal and type this command:

 # ssh root@192.168.1.1

If you made changes to LAN IP address or log in name, replace the relevant data in the command above so that it is correct for your specific case. After executing this command you will prompted with a query that says "Are you sure you want to continue connecting (yes/no)?". Type '''yes''', press "Enter" and type in your router's admin password. If everything went successfully, you should be greeted with a window such as this:

[[File:Ssh login example.png]]

Once this is done, you will able to execute commands via SSH.

==Sending emails==

RUT routers use the '''sendmail''' program to send emails. sendmail is a very simple MTA (Mail Transfer Agent), which implements the SMTP (Simple Mail Transfer Protocol) amongst others and can be used to transmit emails, typically on Linux dedicated or virtual servers.

There is no need to install anything else, because RUT routers have sendmail implemented in their Firmware. So, if you followed the steps above, you should be ready to send emails via command line. 

===Method 1===
----
For this first example, lets send an email from the hypothetical address '''senders.email@gmail.com''' to '''recipients.email@gmail.com''' using Gmail's SMTP settings:

 echo -e "subject:Test\nfrom:senders.email@gmail.com\nTesting" | sendmail -v -H "exec openssl s_client -quiet -connect smtp.gmail.com:587 -tls1 -starttls smtp" -au"senders.email@gmail.com" -ap"senders.email.password" recipients.email@gmail.com

Let's examine this command in detail. First, the '''echo <span style=color:green>-e</span> "<span style=color:blue>subject:Test</span><span style=color:red>\n</span><span style=color:blue>from:senders.email@gmail.com</span><span style=color:red>\n</span><span style=color:blue>Testing</span>"''' part:

'''echo''' - prints the specified arguments to stdout

'''<span style=color:green>-e</span>''' - makes the echo command interpret backslash escapes (</span><span style=color:red>\n</span> in this case)

<span style=color:red>\n</span> - the end line symbol, i.e., it indicates that the following text begins in another line. The </span><span style=color:red>\n</span> part itself is not interpreted as part of the text if '''<span style=color:green>-e</span>''' is specified.



sendmail -v -H "exec openssl s_client -quiet -connect smtp.gma
il.com:587 -tls1 -starttls smtp" <mail.txt -f dziugas.matrosovas@gmail.com -au"d
ziugas.matrosovas@gmail.com" -ap"pass" dziugas.matrosovas@teltonika.lt