Maintain your print environment with Print Deploy

As you know, your print environment is an ever changing one. You will add and decommission printers, change print queue settings, and change who has access to which printers. With Print Deploy, you can easily roll out print queue changes to your users.

Users

• Add or delete an IP range in a zone

• Add or remove user groups in a zone

• Add or change computers in a zone

• Change the order (priority) of zones

• Delete a zone

• Add a new subnet

Printers

• Add a print queue into Print Deploy

• Add a print queue or optional print queue to a zone

• Modify a print queue from optional install to automatic install

• Modify a print queue to be the default for the zone

• Remove a print queue as the default for the zone

• Remove a print queue from a zone and users' computers

• Handling scheduled or unscheduled printer maintenance

• Permanently delete a print queue from the Print queues list

• Replace a printer

• Update a printer driver

• Add finishing options

Administration

• Back up your Print Deploy configuration

• Migrate PaperCut NG/MF with Print Deploy to a different server

• I want to use my own SSL proxy for Print Deploy on a different port than normal

• Enable or disable auto-updates on the server

• Manually update the Print Deploy server to the latest version

• Stop/start or restart the Print Deploy Server service

• Stop/start or restart the Print Deploy clients

Add or delete an IP range in a zone

1. In the Your zones list, select the zone you want to work on; then click Edit zone, and Edit zone again.

2. In the Edit zone popup, under IP range select Selected range(s) and subnet(s).

3. Click Add new. A new field is added to the list.

   

4. To:

   • add an IP range, type the IP address or subnet details

   • delete an IP range, click the trash icon.

5. Click Save.

Add or remove user groups in a zone

To add users to a zone, the users must first exist in a group in PaperCut NG/MF. For general information about user groups in PaperCut NG/MF, including how to add, remove, and update user groups, take a look at Groups in PaperCut NG/MF.

If you delete a user from a group but you still want them to be able to print, make sure to add them to another group that is in the zone that the user needs to print from.

1. In the PaperCut NG/MF Admin web interface, click Groups; then check the Group List to ensure that the group(s) exists.

2. Click Enable Printing to go to the Print Deploy page.

3. In the Your zones list, select the zone you want to work on; then click Edit zone and select Edit zone.

4. In the Edit zone pop-up, under User groups select Selected user groups. A list of all PaperCut NG/MF groups is displayed.

   

5. Select/deselect the groups of users you want in the zone. These are the users who will receive the print queues that are connected to the zone.

   NOTE

   If you remove a group via the PaperCut NG/MF Admin web interface (Add/Remove groups) it is also removed from any zones that the group was applied to.

6. Click Save. The Print Deploy page is displayed with the groups listed above the Edit zone button.

7. Click Save and deploy. Print Deploy deploys the print queues to the users in the group(s).

   The print queues will be automatically installed or deleted on the computers within 15 minutes. This time is configurable though, which is described in Enhance Print Deploy security (optional).

Add or change computers in a zone

To target different computers for a zone you can use an industry standard regex expression to filter based on computer hostnames.

1. In the Your zones list, select the zone you want to work on; then click Edit zone, and Edit zone again.

2. In the Edit zone popup, under Hostnames select Computers matching this regex.

3. Enter a valid regex expression to the Hostname regex field.

4. Test your regex expression by filling out the Hostname test field with a real hostname. A green text field means a positive match, a red text field means a negative match.

   

Change the order (priority) of zones

Administrators can set the order (priority) of zones to ensure that the nominated default printer in the highest ordered Zone is set as the default on the end user's computer. This is particularly useful where printers available on a computer are across several zones.

You can sort the order by name, priority, or drag-and-drop.

1. In the Print Deploy admin interface, click Zones. The Your zones list is displayed.

   

2. If you want to sort by name, click the Sort by drop-down list and select Name. The zones are sorted.

3. If you want to sort by priority:

   • Click the Sort by drop-down list and select Priority. A vertical ellipses is displayed at the end of the row for each zone.

     

   • Do one of the following for each zone:

     • Click and drag the zone to its new place in the order.

     • Click the ellipses and click the appropriate direction until the zone is in the order you want it.

       

Delete a zone

