Merge pull request #3006 from opf/feature/add-packager-upgrade-guide

Add packager upgrade guide 4.0 to 4.1
pull/3007/head
MayaBerd 10 years ago
commit 0d1cf1ba82
  1. 93
      doc/operation_guides/packager/upgrade-guide.md

@ -0,0 +1,93 @@
# OpenProject upgrade guide
Starting with OpenProject 4.1 stable releases will have their own branch on github. According to this the OpenProject release 4.1 is tracked via the stable/4.1 branch. But why is this important to how the OpenProject packages are provided:
The OpenProject Core and OpenProject Community Edition release 4.0 packages are derived from the stable branch of the respective repositories. Due to the fact that the branch for the OpenProject releasse 4.1 is tracked via the stable/4.1 branch packages has to be derived from the stable/4.1 branch instead of stable. This change makes it necessary to update the source file for the package management system of the machine OpenProject is currently installed on. A typical `apt-get install openproject` e.g. for debian like systems will not work.
The following upgrade instructions describe in detail what has to be done to upgrade existing 4.0 installations of the OpenProject Core and the OpenProject Community Edition to 4.1 via the package management system. Therefore the guide is split into two parts:
* The upgrade guide for OpenProject Core
* The upgrade guide for OpenProject Community Edition
Please jump directly to the part of this guide depending on your OpenProject version (Core Edition or Community Edition) and operating system.
## OpenProject Core Edition
### Debian 7.6 Wheezy 64bits server
echo "deb https://deb.packager.io/gh/opf/openproject wheezy stable/4.1" | sudo tee /etc/apt/sources.list.d/openproject.list
sudo apt-get update
sudo apt-get install openproject
sudo openproject configure
### Ubuntu 14.04 Trusty 64bits server
echo "deb https://deb.packager.io/gh/opf/openproject trusty stable/4.1" | sudo tee /etc/apt/sources.list.d/openproject.list
sudo apt-get update
sudo apt-get install openproject
sudo openproject configure
### Fedora 20 64bits server
echo "[openproject]
name=Repository for opf/openproject application.
baseurl=https://rpm.packager.io/gh/opf/openproject/fedora20/stable/4.1
enabled=1" | sudo tee /etc/yum.repos.d/openproject.repo
sudo yum install openproject
sudo openproject configure
### CentOS / RHEL 6 64 bits server
echo "[openproject]
name=Repository for opf/openproject application.
baseurl=https://rpm.packager.io/gh/opf/openproject/centos6/stable/4.1
enabled=1" | sudo tee /etc/yum.repos.d/openproject.repo
sudo yum install openproject
sudo openproject configure
### SUSE Linux Enterprise Server 12
sudo zypper addrepo "https://rpm.packager.io/gh/opf/openproject/sles12/stable/4.1" "openproject"
sudo zypper install openproject
sudo openproject configure
## OpenProject Community Edition
### Debian 7.6 Wheezy 64bits server
echo "deb https://deb.packager.io/gh/finnlabs/pkgr-openproject-community wheezy stable/4.1" | sudo tee /etc/apt/sources.list.d/pkgr-openproject-community.list
sudo apt-get update
sudo apt-get install openproject-ce
sudo openproject-ce configure
### Ubuntu 14.04 Trusty 64bits server
echo "deb https://deb.packager.io/gh/finnlabs/pkgr-openproject-community trusty stable/4.1" | sudo tee /etc/apt/sources.list.d/pkgr-openproject-community.list
sudo apt-get update
sudo apt-get install openproject-ce
sudo openproject-ce configure
### Fedora 20 64bits server
echo "[pkgr-openproject-community]
name=Repository for finnlabs/pkgr-openproject-community application.
baseurl=https://rpm.packager.io/gh/finnlabs/pkgr-openproject-community/fedora20/stable/4.1
enabled=1" | sudo tee /etc/yum.repos.d/pkgr-openproject-community.repo
sudo yum install openproject-ce
sudo openproject-ce configure
### CentOS / RHEL 6 64 bits server
echo "[pkgr-openproject-community]
name=Repository for finnlabs/pkgr-openproject-community application.
baseurl=https://rpm.packager.io/gh/finnlabs/pkgr-openproject-community/centos6/stable/4.1
enabled=1" | sudo tee /etc/yum.repos.d/pkgr-openproject-community.repo
sudo yum install openproject-ce
sudo openproject-ce configure
### SUSE Linux Enterprise Server 12
sudo zypper addrepo "https://rpm.packager.io/gh/finnlabs/pkgr-openproject-community/sles12/stable/4.1" "pkgr-openproject-community"
sudo zypper install openproject-ce
sudo openproject-ce configure
Loading…
Cancel
Save