Project

General

Profile

Bug #10624

Rudder installation docs are misleading as to running rudder-init

Added by Jonathan CLARKE 7 months ago. Updated 6 months ago.

Status:
Released
Priority:
N/A
Category:
Documentation
Target version:
Target version (plugin):
Severity:
Critical - prevents main use of Rudder | no workaround | data loss | security
User visibility:
Getting started - demo | first install | level 1 Techniques
Effort required:
Small
Priority:
86

Description

The current docs for a single platform, for example http://www.rudder-project.org/doc-4.1/_install_rudder_server.html#_install_rudder_root_server_on_debian_or_ubuntu, don't make it clear enought that one must run "rudder-init" at the end of the installation process.

I have myself been hit by this recently, and seen several users installing Rudder without success because that small final step was missing. This is made (much) worse by #10567.

We must clarify this in the docs ASAP. Let's just duplicate the content of http://www.rudder-project.org/doc-4.1/_install_rudder_server.html#initial-config if that's what it takes.

Associated revisions

Revision e8beec44
Added by Alexis MOUSSET 7 months ago

Fixes #10624: Rudder installation docs are misleading as to running rudder-init

History

#1 Updated by Jonathan CLARKE 7 months ago

  • Priority changed from 0 to 86

#2 Updated by Alexis MOUSSET 7 months ago

  • Status changed from New to In progress

#3 Updated by Alexis MOUSSET 7 months ago

  • Status changed from In progress to Pending technical review
  • Assignee changed from Alexis MOUSSET to Nicolas CHARLES
  • Pull Request set to https://github.com/Normation/rudder-doc/pull/308

#4 Updated by Alexis MOUSSET 7 months ago

  • Target version changed from 4.1.2 to 3.1.20

#5 Updated by Alexis MOUSSET 7 months ago

  • Pull Request changed from https://github.com/Normation/rudder-doc/pull/308 to https://github.com/Normation/rudder-doc/pull/309

#6 Updated by Alexis MOUSSET 7 months ago

  • Status changed from Pending technical review to Pending release

#7 Updated by Vincent MEMBRÉ 6 months ago

  • Status changed from Pending release to Released

This bug has been fixed in Rudder 3.1.20, 4.0.5 and 4.1.2 which were released today.

Also available in: Atom PDF