Configure compilers
Compilers must be configured to appropriately route communication between your primary server and agent nodes.
Before you begin:
- Install compilers and load balancers.
- If you need DNS altnames for your load balancers, add them to the primary server.
- Ensure port 8143 is open on the primary server or on any workstations used to run orchestrator jobs.
This procedure is not intended for installations with load
balancers in multiple locations. To configure compilers in multi-region installations,
refer to Load balancing for multi-region installations.
- Configure
pe_repo::compile_master_pool_address
to send agent install requests to the load balancer.- In the console, click Node groups, and in the PE Infrastructure group, select the PE Master group.
- On the Configuration data tab, select the pe_repo class, and set the value of the compile_master_pool_address parameter to the load balancer hostname. If you are using a single compiler, set the compile_master_pool_address value to the compiler's fully qualified domain name (FQDN).
- Click Add data and commit changes.
- Run Puppet on the compiler, and then on the primary server.
- Configure Puppet agents to connect orchestration
(PXP) agents to compilers through the load
balancer. You can configure these settings in the console or with Hiera.
- In the console, click Node groups, and in the PE Infrastructure group, select the PE Agent group.
- On the Classes tab, find the
puppet_enterprise::profile::agent class and specify
parameters:
Parameter Value manage_puppet_conf
Specify true
to ensure that your setting forserver_list
is configured in the expected location and persists through Puppet runs.pcp_broker_list
Specify hostnames for your load balancers. This setting configures PXP agents. Hostnames must include port 8142, for example: ["LOADBALANCER1.EXAMPLE.COM:8142","LOADBALANCER2.EXAMPLE.COM:8142"]
primary_uris
Specify hostnames for your load balancers, for example: ["LOADBALANCER1.EXAMPLE.COM","LOADBALANCER2.EXAMPLE.COM"]
This setting configures PXP agents and assumes port 8140 unless you specify otherwise, such as:
"LOADBALANCER1.EXAMPLE.COM:<PORT>"
server_list
Specify hostnames for your load balancers, for example: ["LOADBALANCER1.EXAMPLE.COM","LOADBALANCER2.EXAMPLE.COM"]
This setting configures Puppet agents and assumes port 8140 unless you specify otherwise, such as:
"LOADBALANCER1.EXAMPLE.COM:<PORT>"
- Remove any values set for pcp_broker_ws_uris.
- Commit changes.
- Run Puppet on the primary server, and then run
Puppet on all agents or install new
agents.
This Puppet run configures both Puppet agents and PXP agents to connect to the load balancer.
Related information