... | ... | @@ -4,6 +4,69 @@ |
|
|
|
|
|
Stork doesn't have any end user installation instructions yet. *Very* early adopters may take a look at the [dependencies](https://gitlab.isc.org/isc-projects/stork/wikis/Development-Environment#dependencies) and [building and running Stork](https://gitlab.isc.org/isc-projects/stork/wikis/Development-Environment#building-testing-and-running-stork) sections of the development environment page.
|
|
|
|
|
|
## Ubuntu (docker)
|
|
|
|
|
|
Get the stork sources, then:
|
|
|
```
|
|
|
$ rake docker_up
|
|
|
```
|
|
|
This is by far the simplest method. However, it requires docker environment to be up and running.
|
|
|
|
|
|
## Ubuntu (native)
|
|
|
|
|
|
1. Make sure that postgresql is installed:
|
|
|
|
|
|
```
|
|
|
$ sudo apt install postgresql postgresql-client
|
|
|
$ sudo systemctl start postgresql
|
|
|
```
|
|
|
|
|
|
2. 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
|
|
|
```
|
|
|
|
|
|
3. 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
|
|
|
```
|
|
|
|
|
|
4. Install Rake: `sudo apt install rake`
|
|
|
5. Build the code:
|
|
|
```
|
|
|
rake build_agent build_backend build_migrations build_server build_ui
|
|
|
```
|
|
|
6. Initialize the db:
|
|
|
```
|
|
|
$ backend/cmd/stork-db-migrate/stork-db-migrate init
|
|
|
$ backend/cmd/stork-db-migrate/stork-db-migrate up
|
|
|
```
|
|
|
|
|
|
7. Run server in one console: `rake run_server`
|
|
|
|
|
|
8. Run the UI in another console: `rake serve_ui`
|
|
|
|
|
|
9. 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.
|
... | ... | |