4.33.9-rc01 [skip ci]

ReleaseNotes.md

@@ -1,19 +1,12 @@
-- 4.33.9-beta0x: Experimental: adding DATABASE_URL parameter to test automatic connection to Postgres database if deploying on fly.io
+- 4.33.9-rc01: Cloud Support Changes
+  - Added instructions for using [fly.io](https://fly.io) as a cloud provider. owlcms detects and connects to the postgres database provided by fly.io .
+  - Adjusted instructions for using Heroku now that there is no longer a free tier.
 - 4.33.8: A new "local templates only" checkbox is added on the Languages and Settings page. If selected, the built-in Excel templates will not be listed in the dropdown lists. Only what is in the `local/templates` folder (or has been uploaded as a zip) with be shown. You can therefore remove files you don't use from local/templates and rename the templates to your local language if you wish. 
-- 4.33.8: fixed uploading of zip file containing local overrides to support zips with non-Latin file names (replaced the standard Java library with an improved one)
-- 4.33.7: fix processing of empty rows in record definition files. Added Examples for Masters and for different file formats to [Record Definition Examples](https://www.dropbox.com/sh/409fqybabjv6byt/AADZIcMxn2Q8epqiZQX3EQk4a?dl=0)
-- 4.33.6: fix missing decision reminder when using phone or tablet
-- 4.33.6: wait for the actual 1/2/3/all button press to inform announcer that referee has been summoned
-- 4.33.6: new translation string for break management dialog, new language translations
-- 4.33.6: usability: more consistent naming of window tabs for group results
-- 4.33.6: small bug fixes when reading record definition files with U age groups.
-- Documented and cleaned-up processing of database environment variables
-- Log file now contains specific location of errors found when reading the record definition files. (#514)
-- Recommended update: Fix for possible birth date errors (one day early) on laptop installations
+- 4.33.7: Examples for Masters and for different file formats to [Record Definition Examples](https://www.dropbox.com/sh/409fqybabjv6byt/AADZIcMxn2Q8epqiZQX3EQk4a?dl=0)
+- 4.33.6: fixes for jury summoning referees and for referre reminders
+- **Recommended update if current version older than 4.33.4:** Fix for possible birth date errors (one day early) on laptop installations
   - Due to a bug in the way the H2 database driver stores dates that have no time zone (#513),  the birth date of the athletes would, in some time zones, be converted to the day before.
-- Current Athlete view layout now displays correctly on 1280 (720p TV), 1366 (common laptops) and 1920 (HD TV) resolutions.
 - A public-facing view decisions display has been added to the streaming-oriented displays, for convenience.  Currently this is the same as cropping the top-right corner of the scoreboard. In the future there might be options to just have the timer and the decisions.
-- Security update for postgresql JDBC driver.
 
 ##### Highlights from recent stable releases
 

docs/DigitalOcean.md

@@ -75,7 +75,7 @@ export RESULTS=results.owlcms.mywire.org
 2. This step fetches the configuration and substitutes the values for OFFICIALS and RESULTS before applying it.  
 
 ```powershell
-curl -sfL https://github.com/owlcms/owlcms4-prerelease/releases/download/4.33.9-beta04/k3s_setup.yaml | envsubst | kubectl apply -f - 
+curl -sfL https://github.com/owlcms/owlcms4-prerelease/releases/download/4.33.9-rc01/k3s_setup.yaml | envsubst | kubectl apply -f - 
 ```
 
 > Note: you may have to execute the command several times, because some steps take time to complete.  There is no harm done repeating the steps.  Wait 30 seconds or so between each attempt, every attempt will get further down the steps.  This is simpler than breaking down the setup in several steps. 

docs/DockerDesktop.md

@@ -17,7 +17,7 @@ Docker Desktop installs the `kubectl` utility that is used to control Kubernetes
 This step installs owlcms and its prerequisites into the Kubernetes cluster.  It does NOT configure the internet access, this is done in the later steps.
 
 ```powershell
-kubectl apply -f https://github.com/owlcms/owlcms4/releases/4.33.9-beta04/download/dd_setup.yaml
+kubectl apply -f https://github.com/owlcms/owlcms4/releases/4.33.9-rc01/download/dd_setup.yaml
 ```
 
 ## Link the cluster to KubeSail

docs/Downloads.md

@@ -2,7 +2,7 @@ Several options are available for installation, depending on your needs. Additio
 
 |                                                              |                                                              |
 | ------------------------------------------------------------ | ------------------------------------------------------------ |
-| **Local Setup** <br />This installs the `owlcms` program to run a competition locally, on a master laptop.  No internet connection is needed.<ul><li>[Windows Installation Instructions](https://owlcms.github.io/owlcms4-prerelease/#/LocalWindowsSetup)<li>[Mac/Linux Installation Instructions](https://owlcms.github.io/owlcms4-prerelease/#/LocalLinuxMacSetup)<li><nobr>[Release Notes](https://github.com/owlcms/owlcms4-prerelease/releases/tag/4.33.9-beta04)</nobr></ul> | <nobr><i class="material-icons" style="transform: translatey(0.30em)">file_download</i>  **[Windows Installer](https://github.com/owlcms/owlcms4-prerelease/releases/download/4.33.9-beta04/owlcms_setup.exe)**</nobr><br/><i class="material-icons" style="transform: translatey(0.30em)">file_download</i>[Mac/Linux Zip](https://github.com/owlcms/owlcms4-prerelease/releases/download/4.33.9-beta04/owlcms.zip) |
-| **Cloud-based Setup**<br />This installs the `owlcms` competition management software in the cloud. Good internet access is needed but no local software is needed. The `publicresults` companion program allows individuals to see the scoreboard on their own phone or tablet no matter where they are located.<ul><li>[Heroku Cloud Installation Instructions](https://owlcms.github.io/owlcms4-prerelease/#/Heroku)</li><li>Configuration Options for [Large Cloud Competitions](https://owlcms.github.io/owlcms4-prerelease/#/HerokuLarge)</li><li>[Updating to the current version](https://owlcms.github.io/owlcms4-prerelease/#/UpdatingCloudApplications)</li><li><nobr>[Release Notes](https://github.com/owlcms/owlcms4-prerelease/releases/tag/4.33.9-beta04)</nobr></li></ul> | <i class="material-icons" style="transform: translatey(0.30em)">cloud_upload</i> **[Competition Management Cloud Installer](https://github.com/owlcms/owlcms-heroku-prerelease/blob/master/README.md)**<br><i class="material-icons" style="transform: translatey(0.30em)">cloud_upload</i> [Public Results Scoreboard Cloud Installer](https://github.com/owlcms/publicresults-heroku-prerelease/blob/master/README.md)<br/><br/><i class="material-icons" style="transform: translatey(0.30em)">file_download</i>[Version Updater](https://github.com/owlcms/owlcms4-heroku-updater/releases) |
+| **Local Setup** <br />This installs the `owlcms` program to run a competition locally, on a master laptop.  No internet connection is needed.<ul><li>[Windows Installation Instructions](https://owlcms.github.io/owlcms4-prerelease/#/LocalWindowsSetup)<li>[Mac/Linux Installation Instructions](https://owlcms.github.io/owlcms4-prerelease/#/LocalLinuxMacSetup)<li><nobr>[Release Notes](https://github.com/owlcms/owlcms4-prerelease/releases/tag/4.33.9-rc01)</nobr></ul> | <nobr><i class="material-icons" style="transform: translatey(0.30em)">file_download</i>  **[Windows Installer](https://github.com/owlcms/owlcms4-prerelease/releases/download/4.33.9-rc01/owlcms_setup.exe)**</nobr><br/><i class="material-icons" style="transform: translatey(0.30em)">file_download</i>[Mac/Linux Zip](https://github.com/owlcms/owlcms4-prerelease/releases/download/4.33.9-rc01/owlcms.zip) |
+| **Cloud-based Setup**<br />This installs the `owlcms` competition management software in the cloud. Good internet access is needed but no local software is needed. The `publicresults` companion program allows individuals to see the scoreboard on their own phone or tablet no matter where they are located.<ul><li>[Heroku Cloud Installation Instructions](https://owlcms.github.io/owlcms4-prerelease/#/Heroku)</li><li>Configuration Options for [Large Cloud Competitions](https://owlcms.github.io/owlcms4-prerelease/#/HerokuLarge)</li><li>[Updating to the current version](https://owlcms.github.io/owlcms4-prerelease/#/UpdatingCloudApplications)</li><li><nobr>[Release Notes](https://github.com/owlcms/owlcms4-prerelease/releases/tag/4.33.9-rc01)</nobr></li></ul> | <i class="material-icons" style="transform: translatey(0.30em)">cloud_upload</i> **[Competition Management Cloud Installer](https://github.com/owlcms/owlcms-heroku-prerelease/blob/master/README.md)**<br><i class="material-icons" style="transform: translatey(0.30em)">cloud_upload</i> [Public Results Scoreboard Cloud Installer](https://github.com/owlcms/publicresults-heroku-prerelease/blob/master/README.md)<br/><br/><i class="material-icons" style="transform: translatey(0.30em)">file_download</i>[Version Updater](https://github.com/owlcms/owlcms4-heroku-updater/releases) |
 | **Documentation**                                            | [Documentation site](https://owlcms.github.io/owlcms4-prerelease/#/index) |
 

docs/Heroku.md

@@ -4,44 +4,44 @@
 
 Heroku is a cloud service provider that provides an attractive pricing plan for running programs like OWLCMS.  The installation process for Heroku is extremely simple and there is nothing whatsoever that needs to be installed on any of the laptops other than a browser.  
 
-There used to be a completely free plan, but this was discontinued in 2022. Because Heroku bills by the second, you can actually turn off your site when you don't use it.  By doing so the costs for preparing, running a competition and gathering the results is roughly 0.50 US$ per day.
+There used to be a completely free plan, but this was discontinued in 2022. Because Heroku bills by the second, you can actually turn off your site when you don't use it.  By doing so the costs for preparing, running a competition and gathering the results is roughly 0.50 US$ per day.  You can then stop billing (see the [Stopping and Resuming Billing](#stopping-and-resuming-billing) section below)
 
-For larger competitions, you can run a meet for less than 10$ per day, see the [large competition instructions](HerokuLarge).
+For larger competitions, you can run a very large meet for less than 10$ per day, see the [large competition instructions](HerokuLarge).  The instructions explain how to go back to the more economical setting afterwards  (or you can stop billing)
 
-**1. Create a free Heroku Account**
+### Preparation Step
+
+**1. Create a Heroku Account**
 
 - Go to page https://heroku.com
 - Create an account. Remember the login and password information.
 
-**2. Start the deployment process**
+### Install owlcms
+
+**1. Start the deployment process**
 
 Click on this purple button to start installation of owlcms on Heroku cloud.
 
 [![Deploy to Heroku](https://www.herokucdn.com/deploy/button.png)](https://heroku.com/deploy?template=https://github.com/owlcms/owlcms-heroku-prerelease)
 
-**3. Name your application and deploy**
+**2. Name your application and deploy**
 
 Enter the name that will be used by the officials.  Once you are done start the deployment (this will prepare the application and make it available)
 
 ![020_selectName](img/Heroku/020_selectName.png)
 
-**4. Check correct deployment**
+**3. Check correct deployment**
 
 ![030_deployApp](img/Heroku/030_deployApp.png)
 
-**5. Go to the application**
+**4. Go to the application**
 
 ![040_success](img/Heroku/040_success.png)
 
-**6. Time zone configuration**
+**5. Time zone configuration**
 
 Heroku data centers run on universal time by default (UTC).  So the times appearing in the intermission timers will be wrong, for instance.  You will therefore need to [set the competition time zone](Preparation#time-zone) according to the published schedule when  entering the competition information.
 
-## Check for updates
-
-Once you have created the application once, you can download a program that will check for updates and remote control Heroku to grab them.   See [Instructions](https://github.com/owlcms/owlcms-heroku-updater) and [Releases · owlcms/owlcms4-heroku-updater (github.com)](https://github.com/owlcms/owlcms4-heroku-updater/releases)
-
-## Control access to the application
+### Control access to the application
 
 In a gym setting, people can read the web addresses on the screens, and one day, some "funny" person will log in to the system and be tempted to mess things up.
 - We suggest that you set a PIN or Password that officials will be required to type when first logging in.  This is done on via the `Prepare Competition` page, using the `Language and System Settings` button.
@@ -61,6 +61,32 @@ In a gym setting, people can read the web addresses on the screens, and one day,
 
 - If you have set a password, you may need to set the OWLCMS_BACKDOOR variable to avoid entering passwords on the screens used for video broadcasting.
 
-## Configuration Parameters
+### Stopping and Resuming Billing
+
+> The easiest way to stop billing is to actually to delete the application from the Heroku page.   This is not as bad as it seems, because the installation process is very quick. This also ensures that you have the latest version the next time around.
+
+In order to stop billing *without* uninstalling the application, you need to install a command interface from [this page](https://devcenter.heroku.com/articles/heroku-cli). NOTE: you can IGNORE the prerequisite about `git`. It is NOT needed for our purpose.
+
+- First, start a command line window and type
+
+  ```
+  heroku login
+  ```
+
+- In order to stop billing on your application "myowlcms" (use your own name)
+
+  ```
+  heroku scale web:0 -a myowlcms
+  ```
+
+  Repeat with any other app you may have (for example, if you have installed publicresults)
+
+- In order to restart the application
+
+  ```
+  heroku scale web:1 -a myowlcms
+  ```
+
+### Scaling Up or Down
 
-See the [Configuration Parameters](./Configuration.md ':include') page to see additional configuration options in addition to the ones presented on this page.
+In order to run a very large competition (say over 100 athletes), you may want to allocate more memory and use a larger CPU.  You can run a very large meet for less than 10$ per day, by changing the settings as explained in [large competition instructions](HerokuLarge).  The instructions explain how to go back to the more economical setting afterwards  (or you can stop billing)

docs/k3d.md

@@ -78,7 +78,7 @@ export RESULTS=results.owlcms.youraccount.usw1.k8g8.com
 2. This step fetches the configuration and substitutes the values for OFFICIALS and RESULTS before applying it. 
 
 ```powershell
-curl -sfL https://github.com/owlcms/owlcms4/releases/download/4.33.9-beta04/k3d_setup.yaml | envsubst | kubectl apply -f - 
+curl -sfL https://github.com/owlcms/owlcms4/releases/download/4.33.9-rc01/k3d_setup.yaml | envsubst | kubectl apply -f - 
 ```
 
 > Note: you may have to execute the command several times, because some steps take time to complete.  There is no harm done repeating the steps.  Wait 30 seconds or so between each attempt, every attempt will get further down the steps.  This is simpler than breaking down the setup in several steps. 

pom.xml

@@ -27,7 +27,7 @@
     <properties>
         <!-- revision is overridden by azure-pipelines.yml for the official builds. this value is only used for local development -->
 
-        <revision>4.33.9-beta04</revision>
+        <revision>4.33.9-rc01</revision>
         <owlcms-maven-url>http://maven.lerta.ca:8088</owlcms-maven-url>
         <owlcms-maven-suffix>/releases</owlcms-maven-suffix><!-- /snapshots if revision is -SNAPSHOT -->
         <owlcms-docker>docker.io/owlcms</owlcms-docker>

version.txt

@@ -1 +1 @@
-4.33.9-beta04
+4.33.9-rc01