Page Comparison

...

Table of Contents
absoluteUrl true exclude ^$

SIMP Version Matrix

Prerequisites

...

Complete installation media for your chosen distribution

• If there is more than one disc, you will need all of them

Make sure the following packages are installed and up to date:

...

git

...

createrepo

...

rpm-sign   # Not necessary on EL6/EL7

...

gnupg      # "gnupg2" on EL6/EL7

...

Your user must be in mock group

60G of space in /var/lib/mock

• The gpg executable must be in the user's path (Fedora package: gnupg, EL package: gnupg2)

  Info
  title Repoclosure Issues
  Presently, there are issues with EPEL expiring packages in our packages.yaml files on the fly. The most recent of these is that python-six was pulled from EPEL and included directly in CentOS 6.7. While this is awesome, it makes getting a consistent build made difficult and we're looking into this issue. If all else fails, add the remote CentOS repos to the build/yum_data/<target_version>/repos directory, then erase the offending RPMs from packages.yaml, to work around this for now.

1. Make sure you are a normal user and not root!

2. Clone the master repository and enter it

   Code Block
   language bash
   $ git clone https://github.com/simp/simp-core $ cd simp-core

3. Check which branches are available

   Code Block
   $ git branch -a

4. Switch to the branch appropriate for the ISO you are building. In this example, we are building for CentOS 6.7, so we run

   Code Block
   language bash
   $ git checkout 4.2.X

5. Install the needed gems as described in the Gemfile 

   Code Block
   language bash
   $ gem install bundler $ bundle

The Easy Method

This method uses a pre-existing tarball to build the SIMP ISO and is the fastest way to get started.

1. Head over to the BinTray repository and find the version of SIMP that you wish to build.

2. Create the DVD_Overlay directory

   Code Block
   language bash
   $ mkdir -p build/DVD_Overlay

3. Download the version that you want into the DVD_Overlay directory

   Code Block
   language bash
   $ cd build/DVD_Overlay $ curl -LO https://bintray.com/artifact/download/simp/Releases/SIMP-DVD-CentOS-4.2.0-RC1.tar.gz $ cd -

You can now proceed to Building the ISO.

Build the ISO

This example is based around using CentOS 6.7.

1. cd into simp-core

2. Download all of the required packages for the build:

   Code Block
   language bash
   $ rake build:yum:sync[<CentOS or RHEL>,<os_version>]   # Example: rake build:yum:sync[CentOS,6.7] # Note: Use 7.0 for CentOS 7

    

   1. If you have previously downloaded packages from yum, you may need to run 

      Code Block
      language bash
      $ rake build:yum:clean_cache

3. Optionally, you may drop in custom packages you wish to have available during an install into build/yum_data/SIMP<simp_version>_<CentOS or RHEL><os_version>_<architecture>/packages

4. Take your favorite RHEL or CentOS ISOs and place them in some directory somewhere with enough space to hold 3 copies.
   

   Code Block
   language bash title CentOS ISO Retrieval Example
   $ mkdir /tmp/CentOS_Build $ cd /tmp/CentOS_Build $ curl -LO http://mirror.vtti.vt.edu/centos/6.7/isos/x86_64/CentOS-6.7-x86_64-bin-DVD1.iso $ curl -LO http://mirror.vtti.vt.edu/centos/6.7/isos/x86_64/CentOS-6.7-x86_64-bin-DVD2.iso

5. Unpack the ISOs

   Code Block
   language bash
   $ mkdir orig $ cd orig $ BUNDLE_GEMFILE=/path/to/simp-core/Gemfile rake -f /path/to/simp-core/Rakefile unpack["/path/to/ISO/CentOS-6.7-x86_64-bin-DVD1.iso"] $ BUNDLE_GEMFILE=/path/to/simp-core/Gemfile rake -f /path/to/simp-core/Rakefile unpack["/path/to/ISO/CentOS-6.7-x86_64-bin-DVD2.iso"]

6. Make a new directory for your custom ISO build and copy the contents of the extracted ISOs
   

   Code Block
   language bash
   $ cd .. $ mkdir 4.2.X $ cd 4.2.X $ cp -rl ../orig/CentOS6.7-x86_64 .

7. And finally, build the ISO:

   Code Block
   language bash
   $ BUNDLE_GEMFILE=/path/to/simp-core/Gemfile rake -f /path/to/simp-core/Rakefile iso:build["/path/to/simp-core/build/DVD_Overlay/SIMP-DVD-CentOS-4.2.0-RC1.tar.gz"]

...

This documentation has moved to ReadTheDocs.

Please ask questions on the SIMP Project slack or Google Group.