... | ... | @@ -6,7 +6,7 @@ This page describes a self-demo that you can run on Stork. To run it you need on |
|
|
- access to https://stork.lab.isc.org (ISC employees only for now)
|
|
|
- an Ubuntu box (download Stork sources from the repository, type ``rake docker_up``, connect to http://localhost:8080)
|
|
|
|
|
|
In addition, in order to have access to the features which require Kea premium hooks, an access token to the Kea premium repository is required. The access token can be found on the following page https://cloudsmith.io/~isc/repos/kea-1-7-prv/setup/#formats-deb which is available to ISC employees and paid ISC customers. The access token is found within the following link https://dl.cloudsmith.io/<access token>/isc/kea-1-7-prv/cfg/setup/bash.deb.sh after logging in to the Cloudsmith.
|
|
|
In addition, in order to have access to the features which require Kea premium hooks, an access token to the Kea premium repository is required. The access token can be found on the following page https://cloudsmith.io/~isc/repos/kea-1-9-prv/setup/#tab-formats-deb which is available to ISC employees and paid ISC customers. The access token is found within the following link https://dl.cloudsmith.io/${ACCESS_TOKEN}/isc/kea-1-9-prv/cfg/setup/bash.deb.sh after logging in to the Cloudsmith.
|
|
|
|
|
|
In order to start the demo with the premium Kea features run the following:
|
|
|
|
... | ... | @@ -14,7 +14,7 @@ In order to start the demo with the premium Kea features run the following: |
|
|
rake docker_up cs_repo_access_token=<access token>
|
|
|
```
|
|
|
|
|
|
Once Stork becomes a bit more mature, we're planning to have a public demo site.
|
|
|
Once Stork becomes a bit more mature, we're planning to have a public demo site.
|
|
|
|
|
|
Stork documentation is available at https://stork.readthedocs.io. It may be useful during this self-guided tour.
|
|
|
|
... | ... | @@ -36,7 +36,7 @@ Since you're logged in as super-admin, you can see the `Configuration` menu and |
|
|
|
|
|
## 4. Add new BIND9 machine to monitor
|
|
|
|
|
|
Go to `Services`->`Machines` and click `Add New Machine`, type in `agent-bind9`.
|
|
|
Go to `Services`->`Machines` and click `Add New Machine`, type in `agent-bind9`.
|
|
|
|
|
|
Normally you would type in an FQDN or an IP address of the machine you want to monitor. By default Stork is being deployed using Docker. There are several docker containers simulating machines with Kea and BIND in various modes of operation. agent-bind9 is a name of one of such containers. Note that you didn't specify what kind of software is running on the `agent-bind9` machine. Stork server connected to the stork agent running there and the agent looked for Kea and BIND and found only BIND. It should detect BIND app running there.
|
|
|
|
... | ... | @@ -66,7 +66,7 @@ You can now inspect the HA status of those servers. Note the difference between |
|
|
|
|
|
Optionally, you may want to connect to simulate one of the Kea servers crashing and observe how the surviving Kea server detects the problem and how Stork provides extra insight into what's happening.
|
|
|
|
|
|
As of 0.12, the Stork Environment Simulator listening on http://localhost:5000/ (this available in demo only) allows you to conveniently stop and start services to simulate all sorts of failures. Go ahead and kill one of the kea-dhcp4 daemons. Alternatively, you can do it youself. Open a new console. Make sure you are in the Stork directory where the demo is being run, then connect to the docker machine and use kill command to abruptly stop kea.
|
|
|
As of 0.12, the Stork Environment Simulator listening on http://localhost:5000/ (this available in demo only) allows you to conveniently stop and start services to simulate all sorts of failures. Go ahead and kill one of the kea-dhcp4 daemons. Alternatively, you can do it yourself. Open a new console. Make sure you are in the Stork directory where the demo is being run, then connect to the docker machine and use kill command to abruptly stop kea.
|
|
|
|
|
|
```
|
|
|
# Make sure this is the directory where you run `rake docker_up` from.
|
... | ... | @@ -152,7 +152,7 @@ Open a new tab in your browser and connect to the Stork Environment Simulator on |
|
|
|
|
|
## 17. Grafana
|
|
|
|
|
|
An early Grafana integration was introduced in 0.5. In 0.9, you can go to `Configuration` and `Settings` and set up the link to your Grafana. In case of demo, type in `http://localhost:3000` (if running the demo locally) or `http://stork.lab.isc.org:3000` (if using on stork.lab). Go to http://localhost:3000 or http://stork.lab.isc.org:3000 and log in using admin/admin credentials. Please don't change the password, so the next person viewing the demo can take a look, too.
|
|
|
An early Grafana integration was introduced in 0.5. In 0.9, you can go to `Configuration` and `Settings` and set up the link to your Grafana. In case of demo, type in `http://localhost:3000` (if running the demo locally) or `http://stork.lab.isc.org:3000` (if using on stork.lab). Go to http://localhost:3000 or http://stork.lab.isc.org:3000 and log in using admin/admin credentials. Please don't change the password, so the next person viewing the demo can take a look, too.
|
|
|
|
|
|
There are two dashboards. One for Kea and another one for BIND 9.
|
|
|
|
... | ... | |