iOS printing (iPad & iPhone)

Sharing printers to iOS devices

1. Set up a Mac OS 10.8+ system to act as your iPad / iPhone print server. This can be your existing Mac print server (if it meets the system requirements), or a separate (secondary) print server (see Configure a Macintosh secondary print server for details).

2. Install the print queues and drivers for the printers you want to share to your iOS devices. These print queues should point directly to the printer, not another print server.

3. Test printing from a local application (e.g. Safari) to ensure that the drivers and printers are functioning correctly.

4. Install PaperCut. If you are setting up a secondary Mac print server (i.e. the primary PaperCut server is on another system), follow the steps at Configure a Macintosh secondary print server.

   Ensure that your Mac server is connected to the same subnet as the wireless network that the iOS devices will connect to. Without further configuration, the publishing protocol Bonjour broadcasts to the local subnet only and devices on other subnets will not see your printers.

   You can overcome the single subnet limitation by connecting your Mac server to multiple subnets. If you are using a cabled network, your Mac needs a separate Ethernet interface for each network connection. However, if you are using a wireless network, you can add multiple IP addresses, one for each subnet, to the same network interface. To add multiple addresses to a wireless interface:

   1. Open Network Preferences ( System Preferences > Network ); then select your wireless interface.

   2. Click the gear icon underneath the interface list; then select Duplicate Service.

   3. Enter a name for your new network; then click Duplicate.

   4. Select the duplicated network connection; then click Advanced.

   5. Click the TCP/IP tab; then select Configure IPv4 Manually.

   6. Enter an IPv4 address for the subnet you want to connect to.

      Your chosen IP address must be unique. Make sure you choose an IP address outside the DHCP address allocation range so there are no address conflicts. Alternatively, you can configure DHCP to permanently reserve the chosen address for your Mac Server. (DHCP configuration is normally performed on your network router.)

5. Share all the printers that you want to publish to iOS devices: System Preferences > Print & Scan > [select printer] > Share this printer on the network (to do this, Printer Sharing must first be enabled in the Sharing pane).

   

6. Run /Applications/PaperCut MF/Control Printer Monitoring.command; then choose to disable print tracking on the print queues that will be shared (see On Mac for details). This allows you to test iOS Printing functionality without PaperCut's monitoring involved (to limit what is being tested).

7. Print a document from your iOS device e.g. open Safari, load a web page, touch the "arrow" menu; then select Print. When selecting a printer, the queues shared from your Mac print server are displayed (if not, see Troubleshooting). The job should print correctly.

8. Test printing across a number of printers and apps such as Mail, Safari, Photos and iBooks / PDFs. Not all printers are capable of supporting all formats. Take the time to test and ensure the printers that you are making available produce acceptable results.

9. Re-enable PaperCut tracking using /Applications/PaperCut MF/Control Printer Monitoring.command (see On Mac for details).

You now need to install the iPad / iPhone app (Mobile web client) to print. See the next section for details.

The Mobile web client - web clip

The Mobile web client is required for printing to PaperCut managed printers. This tool authenticates each print job - effectively linking up users with their print jobs. It can also provide balance display, print job confirmation, Shared accounts selection and message notification.

Deployment

Deploying the Mobile web client on an iOS device involves the user accessing the following URL:

http://[primary-server]:9191/ios/install,

where [primary-server] is the preferred hostname or IP address of your primary PaperCut server.

Tip:

