Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 11 Next »

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.

On this page:


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 the Vagrant-Way

  • 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 

    vagrant up

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

    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 

    Demo has been successfully deployed!

  • then you can open your browser at http://192.168.33.10:8080/SSCAdminApp

Installation on existing Docker Hosts

Ensure that you got docker-compose installed. See the docs on how to install it.

root@ubuntu:~# which docker-compose
/usr/local/bin/docker-compose
root@ubuntu:~# docker-compose -v
docker-compose version 1.7.1, build 0a9ab35
root@ubuntu:~#

Installation on Docker-enabled environments is the fastest way; just open a Bash shell in the demo folder and run.

./init_stack.sh

Typical Usage

Start / Stop

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

vagrant halt

For starting: 

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 

vagrant ssh
sudo -s
cd /bootstrapping
./update_stack.sh

Uninstalling

The whole stack can seamlessly uninstalled by either removing the Vagrant VM from VirtualBux or (being in the demo folder): 

vagrant destroy

 This will destroy and purge all your data!

Troubleshooting

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

  • No labels