TweetFollow Us on Twitter

MacEnterprise: Packages, Receipts, and Snow...

Volume Number: 25
Issue Number: 12
Column Tag: System Administration

MacEnterprise: Packages, Receipts, and Snow...

Snow Leopard's changes to package receipts and updates

by Greg Neagle, Macenterprise.org

Introduction

It's that time of year, when there's snow (at least in parts of the Northern Hemisphere), and people are thinking of packages - packages to ship to friends and family; maybe even packages under a tree. So what better time to talk about Snow Leopard and packages?

As always, with each major OS release from Apple, there are changes that might affect systems administrators. Last time, we went on a scavenger hunt through the OS, looking for some of these changes. This month, we'll focus on changes relating to installer packages, receipts, and Software Update.

Keep Those Receipts!

Experienced OS X systems administrators should be familiar with package receipts. These are written to disk when software packaged in Apple package format is installed. Receipts serve as evidence that a certain version of a certain software package has been installed, and also are essential for the installer when it is upgrading a software package from an older version to a newer version. Some software installation problems can be resolved by removing the relevant receipt(s). If the receipt is missing, the installer treats the installation as a new install instead of an upgrade install. (This may create its own issues; it is not something you should do as a matter of habit.)

Prior to the release of OS X 10.5 Leopard, when Apple packages were installed, receipts were left in /Library/Receipts. These receipts were copies of the original installation package minus the archive containing the actual files that were installed.

Leopard added a new type of package - the "flat" package - where instead of a bundle-style directory, the package is a single file. This file is actually a XAR archive; similar in concept to a "tarball" or zip archive. When this type of package is installed under Leopard, it does not leave a receipt in /Library/Receipts. Instead, a copy of the "bom" (bill-of-materials) file is placed in /Library/Receipts/boms, and an entry for the package is made in the package database. You can get information from the package database using the /usr/sbin/pkgutil tool.

Even though OS X 10.5 introduced a new package format, there's still plenty of software that uses the older format. Any software that can be installed on OS X 10.4 or earlier must use the older bundle-style package format. Many vendors continue to use the bundle-style package format even for software that runs only on 10.5 and later, because this format is well understood and there are several third-party tools to create this format. Under Mac OS X Leopard, packages in this format leave their receipts in /Library/Receipts - just as they did in previous releases of Mac OS X - so you might have to look in two places and use a variety of tools to find the receipt information you are interested in.

In Snow Leopard, virtually all package receipts now go in the package database, and only extremely old package formats or those missing the CFBundleIdentifier attribute from their Info.plist are not added to the package database. If you haven't had to work with the package database before, under Snow Leopard, you almost certainly will.

Pkgutil

If you had previously dug around in package receipts to figure out exactly what was installed, and examined pre- and post-install scripts to puzzle out what additional changes were made when software was installed, you may wonder how to get that information under Snow Leopard. Some of the info is now available via /usr/sbin/pkgutil, but for pre- and post-install scripts, you'll need to find the original installer package - this information is no longer retained.

If you used pkgutil in Leopard, it is mostly unchanged in Snow Leopard. Here are some common uses of pkgutil:

pkgutil —pkgs will list all installed package IDs. By using the —volume option, you can query the package database on a volume other than the boot volume.

pkgutil —pkgs
com.adobe.pkg.FlashPlayer
com.adobe.shockwave
com.apple.pkg.AdditionalEssentials
com.apple.pkg.AdditionalSpeechVoices
com.apple.pkg.AddressBook
...

pkgutil —files packageid shows all the files installed by packageid.

pkgutil —files com.adobe.pkg.FlashPlayer
Flash Player.plugin
Flash Player.plugin/Contents
Flash Player.plugin/Contents/Info.plist
Flash Player.plugin/Contents/MacOS
Flash Player.plugin/Contents/MacOS/Flash Player
Flash Player.plugin/Contents/Resources
Flash Player.plugin/Contents/Resources/English.lproj
...

pkgutil —pkg-info packageid prints extended information about packageid.

pkgutil —pkg-info com.adobe.pkg.FlashPlayer
package-id: com.adobe.pkg.FlashPlayer
version: 10.0
volume: /
location: Library/Internet Plug-Ins
install-time: 1255647844

