Getting Started with OH3: rewriting the tutorial - 1. Introduction

[wborn (Wouter Born)]

@Bruce_Osborne

Great! I deleted the binding & it worked as expect

It should now also no longer cause issues in future builds since the ZWave feature has been disabled.

[matt1 (Skinah)]

@rlkoshak
Can you unlock the other topics as well please? I’ll proof read and edit as I try out V3 over the next week, also it is confusing that some are in this area of the forum, and some more in another, could they be moved and made a sticky? thanks…

Getting Started with OH3: rewriting the tutorial - 2. First steps

This Wiki topic’s goal is to serve as a working document, in order to provide an up-to-date tutorial for OH3 aimed at new users and novices. Everyone is welcome and encouraged to edit it, when we’re satisfied it will make its way to the official docs. You may reply for the specific purpose of improving the article are allowed, but please, this is NOT a support thread: if you’re stuck while reading this and are simply seeking support please open another thread. Thanks! This tutorial has transit…

Building Pages in the OH3 UI: documentation draft (1/3)

UPDATE: The most current information on this topic is now available at: User Interface Design Overview | openHAB. The following is kept for archival purposes only! TOC: I. Pages basics (this topic) Concepts: UI components, pages & widgets Sitemaps Types of pages Page editors, creating a page & adding widgets II. Editing pages & widgets: general information Configuring widgets The system & standard libraries, default widgets (standalone, list items & cells), adding widgets from the model W…

[rlkoshak (Rich Koshak)]

I can unlock but I don’t think I have the power to make it sticky. I think that requires an admin. The rest I can do.

[Andreas_Schultz]

Is there a guide on how to setup model with the file based approach? So far it seems that the model can only be edited through the WebUI or by directly modifying the JSON DB files.

[Bruce_Osborne]

Most all the model pieces appear to be Groups. I would try making one or 2 & use API Explorer to determine what might work in files. I think the new parts are all tags anyway.

[ysc (Yannick Schaus)]

@Andreas_Schultz

Is there a guide on how to setup model with the file based approach? So far it seems that the model can only be edited through the WebUI or by directly modifying the JSON DB files.

See here, there are examples of models built with textual configuration, you just have to tag them properly:

HABot Walkthrough (2/n): Semantic Tagging & Item Resolving

This is a wiki topic, regular members as well as staff may edit it freely and are encouraged to do so! The content will eventually be migrated somewhere in the main documentation when it’s stabilized and enough feedback has been received. When replying to posts on this series, please try to stay on-topic - there will be several of them, each covering a particular feature or area, so please look for the appropriate topic and reply there, or create a new topic. Thanks! When using …

[mstormi (Markus Storm)]

Reviewing the available OH3 docs I came across this and seems #6, #7 and #8 are still missing or was it just me to miss them ? There’s a #9 though.
Added one or two missing links to the table of contents.

[ysc (Yannick Schaus)]

I just have to draft them, probably in the coming days…

[Bruce_Osborne]

@ysc

I just have to draft them

#6 is here.

Getting Started with OH3: rewriting the tutorial - 6. Model your home with Items & link Channels

This Wiki topic’s goal is to serve as a working document, in order to provide an up-to-date tutorial for OH3 aimed at new users and novices. Everyone is welcome and encouraged to edit it, when we’re satisfied it will make its way to the official docs. You may reply for the specific purpose of improving the article are allowed, but please, this is NOT a support thread: if you’re stuck while reading this and are simply seeking support please open another thread. Thanks! This page has been transi…

[mstormi (Markus Storm)]

@Bruce_Osborne

#6 is here

I was referring to #6,7,8 of the list in post #1
OH cloud, persistence and an overall summary, these are.

[Bruce_Osborne]

Hmmm OK.
Perhaps a section is missing from post 1.

[rlkoshak (Rich Koshak)]

EDIT:

I made a pass at making the wording sound more like an introduction and less like a plan of what we plan to write. I updated links where they were missing and marked sections that are not yet written as [TBD].

I propose moving persistence before Pages so that when we discuss pages we can assume they have persistence set up when we talk about Chart pages and the analyze buttons and such. I didn’t want to do that unilaterally though.

Let me know if I missed a link anywhere.

I’m also going to add forward/back links to the bottom of each page so it’s easier to read them like they will be in the docs.

Added a few sentences to use the code tab and post the YAML when asking for help on the forum.

[lampy (Gerwin)]

