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