Unclassified error occured while trying to activate license.

[weisunglee]

Bug description

Hi, I got an error Unclassified error occured while trying to activate license. since yesterday.

---------- git config --list --show-origin -------------
file:/etc/gitconfig	filter.lfs.smudge=git-lfs smudge -- %f
file:/etc/gitconfig	filter.lfs.process=git-lfs filter-process
file:/etc/gitconfig	filter.lfs.required=true
file:/etc/gitconfig	filter.lfs.clean=git-lfs clean -- %f
Changing to "/github/workspace/_activate-license~" directory.
/github/workspace/_activate-license~ /github/workspace
Requesting activation (personal license)
Unclassified error occured while trying to activate license.
Exit code was: 1
Error: The process '/usr/bin/docker' failed with exit code 1

I found a similar issue #345 but it seems that didn't help with mine.

How to reproduce

Run build with

      - uses: game-ci/unity-builder@v2.1.2
        with:
          targetPlatform: WebGL          

then got the error.

Expected behavior

Successfully build.

Additional details

I had success before, but since yesterday it has been failing, I can't find the reason.

[madebyluque]

Hey @weisunglee ! Have you found a workaround for this error?

[segoja7]

Hi, I have the same error, there is a some fix?

[SeoulSKY]

I don't see the env block in your workflow. Did you add UNITY_LICENSE, UNITY_EMAIL and UNITY_PASSWORD?

[Soloveykos]

here is my variant, it's not working also:

      # Test
      - name: Run tests
        uses: game-ci/unity-test-runner@v3
        env:
          UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}
        with:
          githubToken: ${{ secrets.GITHUB_TOKEN }}
          

used personal license and received:
Requesting activation (personal license)
Unclassified error occured while trying to activate license.
Exit code was: 1
Error: The process '/usr/bin/docker' failed with exit code 1

[Oknaaa]

      - uses: game-ci/unity-builder@v2
        env:
          UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}
          UNITY_EMAIL: ${{ secrets.UNITY_EMAIL }}
          UNITY_PASSWORD: ${{ secrets.UNITY_PASSWORD }}
        with:
          projectPath: ${{ matrix.projectPath }}
          targetPlatform: ${{ matrix.targetPlatform }}
          unityVersion:  ${{ matrix.unityVersion }}

Mine looks like this, Same error. any fix ?

[GabLeRoux]

Unclassified error occured while trying to activate license.

This usually happen when the wrong file was inserted into the UNITY_LICENSE environment variable (Github secret).

Related issues

There are a few related issues in the help threads on our discord:

• https://discord.com/channels/710946343828455455/1159352860065157181
• https://discord.com/channels/710946343828455455/1155980604144365609
• https://discord.com/channels/710946343828455455/1159850778744340490

And some related GitHub issues:

• https://github.com/game-ci/unity-actions/issues/101
• Unclassified error occured while trying to activate license error on every build #345 (the one linked by OP)
• Requesting activation (personal license) #199
• Help. "Requesting activation (personal license). Unclassified error occured while trying to activate license." #159

And I even found this in Unity's forums:

• Using GitHub Actions to build & test Unity project
  I would have replied in that thread, but it says You have insufficient privileges to reply here. 😅

Explanation

Activation process is a bit complicated and it's easy to miss a step. We must follow activation process to the letter. A common mistake is to paste the alf (activation request file) into UNITY_LICENSE instead of the actual ulf license.

Refer to GameCI | Github > Activation documentation

Tips

Make sure that the content of your UNITY_LICENSE env var is the content of the downloaded license (in theulf format, not alf) from Unity's activation website.

• The alf file is an activation request file generated by Unity executable (usually from the request activation file action) that needs to be uploaded to unity's website.
• The ulf is the license you download from Unity's website.

ulf License example

Expand here to see what the ulf License file should look like

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <License id="LicenseInfo">
        <MachineBindings>
            <Binding Key="1" Value="576562626572264761624c65526f7578"/>
            <Binding Key="2" Value="576562626572264761624c65526f7578"/>
        </MachineBindings>
        <MachineID Value="Redacted"/>
        <SerialHash Value="Redacted"/>
        <Features>
            <Feature Value="Redacted"/>
            <Feature Value="Redacted"/>
            <Feature Value="Redacted"/>
            <Feature Value="Redacted"/>
            <Feature Value="Redacted"/>
            <Feature Value="Redacted"/>
            <Feature Value="Redacted"/>
            <Feature Value="Redacted"/>
            <Feature Value="Redacted"/>
            <Feature Value="Redacted"/>
        </Features>
        <DeveloperData Value="Redacted"/>
        <SerialMasked Value="Redacted"/>
        <StartDate Value="Redacted"/>
        <UpdateDate Value="Redacted"/>
        <InitialActivationDate Value="Redacted"/>
        <LicenseVersion Value="Redacted"/>
        <ClientProvidedVersion Value="Redacted"/>
        <AlwaysOnline Value="false"/>
        <Entitlements>
            <Entitlement Ns="unity_editor" Tag="Redacted" Type="Redacted" ValidTo="Redacted"/>
            <Entitlement Ns="unity_editor" Tag="Redacted" Type="Redacted" ValidTo="Redacted"/>
        </Entitlements>
    </License>
    <Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
        <SignedInfo>
            <CanonicalizationMethod Algorithm="Redacted"/>
            <SignatureMethod Algorithm="Redacted"/>
            <Reference URI="#LicenseInfo">
                <Transforms>
                    <Transform Algorithm="Redacted"/>
                </Transforms>
                <DigestMethod Algorithm="Redacted"/>
                <DigestValue>Redacted</DigestValue>
            </Reference>
        </SignedInfo>
        <SignatureValue>Redacted</SignatureValue>
    </Signature>
</root>

The MachineBindings should be 576562626572264761624c65526f7578. This is an hardcoded value in the GameCI docker images. It can be found here.

Detailed steps

Always refer to documentation for most up to date procedures. Here's precise steps I took recently on a fork of a project where someone had same error (and it worked fine):

1. Added .github/workflows/activation.yml from GameCI | Github > Activation > personal license
2. Ran manual workflow through Github > Actions > Acquire activation file
3. Downloaded Unity_v2019.2.11f1.alf from Summary page of Acquire activation file workflow
4. Deleted workflow run (to prevent others from downloading my activation request file)
5. Logged in to my Unity3d account on unity3d.com
6. Followed instructions for Converting into a license here
7. Did the trick about showing hidden activation section (I wish Unity didn't hide this...). Right now, you can't miss it, there's a big warning on GameCI's activation page.
8. Downloaded my license file (Unity_v2019.x.ulf
9. Visited https://github.com/GabLeRoux/EmptyProject/settings/secrets/actions (the project's Settings > Security > Secrets and variables > Actions) and Clicked 8. New repository secret button
10. Copied the content of downloaded license (Unity_v2019.x.ulf), I personally copy the content with cat ~/downloads/Unity_v2019.x.ulf | pbcopy on macOS to prevent any bad manipulation, but a good technique is to open the file in a vode editor such as Visual Studio Code and copy from here.
    Name: UNITY_LICENSE
    Secret: paste content of license (content of Unity_v2019.x.ulf), then hit Add secret
11. I went back to Actions > "Actions 😎" > clicked on the Job I previously cancelled and clicked on Re-run Jobs which re-runs the "Build my project ✨" job.

Hope it works for you 🙏

[AndrewKahr]

V4 has a new activation process so this should be resolved