Skip to content

Getting started

Thomas Emil Jensen edited this page Oct 1, 2023 · 8 revisions

🇩🇰 Dansk | 🇬🇧 English


Are you organising a Danish orienteering division match, and do you want to publish division results live and online? You've come to the right place!

Terminology

The pages here describe division-result-bridge, which is the client component in a client-server solution, with the server being division-result-server. From here on out, division-result-bridge will be referred to as the client, and division-result-server as the server or web server.

The client is used by the division match organiser to orchestrate the production of division results, and to communicate with the server for event configuration and upload of results. The server stores competition data, including metadata and results, and hosts a web application that runners and other interested parties can use to view the results.

Prerequisites

Usage of the client assumes a setup consisting of the following pieces of software:

It has been tested with MeOS 3.7SD and Divisionsmatchberegning 2023.0.0 on Windows 10, but newer versions should work as well.

Further requirements include:

  • ~100 MB of storage space
  • Internet connection
  • Support for the x86_64 CPU instruction set

The client itself takes up less than 100 MB of storage space, and intermediate files contribute only a negligible amount. Should you wish to save log files as well, the space requirements depend on client usage, but under normal circumstances, the logs take up a negligible amount of space.

The client needs the internet connection to upload results to the server. A stable connection is obviously preferable, but occasional drop-outs are not an issue; the latest results will simply be delayed until the connection is reestablished. The client does not need to be hosted on a machine with a publicly-visible IP address. It can even run on mobile data behind CGNAT, as is often required at orienteering events.

If your CPU does not natively support x86_64, it may still be possible to run the client through an emulation layer. Alternatively, the source code is freely available, allowing you to compile it with a C++ compiler targeting the native architecture of your CPU.


Next: Install the client

Clone this wiki locally