Skip to Content
Last modified by Erik Bakker on 2025/04/18 13:54
From version 104.1
edited by Erik Bakker
on 2024/03/08 11:40
Change comment: There is no comment for this version
To version 131.1
edited by Carlijn Kokkeler
on 2024/09/03 11:41
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.ebakker
1 +XWiki.CarlijnKokkeler
Content
... ... @@ -21,11 +21,14 @@
21 21  * Standard configuration to ensure that communication between your server and eMagiz to ensure communication.
22 22   ** registry.emagiz.com:443
23 23   ** controlplane.emagiz.com:8000
24 - ** Preferably the entry should be *.emagiz.com{{/info}}
24 + ** controltower.kpn-dsh.com:443
25 + ** Preferably the entry should be *.emagiz.com
26 + ** Preferably the entry should be *.kpn-dsh.com{{/info}}
25 25  
26 26  {{warning}}
27 27  * In case of a very strict firewall configuration, additional configuration is needed to communicate to the eMagiz infrastructure.
28 28   ** controltower.emagiz.com:443
31 + ** controltower.kpn-dsh.com:443
29 29   ** controlbus.emagiz.com:443
30 30   ** controlplane.emagiz.com:443
31 31  
... ... @@ -50,13 +50,33 @@
50 50  
51 51  
52 52  ==== 3.2.1 Docker Installation ====
53 -In powershell with administrative rights, execute the following commands
56 +To install or update docker on your machine, execute the following commands in powershell with administrative rights:
54 54  
55 55  {{code language="cmd"}}
56 -Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/microsoft/Windows-Containers/Main/helpful_tools/Install-DockerCE/install-docker-ce.ps1" -o install-docker-ce.ps1
57 -.\install-docker-ce.ps1
59 +Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/emagiz/windows-support/main/Install-update-docker/install-update-docker.ps1" -o install-update-docker-ce.ps1
60 +.\install-update-docker-ce.ps1 -DockerVersion DESIRED_VERSION
58 58  {{/code}}
59 59  
63 +{{info}}It is advised to use Docker version 24.0.7 as this is the version being used in the latest eMagiz cloud template. We advise to align the on-premise Docker version and update it according to the release notes of the [[Cloud templates>>doc:Main.Release Information.Cloud Templates.WebHome||target="blank"]].
64 +{{/info}}
65 +
66 +{{info}}
67 +By default the docker daemon configuration file is located in the docker data path at {{code language="cmd"}}C:\ProgramData\docker\config\daemon.json{{/code}}.
68 +To check the configuration options and compatible options with Windows you can check: [[Configure Docker in Windows>>https://learn.microsoft.com/en-us/virtualization/windowscontainers/manage-docker/configure-docker-daemon||target="blank"]].
69 +
70 +**Example usage of the Docker daemon file**: You maybe want the Docker daemon to keep images and containers in an alternate path (D:
71 +drive for example). To do so you can add the following attribute to the Docker daemon file:
72 +
73 +{{code language="cmd"}}
74 +{
75 + "data-root": "d:\\docker"
76 +}
77 +{{/code}}
78 +
79 +If not specified, the default is {{code language="cmd"}}c:\programdata\docker{{/code}}.
80 +
81 +{{/info}}
82 +
60 60  ==== 3.2.2 Check installation ====
61 61  
62 62  After executing the commands above, the server will restart if required. After the restart, execute the following command
... ... @@ -68,7 +68,7 @@
68 68  If the command returns that the command cannot be found, please run the following command again.
69 69  
70 70  {{code language="cmd"}}
71 -.\install-docker-ce.ps1
94 +.\install-update-docker-ce.ps1 -DockerVersion DESIRED_VERSION
72 72  {{/code}}
73 73  
74 74  ==== 3.2.3 Verify docker functionality ====
... ... @@ -87,6 +87,19 @@
87 87  
88 88  Install the eMagiz Deploy agent as can be found in this [[microlearning>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.eMagiz Runtime Management.intermediate-runtime-management-deploy-agent.WebHome||target="blank"]]
89 89  
113 +===3.3 Uninstall Docker===
114 +To uninstall docker from your machine, execute the following commands in powershell with administrative rights:
115 +
116 +{{code language="cmd"}}
117 +Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/emagiz/windows-support/main/Uninstall-docker/uninstall-docker.ps1" -o uninstall-docker-ce.ps1
118 +{{/code}}
119 +
120 +Example usage:
121 +
122 +{{code language="cmd"}}
123 +.\uninstall-docker-ce.ps1
124 +{{/code}}
125 +
90 90  == 4. Key takeaways ==
91 91  
92 92  * eMagiz uses runtime images to deploy emagiz runtime on dockerized environments. The runtime image holds all the information and components required to run the runtime
... ... @@ -95,6 +95,21 @@
95 95  
96 96  == 5. Suggested Additional Readings ==
97 97  
134 +** [[Fundamentals (Navigation)>>doc:Main.eMagiz Academy.Fundamentals.WebHome||target="blank"]]
135 +*** [[eMagiz Runtime Generation 3 (Explanation)>>doc:Main.eMagiz Academy.Fundamentals.fundamental-runtime-generation3||target="blank"]]
136 +* [[Release Information (Menu)>>doc:Main.Release Information.WebHome||target="blank"]]
137 +** [[Environment Templates (Navigation)>>doc:Main.Release Information.Cloud Templates.WebHome||target="blank"]]
138 +* [[Intermediate (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.WebHome||target="blank"]]
139 +** [[eMagiz Runtime Management (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.eMagiz Runtime Management.WebHome||target="blank"]]
140 +*** [[Interpret on-premise logging (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.eMagiz Runtime Management.intermediate-emagiz-runtime-management-interpret-on-premise-logging.WebHome||target="blank"]]
141 +*** [[eMagiz Deploy agent (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.eMagiz Runtime Management.intermediate-runtime-management-deploy-agent.WebHome||target="blank"]]
142 +* [[Advanced (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Advanced Level.WebHome||target="blank"]]
143 +** [[Lifecycle Management (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Advanced Level.Lifecycle Management.WebHome||target="blank"]]
144 +*** [[Impact of Runtime Image Upgrades (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Advanced Level.Lifecycle Management.advanced-lifecycle-management-impact-of-runtime-image-upgrades.WebHome||target="blank"]]
145 +* [[Expert (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Expert Level.WebHome||target="blank"]]
146 +** [[Solution Architecture (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Expert Level.Solution Architecture.WebHome||target="blank"]]
147 +*** [[Install Docker for Linux (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Expert Level.Solution Architecture.expert-solution-architecture-onpremises-server-linux-installguide.WebHome||target="blank"]]
148 +* [[Install Docker (Search Result)>>url:https://docs.emagiz.com/bin/view/Main/Search?sort=score&sortOrder=desc&highlight=true&facet=true&r=1&f_space_facet=0%2FMain.&f_type=DOCUMENT&f_locale=en&f_locale=&f_locale=en&text=install+docker||target="blank"]]
98 98  * Docker command line cheatsheet: [[image:Main.Images.Microlearning.WebHome@docker-cheatsheet.png]]
99 99  
100 100  )))((({{toc/}}))){{/container}}{{/container}}