1. On the Print Deploy admin interface, click Zones. The Your zones list is displayed.

2. Click the zone you want to delete.

3. Click Edit zone; then click Delete zone. A pop-up is displayed asking if you’re sure you want to delete the zone.

4. Click Delete.

   Print Deploy removes the zone from the list.

   NOTE

   The print queues will be uninstalled from users' computers the next time the computers call into the Print Deploy server.

Add a new subnet

If you've created a new VLAN on your site (for example, if you have a new branch office or campus with printers on site), you need to make sure there is a zone that includes that subnet range.

New subnets are included in any zone that specifies the IP range as All IP addresses (that is, do not restrict access based on IP address).

If you don't have a zone that specifies All IP addresses, you should set up a new zone to manage the printers available in that subnet, or you should add the new subnet range to an existing zone.

To add a subnet to a new zone

1. Click Add zone. The Add zone popup is displayed.

   

2. In Zone name, type a name that clearly reflects the where the zone is. For example, Melbourne Office Level 5.

3. Under IP range > Selected range, click Add

4. Enter one or more IP subnets (CIDR) or IP address ranges using the format x.x.x.x-y.y.y.y (for example, 0.0.0.0-255.255.255.254).

   Use a selected range if, for example, you want to set up a zone for each campus or building, and restrict access to the print queue outside of that campus or building.

   If you want to add multiple IP ranges, repeat the steps the above steps.

5. Click Save. Your new zone is added to the list of zones on the Print Deploy Admin interface.

To add a new subnet to an existing zone

1. In Your zones, select a zone.

2. Click Edit zone.

3. Under Selected range, click Add new.

4. Enter your IP range in one of the following formats:

   • CIDR, for example, 10.100.10.0/24

   • IP address with netmask, for example, 10.100.10.0:255.255.255.0

   • IP address range, for example, 10.100.10.0-10.100.10.254

5. Click Apply.

Add a print queue into Print Deploy

From time to time, you might want to add a new print queue to your environment. This could be for any number of reasons including:

• adding a new printer to your fleet

• adding a new finisher to an existing printer

• splitting an existing queue that allows both color and Black and White, into two separate queues; one for color, and one for Black and White.

To set up a new print queue:

1. Set up the print queue on your reference computer:

   • Computers that are joined to a local domain

   • Computers that are not joined to a local domain

   • Print serverless (Direct Print) environment

2. Run the cloner tool to upload the print queue information to the Application Server.

   TIP

   If you don't have the cloner tool available, or if it is not the latest version, download it again:

   1. Select Enable Printing > Print Deploy. The Print Deploy page is displayed.

   2. In the right panel, click the Add or update link.

   3. Click the download button for your operating system. The cloner tool (.exe, .dmg) is downloaded with the PaperCut NG/MF server address embedded into its filename.

3. Add the print queue to a zone.

   1. In the Admin web interface, click Enable Printing.

   2. In the Your zones drop-down list, select the zone containing the print queue.

   3. In the Print queues list, select a print queue.

   4. If you want the print queue to be optional for the user to install on their computer, at the bottom of the list select the Optional install checkbox. (Note: the optional checkbox is available in v1.3 and later. For Chromebook users, optional print queues is not applicable.)

   5. Click Connect to zone.

3. Click Save and deploy.

Add a print queue or optional print queue to a zone

1. Click Zones, then in the Your zones list, select the zone you want to connect printers to.

   If you need to add a new zone first, take a look at how to add zones and user groups to Print Deploy.

   

2. In the Print queues list, select which printers you want to be automatically installed on the users' computers; then click Connect to zone. They are added to the list of print queues for that zone.

   

3. If required, add print queues to the zone that you want to make optional for users to install on their computer. They can install them via the Add printers tab in their Print Deploy client.

   1. In the Print queues list, select which printers you want to make optional for users to install.

   2. At the bottom of the list of printers, select the Optional install checkbox.

      

   3. Click Connect to zone. They are added to the list of print queues for that zone.

      

Modify a print queue from optional install to automatic install

There are various ways to change an optional print queue to be automatically installed.