I’ve started with following the docs and building my OH3 server for learning and testing it a bit before really diving in all the way.
This section is clear, only one question. In the section File-based vs UI-driven configuration first the file based is mentioned.
When I have no clue to choose (especially new users), I would pick the first one. But likely the best option for a new user would be the UI based option.
Or is it just me with that strange behavior?

[rlkoshak (Rich Koshak)]

@lampy

When I have no clue to choose (especially new users), I would pick the first one. But likely the best option for a new user would be the UI based option.

We present the pros and the cons for both approaches. we then state that this good l guide isn’t going to present the text based approach (I. e. the user will have to look at the docs on their own). That seems pretty clear to me.

The text based configs are acknowledged so those users who are drawn to then can choose that approach. But those users will have to do so without the benefit of this tutorial. Only developers (who can figure it out from the reference docs without too much trouble) and existing OH 2 users (who already know how to use text based configs) are likely to go down that path.

We won’t code for you though. All we can do is present the pros and cons, which we’ve done. But if you have any suggestions for edits, the post is a wiki so have at it. It’s a group effort.

[edolis]

A practical note from an absolute beginner: It would be useful linking the active page of the installation procedure when mentioned in

This tutorial assumes users have read the concepts and installation guide already

It would be also useful to explain, besides the installation procedure, the one to make a complete uninstallation. Migrating from a tentative installation from 2 to 3, I’d like to be sure I get a full rollback to a clean state. Currently uninstalling OH2 service and deleting the openHAB2 folder - not sure if that’s a rough approach leaving some zombie stuff around- would be nice having a page just saying doing that works fine

tagging @rlkoshak

[mstormi (Markus Storm)]

@edolis

It would be also useful to explain, besides the installation procedure, the one to make a complete uninstallation

That’s easy. Just Read your Mail Really Fast (aka rm -rf /).
But seriously: No. This isn’t relevant for people to start with OH3 in the first place, and out of scope of this tutorial for those who don’t.
Common sense applies: make a system level backup and restore to get back there.

[edolis]

Well, sorry you think it’s useless. It just followed yesterday’s conversation with rloshak where I volunteered to review the doc as an absolute beginner and we agreed it was best done on 3 instead of 2.
not sure about your

rm -rf /

Really obscure for me. Is it a witty remark or is it something which can help? is it a command line command? not clear for an absolute beginner.

@mstormi

Common sense applies: make a system level backup and restore to get back there.

so you suggest I should use a restore point and restore the whole windows environment to do that? Doesn’t sound handy. I have been installing a bunch of apps to start openHAB, it would take a lot of work to roll back and reinstall everything again to get to a clen state from an app of about a couple of hundred megabytes. Uninstalling the whole Visual Studio suite would be way easier, in comparison.
In practice, here you go: I have been trying the last 3 hours.
and the most I have reched so far is this error log at the openhab prompt.

openhab> org.apache.felix.resolver.reason.ReasonException: Unable to resolve root: missing requirement [root] osgi.identity; osgi.identity=openhab-runtime-base; type=karaf.feature; version=“[3.0.0.RC1,3.0.0.RC1]”; filter:=“(&(osgi.identity=openhab-runtime-base)(type=karaf.feature)(version>=3.0.0.RC1)(version<=3.0.0.RC1))” [caused by: Unable to resolve openhab-runtime-base/3.0.0.RC1: missing requirement [openhab-runtime-base/3.0.0.RC1] osgi.identity; osgi.identity=openhab-core-io-rest-sitemap; type=karaf.feature [caused by: Unable to resolve openhab-core-io-rest-sitemap/3.0.0.RC1: missing requirement [openhab-core-io-rest-sitemap/3.0.0.RC1] osgi.identity; osgi.identity=org.openhab.core.io.rest.sitemap; type=osgi.bundle; version=“[3.0.0.RC1,3.0.0.RC1]”; r

and some other tons of error lines. Let’s see how far I can go.
Please don’t say in forum that new users do not want to spend time to contribute to improve documentation. I’m running the second day in trying to set up a working environment and maybe I will soon discover that trying to install 3 is not a good idea at all.

[jensflorian]

@edolis

It would be also useful to explain, besides the installation procedure, the one to make a complete uninstallation.

If you installed it on Windows (as your last comment indicates), I think this still applies to OH3: How do I uninstall OpenHAB2 from a Windows 10 PC

[edolis]

thank you very much. Still wonder why is so hard to add a web page formalizing that and link it to the introduction. Baffling for me.

[Bruce_Osborne]

@edolis

Baffling for me

Java is cross platform and there are many installation methods and many OS/Platforms. Each combination would have a slightly different method for uninstallation. For instance, the commane mentioned earlier would not work on Windows.