...
Section | |||||
---|---|---|---|---|---|
|
...
|
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!
...
then you can open your browser at http://192.168.33.10:8080/SSCAdminApp
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.