Firstboot Package Guide

This guide will walk you through using the Firstboot Template.

Required for this tutorial:
Apple's PackageMaker (Part of Xcode) - https://developer.apple.com/iphone/download.action?path=%2Fios%2Fios_sdk_4.0.2__final%2Fxcode_3.2.3_and_ios_sdk_4.0.2.dmg
The PackageMaker Firstboot template - File:Firstboot.dmg

1. Download the PackageMaker Template: File:Firstboot.dmg. Double click to mount the .dmg once it is finished downloading.
2. Create a new folder named firstboot on your desktop. This folder can be anywhere, but we'll refer to it as being on the desktop for this guide.
3. Drag and drop the contents of the mounted Firstboot.dmg file into your ~/Desktop/firstboot folder.
4. In the firstboot folder, you will notice that there is a specific folder structure. The structure is not required to be this way, but I find that it is easier to keep track of the files within the Apple Package if they arranged in a logical fashion. The ROOT folder represents the root of the machine that this package will be installed on (Which for our purposes, will be the root of the InstaDMG image that we will install this package to). Within the ROOT folder, you will find /Library/LaunchDaemons/com.company.firstboot.plist and /Library/Scripts/CompanyName/firstboot.sh. There is also a scripts folder in the same directory as ROOT, it will contain our postflight script that will be executed after the contents of the package are delivered.
5. The first thing we need to do with this template is customize it for your organization. Rename com.companyname.firstboot.plist so it matches your organizations name and type of internet domain. We will say we work for the SomeUni College, which is an .edu domain, so we would rename it to edu.someuni.firstboot.plist.
6. Change the /Library/Scripts/CompanyName folder to SomeUni as well to match your organization.
7. Double click the firstboot.pmdoc file to open it in PackageMaker. You will notice on the left hand side, there is a contents section, which has com.company.firstboot listed. Expand com.company.firstboot and it will reveal two files. Since we renamed the files in the folder, PackageMaker isn't quite sure where they went (As shown by the ? marks), so lets fix the file names.
8. Click com.company.firstboot
9. Click com.company.firstboot and select the "Configuration" section. For the Install field, change the com.companyname.firstboot.plist to reflect what you renamed the file to. In our case, edu.someuni.firstboot.plist. Once you do this, you will see that the ? mark now turns into a page icon.