Airsonic: Recommended way to upgrade Airsonic (Tomcat WAR version)?

[protist]

Problem description

What is the recommended way to upgrade the Tomcat WAR version of Airsonic, while keeping all data intact?

Should we follow the normal installation instructions? Or should we only replace /var/lib/tomcat8/webapps/airsonic.war, leaving /var/lib/tomcat8/webapps/airsonic/ and /var/lib/tomcat8/work/* intact? What are files in these two directories for anyway?

Steps to reproduce

1. Attempt to upgrade

System information

• Airsonic version: 10.1.1-RELEASE – December 16, 2017
• Operating system: Linux, Raspbian (Debian)
• Proxy server: None
• Client: N/A.

[nate2014jatc]

just replacing the war file leads to many errors and an unusable server on my end.

[xerg0n]

This was asked before on reddit, here and here. Basically its:

• shutdown tomcat
• replace war and delete the airsonic folder under webapps
• start tomcat

Worked without any problem for me.

[protist]

This was asked before on reddit

Thanks. I had actually found both threads, but there were conflicting responses, and the devs hadn't replied in either thread. I wanted an official response from the devs, and preferably in the manual too.

FWIW your instructions are yet another permutation! Some have said remove /var/lib/tomcat8/webapps/airsonic/ and /var/lib/tomcat8/work/*, some have said leave them, but you are the first to say only remove the former!

[xerg0n]

Hey,
I am not the dev, but double checked what I did last time I updated to be sure.
I have the war deployed to root and did:

service tomcat8 stop
cd /usr/local/apache-tomcat-8.0/webapps
rm ROOT.war
rm -R ROOT
wget https://github.com/airsonic/airsonic/releases/download/[latest-version]/airsonic.war
mv airsonic.war ROOT.war
chown www:www ROOT.war
service tomcat8 start

I did not do any backups, so in case you are worried about this replace the rm with mv to a different name.

I overlooked the part about the work folder, but looking at this it seems like its a good idea to remove the work folder to clear the cache. This basically makes my response equal to the reddit one

[stale[bot]]

This issue has been automatically marked as stale because it has not had recent activity. Thank you for your contributions.

[protist]

This issue was closed, but I was still waiting for an official response.

[jvoisin]

I added some lines to the documentation.

It'll show up as soon as the documentation's website is rebuilt.

[protist]

Thank you. A few of the paths are inconsistent with this file, but overall it worked fine for me.