Note
Building SIMP from a pre-built tar file is preferred over other methods. It is the fastest method for getting a known stable build of a SIMP ISO.
Warning
You must be on the SAME operating system that you wish to build. For instance, to build a CentOS 6 ISO, you need to be on a CentOS 6 system. Likewise, to build a RHEL 7 ISO, you must be on a RHEL 7 system.
This is so that the build scripts can find the proper upstream repositories.
Warning
Please have your environment prepared as specified by :ref:`gsg-environment_preparation` before continuing.
Download the SIMP release tar file, found on our SIMP artifacts repository.
Download the latest tar file according to your needs. If you are not sure what version you need, check the :ref:`faq-simp_version_guide`.
Note
Even though the tar files are labelled as CentOS
, they will work
properly for RHEL
systems as well.
Clone simp-core:
git clone https://github.com/simp/simp-core
Change into the simp-core
directory and make sure you are on the correct
branch for your target SIMP version:
cd simp-core git checkout tags/6.4.0-0 # for SIMP 6.4
Run bundle update
to make sure that all of the build tools and dependencies are
installed and up to date:
bundle update
Copy the pre-built tar file to the DVD_Overlay
directory that corresponds
with the version of base OS you want to build. For instance, if you wanted to
build with CentOS 7,
Note
For building on a RHEL system, you will need to replace the word CentOS
with the word RedHat
in the tar file.
mkdir build/distributions/CentOS/7/x86_64/DVD_Overlay cp </path/to/.tar> build/distributions/CentOS/7/x86_64/DVD_Overlay
By default, the SIMP ISO builds from various Internet repositories. However, if you are on a disconnected system, or building RHEL, you will need to tell the build system how to get to your repositories.
To do this, make sure that you have a copy of the files listed in
build/distributions/<OS>/<Release>/<Arch>/yum_data/packages.yaml
in a
:term:`YUM` repo available to the build operating system.
Then, add properly formatted YUM repository configuration files that point to
the repositories that you wish to use at
build/distributions/<OS>/<Release>/<Arch>/yum_data/repos
in the same way
that you would update files in /etc/yum.repos.d
.
Note
The YUM repository configuration files will be used by the yumdownloader
command on the build host.
Run the build:auto
rake task to create a bootable ISO:
Note
Do not add any whitespace before or after the commas. This is an
artifact of using rake
.
SIMP_BUILD_rm_staging_dir=no SIMP_BUILD_prompt=yes SIMP_ENV_NO_SELINUX_DEPS=yes bundle exec rake build:auto[<directory containing source ISOs>]
Answer ``N`` when asked if you want to overwrite the tar file.
Once the process completes, you should have a bootable SIMP ISO, in:
build/distributions/<OS>/<Release>/<Arch>/SIMP_ISO/