Removing invalid characters from XML backups
JIRA 3.1 and above should not suffer from this problem. Invalid characters are automatically stripped from imported data
In older versions of JIRA it was possible to cut & paste text containing control characters into JIRA issue fields. This causes problems, because JIRA's backup format is XML, and XML does not allow for the storage of most control characters .When XML containing control characters is imported into JIRA, the import fails with an error:
To fix this, the control characters will need to be removed from the JIRA backup file. This can be done with the following:
- Download atlassian-xml-cleaner-0.1.jar
- Open a command prompt and locate the XML or ZIP backup file on your computer, ensuring that it is extracted if it's within a ZIP file. In this example, we will use
entities.xml
. Run the application with the below:
$ java -jar atlassian-xml-cleaner-0.1.jar entities.xml > entities-clean.xml
This will create a copy of
entities.xml
asentities-clean.xml
with the invalid characters removed.- Copy the
entities-clean.xml
file into another directory, rename it back toentities.xml
and create a new ZIP with and theactiveobjects.xml
file. - Import the new ZIP file, ensuring that it contains both XML files.
If you are seeing an error specifically with 0xffff as the affected character, please use this perl command to fix the file:
perl -i -pe 's/\xef\xbf\xbf//g' entities.xml
Credit for this goes to Jeff Turner who suggested this in the comments below: Re: Removing invalid characters from XML backups