pkgutil —forget packageid removes info about packageid from the package database. This is equivalent to deleting receipts in /Library/Receipts under older versions of Mac OS X, and is a way to get the installer to treat a reinstall like a new install instead of an upgrade install. Note that this does not remove any files installed by the package.

pkgutil —forget com.adobe.pkg.FlashPlayer
Forgot package 'com.adobe.pkg.FlashPlayer' on '/'.

pkgutil —file-info path will print information about the filesystem item at path. This can be useful for determining which package is responsible for installing a specific file or directory.

pkgutil —file-info /Applications/Mail.app 
volume: /
path: /Applications/Mail.app
pkgid: com.apple.pkg.Mail
pkg-version: 10.6.0.1.1.1249291854
install-time: 1251997001
uid: 0
gid: 0
mode: 755
pkgid: com.apple.pkg.update.os.10.6.1
pkg-version: 1.0.1.1249367152
install-time: 1255646935
uid: 0
gid: 0
mode: 755

We can see that the /Applications/Mail.app directory was installed as part of the com.apple.pkg.Mail package as part of the original OS install, then later modified by the 10.6.1 update.

In Leopard, the actual package database was a Sqlite3 database, stored on-disk at /Library/Receipts/db/a.receiptdb. You could use standard sqlite3 libraries to query and even modify this database. In Snow Leopard, it appears the database is created from the contents of /var/db/receipts. In this directory you will find two files for each installed package - a packageid.bom file, and a packageid.plist file. The bom file is a standard bill-of-materials file, containing a listing of all the filesystem items installed by the package. You can use lsbom to list the contents of the bom file. The plist file is, of course, a standard OS X property list file, containing metadata about the package. The plist file is in binary format, so to read it you'll either need to use the defaults command, or use plutil to convert it to XML. Here we'll use the defaults command:

defaults read /var/db/receipts/com.microsoft.rdc.pkg
{
    InstallDate = "2009-10-14 15:43:47 -0700";
    InstallPrefixPath = "";
    InstallProcessName = installer;
    PackageFileName = "RDC2.0.0.pkg";
    PackageIdentifier = "com.microsoft.rdc.pkg";
    PackageVersion = "2.0.0";
    PathACLs =     {
        Applications = "!#acl 1\\ngroup:ABCDEFAB-CDEF-ABCD-EFAB-CDEF0000000C:everyone:12:deny:delete\\n";
    };
}

This appears to be a superset of the info you can get from pkgutil:

pkgutil —pkg-info com.microsoft.rdc.pkg
package-id: com.microsoft.rdc.pkg
version: 2.0.0
volume: /
location: 
install-time: 1255560227

Note that the plist file for com.microsoft.rdc.pkg contains a little more information - the filename of the installer package; which process installed this, and ACLs for any paths in the installed payload. Also, the install date/time is in a more human-readable format in the plist file.

As always, you can type man pkgutil at a command-line prompt to get more information on the syntax and options for /usr/sbin/pkgutil.

Software Update

Software Update has not changed much from Leopard. One annoyance from Leopard has been fixed, though.

In Leopard, Software Update could be configured to automatically download available updates in the background, and then notify you when they were ready to install. These updates were stored in /Library/Updates. But if you used the command-line version of softwareupdate to download available updates, the updates were downloaded to the Downloads folder of the current user, even when that user was root. This was a minor thing, sure, but was annoying in its inconsistency.

Snow Leopard changes this behavior. /usr/sbin/softwareupdate now downloads updates to /Library/Updates. This makes it easier to script custom behavior for downloading updates, as updates downloaded by a script using /usr/sbin/softwareupdate appear in, and can be installed with the GUI Software Update application.

Software Update Server

If you manage an Apple Software Update Server for your organization, in order to serve updates to Snow Leopard clients, Apple's official stance is that you'll need to upgrade to Snow Leopard Server on your Software Update Server machines. This is not a new requirement; the Leopard update required a matching update on the server end, as did Tiger.

What's frustrating about this is there is no real technical reason for it, as Apple's Software Update service is just a specially configured web server and some code that replicates updates from Apple's servers to yours. You may not be ready to upgrade your server infrastructure at the same time you need to roll out client machines running Snow Leopard.

