RDoc-2454_ver6-dockerChanges #1665

reebhub · 2023-06-12T09:08:14Z

RavenDB docker documentation updates

…to ver 6 and improve it

…r sharding pages fixes

gregolsky · 2023-06-26T11:44:23Z

...tation/6.0/Raven.Documentation.Pages/start/installation/running-in-docker-container.markdown

+  using a dedicated user rather than `root`.  
+  RavenDB `6.0` and up also use a Debian archive file 
+  ([.deb package](../../start/installation/gnu-linux/deb)), applying 
+  a uniform internal structure for Ubuntu and Windows Linux versions.  


What is Windows Linux?
Maybe:

Suggested change

a uniform internal structure for Ubuntu and Windows Linux versions.

a uniform internal structure for Ubuntu OS.

gregolsky · 2023-06-26T11:46:03Z

...tation/6.0/Raven.Documentation.Pages/start/installation/running-in-docker-container.markdown

+     due to CIFS protocol usage.  
+* **Platforms**  
+  RavenDB images are available for:  
+   * **Ubuntu** (20.04, 18.04, 16.04) or any other Debian-based distribution.  


Suggested change

* **Ubuntu** (20.04, 18.04, 16.04) or any other Debian-based distribution.

* **Ubuntu** (22.04, 20.04) or any other Debian-based distribution.

gregolsky · 2023-06-26T11:46:37Z

...tation/6.0/Raven.Documentation.Pages/start/installation/running-in-docker-container.markdown

+   * _Tag_: `windows-1809-latest`  
+     Latest RavenDB version, running on Windows Nano Server version 1809
+   * _Tag_: `windows-ltsc2022-latest`  
+     Latest RavenDB version, running on Windows Nano Server version 2022


Suggested change

Latest RavenDB version, running on Windows Nano Server version 2022

Latest RavenDB version, running on Windows Nano Server version LTSC2022

gregolsky · 2023-06-26T11:46:49Z

...tation/6.0/Raven.Documentation.Pages/start/installation/running-in-docker-container.markdown

+   * _Tag_: `windows-1809-latest-lts`  
+     Latest RavenDB LTS version, running on Windows Nano Server version 1809
+   * _Tag_: `windows-ltsc2022-latest-lts`  
+     Latest RavenDB LTS version, running on Windows Nano Server version 2022


Suggested change

Latest RavenDB LTS version, running on Windows Nano Server version 2022

Latest RavenDB LTS version, running on Windows Nano Server version LTSC2022

gregolsky · 2023-06-26T12:08:18Z

...tation/6.0/Raven.Documentation.Pages/start/installation/running-in-docker-container.markdown

+After running the image, access it from a browser using its URL.  
+By default:  `http://localhost:8080`  
+
+If the server is not installed yet, connecting it will start the setup wizard.  


Suggested change

If the server is not installed yet, connecting it will start the setup wizard.

If the server is not installed yet, connecting it will start the Setup Wizard.

gregolsky · 2023-06-26T12:10:09Z

...tation/6.0/Raven.Documentation.Pages/start/installation/running-in-docker-container.markdown

+To install using the `latest` tag, and persist the data stored on your 
+hard disk if the container is removed, you can use:  
+{CODE-BLOCK:bash}
+docker run --rm -d -p 8080:8080 -p 38888:38888 -v c:/RavenDb/Data:/opt/RavenDB/Server/RavenData ravendb/ravendb


This line should probably use new data dir that's used when installed from DEB /var/lib/ravendb.. something

done
docker run --rm -d -p 8080:8080 -p 38888:38888 -v /var/lib/ravendb/data ravendb/ravendb

gregolsky · 2023-06-26T12:10:29Z

...tation/6.0/Raven.Documentation.Pages/start/installation/running-in-docker-container.markdown

