# puppet-pbis

Joins a node to an Active Directory domain using PowerBroker Identity Services Open Edition (PBIS).

## Usage

    node 'workstation' {
      class { 'pbis': 
        ad_domain             => 'ads.example.org',
        bind_username         => 'admin',
        bind_password         => 'password',
        ou                    => 'ou=Computers,ou=Department,ou=Divison',
        user_domain_prefix    => 'ADS',
        require_membership_of => 'ADS\\Linux_Users',
        version               => "8.5.1-206"
      }
    }

## Distributing PBIS Open packages

This module supports two ways of distributing the PBIS Open packages:

1. using Puppet's built-in fileserver, and
2. as `package` resources using an external repository.

The default is to use Puppet's built-in fileserver.

In either case, download the necessary packages from the [BeyondTrust Repo website](https://repo.pbis.beyondtrust.com/).
You can access the x86_64 RPMs directly, for example: (https://repo.pbis.beyondtrust.com/yum/pbiso/x86_64/Packages/)

### Using Puppet's built-in fileserver

Rename the `pbis-open` package files according to the following convention:

    pbis-open.amd64.deb
    pbis-open.i386.deb

    pbis-open.x86_64.rpm
    pbis-open.i386.rpm
    
and place them in the module's `files/` folder.

### Using an external repository

For scalability, or if you are using variable module paths, you may want to add the PBIS Open packages to a local `apt` or `yum` repository.

In that case, sync with the [BeyondTrust Public Repo](https://repo.pbis.beyondtrust.com), and set $yum_install => true (the default)

### Service name change.

The service name was changed from 'lsass' to 'lwsmd' in Likewise Open 6.0, and therefore all versions of PBIS. This is now configurable as below:

    node 'workstation' {
      class { 'pbis':
        ...
        service_name => 'lwsmd',
      }
    }

## Dependencies

This module requires the `osfamily` fact, which depends on Facter 1.6.1+.
This module requires the 'wget' module, which you can get via: `puppet module install maestrodev-wget --version 1.7.3`

## Supported platforms

This module has been tested against Puppet 2.7.18+ and Facter 1.6.9+ on Debian 7 and Ubuntu 12.04.

Support for RedHat and Suse is included and has been tested 2016-11-16.

## Contributing

Please open a pull request with any changes or bugfixes.

## History

Likewise Open was acquired by BeyondTrust in 2011 and rebranded as PowerBroker Identity Services Open Edition. The project page is at [powerbrokeropen.org](http://www.powerbrokeropen.org).

The original Likewise Open package is included in the Ubuntu repositories, but has not been updated in years.