Connectrix Brocade B-Series : Failing to Install License on Switch with error :"parser error: Document is empty"

tmp/license_alc.xml:1: parser error : Document is empty
License install failed - Invalid license, please contact your reseller.
License install failed - License operation is currently blocked , please try again later.

This occurs when a certificate (during the process of importation) goes through a DOS/Microsoft Windows transition.

The DOS/Windows system places a ^M (carriage return ) character at the end of a valid footer, which results in the validation failure.

- On a Unix machine, use the command to check for unwanted characters.

'cat -v '

Example:

<?xml version="1.0" encoding="UTF-8"?><licenseInfo>^M

    <licenseHeader>^M

        <productName>FOS</productName>^M

        <licenseId>10:00:xx:xx:xx:35:xx:00</licenseId>^M

        <serialNumber>FOS-86-0</serialNumber>^M

        <featureName>^M

                        Ports on Demand^M

            ^M

            <capacity>8</capacity>^M

        </featureName>^M

        <dateGenerated>11/28/2024</dateGenerated>^M

        <dateExpiry>NA</dateExpiry>^M

        <validityDays>NA</validityDays>^M

        <runningFirmwareVersion>NA</runningFirmwareVersion>^M

        <targetFirmwareVersion>NA</targetFirmwareVersion>^M

    </licenseHeader>^M

    <license>^M

        <keyIndex>9</keyIndex>^M

        <licSign> /yJhZZraz3CL+EHE2XPU2A/8HWtDx3ah2YDG+If7UQGIVoJ0oN/ C8ZCLPCIQks5cPt3LO+wnyGdl6trh0qdDhpzjk8RzNiZVmo=</licSign>^M

    </license>^M

WorkAround:

-Unwanted characters could be removed by using the below command:

'unix2dos '

Or

- While using  Windows machine, download the license file again but do NOT open it in any text editor. Apply the certificate directly using WebTools.

Resolution:

There is  a software defect (FOS-849790) which addresses this issue - fix was implemented in FOS v9.2.0b and 9.2.1.