Changes for page 216 - Hack Heaven
Last modified by CarlijnKokkeler on 2024/04/18 13:04
From version 81.1
edited by Erik Bakker
on 2023/02/13 14:00
on 2023/02/13 14:00
Change comment:
There is no comment for this version
To version 432.1
edited by etorken
on 2024/03/19 14:37
on 2024/03/19 14:37
Change comment:
There is no comment for this version
Summary
-
Page properties (3 modified, 0 added, 0 removed)
Details
- Page properties
-
- Title
-
... ... @@ -1,1 +1,1 @@ 1 - 192 -SmallStep1 +216 - Hack Heaven - Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki.e bakker1 +XWiki.etorken - Content
-
... ... @@ -1,158 +1,148 @@ 1 1 {{container}} 2 -{{container layoutStyle="columns"}}((( 2 +{{container layoutStyle="columns"}} 3 +((( 3 3 [[image:Main.Images.Release Blog.WebHome@release-blog-intro.png]] 4 4 5 -**Hi there, eMagiz developers!** Inthe lastcoupleofweeksweworkedhard onbuildingseveral majorthingsthatwill bereleasedlaterthisQ. On top of that wefinishedanadditionalfeatures for our3rdgeneration runtimethatgiveyouchirurgicalprecisionwhendoing maintenance onamodel. Amongtheadditionalfeatures we havethedynamicalerting and thedebugger functionality.6 +**Hi there, eMagiz developers!** As part of our alignment week, we also had a hackathon event focusing on a wide array of reported feedback on the portal. The majority of the release blog will be focused on this. On top of that, we launch new functionality that makes it easier to transform to JSON, select infra flows in a release, and deploy multiple agents to a single machine that adheres to specific conditions. But before we dive into all that has changed, we will publish several announcements via this release blog (and other channels) to prepare your model for upcoming major changes. 6 6 7 -== ** Start/StopFlows**~*~* ==8 +== **Announcement - TLS versions deprecated** == 8 8 9 - {{warning}}Note thatdependingon thealert thisfunctionalitywillonlyworkwhenyourJMSserveris runningonthe3rdgeneration runtime{{/warning}}10 +As eMagiz, we continuously validate our best practices configuration on security to the industry-wide standards in the fields of security to uphold our reputation as a reliable and secure integration platform. As a result of our latest evaluation, we decided to follow the industry-wide standard to **not** support the following TLS versions anymore in our **[[current runtime>>doc:Main.eMagiz Academy.Fundamentals.fundamental-runtime-generation3||target="blank"]]** architecture for outgoing connections from eMagiz to external systems as of April 11th, 2024. 10 10 11 -To enhance the options you have when running into problems or when maintaining your solution in a Production environment, we have added a new feature to our Deploy phase called "Start/Stop Flows". You can access this functionality via the "Deploy Architecture" overview in Deploy. On runtime level you can open the context menu and select the option called "Start/Stop Flows". 12 +* TLSv1.0 13 +* TLSv1.1 12 12 13 - [[image:Main.Images.Release Blog.WebHome@192-release-blog--start-stop-flows-context-menu.png]]15 +{{info}}Should you have concerns whether any of the external systems called from your eMagiz model only support the older TLS versions we suggest checking this via either [[OpenSSL>>doc:Main.Release Information.Release Blogs.openssl.WebHome||target="blank"]] or by calling the endpoint via SOAP UI (version 5.7.0 or higher). {{/info}} 14 14 15 - 16 -{{info}}Only in "Start Editing" mode you can actually start and stop specific flows{{/info}} 17 - 18 - 19 - observability of your integration landscape while running in the 3rd generation runtime architecture, we have added a new feature to our Manage phase called "Dynamic Alerts." You can access this functionality via the "Alerting" menu in Manage. Then, with the help of the "Trigger" overview, you can view all triggers on your environment. On the top of the list you will see all "static" alerts as defined by eMagiz. Below that you will see all "dynamic" alerts that you and your fellow teammembers (with sufficient rights) can view, edit and delete. 17 +== **Announcement - Spring 6** == 20 20 21 -We of fer alerting on five types.19 +We will release a major version of our [[current runtime>>doc:Main.eMagiz Academy.Fundamentals.fundamental-runtime-generation3||target="blank"]] base image for all our clients running on the **[[current runtime>>doc:Main.eMagiz Academy.Fundamentals.fundamental-runtime-generation3||target="blank"]]** architecture in our release that will be released on April 11th, 2024. This image moves the eMagiz stack from Java 8 to Java 17 and from Spring Framework 5 to Spring Framework 6. Although eMagiz will try to make the transition as smooth as possible, we recommend that you start with the following preparations. 22 22 23 -* Error message 24 -* Log message 25 -* Queue consumers 26 -* Messages in queue 27 -* Queue throughput 21 +{{warning}} 22 +* Make sure that your release is running on the **latest** flow versions. After the release of the new image, eMagiz will push new flow versions of components that have changed. These new flow versions must be included in the subsequent release. Having your release already on the **latest** flow versions makes this less affecting. 23 +* To help you identify which flow versions are essential here, you can consider all flows that contain any of the following components: 24 +** Simple job launcher (data pipelines) 25 +** Job explorer (data pipelines) 26 +** HTTP components message sender (support object) 27 +** Web service outbound gateway (with a 'message sender' attribute specified) 28 +** SFTP session factory (support object) 29 +** API gateways with OAuth2 as security mechanism. 30 +* We recommend identifying flows with (advanced) custom Groovy scripts. As our Java and Spring versions change, this may affect the availability of the libraries on the classpath and, therefore, the validity of import statements. You can already test the Groovy script using the flow testing functionality, as flow testing is already running on the Java 17 and Spring Framework 6 baseline. 31 +** Additionally, the Groovy version has been moved from 3.0.19 to 4.0.18. These changes may affect your scripts as well. [[These release notes >>https://groovy-lang.org/releasenotes/groovy-4.0.html||target="blank"]] will specify the changes in more detail. 32 +* The code handling SFTP file transfer has been overhauled completely. Although this should not affect you, we encourage you to test your SFTP integrations before deploying to Production. {{/warning}} 28 28 29 - [[image:Main.Images.ReleaseBlog.WebHome@191-release-blog--dynamic-alert-trigger-options.png]]34 +== **Infra flow selection** == 30 30 31 -These fiveoptionsgiveyoutheoptiontoconfiguremoreorlessthesame as youare currently used towhenconfiguringtriggers.Onceyoumakeachoicefora type you canpressthe"Next" buttontofill inthedetailsofthe trigger.Oneexampleofhowthis canlookisshownbelow.36 +This release will include a significant update to our release functionality, which allows you to configure your release. Presently, eMagiz will allow you to see changes on the infra-flow level visually. This means that the platform and/or system will color light blue to signify this change in the infra version. 32 32 33 -[[image:Main.Images.Release Blog.WebHome@ 191-release-blog--dynamic-alert-trigger-input.png]]38 +[[image:Main.Images.Release Blog.WebHome@release-216-hack-heaven--infra-flow-comparison.png]] 34 34 35 - Oncethetriggertabis filledinyou cannavigate to the "Output" tab toselecttherecipientsforthetrigger you areconfiguring.On topofthatyoucanreducethe number of messageat which congestioncontrolis enabled iften is too high for you.40 +In edit mode, you can select a new version via the right-click option, which you already use for other flows. 36 36 37 -[[image:Main.Images.Release Blog.WebHome@ 191-release-blog--dynamic-alert-trigger-output.png]]42 +[[image:Main.Images.Release Blog.WebHome@release-216-hack-heaven--infra-flow-selection.png]] 38 38 39 - ==**Debugger**~*~*~*==44 +We have also added a title to each context menu that specifies the flow type (e.g., exit connector, container infra, connector infra) for additional clarity while constructing your release. 40 40 41 -{{warning}}Note that this functionality only works when the following criteria are met. 42 -* Your JMS server is running on the 3rd generation runtime 43 -* The store item called "3rd generation debugger" is imported in the infra flow of each runtime for which you want the ability to debug 44 -* A new release is created that includes the flow changes and this release is deployed to the environment(s){{/warning}} 46 +[[image:Main.Images.Release Blog.WebHome@release-216-hack-heaven--context-menu-title.png]] 45 45 46 - Aswith our currentoffering, we now offer a functionalitywith which you candebug channels and see them via the eMagiz portal. As stated above to get to this pointyou need to execute several steps to get yourmodel ready to be "debugged". Once youhave done this you canactivatethe "debug" mode, via Deploy -> Containers for**one**specific flow **per** runtime that is of particular interest to you. Once you have done this you will see a pop-up telling you whether the "debug" mode was indeed activated or not.48 +== **Memory configuration machine** == 47 47 48 - [[image:Main.Images.ReleaseBlog.WebHome@191-release-blog--debugger-action-success.png]]50 +To improve the configuration of memory settings on the runtime level and especially the impact of that change on the overall health of the machine, we have made several changes to this process. Most noteworthy, we now keep track of the total amount of memory assigned to all runtimes running on a machine to compare this to the available amount of memory on the machine. To access the overview you need to select the "Details" option on machine level in Deploy Architecture and select the tab called "Runtime". 49 49 50 -[[image:Main.Images.Release Blog.WebHome@ 191-release-blog--debugger-action-failure.png]]52 +[[image:Main.Images.Release Blog.WebHome@release-216-hack-heaven--runtime-overview-healthy.png]] 51 51 52 - Assumingitwas activatedcorrectlyyou can navigateto Manage-> Explore-> Queuebrowserandselecttheemagiz.debugqueuetoseethemessages coming through.54 +When you exceed the available memory, eMagiz will notify you and block you from continuing to avoid unstable behavior. 53 53 54 -[[image:Main.Images.Release Blog.WebHome@ 191-release-blog--debugger-output-queue-browser.png]]56 +[[image:Main.Images.Release Blog.WebHome@release-216-hack-heaven--runtime-overview-unhealthy.png]] 55 55 56 -{{info}}Note the following limitations when working with the debugger. 57 - * Your entire model needs to be migrated to the 3rd generation runtime 58 - * Only **one** flow **per** runtime can be debugged **per** environment 59 - * There is only **one** overview in which **all** debugged messages are shown 60 - * Message payload in excess of 100KB are not shown in the queue browser as they constitute a "large message" 61 - * The debug functionality works for a period of five minutes in which you can use the refresh button to see new messages coming in. 62 - ** After five minutes the debug functionality will be shutdown automatically under water. 63 - ** To see new messages after the five minutes you will have to access the debug functionality again from scratch.{{/info}} 58 +== **Multiple environments selection** == 64 64 65 -== **Volume mapping - Network Share** == 60 +{{warning}}The following is only applicable under the following conditions: 61 + * Windows 2022 server 62 + * At least one port opened (as a consequence of a hosted web service){{/warning}} 66 66 67 - Thisreleasewill introduce an additionalfunctionalitywithinour[[volume mapping>>doc:Main.eMagizAcademy.Microlearnings.Novice.Filebasedconnectivity.novice-file-based-connectivity-volume-mapping-on-premise||target="blank"]] offering. Withthis additionalconfigurationoptionyoucan configureanetworkshareandconfigureit to create amapping between a network share and a docker volume.64 +When configuring your Deploy Agent, you now have an additional option that the user can activate. This checkbox unlocks the possibility of stability when running multiple deploy agents on one machine. 68 68 69 -[[image:Main.Images.Release Blog.WebHome@ 191-release-blog--volume-mapping-network-share-overview.png]]66 +[[image:Main.Images.Release Blog.WebHome@release-216-hack-heaven--multiple-environments.png]] 70 70 71 -[[image:Main.Images.Release Blog.WebHome@191-release-blog--volume-mapping-network-share-detail.png]] 68 +== **Feedback Items** == 69 +//__Easier component selection in flow designer__// 70 +The area selector through which you can select one or more components has improved to allow for an easier selection of said components when displayed close to the edge of the canvas. Expanding the area allows you to select these components, which will become much easier. 72 72 73 -== **Feedback items ** == 72 +//__Improved handling of optionality in JSON on lists__// 73 +Previously, eMagiz always created a JSON array if your data model expected a list. This led to unexpected and undesirable behavior of the message, as empty arrays are not always accepted by external parties. 74 74 75 -We have a lso solvedotherfeedbackitemsbesidestheflow designer'scriticalupdates.75 +With this release, we have changed the way in which we generate the JSON output should there be an empty list. Consequently, the empty list will **not** be part of the output anymore, as desired. 76 76 77 -//__ Showstatusonmachinelevel underDeployArchitecture__//78 - With thisreleasewearenowable toshowthestatusofthemachinewhenopening the"Details"overview onmachinelevelinDeploy -> Architecture.77 +//__Loading bar when searching for log entries__// 78 +To indicate to the user that eMagiz is still busy retrieving log entries, we have added a loading bar to the log entry overview upon pressing search. 79 79 80 -//__Improved validationfeedbackonnon-supportedWSS4Jinterceptor __//81 - Wehaveimprovedthevalidationfeedbackwhensomeone tries toimplement aspecificWSS4Jinterceptor implementation.80 +//__Improved feedback when deleting elements from Capture__// 81 +To better specify to the user which integration or system the user intends to delete, we have improved the text in the confirmation pop-up. This way, we can provide more information to the user to avoid mistakes. 82 82 83 -//__ Improvehelptextin flowtestingonJavaclasses__//84 -W e haveimprovedthehelptextwhenyouare adding headersto your testmessage. In thishelptextweexplain the topfiveJava classesand howtonotethem down to make itworkintheflow testingfunctionalityandineMagizingeneral.83 +//__Enhanced filter options in Manage__// 84 +With this release, we have added filter options on both the Alerting tab and the Trigger configuration pop-up. This allows users to filter on Status (Alerting) and Queues, Topics, Recipients, and more (Trigger configuration pop-up) in these places. 85 85 86 -//__ Improvedreadibilityofnotification whentrying todeletearuntime__//87 - Whenyou have forgotten oneor more stepswhendeletingaruntimeyouwillbe notified bythe systemonthis. Withthisrelease wehaveimprovedthe readibilityof the notification.86 +//__Copy property names from Create__// 87 +This release unlocks the possibility of easily copying the name of a property placeholder so it can be used while deploying. 88 88 89 -//__Improved sortingofmissingpropertiesoverview__//90 - We haveimprovedthesortingon themissing propertiesoverviewyouwill encounterwhenactivatingthe"checkproperties"option.89 +//__Improved feedback during migration to the current runtime architecture__// 90 +Should you try to migrate the JMS before any other runtime under Create -> Settings, we have improved the feedback. This feedback will tell you why you cannot migrate in this order. 91 91 92 -//__ Improvednotificationwhen errormessagecannotbefound__//93 -We have improvedthe notificationwhenan errormessagecannotbefound fromthemessage redeliveryoverviewin our 3rdgenerationruntime.92 +//__Block user from making changes to their cloud while another upgrade is still in progress__// 93 +We now block users from changing their cloud configuration when another upgrade is ongoing. 94 94 95 -//__ Additionallifecyclemanagementoverview__//96 -We have added a nadditionallifecyclemanagementoverviewtotheportalinwhichusers withenoughpermissions canget an overviewof thelifecycle "state"ofallcustomermodels.95 +//__Cron trigger validation__// 96 +We have added a validation check upon saving a cron expression in the Flow Designer to avoid flows not starting due to a misconfigured cron expression. 97 97 98 -//__Improved feedback when memory settings are negative__// 99 -We have added an additional check that validates whether memory settings on a specific container are of a negative value. In these cases you will be blocked from applying the changes to the environment as this won't lead to a working solution. 98 +== **Bug Fixes** == 99 +//__Making Edit (and View) the default action when configuring parameters__// 100 +We have made the Edit (and View) button the default action when configuring parameters in a transformation. 100 100 101 -//__ Autoupgradeforacloudtemplatedefault to "ON"__//102 - Foreachnewcloud slotwewilltoggle the"automtaticcloudtemplateupdate" to "Yes".102 +//__Property configuration pop-up resized__// 103 +We have resized the property configuration overviews to make the property value better readable. 103 103 104 -//__ Removedanirrelevantrefreshbuttononaflow designercomponent__//105 - Wehave removedanirrelevantrefreshbutton onthestandard filtercomponent.105 +//__Alphabetically sorted components in the flow designer__// 106 +As of this release, we now sort the components alphabetically in the flow designer. 106 106 107 -//__ Notificationlist shows all notificationsondefault__//108 - Whennavigatingto theNotification overview inManage underAlertingyouwillnowsee allnotificationsinsteadofafilteredlist on aspecific state.108 +//__Improved sorting on runtime overview__// 109 +As of this release, we now sort the runtimes in the runtime overview correctly by time. This means that the runtime with a changed status, closest to the current date and time, is shown at the top of the list. This should reduce the chance of overlooking a critical mistake. 109 109 110 -== **Bug fixes ** == 111 +//__Improved sorting on catalog overview__// 112 +As of this release, we now sort the topics in the catalog by name. 111 111 112 -//__ Keep selectionwhencopyingproperties__//113 - Wehavefixedthebug that preventedyoufromeasilycopyingpropertiesfromone runtimetoanotherbased on theruntimelist.114 +//__Styling fix on rich text editors__// 115 +Rich text editors are used in various parts of the portal. This release fixes a broken styling configuration that made it difficult to fill in information in these editors. 114 114 115 -//__ Checkonsecurity headerimprovedfor API Gateway__//116 - Weimprovedthe checkintheAPI Gatewaythroughwhich wevalidatewhether anAPI callerisauthenticatedwhenusing the APIKey methodto secure theAPI Gateway.117 +//__Styling fix on release edit__// 118 +As of this release, the correct icon (green) will be shown when wanting to add a second API operation under the same "header." 117 117 118 -//__ Don'tshowsystemswithonly"external"flowsinDesign__//119 -We fi xedabug thatcaused systems to appear inDesignincaseswhere there shouldbe none.120 +//__Removed false-positive alerts on transformations__// 121 +When transforming a string to a non-empty string, eMagiz would also show an alert even if the user made a check to avoid an empty string as output. This behavior is now corrected. This will significantly reduce the number of alerts you will see as a user within the context of your transformation. 120 120 121 -//__ Fixstylingofmendixlogininsomeoccurences__//122 - Whennavigatingto aspecificURLthe defaultMendixloginpagewould beshown. Withthis releasewehavefixedthis behavior.123 +//__Event Streaming Graphs - view thirty days back__// 124 +Just like the other views, we now also provide the user with a default thirty-day window to analyze relevant statistics related to event streaming further. 123 123 124 -//__ Change timing of wake-upof cloudslots on Friday__//125 - To preventtiming issuesof waking up cloudslots ontheFridayofourdeploymentwe havechangedthetimingofwhen the cloudslots arewoken up on Friday.126 +//__Improved helptext__// 127 +We have improved various help texts across the portal to indicate better what should be filled in for specific fields. 126 126 127 -//__Fixed a typo in the Topic statistics overview__// 128 -We fixed a typo in the topic statistics overview. 129 - 130 -//__Fixed a typo in the HTTP statistics overview__// 131 -We fixed a typo in the HTTP statistics overview. 132 - 133 -//__Activatation of release history when executing a deployment__// 134 -We ensured that the release history is activated when executing a deployment. 135 - 136 136 == **Fancy Forum Answers** == 137 137 138 138 As always, this is a gentle reminder to ask questions via the Q&A forum. The Q&A forum is available in the eMagiz iPaaS portal, so we can all benefit from the knowledge within the community. For some inspiration, take a look at these forum answers: 139 139 140 -* [[Characters transformed to � when retrieving from DataSink>>https://my.emagiz.com/p/question/172825635703287019||target="blank"]] 141 -* [[Can I test my API Gateway locally?>>https://my.emagiz.com/p/question/172825635703236592||target="blank"]] 142 -* [[Deploy stops when updating connector-infra>>https://my.emagiz.com/p/question/172825635703299903||target="blank"]] 133 +* [[XSD is only partially imported into eMagiz (xmlStat.xsd)>>https://my.emagiz.com/p/question/172825635703773349||target="blank"]] 143 143 144 -== **Key takeaways** ==135 +== **Key Takeaways** == 145 145 146 -Thanks to all thathelped build and those who tested and gave feedback to improve the product. To end this post, here are some key takeaways for you:137 +Thanks to all who helped build and those who tested and gave feedback to improve the product. To end this post, here are some key takeaways for you: 147 147 148 148 * If you have questions surrounding our Program Increment Planning, please get in touch with [[productmanagement@emagiz.com>>mailto:academy@emagiz.com]] 149 149 * If you have feedback or ideas for us, talk to the Platypus 150 -* Please inform us of new additions to the store ([[productmanagement@emagiz.com>>mailto:academy@emagiz.com]]) so we can all benefit from these. 141 +* Please inform us of new additions to the store ([[productmanagement@emagiz.com>>mailto:academy@emagiz.com]]) so we can all benefit from these. 151 151 * Clear your browser cache (Ctrl + Shift + Del) 152 152 * Check out the release notes [here] 153 153 * Start thinking about how the license tracker can aid your development 154 154 * Start thinking about major, minor, and patch 155 -* Upgrade to the latest build number 156 156 * Keep making great integrations 157 157 158 158 Let's stay in touch and till next time! ... ... @@ -160,6 +160,11 @@ 160 160 {{info}} 161 161 ~* Indicates a Beta feature. If you would like to get access to this beta feature, please contact [[productmanagement@emagiz.com>>mailto:academy@emagiz.com]] 162 162 163 -~*~* Indicates a GEN3-only feature. 164 -{{/info}})))((({{toc/}}))){{/container}} 153 +{{/info}} 154 +))) 155 + 156 +((( 157 +{{toc/}} 158 +))) 165 165 {{/container}} 160 +{{/container}}