Deploy App Settings to Linux Endpoints
Focus
Focus
GlobalProtect

Deploy App Settings to Linux Endpoints

Table of Contents

Deploy App Settings to Linux Endpoints

Customize GlobalProtect app settings in pre-deployment configuration file for deploying to Linux endpoints.
You can set the GlobalProtect app customization settings in the pre-deployment configuration file (pangps.xml). This enables deployment of GlobalProtect app settings to Linux endpoints prior to their first connection to the GlobalProtect portal.
On Linux endpoints, the pre-deployment configuration file (pangps.xml) is located in /opt/paloaltonetworks/globalprotect.
The following table lists the pre-deployment settings for Linux endpoints that you can add to the pangps.xml file to customize the behavior of the GlobalProtect app and how the user interacts with the GlobalProtect app.
Portal Agent Configuration
Linux
Default
Connect Method
connect-method on-demand | user-logon
user-logon
Allow User to Change Portal Address
can-change-portal yes | no
yes
Allow User to Continue with Invalid Portal Server Certificate
can-continue-if-portal-cert-invalid yes | no
yes
Use Default Browser for SAML Authentication
default-browser yes | no
no
Portal Connection Timeout (sec)
portal-timeout <portaltimeout>
5
TCP Connection Timeout (sec)
connect-timeout <connect-timeout>
5
TCP Receive Timeout (sec)
receive-timeout <receive-timeout>
30
Not in portal
This setting specifies the default portal IP address (or hostname).
Portal <IPaddress>
n/a
If you have already installed the GlobalProtect app on the Linux endpoint, follow these instructions:
  1. Stop the GlobalProtect VPN daemon. Use the sudo systemctl stop gpd.service command.
    user@linuxhost:~$ sudo systemctl stop gpd.service
  2. Add the pre-deployment settings to the pangps.xml file in /opt/paloaltonetworks/globalprotect.
  3. Modify the pre-deployment setting you want to edit for the pangps.xml file in /opt/paloaltonetworks/globalprotect.
  4. Reboot the Linux endpoint in order for the pre-deployment configuration changes to take effect.
If you are installing the GlobalProtect app for the first time, follow these instructions to deploy various settings to the Linux endpoint.
  1. Create the /opt/paloaltonetworks/globalprotect/pangps.xml pre-deployment configuration file.
  2. Add the pre-deployment settings to the pangps.xml file, including the connect method for the GlobalProtect app and the default browser for SAML authentication.
    The following example shows the XML configuration of the pre-deployment changes that you deployed on the Linux endpoint, including the portal IP address (or hostname) under <PanSetup>.
    <?xml version="1.0" encoding="UTF-8"?>
    <GlobalProtect>
          <Settings>
              <connect-method>on-demand</connect-method>
              <can-continue-if-portal-cert-invalid>yes</can-continue-if-portal-cert-invalid>
              <can-change-portal>no</can-change-portal>
              <portal-timeout>100</portal-timeout>
              <connect-timeout>100</connect-timeout>
              <receive-timeout>100</receive-timeout>
              <default-browser>yes</default-browser>
          </Settings>
          <PanSetup>
              <Portal>portal.acme.com</Portal>
          </PanSetup>
          <PanGPS>
          </PanGPS>
    </GlobalProtect>