Skip to content

Latest commit

 

History

History
83 lines (67 loc) · 3.49 KB

Readme.md

File metadata and controls

83 lines (67 loc) · 3.49 KB

first-boot-pkg

first-boot-pkg is a tool to create a flat package that will install a series of packages when a Mac boots for the first time. This is designed for use with tools like AutoDMG, when you need to interact with the booted volume (for example, when binding to Active Directory or setting the Mac's hostname).

Features

  • Is designed with scripting and automation in mind, with options able to be configured with a configuration plist or via options on the command line (or a mixture of both)
  • Will re-try failed packages a specified number of times (in case of Active Directory not being available, for example)
  • Can wait for the network to be available before installing (optional, can be enabled if desired)
  • Can specify amount of seconds to retry network (optional)
  • Can specify whether your first boot package requires a reboot or not

Run with --help for the full list of options.

Examples

$ sudo ./first-boot-pkg --pkg /path/to/a/package.pkg --pkg /path/to/another.pkg
Valdating packages:
----------------------------------------------------------------
package.pkg looks good.
another.pkg looks good.
----------------------------------------------------------------
pkgbuild: Inferring bundle components from contents of /tmp/tmpCfcNTg
pkgbuild: Adding component at usr/local/first-boot/packages/package.pkg
pkgbuild: Adding component at Library/PrivilegedHelperTools/LoginLog.app
pkgbuild: Wrote package to /Users/grahamgilbert/src/Mine/first-boot-pkg/first-boot.pkg

Setting common defaults via a plist, and overriding the version via the command line:

 sudo ./first-boot-pkg --plist /Users/grahamgilbert/Desktop/first-boot-config.plist --version 2.3

##Configuration plist

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN"      "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
   <key>Packages</key>
   <array>
       <string>/Users/grahamgilbert/src/ClearReg/ClearReg.pkg</string>
       <string>/Users/grahamgilbert/Desktop/create_grahamgilbert-1.0.pkg</string>
   </array>
   <key>Name</key>
   <string>package-name.pkg</string>
   <key>Identifier</key>
   <string>com.grahamgilbert.test.pkg</string>
   <key>LaunchDaemonIdentifier</key>
   <string>com.grahamgilbert.first-boot-pkg</string>
   <key>Version</key>
   <string>2.4</string>
   <key>Network</key>
   <false/>
   <key>Output</key>
   <string>/Users/Shared/firstboot</string>
   <key>RetryCount</key>
   <integer>5</integer>
   <key>SleepCount</key>
   <integer>10</integer>
   <key>NoReboot</key>
   <true/>
   <key>NoShutdown</key>
   <true/>
</dict>
</plist>

Notes

By default, the network retry and sleep count are both set to 10 for a total of 100 seconds. If you would like a smaller delay with a total of 100 seconds, use a RetryCount of 100 and a SleepCount of 1. Note that a smaller SleepCount may result in more log entries.

If you would like to invoke either a reboot or shutdown, set one of the values to false.

You can now specify a "LaunchDaemonIdentifier". This will allow you to override the default value of "com.grahamgilbert.first-boot-pkg"

Credits

The original inspiration for this script came from Rich Trouton's First Boot Package Install.

This script makes use of Per Olofsson's LoginLog for displaying the log file whilst the script is running, so massive thanks to him for releasing it.