Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

Appendix C. Applying Custom Configuration to Red Hat Satellite

When you install and configure Satellite for the first time using satellite-installer, you can specify that the DNS and DHCP configuration files are not to be managed by Puppet using --foreman-proxy-dns-managed=false and --foreman-proxy-dhcp-managed=false. If these options are not specified during the initial installer run, any manual changes will be overwritten by a rerun of the installer, for example, rerun for upgrade purposes. If changes are overwritten, you will need to run the restore procedure to restore the manual changes. See Section C.1, “How to restore manual changes overwritten by a Puppet run” for more information.

The installer does not have an option for all configuration files that you may want to manage manually. To specify Satellite configuration values which will not be overwritten by the installer, add entries to the configuration file /etc/foreman-installer/custom-hiera.yaml. This configuration file is in YAML format, consisting of one entry per line in the format of <puppet class>::<parameter name>: <value>. Configuration values specified in this file will persist across installer reruns.

Common examples include:

  • For Apache, to set the ServerTokens directive to only return the Product name: 

    apache::server_tokens: Prod
    Copy to Clipboard Toggle word wrap

  • To turn off the Apache server signature entirely: 

    apache::server_signature: Off
    Copy to Clipboard Toggle word wrap

  • To turn off TRACE: 

    apache::trace_enable: Off
    Copy to Clipboard Toggle word wrap

  • For Puppet, to enable the future parser: 

    puppet::server_parser: future
    Copy to Clipboard Toggle word wrap

  • For Pulp, to configure the number of pulp workers: 

    pulp::num_workers: 8
    Copy to Clipboard Toggle word wrap

C.1. How to restore manual changes overwritten by a Puppet run
リンクのコピー

If your manual configuration has been overwritten by a Puppet run, you can restore the files to the previous state. The following example shows you how to restore a DHCP configuration file overwritten by a Puppet run.

  1. Copy the file you intend to restore. This allows you to compare the files to check for any mandatory changes required by the upgrade. This is not common for DNS or DHCP services. 

    # cp /etc/dhcp/dhcpd.conf /etc/dhcp/dhcpd.backup
    Copy to Clipboard Toggle word wrap

  2. Check the log files to note down the md5sum of the overwritten file. For example: 

    # journalctl -xe
...
/Stage[main]/Dhcp/File[/etc/dhcp/dhcpd.conf]: Filebucketed /etc/dhcp/dhcpd.conf to puppet with sum 622d9820b8e764ab124367c68f5fa3a1
...
    Copy to Clipboard Toggle word wrap

  3. Restore the overwritten file: 

    # puppet filebucket restore --local --bucket \
/var/lib/puppet/clientbucket /etc/dhcp/dhcpd.conf \ 622d9820b8e764ab124367c68f5fa3a1
    Copy to Clipboard Toggle word wrap
  4. Compare the backup file and the restored file, and edit the restored file to include any mandatory changes required by the upgrade.
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hat