Upgrading

Updating From 2.0 to 2.x

Migration of Paths to XDG Standard

Paths of data and configuration files and directories were changed in this version.

Storage and Snapshots Directories: The default location of storage and snapshots directories has changed. Previously, these were located within the user configuration directory. They are now located at ${XDG_DATA_HOME}/aa (which defaults to ~/.local/share/aa).

User Configuration Directory: The default location for the user configuration directory has been changed from ~/.config/aa to ${XDG_CONFIG_HOME}/aa. While the default value remains the same, this location can now be overridden by setting the XDG_CONFIG_HOME environment variable.

The update process is designed to perform the necessary directory changes automatically. Upon the initial launch of the new version, the application will attempt to migrate application data and configuration files from their original locations to the new directories.

Migration does not handle some corner cases. In such situations, manual intervention might be required.

If you have explicitly set option archive-specs-dir or user-config-file to point directly to the previous default configuration directory (~/.config/aa), and the user-config-dir option is not set, while the XDG_CONFIG_HOME environment variable is set to a value different from ~/.config, then the contents of the user configuration directory will be migrated to the location determined by XDG_CONFIG_HOME. Therefore, these files will no longer be located in ~/config/aa, the directory specified by your archive-specs-dir or user-config-file settings. To resolve this, you must either manually move the contents back to the old location or unset archive-specs-dir and user-config-file options.

Note that in version 2.0, setting archive-specs-dir or user-config-file to the default user configuration directory (~/.config/aa) was unnecessary; the location was already the application’s default.