About DCA-Collaboration Server Integration

After installing the DCA, you must integrate it with your Collaboration Server. Integration modifies CCS to include DCA features and turns off some unneeded CCS controls.

Required Integration Tasks

Integrating the DCA with Collaboration Server consists of these steps:

 

1. Assess Pre-Existing CCS Customization

Prior to integrating the DCA with CCS, determine what, if any, pre-existing CCS customization will be affected when you run the DCA-CCS Updater. Note that whenever possible Cisco recommends you use a fresh CCS installation with the DCA.

2. Install the DCA Updater on your Collaboration Server

The DCA-CCS Updater is a patch to CCS that allows it to function with the DCA.

3. Test the Updater Installation   

Verify that the Updater installed properly by checking for the presence of several settings in the  wlserver.properties file.

4. Create the DCA-Collaboration Server Connection   

The DCA-CCS connection establishes an Agent Reporting and Management (ARM) service that makes DCA session information available to Collaboration Server reports. The service also allows the automatic cleanup of DCA sessions when their associated Collaboration sessions are terminated.

5. Add DCA Code to Localized CCS Files   

During integration, the DCA modifies or overwrites a number of files on CCS, adding code that the DCA needs to function. However, the DCA-CCS updater only modifies the English versions of these files; IF you localize CCS to use non-English versions of these files (either before or after integration), you must manually add some code to these localized file versions. Failure to do this will prevent the DCA from functioning.

Optional Integration Tasks

After completing the required integration tasks listed above, you may want to perform the following optional tasks as well.

 

1. Hide Native Controls in the Caller Browser Window

In a DCA session, callers must navigate your Web site using the navigation controls on the DCA Collaboration Toolbar (the Collaboration Toolbar loads automatically in the caller's browser window at the start of a DCA session).

To prevent confusion, it's a good idea to remove all native navigation controls (i.e., menus and toolbars) from the browser window callers will use to share content. A common way to do this is to open the window through a JavaScript link on your Web site that excludes menus and toolbars.

2. Reintroduce Customization

During integration, the DCA  modifies or overwrites a number of files on CCS. If you have customized your CCS (for example, by adding your own code to any of these files) you may need to reintroduce this customization after integration.

3. Re-enable App Sharing and/or White Board   

DCA-CCS integration automatically disables Collaboration Server's Single-Session Agent App Share and White Board features. It does this by setting the CCS Caller Complexity Mode to Simple, and by hiding the controls in the Agent and Caller desktops used by these features. If you plan to use these features, you must re-enable them after integrating the DCA with CCS.

See Also

For related information, see:

How to Deploy the DCA

About the DCA-CCS Updater

About DCA 2.01 Changes to CCS Files

About DCA 2.01 Changes to Agent Role Settings

How to Install the DCA-CCS Updater

How to Test the Updater Installation

How to Create the DCA-Collaboration Server Connection

How to Add DCA Code to Localized CCS Files

How to Re-Enable White Board and App Share

About DCA-CCS Integration Troubleshooting

How to Uninstall the DCA-CCS Updater