[jira] [Created] (IGNITE-18218) Cluster initialization should be covered in docs better

["Andrey Khitrin (Jira)" <ji...@apache.org>]

Andrey Khitrin created IGNITE-18218:
---------------------------------------

             Summary: Cluster initialization should be covered in docs better
                 Key: IGNITE-18218
                 URL: https://issues.apache.org/jira/browse/IGNITE-18218
             Project: Ignite
          Issue Type: Improvement
          Components: documentation
    Affects Versions: 3.0.0-beta1
            Reporter: Andrey Khitrin


While playing with AI3 beta1 deb package, I've noticed that 'ignite3db' service doesn't join any cluster after being installed and started. That may be fine from the DB's point of view, but this behavior may not obvious for a mere user. In order to make AI3 ready to work, user needs to run 'ignite3 cluster init ...' first. Unfortunately, this point is not currently covered properly neither in [DEVNOTES.md|https://github.com/apache/ignite-3/blob/main/DEVNOTES.md] nor in [existing docs|https://ignite.apache.org/docs/3.0.0-beta/quick-start/getting-started-guide]. Command 'systemctl status ignite3db.service' says "active (running)", command 'ignite3 node status' shows "state: starting", DB log says "Components started, joining the cluster".  Everything seem to work fine, but the next user's step is not obvious here. User may try to open SQL console but it will not work until cluster is initialized.
I'm afraid a significant part of newcomers may be discouraged by this behavior. They could be a step close to the final line, but think "it doesn't work with no reason", and refuse to try AI3 anymore. To avoid this, some words about "cluster init" should be added to "Getting started guide" and, probably, to DEVNOTES.



--
This message was sent by Atlassian Jira
(v8.20.10#820010)