1. In the zone the optional printer is connected to, find the print queue in the list; then either:

   • click the Optional install badge

   • click the ellipses button; then select Set as automatic install.

2. Click Save and deploy.

Modify a print queue to be the default for the zone

Only one printer at a time may be defined as a default printer for a zone.

1. In the zone the printer is connected to, find the print queue in the list that you want to set as default.

2. Click the ellipses button; then select Set as default for zone. The default badge is displayed.

   

3. Click Save and deploy.

Remove a print queue as the default for the zone

1. In the zone the default printer is connected to, find the print queue in the list; then do one of the following:

   • Click the ellipse menu button; then select Remove default for this zone.

   • Click the Default badge.

   • Click the ellipse menu button on a different printer; then select Set as default for zone. This will change the default printer to the selected one.

2. Click Save and deploy.

Remove a print queue from a zone and users' computers

Sometimes you might need to remove a print queue from use in a certain print environment but keep it in the Print queue list for use elsewhere. For example, remove a color print queue because you no longer want a department to print in color.

To do this you need to delete the printer from the relevant zone(s), but keep it in the Print Queues list.

1. In the Admin web interface, click Enable Printing.

2. In the Your zones drop-down list, select the zone containing the print queue.

3. Click the ellipses menu at the right of the print queue you want to remove; then click Remove print queue.

NOTE

If the printer is in more than one zone, repeat these steps for each zone.

4. Click Save and deploy.

This uninstalls the print queue from users’ computers that are in those zones.

Handling scheduled or unscheduled printer maintenance

Sometimes you might want to temporarily make one of your printers unavailable. For example, if a printer is offline, you can temporarily hide its print queues so that your users don't try to print to it.

To hide a print queue:

1. In the Admin web interface, click Enable Printing.

2. In the Your zones drop-down list, select the zone containing the print queue.

3. Click the ellipses menu at the right of the print queue you want to remove; then click Remove print queue.

NOTE

If the printer is in more than one zone, repeat these steps for each zone.

4. Click Save and deploy.

When the printer is back online:

1. Open the zone again.

2. Select the printer; then click Connect.

3. Click Save and deploy.

   The Print Deploy clients installed on end users' computers will retrieve the updated list of print queues the next time they contact the Application Server.

Permanently delete a print queue from the Print queues list

An example of when you'd want to permanently delete a printer is when you're decommissioning an old printer.

1. In the Admin web interface, click Enable Printing.

2. In the Print queues list, click the ellipses button at the right of the print queue you want to remove; then click Delete print queue.

   A message is displayed warning you that the print queue will be permanently deleted from the list and removed from any zones that it's been connected to.

3. Click Delete.

   A message is displayed at the top of the Print queues list confirming that the print queue has been deleted.

Replace a printer

Every organization will replace their printers over time. This might happen because a single printer is getting a bit long in the tooth, or maybe you are undergoing a fleet refresh.

To replace a printer when the new printer is using the same driver:

1. Configure the new printer with the same network address as the old printer. The print queues that were deployed for the old printer will work for the new one.

To replace a printer when the new printer uses a different driver, but the printer should maintain the same name as the old printer:

1. On the reference computer, set up a test print queue with a different name to the printer that will be decommissioned.

2. Run the cloner tool.

3. Deploy the print queue to a test computer by connecting the printer to a test zone.

4. If you are happy with the deployment, then update the name of the print queue on the reference computer to match the name of the original printer that is being decommissioned.

5. Run the cloner tool again.

   The existing print queue is updated and the change is automatically deployed to end users. There is no need to Save and deploy the zone again.

Update a printer driver

New versions of printer drivers are continually released. When they are available, you should make sure you update your print queues to use the latest version.

To update your printer drivers:

1. On the reference computer, set up a test print queue with a different name to the previous print queue.

2. Run the cloner tool.

3. Deploy the print queue to a test computer by connecting the printer to a test zone.

4. If you are happy with the deployment, then update the name of the print queue on the reference computer to match the name of the original printer queue.

5. Run the cloner tool again.

   The existing print queue is updated and the change is automatically deployed to end users. There is no need to Save and deploy the zone again.

Add finishing options

