diff --git a/assets/setting-up-dev-machine/windows_apt_install_npm_error_fix_missing.png b/assets/setting-up-dev-machine/windows_apt_install_npm_error_fix_missing.png new file mode 100644 index 0000000..ec0ee2e Binary files /dev/null and b/assets/setting-up-dev-machine/windows_apt_install_npm_error_fix_missing.png differ diff --git a/resources/windows_apt-get install npm_fix-missing.rtf b/resources/windows_apt-get install npm_fix-missing.rtf new file mode 100644 index 0000000..0cf8f5b --- /dev/null +++ b/resources/windows_apt-get install npm_fix-missing.rtf @@ -0,0 +1,49 @@ +{\rtf1\ansi\ansicpg1252\cocoartf2761 +\cocoatextscaling0\cocoaplatform0{\fonttbl\f0\fnil\fcharset0 CascadiaMono-Regular;\f1\fnil\fcharset0 CascadiaMono-Regular_Bold;} +{\colortbl;\red255\green255\blue255;\red0\green0\blue0;\red252\green50\blue33;} +{\*\expandedcolortbl;;\csgray\c0;\cssrgb\c100000\c29522\c16523;} +\paperw11900\paperh16840\margl1440\margr1440\vieww15780\viewh14440\viewkind0 +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\li304\fi4\ri-3254\pardirnatural\partightenfactor0 + +\f0\fs24 \cf2 \CocoaLigature0 \ +Err:2 http://ports.ubuntu.com/ubuntu-ports noble-updates/main arm64 linux-libc-dev arm64 6.8.0-48.48\ + 404 Not Found [IP: 2620:2d:4000:1::19 80]\ +Fetched 84.9 MB in 10s (8262 kB/s) \ + +\f1\b \cf3 E: +\f0\b0 \cf2 Failed to fetch http://ports.ubuntu.com/ubuntu-ports/pool/main/l/linux/linux-libc-dev_6.8.0-48.48_arm64.deb 404 Not Found [IP: 2620:2d:4000:1::19 80]\ + +\f1\b \cf3 E: +\f0\b0 \cf2 Unable to fetch some archives, maybe run apt-get update or try with --fix-missing?\ +\ +root@m3410-w11:~# apt-get update\ +\ +Hit:1 http://ports.ubuntu.com/ubuntu-ports noble InRelease\ +Get:2 http://ports.ubuntu.com/ubuntu-ports noble-updates InRelease [126 kB]\ +Get:3 http://ports.ubuntu.com/ubuntu-ports noble-backports InRelease [126 kB\ +\ +Get:29 http://ports.ubuntu.com/ubuntu-ports noble-security/restricted arm64 Components [212 B]\ +Get:30 http://ports.ubuntu.com/ubuntu-ports noble-security/multiverse arm64 Components [212 B]\ +Fetched 5155 kB in 2s (2114 kB/s) \ +Reading package lists... Done\ +\ +root@m3410-w11:~# apt-get update --fix-missing\ +\ +Hit:1 http://ports.ubuntu.com/ubuntu-ports noble InRelease\ +Hit:2 http://ports.ubuntu.com/ubuntu-ports noble-updates InRelease\ +Hit:3 http://ports.ubuntu.com/ubuntu-ports noble-backports InRelease\ +Hit:4 http://ports.ubuntu.com/ubuntu-ports noble-security InRelease\ +Reading package lists... Done\ +\ +root@m3410-w11:~# apt install npm\ +\ +Reading package lists... Done\ +Building dependency tree... Done\ +Reading state information... Done\ +The following additional packages will be installed:\ + build-essential bzip2 cpp cpp-13 cpp-13-aarch64-linux-gnu cpp-aarch64-linux-gnu dpkg-dev eslint fakeroot g++ g++-13\ +\ +\ +\ +\ +} \ No newline at end of file diff --git a/setting-up-dev-machine.md b/setting-up-dev-machine.md index 4b3b6c0..9e769f0 100644 --- a/setting-up-dev-machine.md +++ b/setting-up-dev-machine.md @@ -9,7 +9,12 @@ On any host, _dotpi_ requires: ## Linux -In addition to the common requirements, be sure that the following packages are installed: +Install the common requirements: + +- `npm` +- `rpi-imager` + +Install also the following packages: - `git` - `make` @@ -47,15 +52,30 @@ Be sure to install `Node.js` _within_ `WSL`. ``` PS C:\Windows\system32> wsl Launching Ubuntu... -root@m3410-w11:~# apt install node +root@m3410-w11:~# apt install npm ``` -Do _not_ install the `Raspberry Pi Imager` in WSL. +If you get errors, read the messages. + +![windows-apt-get-error-fix-missing](./assets/setting-up-dev-machine/windows_apt_install_npm_error_fix_missing.png) + +Then, try to solve the problems (within `WSL`). + +``` +root@m3410-w11:~# apt-get update +root@m3410-w11:~# apt-get update --fix-missing +``` + +Finally, install `npm` again (still within `WSL`). + +``` +root@m3410-w11:~# apt install npm +``` -In this first guide we will see how to use the `dotpi-install` tools to setup a Raspberry Pi, and how to monitor and control it remotely using the `dotpi-manager` +`Raspberry Pi Imager` is an exception: Do _not_ install it within `WSL`. (Later, do _not_ run it within `WSL`.) ::: info -For windows, run _any_ commands within `WSL`. +For windows, run _any_ shell command within `WSL`. ::: ## Installing `dotpi-tools` @@ -67,5 +87,5 @@ npm install -g @dotpi/tools Now, the command `dotpi-tools`should be available in your machine. ::: tip -If you prefer to use `npx` rather tha installing the package globally, just replace `dotpi-tools` by `npx @dotpi/tools` in the remaining of these tutorials. +If you prefer to use `npx` rather than installing the package globally, just replace `dotpi-tools` by `npx @dotpi/tools` in the remaining of these tutorials. :::