In-House eBooks

In-house eBooks are eBooks that are not available from the iBookstore. 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–9 and iBooks 1.0 or later

  • A computer with OS X v10.6–v10.11 and an application to view eBooks

To install an iBooks file, you need:

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

  • A computer with OS X v10.9–v10.11 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.
    Note: If you have not migrated users yet, click Mobile Devices at the top of the page.

  3. Click eBooks.
    On a smartphone or iPod touch, this option is in the pop-up menu.

  4. Click New images/download/thumbnails/11272429/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.
    If you have migrated users, you can add computers, mobile devices, and users as targets to the scope. If you have not migrated users yet, you can only add mobile devices as targets to the scope.
    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.

Editing or Deleting 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.
    Note: If you have not migrated users yet, click Mobile Devices at the top of the page.

  3. Click eBooks.
    On a smartphone or iPod touch, this option is in the pop-up menu.

  4. Click the eBook you want to edit or delete.

  5. Do one of the following:

    • To edit the eBook, click Edit and make changes as needed. Then click Save.

    • To delete the eBook, click Delete and then click Delete again to confirm.

For eBooks set to the “Install Automatically” distribution method, the edit action is applied to mobile devices in the scope the next time they check in with the JSS.

For eBooks set to the ”Make Available in Self Service” distribution method, the edit or delete action is applied 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.
    Note: If you have not migrated users yet, click Mobile Devices at the top of the page.

  3. Click eBooks.
    On a smartphone or iPod touch, this option is in the pop-up menu.

  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 JAMF Software, LLC 2016