Differences

This shows you the differences between two versions of the page.

--- software:intro:install [2022/03/14 09:30] – torben
+++ software:intro:install [2024/10/02 07:47] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 {{indexmenu_n>10}}
-====== Installation: BBT ======
+====== Installation ======
 To start timing using the BBT timing software it must be installed on your Windows computer. This enables you to use your computer as a client allowing you to connect to other servers (see [[software:intro:architecture|]]).
@@ Line 11: / Line 11: @@
 ===== Install BBT software =====
-  - Have the installation file **BBTinstaller.exe** ready. If you do not have the file, please use this link [[https://blackboxtiming.com/contact|blackboxtiming.com/contact]] and follow the steps until you reach this screen where you find a link to download the installer. On this page you will also find the license key which you will need later in the installation process {{ :software:skaermbillede_2022-03-14_095959.jpg |}}
+  - Have the installation file **BBTinstaller.exe** ready. If you do not have the file, please use this link [[https://blackboxtiming.com/contact|blackboxtiming.com/contact]] to contact us
   - Establish an Internet connection
   - Start the installation (please note that the installer will update itself if needed)
@@ Line 18: / Line 18: @@
 {{:software:installer.png|}}
-//Note: It is a requirement that you have Microsoft .NET Framework 4.8 on your computer. This is normally handled by Windows itself and is most likely not something you have to worry about.//
+//Note: It is a requirement that you have Microsoft .NET Framework 4.8 on your computer. This is normally handled by Windows itself and is most likely not something you have to worry about. Otherwise you can download the runtime [[https://dotnet.microsoft.com/en-us/download/dotnet-framework/net48 |here]]. //
-===== Install a database server =====
-//Note: This step can be skipped if you only use your computer as a client to connect to other timing servers//
-If you need to store all event data you must have a database server available on your computer.
-BBT supports the commonly used and free MySQL server
-If you already have MySQL server installed on your computer, you can skip the installation of the server - if not, please press this link [[software:intro:install_mysql|]] to install a MySQL server
-:!: Please remember the administrator (root) password you selected during installation
 ===== Configuring BBT =====
-//Note: This step can be skipped if you only use your computer as a client to connect to other timing servers//
+The first time you launch BBT it will ask you to enter your license key and set up a database.
-{{:software:launcher.png|}}
+If you only use your computer as a client to connect to other local timing servers you do not need to set up a local database, and in many cases do not require a license as well.
+{{:software:initial-setup.png?nolink |}}
 ==== Enter license key ====
-Please press "License" and input the license key
+Please press "Enter license key" and input the license key.
-{{ :software:skaermbillede_2022-03-11_132813.jpg |}}
+The license key can be found on https://bbtiming.com where you log in using your profile (see further above).
-The license key can be found on bbtiming.com where you log in using your profile (see further above).
-A valid license key has this format: **XXXX-XXXX-XXXX-XXXX-XXX**
+A valid license key has this format: XXXX-XXXX-XXXX-XXXX-XXX
 Each key can be bound to a limited number of computers, depending on your license conditions.
 Please contact us at info@blackboxtiming.com if you can not find your license key.
 ==== Configure database ====
-When the MySQL server is installed, we need to tell the BBT timing software how to connect to this new server. This is done from the 'Database' menu.
+If you want to time events on this computer, you need a MySQL database server installed. This is free software, and BBT will help you install it. Alternatively, if you prefer, you may choose to download and install it manually from www.mysql.com (MySQL Community Server) before proceeding.
+Please click the "Set up database" button to get started.
+We recommend to let BBT configure everything for you by choosing to either install a MySQL server for you, or create a new empty database in the existing server, if you already have MySQL Server installed.
-We recommend to let BBT configure everything for you by choosing to create a new empty database.
 {{:software:launcher-database-wizard.png}}
-Enter the username and password you chose during the MySQL installation. When you press "next", BBT will create and set up a new database.
+If installing a new MySQL server, select an administrator password to use for the installation. If you have an existing MySQL server, enter the username and password you chose during the MySQL installation. When you press "next", BBT will create and set up a new database for you.
-:!: For the best experience using the BBT timing software, you should enter a MySQL-user that has access to creating new databases. This will happen automatically to the default user when installing MySQL using this guide.
+:!: Advanced users: For the best experience using the BBT timing software, you should enter a MySQL-user that has access to creating new databases. This will happen automatically when installing MySQL using this guide.
-{{:software:launcher-database-wizard-2.png}}
+{{:software:launcher-database-wizard-install.png}}
-==== Optional: Firewall rules====
-If you want to reach the timing computer from other computers on the network, you may want to open the ports to allow incoming connections to the server.This is done by:
-  - Opening "Windows Defender Firewall" from the Windows start-menu
-  - Pressing "Advanced settings" in the left menu which will open a new window
-  - Pressing "Inbound rules" in the left panel
-  - Pressing "New rule" in the Actions-panel on the right
-TCP port 18498: Used for server-client communication\\
+==== All done ====
-TCP port 80: Used for the built-in web interface (commentator screens etc.)
+Congratulations! You now have a working configured BBT installation and are ready to start timing.
-{{:software:install:firewall-rule.png}}
+{{:software:initial-setup-done.png?nolink}}