You might want to change the default finishing options, or even prevent some users from selecting particular finishing options. For example, you might decide you don't want students to be able to do stapling, but you do want this functionality available to staff.

To change the finishing options available in a print queue:

1. Add the finishing options to the print queue on the reference computer. For advanced finishing options, configure the capabilities under:

   • Printer Properties > General > Preferences

   • Printer Properties > Advanced > Printing Defaults

   Some printer drivers may have settings available in the following tabs:

   • Printer Properties > Device Settings (example: hp)

   • Printer Properties > Configuration (example: fuji-xerox)

   • Printer Properties > Optional Settings (example: epson)

2. Test that printing works on each print queue.

3. Rerun the PaperCutPrint Deploy cloner tool. It automatically updates the end users' print queues with the new finishing options so there is no need to Save and deploy the zones again.

   TIP

   If you don't have the cloner tool available, or if it is not the latest version, download it again:

   1. Select Enable Printing > Print Deploy. The Print Deploy page is displayed.

   2. In the right panel, click the Add or update link.

   3. Click the download button for your operating system. The cloner tool (.exe, .dmg) is downloaded with the PaperCut NG/MF server address embedded into its filename.

Back up your Print Deploy configuration

The files created and used for Print Deploy are not included in the weekly PaperCut NG/MF backups. Instead the Print Deploy configuration files are archived weekly to the following locations:

Windows Application server

<install path>\providers\print-deploy\win\data\backups\

Mac Application server

<install path>/providers/print-deploy/mac/data/backups/

Linux Application server

<install path>/providers/print-deploy/linux/data/backups/

Migrate PaperCut NG/MF with Print Deploy to a different server

If you are using Print Deploy to deploy print queues in your organization, follow the steps below.

1. In the original server, navigate to the Print Deploy directory

   Windows

   [application-directory]\providers\print-deploy\win

   macOS

   [application-directory]/providers/print-deploy/mac

   Linux

   [application-directory]/providers/print-deploy/linux

2. Copy the entirety of the data folder

3. Go to the new server you’re migrating to and stop the Print Deploy server

4. Paste the data folder onto the same directory of Print Deploy in the new server, i.e., [application-directory]/providers/print-deploy/<os>. Overwrite any existing files.

5. Start the Print Deploy server.

   IMPORTANT

   If the server you are migrating to has a different IP address or hostname from your original server, you will need to redeploy the clients with the new server’s hostname. We recommend that you redownload the client from your new server to ensure your clients are also up to date.

   Note that reinstalling or uninstalling the clients won’t remove the print queues already installed on your users’ computers; users can still print to all queues already deployed by Print Deploy.

6. To test and confirm the migration, in the new server, log in to the PaperCut NG/MF page as an admin.

7. Navigate to Enable Printing > Print Deploy tab.

8. Check that you can see your old zones and print queues in the interface.

9. On a client’s machine, check that the Print Deploy client is now pointing to the new address of the server:

   1. Open [PaperCut Print Deploy Client app directory] /data/config/client.conf.toml.

   2. Check that the key named ServerBaseURL is set to the new server’s hostname.

   3. If not, uninstall all the clients first and redeploy.

Restore your Print Deploy configuration

The folder and data structure of Print Deploy is quite simple. To restore a previous configuration, follow the steps below.

1. On the server you’re restoring, stop the Print Deploy server.

2. Navigate to the Print Deploy install directory.

   Windows

   [application-directory]\providers\print-deploy\win\

   macOS

   [application-directory]/providers/print-deploy/mac/

   Linux

   [application-directory]/providers/print-deploy/linux/

   Rename the data folder to data.old or similar.

3. Navigate to the Print Deploy backup directory.

   Windows

   [application-directory]\providers\print-deploy\win\data\backups\

   macOS

   [application-directory]/providers/print-deploy/mac/data/backups/

   Linux

   [application-directory]/providers/print-deploy/linux/data/backups/

4. Locate the appropriate ZIP file corresponding to a recent backup. The backup filename is in the following format:

   backup-YYYYMMDDHHmmSS.zip

   Example: backup-20200219161100.zip

5. Use your preferred ZIP file handling program to extract the data folder to the Print Deploy install directory

