ATG Outreach Administration and Development Guide

As explained in the deployment chapters of the ATG Content Administration Programming Guide, you must set up a matching destination repository for every versioned repository in your development environment and configure it to point to the unversioned database used by your target sites. For ATG Outreach, the repository for which you must create a matching destination is the Outreach repository on the ATG Outreach server. (This repository is configured by OutreachRepository.properties, which is located in <ATG9dir>\ACO9.3\ACO\communication\base\config\config.jar.)

You need to configure a destination Outreach repository for every target you have; for example, if you deploy to both a staging and a production site, you need to configure two destination repositories, one for staging and one for production.

Two pre-configured .properties files that you can use for your destination repositories are provided with ATG Outreach:

These files are located in <ATG9dir>\ACO9.3\ACO\communication\base\config\config.jar.

The following example shows the contents of the preconfigured OutreachRepository_production.properties file:

#
# The initial values of the properties for the OutreachRepository
#
$class=atg.adapter.gsa.GSARepository

repositoryName=OutreachRepository_production

definitionFiles=\
  /atg/campaign/communication/outreachRepository.xml

lockManager=/atg/dynamo/service/ClientLockManager_production
dataSource=/atg/dynamo/service/jdbc/JTDataSource_production
idGenerator=/atg/dynamo/service/IdGenerator
XMLToolsFactory=/atg/dynamo/service/xml/XMLToolsFactory
transactionManager=/atg/dynamo/transaction/TransactionManager

checkTables=true

# since we are running on solid we want to simulate text searches
# this should be removed in a production system
simulateTextSearchQueries=true

#loggingDebug=true
#debugLevel=5

Configure the files as described in Setting Up Deployment in the ATG Content Administration Programming Guide. Locate the new files in the localconfig layer on the ATG Outreach server in a directory with the same path as the versioned Outreach repository, for example

<ATG9dir>\home\localconfig\atg\campaign\communication\
OutreachRepository_production.properties

The destination repositories are included by default in the additionalAssetSources list in the AssetResolver.properties component, which allows them to be recognized on startup by ATG Content Administration and appear in the ATG Business Control Center deployment UI.

OutreachRepository_production is specified as an entry in /atg/dynamo/service/AssetResolver.properties in <ATG9dir>\ACO9.3\ACO\communication\base\config\config.jar.

OutreachRepository_staging is included in /atg/dynamo/service/AssetResolver.properties in <ATG9dir>ACO9.3\ACO\communication\base\configlayers\stagingandprod\config.jar.

Configuring the Destination Repository Data Sources

For each destination OutreachRepository you created for the ATG Outreach server, you need to configure a data source to point to the database used by the target site. Some files preconfigured for this use are supplied with the Dynamo Application Framework.

In <ATG9dir>\DAF\Deployment\config\config.jar:

JTDataSource_production.properties

In <ATG9dir>\DAF\Deployment\configlayers\stagingandprod\config.jar:

JTDataSource_staging.properties

If you have not done so already (see Configuring the External Profile Repository Data Source), extract these files as needed and configure them to point to the target database used by the ATG Outreach Production/Staging module. Locate the files on the ATG Outreach server in a localconfig directory specified by the datasource property of the destination OutreachRepository_*.properties file, by default /atg/dynamo/service/jdbc/.

For more information, refer to Setting Up Deployment in the ATG Content Administration Programming Guide.