|
|
[[_TOC_]]
|
|
|
|
|
|
# Stork demo
|
|
|
# Starting the Stork demo
|
|
|
|
|
|
This page describes a self-demo that you can run on Stork. To run it you need one of the following:
|
|
|
|
|
|
- access to https://stork.lab.isc.org (ISC employees only for now)
|
|
|
- an Ubuntu box (download Stork sources from the repository, type ``rake demo:up``, connect to http://localhost:8080)
|
|
|
- access to <https://stork.lab.isc.org> (ISC employees only for now)
|
|
|
- an Ubuntu box (download Stork sources from the repository, type `rake demo:up`, connect to <http://localhost:8080>)
|
|
|
|
|
|
Optionally, in order to have access to the features which require Kea premium hooks, an access token to the Kea premium repository is required. If you have a Cloudsmith account, can find your token can be found on the following page https://cloudsmith.io/~isc/repos/kea-2-1-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-2-1-prv/cfg/setup/bash.deb.sh after logging in to the Cloudsmith. The Cloudsmith account is not necessary. The customer got their Cloudsmith access token when signed up the support contract or purchased their hooks.
|
|
|
Optionally, in order to have access to the features which require Kea premium hooks, an access token to the Kea premium repository is required. If you have a Cloudsmith account, can find your token can be found on the following page <https://cloudsmith.io/\~isc/repos/kea-2-1-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-2-1-prv/cfg/setup/bash.deb.sh](https://dl.cloudsmith.io/%24%7BACCESS_TOKEN%7D/isc/kea-2-1-prv/cfg/setup/bash.deb.sh) after logging in to the Cloudsmith. The Cloudsmith account is not necessary. The customer got their Cloudsmith access token when signed up the support contract or purchased their hooks.
|
|
|
|
|
|
In order to start the demo with the premium Kea features run the following:
|
|
|
|
|
|
```
|
|
|
```plaintext
|
|
|
rake demo:up CS_REPO_ACCESS_TOKEN=<access token>
|
|
|
```
|
|
|
|
|
|
We're planning to have a public demo site in not so distant future.
|
|
|
|
|
|
Stork documentation is available at https://stork.readthedocs.io. It may be useful during this self-guided tour.
|
|
|
Stork documentation is available at <https://stork.readthedocs.io>. It may be useful during this self-guided tour.
|
|
|
|
|
|
# Stork Features
|
|
|
|
|
|
## 1. Log in using admin/admin credentials
|
|
|
## Management
|
|
|
|
|
|
### 1. Log in
|
|
|
|
|
|
Note the version displayed on the login screen. It is not hardcoded. This is a version of the Stork server that is retrieved over REST API.
|
|
|
After fresh installation, you can log in using admin/admin credentials. In a production environment, the first step would be to change that password, but since this is a temporary demo, it should be fine. Note the version displayed on the login screen. It is not hardcoded. This is a version of the Stork server that was retrieved over REST API.
|
|
|
|
|
|
## 2. Check your role in the system
|
|
|
### 2. Check your role in the system
|
|
|
|
|
|
You logged in as admin, which is an account with `super-admin` role. You can check you currently assigned roles by going to your `Profile` page. Click on the little triangle button next to `Logout`.
|
|
|
|
|
|
Note: as of 0.9 there are currently two roles defined: `super-admin` (can do everything including managing and adding new users) and `admin` (can do everything, except managing or adding users). A third role, read-only users, coming up soon.
|
|
|
Note: Currently there are currently two roles defined: `super-admin` (can do everything including managing and adding new users) and `admin` (can do everything, except managing or adding users). A third role, read-only users, coming up soon.
|
|
|
|
|
|
## 3. Add new user
|
|
|
### 3. Add new user
|
|
|
|
|
|
Since you're logged in as super-admin, you can see the `Configuration` menu and `Users` within it. Click on it and you'll see a list of all users. Click on `Create User Account` to create a new account. It's recommended to create a new account with `admin` role, so the new user can't create more users. Go ahead and try it.
|
|
|
|
|
|
## 4. Add new BIND9 machine to monitor
|
|
|
## Monitoring Kea
|
|
|
|
|
|
Go to `Services`->`Machines` and switch to `Unauthorized` machines view (top-right corner). Now click the action button in `agent-bind9` machine and then click `Authorize` in the menu. And then switch back to `Authorized` machines.
|
|
|
|
|
|
In the demo, there are several docker containers simulating machines with Kea and BIND in various modes of operation. agent-bind9 is the 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 9 and found only BIND 9. It should detect BIND 9 app running there.
|
|
|
|
|
|
## 5. Inspect the agent-bind9 machine
|
|
|
|
|
|
Click around. As of 0.9 the BIND capabilities are basic. Stork is able to check if BIND process is running and display its version, number of zones configured, time since it last reconfiguration and more.
|
|
|
|
|
|
## 6. Add new Kea machine to monitor
|
|
|
### 4. Add new Kea machine to monitor
|
|
|
|
|
|
Go to `Services`->`Machines` and switch to `Unauthorized` machines view (top-right corner). Now click the action button in `agent-kea` machine and then click `Authorize` in the menu. And then switch back to `Authorized` machines. The procedure is the same as before, but this time Stork detected Kea servers running. Notice that a problem is reported.
|
|
|
|
|
|
Kea is being shipped with CA (Control Agent) preconfigured with control sockets for DHCPv4, DHCPv6 and DDNS. This simplifies deployment. In this particular Kea deployment only DHCPv4 daemon is installed. CA tries to connect to all of those daemons and continues with only those that respond. That makes it easy to deploy daemons selectively. However, Stork looks at the CA config and determines that there are 3 daemons expected, but only DHCPv4 is running. The other ones are greyed out and on their tab there is information that Stork agent cannot communicate with them. As this is the initial situation Stork concludes that this is as expected and switches off monitoring of these daemons, only DHCPv4 is monitored and its status is green.
|
|
|
|
|
|
## 7. Inspect Kea details
|
|
|
### 5. Inspect Kea details
|
|
|
|
|
|
You can either click on the Version on the Kea apps list or click on the machine and the link to details in the Kea app panel on the machine details page. Note the Kea version being returned and a list of currently loaded hooks.
|
|
|
|
... | ... | @@ -63,7 +57,7 @@ The `Data Storage` section comprises information about various files used by the |
|
|
|
|
|
If the demo is started with the `cs_repo_access_token`, the agent-kea-premium machine with paid Kea hooks libraries can be monitored. Authorize it and navigate to the Kea view for that machine. Its `Data Storage` section includes a location of the forensic logging files generated by the Kea server.
|
|
|
|
|
|
## 8. Add two Kea servers that work as HA pair
|
|
|
### 6. Add two Kea servers that work as HA pair
|
|
|
|
|
|
Go to `Services`->`Machines` and switch to `Unauthorized` machines view (top-right corner). Now click the action button in `agent-kea-ha1` machine and then click `Authorize` in the menu. Do the same for `agent-kea-ha2`. And then switch back to `Authorized` machines.
|
|
|
|
... | ... | @@ -71,9 +65,9 @@ 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 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.
|
|
|
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.
|
|
|
|
|
|
```
|
|
|
```plaintext
|
|
|
# Make sure this is the directory where you run `rake docker_up` from.
|
|
|
cd ~/devel/stork
|
|
|
|
... | ... | @@ -95,25 +89,26 @@ After couple seconds Stork will report a problem. Observe how Kea goes through v |
|
|
![ha-status-0.9](uploads/2cade4b08a304dc9c4f7c3ed9937631c/ha-status-0.9.png)
|
|
|
|
|
|
To restart Kea, use the following command:
|
|
|
```
|
|
|
|
|
|
```plaintext
|
|
|
/usr/sbin/kea-dhcp4 -c /etc/kea/kea-dhcp4.conf &
|
|
|
```
|
|
|
|
|
|
You can now logout from the docker image using `exit` or by pressing ctrl-d.
|
|
|
|
|
|
## 9. DHCPv6 support
|
|
|
### 7. DHCPv6 support
|
|
|
|
|
|
Stork fully supports IPv6 from the day one. Add another machine called `agent-kea6`. Notice the IPv6 subnet and several pools.
|
|
|
|
|
|
## 10. All subnets in your network
|
|
|
### 8. All subnets in your network
|
|
|
|
|
|
Stork lets you view and search through the subnets and pools. Go to `DHCP` and then `Subnets`. You will see all the subnets with pools in them. You can filter the subnets by type (any, DHCPv4 or DHCPv6). You can also type any string. For example, to limit the subnet to 192.0.3.0, you can search for `0.3`. Note that strings shorter than 4 characters require you to confirm with Enter (strings of 4 chars or longer does not require that). You can search for specific subnets, pools or pool boundaries.
|
|
|
|
|
|
## 11. Shared networks
|
|
|
### 9. Shared networks
|
|
|
|
|
|
Grouping subnets into shared networks is a very popular feature in Kea and other DHCP servers. Stork supports this ability by showing networks. You can go to `DHCP` -> `Shared networks`. It offers the same filtering mechanism as subnets.
|
|
|
|
|
|
## 12. Host reservations on monitored machines
|
|
|
### 10. Host reservations on monitored machines
|
|
|
|
|
|
After adding `agent-kea` machine all host reservations configured on the Kea app running on this machine will be fetched into Stork can be presented in the UI. Navigate to `DHCP` and then `Host Reservations`. All host reservations detected on the monitored machines will be listed, including the DHCP identifiers, reserved IP addresses and the subnets that each reservation belongs to. Finally, the last column comprises the list of servers that the particular host reservation is configured on.
|
|
|
|
... | ... | @@ -125,13 +120,13 @@ Suppose you click on the reservation for an address `192.0.5.1`. This reservatio |
|
|
|
|
|
Go back to the host reservations list by clicking the leftmost tab marked `Host Reservations`. Select host reservation for the address `192.0.2.1`. The demo setup pre-allocates a lease for this address. However, the lease is allocated to a client that doesn't own the reservation. The address is reserved for the MAC address `1a:1b:1c:1d:1e:1f` but the lease is allocated for the client with MAC address `1f:1e:1f:1e:1f:1e`. This situation is known as `conflict`. The `lock` icon and the text `in conflict` indicate the conflict occurrence. You may also click on the `chevron` icon to the left of the IP address to expand additional information. It provides additional details about the lease assignment, i.e. to whom the lease is assigned and when it expires.
|
|
|
|
|
|
## 13. Host reservations within Kea host backends
|
|
|
### 11. Host reservations within Kea host backends
|
|
|
|
|
|
The reservations observed in the previous step were only those that are specified within the Kea configuration files. Kea also supports defining host reservations within a database via `host_cmds` premium hooks library. Those reservations are available in the same view as previously. They are fetched when the Kea app is configured to use `host_cmds` hooks library. The demo setup optionally includes such machine if the demo is started with the `cs_repo_access_token` variable.
|
|
|
|
|
|
In order to see the reservations stored in the host database on this machine, start monitoring this machine by adding it to Stork. The machine name is `agent-kea-premium`. Stork is currently configured to fetch and refresh the reservations from the hosts backend at the 60 seconds interval. Thus, you may need to wait a little while before the host reservations appear on the list. If the fetch is successful, you should observe new IPv4 reservations starting with IP address of 192.0.2.200 and higher.
|
|
|
|
|
|
## 14. DHCP Dashboard
|
|
|
### 12. DHCP Dashboard
|
|
|
|
|
|
One of easily missed features of Stork is its dashboard. Make sure you click on the Stork logo (or the Stork name next to it). Since 0.10, there is also an explicit link in the DHCP menu. This is a high level overview of all the things being currently monitored. If you followed the demo, you should see something similar to this:
|
|
|
|
... | ... | @@ -139,16 +134,13 @@ One of easily missed features of Stork is its dashboard. Make sure you click on |
|
|
|
|
|
The list of subnets shows top 5 subnets with highest pool utilization. There's a list of events on the right hand side. If you configured Grafana, you will see links to Grafana to inspect historic values for subnets and how they changed over time.
|
|
|
|
|
|
## 15. DHCP address pool utilization
|
|
|
### 13. DHCP address pool utilization
|
|
|
|
|
|
Open a new tab in your browser and connect to http://localhost:5000 (if running locally) or to http://stork.lab.isc.org:5000 to take a look at the DHCP traffic generator. This is not part of the Stork itself, it's a tool we developed to simulate actual networks. It's a bit simple, but sufficient enough to generate traffic. It retrieves list of subnets known by Stork and enables to generate traffic for each subnet. You may want to experiment with it. Things to play with it:
|
|
|
Open a new tab in your browser and connect to <http://localhost:5000> (if running locally) or to <http://stork.lab.isc.org:5000> to take a look at the DHCP traffic generator. This is not part of the Stork itself, it's a tool we developed to simulate actual networks. It's a bit simple, but sufficient enough to generate traffic. It retrieves list of subnets known by Stork and enables to generate traffic for each subnet. You may want to experiment with it. Things to play with it:
|
|
|
|
|
|
- set the number of clients to somewhat smaller value than the pool size. You'll see a warning (yellow triangle) once you cross the 80% utilization and critical (red error) once you cross 90%. Those thresholds are hardcoded as of 0.5, but will be configurable in the future versions.
|
|
|
|
|
|
- traffic generator is currently not able to generate traffic for more than one subnet in a shared network. When you click Start in the next subnet, the traffic in the other subnet for the same shared network stops. This is a limitation of the underlying perfdhcp tool that will be fixed in future Kea releases.
|
|
|
|
|
|
- Stork retrieves the information once per 10 seconds from its database. Unfortunately, the UI does not refresh itself yet and you need to press F5 or ctrl-R to reload the page to see. This will be fixed in Stork 0.6.
|
|
|
|
|
|
- The lease lifetimes have unnaturally short lifetimes of only 3 minutes. Wait a little bit and they'll expire.
|
|
|
|
|
|
With a little bit of juggling around, you can see something like this:
|
... | ... | @@ -157,13 +149,41 @@ With a little bit of juggling around, you can see something like this: |
|
|
|
|
|
Make sure you take a look at the shared networks, too!
|
|
|
|
|
|
## 16. DNS traffic
|
|
|
### 14. DHCP Leases Search
|
|
|
|
|
|
Ensure that the agent-kea and agent-kea6 are authorized before trying this feature.
|
|
|
|
|
|
Navigate to `DHCP` -> `Leases Search`. Type `192.0.2.1` in the search box. You should now see a valid DHCPv4 lease. You can expand the lease details by clicking on the chevron icon in the first column.
|
|
|
|
|
|
You can find the same lease using a different query, i.e. MAC address, client identifier, or hostname. Try to copy-paste any of them into the search box and press Enter. The same lease should pop up.
|
|
|
|
|
|
Repeat the steps above for other valid leases preloaded on the agent-kea6 server: `3001:db8:1::1` and `3001:db8:8:10::`. The former is an IPv6 address (IA_NA). The latter is a delegated prefix (IA_PD).
|
|
|
|
|
|
Declined addresses are also internally stored by Kea as leases. Try to find a declined lease by typing `192.0.2.2` or `3001:db8:1::2`.
|
|
|
|
|
|
This view also allows searching for all declined leases. Type: `state:declined` and press Enter. It should return both declined addresses. Note that the declined lease details lack DHCP client information, i.e. MAC address or client identifier, because declined leases do not belong to any client. They simply mark that certain addresses are temporarily unavailable for allocation.
|
|
|
|
|
|
## Monitoring BIND9
|
|
|
|
|
|
Open a new tab in your browser and connect to the Stork Environment Simulator on http://localhost:5000 (if running locally) or http://stork.lab.isc.org:5000 to take a look at the DNS traffic generator. This is not part of the Stork itself, it's a tool we developed to simulate some traffic. It retrieves the DNS servers known by stork and enables to generate traffic to it. You can send a simple query with `Dig` or start a query stream with the `Start` button. This is quite basic and may be extended in the future with the option to query different names, replay a pcap, and emulate different clients. Go ahead and experiment. Once you got some traffic, go to Grafana and see the BIND dashboard.
|
|
|
### 15. Add new BIND9 machine to monitor
|
|
|
|
|
|
## 17. Grafana
|
|
|
Go to `Services`->`Machines` and switch to `Unauthorized` machines view (top-right corner). Now click the action button in `agent-bind9` machine and then click `Authorize` in the menu. And then switch back to `Authorized` machines.
|
|
|
|
|
|
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.
|
|
|
In the demo, there are several docker containers simulating machines with Kea and BIND in various modes of operation. agent-bind9 is the 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 9 and found only BIND 9. It should detect BIND 9 app running there.
|
|
|
|
|
|
### 16. Inspect the agent-bind9 machine
|
|
|
|
|
|
Click around. As of 0.9 the BIND capabilities are basic. Stork is able to check if BIND process is running and display its version, number of zones configured, time since it last reconfiguration and more.
|
|
|
|
|
|
### 17. DNS traffic
|
|
|
|
|
|
Open a new tab in your browser and connect to the Stork Environment Simulator on <http://localhost:5000> (if running locally) or <http://stork.lab.isc.org:5000> to take a look at the DNS traffic generator. This is not part of the Stork itself, it's a tool we developed to simulate some traffic. It retrieves the DNS servers known by stork and enables to generate traffic to it. You can send a simple query with `Dig` or start a query stream with the `Start` button. This is quite basic and may be extended in the future with the option to query different names, replay a pcap, and emulate different clients. Go ahead and experiment. Once you got some traffic, go to Grafana and see the BIND dashboard.
|
|
|
|
|
|
## General features
|
|
|
|
|
|
### 18. 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.
|
|
|
|
|
|
There are two dashboards. One for Kea and another one for BIND 9.
|
|
|
|
... | ... | @@ -173,40 +193,26 @@ Click on Home and then Stork Kea DHCPv4 dashboard. You have plenty of statistics |
|
|
|
|
|
**BIND 9**
|
|
|
|
|
|
For Kea the dashboard for Grafana was already preconfigured. In case of BIND 9 it needs to be manually import. The dashboard definition is available here: https://gitlab.isc.org/isc-projects/stork/-/tree/master/grafana. Now go to Grafana homepage (http://stork.lab.isc.org:3000), click `Home`, then `Import dashboard`, then `Upload .json file` and upload it. Alternatively, you can paste this link `https://gitlab.isc.org/isc-projects/stork/-/raw/master/grafana/bind9-resolver.json` there.
|
|
|
For Kea the dashboard for Grafana was already preconfigured. In case of BIND 9 it needs to be manually import. The dashboard definition is available here: <https://gitlab.isc.org/isc-projects/stork/-/tree/master/grafana>. Now go to Grafana homepage (<http://stork.lab.isc.org:3000>), click `Home`, then `Import dashboard`, then `Upload .json file` and upload it. Alternatively, you can paste this link `https://gitlab.isc.org/isc-projects/stork/-/raw/master/grafana/bind9-resolver.json` there.
|
|
|
|
|
|
Click on Home and then Stork Bind DNS dashboard. There are some generic statistics, as well as the Cache Hit Ratio/Hit/Miss statistics provided by Stork. More are coming in future Stork releases.
|
|
|
|
|
|
## 18. Events
|
|
|
### 19. Events
|
|
|
|
|
|
Stork records various events in the system. There are several places where you can observe events;
|
|
|
|
|
|
1. The dashboard - here you can see the latest 15 events in the whole networks being monitored.
|
|
|
1. The Machine view - here you can the events related to this specific machine
|
|
|
1. Events viewer - this is a full page event viewer, which lets you filter events by severity, machine, app type, daemon and for the events that were results of user's actions - also by user.
|
|
|
2. The Machine view - here you can the events related to this specific machine
|
|
|
3. Events viewer - this is a full page event viewer, which lets you filter events by severity, machine, app type, daemon and for the events that were results of user's actions - also by user.
|
|
|
|
|
|
![events-viewer](uploads/11439438bb815b1f4e6a93d76177d082/events-viewer.png)
|
|
|
|
|
|
## 19. DHCP Leases Search
|
|
|
|
|
|
Ensure that the agent-kea and agent-kea6 are authorized before trying this feature.
|
|
|
|
|
|
Navigate to `DHCP` -> `Leases Search`. Type `192.0.2.1` in the search box. You should now see a valid DHCPv4 lease. You can expand the lease details by clicking on the chevron icon in the first column.
|
|
|
|
|
|
You can find the same lease using a different query, i.e. MAC address, client identifier, or hostname. Try to copy-paste any of them into the search box and press Enter. The same lease should pop up.
|
|
|
|
|
|
Repeat the steps above for other valid leases preloaded on the agent-kea6 server: `3001:db8:1::1` and `3001:db8:8:10::`. The former is an IPv6 address (IA_NA). The latter is a delegated prefix (IA_PD).
|
|
|
|
|
|
Declined addresses are also internally stored by Kea as leases. Try to find a declined lease by typing `192.0.2.2` or `3001:db8:1::2`.
|
|
|
|
|
|
This view also allows searching for all declined leases. Type: `state:declined` and press Enter. It should return both declined addresses. Note that the declined lease details lack DHCP client information, i.e. MAC address or client identifier, because declined leases do not belong to any client. They simply mark that certain addresses are temporarily unavailable for allocation.
|
|
|
|
|
|
## 20. Other tasks
|
|
|
### 20. Other tasks
|
|
|
|
|
|
Here's a list of smaller things you can do.
|
|
|
|
|
|
1. **change your password** by going to `Profile` -> `Settings`.
|
|
|
2. **change others password*. If you're a super-admin, you can change others passwords. Log in as super-admin (e.g. admin user), click on `Configuration` -> `Users` and then on the user you want to modify. Click `Edit`.
|
|
|
2. \*_change others password_. If you're a super-admin, you can change others passwords. Log in as super-admin (e.g. admin user), click on `Configuration` -> `Users` and then on the user you want to modify. Click `Edit`.
|
|
|
3. **remove machines**. Go to `Services` -> `Machines` and pick a machine you want to have removed. Click on the hamburger button (three horizontal lines) on the right hand and choose `Remove` from the menu. Note anything running on the machine will disappear from Stork. The actual services running won't be affected, Stork simply stopped monitoring them. You can re-add them to see that they're doing fine.
|
|
|
4. **Check Stork version**. You can hover your mouse over the Stork logo. It will display some information about Stork itself (version, compilation time).
|
|
|
|
... | ... | @@ -214,39 +220,39 @@ Here's a list of smaller things you can do. |
|
|
|
|
|
Here's a checklist of the above tasks that you can copy-paste into other issues, especially useful when doing sanity checks. Copy it after pressing the Edit button.
|
|
|
|
|
|
- [ ] Get the tarball
|
|
|
- [ ] Run tests
|
|
|
- [ ] `ng_test`
|
|
|
- [ ] `unittest_backend_db`
|
|
|
- [ ] `system_tests` (using RPM and DEB packages from CloudSmith)
|
|
|
- [ ] Start demo locally with `rake docker_up`
|
|
|
- [ ] Log in using admin/admin credentials
|
|
|
- [ ] Correct log-in
|
|
|
- [ ] Version is correctly displayed
|
|
|
- [ ] Check your role in the system
|
|
|
- [ ] Add new user
|
|
|
- [ ] Add new BIND9 machine to monitor
|
|
|
- [ ] Inspect the agent-bind9 machine
|
|
|
- [ ] Add new Kea machine to monitor
|
|
|
- [ ] Inspect Kea details
|
|
|
- [ ] Add two Kea servers that work as HA pair
|
|
|
- [ ] DHCPv6 support
|
|
|
- [ ] All subnets in your network
|
|
|
- [ ] Shared networks
|
|
|
- [ ] Host reservations on monitored machines
|
|
|
- [ ] DHCP Dashboard
|
|
|
- [ ] DHCP address pool utilization
|
|
|
- [ ] DNS traffic
|
|
|
- [ ] Grafana
|
|
|
- [ ] Kea
|
|
|
- [ ] Bind9
|
|
|
- [ ] Events
|
|
|
- [ ] DHCP Leases Search
|
|
|
- [ ] Other tasks
|
|
|
- [ ] change your password
|
|
|
- [ ] change others password
|
|
|
- [ ] remove machines
|
|
|
- [ ] Check Stork version
|
|
|
* [ ] Get the tarball
|
|
|
* [ ] Run tests
|
|
|
* [ ] `ng_test`
|
|
|
* [ ] `unittest_backend_db`
|
|
|
* [ ] `system_tests` (using RPM and DEB packages from CloudSmith)
|
|
|
* [ ] Start demo locally with `rake docker_up`
|
|
|
* [ ] Log in using admin/admin credentials
|
|
|
* [ ] Correct log-in
|
|
|
* [ ] Version is correctly displayed
|
|
|
* [ ] Check your role in the system
|
|
|
* [ ] Add new user
|
|
|
* [ ] Add new BIND9 machine to monitor
|
|
|
* [ ] Inspect the agent-bind9 machine
|
|
|
* [ ] Add new Kea machine to monitor
|
|
|
* [ ] Inspect Kea details
|
|
|
* [ ] Add two Kea servers that work as HA pair
|
|
|
* [ ] DHCPv6 support
|
|
|
* [ ] All subnets in your network
|
|
|
* [ ] Shared networks
|
|
|
* [ ] Host reservations on monitored machines
|
|
|
* [ ] DHCP Dashboard
|
|
|
* [ ] DHCP address pool utilization
|
|
|
* [ ] DNS traffic
|
|
|
* [ ] Grafana
|
|
|
* [ ] Kea
|
|
|
* [ ] Bind9
|
|
|
* [ ] Events
|
|
|
* [ ] DHCP Leases Search
|
|
|
* [ ] Other tasks
|
|
|
* [ ] change your password
|
|
|
* [ ] change others password
|
|
|
* [ ] remove machines
|
|
|
* [ ] Check Stork version
|
|
|
|
|
|
## Wrapping up
|
|
|
|
... | ... | @@ -255,9 +261,11 @@ Once you're using the stork.lab service, please clean up, so the the next person |
|
|
- stop any traffic generator
|
|
|
- delete all machines
|
|
|
|
|
|
If you're running self hosted demo, don't forget to run `rake demo:down` to clean up Docker containers and networks.
|
|
|
|
|
|
# Feedback
|
|
|
|
|
|
Stork in early stages and is being developed rapidly. Your feedback is essential. Please go to Stork project page and report new issues or add your comments to existing ones. In particular, we're interested in:
|
|
|
Stork is a relatively young project, but is being developed rapidly. Your feedback is essential. Please go to Stork project page and report new issues or add your comments to existing ones. In particular, we're interested in:
|
|
|
|
|
|
- things that are non-intuitive, broken, confusing
|
|
|
- missing functionalities you'd like to see (we're aware of many, please search the existing issues and +1 or comment on existing ones)
|
... | ... | |