+* [Ubuntu image Dockerfile](https://github.com/ravendb/ravendb/tree/v5.4/docker/ravendb-ubuntu)  
+* [Windows Nano Server image Dockerfile](https://github.com/ravendb/ravendb/tree/v5.4/docker/ravendb-nanoserver)  


Suggested change

* [Ubuntu image Dockerfile](https://github.com/ravendb/ravendb/tree/v5.4/docker/ravendb-ubuntu)

* [Windows Nano Server image Dockerfile](https://github.com/ravendb/ravendb/tree/v5.4/docker/ravendb-nanoserver)

* [Ubuntu image Dockerfile](https://github.com/ravendb/ravendb/tree/v6.0/docker/ravendb-ubuntu)

* [Windows Nano Server image Dockerfile](https://github.com/ravendb/ravendb/tree/v6.0/docker/ravendb-nanoserver)

gregolsky · 2023-06-26T12:11:53Z

...tation/6.0/Raven.Documentation.Pages/start/installation/running-in-docker-container.markdown

+
+#### Changes made in RavenDB `6.0` and up:
+
+The **user** that installs and runs RavenDB `6.0` and up 


Suggested change

The **user** that installs and runs RavenDB `6.0` and up

The **user** running RavenDB `6.0` and up

gregolsky · 2023-06-26T12:12:13Z

...tation/6.0/Raven.Documentation.Pages/start/installation/running-in-docker-container.markdown

+#### Changes made in RavenDB `6.0` and up:
+
+The **user** that installs and runs RavenDB `6.0` and up 
+and the **folders structure** used by these versions are 


Suggested change

and the **folders structure** used by these versions are

and the **directory structure** used by these versions are

gregolsky · 2023-06-26T12:13:00Z

...tation/6.0/Raven.Documentation.Pages/start/installation/running-in-docker-container.markdown

+These changes need to be addressed when migrating from 
+version `5.x` or lower to version `6.0` and higher.  
+
+* RavenDB Docker images up to `5.x`:  


I'm not sure what's this section about

moved it below the described differences, it looks like this now:

The user that...

RavenDB Docker images up to...

RavenDB Docker images from...

These differences need to be addressed when migrating from
version 5.x or lower to version 6.0 and higher.

gregolsky · 2023-06-26T12:14:42Z

...tation/6.0/Raven.Documentation.Pages/start/installation/running-in-docker-container.markdown

+* Permit the `ravendb` user to access the image directory.  
+  The default **UID** (User ID) and **GID** (Group ID) 
+  used by `ravendb` are **999**.  
+  Set the data folder permissions to these values (or 


For me folder is more of a Windows thing, as in an icon on the desktop. Technically speaking it's a directory.

Suggested change

Set the data folder permissions to these values (or

Set the data directory permissions to these values (or

changed everywhere

gregolsky · 2023-06-26T12:16:11Z

...tation/6.0/Raven.Documentation.Pages/start/installation/running-in-docker-container.markdown

+* Migrate files and data  
+  The setup process will create the folders structure detailed 
+  [here](../../start/installation/gnu-linux/deb#file-system-locations).  
+  When setup is done, migrate or link the contents stored in the 


We need to include that The script inside the image is going to try to link legacy data dir to the new one automatically.

The script within the image will attempt to link the old version's data directory to the new version's data directory automatically. If this attempt fails, an error will be produced. When setup is done, migrate or link the contents stored in the old RavenDB directories to the newly created structure. Most notably, make sure that the data is available in its new location: `/var/lib/ravendb/data`

gregolsky · 2023-06-26T12:40:06Z

...tation/6.0/Raven.Documentation.Pages/start/installation/running-in-docker-container.markdown

+
+      Safe by default, optimized for efficiency
+
+ Build 40040, Version 4.1, SemVer 4.1.4, Commit dc2e9e3


We might wanna update these

RDoc-2470 - cloud backups are kept in the same geographical region as the backed up data

… in the same geographical location in Europe and the US.

reebhub added 2 commits June 12, 2023 12:06

RDoc-2454_ver6-dockerChanges - import basic docker installation page …

ccb7179

…to ver 6 and improve it

RDoc-2454_ver6-dockerChanges - improved docker installation page

66672c7

ppekrol mentioned this pull request Jun 22, 2023

RDoc-2397 Document 6.0 docker Linux image breaking changes in readmes ravendb/ravendb#16082

Merged

RDoc-2454_ver6-dockerChanges - migration from 5.x to 6.0 and up, mino…

a48b315

…r sharding pages fixes

reebhub requested a review from gregolsky June 25, 2023 14:07

reebhub added 2 commits June 26, 2023 11:29

RDoc-2460 - include LTSC 2022 tag in the list of available tags

26ab438

RDoc-2454_ver6-dockerChanges - improved the migration explanations

e18f376

gregolsky reviewed Jun 26, 2023

View reviewed changes

reebhub added 2 commits June 26, 2023 16:02

RDoc-2454_ver6-dockerChanges - fixed by review comments

4c39fc4

RDoc-2470 - cloud backups are kept in the same geographical region as the backed up data

RDoc-2454_ver6-dockerChanges - updated the comment about backups kept…

7b96181

… in the same geographical location in Europe and the US.

gregolsky approved these changes Jun 27, 2023

View reviewed changes

ppekrol merged commit 3dce803 into ravendb:master Jun 27, 2023
1 of 2 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

RDoc-2454_ver6-dockerChanges #1665

RDoc-2454_ver6-dockerChanges #1665

reebhub commented Jun 12, 2023

gregolsky Jun 26, 2023

reebhub Jun 26, 2023

gregolsky Jun 26, 2023

reebhub Jun 26, 2023

gregolsky Jun 26, 2023

reebhub Jun 26, 2023

gregolsky Jun 26, 2023

reebhub Jun 26, 2023

gregolsky Jun 26, 2023

reebhub Jun 26, 2023

gregolsky Jun 26, 2023

reebhub Jun 26, 2023

gregolsky Jun 26, 2023

reebhub Jun 26, 2023

gregolsky Jun 26, 2023

reebhub Jun 26, 2023

gregolsky Jun 26, 2023

reebhub Jun 26, 2023

gregolsky Jun 26, 2023

reebhub Jun 26, 2023

gregolsky Jun 26, 2023

reebhub Jun 26, 2023

gregolsky Jun 26, 2023

reebhub Jun 26, 2023

gregolsky Jun 26, 2023

reebhub Jun 26, 2023

	a uniform internal structure for Ubuntu and Windows Linux versions.
	a uniform internal structure for Ubuntu OS.

	* Ubuntu (20.04, 18.04, 16.04) or any other Debian-based distribution.
	* Ubuntu (22.04, 20.04) or any other Debian-based distribution.

	Latest RavenDB version, running on Windows Nano Server version 2022
	Latest RavenDB version, running on Windows Nano Server version LTSC2022

	Latest RavenDB LTS version, running on Windows Nano Server version 2022
	Latest RavenDB LTS version, running on Windows Nano Server version LTSC2022

	If the server is not installed yet, connecting it will start the setup wizard.
	If the server is not installed yet, connecting it will start the Setup Wizard.

		* [Ubuntu image Dockerfile](https://github.com/ravendb/ravendb/tree/v5.4/docker/ravendb-ubuntu)
		* [Windows Nano Server image Dockerfile](https://github.com/ravendb/ravendb/tree/v5.4/docker/ravendb-nanoserver)


		#### Changes made in RavenDB `6.0` and up:

		The user that installs and runs RavenDB `6.0` and up

	The user that installs and runs RavenDB `6.0` and up
	The user running RavenDB `6.0` and up

	and the folders structure used by these versions are
	and the directory structure used by these versions are

	Set the data folder permissions to these values (or
	Set the data directory permissions to these values (or


		Safe by default, optimized for efficiency

		Build 40040, Version 4.1, SemVer 4.1.4, Commit dc2e9e3

RDoc-2454_ver6-dockerChanges #1665

RDoc-2454_ver6-dockerChanges #1665

Conversation

reebhub commented Jun 12, 2023

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment