Revision e8beec44
Added by Alexis Mousset almost 7 years ago
| 10_installation/05_requirements/05_requirements.txt | ||
|---|---|---|
|
security reasons. It is required that each Node hostname can be resolved to its
|
||
|
IP address that will be used to contact the Rudder Server.
|
||
|
|
||
|
Similarly, each Rudder Node must be able to resolve the Rudder Root Server
|
||
|
hostname given in the step described in <<initial-config>>.
|
||
|
|
||
|
If you can not make every node resolution consistent, it is possible to remove
|
||
|
this constraint by unticking "Use reverse DNS lookups on nodes to reinforce
|
||
|
authentication to policy server:" in the Administration - Settings tab of the
|
||
| 10_installation/10_install_server/11_install_root_server_debian.txt | ||
|---|---|---|
|
|
||
|
=====
|
||
|
|
||
|
Now jump to <<initial-config,the next section to configure your server>>.
|
||
|
include::snippets/initial_config.txt.snippet[]
|
||
|
|
||
| 10_installation/10_install_server/12_install_root_server_sles.txt | ||
|---|---|---|
|
|
||
|
====
|
||
|
|
||
|
Now jump to <<initial-config,the next section to configure your server>>.
|
||
|
include::snippets/initial_config.txt.snippet[]
|
||
|
|
||
|
|
||
| 10_installation/10_install_server/13_install_root_server_centos_rhel.txt | ||
|---|---|---|
|
|
||
|
====
|
||
|
|
||
|
Now jump to <<initial-config,the next section to configure your server>>.
|
||
|
include::snippets/initial_config.txt.snippet[]
|
||
|
|
||
|
|
||
| 10_installation/10_install_server/17_initial_config.txt | ||
|---|---|---|
|
[[initial-config, Initial configuration of your Rudder Root Server]]
|
||
|
==== Initial configuration of your Rudder Root Server
|
||
|
|
||
|
After the installation, you have to configure some system elements, by launching
|
||
|
the following initialisation script:
|
||
|
|
||
|
----
|
||
|
|
||
|
/opt/rudder/bin/rudder-init
|
||
|
|
||
|
----
|
||
|
|
||
|
This script will ask you to fill in the following details:
|
||
|
|
||
|
=====
|
||
|
|
||
|
Allowed networks:: A list of IP networks authorized to connect to the server.
|
||
|
It uses the network/CIDR mask notation, for instance +192.168.0.0/24+ or
|
||
|
+10.0.0.0/8+.
|
||
|
To add several networks, first type the first network, then press
|
||
|
the return key - the script will ask if you wish to add some more networks.
|
||
|
Also, the allowed networks can be adjusted later in the web interface
|
||
|
in the Administration - Settings tab without having to run the script
|
||
|
again.
|
||
|
|
||
|
=====
|
||
|
|
||
|
[TIP]
|
||
|
|
||
|
=====
|
||
|
|
||
|
In case of typing error, or if you wish to reconfigure Rudder, you can
|
||
|
execute this script again as many times as you want.
|
||
|
|
||
|
=====
|
||
|
|
||
| 10_installation/10_install_server/19_validation.txt | ||
|---|---|---|
|
==== Validate the installation
|
||
|
|
||
|
Once all these steps have been completed, use your web browser to go to the URL
|
||
|
given on the step described in <<initial-config, the section about initial configuration>>.
|
||
|
|
||
|
You should see a loading screen, then a login prompt. The default login is "admin" with
|
||
|
password "admin", authenticating you in the Rudder web interface with full administrative privileges.
|
||
|
|
||
|
The setup of the Rudder server is now over. If you plan to manage hundreds or thousands of Nodes,
|
||
|
please note that some <<_performance_tuning, performance tuning>> can be necessary on the system.
|
||
|
|
||
| 10_installation/10_install_server/snippets/initial_config.txt.snippet | ||
|---|---|---|
|
==== Initial configuration of your Rudder Root Server
|
||
|
|
||
|
After the installation, you have to configure some system elements, by launching
|
||
|
the following initialisation script:
|
||
|
|
||
|
----
|
||
|
|
||
|
/opt/rudder/bin/rudder-init
|
||
|
|
||
|
----
|
||
|
|
||
|
This script will ask you to fill in the following details:
|
||
|
|
||
|
=====
|
||
|
|
||
|
Allowed networks:: A list of IP networks authorized to connect to the server.
|
||
|
It uses the network/CIDR mask notation, for instance +192.168.0.0/24+ or
|
||
|
+10.0.0.0/8+.
|
||
|
To add several networks, first type the first network, then press
|
||
|
the return key - the script will ask if you wish to add some more networks.
|
||
|
Also, the allowed networks can be adjusted later in the web interface
|
||
|
in the Administration - Settings tab without having to run the script
|
||
|
again.
|
||
|
|
||
|
=====
|
||
|
|
||
|
[TIP]
|
||
|
|
||
|
=====
|
||
|
|
||
|
In case of typing error, or if you wish to reconfigure Rudder, you can
|
||
|
execute this script again as many times as you want.
|
||
|
|
||
|
=====
|
||
|
|
||
|
==== Validate the installation
|
||
|
|
||
|
Once all these steps have been completed, use your web browser to go to the URL
|
||
|
given in the output of `rudder-init`.
|
||
|
|
||
|
You should see a loading screen, then a login prompt. The default login is "admin" with
|
||
|
password "admin", authenticating you in the Rudder web interface with full administrative privileges.
|
||
|
You are strongly advised to <<_passwords, change this password>> as soon as possible.
|
||
|
|
||
|
The setup of the Rudder server is now over. If you plan to manage hundreds or thousands of Nodes,
|
||
|
please note that some <<_performance_tuning, performance tuning>> can be necessary on the system.
|
||
|
|
||
Also available in: Unified diff
Fixes #10624: Rudder installation docs are misleading as to running rudder-init