This page describes the changes needed to change the host names of Enswitch machines. It is not exhaustive; in particular additional steps may be required at a Linux level if other software is installed. This page assumes that IP addresses will stay the same - if not more steps will be required.

The following updates are required at a Linux level:

  1. Change host name.
  2. Update /etc/hosts on all machines in the cluster.
  3. Update DNS.
  4. Update reverse DNS.
  5. If using HTTPS, install new SSL certificate.

The following updates are required at an Enswitch level:

  1. If running Enswitch 2.12 or later, update the "Online payment notification hostname" and/or "PayPal IPN URL" settings under System » Configuration.
  2. If running Enswitch 2.11 or earlier, update the "online_payment_notification_hostname" and/or "paypal_ipn_url" settings in /etc/enswitch/common.conf.
  3. Update System » Domains.
  4. Update System » Machines.
  5. Update the "SIP domain" custom setting for any rate plans with it set. If using provisioning, each Polycom telephone will need re-saved to regenerate its provisioning file. This does not apply to other manufacturers.
  6. If using heartbeat, update /etc/ha.d/ha.cf and /etc/ha.d/haresources.

When done, reboot all machines. When they come back up, check that:

  1. If using NFS, that all NFS filesystems are mounted.
  2. If using MySQL replication, that replication is running in both directions.
  3. Calls are routing.
  4. The web interface is working.