CAST highly recommends updating to the new release of Console to take advantage of new features and bug fixes. See Upgrade process for more information about this.

Compatibility matrix

Component Required release Notes
Installer for embedded dashboards (when using standalone or Windows JAR installers)

2.11.2-funcrel

You must use the installer provided with the current release of Console, otherwise there is no guarantee of compatibility.
CAST Imaging ≥ 2.5.2-funcrel -

.

2.10.5-funcrel

Other Updates

Internal Id Details
WEBI-16194 A fix has been implemented to prevent very fast "logs" polling rate in the job progress page, which is causing browser performance issues.

Resolved Issues

Customer Ticket Id Details
45866 Fixes an issue where post upgrade to 2.10, the system proxy settings defined within CAST Imaging Console are no longer working.
44639 Fixes an issue causing the swagger API interaction URL to not function.

Other Updates

Internal Id Details
WEBI-16246 An issue exists where using a manual proxy that excludes the extend.castsoftware.com address still allows extensions to be downloaded via ExtendCli.

2.10.4-funcrel

Resolved Issues

Customer Ticket Id Details
44632 Fixes an issue causing the following error and failed analysis "java.nio.file.InvalidPathException: Trailing char < > at index xxx".
44231 Fixes an issue causing the following error and failed analysis "java.lang.NullPointerException: Cannot invoke "java.lang.Comparable.compareTo(Object)" because "left" is null".
44767 Fixes an issue causing the following error and failed analysis "java.nio.file.InvalidPathException: Illegal char <">".

2.10.3-funcrel

Resolved Issues

Customer Ticket Id Details
44112 A change has been implemented to ensure that in an in-place upgrade scenario, the installer will now remove obsolete Java related libraries installed with a previous release. This will ensure libraries are updated properly.
44178 The Apache ActiveMQ library has been updated to 5.16.7 to resolve a CVE found in a previous version.

Known Issues

Internal Id Details
WEBI-15983 A known issue exists in this release: when upgrading an existing installation of your Node service or Console Standalone, if your "Program data folder" is located within the "Installation Folder", the "Program data folder" will be deleted and replaced with a fresh installation configuration. For example, if you have installed to C:\CAST\AipNode and set your "Program data folder" to C:\CAST\AipNode\data, the "data" folder will be deleted and replaced with default values. Therefore if you need to apply this maintenance release in an in place upgrade scenario, ensure that you backup your data folder BEFORE you run the installer. When the install is complete, copy the backed up data folder back into the existing location and overwrite the default settings applied by the installer. If your "data" folder is not located within the main installation folder, then you can proceed with an in-place upgrade without performing a backup since the known issue is not present.

2.10.2-funcrel

Feature Improvements

Summary Details
Profiler CLI automated update from CAST Extend The Profiler CLI (which is used in Console to scan the source code delivery to determine the contents) will now be updated directly from CAST Extend allowing new releases and updates to be automatically applied.

Other Updates

Internal Id Details
WEBI-15667 Fixes various Java JVM related issues preventing the Node Log Service from being installed.
WEBI-15721,WEBI-15763 Fixes issues related to timeout and other crashes caused by the Profiler CLI (which is used in Console to scan the source code delivery to determine the contents).

Resolved Issues

Customer Ticket Id Details
43693 Fixes an issue preventing using Named Application License Keys to onboard applications in Fast Scan onboarding mode, whereas the same key functions correctly when working in legacy onboarding mode (without Fast Scan).
42947 Fixes an issue preventing users from triggering an upload to dashboards when using the Fast Scan onboarding mode via the "Advanced" Run Analysis options, even though the integrated dashboard is deployed and configured correctly.

2.10.1-funcrel

Other Updates

Internal Id Details
WEBI-15682 Fixes an issue with the embedded profiler used during the Fast Scan which causes an error when the source code of the application contains no programming language or no markup files.

Known Issues

Internal Id Details
WEBI-15667 The Log Service Windows Service fails to install with an error message entitled "File execution returned 255" containing "<path_to_JAVA_HOME> was unexpected at this time". This issue occurs when the JAVA_HOME environment variable contains a path with white space, typically if the JAVA_HOME points to a path in %PROGRAMFILES%. The workaround is to 1) edit the JAVA_HOME environment variable to use a Windows short path (run "dir /x" in a CMD window to find the short path for a specific folder), 2) re-run the entire installation using the existing install paths.

