JBoss ON 3.3 server update fails on Windows due to insufficient memory/the file name is too long error when creating archive

Solution Unverified - Updated

Environment

  • Red Hat JBoss Operations Network (ON) 3.3.0, 3.3.1, 3.3.2, 3.3.3
  • Microsoft Windows
  • Using the apply-updates utility to update a JBoss ON 3.3 server installation

Issue

  • Errors trying to apply update
  • Unable to upgrade server due to archiving step fails with Insufficient memory error
  • Backup of CallTimeDataConverterValidator.class fails resulting in apply-updates command aborting

Resolution

  1. Restore the JBoss ON server files from your backup.
  2. Apply JBoss ON 3.3 Update-04 (3.3.4) or later.

Root Cause

Microsoft Windows has a basic file path limit of 260 characters as described in Content from msdn.microsoft.com is not included.Maximum Path Length Limitation of the Content from msdn.microsoft.com is not included.Naming Files, Paths, and Namespaces Windows Dev Center article. This limitation prevents the apply-updates utility from copying files to necessary locations when dealing with long Java package and class names deployed into a root directory that is more then a few characters long.

This issue has been captured as This content is not included.Red Hat Bugzilla 1247311 and was addressed in JBoss ON 3.3 Update-04 and later.

Diagnostic Steps

  • Review the update.log file for the failure Insufficient memory when performing the archive step:

      [Mon 08/03/2015 13:11:52.03] Archiving 
          [D:\jon\jon-server-3.3.0.GA\modules\org\rhq\server-startup\main\deployments\rhq.ear\rhq-portal.war\WEB-INF\classes\org\rhq\enterprise\gui\legacy\action\resource\common\monitor\alerts\config\condition\CallTimeDataConverterValidator.class] to: 
          [D:\jon\jon-server-3.3.0.GA\.patched\080315131048\.old\modules\org\rhq\server-startup\main\deployments\rhq.ear\rhq-portal.war\WEB-INF\classes\org\rhq\enterprise\gui\legacy\action\resource\common\monitor\alerts\config\condition\]        
      [Mon 08/03/2015 13:11:52.03] xcopy /y /c /h /r /e "D:\jon\jon-server-3.3.0.GA\modules\org\rhq\server-startup\main\deployments\rhq.ear\rhq-portal.war\WEB-INF\classes\org\rhq\enterprise\gui\legacy\action\resource\common\monitor\alerts\config\condition\CallTimeDataConverterValidator.class" "D:\jon\jon-server-3.3.0.GA\.patched\080315131048\.old\modules\org\rhq\server-startup\main\deployments\rhq.ear\rhq-portal.war\WEB-INF\classes\org\rhq\enterprise\gui\legacy\action\resource\common\monitor\alerts\config\condition\" 
      Insufficient memory
      0 File(s) copied
    
SBR
Category

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.