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

ComponentRequired releaseNotes
RESTAPI for embedded dashboards (when using standalone or Windows JAR installers)

RESTAPI 2.11.1-funcrel.

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

.

2.8.3-funcrel

Resolved Issues

Customer Ticket IdDetails
42297Fixes an issue where the application resync action fails after an upgrade from Console v1.x to v2.x.

2.8.2-funcrel

Resolved Issues

Customer Ticket IdDetails
41563Fixed an issue that could cause UI to hang for up to a minute after log in.

2.8.1-funcrel

Other Updates

Internal IdDetails
WEBI-14521Fixes an issue where attempting to run only the action "Upload to CAST Imaging" on an application with the status "fully analyzed" will also execute the "Run analysis" action. The analysis action is not required in this situation (already fully analyzed).

Resolved Issues

Customer Ticket IdDetails
40856Fixes an issue present in legacy workflow without Fast Scan: erroneous additional exclusions are added by Console when adding a new version to an analyzed application where exclusions were only configured in the previous version. Note that if duplicate exclusions exist and the application is upgraded to Console 2.8.1-funcrel (or above), the duplicate exclusions will still exist (i.e. these duplicates should be removed before upgrading)..

2.8.0-funcrel

Note

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

Feature Improvements

SummaryDetails
Technical - Improved handing of .lf/.lf38 and .pf/pf38 related source codeWhen .lf/.lf38 and .pf/pf38 files (extracted from IBM i Series) are delivered for analysis, CAST Console will now automatically create SQL Analyzer Analysis Units via the com.castsoftware.dmtsqlfilediscoverer (https://doc.castsoftware.com/display/TECHNOS/Database+File+Discoverer). Previously these files were erroneously handled in RPG analysis units. See https://doc.castsoftware.com/display/TECHNOS/Database+File+Discoverer+-+1.0#DatabaseFileDiscoverer1.0-BehaviourwithregardtoRPGrelatedsourcecodeextractedfromIBMiSeriesinCASTConsole.
UI - Onboarding with Fast Scan - Analysis no longer blockedA change in behaviour has been introduced for those using the onboarding with Fast Scan mode: if CAST Imaging/CAST Dashboards are not configured or are configured but cannot be accessed by CAST Console (network issues for example), the analysis process will no longer be blocked when clicking the Run Analysis button in the Application > Overview panel. Instead, a message will indicate that CAST Imaging/CAST Dashboards cannot be accessed and the analysis will proceed (but no result upload actions will be processed). In previous releases, the entire analysis process is blocked if CAST Imaging/CAST Dashboards cannot be accessed. See https://doc.castsoftware.com/display/AIPCONSOLE/Application+-+Overview+with+Fast+Scan#ApplicationOverviewwithFastScan-runRunanalysis.
UI - Admin Center - Maven RepositoriesAdditional Maven repositories have been added to the list of repositories available in the Admin Center (i.e. for all applications managed in CAST Console) that will be searched by CAST Console during an analysis - see https://doc.castsoftware.com/display/AIPCONSOLE/Administration+Center+-+Settings+-+Maven+Repositories.
UI - Onboarding with Fast Scan - Resume AnalysisWhen using the onboarding with Fast Scan mode, Console will now give you the opportunity to resume the analysis from the same step or a previous step once the issue has been resolved. See https://doc.castsoftware.com/display/AIPCONSOLE/Application+-+Overview+with+Fast+Scan#ApplicationOverviewwithFastScan-Resuminginterruptedjobs for full details.
Technical - Improved handling of missing package alertsUpdates have been implemented with regard to missing package alerts which are displayed as part of the source code delivery process (set as current version step): 1) missing package alerts now only show the missing main package name instead of the specific missing class (this reduces the number of alerts and provides more useful information about what exactly is missing) and 2) alerts are now listed in alphabetical order to improve readability - see https://doc.castsoftware.com/display/ONBRD/Validate+using+progress+window+and+log+messages.
UI - Admin Center - Extension Strategy settingsThe Extension Strategy settings available in the Admin Center have been completely restructured to improve usability and simplify the choice of settings. See https://doc.castsoftware.com/display/AIPCONSOLE/Administration+Center+-+Extensions+Strategy. Note that after upgrade to this release: 1) all settings set in the Extensions Strategy screen available in previous releases will be migrated to the corresponding setting in this new panel. 2) The notion of "whitelisting" an extension has been removed, instead extensions should be blacklisted if they should not be used - if the whitelist was used in previous releases, then this will result in the blacklisting of all non-whitelisted extensions after upgrade to this release.
UI - System Alert for Node Log ServiceA system alert will now be displayed within CAST Console to alert you to a non-functioning Node Log Service - i.e. if the Node Log Service is installed and enabled but the Windows Service has crashed or is not started, a message is displayed. See https://doc.castsoftware.com/display/AIPCONSOLE/Log+Service+installation#LogServiceinstallation-Systemalerts.
Technical - Improved handing of legacy .uax and .src files from the CAST Database ExtractorWhen .uax and .src files (extracted from the legacy CAST Database Extractor) are delivered for analysis, CAST Console will now automatically create SQL Analyzer Analysis Units via the com.castsoftware.dmtsqlfilediscoverer (https://doc.castsoftware.com/display/TECHNOS/Database+File+Discoverer).
UI - Onboarding with Fast Scan - Analysis Report IndicatorsA change has been implemented to ensure that when only CAST Imaging is configured with CAST Console (i.e. CAST Dashboards are not configured), any analysis indicators that require only an analysis to be run rather than a snapshot are displayed in the Analysis Results Indicators section in the Overview page. See https://doc.castsoftware.com/display/AIPCONSOLE/Application+-+Overview+with+Fast+Scan#ApplicationOverviewwithFastScan-AnalysisResultsIndicators. Previously, no indicators were displayed when only an analysis was run.

Other Updates

Internal IdDetails
WEBI-14250When using the Fast Scan onboarding mode, the status of an application is now correctly in sync in both the Application Management page and in the application Overview page. Previously there was a desynchronisation between the application status in the two location (intermediate job step status were displayed erroneously).
WEBI-00000Delivered Engineering Dashboard release: 2.11.1-funcrel. Delivered Health Dashboard release: 2.11.1-funcrel.

Resolved Issues

Customer Ticket IdDetails
32846Fixes an issue where filters on Domains (i.e. checkbox selections) in the Application Management panel are lost when navigating away from the panel and then using the browser's back button to return to the Application Management panel. Now filters choices are retained for the duration of the user session.
37821Fixes an issue where deactivating an Analysis Unit and then running a new analysis does not remove the corresponding results (i.e. objects) from CAST Imaging. Results are now correctly removed from CAST Imaging after deactivating an Analysis Unit and running a new analysis. See also https://doc.castsoftware.com/display/ONBRD/Validate+technology+specific+settings.
40108Fixes an issue where DynamoDB source code is not displayed in the Architecture Map / Architecture Preview panel in the Application > Overview page.
40176Fixes an issue that was occurring when attempting to deliver a new version of an existing application and caused the "add package" step to fail with an error stating "Error: Duplicated Package: <package-name>.castextra already exists".
40180Fixes an issue where Console was setting the wrong path for packages / picking previous version package path when adding a new version and the existing version contained a .castextraction file.
40383Fixes an issue causing the application name filter available in the header to not function correctly for some string combinations.
40404Fixes an issue causing the Service Registry installer (Enterprise mode) to fail when attempting to install it on a Linux host.
39381Fixes an issue where the "Adding extra packages" step in the source code delivery process fails with the error "java.lang.IllegalArgumentException: Host can't be null.".
39692Fixes an issue where RPG related source code files with the extension *.lf and *.pf do not trigger the creation of a SQL Analyzer analysis unit and are instead incorrectly included in a RPG related analysis unit and analyzed with the RPG analyzer. Now, *.lf and *.pf files will trigger the creation of a SQL Analyzer analysis unit and are therefore analyzed correctly.
39042Fixes an issue where it was not possible to restrict a specific extension to a specific release while the global Auto Update option was set to enabled. This is now possible using the new Extensions Strategy UI in the Admin Center. See https://doc.castsoftware.com/display/AIPCONSOLE/Administration+Center+-+Extensions+Strategy.

Known Issues

Internal IdDetails
WEBI-14313When the Fast Scan action is stopped (whether manually or for another reason), it is not currently possible to recover the process and instead the only resolution is to remove the application and start from scratch. This issue will be fixed in a future release.
WEBI-14254When using Enterprise mode with multiple Nodes, and where a snapshot is run on a different Node to the analysis, some information required by CAST Imaging for specific features will be missing. To workaround the issue, ensure that the Application always uses a specific Node. This issue will be fixed in a future release.
WEBI-14467uax and .src files generated by the legacy CAST Database Extractor are not currently correctly handled in CAST Console (the internal detection mechanism cannot yet fully recognise these files as SQL Analyzer related files) and therefore when using the Fast Scan onboarding mode, these file types cannot be viewed in the Fast Scan overview panel.
WEBI-13192When using onboarding with Fast Scan mode and having completed an initial analysis, it is not currently possible to recompute the Analysis Indicator Reports - this issue will be fixed in a future release.

2.8.0-beta3

New Features

SummaryDetails
UI - Switch from legacy to fast scan onboarding mode - betaIt is now possible to switch applications from onboarding without Fast Scan (legacy) mode to fast scan onboarding mode using the CAST Console UI. See https://doc.castsoftware.com/display/AIPCONSOLE/2.8+-+Switch+from+legacy+to+fast+scan+onboarding+mode+-+beta.

Feature Improvements

SummaryDetails
UI - Onboarding with Fast Scan - Run Analysis advanced optionsWhen working in the Overview panel in Onboarding with Fast Scan mode, a new icon has been added in the Run Analysis section which allows you to control what steps in the analysis process are actioned. This button is only enabled when an initial deep analysis has been completed. See https://doc.castsoftware.com/display/AIPCONSOLE/Application+-+Overview+with+Fast+Scan#ApplicationOverviewwithFastScan-runRunanalysis. At the same time, the equivalent green "run analysis" button has been removed from the Application Management > Extensions, Config and Snapshots panels.
UI - Onboarding with Fast Scan - detection of configuration changes before upload to CAST ImagingFollowing an initial deep analysis when working in Onboarding with Fast Scan mode, any change to the application configuration (addition of an Architecture Model, reviewing of Dynamic Links, addition of an Update Application Schema job, transaction configuration, module configuration etc.), a banner is displayed in any tab of the Application Management > Config panel to inform you that a configuration change has been made and that your data should be updated. If the "Update" button is clicked, then a job will run to ensure that all data is correct and prepared ready for the next upload to CAST Imaging job. See also https://doc.castsoftware.com/display/AIPCONSOLE/Application+-+Config#ApplicationConfig-Paneloptionsandbanners.
UI - Alert Notifications for error severity log messagesWhen a log message with an error severity level is encountered in any job run by CAST Console, this will be reported as a notification in the upper right corner of the UI (the bell icon). See https://doc.castsoftware.com/display/AIPCONSOLE/AIP+Console+-+User+interface.
UI - Improved log messages for missing classes (jar)When an analysis is run, previously when missing classes (i.e. jar files) were encountered a message was logged ("Missing classes list when comparing DMT result and framework detector") which is difficult to understand. This message has now been replaced with a more user friendly message: "We are not able to find the artifacts for the following classes. This may impact the results of your analysis. Please check your maven configuration settings or provide manually the missing artifacts."
Technical - Improvements to Log Service - betaIt is now possible to configure the Log Service to highlight specific messaged as notifications using regular expressions (as well as plain strings), i.e. so that more complex patterns can be matched and highlighted as notifications. See https://doc.castsoftware.com/display/AIPCONSOLE/2.7+-+Log+Service+-+beta#id-2.7LogServicebeta-Configuration.
UI - Onboarding with Fast Scan - Resume AnalysisWhen using the onboarding with Fast Scan mode, if one of the following job steps fails, Console will now give you the opportunity to resume the analysis from the same step once the issue has been resolved: Install extensions, Set as current, Update Extensions (rescan), Analysis, Prepare Analysis data, Snapshot, Snapshot indicators, Upload to Measure schema, Upload to CAST Imaging.
UI - Admin Center - Global Configuration - PDS DumpsThe PDS Dumps configuration panel has been updated to allow the entry of specific file extensions in the configuration of a dump type. Previously it was only possible to select Mainframe file types such as copybooks or programs, now it is possible to enter a specific file extension instead, therefore allowing dumps containing other technology such as Perl or ColdFusion to be delivered in this way. See https://doc.castsoftware.com/display/AIPCONSOLE/Administration+Center+-+Settings+-+PDS+Dump and https://doc.castsoftware.com/display/TECHNOS/Mainframe+-+Prepare+and+deliver+the+source+code#MainframePrepareanddeliverthesourcecode-HandlingPDSdumpfiles.

Known Issues

Internal IdDetails
WEBI-14236When upgrading to 2.8.0-beta3, the default PDS Dump entry provided out of the box will contain an erroneous entry in the new "Member file extension" field. The entry COBOL_COPY_BOOK should be manually changed to .cpy if you rely on this default library entry.

2.8.0-beta2

Feature Improvements

SummaryDetails
Technical - Onboarding with Fast Scan - Module creation modeWhen using the onboarding with Fast Scan workflow, the default auto module creation mode for new applications is now set to "Full Content" instead of "per Technology". This means that by default when onboarding a new application, one single module will now be created containing the application's entire source code. In a CAST Console upgrade scenario, existing applications will not be impacted by this change. See also https://doc.castsoftware.com/display/AIPCONSOLE/Application+-+Config+-+Modules and https://doc.castsoftware.com/display/ONBRD/Validate+modules+and+content.
UI - Onboarding with Fast Scan - Analysis Results IndicatorsA new section has been made available in the Overview panel called "Analysis Results Indicators". This section is only visible when CAST embedded Dashboards have been configured and when a deep analysis (with snapshot) has been actioned. This section is already available in the Overview panel for the legacy onboarding without Fast Scan. See https://doc.castsoftware.com/display/AIPCONSOLE/Application+-+Overview+with+Fast+Scan#ApplicationOverviewwithFastScan-AnalysisResultsIndicators.
UI - Legacy onboarding without Fast Scan - Application creation - Select NodeIt is now possible (when using the Legacy onboarding without Fast Scan in Enterprise mode with multiple Nodes) to select a specific Node for the application. Previously this was not possible and Console used its load balancing mechanism to choose the Node automatically. See https://doc.castsoftware.com/display/ONBRD/Application+onboarding+without+Fast+Scan+-+Add+a+new+Application and https://doc.castsoftware.com/display/AIPCONSOLE/Administration+Center+-+Applications+-+Application+Details#AdministrationCenterApplicationsApplicationDetails-nodeNode.
Technical - SMTP settings for email notificationsWhen using Enterprise mode, it is now possible to define SMTP settings for the Console email notification system that applies at a global level. Previously this was only possible for Standalone editon. See https://doc.castsoftware.com/display/AIPCONSOLE/Configuring+email+notifications.

Other Updates

Internal IdDetails
WEBI-14173Fixes a known issue discovered in 2.7.0-funcrel that is causing any user defined module that is configured in any way other than "per technology" to be automatically removed during the analysis process - this occurs when using either of the onboarding workflows (i.e. with or without fast scan).
WEBI-13943Fixes an issue where the sort on the "Status" column in the Application Management panel (https://doc.castsoftware.com/display/AIPCONSOLE/AIP+Console+-+Application+Management) was not working correctly.
WEBI-13862Fixes a minor UI issue in Architecture Studio in the dialog box displayed when creating a new Layer from an Analysis Unit or from a Module: the "Select All" and "Deselect All" buttons were not correctly aligned.
WEBI-14129Fixes issues that occurred when deactivating a specific Analysis Unit from the next analysis job: the Analysis Report section in the Overview panel (for both onboarding with and without Fast Scan) was not updated to show the corresponding removal of the objects belonging to the deactivated Analysis Unit. A side effect of this issue was the objects belonging to the deacivated Analysis Unit were still analyzed (in the next analysis job) and consequently uploaded to CAST Imaging.
WEBI-13928Fixes a minor UI issue in the legacy onboarding workflow when adding a long exclusion path: due to a style sheet issue, the long path was not correctly displayed in the UI and overran the border of the table.
WEBI-14114Fixes a minor UI issue where application backup entries were not displayed in the UI automatically. A manual screen refresh was required. Now completed backups are auto displayed in the list of existing backups.
WEBI-14110Fixes an issue where (when using the onboarding with Fast Scan workflow) additional Filter Rules were displayed in the UI after a deep analysis had been completed. Now all Filter Rules are available for selection/deselection immediately after a Fast Scan has completed.
WEBI-14158Fixes an issue visible when using the onboarding with Fast Scan workflow, having completed an initial deep analysis and where a change was made to the Module creation rule. This change to the Module creation rule was ignored in the next analysis job and the rule was reset to the default "per Technology" rule. Now, customizations to the module creation rule are correctly taken into account.

2.8.0-beta1

Feature Improvements

SummaryDetails
Technical - Support for SAP PowerBuilder 2021, 2022 and 2023Console has been updated to support the analysis of SAP PowerBuilder 2021, 2022 and 2023. This support requires AIP Core ≥ 8.3.50 to be installed on the relevant Node(s). In addition, there are no changes to the requirement to install the SAP PowerBuilder IDE on the Node(s) - see https://doc.castsoftware.com/display/TECHNOS/PowerBuilder+-+Required+third-party+software.
Technical - Node logs ZIP file nameThe name of the ZIP file created when downloading Node Service logs directly from the Console UI in Enterprise mode have been updated to provide clarity: the ZIP file name now includes the Node name (usually the host name) and the port number to help distinguish which Node the ZIP file originates from. See https://doc.castsoftware.com/display/AIPCONSOLE/Administration+Center+-+Nodes#AdministrationCenterNodes-%E2%89%A52.x.
UI - Admin Center - Global Configurations - Maven RepositoriesThe UI has been updated with a note to better explain how to use drag and drop to change the order of Maven repositories (the order in the UI is the order in which the repositories are scanned during the analysis). In addition a link to the documentation has been added in the UI - see https://doc.castsoftware.com/display/AIPCONSOLE/Administration+Center+-+Settings+-+Maven+Repositories.
UI - Onboarding with Fast Scan workflow - Architecture Studio availabilityA change has been made to ensure that an application onboarded with the Fast Scan workflow is available in the Architecture Studio even if the upload to CAST Imaging or a snapshot fails.

Other Updates

Internal IdDetails
WEBI-13418The Measurement schema provided as a prepackaged dump file with Console has been updated to match the Measurement schema provided with AIP Core 8.3.49. This version will be used for the creation of new Measurement schemas. If you wish to upgrade existing Measurement schemas to this release (this is not mandatory) please see the section "Upgrade any existing out-of-date standalone CAST AIP schema" in https://doc.castsoftware.com/display/AIPCORE/SRV+-+Upgrade+Installation.