2.10.0-funcrel

Note

All new features and improvements added in previous 2.10.0 beta releases are also included in this release. See the corresponding release notes for more information.

Additional points:

  • a limitation that existed in 2.10.0-beta2 with regard to the way existing Architecture Studio models which are associated to an application are handled during an upgrade scenario (to 2.10 or above) has been resolved (this is related to a feature update to improve the management of Architecture Studio models). Now, existing Architecture Models will be be correctly upgraded in either of the following situations: 1. when the prepare analysis data step is run OR 2. when the Application > Config > Architecture page is clicked for the first time after the upgrade.

  • a limitation that existed in 2.10.0-beta2 with regard to the impossibility to assign a new version of an existing Architecture Studio model to an application has now been fixed.

Feature Improvements

Summary Details
UI - Application Management - Overview page for onboarding with Fast Scan Several UI changes have been implemented based on the change introduced in 2.10.0-beta4 (use of CAST Profiler): 1) Two new sections using information provided by CAST Profiler have been added to provided greater details: "Complete File Inventory" and "Technology Stack / Framework / Package Inventory", 2) The existing "Architecture Preview" section has been modified to use the information provided by CAST Profiler (more accurate) and therefore the "look and feel" has changed. See https://doc.castsoftware.com/display/AIPCONSOLE/Application+-+Overview+with+Fast+Scan.
UI - Mainframe Updates have been made to prepare the UI for the addition of three new Mainframe specific analysis options that will be made available with AIP Core 8.3.54 and Mainframe Analyzer (com.castsoftware.mainframe) 1.2.0: 1) Save only Referenced Data, 2) Save Cobol literal, 3) Save Cobol Conditional test.
Technical - CAST Profiler The CAST Profiler (https://profiler.castsoftware.io/) engine is now used to generate the initial technology detection results (for both Fast Scan and legacy onboarding), replacing the internal component known as the Framework Detector. This change aligns CAST Console with CAST Profiler and brings improved scanning performance. Some minor differences in language and technology classification as well as line count methodology do exist, therefore the results for the same application using the new and old engine are not directly comparable. In addition, in a CAST Console upgrade scenario (i.e. upgrading from a previous release), some parts of the existing Fast Scan results for existing applications will not be available - the "Update Data" button in th banner at the top of the Application Overview page should be clicked (https://doc.castsoftware.com/display/AIPCONSOLE/Application+-+Overview+with+Fast+Scan#ApplicationOverviewwithFastScan-zipZipContent/FolderContent) to force the generation of new Fast Scan results with the CAST Profiler engine.
Technical - Log Service alerts Many updates have been implemented for the Log Service alert system to refine and improve this feature (see https://doc.castsoftware.com/display/AIPCONSOLE/AIP+Console+-+Job+Progress+panel#AIPConsoleJobProgresspanel-RighthandAlertspanel for general information), including: 1) Pattern matching for custom alerts can now be configured in the Admin Center (see https://doc.castsoftware.com/display/AIPCONSOLE/Administration+Center+-+Settings+-+Alert+Settings) 2) A system alert is generated if the log service is not installed/not running, 3) Alerts can be downloaded in the UI, 4) Alerts now feature a "Remedy" button to help explain what to do when with an alert.

Other Updates

Internal Id Details
WEBI-15204 UI - Application Management - Overview page for onboarding with Fast Scan: a change in the behaviour has been implemented to ensure that ALL files (regardless of whether they can be analyzed or not) are displayed in the "ZIP Content/Folder Content" section. See https://doc.castsoftware.com/display/AIPCONSOLE/Application+-+Overview+with+Fast+Scan#ApplicationOverviewwithFastScan-zipZipContent/FolderContent.
WEBI-15237 Ensures that when the analysis and upload to CAST Imaging jobs (only) are used (a snapshot is not run) and when an Architecture Model has been assigned to an application (but not installed) that the jobs now include the "update extension" and "prepare snapshot data" steps. In turn this ensures that the Architecture Studio model is correctly installed during the jobs.

Resolved Issues

Customer Ticket Id Details
41379 The documentation has been updated to better explain how to configure Keycloak to interact with an LDAP provider such as Microsoft Active Directory - see https://doc.castsoftware.com/display/AIPCONSOLE/Configure+authentication+and+roles+using+Keycloak+-+v.+2.x#ConfigureauthenticationandrolesusingKeycloakv.2.x-LDAPauthentication.
41182 Fixes an issue that occurs when Console has two or more nodes configured to use an Extend Local Server, and where a change has been made in a bundle which is then uploaded to Extend Local Server: one or more of the Nodes keep failing to connect to Extend Local Server because their Extend API key stored in the H2 database is corrupt due to the presence of unusual characters.
41257 Fixes an issue where the legacy "File Extensions" panel does not report any files for even after an analysis has been run. This issue is caused by the type of source code package used for this specific technology (PeopleSoft/Siebel/ Oracle Forms extractions/Database extractions) - Console does not consider these files to be valid source code files. In this specific case, the message in the "File Extensions" panel has been changed to "No file available for this technology".
43130 Fixes an issue where one of the default Maven repositories (https://mvnrepository.com/artifact) could not be accessed during the analysis (this is flagged in the analysis log). In fact, this is an invalid repository and was erroneously added to the list of default repositories available in Console. It has now been removed.
42736 Fixes an issue impacting the legacy onboarding workflow (without Fast Scan) where the Analysis Reports panel in the Application Overview page was not displaying accurate data. This was found to be caused by an erroneous handling of a change in the source code structure between two analyses where additional source code folders were added in the root.
42590 A documentation update was made to better explain that the "Analysis Reports" panel in the Application Overview page (for an onboarding with Fast Scan) displays data for the most recent analysis and therefore if a "New Scan" is run (with changed source code), a new analysis needs to be actioned before the "Analysis Reports" panel will update.
41895 The documentation for configuring SAML in Keycloak has been updated to remove an incorrect step which suggested downloading an Identity Provider XML metadata file generated by Keycloak. See https://doc.castsoftware.com/display/AIPCONSOLE/Configure+authentication+and+roles+using+Keycloak+-+v.+2.x#ConfigureauthenticationandrolesusingKeycloakv.2.x-SAMLauthentication. The documentation now assumes that the Identity Provider XML metadata file will be provided by the network adminisitrator.
42655 The documentation has been updated to explain (when working in Enterprise mode on Microsoft Windows) that dependencies exist between the various Microsoft Windows services and recommends setting some to "Automatic (Delayed Start)" to give time for dependent services to complete their start up routine. See https://doc.castsoftware.com/display/AIPCONSOLE/2.x+-+Enterprise+mode+-+Installation+of+Console+front-end+via+global+Windows+Installer#id-2.xEnterprisemodeInstallationofConsolefrontendviaglobalWindowsInstaller-Step2-EnsureallConsoleservicesareupandrunning and https://doc.castsoftware.com/display/AIPCONSOLE/2.x+-+Enterprise+mode+-+Installation+of+AIP+Console+front-end+via+Java+JAR+installers#id-2.xEnterprisemodeInstallationofAIPConsolefrontendviaJavaJARinstallers-Ensureallservicesareupandrunning.
41785 Fixes an issue where (when using onboarding with Fast Scan mode) files that were uploaded but could not be analyzed (i.e. were not deemed to be programming files) are not displayed in the "Zip Content/Folder Content" panel in the "Application Overview page". Now all files, regardless of whether they can be analyzed or not, are displayed. See See https://doc.castsoftware.com/display/AIPCONSOLE/Application+-+Overview+with+Fast+Scan#ApplicationOverviewwithFastScan-zipZipContent/FolderContent.
41924 Fixes an issue where (when using onboarding with Fast Scan mode) files that were uploaded but could not be analyzed (i.e. were not deemed to be programming files) are not displayed in the "Zip Content/Folder Content" panel in the "Application Overview page". Now all files, regardless of whether they can be analyzed or not, are displayed. See See https://doc.castsoftware.com/display/AIPCONSOLE/Application+-+Overview+with+Fast+Scan#ApplicationOverviewwithFastScan-zipZipContent/FolderContent.
41261 Fixes an issue where the Console GUI hangs in processing stage when adding a version during rescan, so unable to proceed further with adding the version.
41650 Fixes an issue where the Console GUI hangs in processing stage when adding a version during rescan, so unable to proceed further with adding the version.
42096 Fixes an issue where the Console GUI hangs in processing stage when adding a version during rescan, so unable to proceed further with adding the version.
42188 Fixes an issue where the Console GUI hangs in processing stage when adding a version during rescan, so unable to proceed further with adding the version.
43307 Fixes a UI issue where the "Last Execution" runtime (displayed in the dialog box displayed when actioning a job) was missing the number of days (if the estimation was that long): it only displayed the hours and minutes.
40107 Fixes an issue where the "Architecture Preview" in the "Application Overview panel was incorrectly listing a React Native (mobile app) framework as a React (desktop app) framework. With the integration of CAST Profiler, this issue is resolved.
43342 Fixes an issue where the Fast Scan fails with an error "Detect Framework completed with non-zero error code : -1".

2.10.0-beta4

Feature Improvements

Summary Details
UI - Administration Center - CAST Highlight Settings Changes have been made to the CAST Highlight Settings panel in the Administration Center as follows: 1) The field "Client ID" has been added as an optional entry - populating this filed will ensure that CAST Console will generate a System Alert when the CAST Highlight token has expired (without the Client ID entry, CAST Console does not know when the token expires), 2) When the Highlight entries are saved, the com.castsoftware.highlight2mri extension will be automatically added to the Force Install list in the Extensions Strategy panel in the Administration Center, ensuring that the extension is automatically installed for all existing applications during the next analysis and for all new applications by default. See https://doc.castsoftware.com/display/AIPCONSOLE/Administration+Center+-+Settings+-+CAST+Highlight+Settings, https://doc.castsoftware.com/display/TECHNOS/Highlight+2+MRI+-+1.0 and https://doc.castsoftware.com/display/AIPCONSOLE/Administration+Center+-+Extensions+Strategy.
Technical - CAST Profiler The CAST Profiler (https://profiler.castsoftware.io/) engine is now used to generate the initial Fast Scan results, replacing the internal component known as the Framework Detector. This change aligns CAST Console with CAST Profiler and brings improved scanning performance. Some minor differences in language and technology classification as well as line count methodology do exist, therefore the results of the Fast Scan for the same application using the new and old engine are not directly comparable. In addition, in a CAST Console upgrade scenario, some parts of existing Fast Scan results for existing applications will not be available - the "Update Data" button should be clicked in the Application Overview page (https://doc.castsoftware.com/display/AIPCONSOLE/Application+-+Overview+with+Fast+Scan#ApplicationOverviewwithFastScan-zipZipContent/FolderContent) to force the generation of new Fast Scan results with the CAST Profiler engine.
UI - Architecture Studio models - publishing improvements It is now possible to publish multiple quality models in one go. Previously, only one quality model could be published in one go. See https://doc.castsoftware.com/display/AIPCONSOLE/AIP+Console+-+Architecture+Studio+-+Publishing+models#AIPConsoleArchitectureStudioPublishingmodels-Step2-Publication.
UI - Alert display Two updates have been implemented with regard to the display of alerts in the UI: 1) Alerts can now be searched/filtered based on a search string, 2) All alerts for the current job can now be downloaded to a CSV file for further investigation. See https://doc.castsoftware.com/display/AIPCONSOLE/AIP+Console+-+Job+Progress+panel#AIPConsoleJobProgresspanel-RighthandAlertspanel.
UI - Administration Center - Alert Settings A new panel has been introduced in the Administration Center - Global Configurations section. This panel allows you to add and edit custom patterns (string or regular expressions) to match specific entries in the analysis log. When a pattern is matched, an alert is generated in the alert panel in the Job Progress window. A selection of default patterns are provided with CAST Console (these can be removed if required). The custom patterns were previously managed in the .yml properties file: if you have configured custom patterns in this way in previous releases, CAST highly recommends that you retain them before upgrading to this release: these custom patterns are not managed and are ignored by the Alert Settings panel in the Administration Center. See https://doc.castsoftware.com/display/AIPCONSOLE/Administration+Center+-+Settings+-+Alert+Settings.
UI - Custom alert display - alert grouping Multiple occurrences in a job of matched custom alert patterns (that have been added to the Administration Center - Alert Settings panel) will all be grouped together in one single alert in the UI. This is to avoid the generation of multiple alerts for the same matched string. See https://doc.castsoftware.com/display/AIPCONSOLE/Administration+Center+-+Settings+-+Alert+Settings#AdministrationCenterSettingsAlertSettings-Alertgroupings.

Known Issues

Internal Id Details
WEBI-15409 The search/filter field for job alerts does not empty when the alert panel/job progress panel is closed and then re-opened. This will be fixed in a future release.
WEBI-15410 When a new alert pattern is added into the Administration Center - Alert Settings panel, the string is not cleared from the add dialog box when another new pattern is added. This will be fixed in a future release.
WEBI-15398 When a new alert pattern is added and it fails (because the pattern is identical to an existing pattern), the failure message is unclear and does not provide an explanation why it failed. This message will be improved in a future release.

2.10.0-beta3

Feature Improvements

Summary Details
UI - New job alert icon A new job alert icon has been added in various places throughout the UI: 1) At the top of the Application Overview page (for onboarding with Fast Scan only), 2) In the Application Logs panel. This new icon (a red alert indicator) signifies that the most recent job contains alerts that may need to be investigated. Clicking the icon will display the list of alerts in a slide out panel. When no alerts are raised for a given job, then the icon is no longer visible. See https://doc.castsoftware.com/display/AIPCONSOLE/Application+-+Overview+with+Fast+Scan#ApplicationOverviewwithFastScan-Header and https://doc.castsoftware.com/display/AIPCONSOLE/Application+-+Logs.

Other Updates

Internal Id Details
WEBI-15064 Back-end changes have been implemented to improve the performance (loading time) of the Applications > Extensions panel in the UI.

