IBM FileNet P8, Version 5.2

Extracting a service half map

After you define an environment, you can extract its service data to create a service half map.

Service information can be extracted from the following sources:

Deploy data set: Two types of content objects, workflow definitions and form templates, can contain service data. If you attempt to extract service data from a set of content objects, but none of the objects contain service information, the service half map remains empty. However, because it is not necessary to have entries in the service data map to perform a successful deployment, you can still proceed through the convert, validate, and import steps.
Configuration export file: This file is created by using the Export Wizard in Process Configuration Console to extract the configuration data for an isolated region from the workflow database. See Export isolated region configuration data for instructions in how to export this file from the Content Platform Engine server. This information can contain region-wide properties, such as specified web applications, step processor settings, event logging options, and all queue, roster, and log definitions. Content Platform Engine user information can also appear in the service half map. For more information about the supported service types, see Service half map format .
Service half map for the source FileNet® Deployment Manager environment: The service half map data that is gathered from the source environment provides a starting point for creating an service half map to use for the destination environment. For more information, see Create a destination service half map.

To extract service data to a service half map:

In the FileNet Deployment Manager Tree View pane, expand the Environments node and double-click an environment.
On the Overview tab, click the Retrieve Data radio button for Service Data.

In the Update Service Half Map dialog box, choose the service data source:

Option	Description
From the Deploy data set	Select this data source when you want to map service data from content objects for deployment of these objects(or similar) objects to the destination environment. This data source option requires the fully qualified path to a deploy data set. See Create deploy dataset for instructions on how to export to a data set from the Content Platform Engine. In the Select Deploy data set File field, enter the fully qualified path of the deploy data set from which the service data is to be extracted.
From the Content Platform Engine Config Export File	Select this data source when you want to map service data from FileNet P8 objects, for deployment of these objects (or similar) objects to the destination environment. This data source option requires the fully qualified path to a FileNet P8 Configuration Console export file. See Export isolated region configuration data for instructions in how to export this file from the Content Platform Engine server. In the Select Process Configuration File field, enter the fully qualified name of the Process Configuration Console export file from which the service data is to be extracted.
From an Environment's Service HalfMap	Select this data source if you have an existing FileNet Deployment Manager source environment for which you extracted the service data for the service half map. Selecting this data source causes the service half map to be copied from the source environment for use as an initial half map for the destination environment. For more information, see Create a destination service half map. In the Source Environment field, select the source environment that contains the service data to use.

Option

Description

From the Deploy data set

Select this data source when you want to map service data from content objects for deployment of these objects(or similar) objects to the destination environment. This data source option requires the fully qualified path to a deploy data set. See Create deploy dataset for instructions on how to export to a data set from the Content Platform Engine.

In the Select Deploy data set File field, enter the fully qualified path of the deploy data set from which the service data is to be extracted.

From the Content Platform Engine Config Export File

Select this data source when you want to map service data from FileNet P8 objects, for deployment of these objects (or similar) objects to the destination environment. This data source option requires the fully qualified path to a FileNet P8 Configuration Console export file. See Export isolated region configuration data for instructions in how to export this file from the Content Platform Engine server.

In the Select Process Configuration File field, enter the fully qualified name of the Process Configuration Console export file from which the service data is to be extracted.

From an Environment's Service HalfMap

Select this data source if you have an existing FileNet Deployment Manager source environment for which you extracted the service data for the service half map. Selecting this data source causes the service half map to be copied from the source environment for use as an initial half map for the destination environment. For more information, see Create a destination service half map.

In the Source Environment field, select the source environment that contains the service data to use.

For the chosen service data source, if you are updating an existing service half map, select one of the following options:

Option	Description
Merge	Adds new data such as types, names, servers, and URLs to the service half map. Existing data is updated with any changes. This option does not delete any data from the service half map.
Overwrite	Replaces the contents of the service half map with the new data.

Click Finish.
FileNet Deployment Manager processes the specified file, extracts the service data, and creates a half map that contains this data (HalfMap_Service.xml) in the DeploymentTreeRootFolder\Environments subfolder for the specified environment.