OpenHAB
/
openhab-docs
mirror of https://github.com/openhab/openhab-docs.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Automated openhabian Docs fetch (#1966) 

Co-authored-by: openHAB Bot <info@openhab.org>
final-3.3.x
github-actions[bot] 2022-12-19 07:25:00 +01:00 committed by GitHub
parent b203f9c7c1
commit 1f87449bfc
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 9 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
installation/openhabian-DEBUG.md
View File

@ -62,9 +62,9 @@ You can change it at any time to get output on future boot runs or if you use `o
_At this stage, read the first paragraph on the logfile and interactive use again._
To see debug output during the image installation process, you need to use the procedure from your PC **before** you power your box on.
If you have a console available (monitor and keyboard), attach it to follow the install process.
If you have a console available (monitor and keyboard), you may attach it to follow the install process **but** be aware that attaching a keyboard may cause the installation to fail.
Now insert the SD card and turn on your system.
If you don't have any console, try to access the web console at `http://<yourhostip>:80/`.
If you don't have any console, access the web console at `http://<yourhostip>:80/`.
It will display the contents of `/boot/first-log.boot` at intervals of some seconds while installing.
Mind you that if installation fails, network access may or may not be possible so you might need to access the box via console anyway in order to find out what went wrong.

4
installation/openhabian-amanda.md
View File

@ -94,7 +94,7 @@ Read and understand the Amanda docs.
Use your personal user instead (that you have created at the beginning of your openHABian installation or `openhabian` by default).
Installation tasks including post-package-installation changes (edits) of the Amanda config files, require to use the `root` user.
Any ordinary user (such as your personal one) can execute commands on behalf of root (and with root permission) by prepending `sudo` to the command.
As yourself, prepend "sudo -u backup" to execute the following commands as the "backup" user.
As yourself, prepend `sudo -u backup` to execute the following commands as the "backup" user.
# Installation
@ -219,7 +219,7 @@ root@pi:/home/pi#
## Software installation
First, mount/prepare your storage (see examples).
Next, double check that your `backup` user has write access to all of the storage area (preferrably, he `owns` the directory): _Create_ a file there (`touch /path/to/storage/file`), check its ownership (`ls -l /path/to/storage/file`), then delete it
Next, double check that your `backup` user has write access to all of the storage area (preferrably, he **owns** the directory): _Create_ a file there (`touch /path/to/storage/file`), check its ownership (`ls -l /path/to/storage/file`), then delete it
(`rm /path/to/storage/file`).
If that does not work as expected (to produce a file that is owned by the `backup` user), you need to change export options on your NAS/NFS server.
See also [paragraph on `no_root_squash`](#storage-preparation) above.

10
installation/openhabian.md
View File

@ -14,7 +14,7 @@ You may jump to [install instructions](#raspberry-pi-prepackaged-sd-card-image)
:::
# openHABian - Hassle-free openHAB Setup
``
The Raspberry Pi is quite a famous platform for openHAB.
However, setting up a fully working Linux system with all recommended packages and openHAB recommendations is a **boring task**, takes a lot of time and **Linux newcomers** are challenged in a number of ways although all they want is to run openHAB and not some server.
@ -149,13 +149,13 @@ These are what we develop and test openHABian against.
We provide code that is reported "as-is" to run on Ubuntu but we do **not support Ubuntu** so please don't open issues for this (PRs then again are welcome).
Several optional components such as WireGuard or Homegear are known to expose problems on Ubuntu.
We expect you to use the current stable distribution 'bullseye' for Debian (x86). The Raspberry Pi image is based on this, too.
We expect you to use the current stable distribution 'bullseye' for Debian (x86). The current Raspberry Pi image is based on this, too.
To install openHABian on anything older or newer may work or not.
If you do and encounter issues, you may need to upgrade first or to live with the consequences of running an OS on the edge of software development.
### 64 bit?
RPi 3 and 4 have a 64 bit processor and you may want to run openHAB in 64 bit.
Be aware that running in 64 bit has a major drawback: increased memory usage.
Be aware that running in 64 bit has no relevant advantages but a major drawback: increased memory usage.
That is not a good idea on a heavily memory constrained platform like a RPi.
On x86 hardware, 64 bit is the standard.
@ -347,7 +347,7 @@ openHABian has a number of features built in to enhance resilience:
WARNING 2: USB sticks are as susceptible to flash wear-out as SD cards are, making zram the better choice for a standard Pi to run off its internal SD card.
4. Use the openHAB integrated [openhab-cli tool](https://community.openhab.org/t/recommended-way-to-backup-restore-oh2-configurations-and-things/7193/82) to interactively
4. Use the integrated original openHAB [openhab-cli tool](https://community.openhab.org/t/recommended-way-to-backup-restore-oh2-configurations-and-things/7193/82) to interactively
backup/restore your openHAB **config** \[menu option 50/51\].
5. Use [Amanda Network Backup](http://www.amanda.org/) for full system backups, documentation [here](openhabian-amanda.md).
See \[menu option 52\].
@ -382,7 +382,7 @@ Mind the comments for each configuration parameter. Browse the next documentatio
#### Initial configuration
You can have openHABian import a working openHAB configuration right from the start at installation time like when you migrate or reinstall:
make the `initialconfig` parameter point to either a file or URL.
Note that you can only place config zipfiles on the 1st (Windows) partition, and that partition will finally be accessible as `/boot`.
Note that you can only place config zipfiles on the 1st (Windows) partition, and that partition will finally be accessible as `/boot` from inside Linux.
So a filename would need to be `/boot/xxx.zip`. Default is `/boot/initial.zip`.
So if you have a openHAB configuration backup zipfile (created e.g. by using menu option 50), put it to the E: device that the first partition of your SD card shows up as on a Windows PC and change its name to 'initial.zip'.