|
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 | + On apt-based systems, download and install the release package for your OS from |
| 18 | + [apt.voxpupuli.org](https://apt.voxpupuli.org). For example, on Ubuntu 22.04: |
25 | 19 |
|
26 | | - The location for Puppet's executables is `/opt/puppetlabs/bin/`, which is not in your `PATH` environment variable by default. |
| 20 | + ```bash |
| 21 | + wget https://apt.voxpupuli.org/openvox8-release-ubuntu22.04.deb |
| 22 | + sudo dpkg -i openvox8-release-ubuntu22.04.deb |
| 23 | + sudo apt update |
| 24 | + ``` |
27 | 25 |
|
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. |
| 26 | + On yum/dnf-based systems, install the release package for your OS from |
| 27 | + [yum.voxpupuli.org](https://yum.voxpupuli.org). For example, on EL 9: |
29 | 28 |
|
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. |
| 29 | + ```bash |
| 30 | + sudo rpm -Uvh https://yum.voxpupuli.org/openvox8-release-el-9.noarch.rpm |
| 31 | + ``` |
31 | 32 |
|
32 | | - For more information, see details about [file and directory locations][where]. |
| 33 | + For other distributions and versions, see the full list of release packages on |
| 34 | + the respective repository pages or the [Installing OpenVox](https://voxpupuli.org/openvox/install/) page. |
33 | 35 |
|
34 | | -4. Install the `puppet-agent` package on your Puppet agent nodes using the command appropriate to your system: |
| 36 | +2. Install the package. |
35 | 37 |
|
36 | | - * Yum -- `sudo yum install puppet-agent` |
37 | | - * Apt -- `sudo apt-get install puppet-agent` |
38 | | - * Zypper -- `sudo zypper install puppet-agent` |
| 38 | + On apt-based systems: |
39 | 39 |
|
40 | | -5. (Optional) Configure agent settings. |
| 40 | + ```bash |
| 41 | + sudo apt update |
| 42 | + sudo apt install openvox-agent |
| 43 | + ``` |
41 | 44 |
|
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. |
| 45 | + On yum-based systems: |
43 | 46 |
|
44 | | - For other settings you might want to change, see a [list of agent-related settings][agent_settings]. |
| 47 | + ```bash |
| 48 | + sudo yum install openvox-agent |
| 49 | + ``` |
45 | 50 |
|
46 | | -6. Start the `puppet` service: `sudo /opt/puppetlabs/bin/puppet resource service puppet ensure=running enable=true`. |
| 51 | +3. Confirm that you can run the OpenVox executables. |
47 | 52 |
|
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` |
| 53 | + The public binaries are installed under `/opt/puppetlabs/bin`. Add that directory |
| 54 | + to your `PATH` for interactive use, or call the binaries with their full path. |
50 | 55 |
|
51 | | -8. Sign certificates on the certificate authority (CA) master. |
| 56 | + ```bash |
| 57 | + export PATH=/opt/puppetlabs/bin:$PATH |
| 58 | + ``` |
52 | 59 |
|
53 | | - On the Puppet master: |
| 60 | +4. Configure agent settings if needed. |
54 | 61 |
|
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. |
| 62 | + If the server is not reachable as `puppet`, set the `server` value in |
| 63 | + `puppet.conf`. For other commonly adjusted settings, see the |
| 64 | + [agent settings list][agent_settings]. |
57 | 65 |
|
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. |
| 66 | +5. Start and enable the agent service. |
| 67 | + |
| 68 | + ```bash |
| 69 | + sudo /opt/puppetlabs/bin/puppet resource service puppet ensure=running enable=true |
| 70 | + ``` |
| 71 | + |
| 72 | +6. Run a test check-in. |
| 73 | + |
| 74 | + ```bash |
| 75 | + sudo /opt/puppetlabs/bin/puppet agent --test |
| 76 | + ``` |
| 77 | + |
| 78 | +7. Sign the node certificate on the CA, if your deployment requires manual signing. |
| 79 | + |
| 80 | + ```bash |
| 81 | + sudo /opt/puppetlabs/bin/puppetserver ca list |
| 82 | + sudo /opt/puppetlabs/bin/puppetserver ca sign --certname <NAME> |
| 83 | + ``` |
| 84 | + |
| 85 | +If you are replacing Puppet packages on an existing host, back up `/etc/puppetlabs/` |
| 86 | +before you begin. OpenVox continues to use that configuration tree after installation. |
0 commit comments