Configure Default Target VFSs for Switch Deployments

There are two out-of-the-box VFSs that you might need to configure for switch deployments:

When adding an ATG server or Web server to an existing target, configure its switchable VFSs like those on the existing ATG target servers. Verify that:

  • It has the same underlying data sources.

  • Its initial data store, specified in the name1 property of the VFS, is the same as their current data store, so the new server’s agent application starts up using the same data store.

Configuring the ConfigFileSystem for Switch Deployments

ConfigFileSystem is provided out-of-the-box with the Publishing agent, which is included with the Adaptive Scenario Engine. Out-of-the-box, the ConfigFileSystem is configured for online deployments. If you intend to deploy personalization and/or scenario assets to the target, you can configure the ConfigFileSystem on each ATG server for switch deployments.

To configure each ConfigFileSystem VFS for switch deployments, perform this procedure on each target ATG server:

  1. Modify the ConfigFileSystem component in order to configure an instance of SwitchableLocalFileSystem. Do this by layering on a configuration file that looks like this:

    $class=atg.vfs.switchable.SwitchableLocalFileSystem

    liveDirectory=
      {atg.dynamo.server.home}/PublishingAgent/deploymentconfig/live/config
    stagingDirectory=
      {atg.dynamo.server.home}/PublishingAgent/deploymentconfig/staging/config
    dataDirectory=
      {atg.dynamo.server.home}/PublishingAgent/deploymentconfig/data/config

    journaling=true
    updateListeners+=
      /atg/epub/monitor/PersonalizationConfigurationMonitor

    name1=firstDataStore
    name2=secondDataStore

    If you choose to specify a different live directory, make sure the directory is located within the CONFIGPATH.

  2. Place the new ConfigFileSystem.properties file in your localconfig directory at /atg/epub/file/.

  3. Add the ConfigFileSystem to the agent’s list of switchable data stores in /atg/epub/DeploymentAgent.switchableDataStores. Be sure to specify the VFS by its fully qualified Nucleus path: /atg/epub/file/ConfigFileSystem.

Configuring the WWWFileSystem for Switch Deployments

The WWWFileSystem is provided out-of-the-box with the Publishing Web agent. Out-of-the-box, it is configured for online deployments. If you installed the Publishing Web agent on the target Web servers in order to deploy static text and binary files on them, you can configure the WWWFileSystem on each Web server for switch deployments.

To configure each WWWFileSystem VFS for switch deployments, perform these steps on each target Web server:

  1. Modify the WWWFileSystem component in order to configure a SwitchableLocalFileSystem instance. Do this by layering on a configuration file that looks similar to the following:

    $class=atg.vfs.switchable.SwitchableLocalFileSystem

    liveDirectory={atg.dynamo.home}/doc
    stagingDirectory={atg.dynamo.server.home}/PublishingWebAgent/deploy
    mentdocroot/staging
    dataDirectory={atg.dynamo.server.home}/PublishingWebAgent/deploymen
    tdocroot/data

    name1=firstDataStore
    name2=secondDataStore

    For a description of each property, see SwitchableLocalFileSystem in Appendix B, Virtual File Systems.

    If you choose to specify a different directory for the liveDirectory property, make sure the directory is located in the Web server’s document root directory or one of its subdirectories. Also make sure the directory does not store files used by other services; it should contain only files deployed from the ATG Content Administration server’s WWWFileSystem.

  2. Place the new WWWFileSystem.properties file in your localconfig directory at /atg/epub/file/.

  3. Add the WWWFileSystem to the agent’s list of switchable data stores in /atg/epub/DeploymentAgent.switchableDataStores. Make sure to specify the VFS by its fully qualified Nucleus path: /atg/epub/file/WWWFileSystem.

 
loading table of contents...