During the upgrade process, the following actions will have been performed:

• Regardless of the Assessment Model Upgrade Option you chose in CAST Server Manager (see Preparing for upgrade for an explanation of the available options), the existing Assessment Model assigned to the Dashboard Service schema at the point of upgrade will have been upgraded and two copies of this Assessment Model will have been created:
  
  • one with the new CAST AIP 8.3.x Quality Rules merged in and enabled (Preserve Assessment Model customizations, activate new rules from AIP 8.3.0)
  • one with the new CAST AIP 8.3.x Quality Rules merged in and disabled (Preserve Assessment Model customizations, leave new rules disabled) 
• If the Use default Assessment Model from CAST AIP 8.3.0 option was chosen, a new default Assessment Model from CAST AIP 8.3.x will have been created and any Assessment Model fragments from CAST AIP Extensions that were present in the Assessment Model assigned to the Dashboard Service schema at upgrade time will have been merged into this new Assessment Model.
  
• One of the above mentioned Assessment Models will have been assigned to the upgraded CAST Dashboard Service, dependent on the Assessment Model Upgrade Option you chose in CAST Server Manager (see Preparing for upgrade for an explanation of the available options)
  
• Any Assessment Models present in the Assessment Models view in the CAST Management Studio but not assigned to the Dashboard Service schema at the point of upgrade (unassociated Assessment Models) will have been upgraded with the Preserve Assessment Model customizations, leave new rules disabled option.

Assessment Model labels 

 Assessment Models in the Assessment Models view will be labelled as follows after the upgrade:

Validation message

If there are now more than three Assessment Models in the Assessment Models view in the CAST Management Studio following the upgrade process, a message will be logged in the Validation view:

The full message states as shown below. CAST highly recommends that you remove any Assessment Models that you no longer require so as to improve performance. You can export the Assessment Models to file (using the File > Export File option in the CAST Management Studio) prior to removing them.

Warning : There are more than 3 Assessment Models declared in the current management base, 
this can degrade the performances of CAST Management Studio. You should consider removing those which are no longer needed.

CAST highly recommends that this comparison process is completed so that you can identify the differences between the OLD and NEW Assessment Models, however, it is not a mandatory part of the upgrade process and you can skip the step if you prefer not to do this. See Assessment Model comparison process for more information.

If you have used the CAST Siebel extension and have generated a snapshot in the previous release of CAST AIP, then you must follow the instructions explained in the Siebel extension documentation about re-running the Vanilla analysis BEFORE you generate a new snapshot with the new release of CAST AIP. Please see Note about running a CAST AIP upgrade or an Extension upgrade for more information.

CAST has provided support for analyzing SAP BusinessObjects source code via its BO Analyzer (provided out-of-the-box in CAST AIP ≤ 8.2.x) for some time now. This "legacy" analyzer requires the following:

• SAP BusinessObjects (the BO Designer module) must be installed on the workstation on which the CAST Management Studio is being run from.
• you must manually define a connection to the SAP BusinessObjects instance on which your Universe files are used - this instance must be available during the analysis process in the CAST Management Studio - this is known as an "online" analysis.

These requirements can sometimes present significant difficulties for the process of on-boarding a SAP BusinessObjects application into CAST AIP. As a direct result of this and wanting to simplify the approach, CAST has developed the SAP BusinessObjects Analyzer as a standalone extension. The extension (introduced in CAST AIP 8.2.5) provides a means to analyze SAP BusinessObjects source code "offline", i.e. no connection to the SAP BusinessObjects instance is required. In addition there is no longer any requirement to have BusinessObjects (the BO Designer module) installed on the workstation on which the CAST Management Studio is being run from.

From CAST AIP ≥ 8.3.x, the legacy BO Analyzer (provided out-of-the-box in CAST AIP) is no longer available, therefore for upgrades to CAST AIP ≥ 8.3.x, existing SAP BusinessObjects analyses will no longer function and will block the post-upgrade consistency snapshot. As such, CAST highly recommends that you transition to the SAP BusinessObjects Analyzer BEFORE you generate a post-upgrade consistency snapshot (see Switching from legacy to new delivery/analysis method in SAP BusinessObjects Analyzer - 1.0).

