Before you start¶

Introduction¶

The Punch Standalone is running on one node - your laptop. The Punch Deployer makes it possible to configure a Punchplatform on multiple nodes. In this tutorial, we will setup a 3-node Punchplatform based on Vagrant boxes:

For this we need 4 VMs:

1 VM for Punch Deployer
3 VMs for Punch Nodes

Prerequisites¶

Resources¶

16GB of RAM
60 GB of storage

Virtualbox & Vagrant¶

You need Virtualbox and Vagrant to run this tutorial.

Punch deployer¶

You must have a Punchplatform Deployer to run this tutorial. If you do not have one, request one from this form.

Once installed add a few additional plugins:

vagrant plugin install vagrant-disksize
vagrant plugin install vagrant-vbguest
vagrant plugin install vagrant-scp

Start VMs¶

Before deploying your platform, you need to create and deploy the VMs. We will use the following Vagrantfile.

Put the Vagrantfile on a folder on your laptop. Your VMs data will be stored here. Run vagrant up in this folder to start the VMs.

Once all VMs are up, check that you can access the deployer:

# laptop -> deployer
vagrant ssh deployer

From the deployer, check that you can access through SSH to the target servers:

# deployer -> serverX
ssh server1 exit
ssh server2 exit
ssh server3 exit

Upload Punch Deployer¶

Upload the Punch deployer on the deployer VM:

vagrant scp /path/to/your/punch-deployer-6.4.5-SNAPSHOT.zip deployer:~

Prepare Punch Deployer¶

Extract the deployer package and make sure that its resources will not be overwritten.

vagrant ssh deployer
unzip punch-deployer-6.4.5-SNAPSHOT.zip
chmod -R o-w punch-deployer-6.4.5-SNAPSHOT/