Data Manager - Puppet Adapter

Introduction

Puppet is a tool produced by Puppet that is used for software configuration management.

Puppet Adapter uses an API connection to bring data into Assets Data Manager.

How do I connect this tool to Assets Data Manager?

Follow this procedure to connect this tool to Assets Data Manager using the custom-built Adapter:

1. Gather all of the information listed in the Data Manager Fields section, such as the Name, Object class, Data Source Name, and Data Source Type.

2. Gather all of the information in the Puppet Fields section - this may require consultation with the subject matter expert (SME) for Puppet.

3. Within Data Manager:

   1. Create a new job by selecting the Adaptor that matches your tool.

   2. Configure all of the required fields with the appropriate information.

4. Within Puppet:

   1. Review the information in the API Call section, below, and ensure the endpoints are available.

   2. Review the information in the Fields Retrieved section, below.

Each time this job is run, the data your have selected will be brought into Data Manager using the configured Adapter and become raw data.

Data Manager Fields

You will need to specify the following information from Assets Data Manager:

1. Name - the name of the Connection, visible as the job name in Adapters.

2. Object Class - the name of the Object Class you want to the data to be loaded into.

3. Data Source Name - the type of data being created; which is usually the tool name, e.g AD, Qualys etc. Note: This can be the same as Name.

4. Data Source Type - what type of data is the tool providing? For example, Assets, CMDB, user location and more.

Puppet Fields

You will need to specify the following information from Puppet:

1. API URL - the Puppet instance URL to enable Data Manager to connect to the Puppet source.

2. Login Username - the Puppet API login username.

3. Password - the Puppet API password.

4. Product Type - the appropriate Puppet product type from the drop down list -

   1. Orchestrator v1

   2. Puppet Database Inventory v4

API Call

1. Orchestrator

   1. The client CLI directly calls the API to retrieve a list of inventories.

      1. API: {apiUrl}:8143/orchestrator/v1/inventory

      2. Method: GET

      3. Response:

         Name Connected Timestamp

          

2. Database Inventory

   1. The client CLI directly calls the API to retrieve a list of inventories.

   2. API: {apiUrl}:8081/pdb/query/v4/inventory

   3. Method: GET

   4. Response:

      Uuid Timestamp Environment PuppetMasterServer PuppetAgentPid PuppetVersion ServerNumber ClientCert Fqdn HostName Domain DomainDn City Timezone IsVirtual Virtual Kernel KernelRelease KernelVersion KernelMajVersion OsFamily OperatingSystem OperatingSystemRelease OperatingSystemMajRelease HardwareIsa HardwareModel Architecture ProcessorCount PhysicalProcessorCount Processor BiosVendor BiosVersion BiosReleaseDate BoardProductName BoardManufacturer BoardSerialNumber ChassisType ChassisAssetTag ProductName SerialNumber Manufacturer SwapSize SwapFree SwapSizeMb SwapFreeMb MemorySize MemoryFree MemorySizeMb MemoryFreeMb IpAddress IpAddress6 MacAddress Netmask Network Netmask6 Network6 IpaddressLo Ipaddress6Lo Network6Lo NetmaskLo NetworkLo Netmask6Lo UptimeDays UptimeHours UptimeSeconds