|
1 | 1 | --- |
2 | 2 | layout: default |
3 | | -title: "Installing Puppet agent: Linux" |
| 3 | +title: "Installing OpenVox agent: Linux" |
4 | 4 | --- |
5 | 5 |
|
6 | | -[master_settings]: ./config_important_settings.html#settings-for-puppet-master-servers |
7 | 6 | [agent_settings]: ./config_important_settings.html#settings-for-agents-all-nodes |
8 | | -[where]: ./whered_it_go.html |
9 | | -[dns_alt_names]: /puppet/latest/configuration.html#dnsaltnames |
10 | | -[server_heap]: {{puppetserver}}/install_from_packages.html#memory-allocation |
11 | | -[puppetserver_confd]: {{puppetserver}}/configuration.html |
12 | | -[server_install]: {{puppetserver}}/install_from_packages.html |
13 | | -[modules]: ./modules_fundamentals.html |
14 | | -[main manifest]: ./dirs_manifest.html |
15 | | -[environments]: ./environments.html |
16 | | -[`puppet-agent`]: ./about_agent.html |
17 | 7 |
|
18 | | -Install the Puppet agent so that your master can communicate with your Linux nodes. |
| 8 | +Install `openvox-agent` on Linux nodes that will run the OpenVox agent service or |
| 9 | +use `puppet apply`. |
19 | 10 |
|
20 | | -**Before you begin**: Review the [pre-install tasks](./install_pre.html) and [installing Puppet Server][server_install]. |
| 11 | +**Before you begin:** Review the [pre-install tasks](./install_pre.html). If this |
| 12 | +node will connect to an OpenVox Server, make sure the server side is already installed |
| 13 | +and reachable. |
21 | 14 |
|
22 | | -1. Install a release package to [enable Puppet Platform repositories](./puppet_platform.html). |
| 15 | +1. Enable the OpenVox repository for your distribution. |
23 | 16 |
|
24 | | -2. Confirm that you can run Puppet executables. |
| 17 | + Follow the repository guidance on [OpenVox repositories and packages](./openvox_platform.html) |
| 18 | + or the published [Installing OpenVox](https://voxpupuli.org/openvox/install/) page. |
25 | 19 |
|
26 | | - The location for Puppet's executables is `/opt/puppetlabs/bin/`, which is not in your `PATH` environment variable by default. |
| 20 | +2. Install the package. |
27 | 21 |
|
28 | | - The executable path doesn't matter for Puppet services --- for instance, `service puppet start` works regardless of the `PATH` --- but if you're running interactive `puppet` commands, you must either add their location to your `PATH` or execute them using their full path. |
| 22 | + On apt-based systems: |
29 | 23 |
|
30 | | - To quickly add the executable location to your `PATH` for your current terminal session, use the command `export PATH=/opt/puppetlabs/bin:$PATH`. You can also add this location wherever you configure your `PATH`, such as your `.profile` or `.bashrc` configuration files. |
| 24 | + ```bash |
| 25 | + sudo apt update |
| 26 | + sudo apt install openvox-agent |
| 27 | + ``` |
31 | 28 |
|
32 | | - For more information, see details about [file and directory locations][where]. |
| 29 | + On yum-based systems: |
33 | 30 |
|
34 | | -4. Install the `puppet-agent` package on your Puppet agent nodes using the command appropriate to your system: |
| 31 | + ```bash |
| 32 | + sudo yum install openvox-agent |
| 33 | + ``` |
35 | 34 |
|
36 | | - * Yum -- `sudo yum install puppet-agent` |
37 | | - * Apt -- `sudo apt-get install puppet-agent` |
38 | | - * Zypper -- `sudo zypper install puppet-agent` |
| 35 | +3. Confirm that you can run the OpenVox executables. |
39 | 36 |
|
40 | | -5. (Optional) Configure agent settings. |
| 37 | + The public binaries are installed under `/opt/puppetlabs/bin`. Add that directory |
| 38 | + to your `PATH` for interactive use, or call the binaries with their full path. |
41 | 39 |
|
42 | | - For example, if your master isn't reachable at the default address, `server = puppet`, set the `server` setting to your Puppet master's hostname. |
| 40 | + ```bash |
| 41 | + export PATH=/opt/puppetlabs/bin:$PATH |
| 42 | + ``` |
43 | 43 |
|
44 | | - For other settings you might want to change, see a [list of agent-related settings][agent_settings]. |
| 44 | +4. Configure agent settings if needed. |
45 | 45 |
|
46 | | -6. Start the `puppet` service: `sudo /opt/puppetlabs/bin/puppet resource service puppet ensure=running enable=true`. |
| 46 | + If the server is not reachable as `puppet`, set the `server` value in |
| 47 | + `puppet.conf`. For other commonly adjusted settings, see the |
| 48 | + [agent settings list][agent_settings]. |
47 | 49 |
|
48 | | -7. (Optional) To see a sample of Puppet agent's output and verify any changes you may have made to your configuration settings in step 5, manually launch and watch a Puppet run: |
49 | | - `sudo /opt/puppetlabs/bin/puppet agent --test` |
| 50 | +5. Start and enable the agent service. |
50 | 51 |
|
51 | | -8. Sign certificates on the certificate authority (CA) master. |
| 52 | + ```bash |
| 53 | + sudo /opt/puppetlabs/bin/puppet resource service puppet ensure=running enable=true |
| 54 | + ``` |
52 | 55 |
|
53 | | - On the Puppet master: |
| 56 | +6. Run a test check-in. |
54 | 57 |
|
55 | | - 1. Run `sudo /opt/puppetlabs/bin/puppet cert list` to see any outstanding requests. |
56 | | - 2. Run `sudo /opt/puppetlabs/bin/puppet cert sign <NAME>` to sign a request. |
| 58 | + ```bash |
| 59 | + sudo /opt/puppetlabs/bin/puppet agent --test |
| 60 | + ``` |
57 | 61 |
|
58 | | - As each Puppet agent runs for the first time, it submits a certificate signing request (CSR) to the CA Puppet master. You must log into that server to check for and sign certificates. After an agent's certificate is signed, it regularly fetches and applies configuration catalogs from the Puppet master. |
| 62 | +7. Sign the node certificate on the CA, if your deployment requires manual signing. |
| 63 | + |
| 64 | + ```bash |
| 65 | + sudo /opt/puppetlabs/bin/puppetserver ca list |
| 66 | + sudo /opt/puppetlabs/bin/puppetserver ca sign --certname <NAME> |
| 67 | + ``` |
| 68 | + |
| 69 | +If you are replacing Puppet packages on an existing host, back up `/etc/puppetlabs/` |
| 70 | +before you begin. OpenVox continues to use that configuration tree after installation. |
0 commit comments