Skip to Content
Last modified by Erik Bakker on 2025/04/18 13:54
From version 102.1
edited by Eva Torken
on 2024/03/01 15:32
Change comment: There is no comment for this version
To version 125.1
edited by Carlijn Kokkeler
on 2024/03/29 09:23
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.etorken
1 +XWiki.CarlijnKokkeler
Content
... ... @@ -21,28 +21,39 @@
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 -* In case of a very strict firewall configuration, additional configuration is needed.
29 +* 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  
32 -* When using cloudslot number 125 or less, the following configuration is needed.
35 +* When using cloudslot number **equal to or below** 125, the following configuration is needed to communicate to your JMS.
33 33   ** 35.158.46.28:443
34 34   ** 3.74.190.88:443
35 35   ** 35.158.46.28:8443
36 36   ** 3.74.190.88:8443
37 37   ** 35.158.46.28:8444
38 - ** 3.74.190.88:8444 {{/warning}}
41 + ** 3.74.190.88:8444
39 39  
43 +* When using a cloudslot number **above** 125, the following configuration is needed to communicate to your JMS.
44 + ** 3.74.209.20:443
45 + ** 3.76.127.155:443
46 + ** 3.74.209.20:8443
47 + ** 3.76.127.155:8443
48 + ** 3.74.209.20:8444
49 + ** 3.76.127.155:8444{{/warning}}
50 +
40 40  ===3.2 Installation Windows===
41 -Whenever Windows is selected as operating system, you need to have a Windows Server 2022 version or a 2019 version (> 1806). Older Windows servers are **not** supported.
52 +Whenever Windows is selected as operating system, you need to have a Windows Server 2022 version. Older Windows servers are **not** supported.
42 42  
43 43  
44 44  ==== 3.2.1 Docker Installation ====
45 -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:
46 46  
47 47  {{code language="cmd"}}
48 48  Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/microsoft/Windows-Containers/Main/helpful_tools/Install-DockerCE/install-docker-ce.ps1" -o install-docker-ce.ps1
... ... @@ -49,6 +49,30 @@
49 49  .\install-docker-ce.ps1
50 50  {{/code}}
51 51  
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 +{{warning}}
71 +Ignore the Uninstall section as it is outdated (For Windows Server 2016), instead refer to the previous section to Uninstall docker
72 +{{/warning}}
73 +
74 +**Example usage of the Docker daemon file**: You maybe want the Docker daemon to keep images and containers in an alternate path (D:
75 +drive for example). To do so you can add the following attribute to the Docker daemon file:
76 +
77 +{{code language="cmd"}}
78 +{
79 + "data-root": "d:\\docker"
80 +}
81 +{{/code}}
82 +
83 +If not specified, the default is {{code language="cmd"}}c:\programdata\docker{{/code}}.
84 +
85 +{{/info}}
86 +
52 52  ==== 3.2.2 Check installation ====
53 53  
54 54  After executing the commands above, the server will restart if required. After the restart, execute the following command
... ... @@ -79,6 +79,19 @@
79 79  
80 80  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"]]
81 81  
117 +===3.3 Uninstall Docker===
118 +To uninstall docker from your machine, execute the following commands in powershell with administrative rights:
119 +
120 +{{code language="cmd"}}
121 +Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/emagiz/windows-support/main/Uninstall-docker/uninstall-docker.ps1" -o uninstall-docker-ce.ps1
122 +{{/code}}
123 +
124 +Example usage:
125 +
126 +{{code language="cmd"}}
127 +.\uninstall-docker-ce.ps1
128 +{{/code}}
129 +
82 82  == 4. Key takeaways ==
83 83  
84 84  * 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