{"id":15014011,"url":"https://github.com/voxpupuli/puppet-amanda","last_synced_at":"2025-12-11T20:44:24.353Z","repository":{"id":921310,"uuid":"2171665","full_name":"voxpupuli/puppet-amanda","owner":"voxpupuli","description":"Puppet module for amanda","archived":false,"fork":false,"pushed_at":"2025-10-17T15:05:26.000Z","size":339,"stargazers_count":9,"open_issues_count":6,"forks_count":28,"subscribers_count":42,"default_branch":"master","last_synced_at":"2025-11-27T16:30:02.231Z","etag":null,"topics":["hacktoberfest","puppet"],"latest_commit_sha":null,"homepage":"https://forge.puppet.com/puppet/amanda","language":"PostScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/voxpupuli.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"open_collective":"vox-pupuli","github":"voxpupuli"}},"created_at":"2011-08-08T05:11:57.000Z","updated_at":"2025-10-17T15:05:28.000Z","dependencies_parsed_at":"2023-01-13T10:47:00.341Z","dependency_job_id":"ecbee4d2-b6b8-4669-a9cc-089d3218a28e","html_url":"https://github.com/voxpupuli/puppet-amanda","commit_stats":{"total_commits":211,"total_committers":31,"mean_commits":6.806451612903226,"dds":0.6161137440758293,"last_synced_commit":"8a9054bd035719d2e2db9502a67322931ea1b05b"},"previous_names":["pdxcat/puppet-module-amanda"],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/voxpupuli/puppet-amanda","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxpupuli%2Fpuppet-amanda","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxpupuli%2Fpuppet-amanda/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxpupuli%2Fpuppet-amanda/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxpupuli%2Fpuppet-amanda/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/voxpupuli","download_url":"https://codeload.github.com/voxpupuli/puppet-amanda/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voxpupuli%2Fpuppet-amanda/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":27669753,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-11T02:00:11.302Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacktoberfest","puppet"],"created_at":"2024-09-24T19:45:03.555Z","updated_at":"2025-12-11T20:44:24.331Z","avatar_url":"https://github.com/voxpupuli.png","language":"PostScript","funding_links":["https://opencollective.com/vox-pupuli","https://github.com/sponsors/voxpupuli"],"categories":[],"sub_categories":[],"readme":"# Amanda module for Puppet\n\n[![Build Status](https://travis-ci.org/voxpupuli/puppet-amanda.png?branch=master)](https://travis-ci.org/voxpupuli/puppet-amanda)\n[![Code Coverage](https://coveralls.io/repos/github/voxpupuli/puppet-amanda/badge.svg?branch=master)](https://coveralls.io/github/voxpupuli/puppet-amanda)\n[![Puppet Forge](https://img.shields.io/puppetforge/v/puppet/amanda.svg)](https://forge.puppetlabs.com/puppet/amanda)\n[![Puppet Forge - downloads](https://img.shields.io/puppetforge/dt/puppet/amanda.svg)](https://forge.puppetlabs.com/puppet/amanda)\n[![Puppet Forge - endorsement](https://img.shields.io/puppetforge/e/puppet/amanda.svg)](https://forge.puppetlabs.com/puppet/amanda)\n[![Puppet Forge - scores](https://img.shields.io/puppetforge/f/puppet/amanda.svg)](https://forge.puppetlabs.com/puppet/amanda)\n\n## Description\n\nProvides Amanda Network Backup server and client configuration through Puppet\n\n## Usage\n\nThe amanda module allows specifying parameterized classes that will do most of\nthe heavy lifting in a single definition (relying on sane defaults), or for\nmore custom configuration the utility defines can be used directly. What\nfollows is a minimal-effort configuration that trusts the module to figure out\nthe details.\n\n```puppet\nnode 'backup.cat.pdx.edu' {\n  class { 'amanda::server':\n    configs        =\u003e [ 'daily', 'archive' ],\n    configs_source =\u003e 'modules/data/amanda',\n  }\n}\n\nnode 'client.cat.pdx.edu' {\n  class { 'amanda::client':\n    server =\u003e 'backup.cat.pdx.edu',\n  }\n}\n```\n\nOf note is the `configs_source` parameter. While the amanda module will\ninstall and configure server and client machines, it does not yet attempt to build\namanda configs using puppet code. Rather, that legwork is still left up to the\nadministrator, and the module will only ensure that the files which comprise\nthe config are present on the server.\n\nIf you need to create configs from templates or other sources, then by setting\n`manage_configs_source` to `false` will disable extraction via the mechanism\nbelow, you are then free to assign puppet file resources as appropriate to\ncreate your configs.\n\nAdditional parameters are available for both the `amanda::server` and\n`amanda::client` classes which are not documented here. At present the only\nway to look up how to use them is to read the source.\n\n## How Configs Work\n\nUse the following Puppet DSL code to ensure the \"daily\" and \"archive\" configs\nare created on an amanda backup server.\n\n```puppet\nnode 'backup.cat.pdx.edu' {\n  file { '/etc/amanda':\n    ensure =\u003e directory;\n  }\n\n  amanda::config { 'daily':\n    ensure            =\u003e present,\n    configs_source    =\u003e 'modules/data/amanda',\n    configs_directory =\u003e '/etc/amanda',\n  }\n  amanda::config { 'archive':\n    ensure            =\u003e present,\n    configs_source    =\u003e 'modules/data/amanda',\n    configs_directory =\u003e '/etc/amanda',\n  }\n}\n```\n\nThen place your config files in the \"files\" directory of the module specified\nwith the `configs_source` parameter. For the code above, files that make up\nthe \"archive\" and \"daily\" amanda configs should be placed in the `data` module\nas per this example:\n\n    data\n    |-- files\n    |   `-- amanda\n    |       |-- daily\n    |       |   |-- amanda.conf\n    |       |   |-- chg-multi.conf\n    |       |   |-- disklist\n    |       |   `-- label-templates\n    |       |       |-- 3hole.ps\n    |       |       |-- 8.5x11.ps\n    |       |       |-- DIN-A4.ps\n    |       |       |-- DLT-A4.ps\n    |       |       |-- DLT.ps\n    |       |       |-- EXB-8500.ps\n    |       |       |-- HP-DAT.ps\n    |       |       `-- tapetypes.conf\n    |       `-- archive\n    |           |-- amanda.conf\n    |           |-- chg-scsi.conf\n    |           |-- disklist\n    |           `-- dumptypes.conf\n    |-- LICENSE\n    `-- README\n\nThe contents of the `config` directory (\"daily\" or \"archive\") will be synced\nas file resources to the location specified with the `configs_directory`\nspecified in the `amanda::config` resource. For the example above, the files\nwill be synced to the agent system as:\n\n    /\n    |-- etc\n    |   |-- amanda\n    |   |   |-- daily\n    .   |   |   |-- amanda.conf\n    .   .   |   |-- chg-multi.conf\n    .   .   |   |-- disklist\n        .   |   `-- label-templates\n            |       |-- 3hole.ps\n            |       |-- 8.5x11.ps\n            |       |-- DIN-A4.ps\n            |       |-- DLT-A4.ps\n            |       |-- DLT.ps\n            |       |-- EXB-8500.ps\n            |       |-- HP-DAT.ps\n            |       `-- tapetypes.conf\n            `-- archive\n                |-- amanda.conf\n                |-- chg-scsi.conf\n                |-- disklist\n                `-- dumptypes.conf\n\n## Additional Types\n\nBesides the primary classes `amanda::server` and `amanda::client`, three utility\ndefines are included in the module.\n\n### `Amanda::Amandahosts`\n\nThe `amanda::amandahosts` type manages the .amandahosts file, which controls\naccess to amanda services. The important parameter to this resource is\n`content`, and the user must specify the full access line to include. For\nexample,\n\n```puppet\namanda::amandahosts { 'replicator-amdump':\n  content =\u003e \"replicator.cat.pdx.edu backup amdump\",\n}\n```\n\n### `Amanda::Config`\n\nThe `amanda::config` type synchronizes a directory of files in a given module to\na client. A more detailed example is given in the preceding section.\n\n```puppet\namanda::config { 'daily':\n  ensure            =\u003e present,\n  configs_source    =\u003e 'modules/data/amanda',\n  configs_directory =\u003e '/etc/amanda',\n}\n```\n\n### `Amanda::Ssh_authorized_key`\n\nThe `amanda::ssh_authorized_key` type is a convenience define used to install\nssh authentication on an amanda client. The important parameter for this type\nis `key`.\n\n```puppet\namanda::ssh_authorized_key { 'replicator':\n  key =\u003e hiera('pubkey/backup@replicator'),\n}\n```\n\n### `Amanda::Disklist::Dle`\n\nThe `amanda::disklist::dle` type is used to add/remove disk list entries\nfrom the Amanda disklist(5) file, which is used by Amanda to determine which\ndisks will be backed up.\n\nRequirements:\n\n* Puppet `storeconfigs` must be enabled\n* `amanda::config` must be used to synchronize configuration files with the\n  `manage_dle` parameter set to `true`, i.e. `manage_dle =\u003e true`. This\n  must be set for each `amanda::config` if more than one has been configured.\n\n```puppet\namanda::disklist::dle { '/etc':\n   configs  =\u003e 'daily',\n   dumptype =\u003e 'dumptype',\n}\n\namanda::disklist::dle { '/var':\n   configs  =\u003e [ 'daily', 'weekly' ],\n   dumptype =\u003e 'dumptype',\n}\n\n```\n\n## Known Issues\n\n* The module does not include tests\n\n* The module does not allow overriding of the client/server package name(s)\n\n## Contributors\n\n* Darin Perusich \u003cdarin@darins.net\u003e\n* Jon Harker \u003cjesusaurus@cat.pdx.edu\u003e\n* Reid Vandewiele \u003cmarut@cat.pdx.edu\u003e\n* William Van Hevelingen \u003cblkperl@cat.pdx.edu\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoxpupuli%2Fpuppet-amanda","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvoxpupuli%2Fpuppet-amanda","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoxpupuli%2Fpuppet-amanda/lists"}