SAP Knowledge Base Article - Preview

2407011 - LMS Cross Domain Solution (CDS) Knowledge Support and Tips

Symptom

SFTipsNTricks.JPGLMS.png
Click to go back to the main page

 

LMS CROSS DOMAIN SOLUTION (CDS) KNOWLEDGE SESSION FOR CUSTOMERS, PARTNERS AND SAP PRODUCT SUPPORT
 

1. About the SuccessFactors LMS CDS 1.1. Cross Domain Solution Files 1.2. Technical Requirements for the CDS 2. Cross Domain Solution at Run time 2.1. JSlet Tracking vs. Applet Tracking 3. Cross Domain Solution Configuration Overview 3.1. Setting up the Cross Domain Solution on the Content Server 3.2. Configuring LMS-ADMIN for the Cross Domain Solution 3.3. Communication Cross Domain Support Settings 3.4. Enabling the Cross Domain Solution on Content Objects 4. Cross Domain Solution Troubleshooting 5. KBA Related to CDS – Cross Domain Solution

 
 
1. About the SuccessFactors LMS CDS

The Cross Domain Solution (CDS) for content servers applies when you decide to use your own content server instead of iContent.

If Customer has already iContent install, this is already installed for them and you can ignore CDS.

The CDS – Cross Domain Solution (CDS) provides trusted server-to-server communication between an outside content server and SuccessFactors Learning Management System (LMS).  The Trusted communication is necessary when the course content server is different Domain Name Space (DNS) than the SuccessFactors LMS.  This is common.

CDS overview.png

In a cross domain scenario, SuccessFactors recommends the Proxlet WAR CDS.  The Proxlet WAR (Java Web Archive) communicates basic course tracking information back to the LMS such as exam scores and progress through content.

When the Proxlet WAR CDS is NOT working properly, the user can launch content but their completion status is NOT recorded back to the LMS.

1.1. Cross Domain Solution Files

The Cross Domain Solution (CDS) files are delivered to on-premise customers and are available on request for on-demand customers. You need the files to install the CDS on your content server.

On-premise customers can find the CDS files in foundation.zip: \plateau-talent-management-[version]\plateau\support\crossdomain.zip. On-demand customers can contact Customer Success for the files.

•The content.zip file contains static files that you copy to the content server. They load the progress tracking code wrap your content.
•The proxlet.war is a small Web ARchive (WAR) application that you deploy on your content server, typically in Tomcat. It is a communication relay between the tracking code and SAP SuccessFactors Learning.
 

1.2. Technical Requirements for the CDS

•  Web Server – Latest Tomcat 7 or 8 versions

•  Java – Latest Oracle JDK 7 or JDK 8 versions
 
 
2. Cross Domain Solution at Run Time

Users are not aware of the Cross Domain Solution (CDS) when they interact with it at run time, but they are working with it to earn credit for their progress. This topic describes how they are interacting with the CDS.

When users click a link in their learning assignments to launch content, they open a new window that is served from the content server. The users see their content in a separate window and do not know about the wrapper.

Inside the wrapper window, users navigate the course, exam, or other content. This content is served from the content server.

While navigating the content, the user's progress is tracked with JSlet (JavaScript "applet") or a Java Applet tracking code.

The proxlet.war application relays the user's progress to the LMS.

 

2.1. JSlet Tracking vs. Applet Tracking

Where possible, we recommend JSlet tracking over applet tracking. This topic describes why and how you can override that recommendation.

If you use an applet, then from time to time, you must patch your server when users update their Java Runtime Environment (JRE). You cannot control when users patch their JRE. When you use the JSlet, you are not affected by JRE updates.

On-demand customers whose users launch tracked content under the proxlet.war Cross Domain Solution (CDS) must use JSlet.

On-premise customers whose users launch tracked content under the proxlet.war Cross Domain Solution (CDS) use JSlet by default. We recommend JSset to avoid JRE update issues.

On-premise customers whose users launch tracked content under the proxlet.war Cross Domain Solution (CDS) can switch to using Java applets. Go to  System Admin -> Configuration->  System Configuration -> LMS_ADMIN  and change the useJsletInsteadApplet setting to false. This setting has no effect on-demand customers.

 

3. Cross Domain Solution Configuration

Before you begin configuring the parts of the Cross Domain Solution (CDS), this topic gives you an overview of the steps.

The proxlet.war implementation of the Cross Domain Solution (CDS) is configured in three parts:

On content server, you extract and deploy the files from crossdomain.zip.

On SuccessFactors, you point the Learning Management System (LMS) to the content server.

On each content object you want to use, you enable the CDS.

 

3.1. Setting up the Cross Domain Solution on the Content Server

You set up the Cross Domain Solution (CDS) on the content server so that users can earn credit for their progression through the learning content served from the content server.

Prerequisites

Identify or create a web accessible directory in your content server to contain the wrapper files. We recommend /content.

