Manual Install for Lattice

Lattice supports two different deployment methods: Vagrant, for the local host, and Terraform which automates the process of deploying a Lattice cluster to public clouds. Automated deployment to private clouds is not supported. However, deployment can be done manually. Follow these steps to deploy Lattice to a single pre-provisioned VM or host.

These instructions apply specifically to the v0.5.0 release. They will not work for newer versions. We are evaluating how to support manual installations following the packer-bosh cluster retooling.

Prerequisites

  • Ubuntu-based Linux install
    • At least 12GB of raw disk provisioned for the VM
    • Access to the Internet (to download packages)
  • No previous lattice installations already running
  • Following packages installed via apt-get:
    • curl
    • gcc
    • make
    • quota
    • linux-image-extra-$(uname -r)
    • btrfs-tools
    • lighttpd
    • lighttpd-mod-webdav

Installation

1) Download the v0.5.0 backend lattice.tgz

$ curl https://lattice.s3.amazonaws.com/releases/backend/lattice-v0.5.0.tgz -o lattice.tgz

2) Unpack installer script from lattice.tgz

$ tar xzf lattice.tgz --strip-components 2 lattice-build/scripts/install-from-tar

3) Populate the lattice-environment file

$ sudo mkdir -p /var/lattice/setup
$ sudo tee /var/lattice/setup/lattice-environment >/dev/null <<EOF
LATTICE_USERNAME=<username>
LATTICE_PASSWORD=<password>
CONSUL_SERVER_IP=<system_ip>
SYSTEM_DOMAIN=<system_ip>.xip.io
LATTICE_CELL_ID=cell-01
GARDEN_EXTERNAL_IP=<system_ip>
EOF

4) Download and unpack the CFLinuxFS2 Stack Release. - Lattice v0.5.0 is bundled with 1.6.0

$ export STACK_VERSION=1.6.0
$ wget https://github.com/cloudfoundry/stacks/releases/download/$STACK_VERSION/cflinuxfs2-$STACK_VERSION.tar.gz --quiet -O /tmp/cflinuxfs2-$STACK_VERSION.tar.gz
$ sudo mkdir -p /var/lattice/rootfs/cflinuxfs2
$ sudo tar -xzf /tmp/cflinuxfs2-$STACK_VERSION.tar.gz -C /var/lattice/rootfs/cflinuxfs2
$ sudo rm -f /tmp/cflinuxfs2-$STACK_VERSION.tar.gz

5) Run the installer script

$ sudo ./install-from-tar lattice.tgz

Note: The lattice cluster can take some time to become available. Please ltc target the new cluster and try ltc test -v until the cluster is healthy.

Modular. Flexible. Powerful

Application Instances