DEPLOY.rst 1.63 KB
Newer Older
juga's avatar
juga committed
1
2
.. _deploy:

3
Deploying Simple Bandwidth Scanner
Matt Traudt's avatar
Matt Traudt committed
4
=====================================
5
6
7

So you want to run sbws for yourself. You will need

juga's avatar
juga committed
8
9
- A machine to run the :term:`scanner`.
- One or more :term:`destination` (s) that serve a large file.
10

juga's avatar
juga committed
11
12
Both :term:`scanner` and your :term:`destination` (s) should be on fast,
well connected machines.
13

14
.. _destinations_requirements:
15

16
17
:term:`destination` requirements
------------------------------------
18

19
20
21
- A Web server installed and running that supports HTTP GET, HEAD and
  Range (:rfc:`7233`) requests.
  ``Apache`` HTTP Server and ``Nginx`` support them.
Matt Traudt's avatar
Matt Traudt committed
22
23
- Optional support for TLS
- A large file; at the time of writing, at least 1 GiB in size
24

juga's avatar
juga committed
25
26
:term:`scanner` setup
----------------------
27

Matt Traudt's avatar
Matt Traudt committed
28
Install sbws according to :doc:`/INSTALL`.
29

30
``sbws scanner`` needs :term:`destination` (s) to request files from.
31
They are not included by default.
32

33
34
To configure destinations, create a configuration file according to
:doc:`man_sbws.ini`
35

juga's avatar
juga committed
36
It is not required, but it is recomended to include a custom scanner
37
``nickname`` in the configuration file`.
38

juga's avatar
juga committed
39
Destination(s) configuration in more detail::
40

Matt Traudt's avatar
Matt Traudt committed
41
42
43
44
    [destinations]
    foo = on
    bar = on
    baz = off
45

Matt Traudt's avatar
Matt Traudt committed
46
    [destinations.foo]
juga's avatar
juga committed
47
    url = http://example.org/sbws.bin
48

Matt Traudt's avatar
Matt Traudt committed
49
    [destinations.bar]
juga's avatar
juga committed
50
    url = https://example.com/data
51

Matt Traudt's avatar
Matt Traudt committed
52
    [destinations.baz]
juga's avatar
juga committed
53
    url = https://example.net/ask/stan/where/the/file/is.exe
54

Matt Traudt's avatar
Matt Traudt committed
55
``foo`` demonstrates a typical case.
56

Matt Traudt's avatar
Matt Traudt committed
57
58
59
``bar`` demonstrates a case where you want to use HTTPS and want to assume the
large file for sbws to download is at its default path (probably
``/sbws.bin``).
juga's avatar
juga committed
60

Matt Traudt's avatar
Matt Traudt committed
61
``baz`` demonstrates a disabled destination that sbws will ignore.
juga's avatar
juga committed
62