For easier distribution of the installation URL, try adding a link on an intranet page, sending it in an email or printing the URL on posters. It might help to add a short DNS name for your print server or even set up a simple redirect URL (e.g. http://myorg/ios/install > http://print-server.myorg.edu:9191/ios/install).

After accessing the installation URL on an iPad / iPhone (iOS device), an Install Profile dialog is displayed. Follow the prompts to create a Printing Web Clip to access the Mobile web client.

For alternative and advanced deployment options, see Advanced App Deployment.

Usage

The PaperCut Mobile web client is used to:

• Authenticate the user and their print jobs.

• Display the user's balance.

• Perform print job confirmation.

• Perform Shared accounts selection.

• Display Advanced scripting (print scripting) messages.

• Perform other functionality such as message notification.

The following examples illustrate typical usage of the App for a student (immediate print) and a staff member (account selection).

Scenario: Student printing

1. The student prints from their selected app.

   

2. The student closes the app and opens the Printing (PaperCut) app.

   

3. The student enters their username and password. On a personal device this step only needs to be performed once. Future logins are performed automatically through the use of an authentication cookie.

   

4. The student's print job is authentication and proceeds to print. The student can see their job's progress in the app.

   

Scenario: Staff printing (account selection)

1. The staff member prints from their selected app.

   

2. The staff member closes the app and opens the Printing (PaperCut) app.

   

3. The staff member enters their username and password. On a personal device this step only needs to be performed once. Future logins are performed automatically through the use of an authentication cookie.

   

4. The print job is authenticated and is ready for account selection. The account selection dialog is displayed.

   

5. The staff member selects their chosen shared account and touches Print. The job prints, and the staff member can see their job's progress in the app.

   

Troubleshooting & FAQ

Jobs won't print.

1. Are you printing double sided? Try turning double sided off. There seems to be issues with double sided printing on some iOS devices, as of iOS 5.0.1.

2. Try printing with PaperCut tracking disabled (using /Applications/PaperCut MF/Control Printer Monitoring.command) to help diagnose the problem (see On Mac for details).

My printers don't show up on the iOS devices when selecting a printer.

1. Ensure that the printers are shared on the Mac server.

2. Ensure that PaperCut is installed on the Mac server (primary or secondary server install).

3. It can take a few minutes before the printers show up on the iOS devices. Has it been that long since sharing the printers?

4. Ensure that the Mac server is on the same subnet as the iOS devices. Bonjour/mDNS, the protocol used to publish/advertise the print queues, is broadcasted only to the local subnet without further configuration (a "reflector", the configuration of which is beyond the scope of the documentation).

   You can overcome this limitation by connecting a wireless interface on your Mac server to multiple subnets. For more information, see Sharing Printers to iOS Devices.

5. Try rebooting the Mac server. This refreshes the list of available printers and restarts the Bonjour services that publish them.

My jobs do not show in the iPad / iPhone App.

PaperCut uses the IP address of your iOS device to determine which jobs to display. If you access PaperCut via a proxy server, the remote IP address might not be immediately accessible and jobs will not be displayed.

Some proxy servers retain the remote IP address in an X-Forwarded-For header. PaperCut can use this header to obtain the remote IP address, but for security reasons you must first add your proxy servers to PaperCut's list of trusted proxy servers.

In PaperCut's Admin web interface:

1. Go to Settings > Advanced > Security

2. Add the IP addresses of your proxy servers to the Trusted Proxy Servers list.

3. Click Apply.

Other users' jobs are showing up in the PaperCut iPad / iPhone App.

1. The IP addresses of the iOS devices must be unique. Ensure that the devices are not behind a NAT relative to the Mac print server sharing the print queues.

2. If just one other user's jobs are showing up, ensure that the DHCP lease times aren't too short.

I changed a printer's Location field and it's not reflected on the devices.

Changes to the printer's location and name are not reflected immediately. You might need to restart the system or services to promptly broadcast these changes.

Under what username do jobs from iOS devices arrive in the print queue?

guest. The CUPS web interface displays this username as Withheld.

Jobs are printing as [generic account], e.g. "guest".

Ensure that [generic account] is marked as Unauthenticated in PaperCut.

How do I uninstall / reinstall the PaperCut App on my iPad / iPhone?

1. Delete the Printing app (Web Clip) (hold your finger down over the app until the icons "go wobbly", then touch the cross icon next to the app).

2. Delete the Printing profile via Settings > General > Profile > Printing > Remove It is important that the app / Web Clip is deleted before deleting the profile (if not, problems have been reported such as multiple blank icons returning once the profile is reinstalled, as of iOS 5.0.1).

3. To reinstall, follow the installation procedure again.

How do I prevent a printer being shared?

See Limiting Printer Deployment.

How do I disable or re-enable iOS printing support on a Mac Print server?

There are two commands that you can run from the OS X termninal or the OS X Finder:

• [app-path]/providers/iosprint/mac/disable-iosprint.command. Stops (and disables) the iOS print service and creates a marker file that is used during susbquent upgrades to respect the iOS print status.

• [app-path]/providers/iosprint/mac/start-iosprint.command. Enables (and starts) the iOS print service and removes the marker file.

Can the PaperCut App for iPad / iPhone Printing display print scripting popups?

Yes. Scripting popups for the PaperCut App is possible.

Advanced iPad / iPhone printing setup

iPad / iPhone printing technical description

PaperCut for iPad / iPhone Printing works by providing four distinct parts:

1. PaperCut enables Mac OS's built-in Bonjour/mDNS publishing to advertise/publish PaperCut managed/tracked shared print queues, so that they are displayed in the Print menu on iOS devices (on the same network).

2. CUPS on Mac OS accepts print jobs (as PDF) and renders them into the queue's target printer language (generally PostScript).

3. PaperCut identifies the print jobs, generally arriving as user guest, as being unauthenticated. The device IP address is used to identify the device sending the print job.

4. The PaperCut App on the iOS device is used to authenticate the user from their device IP address, linking their print jobs with their username.

5. The App receives directions from the PaperCut server, such as to display print job details or account selection.

Limiting printer deployment

When PaperCut is installed on a Mac OS 10.8+ print server, all PaperCut MFmanaged and shared printers are published (made available) to iOS devices by default (see Sharing Printers to iOS Devices for details). If you want to share printers to OS X (desktop) systems but not to iOS devices, you can turn off broadcasting/advertising by adding "No iOS" anywhere in the printer's location field, then restarting the system e.g.:

1. Select System Preferences > Print & Scan > [select printer] > Options & Supplies > Location

2. In Location, enter the text "No iOS" te.g. "Lab G4.01 (No iOS)".

3. Restart the system for this change to take effect.

Advanced app deployment

Large deployments such as universities, school districts or corporations with organization-wide iPad / iPhone deployments might want to consider more advanced app deployment techniques. Other than the standard URL based (Configuration Profile) deployment covered in Deployment, there are several other deployment options, all of which are compatible with PaperCut:

• If you are using the iPhone Configuration Utility to distribute Configuration Profiles to your iOS devices, you can a Web Clip to them. Use a URL of the form http://[primary-server]:9191/ios. If you are using an SSL certificateSSL certificates are small data files that digitally bind a cryptographic key to an organization’s details, such as a company's domain name, your company name, your address, your city, your state and your country. When installed on a web server, it activates the padlock and the HTTPS protocol (over port 443) and allows secure connections from a web server to a browser. When a browser connects to a secure site it retrieves the site's SSL certificate and checks that it has not expired, it has been issued by a Certification Authority the browser trusts, and that it is being used by the website for which it has been issued. If it fails on any one of these checks the browser will display a warning to the end user letting them know that the site is not secured by SSL. SSL certificates can be either self-signed or CA signed. with PaperCut that is trusted by your iOS devices, you can use an HTTPS URL of the form https://[primary-server]:9192/ios. You can find an icon at http://[primary-server]:9191/images/icons2/72x72/web-client.png.

• If you are using a Mobile Device Management (MDM) server to send configuration to your iOS devices, you can add distribution of the PaperCut App as a Web Clip. Use a URL of the form http://[primary-server]:9191/ios. If you are using an SSLSecure Sockets Layer (SSL) is the standard security technology for establishing an encrypted link between a web server and a browser. This link ensures that all data passed between the web server and browsers remain private and integral. The protocol uses a third party, a Certificate Authority (CA), to identify one end or both end of the transactions. To be able to create an SSL connection a web server requires an SSL certificate. When you choose to activate SSL on your web server you will be prompted to complete a number of questions about the identity of your website and your company. Your web server then creates two cryptographic keys - a Private Key and a Public Key. certificate with PaperCut that is trusted by your iOS devices, you can use an HTTPS URL of the form https://[primary-server]:9192/ios. You can find an icon at http://[primary-server]:9191/images/icons2/72x72/web-client.png.

• You can access the PaperCut App for iOS devices from Safari using a URL of the form http://[primary-server]:9191/ios. From here, you can either continue to use the app in Safari, or select Add to Home Screen from the "arrow" menu. Launching the App from the home screen is recommended for the best experience.