2.10.0-beta2

Feature Improvements

Summary Details
UI - Removal of the "Path Matching" dialog box for "New Scan" action for applications onboarded with Fast Scan The "Path Matching" dialog box - see https://doc.castsoftware.com/display/AIPCONSOLE/Path+matching+option+for+source+code+delivery+rescan (which was previously displayed when the "New Scan" button was clicked for an application that has already been analyzed and where Console has detected changes in the new source code structure) has been removed. This change means that for each new scan a brand new "version" is now created, instead of a "clone version" action. In turn this means that any customization set at Analysis Unit level will be lost and will need to be re-configured.
UI - Performance improvement for "Application > Extensions" panels The performance (i.e. response time) for the "Application > Extensions" (Included and Available) panels has been improved.
UI - Performance improvement for the display of the "Job Progress" panel The performance (i.e. display time) for the "Job Progress" panel (displayed when a new job is launched) has been improved.
UI - Performance improvement for the display of the "Overview" panel in onboarding with Fast Scan mode The performance (i.e. display time) for the "Overview" panel in onboarding with Fast Scan mode has been improved via the introduction of a cache system. Now, when returning to the "Overview" panel (after it has already been displayed once), display should be much quicker.
Technical - Force Install for com.castsoftware.highlight2mri The extension com.castsoftware.highlight2mri (Highlight to MRI) is now set to "Force Install" in the Extensions Strategy settings, meaning that for each new application created in Console, this extension will always be installed and used. See https://doc.castsoftware.com/display/AIPCONSOLE/Administration+Center+-+Extensions+Strategy#AdministrationCenterExtensionsStrategy-Forceinstalledextensions and https://doc.castsoftware.com/display/AIPCONSOLE/Administration+Center+-+Settings+-+Extensions+Strategy#AdministrationCenterSettingsExtensionsStrategy-Forceinstalledextensions.
Technical - CAST Highlight token expiry warning A system alert is now displayed in the Console UI when the configured CAST Highlight token will expire in 15 days or less. Previously the alert was only shown when the token had expired.
UI - Architecture Studio models - management improvements Following on from the improvements introduced in 2.10.0-beta1 with regard to the management of Architecture Studio models, additional improvements have now been implemented: 1) when a new version of an existing model is created and that model is already associated with an application, it is now possible to choose the new model version (previously this was not possible), 2) Models that have already been associated with an application can now be removed from the application use a "Delete" icon (previously this was not possible)., 3) Multiple models can be associated to an application at the same time (previously this was not possible). See https://doc.castsoftware.com/display/AIPCONSOLE/Application+-+Config+-+Architecture and https://doc.castsoftware.com/display/AIPCONSOLE/AIP+Console+-+Architecture+Studio+-+Publishing+models.

