In-House Books

In-house books are books that are not available from the iBooks Store. Jamf Pro allows you to distribute in-house books to computers, mobile devices, and users. Jamf Pro provides two distribution methods for in-house books: install the book automatically/prompt users to install the book (iOS only), or make the book available in Self Service. After a book is installed, users can view it with Apple’s iBooks app.

Before you distribute an in-house book, it is important to consider where the book will be hosted. There are two hosting locations that you can use for in-house books:

  • Distribution points—This hosting location is only available if your master distribution point is the cloud distribution point. To use this hosting location, you upload the book to the master distribution point when configuring settings for the book in Jamf Pro.
    Note: Books cannot be replicated to file share distribution points.

  • Web server—This hosting location is always available, regardless of what type of distribution point the master is. To use this hosting location, the book must be hosted on a web server before you distribute it. Then, when you distribute the book, you specify the URL where it is hosted.

When you distribute an in-house book, you configure settings for the book. Then, you specify the computers, mobile devices, and users that should receive it (called “scope”).

Note: In-house books cannot be distributed to personally owned mobile devices.

Requirements

To distribute an in-house book, the book must be one of the following types of files:

  • ePub file (.epub)

  • iBooks file (.ibooks)

  • PDF

To install an ePub file, you need:

  • A mobile device with iOS 4 or later and iBooks 1.0 or later

  • A computer with macOS 10.7 or later and an application to view books

To install an iBooks file, you need:

  • An iPad with iOS 5 or later and iBooks 2.0 or later

  • A computer with macOS 10.9 or later and iBooks 1.0 or later

Distributing an In-House Book

  1. Log in to Jamf Pro.

  2. Click Computers, Devices, or Users at the top of the page.

  3. Click eBooks.

  4. Click New images/download/thumbnails/18788688/Icon_New_Button.png .

  5. Select In-house eBook and click Next.

  6. Use the General pane to configure settings for the book, including the display name and distribution method.
    Note: If you choose "Make Available in Self Service" as the distribution method, the Make eBook managed when possible checkbox is selected by default. However, in-house books distributed to computers cannot be managed. For more information, see Managed Book Requirements.
    If your master distribution point is the cloud distribution point and you choose "Distribution Points" from the Hosting Location pop-up menu, be sure to upload the book file.

  7. Click the Scope tab and configure the scope of the book.
    For more information, see Scope.

  8. (Optional) Click the Self Service tab and configure the way the book is displayed in Self Service. You can customize the text displayed in the description for the book in Self Service by using Markdown in the Description field.
    For information about Markdown, see the Using Markdown to Format Text Knowledge Base article.
    Note: The Self Service tab is only displayed if “Make Available in Self Service” is chosen in the Distribution Method pop-up menu.

  9. Click Save.

For books set to the “Install Automatically” distribution method, books are installed the next time mobile devices in the scope check in with Jamf Pro. Users can view installed books with Apple's iBooks app.

For books set to the ”Make Available in Self Service” distribution method and books that cannot be installed automatically, books are available in Self Service for users to install the next time Self Service is launched.

Removing a Managed In-House Book from Mobile Devices

To remove a managed in-house book from one or more devices, you remove the mobile device or devices from the scope.

  1. Log in to Jamf Pro.

  2. Click Computers, Devices, or Users at the top of the page.

  3. Click eBooks.

  4. Click the book you want to remove.

  5. Click the Scope tab and remove mobile devices from the scope as needed.
    For more information, see Scope.

  6. Click Save.

The book is removed the next time the mobile devices check in with Jamf Pro.

Related Information

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

For related information, see the following Knowledge Base article:

Hosting In-House Books and Apps on a Tomcat Instance
Find out how to host in-house books on the Tomcat instance that hosts Jamf Pro.

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