You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/installation-and-operations/installation-faq/README.md
+15-1Lines changed: 15 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -129,6 +129,18 @@ Another approach would be to restart OpenProject completely, especially after ch
129
129
130
130
This will be done automatically in case the package based installation is used.
131
131
132
+
133
+
134
+
### The packaged installation cannot be installed or upgraded due to errors. What could cause them?
135
+
136
+
For packaged installations, the openproject package behaves just like every other system package (dpkg or rpm packages, depending on your distribution). If you encounter errors while trying to install or upgrade, please check the following pieces of information first.
137
+
138
+
1. You have enough free space available on `/opt` or your root `/` partition. Verify that `df -h` has at least a few GB of free space.
139
+
2. You have enough inodes on your partitions left. Verify with `df -i` . As OpenProject packages contains a high number of files, these might cause problems with low free inode counts.
140
+
3. Make sure you do not have a virus scanner such as Sophos or other pieces of software blocking the installation of packages.
141
+
142
+
143
+
132
144
### After upgrading I receive the error message "Your OpenProject installation has pending database migrations. You have likely missed running the migrations on your last upgrade. Please check the upgrade guide to properly upgrade your installation." What does that mean?
133
145
134
146
For some updates of OpenProject, the database layout needs to be adapted to support new features and fix bugs. These changes need to be carried out as part of the update process. This is why it is important to always run `sudo openproject configure`as part of the update process.
@@ -148,6 +160,8 @@ Mind, that repository integration in the sense that you will be able to checkout
148
160
149
161
### How can I uninstall OpenProject (Community Edition or Enterprise on-premises)?
150
162
151
-
The package based installation is intended to be run on a dedicated system. Dedicated in this case means that no other application software should be served by the server. The system can be either physical or virtual. Removing OpenProject is then equivalent with removing that system.
163
+
The package based installation is intended to be run on a dedicated system. Dedicated in this case means that no other application software should be served by the server. The system can be either physical or virtual. Removing OpenProject is then equivalent with removing that system or docker instances.
164
+
152
165
In case the database is stored on a different system, e.g. within a database cluster, it needs to be removed separately. The database URL can be found within the OpenProject installation, via `openproject config:get DATABASE_URL`.
166
+
153
167
In case the attachments are stored on a different system, e.g. on an NFS or on S3, they also need to be removed separately.
Copy file name to clipboardExpand all lines: docs/installation-and-operations/operation/upgrading/README.md
+41-9Lines changed: 41 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,26 +7,25 @@ sidebar_navigation:
7
7
# Upgrading your OpenProject installation
8
8
9
9
<divclass="alert alert-warning"role="alert">
10
-
**Note**: In the rest of this guide, we assume that you have taken the necessary steps to[backup](../backing-up)your OpenProject installation before upgrading.
10
+
**Note**: We strongly recommend that you have backed up your installation before upgrading OpenProject to a newer version, especially when performing multiple upgrades at once. Please follow the[backup](../backing-up)instructions.
|[Package-based installation](#package-based-installation-debrpm)| How to upgrade a package-based installation of OpenProject. |
16
16
|[Docker-based installation](#compose-based-installation)| How to upgrade a Docker-based installation of OpenProject. |
17
+
|[Upgrade notes to 12.x](#upgrade-notes-to-12x)| How to upgrade from OpenProject 9.x or greater to OpenProject 12.x. |
17
18
|[Upgrade notes for 8.x to 9.x](#upgrade-notes-for-8x-to-9x)| How to upgrade from OpenProject 8.x to OpenProject 9.x. |
18
19
|[Upgrade notes for 7.x to 8.x](#upgrade-notes-for-openproject-7x-to-8x)| How to upgrade from OpenProject 7.x to OpenProject 8.x. |
19
20
20
21
## Package-based installation (DEB/RPM)
21
22
22
-
Upgrading OpenProject is as easy as installing a newer OpenProject package and
23
-
running the `openproject configure` command.
23
+
This section concerns upgrading of your OpenProject installation for packaged-based installation methods.
24
24
25
-
<divclass="alert alert-info"role="alert">
26
-
27
-
Please note that the package-based installation uses different release channels for each MAJOR version of OpenProject. This means that if you want to switch from (e.g.) 9.x to 10.x, you will need to perform the steps described in the [installation section](../../installation/packaged) to update your package sources to point to the newer release channel. The rest of this section is only applicable if you want to upgrade a (e.g.) 10.x version to a 10.y version.
28
-
29
-
</div>
25
+
### Patch and minor releases
26
+
Upgrading to a newer patch or minor version of OpenProject is as easy as installing a newer OpenProject package and
27
+
running the `openproject configure` command.
28
+
Please follow the steps listed below according to your Linux distribution.
30
29
31
30
### Debian / Ubuntu
32
31
@@ -51,8 +50,34 @@ sudo zypper update openproject
51
50
sudo openproject configure
52
51
```
53
52
53
+
### Major upgrades
54
+
55
+
OpenProject uses a different package repository for each Major version of OpenProject.
56
+
This means that if you want to switch from (e.g.) OpenProject 11.x to 12.x, you will need to explicitly update your package source to be able to install the newer versions.
57
+
58
+
The necessary steps are the same as setting up the package source for the first time. You can also check the [installation guide](../../installation/packaged) for more information. Please follow the link below to see the appropriate steps for your Linux distribution.
|[Suse Linux Enterprise Server 12](../../installation/packaged/#sles-12)|
71
+
72
+
After following the steps to update the package source, updating the openproject package and running `openproject configure`, your system will be up to date.
73
+
74
+
In case you experience issues, please note the exact steps you took, copy the output of all commands you ran and open a post in our [installation support forum](https://community.openproject.org/projects/openproject/forums/9).
75
+
76
+
77
+
### Running openproject configure
78
+
79
+
It is important that you run the `openproject configure` command after _every_ upgrade of OpenProject, as this will ensure your installation is being updated and necessary database migrations are being performed.
54
80
55
-
<divclass="alert alert-info"role="alert">
56
81
Using `openproject configure`, the wizard will display new steps that weren't available yet or had not been configured in previous installations.
57
82
58
83
If you want to perform changes to your configuration or are unsure what steps are available, you can safely run `openproject reconfigure` to walk through the entire configuration process again.
We released [OpenProject 12.0.6](https://community.openproject.com/versions/1504).
14
+
The release contains several bug fixes and we recommend updating to the newest version.
15
+
16
+
<!--more-->
17
+
#### Bug fixes and changes
18
+
19
+
- Fixed: Notification center empty state showing during loading \[[#39828](https://community.openproject.com/wp/39828)\]
20
+
- Fixed: Notification images are cached for years without invalidation means - old images shown \[[#40143](https://community.openproject.com/wp/40143)\]
21
+
- Fixed: Memory leak in work package split screen \[[#40164](https://community.openproject.com/wp/40164)\]
22
+
- Fixed: Check and update the notifications API documentation \[[#40196](https://community.openproject.com/wp/40196)\]
23
+
- Fixed: 429 OK Error on Administration > Users \[[#40213](https://community.openproject.com/wp/40213)\]
24
+
- Fixed: Disable send_notifications on instantiating new project from template \[[#40348](https://community.openproject.com/wp/40348)\]
25
+
- Fixed: Frontend including editor and time logging unusable when there are many activities \[[#40373](https://community.openproject.com/wp/40373)\]
26
+
- Fixed: no "Example" for Host name in "Administration->General" \[[#40396](https://community.openproject.com/wp/40396)\]
0 commit comments