Skip to content
This repository was archived by the owner on Sep 27, 2024. It is now read-only.

MacOS X build and dmg guide

Jump to bottom
Wesley Ceraso Prudencio edited this page Jun 19, 2017 · 11 revisions

MacOS X Release Guide

This guide describes guidelines how to create the .dmg image of released SCAP Workbench for modern MacOS X versions.

Main prerequisites

Get build dependencies

You need XCode which will bring build utilities with it. There are several ways to get Qt4, pcre and other libraries required to build the app. I recommend using homebrew - http://brew.sh/ - it's messy but quick and simple.

brew install qt4
brew install cmake
brew install ...  # we need to figure out what we need to install here

If you already have those installed run brew update to get the latest versions.

  1. Install OpenSCAP from master

In this step we will install OpenSCAP. Currently we have to use master branch to have OSX support. Master branch could be sometimes broken, maybe you need to fix it. Make sure you merge all the branches up to get all the latest fixes!

$ git clone --depth 1 https://github.com/OpenSCAP/openscap.git -b master
$ cd openscap
$ ./autogen.sh ; \
	./configure --disable-probes --disable-python --disable-util-oscap-docker; \
	make -j 4
# make install
  1. Get latest SSG

SSG is part of SCAP Workbench .dmg package. Again, don't forget to replace link to the latest release! We will unpack it and move to the Workbench build directory.

$ cd /tmp
$ wget https://github.com/OpenSCAP/scap-security-guide/releases/download/v0.1.31/scap-security-guide-0.1.31.zip -O ssg.zip
$ unzip ssg.zip

Or use curl if wget is not available

$ curl -L https://github.com/OpenSCAP/scap-security-guide/releases/download/v0.1.31/scap-security-guide-0.1.31.zip -o ssg.zip

You will need to move the contents to the created dmg image in the next step.

  1. Compile SCAP Workbench

Now we will build latest SCAP Workbench. Don't forget to replace link to the latest release tarball. Use the release tarball and NOT the automatic github tag archive!

$ cd /tmp
$ wget https://github.com/OpenSCAP/scap-workbench/releases/download/1.1.4/scap-workbench-1.1.4.tar.bz2 -O workbench.tar.bz2
$ tar -xzf workbench.tar.bz2; mv scap-workbench* /tmp/scap-workbench
$ cd scap-workbench
$ ./build-for-osx.sh
# follow instructions, use the previously downloaded SSG ZIP

Or use curl if wget is not available

$ curl -L https://github.com/OpenSCAP/scap-workbench/releases/download/1.1.4/scap-workbench-1.1.4.tar.bz2 -o workbench.tar.bz2
  1. Check files

Mount the image and try running SCAP Workbench with and without installing it into Applications. When mounted, there should appear some instruction to install the scap-workbench. In case the application starts right away you should execute ./build-for-osx.sh again.

  1. Upload the .dmg image to github release
  1. IMPORTANT Change the www.open-scap.org download link

Go to https://www.open-scap.org/wp-admin/tools.php?page=redirection.php Look for /tools/scap-workbench/download-osx and make sure it points to the uploaded DMG.

Clone this wiki locally