RaceDB | Web-based bike race registration application | Frontend Framework library

There are two method to get RaceDB working - The hard way using lots of command line "code" as per the original install instructions (See OLD INSTALL METHOD below) from the source code - The easy way using Docker and the RaceDB-Container. If you are a seasoned RaceDB enthusist or a seasoned python programmer, feel free to run though the old install instructions. Otherwise, go download and install Docker ([http://www.docker.com]). Docker Desktop is available for Mac and Windows and Docker Community edition is available for Linux. Once Docker is installed, the installation procedure is straight forward.
The following information describes the install RaceDB on the command line. It is a cumbersome process only recommended to those making code changes to the application. We strongly recommend users use the Docker Container.
Step 1: Install Python 3.X:. Step 1a: Install GIT. Step 2: Unzip RaceDB.zip. Step 3: Open a cmd window (windows) or terminal window (Mac/Linux). Step 4: If on Windows, check and fix your Path. a) Close the "cmd" window. b) Follow the instructions to set your PATH here: [http://www.pythoncentral.io/add-python-to-path-python-is-not-recognized-as-an-internal-or-external-command/]. c) Return to Step 3 - make sure you close the old "cmd" window and open a new one. Step 4: If on Linux/Mac, make sure you are using Python3. Step 5: Install the RaceDB Dependencies. Step 6: Initialize the Database. Some starter Category Formats and Categories. Step 6.5: Initialize Demo Data. Step 7: Start the RaceDB Server (run RaceDB). Step 8: Windows Only: Create Launch Icons with different options. 1. On the existing "RaceDB Launch" desktop icon, right-click and select "Copy". 2. On the background of your desktop, right-click and select "Paste shortcut". This will create "RaceDB Launch (2)". 3. Right-click on "RaceDB Launch (2)" and select "Properties". 4. In the "Target" field, add the additional command options. In this case, you can set "launch --rfid__reader". The options exactly the same as described above. Press OK when you are done. 5. Right-click on "RaceDB Launch (2)" and select "Rename". Change the name to "RFID RaceDB". 6. It important to give your new launch icon a different name, otherwise it will be overwritten when you upgrade RaceDB.
Step 1: Install Python 3.X: If you are running Mac or Linux, you likely have this already. If not, go to [https://www.python.org/downloads/] Choose the latest installer of 64 bit python 3 for your platform. 32bit versions are not supported.
Step 1a: Install GIT On Windows, download git from https://gitforwindows.org/. Make sure git is available on your path. On Linux and MacOSX, git is usually installed by default.
Step 2: Unzip RaceDB.zip In Windows, consider unzipping it into "C:" to make a folder called "C:\RaceDB". This will make it easier later. On Linux/Mac, pick an easy location - you could pick your home directory (eg. ~/RaceDB)
Step 3: Open a cmd window (windows) or terminal window (Mac/Linux) On Windows, type "cmd" into the "Search program and files" after clicking on the launch button in the lower left. On other platforms, launch a terminal.
Step 4: If on Windows, check and fix your Path. In a md window, type: ``` python ``` If you get the message: ``` ‘python’ is not recognized as an internal or external command ``` You need to set your PATH. This is not hard, and you only need to do it once:
a) Close the "cmd" window
b) Follow the instructions to set your PATH here: [http://www.pythoncentral.io/add-python-to-path-python-is-not-recognized-as-an-internal-or-external-command/]
c) Return to Step 3 - make sure you close the old "cmd" window and open a new one.
Step 4a: In a cmd window, type: ```bash git ``` ``` ‘git’ is not recognized as an internal or external command ``` You need to set your PATH. You should have said yes to ADD TO PATH during installation of git. Logout or reboot your system to get the path updated.
Step 4: If on Linux/Mac, make sure you are using Python3 Linux can have many versions of python installed. Only python3 is supported. Check: python --version You may have to use the python3 command to get python3.
Step 5: Install the RaceDB Dependencies In your cmd/terminal window, make sure you are in the RaceDB install folder. Do a:
Step 6: Initialize the Database Ensure you are cd'd to the RaceDB directory (see above). In your cmd/terminal enter two commands:
Disciplines
Some starter Category Formats and Categories
Step 6.5: Initialize Demo Data Ensure you are cd'd to the RaceDB directory (see above). If you want s some demo data in your database and play with a tutorial, enter the following:
Some Tdf Riders
Some Tdf Teams
Step 7: Start the RaceDB Server (run RaceDB) If you are running on Windows, the install will create a desktop shortcut called "RaceDB Launch".This does the same as "python manage.py launch" shown below. If you are on Linux or wish to run from the command line, ensure you are cd'd to the RaceDB directory (see above). In your cmd/terminal enter:
Step 8: Windows Only: Create Launch Icons with different options On Windows, you can customize the desktop icon to include additional parameters. For example, say you want to launch RaceDB with the "--rfid_read" option from a desktop icon. To do so:
1. On the existing "RaceDB Launch" desktop icon, right-click and select "Copy".
2. On the background of your desktop, right-click and select "Paste shortcut". This will create "RaceDB Launch (2)"
3. Right-click on "RaceDB Launch (2)" and select "Properties"
4. In the "Target" field, add the additional command options. In this case, you can set "launch --rfid__reader". The options exactly the same as described above. Press OK when you are done.
5. Right-click on "RaceDB Launch (2)" and select "Rename". Change the name to "RFID RaceDB".
6. It important to give your new launch icon a different name, otherwise it will be overwritten when you upgrade RaceDB.
If you are currently running a RaceDB 1.X.X, you need to follow these upgrade steps to get to 3.X.X. You only need to do this once. After you are on RaceDB 3.X.X, upgrades will work as described in Install-Readme.txt (easier). RaceDB should work the same after the upgrade including the interface to the chip reader, CrossMgr download/upload, PDF generation, etc. etc. However, leave yourself some time before an event to do the upgrade and to check out things afterward. Testing has been extensive, but there is always the case there is something in your data that doesn’t work. All related fixes are generally easy and I should be able to turn the around quickly. These instructions are designed to be safe - you can return to the old RaceDB if something goes wrong. The reality is that Python2.7 was stopped being supported by Python.org in Jan 2020. Python3 is a necessary requirement for continued support. We will not assist with issues using version 2.7 of Python.