22.214.171.124.2. Building SIMP From Tarball¶
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.
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.
126.96.36.199.2.1. Getting Started¶
Please have your environment prepared as specified by 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 SIMP Version Guide.
Even though the tar files are labelled as
CentOS, they will work
RHEL systems as well.
188.8.131.52.2.2. Generating The ISO¶
184.108.40.206.2.2.1. Clone the Repo¶
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.5
220.127.116.11.2.2.2. Update your Dependencies¶
bundle update to make sure that all of the build tools and dependencies are
installed and up to date:
18.104.22.168.2.2.3. Inject the Tar File¶
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,
For building on a RHEL system, you will need to replace the word
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
22.214.171.124.2.2.4. Optional - Update your Source Repositories¶
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
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
The YUM repository configuration files will be used by the
command on the build host.
126.96.36.199.2.2.5. Build the ISO¶
build:auto rake task to create a bootable ISO:
Do not add any whitespace before or after the commas. This is an
artifact of using
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: