Changing the Server Name or IP Address

KB Home   |   Changing the Server Name or IP Address

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 running PaperCut MF you may also need to reconfigure the MFDs to point to the new server address.
  • 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:


Categories: Configuration

Comments

Share your findings and experience with other PaperCut users. Feel free to add comments and suggestions about this Knowledge Base article. Please don't use this for support requests.

Article last modified on October 28, 2011, at 03:20 AM
Printable View   |   Article History   |   Edit Article