Other Updates

Internal Id Details
WEBI-15214 Minor update to remove the "Application Version" selection switch in the "Config > Extensions > Included" panel for applications onboarded with Fast Scan. The switch remains for applications onboarded in legacy mode without Fast Scan.
WEBI-15227 Minor update to remove the "Application Version" column in the table in the "Config > Snapshots" panel for applications onboarded with Fast Scan. The column remains for applications onboarded in legacy mode without Fast Scan.
WEBI-15115 Minor updates to labels in the UI: 1) "Full analysis" has been changed to "Deep analysis" in all locations, 2) "Black List" has been changed to "Deny List" in the "Admin Center > Extensions Strategy" panel.
WEBI-15115 Minor updates to the wording in the "Extensions Strategy" panel in the Admin Center: the wording "blacklist" has been replaced with "deny list".

Known Issues

Internal Id Details
WEBI-15099 When upgrading to this release, models that are already associated with an existing application are not handled and will not be associated to the application after an upgrade. This will be fixed a future beta release.

2.10.0-beta1

Feature Improvements

Summary Details
Technical - Availability of the "Upload to CAST Imaging" option with application upgrade A modification has been applied to both Enterprise and Standalone deployment modes to ensure that it is possible to use the "Upload to CAST Imaging" option post an application upgrade to a new release of AIP Core on the Node, without needing to run a new analysis (previous releases of Console require that a new analysis is also run before the Upload to CAST Imaging option is made available). In addition, for Standalone deployments, the "Upload to CAST Imaging" option will be available even if the application has not yet been upgraded to the release of AIP Core running on the Node responsible for the application (previously an upgrade was required, and is still required for Enterprise deployments). This change will make it easier and less time consuming to upload an application to CAST Imaging. See also https://doc.castsoftware.com/display/DASHBOARDS/Application+and+schema+upgrade+using+AIP+Console.
UI - Architecture Studio models - Add to application The way in which Architecture Studio models are added into existing applications so that they are taken into account in the next analysis has been improved in this release: now, models can be directly added using the Config > Architecture panel at application level via the "Add" button. Note that the "Install Extensions" action is still required (which can be actioned manually or automatically as part of the next analysis). In previous releases, it was necessary to add the model via the Extensions panel at application level. See https://doc.castsoftware.com/display/AIPCONSOLE/Application+-+Config+-+Architecture.
UI - Architecture Studio models as extensions Architecture Studio models that have been published as an extension are not longer visible in the Application > Extensions panel. Instead, Architecture Studio models are now added directly to an Application in the Config > Architecture panel as described above.
UI - Onboarding with Fast Scan - Alert grouping Some messages (those resulting from "Missing JAR files" and "Analysis Indicators") are now grouped into one single alert, rather than each message being displayed in one alert. In addition, when looking at the corresponding log file for "Missing JAR file" alerts, the same is true: multiple messages are grouped together in the log, rather than being displayed where they occurred. This improves readability by reducing the total number of alerts that may be displayed. See also https://doc.castsoftware.com/display/AIPCONSOLE/2.9+-+Onboarding+with+Fast+Scan+-+redesigned+job+progress+screen#id-2.9OnboardingwithFastScanredesignedjobprogressscreen-RighthandAlertspanel.

Known Issues

Internal Id Details
WEBI-15161 The banner displayed when adding an Architecture Studio model into an application states "Install Extensions" instead of "Install Models".
WEBI-15162 The table listing existing Architecture Studio models that have been added to an Application does not state whether the model has been installed or not.
WEBI-15164 The Config > Architecture feature does not currently allow users to re-add a model that already exists in the table (for example when the model has been updated to a new version).