Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Section
Column
width400px

Introduction

The whole

...

azeti Engine application stack can be demoed using the azetiCloud demoBundle leveraging docker to virtualize the whole stack. The process itself is pretty straight forward - consultants send customers the demoBundle.zip and the customer only needs to extract it and setup the Vagrant VM.

Column
width400px
Panel
borderColorlightgrey
bgColor#f0f0f0
titleOn this page:

Table of Contents

Related pages:

  • Filter by label (Content by label)
    showLabelsfalse
    showSpacefalse
    sortcreation
    cqllabel = "docker"

Prerequisites

Technical prerequisites for customer

For running the DockerDemo the host needs to have the following pre-requisites:

  • recent installation of Vagrant (1.7+) (it is freely available from https://www.vagrantup.com)
  • Windows 7+, OS X 10.10+
  • administrative privileges are required for installing Vagrant and running it
  • Vagrant runs on a separate network interface, one has to make sure, that this special interface (usually having IP: 192.168.33.10) is not firewalled; furthermore without further configuration it cannot be reached from the local network
  • for Linux/Ubuntu the DockerDemo can be run directly, but you need to have a very recent version of the DockerEngine (1.11+) and DockerCompose (1.7+) and you have to make sure, that there are no conflicting applications running, because usually they get bridged to localhost.

Administrative prerequisites for customer

The customer needs to have a DockerHub (https://hub.docker.com) account, and this account has to be a member of the Azeti organization (https://hub.docker.com/u/azeti/) to access the private DockerImages from Azeti. 

Administrative prerequisites for consultant

Basically you need to get hold of the latest demoBundle; it is automatically built and tagged with the corresponding version numbers of the whole stack. The demo bundle can be downloaded from the in-house private Nexus at: http://10.0.0.70:8081/nexus/content/repositories/demos/net/azeti/ssc/demo/demoStack/ This site is only available from inside the Azeti network (or via VPN) and you need Nexus credentials.

Installation of the Docker Environment

  •  make sure all pre-requisites are met

...

  •  extract demoStack-Version.zip (e.g. demoStack-0.3.6.zip), it will expand into a demo folder
  •  

    change to this folder, open a command prompt / terminal there and run 

    Code Block
    vagrant up
  •  

    it might take some time and will prompt for your DockerHub credentials (username, passwort) and hit Enter

    Code Block
    Username for DockerHub: customerusername
    Password for DockerHub: allyoursecretsarebelongtous
  •  

    for the first time a lot of files need to be downloaded (2.5 GB) so be patient

  •  

    after a while you should see something like 

    Code Block
    Demo has been successfully deployed!

...

Installation on existing Docker Hosts

...

Code Block
./init_stack.sh

Typical Usage

Start / Stop

Simply stop the Vargrant VM, either via VirtualBox or (being in the demo folder) for stopping:

...

For starting: 

Code Block
vagrant up

Updating

The demo stack can be easily updated without losing data, because it just depends on the private azeti/tomcat-data image, that has the latest releases. For updating you need to login in to the Vagrant VM (password + username are both vagrant) and call the update script 

...

Code Block
vagrant destroy

...

Warning

 This will destroy and purge all your data!

Troubleshooting

So far there have not been any problems yet. (smile)