Release 3.3.1

Author: ikulikov

_config.yml

@@ -75,8 +75,8 @@ collections:
 
 release:
   branch: release-3.3
-  ce_ver: 3.3
-  ce_tag: v3.3
-  ce_full_ver: 3.3.0
-  pe_ver: 3.3pe
-  pe_full_ver: 3.3.0PE
+  ce_ver: 3.3.1
+  ce_tag: v3.3.1
+  ce_full_ver: 3.3.1
+  pe_ver: 3.3.1pe
+  pe_full_ver: 3.3.1PE

_includes/templates/solution-templates.md

@@ -1,6 +1,6 @@
 {% if docsPrefix == "pe/" %}
 {% capture paas_only %}
-At the moment, the Solution Templates are only available in [ThingsBoard Cloud](/products/paas/). Supporting solution templates in [ThingsBoard PE](/products/thingsboard-pe/) is scheduled for version 3.3.1.
+The Solution Templates are available in [ThingsBoard Cloud](/products/paas/). Solution templates for [ThingsBoard PE](/products/thingsboard-pe/) introduced starting from version 3.3.1PE.
 {% endcapture %}
 {% include templates/info-banner.md content=paas_only %}
-{% endif %}
+{% endif %}

docs/edge/install/deb-installation.md

@@ -8,7 +8,7 @@ description: Installing ThingsBoard Edge on Ubuntu Server
 * TOC
 {:toc}
 
-This guide describes how to install ThingsBoard Edge on Ubuntu Server 18.04 LTS.
+This guide describes how to install ThingsBoard Edge on Ubuntu 18.04 LTS / Ubuntu 20.04 LTS.
 
 {% include templates/edge/install/prerequisites.md %}
 

docs/iot-gateway/install/deb-installation.md

@@ -6,7 +6,7 @@ title: Install ThingsBoard IoT Gateway as package.
 
 ### Prerequisites
 
