28.4. Installing Image Builder
- The virtual machine for Image Builder must be already installed, meet the requirements, be subscribed, and be running.
- The system with repository mirrors must be accessible on network.
- The Image Builder system must use the same version of Red Hat Enterprise Linux as the system containing repository mirrors.
- You must be connected to the virtual machine and run all the commands there.
- The repository
RHEL-7-Extrasmust be enabled on the system.
- Install the Image Builder packages:
yum install lorax-composer composer-cli cockpit-composer
NoteIf web console is not installed yet, it is implicitly installed as a dependency of the cockpit-composer package.
- List the repositories enabled on this machine and note their identifiers:
- Create a repository configuration file in the
/etc/yum.repos.ddirectory which points to the mirrored repositories. Include the IP address or host name of the virtual machine system. For each of the repository mirrors, run:
cat >> /etc/yum.repos.d/mirror.repo <<EOF[mirror-REPO-ID] name=NAME baseurl=http://IP-ADDR/cdrom/ enabled=1 gpgcheck=1 gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-redhat-release EOFReplace REPO-ID with the repository identifier, NAME with the repository name, and IP-ADDR with the IP address or host name. This will present the repository mirrors to the system with an identifier containing the prefix mirror-.
- Verify the repository configuration:
yum clean all#
- Disable the original subscribed repositories from Red Hat content delivery network. For each of the mirrored repositories, run:
yum-config-manager --disable REPO-IDReplace REPO-ID with the repository identifier.
- Enable Image Builder to start after each reboot and configure the system firewall:
systemctl enable lorax-composer.socket#
systemctl enable cockpit.socket#
firewall-cmd --add-service=cockpit && firewall-cmd --add-service=cockpit --permanent
- The Image Builder and web console services are started automatically on each system reboot. For this first session after installation, start these services manually:
systemctl start lorax-composer
# systemctl start cockpit