The Ansible playbook can be used to install PTAnywhere in Linux machines with SSH access.

However, this project also provides a script to create one or multiple local virtual machine/s where we can install it (together with a web server and a Redis server).

The script uses VirtualBox, but you can modify it to use other VM provider.

The base configuration file can be found in vagrant/one_machine.rb. This file defines a unique machine called ptanywhere. This machine is able to:

1. serve the PTAnywhere application and
2. manage PT instances using Docker.

To create this VM:

1. Install Vagrant in the host.
2. Go to this project's root directory and type vagrant up.
   This command creates the machines defined in the configuration file and an Ansible inventory file equivalent to the machine file (see .vagrant/provisioners/ansible/inventory).
3. The script will fail at the Docker container creation. The easiest way to solve this is by running the provisioning script again using: vagrant provision

Once you have completed these steps, you will be able to:

• Deploy PTAnywhere on port 8080.
• Access and manage new instances using the web application on port 80.

You can find additional configuration files for creating different installations in the vagrant directory:

• vagrant/two_machines.rb: this file defines a web server called websvr where the PTAnywhere app should be deployed and a support machine called node1 which will have an HTTP API to manage PT instances using Docker. To create more support machines edit the configuration file on NOTE 1.
• vagrant/configuration.rb: this is a special configuration which creates a VM with PacketTracer installed and VNC enabled to graphically access to the machine. For more information please check the Preparing the PT installation section.

To create any of these installations run:

MACHINES='./vagrant/[filename].rb' vagrant up