Skip to content

Commit bb111ce

Browse files
docs: inline every host-setup command in the example prerequisites
The prerequisites section referenced the inotify and pids_limit fixes only via 'the profile setup prints them' and listed the Istio distribution without a download command. All five host changes the 2026-07 fresh-host bring-up required now carry their exact commands inline: sysctl inotify limits, podman pids_limit, iptables kernel modules, minikube >= 1.36 tooling note, and the Istio distribution unpack + istio-current symlink.
1 parent 9ac80fb commit bb111ce

1 file changed

Lines changed: 26 additions & 4 deletions

File tree

‎examples/lgtm-datamesh/README.md‎

Lines changed: 26 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -96,16 +96,38 @@ RAM-constrained.
9696
> /etc/modules-load.d/99-kubernetes-iptables.conf'
9797
sudo systemctl restart systemd-modules-load
9898
```
99-
- Kernel `fs.inotify.max_user_instances` raised and podman's default
100-
`pids_limit` raised or unlimited (the profile setup checks both and
101-
prints the fix commands)
99+
- Kernel `fs.inotify.max_user_instances` raised (the capstone runs many
100+
controllers; Fedora's default of 128 is not enough):
101+
102+
```bash
103+
sudo sh -c 'printf "fs.inotify.max_user_instances = 512\nfs.inotify.max_user_watches = 524288\n" \
104+
> /etc/sysctl.d/99-kubernetes.conf'
105+
sudo sysctl -p /etc/sysctl.d/99-kubernetes.conf
106+
```
107+
- Podman's default `pids_limit` raised or unlimited — the fully-meshed
108+
stack runs ~2000+ tasks on the node and saturates the 2048 default
109+
(CAP-040). Must be set **before** the node is created:
110+
111+
```bash
112+
mkdir -p ~/.config/containers
113+
printf '[containers]\npids_limit = 0\n' >> ~/.config/containers/containers.conf
114+
```
115+
116+
(The profile setup checks both of these and prints the same fixes.)
102117
- Standard tooling: minikube **1.36 or newer** (1.35's registry addon
103118
pins a `kube-registry-proxy` image digest that no longer exists on
104119
gcr.io, so the addon can never come up), kubectl, helm, istioctl —
105120
with the full Istio distribution unpacked at
106121
`~/.local/share/istio-current` (`setup-kiali.sh` applies
107122
`samples/addons/kiali.yaml` from it; the `istioctl` binary alone is
108-
not enough)
123+
not enough):
124+
125+
```bash
126+
curl -fsSL https://github.com/istio/istio/releases/download/1.26.2/istio-1.26.2-linux-amd64.tar.gz \
127+
| tar xz -C ~/.local/share
128+
ln -sfn ~/.local/share/istio-1.26.2 ~/.local/share/istio-current
129+
cp ~/.local/share/istio-current/bin/istioctl ~/.local/bin/
130+
```
109131

110132
The bootstrap script audits prerequisites before doing any work.
111133

0 commit comments

Comments
 (0)