APNS messaging for HCL Verse for iOS clients

HCL Traveler server can use Apple Push Notification service (APNs or APNS) for real time push notifications to keep your Mail, Calendar, Contact and To Do data on your HCL Verse for iOS/iPadOS and HCL To Do clients up to date.

Note: This does not apply to the Mail, Calendar and Contacts apps that are built into the Apple devices. For more information on customizing the notifications for those applications, see How do I customize my account?.

The HCL Traveler server attempts to communicate with the APNS service using the host api.push.apple.com on port 443. Make sure that any internal firewalls between the HCL Traveler servers and this external host allow this connection.

Checking status

A connection to the APNS server will only be active for each application in HCL Traveler if there is an active client Using APNS mode for auto sync.

Debugging Issues

Most APNS issues are related to proxies or firewalls in the network. You can test network connectivity including firewall settings by either
  1. sending a tell traveler push test message to a device registered with APNS or
  2. trying an HTTP request to https://api.push.apple.com/3/device/ in a web browser on the server that is connecting to the APNS server (either the HCL Traveler server or the proxy server).
  1. Identify a user with a device registered with APNS and send a test message via a tell command.
    1. If you don't already know a user with a device registered with APNS, find a user by:
      1. Issuing the tell traveler systemdump push command.
      2. opening the output file that systemdump created
      3. searching in the Listener Store section for a user with the Manufacturer Address and Manufacturer Provider ID set as needed.
    2. Confirm the user has the Manufacturer Address and Manufacturer Provider ID set as needed and get the device name by issuing the tell traveler push status <userName> command for the user name determined above.
    3. For the device name and user name determined above, issue the tell traveler push test * <deviceName> <userName> command.
  2. Trying https://api.push.apple.com/3/device/ in a web browser.

    The request will be for the wrong method, so a "successful" result is an HTTP 405 (Method Not Allowed) response.

On the Traveler server, run the command:
tell traveler push cmstatus
In the output, check for a section that looks similar to the following text.
Traveler: ########## Connection Notification Sender APNS (Tue Nov 04 06:50:43 EST 2025) ##########
Traveler: Description: Details about the connections to the Apple Push Notification Service (APNS) servers using the HTTP/2 interface.

For each active client, look for the connection in the Enabled or Disabled sub-sections. The HCL Traveler server will not attempt to contact APNS until it has a reason to do so.