Upgrading the Beginner's Tutorial Service

Introduction

caGrid 1.1 makes several improvements over caGrid 1.0. To take advantage of these improvements, the Introduce toolkit supports upgrading services from one version of caGrid to another. The data service infrastructure also supports upgrading the underlying data service infrastructure as well. This tutorial will upgrade the service created in the 1.0 beginner's tutorial to caGrid 1.1 including the data service infrastructure upgrades. This service is available in a zip file which may be used for this tutorial. In all cases, this tutorial assumes the service resides in c:/CaGridTutorialService.

Upgrading the Service

Launch the Introduce Grid Service Authoring Toolkit

In a system terminal execute the following commands to launch Introduce:

%> cd %CAGRID_LOCATION%

%> ant introduce

Open the Service for Modification with Introduce

Select the Modify Service button from the Introduce toolbar.
In the file dialog which opens, browse to c:/CaGridTutorialService.
Click the Open button to begin loading the service.

At this point, Introduce will parse the service model and detect that the service was generated with an older version of Introduce and prompt the developer with three options for how to proceed.

Select the Upgrade Behavior

Introduce allows selection of the type of upgrading to perform on the service:

Upgrade Options

Upgrade
- Attempts to upgrade the service to the currently running version of Introduce and its extensions. An archive of the service in its present state will be created before performing this operation.
Open
- Attempts to open the service without performing any upgrades. This can be dangerous as the service model has changed between versions of Introduce, and extensions may not behave correctly.
Close
- Close the service and perform no modifications

Since we wish to upgrade this service to Introduce 1.1, select the Upgrade option. Introduce will attempt to perform upgrades on the service and its extensions. Depending on what operations need to be performed, this process may take a few minutes to complete.

Verify Status

When the upgrade is complete, Introduce will display a dialog indicating the status of the upgrade (success or failure), as well as a summary of the changes made to your service. Each extension to be upgraded also includes status information in this window. This window also presents the developer with three options:

Upgrade Status

Proceed
- If the upgrade was successful, this option will load the service into the Introduce modification viewer for further editing and inspection.
Edit
- Some changes during the upgrade process may have affected the build process. If your service included custom activity in the build, carefully observe the upgrade status messages and act on any relevant changes. Selection of this option closes the service, leaving it in the upgraded state, and giving the developer a chance to make changes to the service before reloading it with Introduce.
Roll Back
- Before upgrading, Introduce creates an archive of the service. Selection of this option will restore the service to this archived state and close it.

Select Proceed to continue loading the service.

Upgrade Result

When the service modification window loads, select the Data Service tab. This tab will have several sub-tabs, including the new caCORE SDK v3.1 tab. Select this tab. This tab provided as part of the new caGrid data services styles infrastructure. This tab is for informational purposes only, and the values displayed here can be configured by editing the service's deployment properties.