In-House eBooks

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

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

  • Distribution points—This hosting location is only available if your master distribution point is a JDS instance or the cloud distribution point. To use this hosting location, you upload the eBook to the master distribution point when configuring settings for the eBook in the JSS.
    Note: eBooks 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 eBook must be hosted on a web server before you distribute it. Then, when you distribute the eBook, you specify the URL where it is hosted.

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

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

Requirements

To distribute an in-house eBook, the eBook 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 eBooks

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 eBook

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

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

  3. Click eBooks.

  4. Click New images/download/thumbnails/15181964/New_icon.png .

  5. Select In-house eBook and click Next.

  6. Use the General pane to configure settings for the eBook, 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 eBooks distributed to computers cannot be managed. For more information, see Managed eBook Requirements.
    If your master distribution point is a JDS instance or the cloud distribution point and you choose "Distribution Points" from the Hosting Location pop-up menu, be sure to upload the eBook file.

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

  8. (Optional) Click the Self Service tab and configure the way the eBook is displayed in Self Service. You can customize the text displayed in the description for the eBook in Self Service by using Markdown in the Description field.
    For information about Markdown, see the following Knowledge Base article:
    Using Markdown to Format Text
    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 eBooks set to the “Install Automatically” distribution method, eBooks are installed the next time mobile devices in the scope check in with the JSS. Users can view installed eBooks with Apple's iBooks app.

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

Removing a Managed In-House eBook from Mobile Devices

To remove a managed in-house eBook from one or more devices, you remove the mobile device(s) from the scope.

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

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

  3. Click eBooks.

  4. Click the eBook 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 eBook is removed the next time the mobile devices check in with the JSS.

Related Information

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

For related information, see the following Knowledge Base article:

Hosting In-House eBooks and Apps on a Tomcat Instance
Find out how to host in-house eBooks on the Tomcat instance that hosts the JSS.

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