Merge pull request #186 from FirelyTeam/vonk/4.2.0

vonk: releasenotes version 4.2.0

firelyserver/releasenotes/releasenotes.rst

@@ -17,6 +17,39 @@ Upgrading Firely Server
 
 See :ref:`upgrade` for information on how to upgrade to a new version of Firely Server.
 
+.. _vonk_releasenotes_420:
+
+Release 4.2.0
+-------------
+
+Database
+^^^^^^^^
+
+.. attention::
+   For SQL Server we changed the datatype of the primary keys. The related upgradescript (`data/20210519072216_ChangePrimaryKeyTypeFromIntToBigint.sql`) can take a lot of time if you have many resources loaded in your database. Therefore some guidelines:
+
+   * We tested it on a database with about 15k Patient records, and 14 mln resources in total. Migrating that took about 45 minutes on a fairly powerful laptop.
+   * Absolutely make sure you create a backup of your database first.
+   * If you haven't done so already, first upgrade to version 4.1.x.
+   * If you already expect the migration might time out, you can run it manually upfront. Shut down Firely Server, so no other users are using the database, and then run the script from SQL Server Management Studio (or a similar tool).
+   * Running the second script (`20210520102224_ChangePrimaryKeyTypeFromIntToBigintBDE.sql`) is optional - that should also succeed when applied by the automigration.
+
+Feature
+^^^^^^^
+
+#. Terminology operation ``$lookup`` is now also connected to remote terminology services, if enabled. See :ref:`feature_terminology`.
+#. We provided a script to 'purge' data from a SQL Server database. See `data/20210512_Purge.sql`. You can filter on the resourcetype only. Use with care and after a backup. If you need more elaborate support for hard deletes, please :ref:`vonk_contact`.
+
+Fix
+^^^
+#. Firely Server could run out of primary keys on the index tables in SQL Server. Fixed by upgrading to bigint, see warning above.
+#. Nicer handling of SQL Server migration scripts that time out on startup. It will now kindly ask you to run the related script manually if needed (usually depends on the size of your database).
+#. The Patient-everything (`$everything`) operation was not mentioned in the CapabilityStatement.
+#. License expired one day too early.
+#. Dependencies have been upgraded to the latest versions compatible with .NET Core 3.1.
+#. PATCH did not allow adding to a repeating element.
+#. If your license does not allow usage of SMART on FHIR, authorization was disabled, emitting a warning in the log. Possibly causing unauthorized access without the administrator noticing it. This specific case will now block the startup of Firely Server. 
+
 .. _vonk_releasenotes_413:
 
 Release 4.1.3 hotfix