Difference between revisions of "Getting Started"
(19 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
+ | {| align="right" | ||
+ | |align="right"|__TOC__ | ||
+ | |} | ||
+ | |||
Here you will discover basic information on what FM devices support FOTA Web solution and where you can get started by following step by step guide from the invitation to your first login. Additionally you will find web sites basic settings such as changing language, API and more. | Here you will discover basic information on what FM devices support FOTA Web solution and where you can get started by following step by step guide from the invitation to your first login. Additionally you will find web sites basic settings such as changing language, API and more. | ||
<br> | <br> | ||
− | |||
− | |||
=='''Device requirements'''== | =='''Device requirements'''== | ||
{| style="width: 75%; text-align: center; vertical-align: top;" | {| style="width: 75%; text-align: center; vertical-align: top;" | ||
Line 93: | Line 95: | ||
<br> | <br> | ||
− | '''Note''': 1. All FMBXXX devices except for FMB64X should have at least [[FMB_firmware_errata#01.03.03.Rev.00|01.03.03.Rev.00]] firmware version installed.<br />2. FMB64X should have at least [[FMB640 firmware errata#00.02.05|00.02.05]] version installed.<br />Please check [https://wiki.teltonika-gps.com/view/Firmware_versions Firmware Link] to find latest base firmware for your device.<br> | + | '''Note''': 1. All FMBXXX devices except for FMB64X should have at least [[FMB_firmware_errata#01.03.03.Rev.00|01.03.03.Rev.00]] firmware version installed.<br />2. FMB64X should have at least [[FMB640 firmware errata#00.02.05|00.02.05]] version installed.<br />3. FM36YX devices should have at least [[FM36 firmware errata#01.12.00.Rev.02|01.12.00.Rev.02]] version installed. (FM36YX FotaWeb functionality for firmware update only)<br /> |
+ | Please check [https://wiki.teltonika-gps.com/view/Firmware_versions Firmware Link] to find latest base firmware for your device.<br> | ||
<br> | <br> | ||
+ | |||
+ | '''Default FOTA WEB configuration settings:''' | ||
+ | |||
+ | '''Domain:''' fota.teltonika.lt<br /> | ||
+ | '''Port:''' 5000 <br /> | ||
+ | '''Period:''' 720 minutes (every 720 minutes device shall connect to FOTA WEB)<br /> | ||
+ | [[File:FOTA_Web_Configuration.PNG|750px]]<br /> | ||
=='''Network requirements'''== | =='''Network requirements'''== | ||
Line 100: | Line 110: | ||
If your SIM cards are within Mobile Operator’s VPN (private APN), the following must be ensured and paid special attention. | If your SIM cards are within Mobile Operator’s VPN (private APN), the following must be ensured and paid special attention. | ||
<br /> | <br /> | ||
− | '''1.''' Must ensure that domain | + | '''1.''' Must ensure that domain '''http://fota.teltonika.lt''' can be resolved from within Operator’s network.<br /> |
− | '''2.''' Following | + | '''2.''' Following IP and ports (egress) must be allowed by the operator. |
+ | <br /> | ||
− | + | *IP: 35.156.7.140 | |
− | |||
− | * | ||
*Ports: | *Ports: | ||
− | ** | + | **2000<br /> |
− | ** | + | **3000<br /> |
− | + | **4000<br /> | |
− | * | + | **5000<br /> |
− | * | + | **6000<br /> |
− | ** | + | **7000<br /> |
− | ** | ||
− | When using VPN SIM cards, you should still configure | + | When using VPN SIM cards, you should still configure '''http://fota.teltonika.lt''' domain in your configurator, not the plain IP address. |
=='''How to access FOTA WEB'''== | =='''How to access FOTA WEB'''== | ||
− | FOTA WEB is reached using domain address ''' | + | FOTA WEB is reached using domain address '''http://fota.teltonika.lt'''. FOTA WEB uses HTTP ports 80 and 85 for authentication so if your network has HTTP proxy service or is blocking outgoing traffic – make sure that those two ports are added to exceptions in network proxy service and firewall. |
<br> | <br> | ||
Line 150: | Line 158: | ||
[[File:FOTA Web Notifications.png]] | [[File:FOTA Web Notifications.png]] | ||
− | =='''FOTA Web | + | =='''Settings'''== |
− | + | ||
+ | You can find '''FOTA Web Settings''' at the top-right of the page, there you are able to change web page language, generate API tokens, change account password and set your own time zone. More details about the functions are explained below. <br> | ||
+ | [[File:FOTA Web Settings.png]] | ||
+ | ===Language=== | ||
+ | |||
+ | In the settings tab window you can select your preferred language. | ||
+ | Currently there are 6 available languages: | ||
+ | * English | ||
+ | * Lithuanian | ||
+ | * Russian | ||
+ | * Spanish | ||
+ | * Portuguese | ||
+ | * France | ||
+ | |||
+ | ===API tokens=== | ||
+ | |||
+ | You can generate Token ID in the API Tokens window by clicking '''Add token''', set a Token name and then click generate. This will generate FOTA Web API Token with which you can use it to integrate FOTA Web functionalities on your existing software system. <br> | ||
+ | [[File:FOTA Web API Token.png|600px]] | ||
+ | |||
+ | Full FOTA API documentation can be found [https://api.teltonika.lt/documents/index.html <u>'''HERE'''</u>]. | ||
+ | |||
+ | ===Change password=== | ||
+ | |||
+ | If your current password is too difficult to remember or not secure enough and you want to change it, you can freely change your password by entering your current password and then the password you want it to be changed to.<br> | ||
+ | [[File:FOTA Web ChangePassword.png|500px]]<br> | ||
+ | If you do not remember your current password, in FOTA WEB initial window you can click forgot password. It will generate a link for resetting your password and send it to your email address. | ||
+ | |||
+ | ===Time zone=== | ||
− | ''' | + | Time zone functionality lets you freely change how page will display time in different time zones. Changing it will change time information on when device was '''Seen at''', '''Created at''' or '''Updated at'''. |
− | + | [[File:FOTA Web Timezone.png|300px]] | |
− | + | <br> | |
− | + | {|style="width:100%;" | |
+ | |- | ||
+ | |[https://wiki.teltonika-gps.com/view/FOTA_WEB'''Landing page'''] - Previous page | ||
+ | |style="text-align:right;| Next page - [https://wiki.teltonika-gps.com/view/Dashboard '''Dashboard '''] | ||
+ | |} |
Revision as of 09:59, 13 July 2023
Here you will discover basic information on what FM devices support FOTA Web solution and where you can get started by following step by step guide from the invitation to your first login. Additionally you will find web sites basic settings such as changing language, API and more.
Device requirements
Supported Devices |
---|
|
|
|
|
|
|
Note: 1. All FMBXXX devices except for FMB64X should have at least 01.03.03.Rev.00 firmware version installed.
2. FMB64X should have at least 00.02.05 version installed.
3. FM36YX devices should have at least 01.12.00.Rev.02 version installed. (FM36YX FotaWeb functionality for firmware update only)
Please check Firmware Link to find latest base firmware for your device.
Default FOTA WEB configuration settings:
Domain: fota.teltonika.lt
Port: 5000
Period: 720 minutes (every 720 minutes device shall connect to FOTA WEB)
Network requirements
If your SIM cards are within Mobile Operator’s VPN (private APN), the following must be ensured and paid special attention.
1. Must ensure that domain http://fota.teltonika.lt can be resolved from within Operator’s network.
2. Following IP and ports (egress) must be allowed by the operator.
- IP: 35.156.7.140
- Ports:
- 2000
- 3000
- 4000
- 5000
- 6000
- 7000
- 2000
When using VPN SIM cards, you should still configure http://fota.teltonika.lt domain in your configurator, not the plain IP address.
How to access FOTA WEB
FOTA WEB is reached using domain address http://fota.teltonika.lt. FOTA WEB uses HTTP ports 80 and 85 for authentication so if your network has HTTP proxy service or is blocking outgoing traffic – make sure that those two ports are added to exceptions in network proxy service and firewall.
1. Invitation for FOTA WEB is being delivered to user e-mail. Press the URL to create a password for your account. | 2. After pressing the URL Link you will be asked to create a password for your account. | 3. Last step is logging into FOTA WEB with the newly created account by entering your email address and password for your account. Email address is the same as the address you've received the invitation. |
Select company
At the top-right corner, you can find the Company selector button. Pressing on a button will open a list of parent and child companies. Selecting a company allows for filtering resources available such as devices, task groups, groups, users, and files. It is an easy way to separate resources and make sure that you are working with the correct ones. Company selector button behavior:
- When a single company is selected, you will see the company button label change to the selected company's name.
- When two or more companies are selected, you will see a number of companies selected instead of an icon and "Companies" label.
- When nothing is selected, you will see everything available and "All companies" label.
Note: Every company has to be selected individually.
Notifications
Notifications is located at the top-right corner of the page. Notifications will inform you when certain actions are completed such as devices firmware got updated, configuration got uploaded to or downloaded from the device and also notifies when devices are transferred from one company to another or moved from main company to child company.
Settings
You can find FOTA Web Settings at the top-right of the page, there you are able to change web page language, generate API tokens, change account password and set your own time zone. More details about the functions are explained below.
Language
In the settings tab window you can select your preferred language. Currently there are 6 available languages:
- English
- Lithuanian
- Russian
- Spanish
- Portuguese
- France
API tokens
You can generate Token ID in the API Tokens window by clicking Add token, set a Token name and then click generate. This will generate FOTA Web API Token with which you can use it to integrate FOTA Web functionalities on your existing software system.
Full FOTA API documentation can be found HERE.
Change password
If your current password is too difficult to remember or not secure enough and you want to change it, you can freely change your password by entering your current password and then the password you want it to be changed to.
If you do not remember your current password, in FOTA WEB initial window you can click forgot password. It will generate a link for resetting your password and send it to your email address.
Time zone
Time zone functionality lets you freely change how page will display time in different time zones. Changing it will change time information on when device was Seen at, Created at or Updated at.
Landing page - Previous page | Next page - Dashboard |