Skip to Content
Last modified by Erik Bakker on 2025/04/18 13:54
From version 127.1
edited by Erik Bakker
on 2024/04/11 08:21
Change comment: There is no comment for this version
To version 98.1
edited by Eva Torken
on 2024/02/26 09:21
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.ebakker
1 +XWiki.etorken
Content
... ... @@ -16,23 +16,18 @@
16 16  == 3. On-premises deployments ==
17 17  
18 18  ===3.1 General requirements===
19 -
20 -{{info}}
21 -* Standard configuration to ensure that communication between your server and eMagiz to ensure communication.
19 +These are the general requirements to allow the installation of the eMagiz Docker agent:
20 +* Ensure access to the following URLs is enabled
22 22   ** registry.emagiz.com:443
22 + ** 3.126.123.28
23 + ** 18.194.225.123
24 + ** 54.93.164.84
23 23   ** controlplane.emagiz.com:8000
24 - ** controltower.kpn-dsh.com:443
25 - ** Preferably the entry should be *.emagiz.com
26 - ** Preferably the entry should be *.kpn-dsh.com{{/info}}
27 -
28 -{{warning}}
29 -* In case of a very strict firewall configuration, additional configuration is needed to communicate to the eMagiz infrastructure.
26 + ** controlplane.emagiz.com:443
27 + ** 3.122.22.89:443
28 + ** 3.122.22.89:8000
30 30   ** controltower.emagiz.com:443
31 - ** controltower.kpn-dsh.com:443
32 32   ** controlbus.emagiz.com:443
33 - ** controlplane.emagiz.com:443
34 -
35 -* When using cloudslot number **equal to or below** 125, the following configuration is needed to communicate to your JMS.
36 36   ** 35.158.46.28:443
37 37   ** 3.74.190.88:443
38 38   ** 35.158.46.28:8443
... ... @@ -39,47 +39,23 @@
39 39   ** 3.74.190.88:8443
40 40   ** 35.158.46.28:8444
41 41   ** 3.74.190.88:8444
37 + ** 52.28.59.137
38 + ** 3.71.221.73
39 + ** 52.58.23.77
40 + ** Preferably the entry should be *.emagiz.com
42 42  
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 -
51 51  ===3.2 Installation Windows===
52 -Whenever Windows is selected as operating system, you need to have a Windows Server 2022 version. Older Windows servers are **not** supported.
43 +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.
53 53  
54 54  
55 55  ==== 3.2.1 Docker Installation ====
56 -To install or update docker on your machine, execute the following commands in powershell with administrative rights:
47 +In powershell with administrative rights, execute the following commands
57 57  
58 58  {{code language="cmd"}}
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
50 +Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/microsoft/Windows-Containers/Main/helpful_tools/Install-DockerCE/install-docker-ce.ps1" -o install-docker-ce.ps1
51 +.\install-docker-ce.ps1
61 61  {{/code}}
62 62  
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 -
83 83  ==== 3.2.2 Check installation ====
84 84  
85 85  After executing the commands above, the server will restart if required. After the restart, execute the following command
... ... @@ -91,7 +91,7 @@
91 91  If the command returns that the command cannot be found, please run the following command again.
92 92  
93 93  {{code language="cmd"}}
94 -.\install-update-docker-ce.ps1 -DockerVersion DESIRED_VERSION
65 +.\install-docker-ce.ps1
95 95  {{/code}}
96 96  
97 97  ==== 3.2.3 Verify docker functionality ====
... ... @@ -110,19 +110,6 @@
110 110  
111 111  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"]]
112 112  
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 -
126 126  == 4. Key takeaways ==
127 127  
128 128  * 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