/vagrant-geoserver

A Vagrant environment for Geoserver.

Apache License 2.0Apache-2.0

vagrant.geowave

A Vagrant environment for deploying Geoserver 2.7.0.

Vagrant and Ansible must be installed.

Overview

This repository can be used to set up a virtual machine environment to deploy Geoserver using Vagrant. The virtual machine will include Geoserver, Apache Tomcat 7, Apache 2, Postgresql 9.4, and Postgis.

Installation Requirements

In order to get started with this virtual machine, some software must be installed on the host machine and the host machine must support virtualization.

Software

Vagrant

Vagrant (version >= 1.7.2) is required on the host to manage the virtual machine. Binaries are available for most operating systems.

Ansible

Ansible (version >= 1.8.2) is required to handle configuration of the virtual machine. Ansible is officially supported for Mac OSX and Linux host environments, though it can be used with a Windows host machine. There are multiple ways to install Ansible, choose the most appropriate one for your operating system.

VirtualBox

VirtualBox is an open source virtual software package used to handle virtual machines. There are binaries available for most operating systems.

Note: It is also possible to run the virtual machine using a Kernel Based Virtual Machine on Linux. This can be done using the Vagrant Libvirt Provider. Vagrant Libvirt is still under active development and there are additional requirements if KVM is used.

Sytem Requirements

Your host machine should have at least 6GB of memory, a modern x86-64 processor, and virtualization support must be enabled for the processor being used.

Getting Started

  1. Clone this repository.

    git clone https://github.com/stumptownlabs/vagrant-geoserver.git geosever

    Note: If you wish to submit patches to this repository, you should consider forking this repository.

  2. Install required software listed above

  3. At this point, the directories in the vagrant-geoserver directory should look like this.

    vagrant-geoserver
    ├── ansible
    ├── README.md
    └── Vagrantfile
    
  4. In the top level directory with the Vagrantfile bring up the virtual machine at the command line.

    vagrant up

    At this point Vagrant will start the virtual machine and begin provisioning it with Ansible. Depending on internet connection speeds, installation and downloading of all dependencies could take some time.

  5. Once the machine finishes provisioning, you can verify that Geoserver is running by navigating to their web UI.

    The default username is 'admin' and password is 'geoserver'

Attribution

Adapted from original work by Chris Brown @notthatbreezy geotrellis/vagrant.geotrellis