Getting *nix to Netboot Macs

Apple-Intel-Netboot

http://brandon.penglase.net/index.php?title=Getting_*nix_to_Netboot_Macs

class "Apple-Intel-Netboot" {
 2 	# Limit this class to only Intel Apple machines
 3 	match if substring (option vendor-class-identifier, 0, 14) = "AAPLBSDPC/i386";
 4 	option dhcp-parameter-request-list 1,3,17,43,60; # Send these options to the client (possibly forcing it, if the client didn't request it)
 5 							# From: http://www.iana.org/assignments/bootp-dhcp-parameters/bootp-dhcp-parameters.xml
 6 							# 1 - Subnet Mask
 7 							# 3 - Router
 8 							# 17 - Root Path
 9 							# 43 - Vendor Specific
10 							# 60 - Class ID
11 
12 	if (option dhcp-message-type = 8) {
13 		# on DHCPInform Messages, Us/Our (Server), Them (Client)
14 		option vendor-class-identifier "AAPLBSDPC"; # Let Them know we're responding with Apple BSDP Information
15 		if (substring(option vendor-encapsulated-options, 0, 3) = 01:01:01) {
16 			log(info, "BSDP_LIST");
17 			# BSDP List
18 			# Let Them know this is the let, what server, the server's priority, what Our default image is, and provide the image list
19 			option vendor-encapsulated-options
20 				01:01:01:			# Start BSDP Inform/List Option 1 (01:), Length 1 (01:), Message Type List(1) (01:)
21 				03:04:				# BSDP option code 3 (length 04) -- Server Identifier
22 					0A:00:03:02:		# Server IP (10.0.3.2), Dec->Hex
23 				04:02:				# BSDP option code 4 (length 02) -- Server Priority
24 					80:00:			# Priority (32768) Dec->Hex
25 				07:04:				# BSDP option code 7 (length 04) -- Default Image ID
26 					81:00:00:89:		#     Image ID - (137) Dec->Hex
27 								# This is what is picked as Default when you only hold down N on the client
28 								#
29 								# 81 breaks into: 0 or 8 for Non-Install (NetBoot) set or Install (NetInstal) set,
30 								# Most, including DeployStudio default to NetInstall set.
31 								# Then 0 for Mac OS 9, 1 for Mac OS X (Client)
32 								# 2 for OS X Server, and 3 for Hardware Diagnostics
33 								# 4- through 127 (x4:00-xf:ff) reversed for future use
34 								# And the last two are for the Image ID (Dec->Hex)
35 								# IDs 1-4095 (00:01-0F:FF) are for Server-Specific Images (You will probably want an ID in this range)
36 								# IDs 4096-65535 (10:00-FF:FF) Are "Globally-Unique", Multiple servers can present this same ID
37 								# and the client will only see one image, and pick a random(?) server to talk to.
38 								#
39 				09:				# BSDP option code 9 -- Boot image list
40 					2A:			# Length - =5*<numofimages>+<sumofallimagenames>, eg =5*2+(23+9), =10+32, =42, Dec->Hex =2A
41 								# This only appears once in the pacakge, no matter how many images you have below
42 						81:00:00:89:	# Image ID (137) -- dec->hex, see above (Default Image ID) for how to forumlate the full ID
43 							09:44:6f:45:2d:49:6d:61:67:65:	# Length(09):Name 'DoE-Image' ascii->hex
44 						81:00:00:8A:				# Image ID -- 138
45 							17:44:53:52:2d:4e:42:30:31:30:31:32:30:31:32:2d:30:35:31:32:32:30:31:32; # Length(Hex:17,Dec:23):Name 
46 																# Name: DSR-NB01012012-05122012
47 		} elsif (substring(option vendor-encapsulated-options, 0, 3) = 01:01:02) {
48 			log(info, "BSDP_SELECT");
49 			# BSDP Select, This is the client selecting which image they want to boot from
50 			# Here we basically do if statements to catch what image is referenced
51 			# Since we MIGHT be clustered, Check to see if we're the server being asked, this is BSDP Option 3 (Length 04)
52 			if (substring(option vendor-encapsulated-options, 9, 4) = 0A:00:03:02) { # Match to IP: 10.0.3.2, same as above. You'll want to change this
53 				log(info, "BSDP_SELECT-Responding, Client is talking to us."); # Log we're being talked to
54 				if (substring(option vendor-encapsulated-options, 15, 4) = 81:00:00:89) { # Catch Image ID 81:00:00:89
55 					log(info, "BSDP_SELECT-Image: 137:DOE-Image"); # This isn't _needed_, but is nice for debugging/knowing
56 					# Insert stuff needed to boot here
57 					filename "/osx/i386/booter";
58 					next-server 10.25.64.32;
59 					option root-path = "http://10.25.64.32/build.sparseimage";
60 				} elsif (substring(option vendor-encapsulated-options, 15, 4) = 81:00:00:8A) { # Catch Image ID 81:00:00:8A
61 					log(info, "BSDP_SELECT-Image: DSR-NB01012012-05122012");
62 					# Insert stuff here needed for boot
63 					# This example is from the FOG Project: http://fogproject.org/wiki/index.php?title=How_to_get_Macintosh%27s_Netboot_working_with_your_FOG_server
64 					filename "macnbi-i386/booter";
65 					#Replace 192.168.1.1 with the server's actual IP address.
66 					#Need clarification if NetRestore works for both Intel and PowerPC
67 					#For DeployStudio, either copy DeployStudioRuntime.sparseimage to /nbi, or use nfs share to connect to deploy studio server
68 					#option root-path "nfs:<deploystudio_ip>:/Volumes/<volume_label>/Library/NetBoot/NetBootSP0:<runtime_folder>/DeployStudioRuntime.sparseimage";
69       					#option root-path "nfs:192.168.1.1:/nbi:DeployStudioRuntime.sparseimage";
70 					option root-path "nfs:192.168.1.1:/nbi:NetInstall-Restore.dmg";
71 					next-server 192.168.1.1;
72 				} else {
73 					log(info,"BSDP_SELECT-ERROR: Client responded with an image we don't have a match for! -- (Image added to list, but not in select catch?)");
74 				} 	# End Image Selection Response
75 			} else {
76 				log(info,"BSDP_SELECT-Ignoring, Client is talking to another server--We're not worthy!"); # Log that we are not worthy of the client's time
77 			} 		# End Server Check
78 		} 			# End BSDP Options Check
79 	} 				# End DHCPInform Messages
80 } 					# End Class