Changes for page 198 - Great Migration

Last modified by Carlijn Kokkeler on 2024/04/18 13:14

From 80.1 to 81.1 From 103.1 to 104.1

From version 81.1

edited by Erik Bakker
on 2023/02/13 14:00

Change comment: There is no comment for this version

To version 103.1

edited by Erik Bakker
on 2023/04/13 14:29

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Title

@@ -1,1 +1,1 @@
--192 - Small Step
++195 - Easter Party

Content

@@ -2,144 +2,98 @@
  {{container layoutStyle="columns"}}(((
  [[image:Main.Images.Release Blog.WebHome@release-blog-intro.png]]
--**Hi there, eMagiz developers!** In the last couple of weeks we worked hard on building several major things that will be released later this Q. On top of that we finished an additional features for our 3rd generation runtime that give you chirurgical precision when doing maintenance on a model. Among the additional features we have the dynamic alerting and the debugger functionality.
++**Hi there, eMagiz developers!** In the last few weeks, we have focused on wrapping up the previous quarter and starting the new one. When this happens, we go silent for a few weeks to plan for the upcoming quarter during our PI rituals. This time we added the famous "Hackathon" to the end of the PI week so we could start the Easter break with excellent spirit after solving several smaller feedback items and bugs reported by you. Several of those stories will be included in this and the upcoming release. On top of that, we introduce various improvements to our API Gateway pattern and our 3rd generation runtime architecture. Subsequently, we will release a new runtime image supporting the multiple improvements.
--== **Start/Stop Flows** ~*~* ==
++== **Release properties** ==**
--{{warning}}Note that depending on the alert this functionality will only work when your JMS server is running on the 3rd generation runtime{{/warning}}
++With this release we bring an improved version of the release properties functionality. With the introduction of the 3rd generation runtime the way properties can be updated and when they need to be available for the solution to start up has changed compared to the current runtime architecture. More on that can be found [[here>>Main.eMagiz Academy.Fundamentals.fundamental-runtime-generation3||target= "blank"]].
--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".
++As of now you can not only view all property values related to a specific release by pressing the wrench icon. You can also create what we call a "property release" on each of the three environment that allows you to quickly change one or more property values and deploy the changes to your environment. When deploying such a release eMagiz will check on which runtimes the properties are used and only execute the deploy actions for the machines to which said runtime(s) belong(s).
--[[image:Main.Images.Release Blog.WebHome@192-release-blog--start-stop-flows-context-menu.png]]
++{{video attachment="release-blog-easter-party--release-properties.mp4" reference="Main.Videos.Microlearning.WebHome"/}}
--
--{{info}}Only in "Start Editing" mode you can actually start and stop specific flows{{/info}}
--
--
--  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.
++{{info}}The following considerations need to be taken into account when using this functionality:
++* This functionality works from the moment one runtime is running on the 3rd generation runtime architecture
++* This functionality can only change property values. Functional changes need a seperate release that needs to be promoted
++* In comparison to standard releases a property release can be created on each environment (as the property value is linked to a specific environment).
++* While changing a property in a ‘property’ release, users also have the option to alter the value in the Deploy-Properties list. By default, this is set to Yes, because when a new release is created, the values of Deploy-Properties will be used and not properties of an earlier release. When a user closes the screen for editing a property, the change will immediately be implemented.
++* The auto-clean release functionality is unaffected by this change, ‘property’ releases will not be counted as a release.
++* There is a maximum of 26 ‘property’ releases. (26 letters of the alphabet)
++* Only the latest release can be edited. This can be identified by checking the suffix. The suffix with the latest letter of the alphabet is editable.{{/info}}
--We offer alerting on five types.
++== **API improvements** ==
--* Error message
--* Log message
--* Queue consumers
--* Messages in queue
--* Queue throughput
++//__Improved auto-generated error handling__//
++When you create a new operation in your API gateway, eMagiz will now automatically generate the correct schemas, HTTP codes, and examples for this operation based on industry standards.
--[[image:Main.Images.Release Blog.WebHome@191-release-blog--dynamic-alert-trigger-options.png]]
++//__Switch default message format__//
++We have improved the logic when you switch the message format of your gateway message from XML to JSON or vice versa. As a result, the Swagger file will be changed accordingly. Once you update the relevant flow in Create and deploy the solution, the Swagger UI will automatically match the expected result.
--These five options give you the option to configure more or less the same as you are currently used to when configuring triggers. Once you make a choice for a type you can press the "Next" button to fill in the details of the trigger. One example of how this can look is shown below.
++//__Re-using elements in gateway message__//
++This release improves how the examples and schemas in Swagger and the Flow Testing functionality are generated when certain elements repeatedly appear in different places within one specific gateway message.
--[[image:Main.Images.Release Blog.WebHome@191-release-blog--dynamic-alert-trigger-input.png]]
++//__Improved naming of API operations when adding integrations to Create__//
++Previously when you added API operations to the Create phase, the HTTP operation (i.e., POST, PUT, GET) was not visible to a user. As a result, it became tough for a user to discern between specific operations once multiple of them were used on one resource (i.e., Order, Invoice, Lead). To clarify this for the user, the display name defined in Design (instead of Capture) is now used within this overview for these operations.
--Once the trigger tab is filled in you can navigate to the "Output" tab to select the recipients for the trigger you are configuring. On top of that you can reduce the number of message at which congestion control is enabled if ten is too high for you.
++== **3rd generation improvements** ==
--[[image:Main.Images.Release Blog.WebHome@191-release-blog--dynamic-alert-trigger-output.png]]
++//__Update of the static alerting engine__//
++In this release, we have updated the static alerting engine that determines when one of the static alerts, as defined by eMagiz, should be triggered (or not). This change will improve the performance of the solution and will ensure that the alerts are activated correctly.
--== **Debugger ** ~*~* ~* ==
++//__Add "Data pipeline" functionality__//
++This release introduces the "data pipeline" functionality to the 3rd generation runtime. This removes another blockage for models waiting on this before migrating to the 3rd generation runtime.
--{{warning}}Note that this functionality only works when the following criteria are met.
--* Your JMS server is running on the 3rd generation runtime
--* The store item called "3rd generation debugger" is imported in the infra flow of each runtime for which you want the ability to debug
--* A new release is created that includes the flow changes and this release is deployed to the environment(s){{/warning}}
++//__Fix related to the debugger__//
++This release introduces a fix that allows users to debug a flow once the toggle "Send error messages to eMagiz" is activated.
--As with our current offering, we now offer a functionality with which you can debug channels and see them via the eMagiz portal. As stated above to get to this point you need to execute several steps to get your model ready to be "debugged". Once you have done this you can activate the "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.
++{{warning}}To make use of this bug fix, you need to be on the latest runtime image{{/warning}}
--[[image:Main.Images.Release Blog.WebHome@191-release-blog--debugger-action-success.png]]
++//__Improved migration process__//
++This release introduced a fix that allows a user to migrate event processors with custom error handling without manual intervention.
--[[image:Main.Images.Release Blog.WebHome@191-release-blog--debugger-action-failure.png]]
++//__Deployment plan change__//
++In this release, the prepare release step will not start automatically anymore. This prevents the user from waiting for this action to be finished before they can continue deploying the solution to their environment.
--Assuming it was activated correctly you can navigate to Manage -> Explore -> Queue browser and select the emagiz.debug queue to see the messages coming through.
++{{warning}}Should you be interested in migrating your model to our new 3rd generation architecture, don't hesitate to contact us at [[productmanagement@emagiz.com>>mailto:productmanagement@emagiz.com]] or read our [[documentation>>doc:Main.eMagiz Academy.Fundamentals.fundamental-runtime-generation3||target="blank"]] on the subject.{{/warning}}
--[[image:Main.Images.Release Blog.WebHome@191-release-blog--debugger-output-queue-browser.png]]
--
--{{info}}Note the following limitations when working with the debugger.
--  * Your entire model needs to be migrated to the 3rd generation runtime
--  * Only **one** flow **per** runtime can be debugged **per** environment
--  * There is only **one** overview in which **all** debugged messages are shown
--  * Message payload in excess of 100KB are not shown in the queue browser as they constitute a "large message"
--  * The debug functionality works for a period of five minutes in which you can use the refresh button to see new messages coming in.
--    ** After five minutes the debug functionality will be shutdown automatically under water.
--    ** To see new messages after the five minutes you will have to access the debug functionality again from scratch.{{/info}}
--
--== **Volume mapping - Network Share** ==
--
--This release will introduce an additional functionality within our [[volume mapping>>doc:Main.eMagiz Academy.Microlearnings.Novice.File based connectivity.novice-file-based-connectivity-volume-mapping-on-premise||target="blank"]] offering. With this additional configuration option you can configure a network share and configure it to create a mapping between a network share and a docker volume.
--
--[[image:Main.Images.Release Blog.WebHome@191-release-blog--volume-mapping-network-share-overview.png]]
--
--[[image:Main.Images.Release Blog.WebHome@191-release-blog--volume-mapping-network-share-detail.png]]
--
  == **Feedback items ** ==
--We have also solved other feedback items besides the flow designer's critical updates.
++//__License Tracker improvements__//
++With this release, we have added several new features available to purchase. On top of that, additional information on the license, such as adding notes and seeing the data sink packets, is now available.
--//__Show status on machine level under Deploy Architecture__//
--With this release we are now able to show the status of the machine when opening the "Details" overview on machine level in Deploy -> Architecture.
++//__Ability to view the message definition for a topic__//
++Currently, you can easily navigate to the message definition of a topic via the context menu in Design, even if there is no event processor linked to the topic.
--//__Improved validation feedback on non-supported WSS4J interceptor __//
--We have improved the validation feedback when someone tries to implement a specific WSS4J interceptor implementation.
++//__Restricted access for uploading custom certificates to endpoints__//
++To improve our cloud offerings' general security and prevent users from uploading the wrong certificates, we have now restricted access to this view to ensure that only the administrator can execute this change. This allows for a discussion between the team implementing the solution and eMagiz before actions are taken.
--//__Improve help text in flow testing on Java classes__//
--We have improved the helptext when you are adding headers to your test message. In this helptext we explain the top five Java classes and how to note them down to make it work in the flow testing functionality and in eMagiz in general.
--
--//__Improved readibility of notification when trying to delete a runtime__//
--When you have forgotten one or more steps when deleting a runtime you will be notified by the system on this. With this release we have improved the readibility of the notification.
--
--//__Improved sorting of missing properties overview__//
--We have improved the sorting on the missing properties overview you will encounter when activating the "check properties" option.
--
--//__Improved notification when error message cannot be found__//
--We have improved the notification when an error message cannot be found from the message redelivery overview in our 3rd generation runtime.
--
--//__Additional lifecycle management overview__//
--We have added an additional lifecycle management overview to the portal in which users with enough permissions can get an overview of the lifecycle "state" of all customer models.
--
--//__Improved feedback when memory settings are negative__//
--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.
--
--//__Auto upgrade for a cloud template default to "ON"__//
--For each new cloud slot we will toggle the "automtatic cloud template update" to "Yes".
--
--//__Removed an irrelevant refresh button on a flow designer component__//
--We have removed an irrelevant refresh button on the standard filter component.
--
--//__Notification list shows all notifications on default__//
--When navigating to the Notification overview in Manage under Alerting you will now see all notifications instead of a filtered list on a specific state.
--
  == **Bug fixes ** ==
--//__Keep selection when copying properties__//
--We have fixed the bug that prevented you from easily copying properties from one runtime to another based on the runtime list.
++//__Improved deletion behavior for enumerations__//
++To prevent that eMagiz will incorrectly delete enumeration lists when you press a "Cancel" button, we have improved the deletion behavior when viewing enumerations in the Create phase of eMagiz.
--//__Check on security header improved for API Gateway__//
--We improved the check in the API Gateway through which we validate whether an API caller is authenticated when using the API Key method to secure the API Gateway.
++//__Prevent "async" api operations__//
++With this release, we have removed the ability to select the "async" option when the default message format is API Management.
--//__Don't show systems with only "external" flows in Design__//
--We fixed a bug that caused systems to appear in Design in cases where there should be none.
++//__Importing a response definition broke the request definition__//
++Currently, importing a response definition breaks the request definition. With this release, we have changed this behavior, ensuring that only the response definition is changed when importing and not the request definition.
--//__Fix styling of mendix login in some occurences__//
--When navigating to a specific URL the default Mendix login page would be shown. With this release we have fixed this behavior.
++//__Removing a flow does not update the API "all-entry" anymore__//
++When you removed a flow from Create, the API Gateway all-entry received a new version of the flow. With this release, we have changed this behavior so that this only happens when the flow you remove is an API-related flow and not when it is a messaging or event streaming flow.
--//__Change timing of wake-up of cloud slots on Friday__//
--To prevent timing issues of waking up cloud slots on the Friday of our deployment we have changed the timing of when the cloud slots are woken up on Friday.
++//__Stop deployment plan when a property is missing__//
++Currently, the execution of your deployment plan continues when eMagiz notices a missing property. As this is confusing for a user and not desirable, we have updated the logic to ensure that when this happens, the execution stops. This allows you to fill in the properties, and once filled in, you can continue with the remainder of the deployment plan.
--//__Fixed a typo in the Topic statistics overview__//
--We fixed a typo in the topic statistics overview.
++//__Cap stack trace of error messages and log entries__//
++To prevent that enormous stack traces of error messages and log entries need to be processed by various systems, we have now limited what is kept so only the relevant information is shown to the user.
--//__Fixed a typo in the HTTP statistics overview__//
--We fixed a typo in the HTTP statistics overview.
--
--//__Activatation of release history when executing a deployment__//
--We ensured that the release history is activated when executing a deployment.
--
  == **Fancy Forum Answers** ==
  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:
--* [[Characters transformed to � when retrieving from DataSink>>https://my.emagiz.com/p/question/172825635703287019||target="blank"]]
--* [[Can I test my API Gateway locally?>>https://my.emagiz.com/p/question/172825635703236592||target="blank"]]
--* [[Deploy stops when updating connector-infra>>https://my.emagiz.com/p/question/172825635703299903||target="blank"]]
++* [[Entry stops polling occasionally since generation 3>>https://my.emagiz.com/p/question/172825635703376768||target="blank"]]
++* [[Invalid datetime>>https://my.emagiz.com/p/question/172825635703389326||target="blank"]]
++* [[Paging with a queue -16>>https://my.emagiz.com/p/question/172825635703389781||target="blank"]]
  == **Key takeaways** ==

Changes for page 198 - Great Migration

Summary

Details

Navigation