3.4.1.3.2. Building SIMP From Tarball¶
Note
Building SIMP from a pre-built tar file is the fastest method for getting a known stable build of a SIMP ISO and should be preferred over other methods.
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.
3.4.1.3.2.1. Getting Started¶
Warning
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.
Note
Even though the tar files are labelled as CentOS
, they will work
properly for RHEL
systems as well.
3.4.1.3.2.2. Generating The ISO¶
3.4.1.3.2.2.1. Clone the Repo¶
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.2.0-0 # for SIMP 6.2
3.4.1.3.2.2.2. Update your Dependencies¶
Run bundle update
to make sure that all of the build tools and dependencies are
installed and up to date:
$ bundle update
3.4.1.3.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,
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
3.4.1.3.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 /etc/yum.repos.d
.
Note
The YUM repository configuration files will be used by the yumdownloader
command on the build host.
3.4.1.3.2.2.5. Build the ISO¶
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/