If you are upgrading from CAST AIP 8.1.0 (baseline) ONLY, you should check your snapshots for errors that may have occurred during the upgrade of the Measurement Service schema with CAST Server Manager. To do so:

• connect and login to the Health Dashboard from the previous release of CAST AIP (this should still be available).
• navigate through all the Applications that have been upgraded to the new release of CAST AIP and check the list of snapshots in the snapshot selector for each Application:

• any snapshot Version name that contains the string "MIGR_ERROR_ALG_xxx_x_x" (for example "MIGRERROR_ALG_1106776204_3_4") was subject to an error that occurred during the upgrade of the Measurement Service schema with CAST Server Manager. It has not been possible to automatically repair this error and therefore the snapshot may produce erroneous data in the Health Dashboard or in the CAST Report Generator.

Resolution

If any existing snapshots are marked as containing an error, you need to perform a specific set of actions to remove and re-consolidate the snapshot (containing the error) in the Measurement Service schema. To do so: 

• Launch the AadConsolidation-GUI.exe located in <CAST_AIP_installation_folder>\AAD\GUI:
  

• In the GUI, tick the Reset option as shown above
• Fill in the fields in the AAD Connection tab (as highlighted above) to connect to the Measurement Service schema in which the snapshots with errors have been consolidated. See HD - GUI common fields for more information.
• Move to the Reset tab and fill in the three fields as follows, according to the Version name given to the snapshot that contains an error, for example: "MIGRERROR_ALG_1106776204_3_4"

• the first figure, (here 1106776204) represents the site_id
• the second one, (here 3), the application_id
• the third one (here 4) the snapshot_id
• Finally click the Run Application button to start the removal process:

• Repeat this process for ALL snapshots in your upgraded Application that have an error in the Version name.
• Finally, open the CAST Management Studio from the new release of CAST AIP, open the Application editor and move to the Execute tab
• Click the Upload Snapshots to Measurement Service option to re-consolidate all snapshots for the current Application. Repeat for each Application as necessary.

Copy the delivery

• First ensure that the current version is set to the version used to generate the most recent snapshot (i.e. the last snapshot generated before the upgrade).
• Now select the current version and click Add Version (click to enlarge)

• The following screen will now be displayed. Please ensure that you do as follows:
  • 1) Enter a name for this copied version
  • 2) Ensure the Copy source code option is selected (click to enlarge):
  • 3) Available from CAST AIP ≥ 8.3.5: Decide if you want to enable any specific discoverers by entering their names in the Discoverers to activate field. You can enter either any of the following (if you enter multiple discoverers, separate them with a comma):
    
    
    • "HTML5 project" (Web Files Discoverer) - enabling this discoverer is aimed at those that are upgrading to CAST AIP 8.3.x (from previous releases of CAST AIP) with Applications containing HTML5 and JavaScript files. This will automatically force the creation of Analysis Units for HTML5 and JavaScript files during the upgrade and is therefore an option ensure consistency of post-upgrade snapshot results, where the Application contains these file types.
      
      
    • "XML scanner" (DMT XML Scanner) - enabling this discoverer will provide additional information in the CAST Delivery Manager Tool "Delivery report'".

• Click Finish to continue.

Re-package the source code and deliver

• The CAST Delivery Manager Tool will open (click to enlarge):

• You now need to open each "package" (double click it) and check that all the configuration settings are as they should be.
• Click Package at Version level and ensure that:
  • Force extraction option is UNTICKED - this will limit the result comparison to the source code that was delivered with the last snapshot generated prior to the upgrade
  • Force scan option is UNTICKED

• Click Finish to run the Package action
• Check the status of the packaging action in the Package Content tab for each Package.
• Click Deliver to close the Version
• Quit the CAST Delivery Manager Tool

Accept and set as current version

