Managing Packages

Packages in the following formats can be administered using the Casper Suite:

  • DMG

  • PKG

  • MPKG

Note: There are special instructions for managing macOS Installers, and Adobe Updaters and Installers for CS3 or CS4. For more information, see Managing macOS Installers or Administering Adobe CS3 and CS4.

Before you can deploy a package, it must exist on the distribution point you plan to deploy it from and in the Jamf Software Server (JSS). There are three ways to achieve this:

  • Add the package to Casper Admin—This method adds the package to the master distribution point and the JSS. You can then add the package to other distribution points via replication.

  • Upload the package directly to the JSS—This method is only available if your master distribution point is the cloud distribution point or a JDS instance. It adds the package to the master distribution point and the JSS. You can then add the package to other distribution points via replication.

  • Manually—This method is only available if your master distribution point is a file share distribution point. It involves manually copying the package to the distribution point and then entering information about the package in the JSS.

Each of these methods also involves configuring settings for the package. When you configure settings for a package, you can do the following:

  • Add the package to a category. (For more information, see Categories.)

  • Choose a priority for deploying or uninstalling the package.

  • Fill user templates with the contents of the home directory in the package’s Users folder.

  • Fill existing user home directories with the contents of the home directory in the package’s Users folder.

  • Allow the package to be uninstalled.

  • Specify whether computers must be restarted after installing the package.

  • Choose whether the package must be installed on the boot drive after imaging.

  • Specify operating system and architecture type requirements for deploying the package.

  • Only allow the package to be installed if it is available in Software Update.

You can also index packages. Indexing creates a log of all the files contained within a package. This allows you to uninstall the package and view the contents of the package from the JSS. Packages can only be indexed using Casper Admin.

In addition, you can validate packages using the checksum. (For more information, see Calculating a Checksum.)

When you add, edit, or delete a package in Casper Admin, the changes are reflected in the JSS and vice versa.

Requirements

To manage packages, you need a distribution point set up in the JSS. (For more information, see About Distribution Points.)

Adding a Package to Casper Admin

Adding a package to Casper Admin adds the package to the master distribution point and the JSS.

  1. Open Casper Admin and authenticate to the JSS.

  2. Drag the package to the main repository in Casper Admin.
    The package is displayed in blue text in the Unknown category until you add it to a category.

  3. Double-click the package in the main repository.

  4. Click the General tab and configure basic settings for the package, including the display name and category.

    images/download/attachments/16433136/Package_General.png
  5. Click the Options tab and configure additional settings for the package, including the priority, and operating system and architecture type requirements.
    Note: Package Limitations options do not apply when installing a package during imaging.

    images/download/attachments/16433136/Package_Options.png

  6. Click OK.

Uploading a Package to the JSS

If your master distribution point is the cloud distribution or a JDS instance, you can upload the package directly to the JSS. This adds the package to the master distribution point and the JSS.

  1. Log in to the JSS with a web browser.

  2. In the top-right corner of the page, click Settings images/download/thumbnails/16433136/Settings_icon.png .

  3. Click Computer Management.

  4. In the “Computer Management” section, click Packages images/download/thumbnails/16433136/Packages.png .

  5. Click New images/download/thumbnails/16433136/New_icon.png .

  6. Use the General pane to configure basic settings for the package, including the display name and category.
    Note: If you do not add the package to a category, Casper Admin displays the package in blue text in the Unknown category.

  7. Click Upload Package and upload the package.

  8. Click the Options tab and configure additional settings for the package, including the priority.

  9. (Optional) Click the Limitations tab and configure limitations for the package, including operating system and architecture type requirements.

  10. Click Save.

Manually Adding a Package to a Distribution Point and the JSS

If your master distribution point is a file share distribution point, you can manually copy a package to the distribution point and then enter information about the package in the JSS.

  1. Copy the package to the Packages folder at the root of the file share on the distribution point.

  2. Log in to the JSS with a web browser.

  3. In the top-right corner of the page, click Settings images/download/thumbnails/16433136/Settings_icon.png .

  4. Click Computer Management.

  5. In the “Computer Management” section, click Packages images/download/thumbnails/16433136/Packages.png .

  6. Click New images/download/thumbnails/16433136/New_icon.png .

  7. Use the General pane to configure basic settings for the package, including the display name, category, and filename.
    Note: If you do not add the package to a category, Casper Admin displays the package in blue text in the Unknown category.

  8. Click the Options tab and additional settings for the package, including the priority.

  9. (Optional) Click the Limitations tab and configure limitations for the package, including operating system and architecture type requirements.

  10. Click Save.

Editing or Deleting a Package Using Casper Admin

  1. Open Casper Admin and authenticate to the JSS.

  2. In the main repository, select the package you want to edit or delete.

  3. Do one of the following:

    • To edit the package, double-click it and make changes as needed. Then click OK.

    • To delete the package, click Delete images/download/thumbnails/16433136/icon_CA_delete.png and then click Delete again to confirm.

The edit or delete action is applied immediately on the master distribution point. The action is applied to your other distribution points when replication occurs.

Indexing a Package

Indexing a package creates a log of all the files contained within the package. This allows you to uninstall the package and view the contents of the package from the JSS.

Packages can be indexed using Casper Admin only. The time it takes to index a package depends on the amount of data in the package.

  1. Open Casper Admin and authenticate to the JSS.

  2. In the main repository, select the package you want to index and click Index at the bottom of the pane.

  3. If prompted, authenticate locally.

When the indexing process is complete, Casper Admin defaults back to the main repository.

Viewing the Contents of an Indexed Package

  1. Log in to the JSS with a web browser.

  2. In the top-right corner of the page, click Settings images/download/thumbnails/16433136/Settings_icon.png .

  3. Click Computer Management.

  4. In the “Computer Management” section, click Packages images/download/thumbnails/16433136/Packages.png .

  5. Click the package you want to view the contents of.

  6. Click Contents.

A table that contains the package contents is displayed.

Calculating a Checksum

The checksum is calculated when a package is uploaded to the JSS. The checksum ensures authenticity when the package is downloaded.

The checksum can also be calculated manually using Casper Admin:

  1. Open Casper Admin and authenticate to the JSS.

  2. In the main repository, select the package you want to calculate checksum for.

  3. Control-click (or right-click) and select Calculate Selected Package Checksum(s).

Related Information

For related information, see the following sections in this guide:

Copyright | Privacy | Terms of Use | Security
© copyright 2002-2017 Jamf. All rights reserved.