IBM Support

Download Artifacts step throws java.lang.NoClassDefFoundError: java/text/Normalizer...

Technote (troubleshooting)


IBM UrbanCode Deploy Download Artifacts step yields the error "java.lang.NoClassDefFoundError: java/text/Normalizer...".


When a component tries to execute a Download Artifact step, the step fails with the following exception:

Caught: java.lang.NoClassDefFoundError: java/text/Normalizer$Form
java.lang.NoClassDefFoundError: java/text/Normalizer$Form
at com.urbancode.vfs.client.PatternPathFilter.(



IBM UrbanCode Deploy Versioned File Storage plugin requires java.text.Normailzer class which is available in JDK 1.6 or greater.

Diagnosing the problem

Verify the version of Java in use:

  1. Go to Resources > Agent
  2. Select the agent that you tried to deploy
  3. Click Configuration > Agent Properties
  4. Check the JAVA_HOME properties


If the JDK’s version is 1.5 or below, you need to upgrade system JDK.

Resolving the problem


  1. Login to the machine that hosts the agent

  2. Install JDK 1.6 or higher to the machine

  3. Go to the agent bin directory and execute the stop command

    Example: <agent_home>/bin/ibm-ucdagent stop

  4. In <agent_home>/bin directory, use a text editor to edit ibm-ucdagent file

  5. Update JAVA_HOME property value so that it points to the new JDK directory and save the file

  6. Go to <agent_home>/conf/agent > and open file with a text editor

  7. Update IBM\ UrbanCode\ Deploy/java.home property with the new JDK path and save the file

  8. Go to the agent bin directory and execute the start command

    Example: <agent_home>/bin/ibm-ucdagent start

It the issue persists, contact IBM support.

Document information

More support for: IBM UrbanCode Deploy
General Information

Software version: 6.0, 6.0.1,,,,

Operating system(s): AIX, HP-UX, Linux, OS X, Solaris, Windows

Reference #: 1672458

Modified date: 06 December 2014