6. On the server you’re restoring, start the Print Deploy server and confirm you configuration has been restored.

I want to use my own SSL proxy for Print Deploy on a different port than normal

Some organizations might want to use a proxy or SSL/TLS termination service as a front end to as many products as possible. For example, managing SSL/TLS certificates in many different systems might be difficult and the organization prefers to have a SSL/TLS terminiation service or device handle all SSL/TLS certificates.

You can configure the Print Deploy client to use an Administrator-specified SSL/TLS port while the Print Deploy Server service remains unchanged. In addition, you can configure the Print Deploy client to use a custom SSL/TLS port for Mobility Print print queues.

This is an advanced configuration setting that's made in the client.conf.toml file. It's expected that system administrators undertake this with an existing proxy or SSL/TLS infrastructure in place.

The config values that change the SSL/TLS ports in use are:

• AccessibleMobilityPrintTLSPort = 9164
• AccessiblePrintDeployTLSPort = 9174

1. Update the config values in the client.conf.toml file, located in: <PaperCut NG\MF installation folder>\providers\print-deploy\<os>\data\config\client.conf.toml

2. Restart the PaperCut Print Deploy Server service.

Enable or disable auto-updates on the server

Auto-updates are automatically disabled if there are no printers imported and no additional zones created. To enable auto-updates:

• Clone your first print queue. To learn more, see How Print Deploy works—the basics

Or

1. Click Enable Printing to go to the Print Deploy page.

2. Click the About button (top-right corner of the page) and toggle updates On.

   

   The updated downloads in the background. The time taken varies based on internet speeds. The service will then update and restart.

3. Click Close.

You can enable or disable updates at any time.

Manually update the Print Deploy server to the latest version

The Print Deploy server updates automatically within a day after a new version is released.

To update immediately, we recommend you Enable or disable auto-updates on the server.

If you must manually do the update, you can trigger the auto-update as follows:

1. On the Application Server, run the terminal or command prompt with administrative privileges and navigate to <PaperCut MF/NG install directory>/providers/print-deploy/<os>/.

   This directory contains an executable binary called pc-updater.

2. Run the following command:

   Windows

   pc-updater.exe https://update.print-deploy.cloud.papercut.com/client-version/v3/check-update/pc-print-deploy-server/win

   macOS

   Run the command below as the user papercut.

   ./pc-updater https://update.print-deploy.cloud.papercut.com/client-version/v3/check-update/pc-print-deploy-server/macos

   Linux

   Run the command below as the user papercut.

   ./pc-updater https://update.print-deploy.cloud.papercut.com/client-version/v3/check-update/pc-print-deploy-server/linux-gnu

   Your server is updated to the latest version.

3. If you want to find out what the latest version is, go to the Print Deploy release notes page.

The clients may take another 24-48 hours after the server has updated, depending on their connectivity to the Print Deploy server.

Stop/start or restart the Print Deploy Server service

Some configuration changes require that you to stop/start or restart the Print Deploy Server service for the changes to take effect.

Windows

1. Open Windows Services.

2. Right-click PaperCut Print Deploy Server; then click the action you require.

macOS

1. Open the Activity Monitor.

2. Click View > All Processes.

3. Select pc-print-deploy; then click Quit.

The Print Deploy services will automatically start up again.

For starting and stopping the Print Deploy Server, run the following commands:

• Start: sudo launchctl load /Library/LaunchDaemons/papercut-print-deploy.plist

• Stop: sudo launchctl unload /Library/LaunchDaemons/papercut-print-deploy.plist

Linux

On Linux, simply run the following commands consecutively:

• Stop: sudo systemctl stop pc-print-deploy

• Start: sudo systemctl start pc-print-deploy

Stop/start or restart the Print Deploy clients

Rarely, some configuration changes require you to stop/start or restart the Print Deploy clients for the changes to take effect.

Windows

1. Open Windows Services.

2. Right-click PaperCut Print; then click the action you require.

macOS

1. Open finder to Applications > Print Deploy Client.

2. Double-click the Restart.command.

3. Enter your password when prompted.

   The Print Deploy services will automatically start up again.