• Back in CAST Management Studio, the Version will now be displayed in the Delivery done section (click to enlarge):

• Accept the Version and set it as current:

• Deploy the source code as normal (click to enlarge):

• You are now ready to generate a snapshot - see below.

• For each Application involved in the upgrade, generate a snapshot. The rational of doing so now is so that you can compare the pre and post upgrade snapshots.
• First ensure that the correct Assessment Model is assigned to your Dashboard Service (use the Expert audience mode) click to enlarge:

• Now check your Analysis Units to make sure, in particular, that any file based source code is available. Use the Current Version tab in the Application editor (click to enlarge):

• Next right click the upgraded Application and select Execute > Take a snapshot of the application. This will run all the analyses, synchronize modules and execute a new snapshot:

When the snapshot has completed, you can check the contents by launching a temporary Engineering Dashboard:

• Open your Dashboard Service in the CAST Management Studio
• Ensure no URL is present in the URL field in the General tab
• Click the Open Engineering Dashboard option in the General tab and compare the pre and post upgrade snapshots (credentials are admin/cast).

When redeploying the CAST AIC Portal, ensure the following is always done:

• You must configure the portal to point to your EXISTING Delivery folder - DO NOT create a new empty Delivery folder.
• The CAST AIC Portal uses a file format database to store various persistent information. Two files from this database must be copied from the existing CAST AIC Portal deployment, over to the same folder in the new CAST AIC Portal deployment - when prompted, you should OVERWRITE the existing files. The files that must be copied are as follows:

%CATALINA_HOME%\webapps\CAST-AICP\database\security.properties
%CATALINA_HOME%\webapps\CAST-AICP\database\security.script

• You must comment out any references to Applications that have not been upgraded to the current release of CAST AIP in the index.xml file located in the "data" folder at the root of the Delivery folder (i.e. you have deliberately chosen not to update certain Applications at this time). This is to prevent these Applications from appearing in the CAST AIC Portal and them being inadvertently worked on via the CAST Delivery Manager Tool. For example, in the following index.xml there are two Applications: MEUDON has been updated, SEVRES has not. The comments have been placed around the SEVRES Application:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
 <comment/>
 <!--
 <entry key="4454b831-7931-405c-85e2-60727ebaef74_4454b831-7931-405c-85e2-60727ebaef74.entity.xml_checksum">4a8579cf20d2a7fb74da82b70940ce3c</entry>
 <entry key="4454b831-7931-405c-85e2-60727ebaef74_4454b831-7931-405c-85e2-60727ebaef74.entity.xml_lastModified">1435072140917</entry>
 <entry key="4454b831-7931-405c-85e2-60727ebaef74_4454b831-7931-405c-85e2-60727ebaef74.entity.xml_length">2287</entry>
 <entry key="4454b831-7931-405c-85e2-60727ebaef74_manager"></entry>
 <entry key="4454b831-7931-405c-85e2-60727ebaef74_mngtId">1764613107</entry>
 <entry key="4454b831-7931-405c-85e2-60727ebaef74_name">SEVRES</entry>
 <entry key="4454b831-7931-405c-85e2-60727ebaef74_owner"></entry>
 <entry key="4454b831-7931-405c-85e2-60727ebaef74_syncId">4</entry>
 <entry key="4454b831-7931-405c-85e2-60727ebaef74_type">delivery.Application</entry>
 <entry key="4454b831-7931-405c-85e2-60727ebaef74_uuid">4454b831-7931-405c-85e2-60727ebaef74</entry>
 -->
 <entry key="c8bf6626-4840-44eb-ac3a-080370e67bbf_c8bf6626-4840-44eb-ac3a-080370e67bbf.entity.xml_checksum">3387ef40b17e24ae225cea19f52a6d48</entry>
 <entry key="c8bf6626-4840-44eb-ac3a-080370e67bbf_c8bf6626-4840-44eb-ac3a-080370e67bbf.entity.xml_lastModified">1434985964337</entry>
 <entry key="c8bf6626-4840-44eb-ac3a-080370e67bbf_c8bf6626-4840-44eb-ac3a-080370e67bbf.entity.xml_length">2287</entry>
 <entry key="c8bf6626-4840-44eb-ac3a-080370e67bbf_manager"></entry>
 <entry key="c8bf6626-4840-44eb-ac3a-080370e67bbf_mngtId">1764613107</entry>
 <entry key="c8bf6626-4840-44eb-ac3a-080370e67bbf_name">MEUDON</entry>
 <entry key="c8bf6626-4840-44eb-ac3a-080370e67bbf_owner"></entry>
 <entry key="c8bf6626-4840-44eb-ac3a-080370e67bbf_syncId">4</entry>
 <entry key="c8bf6626-4840-44eb-ac3a-080370e67bbf_type">delivery.Application</entry>
 <entry key="c8bf6626-4840-44eb-ac3a-080370e67bbf_uuid">c8bf6626-4840-44eb-ac3a-080370e67bbf</entry>