What to do? You could configure your Snow Leopard clients to get their updates directly from Apple. You could set up a new Snow Leopard-only software update server on some spare box you have - Apple's new pricing on Snow Leopard server makes that more appealing than in the past. Or you could go the super-cheap route and hack your Leopard Software Update server.

Software Update Server Hack

The original hack was described by Jan Uschok on an Apple discussion list here:

http://discussions.apple.com/thread.jspa?threadID=2169042&tstart=0

All credit for this hack should go to Jan, and I recommend you read the original hack and discussion if you want to try this. In case the discussion disappears, the basic steps follow:

Stop your Software Update Server process.

On your Software Update Server, create a file at /usr/share/swupd/html/content/meta/mirror-config-1.plist with the following contents (you may need to create the "meta" directory if it is missing):

<?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>PrimaryCatalog</key>
   <string>http://swscan.apple.com/content/catalogs/index.sucatalog</string>
   <key>CatalogsList</key>
   <array>
   <string>http://swscan.apple.com/content/catalogs/index.sucatalog</string>
   <string>http://swscan.apple.com/content/catalogs/others/index-leopard.merged-1.sucatalog</string>
   <string>http://swscan.apple.com/content/catalogs/others/index-leopard-snowleopard.merged-1.sucatalog</string>
   </array>
</dict>
</plist>

If you retype this from this magazine, note that there should be no line breaks inside any of the <string> elements - they are all a single line.

Edit /etc/swupd/swupd.plist and change the metaIndexURL entry to look like this:

<key>metaIndexURL</key>

<string>http://localhost:8088/content/meta/mirror-config-1.plist</string>

Again, mind the line breaks; the <string> element is a single line.

Start the Software Update Server process and wait for it to download the catalogs. They'll appear under /usr/share/swupd/html/content/catalogs/ and /usr/share/swupd/html/content/catalogs/other/

Once the new catalogs are in place, stop the Software Update Server process again.

Create some symlinks:

cd /usr/share/swupd/html
ln -s /usr/share/swupd/html/content/catalogs/index.sucatalog .
ln -s /usr/share/swupd/html/content/catalogs/others/index-leopard.merged-1.sucatalog .
ln -s /usr/share/swupd/html/content/catalogs/others/index-leopard-snowleopard.merged-1.sucatalog .

(Again, watch the line breaks; all ln -s commands are a single line)

Start the Software Update Server process (again!) and wait for updates to download.

At this point, your hacked Software Update Server should be acting like a Software Update Server running on Snow Leopard server. You can then configure your clients as described on pages 88-89 of the Server System Imaging and Software Update Administration Guide for Snow Leopard. This guide is available from Apple here:

http://images.apple.com/server/macosx/docs/System_Imaging_and_SW_Update_Admin_v10.6.pdf

Specifically, you need to point Tiger clients to one Software Update URL; Leopard clients to another URL, and Snow Leopard clients to yet another.

Use this hack at your own risk; Apple could make changes that would cause this to stop working, and there's no guarantee that the Leopard Server Admin GUI tools will do the right thing with your hacked Software Update Server.


Figure 1 - Leopard Server hosting Snow Leopard updates.

Figure 1 is a screen shot showing a hacked Leopard server hosting Snow Leopard updates. You can see there vvvare updates available for Tiger, Leopard, and Snow Leopard. For comparison, see Figure 2, which is a Snow Leopard server hosting the same updates.


Figure 2 - Snow Leopard server running Software Update Server.

In my brief testing, this hack seemed to work as desired, but I'm not certain I'd want to rely on it indefinitely. Your mileage may vary; results shown may not be typical; talk to your doctor to see if Software Update Server hacking is right for you.

Wrapping up

That completes our look at Snow Leopard, receipts, packages, and Software Update. As with most of the changes between Leopard and Snow Leopard, the changes in handling packages and receipts aren't dramatic; they are more evolutionary than revolutionary. We'll all have to wait for Mac OS X 10.7 to see if revolutionary changes are in store - like for example:

pkgutil -uninstall packageid

A systems administrator can dream!


Greg Neagle is a member of the steering committee of the Mac OS X Enterprise Project (macenterprise.org) and is a senior systems engineer at a large animation studio. Greg has been working with the Mac since 1984, and with OS X since its release. He can be reached at gregneagle@mac.com.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