-This guide describes how to install ThingsBoard IoT Gateway on Ubuntu Server 18.04 LTS. 
+This guide describes how to install ThingsBoard IoT Gateway on Ubuntu 18.04 LTS / Ubuntu 20.04 LTS.
 The minimum system requirements match official [minimum requirements](https://help.ubuntu.com/lts/serverguide/preparing-to-install.html#system-requirements) for the OS.
 
 ### Step 1. Download the deb file

docs/pe/reference/releases.md

@@ -8,6 +8,21 @@ description: ThingsBoard architecture
 * TOC
 {:toc}
 
+## v3.3.1 (September 3, 2021)
+
+Everything from [TB CE v3.3.1](https://github.com/thingsboard/thingsboard/releases/tag/v3.3.1) with the following improvements.
+
+Main features:
+
+* Introduced [Solution templates](/docs/pe/solution-templates/overview/);
+* UI: Added rule engine service to make requests to rule engine from custom actions;
+* Remote integrations: Ability to setup RPC SSL without server SSL certificate
+
+Bug fixes:
+
+* UI: Fixed incorrect cashing data in permission resources autocomplete;
+* UI: Fixed **The Things Stack Industries** integration form
+
 ## v3.3 (August 13, 2021)
 
 Everything from [TB CE v3.3](https://github.com/thingsboard/thingsboard/releases/tag/v3.3) with the following improvements.

docs/reference/releases.md

@@ -8,6 +8,53 @@ description: ThingsBoard architecture
 * TOC
 {:toc}
 
+## v3.3.1 (September 3, 2021)
+
+Minor release with the following improvements and bug fixes:
+
+**Improvements:**
+
+* Core:
+  * Added sequential RPC calls support;
+  * Edge functionality enabled by default;
+  * Additional thread pools naming (logging);
+  * Ability to override spring MVC async request-timeout property (avoid REST API timeouts)
+* Transport:
+  * Added support for UTF-8 characters in MQTT credential Client ID;
+  * Improved Session Activity reporting - short-lived sessions support;
+  * LwM2M: advanced tracking of sent requests
+* UI:
+  * New **Markdown/HTML** widget;
+  * Chart widgets: custom comparison intervals for data key;
+  * Chart widgets: tooltips visibility configuration;
+  * Added copy user id button within user details;
+  * Multiple attributes widget: added patterns support for widget title;
+  * Input widgets: added required field option;
+  * Added clear all filters option in events filter panel;
+  * Rule nodes forms: added show/hide password toggle to credentials fields of external rule nodes;
+  * New rxjs operators available in widget context (switchMap, catchError);
+  * Custom translations support for alarm type and alarm details in device profile alarm rules
+* Build scripts:
+  * Improved maven artifacts dependency management
+
+**Bug fixes:**
+
+* Core:
+  * Added validation and replacement of Queue names in the Device profile;
+  * Value of property SECURITY_USER_LOGIN_CASE_SENSITIVE is considered on password reset request;
+  * Corrected handling unique device name constraint violation for save device transaction
+* Rule Engine:
+  * Fixed device profile update handling by rule node — new telemetry keys from device profile were ignored;
+  * Fixed NPE while tell next in Rule chain actor message processor
+* UI:
+  * Hierarchy widget: process entity label from dashboard state;
+  * Fixed link to **Resources library** in SysAdmin home page;
+  * Fixed full-screen mode toggle in JSON forms;
+  * Improved queue name selector in device profile form;
+  * Fixed **Show on widget** button behavior: always display default widgets bundle;
+  * MQTT rule node form: credentials fields now optional;
+  * Global loading indication: added considering of canceled requests
+
 ## v3.3 (August 13, 2021)
 
 Major release which contains 2126 commits and 1668 changed files.

docs/trendz/install/ubuntu.md

@@ -12,7 +12,7 @@ description: Installing ThingsBoard Trendz Analytics on Ubuntu
 
 ### Prerequisites
 
-This guide describes how to install Trendz Analytics on Ubuntu Server 18.04 LTS. 
+This guide describes how to install Trendz Analytics on Ubuntu 18.04 LTS / Ubuntu 20.04 LTS.
 
 **Hardware requirements** depend on amount of analyzed data and amount of devices connected to the system. 
 To run Trendz Analytics on a single machine you will need at least 1Gb of free RAM.
@@ -214,4 +214,4 @@ cat /var/log/trendz/trendz.log | grep ERROR
 
 ### Next steps
 
-{% assign currentGuide = "InstallationOptions" %}{% include templates/trndz-guides-banner.md %}
+{% assign currentGuide = "InstallationOptions" %}{% include templates/trndz-guides-banner.md %}

docs/user-guide/install/cluster/aws-self-hosted-setup.md

@@ -18,7 +18,7 @@ You need to have admin access to ec2 resourse in your AWS account.
 
 ### Step 1. Create EC2 instance
 
-Create EC2 instance ([Amazon user guide](https://docs.aws.amazon.com/efs/latest/ug/gs-step-one-create-ec2-resources.html)) and choose Ubuntu Server 18.04 LTS. We recommend this distribution and OS version for our product.
+Create EC2 instance ([Amazon user guide](https://docs.aws.amazon.com/efs/latest/ug/gs-step-one-create-ec2-resources.html)) and choose Ubuntu Server 20.04 LTS. We recommend this distribution and OS version for our product.
 
 ### Step 2. Configure your security group for the instance.
 

docs/user-guide/install/cluster/gcp-self-hosted-setup.md

@@ -18,7 +18,7 @@ You need to have admin access to Compute Engine in your GCP account.
 
 ### Step 1. Create VM instance
 
-Create EC2 instance ([Creating and starting a VM instance](https://cloud.google.com/compute/docs/instances/create-start-instance)) and choose Ubuntu Server 18.04 LTS. We recommend this distribution and OS version for our product.
+Create EC2 instance ([Creating and starting a VM instance](https://cloud.google.com/compute/docs/instances/create-start-instance)) and choose Ubuntu Server 20.04 LTS. We recommend this distribution and OS version for our product.
 
 ### Step 2. Configure your firewall rules for the instance.
 

docs/user-guide/install/pe/add-haproxy-ubuntu.md

@@ -13,7 +13,7 @@ as ubuntu service. This is possible in case you are hosting ThingsBoard in the c
 
 ### Prerequisites
 
-Ubuntu 18.04 with valid DNS name assigned to the instance. Network settings should allow connections on Port 80 (HTTP) and 443 (HTTPS). 
+Ubuntu 18.04 / Ubuntu 20.04 with valid DNS name assigned to the instance. Network settings should allow connections on Port 80 (HTTP) and 443 (HTTPS).
 
 ### Step 1. Connect to your ThingsBoard instance over SSH
 

docs/user-guide/install/pe/resources/3.3.1pe/thingsboard-centos-download.sh

@@ -0,0 +1 @@
+wget https://dist.thingsboard.io/thingsboard-3.3.1pe.rpm

docs/user-guide/install/pe/resources/3.3.1pe/thingsboard-centos-installation.sh

@@ -0,0 +1 @@
+sudo rpm -Uvh thingsboard-3.3.1pe.rpm

docs/user-guide/install/pe/resources/3.3.1pe/thingsboard-ubuntu-download.sh

@@ -0,0 +1 @@
+wget https://dist.thingsboard.io/thingsboard-3.3.1pe.deb

docs/user-guide/install/pe/resources/3.3.1pe/thingsboard-ubuntu-installation.sh

@@ -0,0 +1 @@
+sudo dpkg -i thingsboard-3.3.1pe.deb

docs/user-guide/install/pe/ubuntu.md

@@ -14,7 +14,7 @@ description: Installing ThingsBoard on Ubuntu
 
 ### Prerequisites
 
-This guide describes how to install ThingsBoard on Ubuntu Server 18.04 LTS. 
+This guide describes how to install ThingsBoard on Ubuntu 18.04 LTS / Ubuntu 20.04 LTS.
 Hardware requirements depend on chosen database and amount of devices connected to the system. 
 To run ThingsBoard and PostgreSQL on a single machine you will need at least 1Gb of RAM.
 To run ThingsBoard and Cassandra on a single machine you will need at least 8Gb of RAM.

docs/user-guide/install/pe/upgrade-instructions.md

@@ -12,6 +12,17 @@ description: ThingsBoard PE IoT platform upgrade instructions
   <li>
         <a href="#prepare-for-upgrading-thingsboard-centos-ubuntu" id="prepare-for-upgrading-thingsboard-centos-ubuntu">Prepare for upgrading ThingsBoard (CentOS, Ubuntu)</a>
   </li>
+  <li>
+      <a href="#upgrading-to-331pe" id="markdown-toc-upgrading-to-322pe">Upgrading to 3.3.1PE</a>
+      <ul>
+          <li>
+              <a href="#ubuntucentos-331" id="markdown-toc-ubuntucentos-331">Ubuntu/CentOS</a>
+          </li>
+          <li>
+              <a href="#windows-331" id="markdown-toc-windows-331">Windows</a>
+          </li>
+      </ul>
+  </li>
   <li>
       <a href="#upgrading-to-33pe" id="markdown-toc-upgrading-to-33pe">Upgrading to 3.3PE</a>
       <ul>
@@ -297,6 +308,102 @@ $ sudo systemctl start cassandra
 **PostgreSQL**
 Do nothing, postgresql is already running.
 
+## Upgrading to 3.3.1PE
+
+### Ubuntu/CentOS {#ubuntucentos-331}
+
+**NOTE**: These upgrade steps are applicable for ThingsBoard version 3.3.0PE. In order to upgrade to 3.3.1PE you need to [**upgrade to 3.3.0PE first**](/docs/user-guide/install/pe/upgrade-instructions/#ubuntucentos-33).
+
+#### ThingsBoard PE package download
+
+{% capture tabspec %}thingsboard-download-3-3-1
+thingsboard-download-3-3-1-ubuntu,Ubuntu,shell,resources/3.3.1pe/thingsboard-ubuntu-download.sh,/docs/user-guide/install/resources/3.3.1pe/thingsboard-ubuntu-download.sh
+thingsboard-download-3-3-1-centos,CentOS,shell,resources/3.3.1pe/thingsboard-centos-download.sh,/docs/user-guide/install/resources/3.3.1pe/thingsboard-centos-download.sh{% endcapture %}
+{% include tabs.html %}
+
+#### ThingsBoard PE service upgrade
+
+* Stop ThingsBoard service if it is running.
+
+```bash
+$ sudo service thingsboard stop
+```
+
+* Install Thingsboard Web Report component as described [here](/docs/user-guide/install/pe/ubuntu/#step-9-install-thingsboard-webreport-component).
+
+
+{% capture tabspec %}thingsboard-installation-3-3-1
+thingsboard-installation-3-3-1-ubuntu,Ubuntu,shell,resources/3.3.1pe/thingsboard-ubuntu-installation.sh,/docs/user-guide/install/resources/3.3.1pe/thingsboard-ubuntu-installation.sh
+thingsboard-installation-3-3-1-centos,CentOS,shell,resources/3.3.1pe/thingsboard-centos-installation.sh,/docs/user-guide/install/resources/3.3.1pe/thingsboard-centos-installation.sh{% endcapture %}
+{% include tabs.html %}
+
+**NOTE:** Package installer may ask you to merge your thingsboard configuration. It is preferred to use **merge option** to make sure that all your previous parameters will not be overwritten.
+Please make sure that you set **database.ts.type** parameter value (in the file **/etc/thingsboard/conf/thingsboard.yml**) to "cassandra" instead of "sql" if you are using Cassandra database for timeseries data:
+
+```
+database:
+  ts_max_intervals: "${DATABASE_TS_MAX_INTERVALS:700}" # Max number of DB queries generated by single API call to fetch telemetry records
+  ts:
+    type: "${DATABASE_TS_TYPE:sql}" # cassandra, sql, or timescale (for hybrid mode, DATABASE_TS_TYPE value should be cassandra, or timescale)
+```
+
+Execute regular upgrade script:
+
+```bash
+# Execute regular upgrade script
+$ sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=3.3.0
+```
+
+#### Start the service
+
+```bash
+$ sudo service thingsboard start
+```
+
+### Windows {#windows-331}
+
+**NOTE**: These upgrade steps are applicable for ThingsBoard version 3.3.0PE. In order to upgrade to 3.3.1PE you need to [**upgrade to 3.3.0PE first**](/docs/user-guide/install/pe/upgrade-instructions/#windows-33).
+
+#### ThingsBoard PE package download
+
+Download ThingsBoard PE installation package for Windows: [thingsboard-windows-setup-3.3.1pe.exe](https://dist.thingsboard.io/thingsboard-windows-setup-3.3.1pe.exe).
+
+#### ThingsBoard PE service upgrade
+
+* Stop ThingsBoard service if it is running.
+
+```text
+net stop thingsboard
+```
+
+* Make a backup of previous ThingsBoard PE configuration located in \<ThingsBoard install dir\>\conf (for ex. C:\thingsboard\conf).
+* Run installation package **thingsboard-windows-setup-3.3.1pe.exe**.
+* Compare your old ThingsBoard configuration files (from the backup you made in the first step) with new ones.
+* Please make sure that you set **database.ts.type** parameter value (in the file **\<ThingsBoard install dir\>\conf\thingsboard.yml**) to "cassandra" instead of "sql" if you are using Cassandra database for timeseries data:
+
+```
+database:
+  ts_max_intervals: "${DATABASE_TS_MAX_INTERVALS:700}" # Max number of DB queries generated by single API call to fetch telemetry records
+  ts:
+    type: "${DATABASE_TS_TYPE:sql}" # cassandra, sql, or timescale (for hybrid mode, DATABASE_TS_TYPE value should be cassandra, or timescale)
+```
+
+* Finally, run **upgrade.bat** script to upgrade ThingsBoard to the new version.
+
+**NOTE** Scripts listed above should be executed using Administrator Role.
+
+Execute regular upgrade script:
+
+```text
+C:\thingsboard>upgrade.bat --fromVersion=3.3.0
+```
+
+#### Start the service
+
+```text
+net start thingsboard
+```
+
 ## Upgrading to 3.3PE
 
 ### Ubuntu/CentOS {#ubuntucentos-33}

docs/user-guide/install/resources/3.3.1/thingsboard-centos-download.sh

@@ -0,0 +1 @@
+wget https://github.com/thingsboard/thingsboard/releases/download/v3.3.1/thingsboard-3.3.1.rpm

docs/user-guide/install/resources/3.3.1/thingsboard-centos-installation.sh

@@ -0,0 +1 @@
+sudo rpm -Uvh thingsboard-3.3.1.rpm

docs/user-guide/install/resources/3.3.1/thingsboard-ubuntu-download.sh

@@ -0,0 +1 @@
+wget https://github.com/thingsboard/thingsboard/releases/download/v3.3.1/thingsboard-3.3.1.deb

docs/user-guide/install/resources/3.3.1/thingsboard-ubuntu-installation.sh

@@ -0,0 +1 @@
+sudo dpkg -i thingsboard-3.3.1.deb

docs/user-guide/install/ubuntu.md

@@ -12,7 +12,7 @@ description: Installing ThingsBoard CE on Ubuntu Server
 
 ### Prerequisites
 
-This guide describes how to install ThingsBoard on Ubuntu Server 18.04 LTS. 
+This guide describes how to install ThingsBoard on Ubuntu 18.04 LTS / Ubuntu 20.04 LTS.
 Hardware requirements depend on chosen database and amount of devices connected to the system. 
 To run ThingsBoard and PostgreSQL on a single machine you will need at least 1Gb of RAM.
 To run ThingsBoard and Cassandra on a single machine you will need at least 8Gb of RAM.