starting the server from an older release will cause a {case_clause,version_not_available}

[snackycracky]

Hello,
I have checked out the tag v3.11.23 and wanted to start the server with the command make run-broker but it yields the following error. Where am I supposed to set the version, when it's not available?

2023-10-07 12:27:16.898279+00:00 [notice] <0.234.0> Logging: switching to configured handler(s); following messages may not be visible in this log output

              RabbitMQ 3.11.23+dirty
        
              Copyright (c) 2007-2023 VMware, Inc. or its affiliates.
            
              Licensed under the MPL 2.0. Website: https://rabbitmq.com

  Erlang:      25.0 [jit]
  TLS Library: OpenSSL - OpenSSL 1.1.1f  31 Mar 2020
  Release series support status: supported

  Doc guides:  https://rabbitmq.com/documentation.html
  Support:     https://rabbitmq.com/contact.html
  Tutorials:   https://rabbitmq.com/getstarted.html
  Monitoring:  https://rabbitmq.com/monitoring.html

  Logs: /tmp/rabbitmq-test-instances/rabbit@worker1/log/[email protected]
        /tmp/rabbitmq-test-instances/rabbit@worker1/log/rabbit@worker1_upgrade.log
        <stdout>

  Config file(s): /tmp/rabbitmq-test-instances/test.config

  Starting broker...
BOOT FAILED
===========
Exception during startup:

error:{case_clause,version_not_available}

    rabbit_boot_steps:-run_step/2-lc$^0/1-0-/2, line 41
    rabbit_boot_steps:run_step/2, line 48
    rabbit_boot_steps:-run_boot_steps/1-lc$^0/1-0-/1, line 19
    rabbit_boot_steps:run_boot_steps/1, line 20
    rabbit:start/2, line 958
    application_master:start_it_old/4, line 293

{"Kernel pid terminated",application_controller,"{application_start_failure,rabbit,{{case_clause,version_not_available},{rabbit,start,[normal,[]]}}}"}
Kernel pid terminated (application_controller) ({application_start_failure,rabbit,{{case_clause,version_not_available},{rabbit,start,[normal,[]]}}})

Crash dump is being written to: /tmp/rabbitmq-test-instances/rabbit@worker1/log/erl_crash.dump...done
make: *** [/home/nils/dev/tmp/rabbitmq-server/deps/rabbit_common/mk/rabbitmq-run.mk:288: run-broker] Error 1

[lukebakken]

I can't reproduce what you report. make run-broker from the 3.11.23 tag works fine in my environment. I suggest running git clean -xffd in yours and trying again. You should capture a complete transcript of all of the commands you run and their output so we know exactly what you are doing. ATTACH that as a file (do not paste it!!!) to a comment here if you'd like us to assist.

              RabbitMQ 3.11.23

              Copyright (c) 2007-2023 VMware, Inc. or its affiliates.

              Licensed under the MPL 2.0. Website: https://rabbitmq.com

  Erlang:      25.3.2.6 [jit]
  TLS Library: OpenSSL - OpenSSL 3.1.2 1 Aug 2023
  Release series support status: supported

  Doc guides:  https://rabbitmq.com/documentation.html
  Support:     https://rabbitmq.com/contact.html
  Tutorials:   https://rabbitmq.com/getstarted.html
  Monitoring:  https://rabbitmq.com/monitoring.html

  Logs: /tmp/rabbitmq-test-instances/rabbit@PROKOFIEV/log/[email protected]
        /tmp/rabbitmq-test-instances/rabbit@PROKOFIEV/log/rabbit@PROKOFIEV_upgrade.log
        <stdout>

  Config file(s): /tmp/rabbitmq-test-instances/test.config

  Starting broker... completed with 36 plugins.

[snackycracky]

I did the following steps:

➜  ~ cd /tmp
➜  /tmp g clone [email protected]:rabbitmq/rabbitmq-server.git
Cloning into 'rabbitmq-server'...
remote: Enumerating objects: 406871, done.
remote: Counting objects: 100% (4616/4616), done.
remote: Compressing objects: 100% (1915/1915), done.
remote: Total 406871 (delta 3181), reused 3652 (delta 2646), pack-reused 402255
Receiving objects: 100% (406871/406871), 192.26 MiB | 10.83 MiB/s, done.
Resolving deltas: 100% (257624/257624), done.

tested the erlang version:

➜  /tmp cd rabbitmq-server
➜  rabbitmq-server git:(main) erl
Erlang/OTP 25 [erts-13.0] [source] [64-bit] [smp:8:8] [ds:8:8:10] [async-threads:1] [jit:ns]

Eshell V13.0  (abort with ^G)
1>

switched to the release tag:

➜  rabbitmq-server git:(main) gco v3.11.23
HEAD is now at 1fc362c6d1 Merge pull request #9352 from rabbitmq/dependabot/github_actions/v3.11.x/actions/cache-3.3.2
➜  rabbitmq-server git:(v3.11.23)

then executed the make run-broker command with the following output attached:
output_make_run_broker.txt

[michaelklishin]

This error was used in a 3.11 upgrade code path. Wipe node's data directory. You cannot start a 3.11 node with a data directory of a more recent version anyway.

When Make is used, it should be under $TMP/rabbitmq-instances or $TEMP/rabbitmq-instances or /tmp/rabbitmq-instances or something like that. Wiping that entire enclosing directory is perfectly fine during development.

[snackycracky]

thanks, it was the directory /tmp/rabbitmq-test-instances that I should have wiped. Now the server starts fine.

[michaelklishin]

version_not_available is a misleading atom to use, the check looks for a schema version file to determine what schema database upgrade functions must be run. That has been changed since 3.11.