Skip to content

GitLab

  • Projects
  • Groups
  • Snippets
  • Help
    • Loading...
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in / Register
stork
stork
  • Project overview
    • Project overview
    • Details
    • Activity
    • Releases
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
  • Issues 152
    • Issues 152
    • List
    • Boards
    • Labels
    • Service Desk
    • Milestones
  • Merge Requests 8
    • Merge Requests 8
  • Operations
    • Operations
    • Incidents
  • Packages & Registries
    • Packages & Registries
    • Container Registry
  • Analytics
    • Analytics
    • Repository
    • Value Stream
  • Wiki
    • Wiki
  • Snippets
    • Snippets
  • Members
    • Members
  • Activity
  • Graph
  • Create a new issue
  • Commits
  • Issue Boards
Collapse sidebar
  • ISC Open Source Projects
  • storkstork
  • Wiki
  • Install

Last edited by Andrei Pavel Apr 01, 2021
Page history

Install

Stork Installation Instructions

NOTE: This page is being migrated to Stork ARM and is outdated. See Stork ARM at readthedocs for the up to date information.

Below are some system specific notes.

Ubuntu (docker)

On Ubuntu 20, you need to install couple packages first:

$ sudo apt install rake docker docker-compose python3-sphinx-rtd-theme openjdk-11-jre-headless

Get the stork sources, then:

$ rake docker_up

This is by far the simplest method. However, it requires the docker environment and Java to be up and running.

Ubuntu (native)

  1. Make sure that postgresql is installed:
$ sudo apt install postgresql postgresql-client
$ sudo systemctl start postgresql
  1. You may need to modify pg_hba.conf in /etc/postgresql (may be in 10/main subdir) and tweak the access rights, so the the unix account running Stork code will be able to connect as stork user in postgres.
local   all             all                                     password
host    all             all             127.0.0.1/32            password
host    all             all             ::1/128                 password
  1. Create the database, stork user and assign necessary permissions:
# su - postgres
postgres@ubuntu:~$ psql postgres
psql (10.10 (Ubuntu 10.10-0ubuntu0.18.04.1))
Type "help" for help.

postgres=# CREATE USER stork WITH PASSWORD 'stork';
CREATE ROLE
postgres=# CREATE DATABASE stork;
CREATE DATABASE
postgres=# GRANT ALL PRIVILEGES ON DATABASE stork TO stork;
GRANT
postgres=# \c stork
postgres=# CREATE EXTENSION pgcrypto;
CREATE EXTENSION
postgres=# \q
  1. Install Rake: sudo apt install rake
  2. Build the code:
rake build_agent build_backend build_migrations build_server build_ui
  1. Initialize the db:
$ backend/cmd/stork-db-migrate/stork-db-migrate init
$ backend/cmd/stork-db-migrate/stork-db-migrate up
  1. Run server in one console: rake run_server

  2. Run the UI in another console: rake serve_ui

  3. Run the agent in the third console: rake run_agent

You can now connect to http://localhost:4200, log in and connect your machine available at localhost:8888.

MacOS

MacOS is not officially supported. Here are some instructions for developers to run Stork.

NOTE: As of Nov 16, this requires changes from 87-macos. See !26 (merged).

  1. Install postgresql: brew install postgresql
  2. Make sure the service is started: brew services list and brew services start postgresql
  3. Open psql postgres and create the user and database:
$ psql postgres
psql (11.5)
Type "help" for help.

postgres=# CREATE USER stork WITH PASSWORD 'stork';
CREATE ROLE
postgres=# CREATE DATABASE stork;
CREATE DATABASE
postgres=# GRANT ALL PRIVILEGES ON DATABASE stork TO stork;
GRANT
postgres=# \c stork
You are now connected to database "stork" as user "thomson".
stork=# create extension pgcrypto;
CREATE EXTENSION
  1. (optional) Temporarily store the password in STORK_DATABASE_PASSWORD. Otherwise many of the following steps will ask about it: export STORK_DATABASE_PASSWORD=stork
  2. Initialize the DB:
$ backend/cmd/stork-db-migrate/stork-db-migrate init
  1. Upgrade the database:
$ backend/cmd/stork-db-migrate/stork-db-migrate up
  1. Run the server: rake run_server
  2. (in another console) Run the UI frontend: rake serve_ui
  3. (in another console) Run the agent: rake run_agent
  4. Click add new machine, use localhost:8888. This will at the agent you ran in the step 9 above.

FreeBSD

The following commands can be used to install Stork agent on FreeBSD. This procedure has been tried on 12.1-RELEASE-p3

  1. pkg install rubygem-rake ruby
  2. pkg install git
  3. git clone https://gitlab.isc.org/isc-projects/stork.git
  4. sudo pkg install protobuf
  5. mkdir -p tools/3.11.2/bin
  6. cd tools/3.11.2/bin
  7. ln -s which protoc
  8. rake build_agent
Clone repository
  • Demo
  • Ideas
  • Install Prometheus Grafana
  • Install
  • Known issues
  • Leases Tracking
  • Processes
    • coding guidelines
    • development Environment
    • gitlab howto
  • Releases
  • Releases
    • Release notes 0.1
    • Release notes 0.10
    • Release notes 0.11
    • Release notes 0.12
    • Release notes 0.13
View All Pages