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.

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.

Catagory: Configuration

Page last modified on March 23, 2008, at 08:17 PM