Last modified by Erik Bakker on 2025/04/18 13:54

From version 41.1
edited by eMagiz
on 2023/01/26 08:55
Change comment: There is no comment for this version
To version 55.1
edited by eMagiz
on 2023/02/07 11:39
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -37,51 +37,86 @@
37 37  * Validate if WSL 2.0 is properly installed
38 38  * Go to the next section around installing the eMagiz Docker agent
39 39  
40 +===3.3 Installation requirements Windows Server 2022 (without Docker Desktop) ===
40 40  
41 - {{code language="cmd"}}
42 - #Install docker
43 -sudo apt-get update
44 -sudo apt install --no-install-recommends apt-transport-https ca-certificates curl gnupg2
45 -. /etc/os-release
46 -curl -fsSL https://download.docker.com/linux/${ID}/gpg | sudo tee /etc/apt/trusted.gpg.d/docker.asc
47 -echo "deb [arch=amd64] https://download.docker.com/linux/${ID} ${VERSION_CODENAME} stable" | sudo tee /etc/apt/sources.list.d/docker.list
48 -sudo apt update
49 -sudo apt install docker-ce docker-ce-cli containerd.io
42 +**Step 1: Install linux distribution**
50 50  
51 -#Install Java
52 -wget -O - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo apt-key add -
53 -echo "deb https://packages.adoptium.net/artifactory/deb $(awk -F= '/^VERSION_CODENAME/{print$2}' /etc/os-release) main" | sudo tee /etc/apt/sources.list.d/adoptium.list
54 -sudo apt update # update if you haven't already
55 -sudo apt install temurin-8-jdk
44 +{{code language="cmd"}}
45 + wsl --install -d Ubuntu
46 + sudo apt-get update
47 + sudo apt install --no-install-recommends apt-transport-https ca-certificates curl gnupg2
48 + . /etc/os-release
49 +{{/code}}
56 56  
57 -#Autostart Dockerd with wsl
58 58  
52 +**Step 2: Install Docker **
53 +
54 +{{code language="cmd"}}
55 + curl -fsSL https://download.docker.com/linux/${ID}/gpg | sudo tee /etc/apt/trusted.gpg.d/docker.asc
56 + echo "deb [arch=amd64] https://download.docker.com/linux/${ID} ${VERSION_CODENAME} stable" | sudo tee /etc/apt/sources.list.d/docker.list
57 + sudo apt update
58 + sudo apt install docker-ce docker-ce-cli containerd.io
59 +{{/code}}
60 +
61 +{{info}}
62 + Requires ~335 Mb space to install
63 +{{/info}}
64 +
65 +**Step 3: Install Java **
66 +
67 +{{code language="cmd"}}
68 + wget -O - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo apt-key add -
69 + echo "deb https://packages.adoptium.net/artifactory/deb $(awk -F= '/^VERSION_CODENAME/{print$2}' /etc/os-release) main" | sudo tee /etc/apt/sources.list.d/adoptium.list
70 + sudo apt update # update if you haven't already
71 + sudo apt install temurin-8-jdk
72 +{{/code}}
73 +
74 +{{info}}
75 + Requires ~335 Mb space to install
76 +{{/info}}
77 +
78 +**Step 4: Ensure Docker is autostarted with WSL **
79 +
80 +{{code language="cmd"}}
59 59  nano .bashrc
60 60  
83 + #Add following lines to bashrc
61 61   DOCKER_DISTRO="Ubuntu"
62 62   DOCKER_LOG_DIR=$HOME/docker_logs
63 63   mkdir -pm o=,ug=rwx "$DOCKER_LOG_DIR"
64 64   /mnt/c/Windows/System32/wsl.exe -d $DOCKER_DISTRO sh -c "nohup sudo -b dockerd < /dev/null > $DOCKER_LOG_DIR/dockerd.log 2>&1"
88 +{{/code}}
65 65  
66 -#Do not ask password dockerd
90 +**Step 5: Add user to Docker group **
91 +
92 +{{code language="cmd"}}
67 67  sudo visudo
68 68  
69 - %docker ALL=(ALL) NOPASSWD: /usr/bin/dockerd
95 + #Add following lines
70 70  
71 -#Set WSL config for memory
72 -USERDIR/.wslconfig
73 - # Settings apply across all Linux distros running on WSL 2
74 - [wsl2]
97 + # Don't ask for password
98 + %docker ALL=(ALL) NOPASSWD: /usr/bin/dockerd
99 +{{/code}}
75 75  
76 - # Limits VM memory to use no more than 4 GB, this can be set as whole numbers using GB or MB
77 - memory=16GB
101 +**Step 6: Update wsl config file **
102 +In this step we need to add or update the WSL config file that manages the resources of the Linux subsystem. Important resources to manage are the assigned memory and number of processors. For memory we recommend to review the mempory settings for the runtime that need to run on this server and add 762 MB to the total value of the heap and non-heap of these runtimes. For processor we recommend to set the value to 2 - depending on the amount of processors available on that machine
78 78  
79 - # Sets the VM to use two virtual processors
80 - processors=2
104 +First, locate the config file or add it to the location %USERPROFILE%. The name should be .wslconfig (no extension)
81 81  
82 -(Exit WSL: wsl --shutdown)
83 - {{/code}}
106 +{{code language="cmd"}}
107 + #Add following lines
108 +
109 + # Settings apply across all Linux distros running on WSL 2
110 + [wsl2]
111 + # Limits VM memory to use no more than 4 GB, this can be set as whole numbers using GB or MB
112 + memory=16GB
113 + # Sets the VM to use two virtual processors
114 + processors=2
115 +{{/code}}
84 84  
117 +**Step 7: Auto start the linux subsystem when server restarts **
118 +
119 +
85 85  ===3.4 Installation requirements Windows Server 2019 version >1806===
86 86  
87 87  These are the requirements to allow the installation of the eMagiz Docker agent: