2025-04-24 influxdb - master branch - PR 1 of 2

InfluxDB has departed from the pattern established in 2021 whereby
pinning to the `1.8` tag was (effectively) a synonym for
"the latest release of InfluxDB 1".

At some point in the last few months, the `1.11` tag took on this role.
This seems to have happened after a period of experimentation involving
variants of `1.9-xx` and `1.10-xx`. It looks like there never were
plain `1.9` or `1.10` tags so we (IOTstack) really haven't missed much.

The 1.8 (and earlier) containers launched as root. The 1.11 container
launches as root but downgrades its privileges to user ID 1500
(user `influxdb` inside the container). In a clean-slate situation,
`docker-compose` will create the persistent store owned by root.
In an "upgrade 1.8 to 1.11" situation, the persistent store will be
owned by root. Version 1.11 does not appear to contain any self-repair
code for dealing with either of these situations, which means the
container is unable to access its persistent store, crashes, and goes
into a restart loop. Adding a `user: "0"` clause restores the 1.8
behaviour so 1.11 launches properly.

I have been running v1.11 for the last month without issues so I see
no reason not to make this the default for IOTstack.

The InfluxDB documentation web site for v1 which used to include a
`v1.8` path component now uses just `v1`. IOTstack documentation
updated accordingly.

The IOTstack documentation for InfluxDB 2 had numerous references to
"1.8". Updated to refer to version "1".

Signed-off-by: Phill Kelley <[email protected]>

Author: Paraphraser

.templates/influxdb/service.yml

@@ -1,7 +1,8 @@
 influxdb:
   container_name: influxdb
-  image: "influxdb:1.8"
+  image: "influxdb:1.11"
   restart: unless-stopped
+  user: "0"
   ports:
     - "8086:8086"
   environment:

docs/Containers/InfluxDB.md