Obtain the crossdomain.zip file, which is explained in Cross Domain Solution Files

 

Procedure

Extract content.zip from the crossdomain.zip file to a temporary folder.You see two files in the temporary folder: content.zip and proxlet.war.

Extract content.zip to the web accessible directory.For the web accessible directory, we recommend /content.

Deploy proxlet.war on the content server according to the instructions for your application server or servlet container.

 

3.2. Configuring LMS_ADMIN for the Cross Domain Solution

You configure the LMS_ADMIN file to point the Learning Management System (LMS) to the content server where you deployed the Cross Domain Solution (CDS).

Prerequisites
You have set up the CDS on the content server.

Procedure
Log in to Learning Administration as a system administrator.

Go to  System Admin-> Configuration -> System Configuration ->  LMS_ADMIN .

Edit the communication CDS settings.

 

3.3. Communication Cross Domain Support Settings

Use these settings in LMS_ADMIN to configure Cross Domain Support (CDS) to the proxlet.war.

Configuration Example

communicationCrossDomainSupportEnabled=true
defaultContentServerPath=http://content.xyzcorp.com/content
contentWrapperPageName=main_content_wrapper.html
scorm2004ContentWrapperPageName=scorm_2004_content_wrapper.html
externalURLQuestionWrapperPageName=main_question_wrapper.html
contentOpenerPageName=main_content_opener.html
defaultProxletPath=http://content.xyzcorp.com:8080/proxlet
lmsSessionId=JSESSIONID

properties settings.png

 

3.4. Enabling the Cross Domain Solution on Content Objects

You enable individual content objects for the Cross Domain Solution (CDS) so that the content object can work properly in the CDS context.

Prerequisites
You configured LMS_ADMIN and know the values you set for the properties.
You have imported or created the content objects you want to configure.

Procedure

1.Go to  Learning Admin -> Content -> Content Objects, find your content object, and then open Cross Domain.
2.Select Enable Communication Cross Domain through Proxy and then click Apply Changes.
3.Check the settings in Cross Domain Settings.You see default values based on your Cross Domain Solution (CDS) configuration. In most cases, you do not need to make changes.
  Clear Use Frameset if your content does not run well when launched under a frameset.


4. Cross Domain Solution Troubleshooting

This topic describes how you can troubleshoot issues with your Cross Domain Solution (CDS) configuration.

IMPORTANT NOTE:

Cross Domain issues are outside of Customer Support scope.  To obtain the latest Proxlet WAR for CDS see the link available to our Community in the LMS Help Guide here: https://help.sap.com/viewer/1419d96be9bf43cdb7f4a6ebfd320840/latest/en-US/ba9659a2df144cd0aaa0ab2b8b595ae1.html.  
If Customer requests help for installing or modifying the Proxlet or if they want to set up a reverse proxy this has to go through Professional Services.

 

Turning on Debugging for All User Sessions

The easiest but broadest way to debug the CDS is to turn debugging on in LMS_ADMIN. When you turn debugging on in this way, all user sessions are put into debugging mode. We recommend this approach if you are debugging a staging server.
Go to  System Admin ->  Configuration ->  System Configuration -> LMS_ADMIN. Find the contentTestPagesEnabled setting and change its value to true.

 

5. KBA related to Cross Domain Solution (CDS)

Cross Domain issues are outside of Customer Support scope.  To obtain the latest Proxlet WAR for CDS see the link available to our Community in the LMS Help Guide here: https://help.sap.com/viewer/1419d96be9bf43cdb7f4a6ebfd320840/latest/en-US/ba9659a2df144cd0aaa0ab2b8b595ae1.html.  
If Customer requests help for installing or modifying the Proxlet or if they want to set up a reverse proxy this has to go through Professional Services.

2316110  How to Implement Cross Domain Solution - AICC Contents hosted in a different server location - [LMS]

2316114  How to Implement Cross Domain Solution - SCORM Contents hosted in a different server location - [LMS]

2154000  Cross-Domain Communication Restriction - Learning Management System

2149060  Cross Domain solution not communicating with LMS ** CS Internal Use Only

2409189 - Content is not launching on Mobile devices SF APP - iphone/ipad/tabs {Screen goes blank after clicking the launch button or the link is not clickable}

 

 

ToTop.png

 


Read more...

Environment

SAP SuccessFactors Learning Management System (LMS)

Product

SAP SuccessFactors Learning Marketplace all versions

Keywords

  • Cross Domain Solution
  • CDS
  • LMS CDS
  • LMS Customer Content Server 
, KBA , LOD-SF-LMS , SuccessFactors Learning , LOD-SF-LMS-CNT , Content , How To

About this page

This is a preview of a SAP Knowledge Base Article. Click more to access the full version on SAP ONE Support launchpad (Login required).

Search for additional results

Visit SAP Support Portal's SAP Notes and KBA Search.