Project

General

Profile

Actions
Copy link

Bug #10624

closed

Rudder installation docs are misleading as to running rudder-init

Added by Jonathan CLARKE over 7 years ago. Updated over 7 years ago.

Status:
Released
Priority:
N/A
Assignee:
Nicolas CHARLES
Category:
Documentation
Target version:
3.1.20
Pull Request:
https://github.com/Normation/rudder-d...
Severity:
Critical - prevents main use of Rudder | no workaround | data loss | security
UX impact:
User visibility:
Getting started - demo | first install | level 1 Techniques
Effort required:
Small
Priority:
86
Name check:
Fix check:
Regression:

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.

Actions
Copy link

Also available in: Atom PDF