@@ -13,16 +13,16 @@ InfluxDB has configurable aggregation and retention policies allowing measuremen
 
 - [DockerHub](https://hub.docker.com/_/influxdb/tags)
 - [GitHub home page](https://github.com/influxdata/influxdata-docker) (for the container)
-- [InfluxDB 1.8 documentation](https://docs.influxdata.com/influxdb/v1.8/)
-- [InfluxDB 1.8 configuration reference](https://docs.influxdata.com/influxdb/v1.8/administration/config)
+- [InfluxDB 1 documentation](https://docs.influxdata.com/influxdb/v1/)
+- [InfluxDB 1 configuration reference](https://docs.influxdata.com/influxdb/v1/administration/config)
 
 Note:
 
-* 	IOTstack uses the `influxdb:1.8` image. Substituting the `:latest` tag will get you InfluxDB version 2 and *will* create a mess.
+* 	IOTstack uses the `influxdb:1.x` image. Substituting the `:latest` tag will get you InfluxDB version 2 and *will* create a mess.
 
 ## Configuration { #configuration }
 
-All InfluxDB [settings](https://docs.influxdata.com/influxdb/v1.8/administration/config) can be applied using environment variables. Environment variables override any settings in the [InfluxDB configuration file](#configFile):
+All InfluxDB [settings](https://docs.influxdata.com/influxdb/v1/administration/config) can be applied using environment variables. Environment variables override any settings in the [InfluxDB configuration file](#configFile):
 
 * Under "new menu" (master branch), environment variables are stored inline in
 
@@ -152,8 +152,8 @@ You can open the `influx` CLI interactive shell by:
 
 ``` console
 $ docker exec -it influxdb influx
-Connected to http://localhost:8086 version 1.8.10
-InfluxDB shell version: 1.8.10
+Connected to http://localhost:8086 version 1.x.x
+InfluxDB shell version: 1.x.x
 >
 ```
 

docs/Containers/InfluxDB2.md

@@ -13,23 +13,23 @@
 	- DockerHub does not have a 32-bit image for InfluxDB 2 so you can't run this container until you have upgraded.
 	- Running full 64-bit is **not** the same as enabling the 64-bit kernel in `/boot/config.txt`. User-mode needs to be 64-bit capable as well. You must start from a [full 64-bit image](https://www.raspberrypi.com/software/operating-systems/#raspberry-pi-os-64-bit).
 
-2. Node-RED is your principal mechanism for feeding data to InfluxDB 1.8.
+2. Node-RED is your principal mechanism for feeding data to InfluxDB 1.
 
-	- You may have other services feeding data to InfluxDB 1.8 (eg Telegraf). The steps documented here will migrate all your existing data but do not discuss how to adapt services other than Node-RED to feed new data to InfluxDB 2.
+	- You may have other services feeding data to InfluxDB 1 (eg Telegraf). The steps documented here will migrate all your existing data but do not discuss how to adapt services other than Node-RED to feed new data to InfluxDB 2.
 
-3. Grafana is your principle mechanism for creating dashboards based on data stored in InfluxDB 1.8.
+3. Grafana is your principle mechanism for creating dashboards based on data stored in InfluxDB 1.
 
 	- You may have other visualisation tools. You may gain insights from studying how Grafana needs to be changed to run Flux queries against InfluxDB 2 buckets but this documentation does not explore alternatives.
 
-4. Node-RED, InfluxDB 1.8 and Grafana are all running in *non-host* mode on the same Docker instance, and that it is your intention to deploy InfluxDB 2 in *non-host* mode as well.
+4. Node-RED, InfluxDB 1 and Grafana are all running in *non-host* mode on the same Docker instance, and that it is your intention to deploy InfluxDB 2 in *non-host* mode as well.
 
 	- If you are running any containers in *host* mode or have distributed the services across multiple Docker instances, you will have to adapt appropriately.
 
 ## terminology: *database* vs *bucket*
 
-InfluxDB 1.8 and InfluxDB 2 are both database management systems (DBMS), sometimes referred to as "engines", optimised for storage and retrieval of time-series data. InfluxDB 1.8 uses the term *database* to mean a collection of *measurements*. InfluxDB 2 uses the term *bucket* to mean the same thing.
+InfluxDB 1 and InfluxDB 2 are both database management systems (DBMS), sometimes referred to as "engines", optimised for storage and retrieval of time-series data. InfluxDB 1 uses the term *database* to mean a collection of *measurements*. InfluxDB 2 uses the term *bucket* to mean the same thing.
 
-When an InfluxDB 1.8 *database* is migrated, it becomes an InfluxDB 2 *bucket*. You will see this change in terminology in various places, such as the InfluxDB-out node in Node-RED. When that node is set to:
+When an InfluxDB 1 *database* is migrated, it becomes an InfluxDB 2 *bucket*. You will see this change in terminology in various places, such as the InfluxDB-out node in Node-RED. When that node is set to:
 
 * Version 1.x, the user interface has a "Database" field which travels with the *connection*. For example:
 
@@ -175,30 +175,30 @@ To initialise InfluxDB 2:
 	$ docker logs influxdb2
 	```
 
-If you don't need to migrate any data from InfluxDB 1.8 you can go straight to [running InfluxDB 2](#runContainer), otherwise follow the [data-migration procedure](#migrateContainer) instructions below.
+If you don't need to migrate any data from InfluxDB 1 you can go straight to [running InfluxDB 2](#runContainer), otherwise follow the [data-migration procedure](#migrateContainer) instructions below.
 
 ## <a name="migrateContainer"></a>data-migration procedure
 
 Successful migration depends on the following assumptions being true:
 
 * The InfluxDB&nbsp;2 container is running and has just been initialised as per [initialising InfluxDB&nbsp;2](#initContainer).
-* The InfluxDB&nbsp;1.8 container is running, and is based on the IOTstack service definition (or reasonable facsimile) at:
+* The InfluxDB&nbsp;1 container is running, and is based on the IOTstack service definition (or reasonable facsimile) at:
 
 	```
 	~/IOTstack/.templates/influxdb/service.yml
 	```  
 
-To migrate your InfluxDB&nbsp;1.8 data:
+To migrate your InfluxDB&nbsp;1 data:
 
 1. Be in the correct directory (assumed throughout):
 
 	```bash
 	$ cd ~/IOTstack
 	```
 
-2. InfluxDB&nbsp;1.8 runs as root and its persistent store is owned by root but not all files and folders in the persistent store are *group* or *world* readable. InfluxDB&nbsp;2 runs as user ID 1000 (user "influxdb" inside the container). Because of this, you need to give InfluxDB&nbsp;2 permission to read the InfluxDB&nbsp;1.8 persistent store.
+2. InfluxDB&nbsp;1 runs as root and its persistent store is owned by root but not all files and folders in the persistent store are *group* or *world* readable. InfluxDB&nbsp;2 runs as user ID 1000 (user "influxdb" inside the container). Because of this, you need to give InfluxDB&nbsp;2 permission to read the InfluxDB&nbsp;1 persistent store.
 
-	It is not a good idea to interfere with a persistent store while a container is running so best practice is to stop InfluxDB&nbsp;1.8 for long enough to make a copy of its persistent store:
+	It is not a good idea to interfere with a persistent store while a container is running so best practice is to stop InfluxDB&nbsp;1 for long enough to make a copy of its persistent store:
 
 	```bash
 	$ sudo rm -rf ./volumes/influxdb.migrate
@@ -213,10 +213,10 @@ To migrate your InfluxDB&nbsp;1.8 data:
 	In words:
 
 	1. Ensure any previous attempts at migration are removed. Always be *extremely* careful with any `sudo rm` command. Check your work **before** you press <kbd>return</kbd>.
-	2. Stop InfluxDB&nbsp;1.8.
-	3. Make a copy of the InfluxDB&nbsp;1.8 persistent store.
-	4. Start InfluxDB&nbsp;1.8 again.
-	5. Change ownership of the **copy** of the InfluxDB&nbsp;1.8 persistent store.
+	2. Stop InfluxDB&nbsp;1.
+	3. Make a copy of the InfluxDB&nbsp;1 persistent store.
+	4. Start InfluxDB&nbsp;1 again.
+	5. Change ownership of the **copy** of the InfluxDB&nbsp;1 persistent store.
 
 3. Edit your compose file as per the "upgrade" column of [Table 1](#svcDefVars). The changes you need to make are:
 
@@ -236,7 +236,7 @@ To migrate your InfluxDB&nbsp;1.8 data:
 			    - DOCKER_INFLUXDB_INIT_MODE=upgrade
 			```
 
-	2. Activate the volume mapping to give InfluxDB&nbsp;2 read-only access to the **copy** of the InfluxDB&nbsp;1.8 persistent store that you made in step 2:
+	2. Activate the volume mapping to give InfluxDB&nbsp;2 read-only access to the **copy** of the InfluxDB&nbsp;1 persistent store that you made in step 2:
 
 		- before editing:
 
@@ -270,9 +270,9 @@ To migrate your InfluxDB&nbsp;1.8 data:
 	DOCKER_INFLUXDB_INIT_MODE=upgrade
 	```
 
-	This, combined with the absence of the "bolt" file, starts the migration process. You need to wait until the migration is complete. The simplest way to do that is to watch the size of the persistent store for InfluxDB&nbsp;2 until it stops increasing. Experience suggests that the InfluxDB&nbsp;2 persistent store will usually be a bit larger than InfluxDB&nbsp;1.8. For example:
+	This, combined with the absence of the "bolt" file, starts the migration process. You need to wait until the migration is complete. The simplest way to do that is to watch the size of the persistent store for InfluxDB&nbsp;2 until it stops increasing. Experience suggests that the InfluxDB&nbsp;2 persistent store will usually be a bit larger than InfluxDB&nbsp;1. For example:
 
-	* reference size for an InfluxDB&nbsp;1.8 installation:
+	* reference size for an InfluxDB&nbsp;1 installation:
 
 		```bash
 		$ sudo du -sh ./volumes/influxdb
@@ -330,7 +330,7 @@ The container now needs to be instructed to run in normal mode.
 
 	The absence of an active `DOCKER_INFLUXDB_INIT_MODE` variable places InfluxDB&nbsp;2 into normal run mode.
 
-4. If you have just performed a data migration, you can remove the **copy** of the InfluxDB&nbsp;1.8 persistent store:
+4. If you have just performed a data migration, you can remove the **copy** of the InfluxDB&nbsp;1 persistent store:
 
 	```bash
 	$ sudo rm -rf ./volumes/influxdb.migrate
@@ -396,14 +396,14 @@ Go to [initialising InfluxDB&nbsp;2](#initContainer).
 	```
 
 2. Sign in to the InfluxDB&nbsp;2 instance using your [«username»](#influxUsername) and [«password»](#influxPassword).
-3. Click on "Explore" in the left-hand tool strip. That is marked [A] in the screen shot. In the area marked [B] you should be able to see a list of the *buckets* that were migrated from InfluxDB&nbsp;1.8 *databases*.
+3. Click on "Explore" in the left-hand tool strip. That is marked [A] in the screen shot. In the area marked [B] you should be able to see a list of the *buckets* that were migrated from InfluxDB&nbsp;1 *databases*.
 
 	In the screen shot, I clicked on other fields to create a query:
 
 	- In area <a name="influxExplorer-B"></a>[B], I selected the "power/autogen" *bucket*;
 	- In area <a name="influxExplorer-C"></a>[C], I selected the "hiking2" (electricity meter) *measurement*;
 	- In area <a name="influxExplorer-D"></a>[D], I selected the "voltage" *field*;
-	- The bucket in this test is a migrated copy of an InfluxDB&nbsp;1.8 database. It was not ingesting live data so I also needed to change the duration popup menu [E] to a time-span that included the most-recent insertions;
+	- The bucket in this test is a migrated copy of an InfluxDB&nbsp;1 database. It was not ingesting live data so I also needed to change the duration popup menu [E] to a time-span that included the most-recent insertions;
 	- Then I clicked the "Submit" button [F]; and
 	- The result was the graph in [G].
 
@@ -435,7 +435,7 @@ Two important things to note here are:
 
 ![Node-RED flow models](./images/influxdb2-nodered-flow-models.jpeg)
 
-1. Assume you have an existing flow (eg a fairly standard [3-node flow](https://gist.github.com/Paraphraser/c9db25d131dd4c09848ffb353b69038f)) which is logging to an InfluxDB&nbsp;1.8 database. Your goal is to modify the flow to log the same data to the recently-migrated InfluxDB&nbsp;2 bucket. 
+1. Assume you have an existing flow (eg a fairly standard [3-node flow](https://gist.github.com/Paraphraser/c9db25d131dd4c09848ffb353b69038f)) which is logging to an InfluxDB&nbsp;1 database. Your goal is to modify the flow to log the same data to the recently-migrated InfluxDB&nbsp;2 bucket. 
 
 2. Start Node-RED if it is not running:
 
@@ -447,7 +447,7 @@ Two important things to note here are:
 3. Use a web browser to connect to your Node-RED instance.
 4. Drag a **new** InfluxDB-out node onto the canvas:
 
-	- This is exactly the same InfluxDB-out node that you have been using to write to your InfluxDB&nbsp;1.8 databases. There isn't a different node or package for InfluxDB&nbsp;2.
+	- This is exactly the same InfluxDB-out node that you have been using to write to your InfluxDB&nbsp;1 databases. There isn't a different node or package for InfluxDB&nbsp;2.
 	- Always drag a **new** InfluxDB-out node from the palette onto the canvas. Do not make the mistake of re-using an existing InfluxDB-out node (eg via copy and paste) because that is a very good way of breaking your flows.
 
 5. Double-click the InfluxDB-out node to open it:
@@ -552,7 +552,7 @@ Two important things to note here are:
 7. Click the Refresh button.
 8. Click Apply.
 
-In the side-by-side screen shots below, observations before the straight-line (missing data) segment were imported from InfluxDB&nbsp;1.8 while observations after the straight-line segment were inserted by the new InfluxDB-out node in Node-RED.
+In the side-by-side screen shots below, observations before the straight-line (missing data) segment were imported from InfluxDB&nbsp;1 while observations after the straight-line segment were inserted by the new InfluxDB-out node in Node-RED.
 
 ![compare results](./images/influxdb2-chart-vs-grafana.jpeg)
 
@@ -585,8 +585,8 @@ In the side-by-side screen shots below, observations before the straight-line (m
 
 ## migration strategy
 
-From the fact that both InfluxDB&nbsp;1.8 and InfluxDB&nbsp;2 can run in parallel, with Node-RED feeding the same data to both, it should be self-evident that you can repeat the data-migration as often as necessary, simply by starting from [re-initialising InfluxDB&nbsp;2](#reinitContainer).
+From the fact that both InfluxDB&nbsp;1 and InfluxDB&nbsp;2 can run in parallel, with Node-RED feeding the same data to both, it should be self-evident that you can repeat the data-migration as often as necessary, simply by starting from [re-initialising InfluxDB&nbsp;2](#reinitContainer).
 
-This implies that you can concentrate on one database at a time, adjusting Node-RED so that it writes each row of sensor data to both the InfluxDB&nbsp;1.8 database and corresponding InfluxDB&nbsp;2 bucket.
+This implies that you can concentrate on one database at a time, adjusting Node-RED so that it writes each row of sensor data to both the InfluxDB&nbsp;1 database and corresponding InfluxDB&nbsp;2 bucket.
 
 Having the data going to both engines means you can take your time adjusting your Grafana dashboards to be based on Flux queries. You can either retrofit InfluxDB&nbsp;2 bucket sources and Flux queries to existing dashboards, or build parallel dashboards from the ground up.