Posts in Category "Trouble Shooting"

Content Services clear cache and index check

This blog is relevant to all LiveCycle Content Services customers who are using CS directly or might be using applications that use CS (like CM 2.5 or customized Workspace to use CS in background).

In case if you see any inconsistency in search results of the assets that are stored in Content Services then you may follow below steps to troubleshoot that issue.

I would recommend performing these on development and test environments and not on production system. These steps do not cause any side effects but it is advised to perform these in assistance with LiveCycle support if you are doing it on production systems ( just to avoid any user errors while performing these steps)

One of the reasons for search result inconsistency could be due to cache. Follow the below steps to clear cache and then use your application to check if search results are as expected.

Steps to clean cache :

  1. Log on to http://hostname:port/contentspace as administrator
  2. In the same browser session change the above URL in address bar to http://[hostname]:[port]/contentspace/wcservice/adobe/cms/cleancache/webscript
  3. Hit Enter
  4. You would see a success message after the cache is cleaned
  5. Check the search behavior now from customized workspace UI and/or from CM Manage Assets UI

If the issue still persists , check if the indexes are out of sync

  1. Go to http://hostname:port/contentspace/service/enterprise/admin/indexcheck URL, login as administrator
  2. Click on Check all txn ids (warning: this may take some time)

Note: This operation will take some time and is recommended to be performed when the load on the system is very low (post business hours) or during weekends when no one or not many people are using the system for development or testing.

Also if your development or test  system is cluster, perform these steps on all the nodes separately.

Flash player release or debug ?

 

LiveCycle Correspondence Management Solution has a Flex based user interface which works with Flash Player version of 10.2 or above.

 

Though Flash Player is installed almost on every internet connected PC , often some Correspondence Management solution users have following questions in their minds

1) What is the version of Flash Player plug-in installed in my browserr?

2) Is the Flash Player plug-in that is installed in my browser a release version or a debug version?

When users log on to Correspondence Management Solution http://hostname:port/cm/manageassets.html , Correspondence Management Asset Manager UI is loaded only if FlashPlayer 10.2 or higher is installed if not users are prompted with a URL in their browser to get a latest version of Flash from Adobe’s website.

 

latest version of Flash Player can be downloaded from http://get.adobe.com/flashplayer/

If FlashPlayer is already installed it’s easy to check which version of it is installed

1) If you are connected to internet just click here to check what version of Flash Player you currently have and what is the latest version available

2) If you are not connected to internet , Once you log on to CM solution , Right Click anywhere on Manage Assets UI , If the FlashPlayer is of debug version you would see a menu item ‘Debugger’ in context sensitive menu , If not it means the Flash Player that is installed is a release version. Version number of Flash Player is also displayed on the context sensitive menu (see the below image)

 

Connection Error

 

Developers who are working with Correspondence Management solution would have encountered these errors when working with author and publish instances (see the screen grab of error below).

 

 

These errors will be seen when Author and Publish instances of Correspondence Management solution are run on same machine and if one tries to work with both author and publish instances in two different tabs of same browser. This is quite common on a development system but not on production systems.

These errors can be avoided in different ways

1) Instead of accessing author and publish with same name or IP in browser’s address bar , One can use an IP address for one instance and FQDN for another instance i.e

http://fqdn:author-port/cm/manageassets.html (for author)

http://ipaddress:publish-port/cm/manageassets.html (for publish)

2) One can use two different browsers , one for accessing author instance and another for publish instance

3) Make two entries in hosts file with same IP address but different names , i.e if one’s client machine’s IP address is xx.xx.xxx.xxx one can add following entries in the hosts file of client machine from where the author and publish CM instances are accessed via browser and access the author and publish instances with their names provided in hosts file

e.g entries in hosts file (If the system is Win XP the hosts file will be under %SystemRoot%\system32\drivers\etc\ folder )

xx.xx.xxx.xxx    author

xx.xx.xxx.xxx    publish

Once the above entries are made in hosts file one can access the author and publish instances as below

http://author:author-port/cm/manageassets.html

http://publish:publish-port/cm/manageassets.html

 

If double-click doesn’t work

 

With ADEP release running an Experience Server is as simple as double-clicking Solutions Quickstart

One needs to obtain a license file, copy license file and Solutions Quickstart to some folder and double-click Solutions Quickstart to get everything up and running *but* at times you may notice that Experience Server does not start [though it’s not a problem with Solutions Quickstart] on double-click.

Solutions Quickstart is a jar file and it doesn’t start on double-click if some other program has hijacked the jar file extension i.e when we install JRE on Windows system the file “jar” is correctly associated with javaw.exe and if any other program like a zip utility is installed that utility modifies the association of jar file and when you double click Solution Quickstart instead of starting Experience Server it just opens up the file or does nothing.

In order to fix this problem, I suggest four ways :

  1. Right click on Solutions Quickstart jar file , In context sensitive menu Go to open with , Select Java(TM) Platform SE binary. If this option is not visible in context sensitive menu click Choose Program and Browse to <Java_Home>\jre\bin\javaw.exe , Select Java(TM) Platform SE binary in Open with dialog , Check “Always use selected program to open this kind of file”, Click OK
  2. Tweak the registry key “HKEY_CLASSES_ROOT\jarfile\shell\open\command” to “<prefix_correct_path_till_Java_Folder>\\jre6\bin\javaw.exe” -jar “%1″ %*
  3. There are scores of jarfix utilities that are available on internet , You can use any such utility , One such utility is available here [Read terms & conditions , license agreement before using this utility or any such utility]
  4. Re-install JRE
Any of the ways suggested above should fix the problem and you should be able to start Experience Server with just a click of a button.
Alternatively Solutions Quickstart can also be started from command prompt for more information on this refer to my earlier post [Installation section] on my blog

 

Error – Server.Processing

 

At times users may encounter the below error message with Title “Error – Server.Processing” and message “An error occured while fetching configuration”.

When the above message is shown on Correspondence Management Manage Assets UI screen , It could be due to either of the following two things :

  1. Experience Server is not properly configured with a Document Server or
  2. Experience Server is unable to communicate with the configured Document Server

 

How do I check if Experience Server is properly configured with a Document Server ( Issue # 1 above )?

1. If Experience Server is running on the same machine where Document Server is run in turnkey mode [ JBoss using default ports] no additional configuration is needed to be done by user , Experience server configurations include URL to connect to Document Server running on same machine using default JBoss port

2. If Experience Server is running on a different machine than the machine that runs Document Server or If Experience Server needs to use Document Server running on JBoss using non-default port of any other supported application server like WebLogic or WebSphere then follow below steps to check the configuratio

2.1 Log on to Felix Web console http://[hostname]:[port]/system/console/bundles as admin (default admin credentials , username : admin , password:admin )

2.2 Click “Document Services Settings” Tab

2.3 Enter correct Document Server Url , username , password and Experience Server Url values and click configure

 

If Experience Server is properly configured with Document Server but still you are seeing the above Error (Issue # 2 mentioned above)

  • Then check if you are able to connect to Document Server from the machine where you are running Experience Server
  • Try to access Document Server adminui page using a browser from Experience Server  http://[hostname]:[port]/adminui

 

If you are thinking of why should we configure Experience Server with a Document Server? :-)

  • Correspondence Management needs ADEP Forms or Output running on Document Server in order to preview or submit any letter and to kick off any post-process if attached to the letter after letter submission

 

Refer to more detailed install docs on official Adobe help documentation for configuring Experience Server with Document Server.

 

.