1. Overview

Starting with release 4.1.1.162, phone home data is used to learn about the usage of Payara Server.
This is part of work towards an automated Payara Server update facility.

Domains call our phone home server when they are started and then once again each day.

2. Documentation Conventions

${Product-Root} - This is the root of the Payara server directory, referring to where you have Payara installed.
${Domain} - This refers to the name of your Payara domain.
... - Denotes a skipping of unrelated code that would be present in the actual file or program.

3. What information is sent?

The following information is sent in each phone home call:

  • Payara Server version
  • Java Virtual Machine version
  • Domain uptime
  • Number of nodes in the domain
  • Number of instances in the domain

4. Phone Home Source Code

The phone home code is Open Source and available to view here.

5. Disabling Phone Home

By default, Phone Home activity is enabled.

It may be disabled by any of the following methods:

5.1 Disable Phone Home by removing the service file

  • Navigate to the ${Product-Root}/glassfish/modules directory.
  • Delete phonehome-bootstrap.jar.

5.2 Disable Phone Home using Asadmin

The command requires the Admin Server to be running, and will expect it to be listening on port 4848 unless specified differently with the --port asadmin utility option.

asadmin disable-phone-home

This command will also update the domain.xml with the change described below.

5.3 Disable Phone Home in the domain.xml file

  • Open up the domain.xml file in your text editor of choice, it can be found under ${Product_Root}/glassfish/domains/${Domain}/config/
  • Find the <config name="server-config"> tag
  • Add the tag <phone-home-runtime-configuration enabled="false"/>

6. Phone Home URL

Phone Home messages are sent to:

http://www.payara.fish/phonehome

results matching ""

    No results matching ""