Groups keyboard shortcuts have been updated
Dismiss
See shortcuts

Migrating from rundeck.projectsStorageType=filesystem to rundeck.projectsStorageType=db

41 views
Skip to first unread message

Sean McGurk

unread,
Jan 7, 2025, 6:01:57 PMJan 7
to rundeck-discuss
Hi there,

I am in the process of migrating our vm-based rundeck instance from version  3.2.0 to a containerised version of the latest image (5.9.0).

Reading the release notes for Upgrading to Rundeck 3.4 (https://docs.rundeck.com/docs/upgrading/upgrading-to-rundeck-3.4.html), I see that support for File System Based project definitions has been removed.

This is what we are currently using to store our project definitions and configuration.

According to the documentation, If we are using this mode, you will see a warning at startup, and projects will be converted to DB storage automatically.

I have tried adding the following line to my Dockerfile to ensure that this configuration value is set:

RUNDECK_PROJECTS_STORAGE_TYPE=filesystem

but when I load the UI, I do not see the warning at startup and my projects are not converted to db storage.

I am however able to see them in the 'projects' folder on the filesystem.

Can anyone tell me what I might be doing wrong?

Thanks,
Sean


rac...@rundeck.com

unread,
Jan 8, 2025, 7:53:25 AMJan 8
to rundeck-discuss

Hi,

I am in the process of migrating our vm-based rundeck instance from version 3.2.0 to a containerised version of the latest image (5.9.0).

The gap between 3.2.0 and 5.8.0 (latest at this moment) is huge. The best way to migrate that instance is to launch a fresh 5.8.0 instance and then import project, acl, etc. Please take a look at this.

In that way you can avoid some specific migration steps between 3.2.0 and 5.9.0 like log42 upgrade steps, etc.

but when I load the UI, I do not see the warning at startup and my projects are not converted to db storage.
I am however able to see them in the ‘projects’ folder on the filesystem.

The warning should be present on the service.log (the docker standard output in your case) as follows:

[2025-01-08T09:08:09,980] WARN framework.RundeckFrameworkFactory [main] - Invalid value for rundeck.projectsStorageType configuration: filesystem, The 'filesystem' value is no longer supported. You should remove the rundeck.projectsStorageType configuration. Using 'db' storage type.

I have tried adding the following line to my Dockerfile to ensure that this configuration value is set:
RUNDECK_PROJECTS_STORAGE_TYPE=filesystem

That config isn’t longer valid for 5.8.0. Probably the project stuff is already in your db backend, can you confirm?

Here is the result on my end: before upgrading, after upgrading.

Anyway, the main advice is to run a fresh 5.8.0 and import your old stuff there.

Regards!

Sean McGurk

unread,
Jan 8, 2025, 12:07:17 PMJan 8
to rundeck-discuss
Thanks!

Of course - this makes perfect sense.

I was able to export the project configuration from my 'old' instance and import it into my new instance - worked perfectly!
Reply all
Reply to author
Forward
0 new messages