Knowledge Base

Changing the name (hostname) or the IP address of a server is generally considered a high impact task and should be treated with some care (much more so than changing the IP of a workstation). Clients/workstations software (e.g. the PaperCut User Client) locate and communicate with the server by using a hostname and/or IP address stored in a configuration file. For correct operation, any hostname/IP address change should also be propagated to the following files:

• config.properties file located in the client directory (client connection information stored in the same directory as the client executable):
  On Server:

  [app-path]/client/win/config.properties

  [app-path]/client/linux/config.properties

  [app-path]/client/mac/PCClient.app/Contents/Resources/config.properties
  On Locally Installed Clients: [client-install-path]/config.properties
• connection.properties file located in the release directory (release station connection information):
  On Server: [app-path]/release/connection.properties
  On Locally Installed Stations: [client-install-path]/connection.properties
• The print provider config file located at: [app-path]/providers/print/win/print-provider.conf (Note: On windows, the print provider service must be restarted after changing this file)
• The print provider config file located on any secondary server or future installed secondary server.
• If the hostname is being changed and you would like to keep the same printer entries in PaperCut afterwards (i.e. to preserve settings and print history), then the printers in PaperCut must be renamed. See the article How to Rename a Printer for more details.

Also consider:

• The impact renaming the server may have on shared printers, or shared file paths.
• The URLs used to access the PaperCut server for remote administration may need to change - inform other administrators.
• Always take time to test the system in full after making the changes. You may find the PaperCut Post Upgrade Test Plan useful.

See also:

• How to Rename a Printer
• Migrating PaperCut to a New Server
• Migrating PaperCut to a New Server - when using external database

Categories: Configuration