Package Management

You can use Jamf Pro and Jamf Admin to manage packages you plan to deploy to computers in your environment. Managing packages involves adding the package to your distribution point and to Jamf Pro, and configuring settings for the package.

Before you can deploy packages to remote computers, you must have a distribution point set up in Jamf Pro. For more information, see About Distribution Points.

Package Upload Methods

You can add the package to your distribution point using the following methods:

  • Jamf Pro—You can upload the package directly to Jamf Pro. This adds the package to the principal distribution point and Jamf Pro.

  • Jamf Admin—The Jamf Admin application is a repository that allows you to add and manage packages. It also allows you to create configurations (images) using these items and replicate files to distribution points. Adding a package to Jamf Admin automatically adds the package to the principal distribution point and Jamf Pro.
    To add a package to Jamf Admin, the file must be in one of the following formats:

    • Disk Image (.dmg)

    • Installer Package (.pkg)

    • Metapackage (.mpkg)

    • Compressed archive (.zip)

    • Application (.app)

Depending on the type of distribution point in your environment, you can use the following methods for adding packages to your distribution point and Jamf Pro:

Distribution Point

Method

Description

Any Distribution Point

Add the package to Jamf Admin

This method adds the package to the principal distribution point and Jamf Pro. You can then add the package to other distribution points via replication.

Cloud Distribution Point

Upload the package directly to Jamf Pro

This method adds the package to the principal distribution point and Jamf Pro. You can then add the package to other distribution points via replication.

File Share Distribution Point

Manually

This method involves manually copying the package to the distribution point and then entering information about the package in Jamf Pro.

Note: On computers with macOS 10.15 or later that do not have an MDM profile, you must use an HTTP, HTTPS, or cloud distribution point to install packages.

Package Settings

When you add a package to a distribution point and Jamf Pro, you can configure settings for the package, such as choosing a priority for the package installation. Adding, editing, or deleting a package in Jamf Admin is reflected in Jamf Pro and vice versa. Some settings are only available when using Jamf Admin to manage the package.

The following table explains the different settings you can configure for packages:

Setting

Jamf Pro

Jamf Admin

Description

Category

images/download/thumbnails/81550595/checkmark.png

images/download/thumbnails/81550595/checkmark.png

You can add the package to a category, an organizational component that allows you to group the package in Jamf Admin and Jamf Pro. Before you can add a package to a category, you must add the category to Jamf Admin or Jamf Pro. For more information, see Categories.

Priority

images/download/thumbnails/81550595/checkmark.png

images/download/thumbnails/81550595/checkmark.png

You can choose a priority for deploying or uninstalling the package. Consider the following when configuring priority:

  • Packages with higher priority install first.

  • Package priority defaults to "10".

  • A package with a priority of "1" is deployed or uninstalled before other packages.

  • Multiple packages with the same priority install in alphabetical order based on the package name.

Fill User Templates (FUT)

images/download/thumbnails/81550595/checkmark.png

images/download/thumbnails/81550595/checkmark.png

You can fill user templates with the contents of the home directory in the package's Users folder. This setting applies to DMGs only.

Fill Existing User Home Directories (FEU)

images/download/thumbnails/81550595/checkmark.png

images/download/thumbnails/81550595/checkmark.png

You can fill existing user home directories with the contents of the home directory in the package’s Users folder. This setting applies to DMGs only.

Index Packages

 

images/download/thumbnails/81550595/checkmark.png

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 Jamf Pro. The time it takes to index a package depends on the amount of data in the package.

Allow Package to be Uninstalled

images/download/thumbnails/81550595/checkmark.png

images/download/thumbnails/81550595/checkmark.png

You can allow the package to be uninstalled. You must index a package using Jamf Admin before you can uninstall it.

Require Restart

images/download/thumbnails/81550595/checkmark.png

images/download/thumbnails/81550595/checkmark.png

You can specify whether computers must be restarted after installing the package.

Install on boot drive after imaging

images/download/thumbnails/81550595/checkmark.png

images/download/thumbnails/81550595/checkmark.png

You can choose whether the package must be installed on the boot drive after imaging.

Operating System requirements

images/download/thumbnails/81550595/checkmark.png

images/download/thumbnails/81550595/checkmark.png

You can specify operating system and architecture type requirements for deploying the package. For example, if you enter "10.13", packages are only installed on computers with macOS 10.13.

Install Only if Available in Software Update

images/download/thumbnails/81550595/checkmark.png

images/download/thumbnails/81550595/checkmark.png

You can choose to install the package only if there is an available update. The display name of the package must match the name in the command-line version of the Software Update. This setting applies to PKGs only.

Limit Architecture Type

images/download/thumbnails/81550595/checkmark.png

images/download/thumbnails/81550595/checkmark.png

You can choose to deploy the packages to computers that meet specific architecture types only. For example, you can specify "PowerPC" as a requirement. You can also specify a previously configured package as a substitute package to deploy to computers that do not have the required architecture type.

Adding a Package to Jamf Admin

  1. Open Jamf Admin and authenticate to the Jamf Pro server.

  2. Drag the package to the main repository in Jamf 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/81550595/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/81550595/Package_Options.png

  6. Click OK.

Uploading a Package to Jamf Pro

To upload a package to Jamf Pro, your principal distribution point must be a cloud distribution point. For more information, see Cloud Distribution Point.

  1. Log in to Jamf Pro.

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

  3. Click Computer Management.

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

  5. Click New images/download/thumbnails/81550595/Icon_New_Button.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, Jamf Admin displays the package in blue text in the Unknown category.

  7. Click Upload Package and upload the package.

  8. (Optional) If you are uploading an enrollment package, you can upload a custom manifest file by clicking the Upload Manifest File button. You can remove the file by clicking the Delete Manifest File button.

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

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

  11. Click Save.

Manually Adding a Package to a Distribution Point and Jamf Pro

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

  2. Log in to Jamf Pro.

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

  4. Click Computer Management.

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

  6. Click New images/download/thumbnails/81550595/Icon_New_Button.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, Jamf 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 Jamf Admin

  1. Open Jamf Admin and authenticate to the Jamf Pro server.

  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. Click OK. Then click File > Save.

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

The edit or delete action is applied immediately on the principal 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 Jamf Pro. The time it takes to index a package depends on the amount of data in the package.

Packages can be indexed using Jamf Admin only.

  1. Open Jamf Admin and authenticate to the Jamf Pro server.

  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.

  4. Save the changes by clicking File > Save.

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

Viewing the Contents of an Indexed Package

  1. Log in to Jamf Pro.

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

  3. Click Computer Management.

  4. In the “Computer Management” section, click Packages images/download/thumbnails/81550595/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 Jamf Pro. The checksum ensures authenticity when the package is downloaded.

The checksum can also be calculated manually using Jamf Admin:

  1. Open Jamf Admin and authenticate to the Jamf Pro server.

  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).

Copyright     Privacy Policy     Terms of Use     Security
© copyright 2002-2020 Jamf. All rights reserved.