JBoss Server Migration Tool fails with WFLYEMB0021: Cannot start embedded process when migrating domain.xml file

Solution Verified - Updated

Environment

  • Red Hat JBoss Enterprise Application Platform (EAP)
    • 7.1
    • 6.4

Issue

JBoss Server Migration Tool fails with WFLYEMB0021: Cannot start embedded process when migrating domain.xml file. The $JBOSS_HOME/migration/logs/migration.log file shows:

    OPVDX001: Validation error in domain.xml --------------------------------
    |
    |  491: 
    |  492: <subsystem xmlns="urn:jboss:domain:transactions:1.5">
    |  493:     <core-environment path="var" relative-to="jboss.server.data.dir" node-identifier="${jboss.server.name}">
    |           ^^^^ The attribute 'path' is no longer supported
    |
    |  494:         <process-id>
    |  495:             <uuid></uuid>
    |  496:         </process-id>
    |
    | The primary underlying error message was:
    | > ParseError at [row,col]:[493,17]
    | > Message: WFLYTX0031: The attribute 'path' is no longer supported
    |
    |-------------------------------------------------------------------------------

Resolution

Apply CP5 or later to EAP 7.1

Workaround

Remove the attribute path and relative-to from the transaction subsystem before running the migration tool.

Related Solutions:

Root Cause

There are invalid/deprecated attributes in the transaction subsystem:

            <subsystem xmlns="urn:jboss:domain:transactions:3.0">
                 <core-environment path="var" relative-to="jboss.server.data.dir" node-identifier="${jboss.server.name}"> <!-- this is invalid -->
                    <process-id>
                        <uuid/>
                    </process-id>
                </core-environment>
                <recovery-environment socket-binding="txn-recovery-environment" status-socket-binding="txn-status-manager"/>
            </subsystem>

This is explained in Content from issues.jboss.org is not included.JBEAP-14809 - Validation error in migration due to deprecated attributes in transaction subsystem.

Diagnostic Steps

See migration output, migration reports and logs at: $JBOSS_HOME/migration/logs/migration.log

SBR
Product(s)
Components
Category
Tags

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.