How IP address or host name changes affect collaboration services

Contacts service

Changing the IP address of a Contacts server doesn’t affect new connections to the server; however, it can disconnect existing client connections.

Changing the host name of a Contacts server necessitates restarting the service.

Calendar service

Calendar Server is based on the same underlying technology as the Address Book Server, so the needs are the same.

Changing the IP address of an Calendar server doesn’t affect new connections to the server; however, it can disconnect existing client connections.

Changing the host name of an Calendar server necessitates restarting the service.

Messages service

The Messages service is highly resilient to network and identity changes on the primary Ethernet port. No additional configuration is necessary if you changed the host name or IP address of the Messages server.

However, the Jabber IDs associated with the server don’t update to the new Messages server host name. For example, if you change the server from example.com to example.net, Joe’s Jabber ID (joe@example.com) doesn’t migrate to joe@example.net.

You can use the jabber_autobuddy tool to change the jabber IDs for service users. The tool modifies the database by changing the @host.com part of user names associated with the old domain to reflect the new domain, as well as secondary references (individual- and group-based buddies) that reference the old domain.

To migrate Jabber IDs, run the following commands:

sudo serveradmin stop jabbersudo jabber_autobuddy --move-domain old_domain new_domainsudo serveradmin start jabber

Additionally, the tool makes an automatic backup of the previous database (/Library/Server/Messages/Data/sqlite/jabberd2_bak.db), which can be stored or restored as needed.

Certificates for collaboration services

Contacts, Calendar, and Messages servers that use SSL need new certificates. You might need to regenerate or repurchase the certificates. Use the Server App to import the new certificates, then configure each service’s new certificate.