</properties>

When redeploying the Health / Engineering Dashboards, please note the following:

WAR file names

Continuing with the dashboard re-naming modifications made in CAST AIP 8.3.2, the WAR files have now been renamed as follows in CAST AIP 8.3.3:

Please ensure that you take note of this and modify any WAR deployment routines you may have. See also:

• Installing and configuring the Health Dashboard
• Installing and configuring the Engineering Dashboard

.JSON files

If you have made configuration changes to tiles via .JSON files and you want to retain those changes in the new version of the dashboards, you can re-use old .JSON files with the new deployment of the dashboards, however please note that doing so will mean that you will not benefit from any improvements or features added to the current release of the Health Dashboard/Engineering Dashboard.

Users, groups and roles configuration

In CAST AIP 8.3.x, the configuration of users, groups and roles for the Health Dashboard / Engineering Dashboard / RestAPI have been updated and brought into line with the methods used in the CAST AIC Portal.

• HD - Configuring user authentication

• ED - Configuring user authentication

Enhancement Function Point counting mode (Health Dashboard only)

In CAST AIP 8.2.x, CAST implemented a new enhancement Function Point counting mode (see CAST AIP enhancement Function Point counting mode) and has therefore modified the Health Dashboard default Enhancement Function Point tile configuration (see Automated Enhancement Point) to pull data ONLY from the new AEP measure. However, Applications on-boarded in previous releases of CAST AIP (≤ 8.1.x) and upgraded to CAST AIP ≥ 8.2.x will continue to use the legacy EFP measure mode for future snapshots (unless manually changed) and as such, the new tile in the dashboard will display no information (N/A) about enhancement Function Points. If you need to display tiles that are configured to display EFP data, please copy the following section of text from the existing deployed WAR (%CATALINA_HOME%\webapps\CAST-Health\portal\resources\app.json file) into the equivalent file in the newly deployed WAR:

{
    "id": 2,
    "title": "Software Enhancement Function Points (since previous version)",
    "panels": [
        {
            "id": 2000,
            "plugin": "FunctionalWeightMeasureResult",
            "color": "blue",
            "parameters": {
                "title": "",
                "functionalWeightMeasure": {
                    "id": "ADDED_FUNCTION_POINTS",
                    "format": "0,000",
                    "description": "Automated FPs Added"
                }
            }
        },
        {
            "id": 2002,
            "plugin": "FunctionalWeightMeasureResult",
            "color": "green",
            "parameters": {
                "title": "",
                "functionalWeightMeasure": {
                    "id": "MODIFIED_FUNCTION_POINTS",
                    "format": "0,000",
                    "description": "Automated FPs Modified"
                }
            }
        },
        {
            "id": 2001,
            "plugin": "FunctionalWeightMeasureResult",
            "color": "purple",
            "parameters": {
                "title": "",
                "functionalWeightMeasure": {
                    "id": "DELETED_FUNCTION_POINTS",
                    "format": "0,000",
                    "description": "Automated FPs Deleted"
                }
            }
        }