Known Issues
In MediationZone 9.1, there are the following known issues:
- 1 Installation and Upgrade Issues
- 1.1 Unable to change platform database after installation
- 1.2 Installation Is Not Possible if MZ_HOME Path Contains a Folder Name with Spaces
- 1.3 Installation is Reported as Successful Even if the Platform Fails to Start
- 1.4 Warning Messages Displayed During Installation
- 1.5 Error Occurs When Performing Multiple Installations on a Host with Different UNIX User IDs
- 1.6 Latest Oracle JDBC Driver Versions not Supported
- 1.7 Unable to Upgrade When Using a Symbolic Link as MZ_HOME
- 1.8 Platform Instances and Runtime Data Need to be Removed Post Upgrade
- 1.9 Removing Unused Service Contexts After Upgrading from MediationZone 8
- 2 User Interface issues
- 2.1 New Desktop Issues
- 2.1.1 Database Agent Assignment Tab Value Are Not Cleared
- 2.1.2 Database Agent MIM Browser Need To Click Twice To Close It
- 2.1.3 External Reference Profile Datalist Can Be Altered in Read-Only Mode
- 2.1.4 Login Web UI Will Go To Last Page That Last User Accessed
- 2.1.5 Integer Field Validation Can Be Broken
- 2.1.6 Type Assigned Indication not Shown in MIM Browser
- 2.1.7 Idle Timeout Only Warns the User Once
- 2.1.8 Cannot Login to Multiple Platforms
- 2.1.9 Data Veracity Repair Jobs Show in One Line
- 2.2 Accessibility Issues
- 2.3 Code Editor Issues
- 2.4 Known Differences Between Desktops
- 2.5 Legacy Desktop Issues
- 2.1 New Desktop Issues
- 3 Data Veracity issues
- 3.1 Data Veracity Search Filtering For Some Fields Are Case-Sensitive
- 3.2 Data Veracity Filter's Full Query Is Not Available In Web Native UI
- 3.3 Adding an Empty Query Group With a Parent Condition in Data Veracity Search & Repair Filter Will Result In An Error
- 3.4 Importing Old Data Veracity Collection Agent Workflow Configurations Returned Validation Errors
- 3.5 Data Veracity Filter Are Not Refresh Automatically
- 3.6 Data Veracity New Restricted Fields that were Used for an Existing Repair Rule Not Disabled
- 4 Other issues
- 4.1 Logging Issue
- 4.2 Error Thrown When SAPCC Agent Not Added With Any Host
- 4.3 Inappropriate Validation Handling On Workflow Group Scheduling
- 4.4 Database Forwarding Agent Validation Message
- 4.5 mzsh topo show pico-view Does Not Dispaly Full Information
- 4.6 External References Can Be Removed when a Workflow is Dependent on It
- 4.7 Missing <Agent> - 5G <Field> Parameters in Workflow Table and Workflow Instance Table
- 4.8 The Aggregation Inspector Does not Work with Aggregation Profiles Using External References
- 4.9 File Storage Aggregation Data not Removed when Modifying Profile
- 4.10 Open API Incorrectly Validates Request Body
- 4.11 Data Hub Workflow Aborts With “NoClassDefFoundError”
Installation and Upgrade Issues
Unable to change platform database after installation
It is not possible to change platform database after the installation is completed which used to be a feature that available since 8.x. This issue will be fixed in future releases.
Installation Is Not Possible if MZ_HOME Path Contains a Folder Name with Spaces
If the MZ_HOME path contains spaces the installation will fail. Please ensure the MZ_HOME doesn't contain any spaces before installing.
Installation is Reported as Successful Even if the Platform Fails to Start
In some circumstances during installation the installer may report as successful when the platform has not started.
Warning Messages Displayed During Installation
When the user performs “setup.sh prepare”, a warning message “setSecurityManager will be removed in a future release" is displayed. This does not impact functionality of MZ 9 installation and will be handled in future versions of MZ.
Error Occurs When Performing Multiple Installations on a Host with Different UNIX User IDs
The /tmp/syslog/syslog-debug.log
file is created when a host machine contains an MZ 9 installation. This file will be overwritten by any subsequent MZ 9 installations that are performed on the same host machine with a different UNIX user ID. However, the attempt to overwrite this file will fail and cause errors to the subsequent installations.
To solve this issue, modify the platform.xml
file setting by using the mzsh topo open platform
command. Edit the platform.xml
file, and change the directory to use another directory using the following command: <property name="mz.syslog.debuglogfile.filedir" value="[the directory]"/>
.
Latest Oracle JDBC Driver Versions not Supported
Latest Oracle JDBC drivers such as version 21c and 23c are not supported in this release. Ensure to check the System Requirements for information about supported Oracle database version.
Unable to Upgrade When Using a Symbolic Link as MZ_HOME
Users are encountering issues with symlinks when using them as MZ_HOME during an installation or upgrade due to the java.nio.file.FileAlreadyExistsException
error.
This issue arises from a bug reported under [JDK-8294193] Files.createDirectories throws FileAlreadyExistsException for a symbolic link whose target is an existing directory - Java Bug System (openjdk.org) and has been fixed in JDK 20.
To avoid encountering this error during installation or upgrade, you should use an absolute path instead of a symlink for the MZ_HOME directory.
Platform Instances and Runtime Data Need to be Removed Post Upgrade
Due to some issues with the Desktop cache, platform instances and runtime data must be cleared from the Desktop Launcher, see Removing Instances and Runtime Data.
Removing Unused Service Contexts After Upgrading from MediationZone 8
When upgrading from MediationZone 8 to MediationZone 9, all picos are upgraded resulting in an installation with numerous unused service contexts that should be removed.
To resolve this, you are required to use the mzsh topo
command to manually remove these picos. For more information on the steps, refer to Removing Pico Configurations.
User Interface issues
New Desktop Issues
Database Agent Assignment Tab Value Are Not Cleared
When Value Type is set to "To UDR" or "NULL", the Value column is not cleared.
Database Agent MIM Browser Need To Click Twice To Close It
The MIM browser open from database agent, need to close it by hitting twice on cancel button or the X button to close it.
External Reference Profile Datalist Can Be Altered in Read-Only Mode
When certain procedures are made, it is possible to alter the data list found in the external reference profile while the read-only mode is used. This causes a system-wide DRRCPException to be thrown.
Login Web UI Will Go To Last Page That Last User Accessed
User A log out from web UI, and User B login, it will automatically go to the page last accessed by User A.
Integer Field Validation Can Be Broken
Inputing integer values outside of the expected range can break the validation in the UI.
Type Assigned Indication not Shown in MIM Browser
This can be viewed in the Legacy Desktop if required.
Idle Timeout Only Warns the User Once
Inactive users will be logged out after a configurable period, following a warning to that effect. If a user is active after the warning they won't be logged out, but if they are inactive again then they will be logged out with no warning.
Cannot Login to Multiple Platforms
It is not currently possible to login to multiple separate platforms using the new UI in one browser. Users can use different browsers, incognito modes, or the Legacy Desktop if this is required.
Data Veracity Repair Jobs Show in One Line
When viewing the repair jobs in the new UI they are displayed in one line which is hard to read.
Accessibility Issues
The new web-native desktop aims to be fully accessible, but there are currently some outstanding issues regarding this. These include:
In some interfaces, the keyboard navigation doesn't follow the ideal order or convention
Incorrect behavior of radio buttons
Code Editor Issues
The code editor in the new web-native desktop provides code completion and syntax highlighting there are some known issues with syntax highlighting not being correct, it is not possible to add tabs to code and code completion cannot be activated on a Mac if multiple keyboard layouts are enabled.
When attempting to use the code completion function in agents or profiles, for example, the Analysis agent, the built-in keyboard shortcut of Command + Space on a Mac computer will not trigger the code completion dialog box.
Known Differences Between Desktops
There are some known, minor issues with differences between the two Desktops.
Legacy Desktop Issues
In the Legacy Desktop an exception may occur when you first log in to the Platform. If you log in again the exception is not shown.
Data Veracity issues
Data Veracity Search Filtering For Some Fields Are Case-Sensitive
The filtering for the source_node and message fields in the Data Veracity Search & Repair table are case-sensitive.
Data Veracity Filter's Full Query Is Not Available In Web Native UI
The full filter query for Data Veracity is not available for viewing in the web UI. A partial display of the query can be seen in the filter listing under Data Veracity > Filter listing.
Adding an Empty Query Group With a Parent Condition in Data Veracity Search & Repair Filter Will Result In An Error
Attempting to add an empty query group with a parent condition will cause an error to be thrown upon clicking OK. A sample of the query setup is shown below.
Importing Old Data Veracity Collection Agent Workflow Configurations Returned Validation Errors
If you have an old Data Veracity Collection Agent Workflow configuration from version 8.x, it is possible that validation errors about invalid Analysis Agents may occur.
Example error during import:
|
Example error when viewing the invalid workflow Analysis Agent configuration:
|
To resolve this, you will need to re-add the Data Veracity UDR for Analysis Agent input UDR Types or use the Set To
Input button if applicable. After adding the appropriate Analysis UDR Types, save the workflow configuration.
Data Veracity Filter Are Not Refresh Automatically
The Filter page is not always the latest, after creating a new Filter from the Data Veracity Search page, you may need to click the Refresh button to view it.
Data Veracity New Restricted Fields that were Used for an Existing Repair Rule Not Disabled
If setting a new restricted field that was used in a previously created Repair Rule, it is expected that the rule on the said field should gray out when viewing the saved Repair Rule and be ignored when applying repair tasks. However, the rule on the said field still appears to be editable in the old Saved Repair Rule.
Other issues
Logging Issue
When logging out of the legacy desktop desktop_current.log has unnecessary logs added
Error Thrown When SAPCC Agent Not Added With Any Host
In the SAP CC Batch agent, do not add any host, click the Save As button, and you will find the error shown below:
java.lang.NullPointerException: Cannot invoke "String.matches(String)" because "hosts" is null
Inappropriate Validation Handling On Workflow Group Scheduling
In Workflow Group Scheduling, when adding a duplicate execution day plan, it prompts the wrong validation message content and if the user continues to save, scheduling data will be wiped off.
Database Forwarding Agent Validation Message
In Database Forwarding Agent, when we have a field NULL/To UDR, the validation message that prompted does not properly describe the problem.
mzsh topo show pico-view Does Not Dispaly Full Information
The mzsh topo show pico-view does not show the pico names in the output. Picos can be viewed in the Desktops
External References Can Be Removed when a Workflow is Dependent on It
External references of the type Database Properties can be removed even if they are in use. Any workflows using these references will become invalid.
Missing <Agent> - 5G <Field> Parameters in Workflow Table and Workflow Instance Table
The HTTP2_Server_1 - 5G - 5G Profile, HTTP2_Server_1 - 5G - Primary NRF Address, and HTTP2_Server_1 - 5G - Secondary NRF Addresses parameters in version 8.3.2.X are missing from the Workflow Table and workflow instance table when upgrading from version 8.3.2.1 onwards to MediationZone 9.
The '<agent> - 5G - <field>' parameters in version 8.3.2.X
This is because the three parameters are classified under a different sub-category, the '5G Support' as HTTP2_Server_1 - 5G Support - 5G Profile, HTTP2_Server_1 - 5G Support - NRF Address, and HTTP2_Server_1 - 5G Support - Secondary NRF Address.
The '<agent> - 5G Support - <field>' parameters in MediationZone 9
If the existing workflow contains these parameters from the older version, users are required to configure them under the new '5G Support' sub-category.
The Aggregation Inspector Does not Work with Aggregation Profiles Using External References
If you have an Aggregation profile using External References, the session data will not be visible in Aggregation Inspector. To solve this, you can update the Aggregation profile to not use External References once the session data has been made available, the data will then be visible in Aggregation Inspector.
File Storage Aggregation Data not Removed when Modifying Profile
If you have an Aggregation profile with File storage selected and select to change the Storage Host or the Directory, or change to a different storage type, you will have to manually remove data. However, if this is done in the Legacy Desktop, data will automatically be removed.
Open API Incorrectly Validates Request Body
Users are encountering an issue with request body validation when using a schema file that includes discriminator
and oneOf
keywords in the same schema object. This issue arises due to a limitation in the library implementation.
There is an existing ticket logged on this issue, see https://bitbucket.org/atlassian/swagger-request-validator/issues/771/discriminator-is-not-working-with-oneof. To work around this issue, you can disable request validation for requests containing the schema object.
Data Hub Workflow Aborts With “NoClassDefFoundError”
Users might encounter a “NoClassDefFoundError” in Data Hub Forwarding agent in MediationZone9.1.1. This is caused by an unintentional removal of a library dependency. To resolve this, the change will be reverted in the subsequent service pack release of MediationZone 9.1.