OmniGraffle Pro 7.2.2 - Create diagrams,...
OmniGraffle Pro helps you draw beautiful diagrams, family trees, flow charts, org charts, layouts, and (mathematically speaking) any other directed or non-directed graphs. We've had people use... Read more
OmniGraffle 7.2.2 - Create diagrams, flo...
OmniGraffle helps you draw beautiful diagrams, family trees, flow charts, org charts, layouts, and (mathematically speaking) any other directed or non-directed graphs. We've had people use Graffle to... Read more
Spotify 1.0.44.100. - Stream music, crea...
Spotify is a streaming music service that gives you on-demand access to millions of songs. Whether you like driving rock, silky R&B, or grandiose classical music, Spotify's massive catalogue puts... Read more
Microsoft OneNote 15.29 - Free digital n...
OneNote is your very own digital notebook. With OneNote, you can capture that flash of genius, that moment of inspiration, or that list of errands that's too important to forget. Whether you're at... Read more
WALTR 2 2.0.8 - $39.95
WALTR 2 helps you wirelessly drag-and-drop any music, ringtones, videos, PDF, and ePub files onto your iPhone, iPad, or iPod without iTunes. It is the second major version of Softorino's critically-... Read more
Dropbox 16.3.27 - Cloud backup and synch...
Dropbox is an application that creates a special Finder folder that automatically syncs online and between your computers. It allows you to both backup files and keep them up-to-date between systems... Read more
EtreCheck 3.1.5 - For troubleshooting yo...
EtreCheck is an app that displays the important details of your system configuration and allow you to copy that information to the Clipboard. It is meant to be used with Apple Support Communities to... Read more
Carbon Copy Cloner 4.1.12 - Easy-to-use...
Carbon Copy Cloner backups are better than ordinary backups. Suppose the unthinkable happens while you're under deadline to finish a project: your Mac is unresponsive and all you hear is an ominous,... Read more
VueScan 9.5.62 - Scanner software with a...
VueScan is a scanning program that works with most high-quality flatbed and film scanners to produce scans that have excellent color fidelity and color balance. VueScan is easy to use, and has... Read more
SpamSieve 2.9.27 - Robust spam filter fo...
SpamSieve is a robust spam filter for major email clients that uses powerful Bayesian spam filtering. SpamSieve understands what your spam looks like in order to block it all, but also learns what... Read more

Latest Forum Discussions

See All

Track Santa with these three festive app...
Christmas is fast approaching and that means it's time to prepare for Santa's yearly pilgrimage around the globe. Christmas Eve is an exciting time as parents help their kids get ready to welcome Santa. You've got the cookies and milk all planned... | Read more »
Galaxy on Fire 3 and four other fantasti...
Galaxy on Fire 3 - Manticore brings the series back for another round of daring space battles. It's familiar territory for folks who are familiar with the franchise. If you've beaten the game and are looking to broaden your horizons, might we... | Read more »
The best apps for your holiday gift exch...
What's that, you say? You still haven't started your holiday shopping? Don't beat yourself up over it -- a lot of people have been putting it off, too. It's become easier and easier to procrastinate gift shopping thanks to a number of apps that... | Read more »
Toca Hair Salon 3 (Education)
Toca Hair Salon 3 1.0 Device: iOS Universal Category: Education Price: $2.99, Version: 1.0 (iTunes) Description: | Read more »
Winter comes to Darkwood as Seekers Note...
MyTona, based in the chilly Siberian city of Yakutsk, has brought a little festive fun to its hidden object game Seekers Notes: Hidden Mystery. The Christmas update introduces some new inhabitants to players, and with them a chance to win plenty of... | Read more »
Bully: Anniversary Edition (Games)
Bully: Anniversary Edition 1.03.1 Device: iOS Universal Category: Games Price: $6.99, Version: 1.03.1 (iTunes) Description: *** PLEASE NOTE: This game is officially supported on the following devices: iPhone 5 and newer, iPod Touch... | Read more »
PINE GROVE (Games)
PINE GROVE 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: A pine grove where there are no footsteps of people due to continuous missing cases. The case is still unsolved and nothing has... | Read more »
Niantic teases new Pokémon announcement...
After rumors started swirling yesterday, it turns out there is an official Pokémon GO update on its way. We’ll find out what’s in store for us and our growing Pokémon collections tomorrow during the Starbucks event, but Niantic will be revealing... | Read more »
3 reasons why Nicki Minaj: The Empire is...
Nicki Minaj is as business-savvy as she is musically talented and she’s proved that by launching her own game. Designed by Glu, purveyors of other fine celebrity games like cult favorite Kim Kardashian: Hollywood, Nicki Minaj: The Empire launched... | Read more »
Clash of Clans is getting its own animat...
Riding on its unending wave of fame and success, Clash of Clans is getting an animated web series based on its Clash-A-Rama animated shorts.As opposed to the current shorts' 60 second run time, the new and improved Clash-A-Rama will be comprised of... | Read more »

