Jamf Distribution Server Instances

A Jamf Distribution Server (JDS) instance is a distribution point that is managed by the Jamf Software Server (JSS), similar to a computer or mobile device. It can be used to host packages, in-house apps, and in-house eBooks.

Before using a JDS instance, you must install it and configure it. JDS instances can be installed on Mac or Linux. When you install a JDS instance, it is enrolled with the JSS. You can install as many instances as your organization requires.

By default, the first JDS instance you install is the root. The root instance is used by other instances as the authoritative source for all files. The root instance can also be used as the master distribution point. You can make a different instance the root at any time.

You can define parent-child relationships between non-root JDS instances, making selective file replication more manageable.

When you configure a JDS instance, you can do the following:

  • Make it the master distribution point.

  • Choose a parent JDS instance (non-root JDS instances only).

  • Enable certificate-based authentication.

  • Limit the rate at which the JDS instance downloads files.

  • Specify WebDAV accounts.

  • Choose whether to replicate specific files or the entire contents of the parent JDS instance
    (non-root JDS instances only).

You can also view the progress of file replication and view inventory information for each JDS instance.

Requirements

The JDS Installer for Mac requires a computer with:

  • An Intel processor

  • 2 GB of RAM

  • 100 GB of disk space available

  • macOS 10.7 or later with macOS Server 1.4.3 or later installed

The JDS Installer for Linux requires a computer with:

  • An Intel processor

  • 2 GB of RAM

  • 100 GB of disk space available

  • One of the following operating systems:

    • Ubuntu 10.04 LTS Server

    • Ubuntu 12.04 LTS Server

    • Red Hat Enterprise Linux (RHEL) 6.4, 6.5, 6.6, or 7.0
      Note: To install a JDS instance on a Linux operating system that is running on a virtual machine, you need a virtualization platform that provides SMBIOS information.

To manage JDS instances in the JSS, you need a valid SSL certificate on the JSS host server. (For more information, see SSL Certificate.)

Note: If you have upgraded from the Casper Suite v8.x, you must migrate the scripts and packages on your master distribution point before configuring JDS instances. (For more information, see the Migrating Packages and Scripts Knowledge Base article.)

Installing a JDS Instance on Mac

  1. Copy the JDS Installer for Mac (JDS Installer.pkg) to the server on which you plan to install a JDS instance.
    Note: To obtain the JDS Installer for Mac, log in to Jamf Nation and go to the following page: https://www.jamf.com/jamf-nation/my/products

  2. Double-click the installer.

  3. Follow the onscreen instructions to complete the installation.

Installing a JDS Instance on Linux

  1. Copy the JDS Installer for Linux (JDS Installer.run) to the server on which you plan to install a JDS instance.
    Note: To obtain the JDS Installer for Linux, log in to Jamf Nation and go to the following page:
    https://www.jamf.com/jamf-nation/my/products

  2. Log in to the server as a user with superuser privileges.

  3. Initiate the installer by executing a command similar to the following:

    sudo /path/to/JDS Installer.run

  4. When prompted, enter the JDS hostname. For example, “jds.mycompany.com”.

  5. When prompted, enter the JSS URL. For example, “https://jss.mycompany.com:8443/”.

  6. When prompted, enter credentials for a JSS user account with the “JDS” privilege.

  7. Follow the onscreen instructions to complete the installation.

Configuring a JDS Instance

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

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

  3. Click Server Infrastructure.

  4. Click JDS Instances images/download/thumbnails/16432771/JDS_Instances.png .

  5. Click the JDS instance you want to configure.

  6. Click Edit.

  7. Use the General pane to configure basic settings for the JDS instance.

  8. Click the Distribution Point tab and configure distribution settings.

  9. Click Save.

Replicating Files to the Root JDS Instance

During replication, all files on the master distribution point are replicated to the root JDS instance. Then, files are replicated to child JDS instances from their non-root parent instances on check in with the JSS. The files that are replicated to non-root JDS instances depend on whether each instance is configured to replicate specific files or the entire contents of their parent JDS instance.

  1. Open Casper Admin and authenticate to the JSS.

  2. In the sidebar, select the root JDS instance.

  3. Click Replicate.

Viewing the Progress of File Replication

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

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

  3. Click Server Infrastructure.

  4. Click JDS Instances images/download/thumbnails/16432771/JDS_Instances.png .

  5. Click Grid View images/download/thumbnails/16432771/Grid_View_icon.png at the top of the list.

The progress of file replication for each JDS instance is displayed. If your master distribution point is a JDS instance, it is marked with two asterisks (**). If your master distribution point is a different type of distribution point, the root instance is marked with a single asterisk (*).

Viewing Inventory Information for a JDS Instance

The JSS displays the following inventory information for each JDS instance:

  • Whether or not it is the master distribution point

  • Whether or not it is the root instance

  • Hostname

  • URL

  • Reported IP address

  • jamfds binary version

  • Operating system

  • Operating system version

  • Total memory

  • Available memory

  • Hard drive size

  • Hard drive used space

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

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

  3. Click Server Infrastructure.

  4. Click JDS Instances images/download/thumbnails/16432771/JDS_Instances.png .

  5. Click the JDS instance you want to view inventory information for.

Related Information

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

Network Segments
You can use network segments to ensure that computers and mobile devices use the closest distribution point by default.

For related information, see the following Knowledge Base articles:

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