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
Watson Yuuma Sato edited this page Dec 13, 2016 · 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
  1. Install OpenSCAP from master

In this step we will install OpenSCAP. Currently we have to use master branch to have Windows support. Master branch could be sometimes broken, maybe you need to fix it.

$ 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.3/scap-workbench-1.1.3.tar.bz2 -O workbench.tar.bz2
$ tar -xzbf 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.3/scap-workbench-1.1.3.tar.bz2 -o workbench.tar.bz2
  1. Check files

Mount the image and try running SCAP Workbench with and without installing it into Applications.

  1. Upload the .dmg image to github release
  1. 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