The following steps should be performed to troubleshoot XPM (Experience Management) configuration for an SDL Web 8 environment. |
Session-enabled content service 1. cd_storage_conf.xml - SessionWrapper is added in wrappers - Preview_dao_bundle.xml is added as storage binding 2. cd_ambient_conf.xml - Make sure that <WhiteList> is enabled and the ip address that is requesting is within the white-list range, or just add the following to enable all <Ip>0.0.0.0-255.255.255.255</Ip>- <GloballyAcceptedClaims> has <Claim Uri="taf:session:preview:preview_session"/> enabled - preview cartridges should be enabled <Cartridge File="cd_webservice_preview_cartridge.xml" Category="SYSTEM"/> <Cartridge File="cd_webservice_preview_cartridge.xml"/>3. logs The following lines are present in cd_core.log - Check if cookies are enabled: 2017-07-04 16:35:43,864 DEBUG AbstractAmbientDataServletFilter - Cookie forwarding is enabled: true- Check if cookies forwarding is enabled 2017-07-04 16:35:43,864 DEBUG AbstractAmbientDataServletFilter - Cookie forwarding for current request is allowed: true- Check that the following log event is NOT present 2017-07-04 16:35:43,864 DEBUG ClaimCookieDeserializer - The list of ClaimsCookies sent to be deserialized is empty!- but the following is present (the XYZ should be some number) 2017-07-04 16:35:43,864 DEBUG ClaimCookieDeserializer - Found XYZ claims cookies. Preview service 1. cd_storage_conf.xml - SessionWrapper is added in wrappers - Preview_dao_bundle.xml is added as storage binding 2. cd_ambient_conf.xml - Both system and non system cartridges are enabled <Cartridge File="cd_webservice_preview_cartridge.xml" Category="SYSTEM"/> <Cartridge File="cd_webservice_preview_cartridge.xml"/>3. session db Verify that there is data in the PREVIEW_SESSIONS or PREVIEW_SESSION_ITEMS tables once you click on UpdatePreview .NET - web application 1. cd_ambient_conf.xml - ForwardedClaims element is enabled and contains: <Claim Uri="taf:session:preview:preview_session"/> Java - web application 1. cd_client_conf.xml - Cache is disabled - preview service element is present <PreviewService MachineName="MachineName1" FileLocation="C:/temp" DefaultFileSystem="true"/>2. cd_ambient_conf.xml - ForwardedClaims element is enabled and contains: <Claim Uri="taf:session:preview:preview_session"/>3. web.xml is present (at the same level as classes folder) and * has the PageContentFilter enabled, for com.sdl.web.preview.client.filter.ClientPageContentFilter * has BinaryContentFilter enabled, for com.sdl.web.preview.client.filter.ClientBinaryContentFilter 4. logs The following should be present in the logs: ensure that claims forwarding is enabled on the client side - where XYZ should be list of claims that will be forwarded. Ensure that "taf:session:preview:preview_session" is present. ForwardedClaims is configured. Will forward following claims: XYZMicroservice configuration when servers communicate using IPv6 Microservices do work with network configured to use IPv6 communication. The two options to enable this are: - Add param "-Djava.net.preferIPv4Stack=true" to the $jvmoptions. A full jvmoptions example would be $jvmoptions = "-Xrs", "-Xms128m", "-Xmx128m", "-Djava.net.preferIPv4Stack=true"Reinstall the microservice(s) by modifying the installService Powershell script in the bin directory. - Use an IPv6 mask in the cd_ambient_conf.xml file, mask format will be something like <WhiteList> <IPAddresses> <Ip>0:0:0:0:0:0:0:0-ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff</Ip> </IPAddresses> </WhiteList>This mask includes IPv4 0.0.0.0-255.255.255.255 |