Price Scanner via MacPrices.net

Never Settle for Low Performing Wifi With iOS...
AppYogi Software has announced the release of WiFi Signal Strength Status App 1.0, the company’s new utility developed exclusively for macOS. WiFi Signal Strength Status App features a unique, single... Read more
New 2016 13-inch Touch Bar MacBook Pros in st...
B&H Photo has stock of new 2016 Apple 13″ Touch Bar MacBook Pro models, each including free shipping plus NY sales tax only: - 13″ 2.9GHz/512GB Touch Bar MacBook Pro Space Gray: $1999 - 13″ 2.... Read more
New 2016 15″ Touch Bar MacBook Pros in stock...
B&H Photo has new 2016 Apple 15″ Touch Bar MacBook Pro models in stock today including free shipping plus NY sales tax only: - 15″ 2.7GHz Touch Bar MacBook Pro Space Gray: $2799 - 15″ 2.7GHz... Read more
DietSensor App Targeting Diabetes and Obesity...
DietSensor, Inc., a developer of smart food and nutrition applications designed to fight diabetes and obesity and help improve overall fitness, has announced the launch of its DietSensor app for... Read more
Holiday 2016 13-inch 2.0GHz MacBook Pro sales...
B&H has the non-Touch Bar 13″ MacBook Pros in stock today for $50-$100 off MSRP. Shipping is free, and B&H charges NY sales tax only: - 13″ 2.0GHz MacBook Pro Space Gray (MLL42LL/A): $1449 $... Read more
Holiday sale: Apple TVs for $51-$40 off MSRP,...
Best Buy has dropped their price on the 64GB Apple TV to $159.99 including free shipping. That’s $40 off MSRP. 32GB Apple TVs are on sale right now for $98 on Sams Club’s online store. That’s $51 off... Read more
12-inch Retina MacBooks, Apple refurbished, n...
Apple has restocked a full line of Certified Refurbished 2016 12″ Retina MacBooks, now available for $200-$260 off MSRP. Refurbished 2015 models are available starting at $929. Apple will include a... Read more
Holiday sale: 12-inch Retina MacBook for $100...
B&H has 12″ Retina MacBooks on sale for $100 off MSRP as part of their Holiday sale. Shipping is free, and B&H charges NY sales tax only: - 12″ 1.1GHz Space Gray Retina MacBook: $1199 $100... Read more
Apple refurbished 13-inch MacBook Airs availa...
Apple has Certified Refurbished 13″ MacBook Airs available starting at $849. An Apple one-year warranty is included with each MacBook, and shipping is free: - 13″ 1.6GHz/8GB/128GB MacBook Air: $849 $... Read more
Apple refurbished iMacs available for up to $...
Apple has Certified Refurbished 2015 21″ & 27″ iMacs available for up to $350 off MSRP. Apple’s one-year warranty is standard, and shipping is free. The following models are available: - 21″ 3.... Read more

Jobs Board

Integration Technician, *Apple* - Zones, In...
…at Zones and for our customers each day. Position Overview The Apple Integration Technician will be responsible for performing customer specific configuration Read more
*Apple* Brand Ambassador (Macy's) - The...
…(T-ROC), is proud of its unprecedented relationship with our partner and client, APPLE ,in bringing amazing" APPLE ADVOCATES"to "non" Apple store locations. Read more
*Apple* Retail - Multiple Positions- Trumbul...
Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, you're also the Read more
*Apple* Retail - Multiple Positions - Apple,...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
US- *Apple* Store Leader Program - Apple (Un...
…Summary Learn and grow as you explore the art of leadership at the Apple Store. You'll master our retail business inside and out through training, hands-on Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.