@ -1,9 +0,0 @@ |
||||
--- |
||||
sidebar_navigation: |
||||
title: Docker installation |
||||
priority: 300 |
||||
--- |
||||
|
||||
# Docker installation |
||||
|
||||
TODO |
@ -0,0 +1,14 @@ |
||||
--- |
||||
sidebar_navigation: |
||||
title: Installation |
||||
priority: 400 |
||||
--- |
||||
|
||||
# Installing OpenProject |
||||
|
||||
OpenProject can be setup in two different ways: |
||||
|
||||
| ----------- | :---------- | |
||||
| [Installation with DEB/RPM packages](./packaged) | This is the recommended way to install OpenProject | |
||||
| [Installation with docker](./docker) | This method of installation will undergo some changes soon and is currently not recommended | |
||||
|
@ -1,6 +1,6 @@ |
||||
--- |
||||
sidebar_navigation: |
||||
title: Installation guide |
||||
title: Docker |
||||
priority: 300 |
||||
--- |
||||
|
@ -1,12 +1,184 @@ |
||||
--- |
||||
sidebar_navigation: |
||||
title: Initial configuration |
||||
priority: 100 |
||||
title: Packages |
||||
priority: 400 |
||||
--- |
||||
|
||||
# Initial configuration of your packaged installation |
||||
# Install OpenProject with DEB/RPM packages |
||||
|
||||
After you have successfully installed the OpenProject package ([see the installation guide](../installation)), you can now perform the initial configuration of OpenProject, using the wizard that ships with the OpenProject package. |
||||
The packaged installation of OpenProject is the recommended way to install and maintain OpenProject using DEB or RPM packages. |
||||
|
||||
The package will: |
||||
|
||||
- guide you through all the required steps |
||||
|
||||
- install all the required libraries and dependencies |
||||
|
||||
- install a local PostgreSQL database or allow you to connect to an existing PostgreSQL database |
||||
|
||||
- allow you to install and configure an outer Apache web server (recommended) |
||||
|
||||
- setup SSL/TLS encryption for the Apache server (optional) |
||||
|
||||
- configure repositories (Git/SVN) (optional) |
||||
|
||||
- configure email settings |
||||
|
||||
The package is available for the following Linux distributions: |
||||
|
||||
| Distribution (**64 bits only**) | |
||||
| ------------------------------- | |
||||
| CentOS/RHEL 7.x | |
||||
| Debian 9 Stretch | |
||||
| Debian 10 Stretch | |
||||
| Suse Linux Enterprise Server 12 | |
||||
| Ubuntu 16.04 Xenial Xerus | |
||||
| Ubuntu 18.04 Bionic Beaver | |
||||
|
||||
Please ensure that you are running on a 64bit system before proceeding with the installation. You can check by running the `uname -i` command on the target server and verifying that it outputs `x86_64`: |
||||
|
||||
```bash |
||||
$ uname -i |
||||
x86_64 |
||||
``` |
||||
|
||||
Also, please note that the packaged installation works best when running on a dedicated server or virtual machine, as we cannot ensure that the components installed and configured by the OpenProject installer will work on systems that have been already customized. |
||||
|
||||
## Ubuntu 18.04 |
||||
|
||||
Import the PGP key used to sign our packages: |
||||
|
||||
```bash |
||||
wget -qO- https://dl.packager.io/srv/opf/openproject/key | sudo apt-key add - |
||||
``` |
||||
|
||||
Add the OpenProject package source: |
||||
|
||||
```bash |
||||
sudo wget -O /etc/apt/sources.list.d/openproject.list \ |
||||
https://dl.packager.io/srv/opf/openproject/stable/10/installer/ubuntu/18.04.repo |
||||
``` |
||||
|
||||
Download the OpenProject package: |
||||
|
||||
```bash |
||||
sudo apt-get update |
||||
sudo apt-get install openproject |
||||
``` |
||||
|
||||
Then finish the installation by reading the [*Initial configuration*][initial-config] section. |
||||
|
||||
## Ubuntu 16.04 |
||||
|
||||
Import the PGP key used to sign our packages: |
||||
|
||||
```bash |
||||
wget -qO- https://dl.packager.io/srv/opf/openproject/key | sudo apt-key add - |
||||
``` |
||||
|
||||
Add the OpenProject package source: |
||||
|
||||
```bash |
||||
sudo wget -O /etc/apt/sources.list.d/openproject.list \ |
||||
https://dl.packager.io/srv/opf/openproject/stable/10/installer/ubuntu/16.04.repo |
||||
``` |
||||
|
||||
Download the OpenProject package: |
||||
|
||||
```bash |
||||
sudo apt-get update |
||||
sudo apt-get install openproject |
||||
``` |
||||
|
||||
Then finish the installation by reading the [*Initial configuration*][initial-config] section. |
||||
|
||||
## Debian 10 |
||||
|
||||
Import the PGP key used to sign our packages: |
||||
|
||||
```bash |
||||
wget -qO- https://dl.packager.io/srv/opf/openproject/key | sudo apt-key add - |
||||
``` |
||||
|
||||
Add the OpenProject package source: |
||||
|
||||
```bash |
||||
sudo wget -O /etc/apt/sources.list.d/openproject.list \ |
||||
https://dl.packager.io/srv/opf/openproject/stable/10/installer/debian/10.repo |
||||
``` |
||||
|
||||
Download the OpenProject package: |
||||
|
||||
```bash |
||||
sudo apt-get update |
||||
sudo apt-get install openproject |
||||
``` |
||||
|
||||
Then finish the installation by reading the [*Initial configuration*][initial-config] section. |
||||
|
||||
## Debian 9 |
||||
|
||||
Import the PGP key used to sign our packages: |
||||
|
||||
```bash |
||||
wget -qO- https://dl.packager.io/srv/opf/openproject/key | sudo apt-key add - |
||||
``` |
||||
|
||||
Add the OpenProject package source: |
||||
|
||||
```bash |
||||
sudo wget -O /etc/apt/sources.list.d/openproject.list \ |
||||
https://dl.packager.io/srv/opf/openproject/stable/10/installer/debian/9.repo |
||||
``` |
||||
|
||||
Download the OpenProject package: |
||||
|
||||
```bash |
||||
sudo apt-get update |
||||
sudo apt-get install openproject |
||||
``` |
||||
|
||||
Then finish the installation by reading the [*Initial configuration*][initial-config] section. |
||||
|
||||
## CentOS 7 / RHEL 7 |
||||
|
||||
Add the OpenProject package source: |
||||
|
||||
```bash |
||||
sudo wget -O /etc/yum.repos.d/openproject.repo \ |
||||
https://dl.packager.io/srv/opf/openproject/stable/10/installer/el/7.repo |
||||
``` |
||||
|
||||
Download the OpenProject package: |
||||
|
||||
```bash |
||||
sudo yum install openproject |
||||
``` |
||||
|
||||
Then finish the installation by reading the [*Initial configuration*][initial-config] section. |
||||
|
||||
## SLES 12 |
||||
|
||||
Add the OpenProject package source: |
||||
|
||||
```bash |
||||
wget -O /etc/zypp/repos.d/openproject.repo \ |
||||
https://dl.packager.io/srv/opf/openproject/stable/10/installer/sles/12.repo |
||||
``` |
||||
|
||||
Download the OpenProject package: |
||||
|
||||
```bash |
||||
sudo zypper install openproject |
||||
``` |
||||
|
||||
Then finish the installation by reading the [*Initial configuration*][initial-config] section. |
||||
|
||||
[initial-config]: #initial-configuration |
||||
|
||||
# Initial Configuration |
||||
|
||||
After you have successfully installed the OpenProject package, you can now perform the initial configuration of OpenProject, using the wizard that ships with the OpenProject package. |
||||
|
||||
## Prerequisites |
||||
|
Before Width: | Height: | Size: 114 KiB After Width: | Height: | Size: 114 KiB |
Before Width: | Height: | Size: 33 KiB After Width: | Height: | Size: 33 KiB |
Before Width: | Height: | Size: 11 KiB After Width: | Height: | Size: 11 KiB |
Before Width: | Height: | Size: 19 KiB After Width: | Height: | Size: 19 KiB |
Before Width: | Height: | Size: 30 KiB After Width: | Height: | Size: 30 KiB |
Before Width: | Height: | Size: 39 KiB After Width: | Height: | Size: 39 KiB |
Before Width: | Height: | Size: 19 KiB After Width: | Height: | Size: 19 KiB |
Before Width: | Height: | Size: 20 KiB After Width: | Height: | Size: 20 KiB |
Before Width: | Height: | Size: 17 KiB After Width: | Height: | Size: 17 KiB |
@ -1,14 +0,0 @@ |
||||
--- |
||||
sidebar_navigation: |
||||
title: Packages |
||||
priority: 400 |
||||
--- |
||||
|
||||
# Packaged installation (DEB/RPM) |
||||
|
||||
The packaged installation is the recommended way to install OpenProject. Follow the instructions detailed in the following guides to get OpenProject running on your own server: |
||||
|
||||
| Main Topics | Description | |
||||
| ----------- | :---------- | |
||||
| [Installation](./installation) | How to install OpenProject from DEB/RPM packages | |
||||
| [Initial configuration](./configuration) | How to perform the initial configuration of OpenProject | |
@ -1,183 +0,0 @@ |
||||
--- |
||||
sidebar_navigation: |
||||
title: Installation |
||||
priority: 200 |
||||
--- |
||||
|
||||
# Installation of OpenProject with DEB/RPM packages |
||||
|
||||
The packaged installation of OpenProject is the recommended way to install and maintain OpenProject using DEB or RPM packages. |
||||
|
||||
The package will: |
||||
|
||||
- guide you through all the required steps |
||||
|
||||
- install all the required libraries and dependencies |
||||
|
||||
- install a local PostgreSQL database or allow you to connect to an existing PostgreSQL database |
||||
|
||||
- allow you to install and configure an outer Apache web server (recommended) |
||||
|
||||
- setup SSL/TLS encryption for the Apache server (optional) |
||||
|
||||
- configure repositories (Git/SVN) (optional) |
||||
|
||||
- configure email settings |
||||
|
||||
The package is available for the following Linux distributions: |
||||
|
||||
| Distribution (**64 bits only**) | Identifier | init system | |
||||
| ------------------------------- | ------------ | ----------- | |
||||
| CentOS/RHEL 7.x | centos-7 | systemd | |
||||
| Debian 9 Stretch | debian-9 | systemd | |
||||
| Debian 10 Stretch | debian-10 | systemd | |
||||
| Suse Linux Enterprise Server 12 | sles-12 | sysvinit | |
||||
| Ubuntu 16.04 Xenial Xerus | ubuntu-16.04 | upstart | |
||||
| Ubuntu 18.04 Bionic Beaver | ubuntu-18.04 | systemd | |
||||
|
||||
Please ensure that you are running on a 64bit system before proceeding with the installation. You can check by running the `uname -i` command on the target server and verifying that it outputs `x86_64`: |
||||
|
||||
``` |
||||
$ uname -i |
||||
x86_64 |
||||
``` |
||||
|
||||
Also, please note that the packaged installation works best when running on a dedicated server or virtual machine, as we cannot ensure that the components installed and configured by the OpenProject installer will work on systems that have been already customized. |
||||
|
||||
## Installation |
||||
|
||||
The first step of the installation is to add the OpenProject package source to the package manager of your distribution (`apt`, `yum`, or `zypper`). |
||||
|
||||
### Ubuntu 18.04 |
||||
|
||||
Import the PGP key used to sign our packages: |
||||
|
||||
``` |
||||
wget -qO- https://dl.packager.io/srv/opf/openproject/key | sudo apt-key add - |
||||
``` |
||||
|
||||
Add the OpenProject package source: |
||||
|
||||
``` |
||||
sudo wget -O /etc/apt/sources.list.d/openproject.list \ |
||||
https://dl.packager.io/srv/opf/openproject/stable/10/installer/ubuntu/18.04.repo |
||||
``` |
||||
|
||||
Download the OpenProject package: |
||||
|
||||
``` |
||||
sudo apt-get update |
||||
sudo apt-get install openproject |
||||
``` |
||||
|
||||
Then finish the installation by reading the [*Initial configuration*][initial-config] section. |
||||
|
||||
### Ubuntu 16.04 |
||||
|
||||
Import the PGP key used to sign our packages: |
||||
|
||||
``` |
||||
wget -qO- https://dl.packager.io/srv/opf/openproject/key | sudo apt-key add - |
||||
``` |
||||
|
||||
Add the OpenProject package source: |
||||
|
||||
``` |
||||
sudo wget -O /etc/apt/sources.list.d/openproject.list \ |
||||
https://dl.packager.io/srv/opf/openproject/stable/10/installer/ubuntu/16.04.repo |
||||
``` |
||||
|
||||
Download the OpenProject package: |
||||
|
||||
``` |
||||
sudo apt-get update |
||||
sudo apt-get install openproject |
||||
``` |
||||
|
||||
Then finish the installation by reading the [*Initial configuration*][initial-config] section. |
||||
|
||||
### Debian 10 |
||||
|
||||
Import the PGP key used to sign our packages: |
||||
|
||||
``` |
||||
wget -qO- https://dl.packager.io/srv/opf/openproject/key | sudo apt-key add - |
||||
``` |
||||
|
||||
Add the OpenProject package source: |
||||
|
||||
``` |
||||
sudo wget -O /etc/apt/sources.list.d/openproject.list \ |
||||
https://dl.packager.io/srv/opf/openproject/stable/10/installer/debian/10.repo |
||||
``` |
||||
|
||||
Download the OpenProject package: |
||||
|
||||
``` |
||||
sudo apt-get update |
||||
sudo apt-get install openproject |
||||
``` |
||||
|
||||
Then finish the installation by reading the [*Initial configuration*][initial-config] section. |
||||
|
||||
### Debian 9 |
||||
|
||||
Import the PGP key used to sign our packages: |
||||
|
||||
``` |
||||
wget -qO- https://dl.packager.io/srv/opf/openproject/key | sudo apt-key add - |
||||
``` |
||||
|
||||
Add the OpenProject package source: |
||||
|
||||
``` |
||||
sudo wget -O /etc/apt/sources.list.d/openproject.list \ |
||||
https://dl.packager.io/srv/opf/openproject/stable/10/installer/debian/9.repo |
||||
``` |
||||
|
||||
Download the OpenProject package: |
||||
|
||||
``` |
||||
sudo apt-get update |
||||
sudo apt-get install openproject |
||||
``` |
||||
|
||||
Then finish the installation by reading the [*Initial configuration*][initial-config] section. |
||||
|
||||
### CentOS 7 / RHEL 7 |
||||
|
||||
Add the OpenProject package source: |
||||
|
||||
``` |
||||
sudo wget -O /etc/yum.repos.d/openproject.repo \ |
||||
https://dl.packager.io/srv/opf/openproject/stable/10/installer/el/7.repo |
||||
``` |
||||
|
||||
Download the OpenProject package: |
||||
|
||||
``` |
||||
sudo yum install openproject |
||||
``` |
||||
|
||||
Then finish the installation by reading the [*Initial configuration*][initial-config] section. |
||||
|
||||
### SLES 12 |
||||
|
||||
Add the OpenProject package source: |
||||
|
||||
``` |
||||
wget -O /etc/zypp/repos.d/openproject.repo \ |
||||
https://dl.packager.io/srv/opf/openproject/stable/10/installer/sles/12.repo |
||||
``` |
||||
|
||||
Download the OpenProject package: |
||||
|
||||
``` |
||||
sudo zypper install openproject |
||||
``` |
||||
|
||||
Then finish the installation by reading the [*Initial configuration*][initial-config] section. |
||||
|
||||
[initial-config]: ../configuration |
||||
|
||||
|
@ -1,170 +0,0 @@ |
||||
# Upgrade your pre-5.0 OpenProject installation (DEB/RPM Packages) |
||||
|
||||
Starting with OpenProject 4.1 stable releases will have their own branch on github. According to this the OpenProject release 6.0 is tracked via the stable/6 branch. We provide a stable branch `stable/<VERSION>` to contain all minor upgrades to OpenProject <VERSION>.x. |
||||
|
||||
For OpenProject 4.2, two packages existed: The OpenProject Core and Community Edition. |
||||
Starting with OpenProject 5.0, both editions have been integrated into the single OpenProject package, which now contains a standard set of the most-used plugins previously contained in the Community Edition. |
||||
|
||||
This guide contains two guides: |
||||
|
||||
* The upgrade guide for OpenProject Core 4.2. to OpenProject 6.0 |
||||
* The migration guide to OpenProject 6.0 from OpenProject Community Edition 4.2. |
||||
|
||||
Please jump directly to the part of this guide depending on your OpenProject version (Core Edition or Community Edition) and operating system. |
||||
|
||||
## Upgrading from OpenProject Core Edition 4.2 |
||||
|
||||
### Preliminary step: Remove the sources.list that defines the OpenProject Core Edition 4.2 |
||||
|
||||
To avoid trying to update the deprecated 4.2 package, remove the following entry: |
||||
|
||||
sudo rm -i /etc/apt/sources.list.d/openproject.list |
||||
|
||||
|
||||
### Debian 7.6 Wheezy 64bits server |
||||
|
||||
echo "deb https://deb.packager.io/gh/opf/openproject wheezy stable/6" | 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/6" | 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/6 |
||||
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/6 |
||||
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/6" "openproject" |
||||
sudo zypper install openproject |
||||
sudo openproject configure |
||||
|
||||
## Migrating from OpenProject Community Edition 4.2 |
||||
|
||||
The `openproject-ce` package no longer exists, but you can migrate to the new OpenProject package, which contains all functionality that was previously contained in the Community Edition. |
||||
|
||||
The following steps were tested on Ubuntu and Debian machines with OpenProject Community Edition 4.2 installed. There may be variations for other distributions, please let us know If you can provide additional information to the migration path. |
||||
|
||||
### Step 1: Backup existing installation |
||||
|
||||
Before performing the migration, please backup your existing installation. While we will continue to use it and database migrations should run smoothly, please keep a backup at hand. |
||||
|
||||
To backup attachments, database and repository, use the following command: |
||||
|
||||
sudo openproject-ce run backup |
||||
|
||||
### Step 2: Shut down openproject-ce instance |
||||
|
||||
To avoid any further changes to the application, stop the web and worker processes: |
||||
|
||||
sudo openproject-ce scale web=0 worker=0 |
||||
|
||||
### Step 3: Confirm database connection details |
||||
|
||||
If you used autoinstall, the database name and database user name should equal `openproject_ce`. You can confirm this by running: |
||||
|
||||
sudo openproject-ce config:get DATABASE_URL |
||||
|
||||
Which should output something of the form |
||||
|
||||
mysql2://<username>:<password>@127.0.0.1:3306/<dbname> |
||||
|
||||
If the URI contains `openproject_ce` as the username and database name as the example above, we can simply continue. |
||||
Otherwise, note user-, database name and password just to be sure. |
||||
|
||||
### Step 4: Remove the openproject-ce package |
||||
|
||||
Remove the `openproject-ce` package from your system. For Debian/Ubuntu, run: |
||||
|
||||
sudo apt-get remove openproject-ce |
||||
|
||||
### Step 5: Remove the sources.list that defines the Community Edition package |
||||
|
||||
To avoid installing the deprecated 4.2 package, remove the following entry: |
||||
|
||||
sudo rm -i /etc/apt/sources.list.d/pkgr-openproject-community.list |
||||
|
||||
|
||||
### Step 6: Move the existing application and configuration files |
||||
|
||||
As the OpenProject 6.0 package is identitical to the core in regards to paths, you'll need to reference the configuration and application (e.g., attachments, SVN repositories) files to the path that is expected from the new package. |
||||
|
||||
# Move openproject-ce configuration |
||||
sudo mv /etc/openproject-ce /etc/openproject |
||||
|
||||
For repositories, there are references in the database to the old `/var/db/openproject-ce/svn/<repository>` locations, so we suggest to symlink them instead: |
||||
|
||||
# Symlink existing attachments and |
||||
sudo ln -s /var/db/openproject-ce /var/db/openproject |
||||
|
||||
### Step 7: Disable the Community Edition Apache2 configuration |
||||
|
||||
As a final step, disable the `openproject-ce` configuration. |
||||
|
||||
sudo a2dissite openproject-ce |
||||
|
||||
Optionally, remove the disabled site. The following path applies to Debian/Ubuntu. |
||||
|
||||
sudo rm -i /etc/apache2/sites-available/openproject-ce.conf |
||||
|
||||
Note: |
||||
|
||||
* For RedHat, the path should be changed to `/etc/httpd/conf.d/openproject-ce.conf`. |
||||
* For SLES, the path should be changed to `/etc/apache2/vhosts.d/openproject-ce.conf`. |
||||
|
||||
### Step 8: Install the OpenProject 6.0 package and select database |
||||
|
||||
The rest of the installation is mostly identical to the installation guide of the OpenProject 5.0 package: |
||||
https://www.openproject.org/open-source/packaged-installation/packaged-installation-guide/ |
||||
|
||||
Add the package source to your package manager, update the sources, and install the `openproject` package. (See the installation guide linked above for the detailed steps for the various distributions). |
||||
|
||||
**Important:** Instead of running `openproject configure`, run `openproject reconfigure`, which will lead you through the complete wizard. |
||||
|
||||
In the first step *mysql/autoinstall*, select the **reuse** option (Use an existing database). |
||||
|
||||
![](https://dl.dropboxusercontent.com/u/270758/op/mysql-reuse.png) |
||||
|
||||
Press OK for the following steps, which will simply take the existing values from your old configuration |
||||
|
||||
* MySQL IP or hostname |
||||
* MySQL port |
||||
|
||||
In the dialog `mysql/username`, enter `openproject_ce` if the Database URI from Step 4 contained it. If you chose a different user name in the original CE installation, it should already be set to this value. |
||||
|
||||
![](https://dl.dropboxusercontent.com/u/270758/op/mysql-username.png) |
||||
|
||||
In the dialog `mysql/password`, **leave the password empty**. It will use the value from your original installation. You can optionally enter the password you retrieved from the database URI from Step 4, but that should be identical. |
||||
|
||||
![](https://dl.dropboxusercontent.com/u/270758/op/mysql-password.png) |
||||
|
||||
And again, in the `mysql/db_name` step, enter `openproject_ce` if the Database URI from Step 4 contained it. If you chose a different database name in the original CE installation, it should already be set to this value. |
||||
|
||||
The other installation steps (mysql/db_source_host, mysql/ssl) may again be skipped by pressing OK, as they should still contain the old values from the Community Edition. |
||||
|
||||
There will be other new steps in the installation wizard for which we will provide additional information in the packager installation guide. |
||||
|
||||
Once the wizard has completed, the OpenProject instance should be updated to 6.0.x while re-using your existing database. |
||||
|
||||
**Note:** This last step is a workaround for the package upgrading process. We are working on making this step optional. |
||||
The workaround is necessary since since the package appname changed from `openproject-ce` to `openproject`, and the installer wizard automatically sets the database to the app name when selecting an automatic installation of MySQL. Instead, the updater should respect an existing database (user-) name in its configuration. |
@ -1,68 +0,0 @@ |
||||
## OpenProject PostgreSQL migration guide to 9.6 |
||||
|
||||
This guide will lead you to the steps of upgrading your system PostgreSQL version to 9.6. |
||||
OpenProject 7.4.0 requires PostgreSQL 9.5+, so we're recommending to install to 9.6 directly. |
||||
|
||||
If you're upgrading to 7.4.0 without a 9.5+ database, your upgrade process will be terminated with a 'Database incompatibility warning'. You should not |
||||
|
||||
Since Ubuntu 14.04 (still supported by OpenProject) is still running on PostgreSQL 9.3., we're showing the |
||||
upgrade process for this distribution. Debian oldstable also uses PostgreSQL 9.4. as well. |
||||
|
||||
### Preparations for the upgrade |
||||
|
||||
Stop the current OpenProject workers |
||||
|
||||
```bash |
||||
service openproject stop |
||||
``` |
||||
|
||||
### Install the newer PostgreSQL version |
||||
|
||||
For Ubuntu 14.04: |
||||
|
||||
```bash |
||||
sudo add-apt-repository "deb http://apt.postgresql.org/pub/repos/apt/ trusty-pgdg main" |
||||
wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add - |
||||
sudo apt-get update |
||||
sudo apt-get install postgresql-9.6 |
||||
``` |
||||
|
||||
|
||||
For other versions of Ubuntu, see this answer on AskUbuntu: |
||||
https://askubuntu.com/questions/831292 |
||||
|
||||
Or check the download for repositories from PostgreSQL: |
||||
https://www.postgresql.org/download/ |
||||
|
||||
|
||||
### Upgrade of PostgreSQL |
||||
|
||||
|
||||
Stop the old cluster: |
||||
|
||||
```bash |
||||
pg_dropcluster 9.6 main --stop |
||||
``` |
||||
|
||||
Upgrade the cluster to 9.6 |
||||
|
||||
```bash |
||||
pg_upgradecluster -v 9.6 9.3 main |
||||
``` |
||||
|
||||
Remove the old cluster |
||||
|
||||
```bash |
||||
pg_dropcluster 9.3 main |
||||
``` |
||||
|
||||
Lastly, remove the ubuntu-provided version of 9.3: |
||||
|
||||
```bash |
||||
apt-get remove postgres postgresql-9.3 |
||||
``` |
||||
|
||||
### Upgrade OpenProject |
||||
|
||||
You can now continue with the regular upgrading guide as detailed on these pages: |
||||
[https://www.openproject.org/operations/upgrading/](https://www.openproject.org/operations/upgrading/) |