修改magnolia.repositories.home后无法触发Magnolia新安装的问题

如何强制触发全新安装 #

• 确保magnolia.repositories.home指向完全空的新文件夹，删除该目录下所有残留文件（包括隐藏文件）。
• 启动服务器时添加JVM参数：-Dmagnolia.bootstrap.all=true，强制重新执行所有bootstrap初始化流程，触发安装界面。
• 清理服务器的临时目录（如Tomcat的work、temp文件夹），避免缓存旧配置影响启动。

安装数据存储位置 #

• JCR仓库及Derby数据库文件：全部存储在magnolia.repositories.home指定的目录下，默认包含author（作者实例数据）、public（公共实例数据）、shared（共享数据）三个子目录，以及仓库配置文件magnolia-repository.properties。
• 初始安装的bootstrap数据：来自Magnolia webapp包内的WEB-INF/bootstrap目录，启动时会自动导入到JCR仓库中。

无法看到安装界面的原因 #

• 目标仓库目录非空：magnolia.repositories.home指向的文件夹残留了之前启动生成的配置文件或部分Derby数据，Magnolia判定仓库已初始化，跳过安装流程。
• Bootstrap执行状态被标记为完成：即使仓库为空，若之前启动过实例，bootstrap模块的执行状态可能被缓存，导致不触发安装，需通过-Dmagnolia.bootstrap.all=true参数强制重置。
• 服务器缓存残留：服务器的工作目录或临时文件缓存了旧的Magnolia配置，清理后重启即可解决。

内容的提问来源于stack exchange，提问作者rainxart