Master - Agent

Follow the instructions below to manually setup your Puppet Master and Puppet Agent environment.

Step 1 - Setup two instances

These instances can be either two cloud instances, two physical computer instances, or two local Virtual Machine (VM) instances. You should be able to SSH into both of the instances. Configure one instance as the Puppet Master and the other as Puppet Agent.

Step 2 - Setup Puppet Master and Puppet Agent

Follow the instructions below to initially install and then configure the Puppet Master and Puppet Agent respectively.

2.1. Install Puppet

Puppet Master
Follow the instructions below to install Puppet Master.

Sign into Puppet Master as the super user.

Issue the following commands. Please refer the inline comments to identify the reason behind executing these commands.

# Sync time between the Master and the Agent
ntpdate pool.ntp.org ; apt-get update && sudo apt-get -y install ntp ; service ntp restart  
cd /tmp  
 
# Download and install the Puppet distribution
wget https://apt.puppetlabs.com/puppetlabs-release-trusty.deb  
dpkg -i puppetlabs-release-trusty.deb  
apt-get update  
apt-get install puppetmaster

Check the Puppet version
```
 puppet -V
```
The Puppet version should be 3.8.3 or higher.
Edit the /etc/hostname file and set the property hostname.
```
[puppet-master-ip] puppetmaster
```
Edit your Puppet Master hosts file, which is /etc/hosts, as follows and set the Puppet Master hostname.
```
127.0.0.1 localhost
127.0.0.1 puppetmaster 
```

Puppet Agent
Follow the instructions below to install Puppet Agent.

1. Sign into Puppet Agent as the super user.
2. Issue the following commands to download and install the Puppet distribution.
```
apt-get update  
apt-get install puppet
```
3. Edit the /etc/hostname file and set the property hostname.
```
{host-ip}  qaa-node-1
```
4. Edit the /etc/hosts file of your Puppet Agent.
```
127.0.0.1 localhost  
192.168.19.XXX puppet # Puppet Master's IP address 
```

2.2. Configure Puppet

Puppet Master
Follow the instructions below to configure the Puppet Master.

1. Sign into the Puppet Master as the super user.
2. Create the following directory.
  /etc/puppet/environments/production
3. Modify the /etc/puppet/puppet.conf file that corresponds to the Puppet Master by appending the following to the [main] and [master] sections accordingly.
```
[main]
dns_alt_names=puppetmaster,puppet
environmentpath = $confdir/environments
hiera_config = /etc/puppet/hiera.yaml
[master]
autosign=true
```
4. Before restarting the Puppet Master, clean all certificates, including Puppet Master’s certificate which has its old DNS alt names.
```
puppet cert clean --all
```
5. Restart the Puppet Master for new configuration changes to take effect and to regenerate the certificate with the new dns_alt_names.
```
service puppetmaster restart
```
6. Download the Puppet Module Git repository files to a temporary folder.
```
git clone https://github.com/wso2/puppet-modules.git <LOCAL_FOLDER_PATH>
```
7. Prepare Puppet Modules as follows:
  1. Copy all the modules in <PUPPET_MODULES_HOME>/modules directory to the /etc/puppet/environments/production/modules/ directory.
  2. Install the Java module from puppetforge.
    puppet module install 7terminals-java
  3. Install the stdlib module from puppetforge.
    puppet module install puppetlabs-stdlib
8. Prepare Hieradata.
  1. Copy the <PUPPET_MODULES_HOME>/hiera.yaml file to the /etc/puppet directory.
  2. Edit the hiera.yaml file YAML data directory location as follows:
    :yaml: :datadir: "/etc/puppet/hieradata/%{::environment}"
  3. Copy the <PUPPET_MODULES_HOME>/hieradata folder to the /etc/puppet directory.
  4. Rename the /etc/puppet/hieradata/dev directory to the /etc/puppet/hieradata/production directory.
9. Prepare the site.pp manifest.
  Copy the <PUPPET_MODULES_HOME>/manifests/site.pp file to the /etc/puppet/environments/production/manifests directory.
10. Prepare the files/packs.
  1. Copy the pack file (e.g, wso2am-1.9.1.zip) into the /etc/puppet/environments/production/modules/wso2am/files directory.
  2. Copy the JDK installation file (e.g., jdk-7u79-linux-x64.gz) into the /etc/puppet/modules/wso2base/files directory.
  3. Add the JDK version (home) and filename information to the /etc/puppet/hieradata/production/common.yaml file.
  4. Update the /etc/puppet/hieradata/production/common.yaml YAML file with the JDK pack information. Specifically define the java_install_dir and java_source_file fields.

Puppet Agent
Follow the instructions below to configure the Puppet Agent.

1. Sign into the Puppet Agent as the super user.
2. Modify the /etc/puppet/puppet.conf file that corresponds to the Puppet Agent by appending the following to the[main] section.
```
[main]  
server = puppet
```

Step 3 - Set facters and run Puppet Agent

Follow the instructions below to set Puppet facters and run the Puppet Agent.

Modify the deployment.conf file according to your product.
Login to Puppet Agent as super user.
Copy the content of the modified deployment.conf file into the /opt/deployment.conf file.
For example, the deployment.conf file may appear as follows for the WSO2 APIM 1.9.1 product.
```
product_name=wso2am
product_version=1.9.1
product_profile=default
vm_type=openstack
```

Copy the file setup.sh file, which appears as follows, into the /opt/setup.sh file.
For example, the setup.shfile may appear as follows for the WSO2 APIM 1.9.1 product.

#!/bin/bash
echo  "#####################################################" 
echo  " Starting cleanup " 
echo  "#####################################################" 
ps aux | grep -i wso2 | awk { 'print $2' } | xargs kill -9
#rm -rf /mnt/*
sed -i  '/environment/d'  /etc/puppet/puppet.conf
echo  "#####################################################" 
echo  " Setting up environment " 
echo  "#####################################################" 
rm -f /etc/facter/facts.d/deployment_pattern.txt
mkdir -p /etc/facter/facts.d

while read -r line; do declare  $line
      ; done < deployment.conf  

echo product_name=$product_name >> /etc/facter/facts.d/deployment_pattern.txt  
echo product_version=$product_version >> /etc/facter/facts.d/deployment_pattern.txt  
echo product_profile=$product_profile >> /etc/facter/facts.d/deployment_pattern.txt  
echo vm_type=$vm_type >> /etc/facter/facts.d/deployment_pattern.txt  

echo  "#####################################################"   
echo  " Installing "   
echo  "#####################################################"   

puppet agent --enable  
puppet agent -vt  
puppet agent --disable

Execute the following command, so that users other than the owner can read and execute the file.
```
chmod 755 setup.sh
```
Run the following command to set the Puppet facters and run the Puppet Agent in order to setup the WSO2 product instance.
```
./setup.sh
```
This installs an instance of a standard WSO2 product based on the product and version that you defined.
For example:
```
/mnt/10.0.2.89/wso2am-1.9.1
```
For APIM 1.9.1 the complete deployment time (deployment and server startup) is approximately 1 minute.