README.md 3.54 KB
Newer Older
Mattias Päivärinta's avatar
Mattias Päivärinta committed
1
# Zonemaster Backend
2
[![Build Status](https://travis-ci.org/zonemaster/zonemaster-backend.svg?branch=master)](https://travis-ci.org/zonemaster/zonemaster-backend)
Patrik Wallström's avatar
Patrik Wallström committed
3

Mattias Päivärinta's avatar
Mattias Päivärinta committed
4

5
6
7
### Purpose
This repository is one of the components of the Zonemaster software. For an
overview of the Zonemaster software, please see the
8
[Zonemaster repository](https://github.com/zonemaster/zonemaster).
Patrik Wallström's avatar
Patrik Wallström committed
9
10
11
12
13
14

This module is the Backend JSON/RPC weservice for the Web Interface part of
the Zonemaster project. It offers a JSON/RPC api to run tests one by one
(as the zonemaster-gui web frontend module does, or by using a batch API to
run the Zonemaster engine on many domains)

15
16
A Zonemaster user needs to install the backend only in the case where there is a
need of logging the Zonemaster test runs in one's own respective database for
Mattias Päivärinta's avatar
Mattias Päivärinta committed
17
analysing.
18
19


20
### Prerequisites
21

22
23
Before you install the Zonemaster Backend, you need the
Zonemaster Engine installed. Please see the
24
[Zonemaster Engine installation
25
instructions](https://github.com/zonemaster/zonemaster-engine/blob/master/docs/Installation.md).
26

Mattias Päivärinta's avatar
Mattias Päivärinta committed
27

28
29
### Upgrade 

30
31
If you upgrade Zonemaster-Backend and want to keep the content of the database
(MySQL/MariaDB or PostgrSQL) then you should not reset the database when you
32
follow the [installation instructions]. In some cases you need to patch the
33
database when you update Zonemaster-Backend.
34

35
Always take a backup first if the database is valuable.
36

37
38
39
40
41
42
Current version                     | Link to instructions  | Comments
------------------------------------|-----------------------|-----------------------
Older than 1.0.3                    | [Upgrade to 1.0.3]    |
At least 1.0.3 but older than 1.1.0 | [Upgrade to 1.1.0]    |
At least 1.1.0 but older than 5.0.0 | [Upgrade to 5.0.0]    |
At least 5.0.0 but older than 5.0.2 | [Upgrade to 5.0.2]    | For MySQL/MariaDB only
43

44
45
46
47
If the database was created before Zonemaster-Backend version 5.0.0, then you
have to upgrade in several steps.

To complete the upgrade follow the [installation instructions], except for creating
48
the database. If you instead want to start from an empty database, then you remove the database
49
and create a new database using the [installation instructions].
Mattias Päivärinta's avatar
Mattias Päivärinta committed
50

51
### Installation
Patrik Wallström's avatar
Patrik Wallström committed
52

53
Follow the detailed [installation instructions].
Patrik Wallström's avatar
Patrik Wallström committed
54
55


Mattias Päivärinta's avatar
Mattias Päivärinta committed
56
### Configuration
57

Mattias Päivärinta's avatar
Mattias Päivärinta committed
58
See the [configuration documentation].
59

Patrik Wallström's avatar
Patrik Wallström committed
60

61
### Documentation
Patrik Wallström's avatar
Patrik Wallström committed
62

63
64
65
66
67
68
69
70
71
72
The Zonemaster Backend documentation is split up into several documents:

* A number of [Typographic Conventions](docs/TypographicConventions.md) are used
  throughout this documentation.
* The [Architecture](docs/Architecture.md) document describes each of the
  Zonemaster Backend components and how they operate. It also discusses all
  central concepts needed to understand the Zonemaster backend, and contains a
  glossary over domain specific technical terms.
* The [Getting Started](docs/GettingStarted.md) guide walks you through creating
  a *test* and following it through its life cycle, all using JSON-RPC calls to
Michal TOMA's avatar
Michal TOMA committed
73
74
  the *RPC API daemon*.
* The [API](docs/API.md) documentation describes the *RPC API daemon* inteface in
75
76
  detail.

Patrik Wallström's avatar
Patrik Wallström committed
77

Mattias Päivärinta's avatar
Mattias Päivärinta committed
78
## License
Patrik Wallström's avatar
Patrik Wallström committed
79

Patrik Wallström's avatar
Patrik Wallström committed
80
81
The software is released under the 2-clause BSD license. See separate
[LICENSE](LICENSE) file.
Mattias Päivärinta's avatar
Mattias Päivärinta committed
82
83
84


[Configuration documentation]: docs/Configuration.md
mats Dufberg's avatar
mats Dufberg committed
85
86
87
88
89
[Installation instructions]:   docs/Installation.md
[Upgrade to 1.0.3]:            docs/upgrade_db_zonemaster_backend_ver_1.0.3.md
[Upgrade to 1.1.0]:            docs/upgrade_db_zonemaster_backend_ver_1.1.0.md
[Upgrade to 5.0.0]:            docs/upgrade_db_zonemaster_backend_ver_5.0.0.md
[Upgrade to 5.0.2]:            docs/upgrade_db_zonemaster_backend_ver_5.0.2.md