Skip to content

Commit

Permalink
Add hint that /etc/default/openhab2 is not considered by the upgrade (o…
Browse files Browse the repository at this point in the history
…penhab#1461)

* Add hint that /etc/default/openhab2 is not considered by the upgrade 

When you use a raspberry you may have used the file /etc/default/openhab2 to changed JAVA options.
After upgrade to openHAB 3.0 this file is no longer used. Instead the file /etc/default/openhab must be used.

* Small modifications to original pull request.

Signed-off-by: Jerome Luckenbach <github@luckenba.ch>

Co-authored-by: Jerome Luckenbach <github@luckenba.ch>
  • Loading branch information
BertramVielsack and Confectrician authored Jan 20, 2021
1 parent 6bf5bf0 commit 3a54d1f
Showing 1 changed file with 7 additions and 2 deletions.
9 changes: 7 additions & 2 deletions configuration/migration/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,13 +30,18 @@ If you are working with an [openHABian](https://www.openhab.org/docs/installatio

### Package-based Installations

Since the openHAB 2 Linux `openhab2*` packages used folder names like `/etc/openhab2` we used this opportunity to remove the version out of anything the packages provides, including the name of the package itself. Some files such as `openhab-cli` didn't use any version in the naming at all, and therefore haven't moved anywhere.
Since the openHAB 2 Linux `openhab2*` packages used folder names like `/etc/openhab2` we used this opportunity to remove the version out of anything the packages provides, including the name of the package itself.
Some files such as `openhab-cli` didn't use any version in the naming at all, and therefore haven't moved anywhere.

Unfortunately, it means that in terms of openHAB 2 and openHAB 3, you cannot install both at the same time and openHAB 2 will not automatically update to openHAB 3, but if you use the commands to install openHAB 3 whilst openHAB 2 is installed, then the configs will copy across automatically.
Please be aware that system configuration done for openHAB 2 is not copied across automatically.
E.g. if you have changed /etc/default/openhab2, similar changes in /etc/default/openhab might be required.

#### Backup first

If you've got an existing openHAB 2 installation, back it up before you do anything. `openhab-cli backup [filepath]/[filename].zip` will create a zip file which can be used to restore the same version of openHAB later using `openhab-cli restore [filepath]/[filename].zip`. Put the file somewhere not related to openHAB, such as your own home directory (e.g. `/home/pi/`). You should probably do your usual OS backup too to make sure you can get back to where you left off.
If you've got an existing openHAB 2 installation, back it up before you do anything. `openhab-cli backup [filepath]/[filename].zip` will create a zip file which can be used to restore the same version of openHAB later using `openhab-cli restore [filepath]/[filename].zip`.
Put the file somewhere not related to openHAB, such as your own home directory (e.g. `/home/pi/`).
You should probably do your usual OS backup too to make sure you can get back to where you left off.

#### Prerequisites

Expand Down

0 comments on commit 3a54d1f

Please sign in to comment.