983214f253
- Always run in the foreground - Always log to stdout/err (unless syslog is requested) - Update systemd to reload with a direct signal - Omit any pidfile for "warewulfd" Signed-off-by: Jonathon Anderson <janderson@ciq.com>
51 lines
1.8 KiB
ReStructuredText
51 lines
1.8 KiB
ReStructuredText
=======================
|
|
Warewulf Initialization
|
|
=======================
|
|
|
|
System Services
|
|
===============
|
|
|
|
Once Warewulf has been installed and configured, it is ready to be
|
|
initialized and have the associated system services started. To do
|
|
this, start by configuring the system services that Warewulf depends
|
|
on for operation. To do that, run the following command:
|
|
|
|
.. code-block:: console
|
|
|
|
# wwctl configure --all
|
|
|
|
This command will configure the system for Warewulf to run
|
|
properly. Here are the things it will do:
|
|
|
|
* **dhcp**: (re)Write the DHCP configuration and restart the service
|
|
from the **host** template under ``/etc/dhcpd.conf.ww`` and enable
|
|
the system service.
|
|
* **hostfile**: Update the system's /etc/hosts file based on the
|
|
**host** template ``/etc/hosts.ww``.
|
|
* **nfs**: Configure the NFS server on the control node based on the
|
|
configuration in ``/etc/warewulf/warewulf.conf`` and enable the NFS
|
|
service. Also the file ``/etc/exports.ww`` from the **host** template is
|
|
installed.
|
|
* **ssh**: Create the appropriate host keys (stored in
|
|
``/etc/warewulf/keys/``) and user keys for passwordless ``ssh`` into
|
|
the nodes. Addionally the shell profiles
|
|
``/etc/profile.d/ssh_setup.csh`` and ``/etc/profile.d/ssh_setup.sh``
|
|
are installed.
|
|
* **tftp**: Write the appropriate binary PXE/iPXE blobs to the TFTP
|
|
root directory and enable the system service.
|
|
|
|
This command will quickly setup the system services per the Warewulf
|
|
configuration. Watch this output carefully for errors and resolve them
|
|
in the configuration portion of this manual.
|
|
|
|
Warewulf Service
|
|
================
|
|
|
|
The Warewulf installation attempts to register the Warewulf service
|
|
with systemd, so it should be as easy to start/stop/check as any other
|
|
systemd service:
|
|
|
|
.. code-block:: console
|
|
|
|
# systemctl enable --now warewulfd
|